执行模式（cli / mcp）
除了 Direct / Agent，项目还有一层更底层的执行模式开关，决定整体走「选区 + CLI」新链路，还是回退到旧的页内 MCP 链路。
两种模式
| 模式 | 开关 | 行为 |
|---|---|---|
cli（默认） | AGENT_EXECUTION_MODE=cli + 扩展 EXECUTION_MODE='cli' | 选区 + CLI 链路；不挂 /bridge、不生成 mcp-config |
mcp（回滚） | AGENT_EXECUTION_MODE=mcp + 扩展 EXECUTION_MODE='mcp' | 恢复原页内 MCP 链路（代码保留） |
cli是默认与推荐模式，也是本文档的主线。mcp是回滚通道：旧链路代码完整保留，切回只需改开关。详见 MCP 模式（旧）。
如何切换
Gateway 侧用环境变量：
bash
# 默认：CLI 模式
AGENT_EXECUTION_MODE=cli pnpm start:gateway
# 回滚：MCP 模式
AGENT_EXECUTION_MODE=mcp pnpm start:gateway扩展侧用构建常量 EXECUTION_MODE（见 packages/chrome-extension/src/shared/constants.ts）。两侧需保持一致。
环境变量名（
AGENT_EXECUTION_MODE等）与内部标识符为功能标识，不随产品改名而变化。
灰度策略
- Chrome 扩展：通过 Chrome Web Store / Release 渠道分阶段发布。
- 文档宿主端：通过功能开关灰度。
- 按 provider 灰度：钉钉先启用，飞书 / Notion 适配器就绪后按端逐步放量。
配置项完整列表见 配置项。