EZCode

AI 原生的 Agent IDE。目标：做到 Trae 级别的智能体编码体验。

以 fork VS Code（TypeScript / Electron）为地基，融合三条开源主线的设计思路：

• VS Code —— IDE 外壳（编辑器 / LSP / 调试 / 终端 / 扩展生态）
• Trae-agent —— Agent 循环设计（规划 / 工具调用 / 多步 SWE 任务）
• Cherry Studio —— 多供应商 LLM 管理与聊天 UX

当前处于 B 路线（先做 VS Code 扩展，验证核心 agent 能力），核心资产可平滑演进到未来的 fork 外壳。

架构

npm workspaces monorepo，agent 逻辑与运行环境解耦：

packages/
├── shared/       契约层：LLM 消息 / 工具 / agent 事件类型
├── agent-core/   Trae 式 agent 循环（与 UI、供应商解耦）
└── llm/          多供应商适配（当前：OpenAI 兼容，覆盖官方/中转/本地）
apps/
└── vscode-extension/   VS Code 扩展：侧栏聊天 UI + 工具落地 + agent 宿主
legacy/           旧 C# / .NET / Avalonia 实现（已弃用，仅作参考）

开发运行

前置：Node ≥ 20、npm ≥ 10、VS Code。

# 安装依赖（workspace 根目录）
npm install

# 构建全部
npm run build

在 VS Code 中打开本仓库，按 F5 选择「运行 EZCode 扩展」，会启动一个带 EZCode 扩展的 Extension Development Host 窗口。

配置模型

在扩展窗口的设置里搜索 ezcode，填写：

• ezcode.provider.baseUrl —— API 基址（OpenAI 官方 https://api.openai.com/v1、国内中转、或本地 http://localhost:11434/v1）
• ezcode.provider.apiKey —— API Key（本地 Ollama 可留空）
• ezcode.provider.model —— 模型 id

点侧栏 EZCode 图标打开对话面板即可使用。

Agent 能力

内置工具（写/执行类会请求确认，读类自动放行）：

• read_file / write_file / list_dir —— 文件读写、目录浏览
• find_files / search_text —— 文件名匹配、全文检索
• run_command —— 终端命令执行（高风险，需确认）

路线图

• M0 骨架 ✅ monorepo + 三包 + 扩展可加载
• M1 对话 ✅ 侧栏聊天 + OpenAI 兼容供应商
• M2 Agent 动手 ✅ Trae 式循环 + 文件/搜索/终端工具 + 审批门控
• M3 增强 ⏳ 多步规划、diff 审查、更多供应商、差异化创新功能