ACE Context Engine — VS Code 扩展

为 CLI Coding Agent（Claude Code / Codex / Gemini / OpenCode / Kimi / Qwen / ZCode / Grok / Qoder / Reasonix 等）提供 IDE 上下文感知能力（通过 MCP 协议）。本扩展是 ACE 的 VS Code 端采集器。

扩展采集当前 IDE 状态（当前文件、光标、选中代码、诊断、Git 状态、最近修改等），经本地 daemon 以 MCP 提供给各 Coding Agent。Agent 在合适场景主动调用 ACE 工具，拿到真实编辑状态，不再凭空猜测"你在看什么"。

功能特性

• IDE 上下文采集：当前文件 / 光标 / 选中代码 / 打开的标签页 / 工作区 / 错误诊断 / Git 状态 / 最近修改 / 符号结构
• 双向通道（只读查询）：Agent 不依赖光标、按符号名跨文件查询——13 个 method（定义 / 引用 / 悬停 / 实现 / 签名 / 调用层级 / 类型层级 / 符号搜索 / IDE 导航 / Code Action 建议），见「双向通道」一节
• 自动拉起 daemon：扩展激活即拉起本地 daemon（HTTP :8787），崩溃自动重启（指数退避），零手动操作
• 多 Agent 共享：多个 Coding Agent 连同一 daemon，上下文单一权威；多项目按 projectRoot / select_project 隔离
• 一键接入所有 Agent：命令面板一条命令，把 MCP 配置 + 使用提示词写入本机所有已安装的 Agent
• OAuth 自动授权：兼容 Claude Code 等对 HTTP MCP 强制 OAuth 的客户端，免配置

快速开始（一键接入）

1. 安装扩展并打开任意项目。
2. 打开命令面板（Ctrl+Shift+P）→ 运行 ACE: 一键接入所有 Agent。
3. 扩展会自动：
   • 为已安装的每个 Agent 写入全局 MCP 配置（指向 http://localhost:8787/mcp）；
   • 写入该 Agent 的全局提示词文件（CLAUDE.md / AGENTS.md，带 <!-- ACE_START --> 标记块，可重复运行不重复追加）；
   • 在 ~/.local/bin/ 写入全局 ace 命令（stdio 兜底）。

运行结果打印在 ACE 输出面板：每个 Agent 是"已配置 / 未检测到"一目了然。

提示：配置已写入，重启对应的 Coding Agent 会话后生效。

手动配置

一键命令之外，手动接入只需两步：写 MCP 配置 + 写提示词。所有 Agent 共用同一个 daemon 地址 http://localhost:8787/mcp。

1. MCP 配置

在 Agent 的全局 MCP 配置文件中注册 ace（各 Agent 的 MCP 配置文件与提示词文件在同一目录，见「提示词（使用指引）」表格）：

{
  "mcpServers": {
    "ace": { "type": "http", "url": "http://localhost:8787/mcp" }
  }
}

Claude Code 也可用命令行：claude mcp add ace --type http --url http://localhost:8787/mcp（用户级）。

TOML 系（Codex / Grok / Reasonix）与 OpenCode / ZCode 的结构字段略有差异，推荐直接使用一键命令自动写入，避免手误。

2. 提示词

把使用指引写入 Agent 的全局提示词文件（~/.claude/CLAUDE.md / ~/.codex/AGENTS.md 等，路径见「提示词（使用指引）」表格），以 <!-- ACE_START --> / <!-- ACE_END --> 标记块包裹。一键接入时已自动写入，重复运行会更新而非重复追加；内容参考「工具清单（AI Agent 使用指引）」一节。

3. stdio 模式（兜底，无 HTTP daemon 时）

若某 Agent 只支持 stdio：一键接入时扩展已在 ~/.local/bin/ 写入全局 ace 命令，配置为：

{ "type": "stdio", "command": "~/.local/bin/ace" }

stdio 模式下多会话自动 relay 共享上下文，cwd 自动路由项目。

双向通道（只读查询 / 导航 / Code Action）

Agent 以任意符号名跨文件查询，不依赖光标定位；Server 经 WS 下发 request，扩展复用 VS Code LSP 执行查询后回 response：

范围红线：全程只读查询 + IDE 导航定位 + 只读建议，不做写操作 / 代码执行 / 应用修复。能力跟随 VS Code 已装语言扩展（内置 JS/TS 等），非声明语言返回明确提示而非静默空。

提示词（使用指引）

一键接入时，扩展已把使用指引写入各 Agent 的全局提示词文件：

内容以 <!-- ACE_START --> / <!-- ACE_END --> 标记块写入，重复运行一键命令会更新而非重复追加。你也可以手动把使用指引写入上述文件（内容参考「工具清单」一节），效果相同。

工具清单（AI Agent 使用指引）

以下指引面向 AI Coding Agent：你有 ACE 提供的 IDE 上下文感知工具（MCP），在合适的场景主动调用合适的工具，由 AI 决策，而不是等用户明确指定。工具名即 MCP 工具名；双向通道的协议 method 名（definition / references / hover 等）即对应工具去掉 get_ 前缀，见上节。

工具与用途

触发场景 → 应调用

使用原则

1. 模糊指代先取上下文，不猜测：用户说"这里 / 这个 / 当前"时，先调用工具获取真实状态，再回答或动手。
2. 最小调用：优先用 get_current_context 一次拿全；按需再定向调用其他工具，不批量轰炸。
3. 无上下文时：若工具返回"尚无 IDE 上下文"，说明扩展未连接（或未打开文件），如实告知用户，不臆造。
4. 多项目：同时接入多个项目时，工具默认路由到 select_project 绑定的项目；需指定时用 projectRoot 参数。

排错

配置