Jerry Liang f9442cdaa2 docs:删除旧AI助手(Kiro/ACP)文档,清理部署与设计文档中的旧助手和旧MCP引用 12 時間 前
..
README.md f9442cdaa2 docs:删除旧AI助手(Kiro/ACP)文档,清理部署与设计文档中的旧助手和旧MCP引用 12 時間 前
agent-mcp.md f9442cdaa2 docs:删除旧AI助手(Kiro/ACP)文档,清理部署与设计文档中的旧助手和旧MCP引用 12 時間 前
requirements.md f9442cdaa2 docs:删除旧AI助手(Kiro/ACP)文档,清理部署与设计文档中的旧助手和旧MCP引用 12 時間 前
technical-design.md f9442cdaa2 docs:删除旧AI助手(Kiro/ACP)文档,清理部署与设计文档中的旧助手和旧MCP引用 12 時間 前
ui-design.md f9442cdaa2 docs:删除旧AI助手(Kiro/ACP)文档,清理部署与设计文档中的旧助手和旧MCP引用 12 時間 前

README.md

新 AI 助手(AgentServer):文档导航

本目录是 ToolBox 新 AI 助手的需求与设计。新助手基于 AgentServer(~/web/AgentServer,自托管的 Claude Code / Codex Agent 服务):对话、事件、文件、审批、沙箱由 AgentServer 提供,ToolBox 负责入口、鉴权、会话归属,业务数据由新建的、无用户状态的 MCP 服务 fwh-agent-mcp 提供。

当前状态:需求与设计初稿(2026-10-24),尚未编码。AgentServer 已支持第三方 MCP 服务(ADR-0021);还需要一处通用的结果处理改动(agent-mcp 5.2)。

建议阅读顺序:requirements → technical-design → ui-design → agent-mcp。

文档职责

文档 内容 何时读取
requirements.md 新助手的目标、功能与非功能需求、待确认事项 确定做什么、讨论验收范围时
technical-design.md 总体架构、ToolBox 前后端新模块(会话归属与代理)、AgentServer 配置、技能、实施步骤与验收用例 实现 ToolBox 侧、排期时
ui-design.md 独立页面的路由与菜单、三栏布局、欢迎页、交互细节、主题与代码结构 实现或评审前端页面时
agent-mcp.md fwh-agent-mcp:定位、框架、工具清单、大数据处理、部署与接入、写工具规划 实现业务工具时

AgentServer 自身的设计以其仓库 docs/ 为准,重点参考:docs/integration.md、docs/design/04-api.md、docs/design/08-platform-connectors.md、docs/adr/0021-third-party-mcp-via-gateway.md、docs/design/06-security.md。

维护方式

范围变化更新 requirements.md 并关闭对应待确认条目;ToolBox 侧设计变化写入 technical-design.md,页面调整写入 ui-design.md,MCP 设计变化写入 agent-mcp.md。编码开始后另建 implementation-status.md。