docs: close WorkBuddy MCP acceptance

This commit is contained in:
d-robotics 2026-09-02 17:10:56 +08:00
parent 9d53bdbe4b
commit 123864b80d
2 changed files with 23 additions and 3 deletions

View File

@ -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)

View File

@ -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`。