diff --git a/docs/development/MCP_SETUP.md b/docs/development/MCP_SETUP.md index 433ea9f..d0845c4 100644 --- a/docs/development/MCP_SETUP.md +++ b/docs/development/MCP_SETUP.md @@ -82,6 +82,19 @@ uv run pytest tests/integration/test_mcp_server.py tools/call,并使用与 WorkBuddy 相同的 Bearer Header 配置验证身份传递、无结果、参数错误、 认证失败、Origin 防护和错误脱敏。 +### WorkBuddy 现场验收记录 + +2026-09-02 使用 WorkBuddy Desktop `5.3.14` 自带的 CodeBuddy CLI `2.115.0` 完成兼容性 +验收。客户端直接加载 `deploy/workbuddy-mcp.example.json`,健康检查为 `Connected`;工具 +发现结果只有 `mcp__enterprise-knowledge__search_knowledge`,随后以字符串 `query` 和 +`top_k=1` 完成 Tool 调用并读取结构化 `filename`、`section`、`content` 等来源字段。 + +现场验收使用 DEMO-012 的真实 Gateway、Bearer 验证、service identity 传递、输入 Schema 和 +Tool 注册代码。为避免外部数据库与模型波动掩盖客户端兼容性,检索应用使用确定性验收返回; +真实 Provider 检索链路由 `ARCH-006` 的受控验收负责。非交互 CLI 需要批准 MCP Tool 调用, +本次只在单次会话中允许 `DeferExecuteTool`,没有永久启用跳过权限。测试结束后已删除临时 MCP +配置并停止本地 Gateway,未写入真实凭据。 + 参考: - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md index 23b17b5..4aad046 100644 --- a/docs/plans/PROGRESS.md +++ b/docs/plans/PROGRESS.md @@ -303,7 +303,14 @@ Provider 架构迁移按 `ARCH-001 → ARCH-002 → ARCH-003 → ARCH-004 → AR - 验证结果:Ruff Format/Lint、Mypy、Git diff、Alembic Head/离线升级全部通过;Unit + Integration `165 passed`,RAG Evaluation `5 passed`。本任务未改变检索算法或数据库结构, 不重复消耗真实 Embedding/OceanBase/Reranker 资源。 -- 当前环境未安装 WorkBuddy/CodeBuddy 客户端,因而没有执行客户端 UI 的现场连接;已按其官方 - HTTP 配置格式提供无凭据模板,并使用官方 MCP Client 对相同 Streamable HTTP + Bearer - 链路完成端到端协议验证。正式部署后仍需用可达 HTTPS URL 做一次 WorkBuddy 现场冒烟。 +- 2026-09-02 补充完成 WorkBuddy 现场验收:本机 WorkBuddy Desktop `5.3.14` 自带的 + CodeBuddy CLI `2.115.0` 通过仓库交付的 `deploy/workbuddy-mcp.example.json` 建立 + Streamable HTTP + Bearer 连接,健康检查为 `Connected`,仅发现 + `mcp__enterprise-knowledge__search_knowledge`,并以 `query` + `top_k=1` 完成真实 Tool + 调用、读取结构化来源字段。验收使用真实 Gateway、认证、身份传递、Schema 和 Tool + 注册代码,检索应用返回确定性数据,以隔离 WorkBuddy 兼容性与外部 Provider 波动。 +- 非交互客户端调用使用仅对当前会话放行 `DeferExecuteTool` 的权限设置,没有持久化放宽权限; + 临时客户端配置已删除、Gateway 已停止,仓库和用户配置中均未留下测试 Token。至此 + `DEMO-012` 约定的 WorkBuddy 客户端验收项闭环;公网 HTTPS 部署验证属于部署环境验收, + 不阻塞本地 Demo Task 完成。 - 下一任务:`DEMO-015`。