Skip to content

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)
交互形态选区 + 指令聊天 + 工具调用
适配成本每端一个适配器与宿主强耦合

旧链路代码完整保留,仅作回滚用途,不再新增能力。

基于 MIT 许可发布