MCP 模式(旧)
这是回滚通道,不是推荐路径。 默认与推荐使用的是
cli模式(选区 + 官方 CLI)。本页说明保留下来的旧链路,供需要时回退。
背景
项目最初的 v1 架构基于 MCP:本地 Agent(qodercli)通过 MCP 协议,驱动注入到文档宿主(we-word / 钉钉文档)页内的 MCP Server 完成编辑。它把编辑逻辑放在页内,跨端复制成本高、多维表能力弱——这正是新方案要解决的问题(见 介绍)。
链路概览
qodercli ── MCP ──> Gateway ──(WebSocket /bridge)──> 扩展 Background
│
Content Script(页内 MCP Server / Transport)
│
we-word 文档- 扩展 Background 通过
chrome.runtime.connect建立 Port 直连; - Gateway 挂载
/bridge(WebSocket)并生成 mcp-config; - 页内经
AgentExtensionTransport桥接工具调用。
何时 / 如何回退
设置两侧开关为 mcp:
bash
AGENT_EXECUTION_MODE=mcp pnpm start:gateway并让扩展构建常量 EXECUTION_MODE='mcp'(见 执行模式)。此时:
- 恢复页内 MCP 链路;
- 挂载
/bridge、生成 mcp-config; - 侧边栏切换为聊天式交互(会话、流式回复、工具调用卡片)。
与 CLI 模式的差异
cli(默认) | mcp(旧) | |
|---|---|---|
| 变更执行者 | 官方 CLI | 页内 MCP Server |
/bridge | 不挂 | 挂载(WebSocket) |
| 交互形态 | 选区 + 指令 | 聊天 + 工具调用 |
| 适配成本 | 每端一个适配器 | 与宿主强耦合 |
旧链路代码完整保留,仅作回滚用途,不再新增能力。