用途:把 CloudBase MCP 新版本推进 CodeBuddy IDE 的内置集成,并修复「IDE 里集成的 CloudBase 功能不足」(资料指出根因多为 toolWhiteList 漂移而非 MCP 能力不足);也用于修改内置 toolWhiteList、systemPrompt、attatchPrompt,以及定位 IDE 内 MCP 的实际版本与可用工具。
集成结构:内置集成由 genie 扩展承载,需同时改两处——integration-mcp/tcb/index.cjs(由仓库 mcp/dist/cli.cjs 改名而来)与 out/extension/index.js 中内嵌的 tcb 配置(webpack module,ir.exports=JSON.parse('{...}'))。默认 IDE 路径 /Applications/CodeBuddy CN.app,同目录另有 anydev、eop、lighthouse 集成,注意别改错。启动不传命令行参数,凭据依赖环境变量 TENCENTCLOUD_SECRETID/SECRETKEY/SESSIONTOKEN。
主要步骤:解包取得线上基线与 scripts/tools.json 比对;构建新 bundle(cd <repo>/mcp && npm run build:webpack,只跑该命令,避免 npm run build 触发 prebuild 的 rm -rf dist);由 tools.json 全量生成 toolWhiteList;dry-run 后注入(node scripts/apply-to-ide.mjs --dry-run,再 node scripts/apply-to-ide.mjs,可用 scripts/patch-tool-timeout.mjs --timeout 300000);用 verify-ide-config.mjs、verify-bundle.mjs 验证,rollback-ide.mjs --latest 回滚。
限制与坑:白名单过滤在 IDE 侧,只换 bundle 不换白名单则新工具被静默过滤;写入后必须完全退出并重启 IDE 才生效;解包需按 JS 字符串语义 eval+JSON.parse 判断结束位置,锚点用 "id":"tcb";大打包产物改动后必须对整文件做真实编译校验(如 new vm.Script)并内置失败回滚,node --check 独立复核;已知 IDE 侧 toolTimeout 未接通,实际约 60 秒;插件类工具需注入 CLOUDBASE_MCP_PLUGINS_ENABLED。另需人工端到端验收 E1–E10。MCP 发版时必须按 checklist 重新生成白名单并用 build-config.mjs 同步。首次实操交付物模板见仓库 specs/cb-ide-mcp-upgrade/。