11 里程碑与待决事项

里程碑

M1：主链路跑通（Claude）— ✅ 已完成（2026-10-22）

monorepo 骨架；shared 类型；SQLite schema 与迁移
ClaudeAdapter：流式输出、resume、中断、canUseTool 交互（审批 + 提问）、图片输入
会话 / 消息 / SSE（含断线续传）/ 交互 / 文件上传下载 API；API Key 鉴权
文件访问策略：三层合并、Claude 侧映射（沙箱 + 权限规则 + canUseTool 路径校验）、生效预览
安全基线：Claude 沙箱（failIfUnavailable、关闭沙箱外重试）、WebFetch 私网拦截、全局强制禁止项
后台设置：路径、安全、网络、限制、引擎；资料库管理（含可见性检测）
后台：登录、Playground（时间线 + 交互卡片 + 输入框 + 调试面板）、会话回放、引擎状态、API Keys
技能接入（自写 report-conventions；官方技能见 Q5）

验收：

在 Playground 中上传一份 xlsx 和一张截图，让 Claude 分析并生成带中文图表的 docx 报告，过程中触发一次审批，最终能下载报告；重启服务后可以继续该会话。
让 Agent 读取 ~/.ssh 和 ~/.claude/.credentials.json，通过 Read 工具和 Bash 两条路径都被拦截，并写入审计日志。
在后台新增一个资料库并在 Profile 中启用，Agent 能检索其中的内容；未启用的资料库读取会被拒绝。

M2：Codex 与客户端包（✅ 完成 2026-10-23：Codex 接入、MCP Gateway、第三方技能（ADR-0017）、Codex 插件目录（仅 Playground，ADR-0018）、用量统计、业务平台接入（ADR-0019）、Profile 另存为与版本历史）

CodexAdapter：app-server 进程管理、个人配置覆盖与自检、协议类型生成、事件映射、审批桥接、权限配置映射
MCP Gateway 上线（内置 convert_document、recalc_workbook、web_fetch、kb_list_roots；ask_user 不再需要，两个引擎都有原生提问并已接入交互卡片）
Profile 管理：复制为新 Profile、Playground 另存为 Profile、版本历史（内容变化才产生新版本，恢复保存为新版本）
packages/client 与 packages/chat-ui，在一个上层平台中接入
用量统计、概览页、审计日志页
~~systemd 常驻部署~~（已提前完成，ADR-0012）

M3：完善

资料库全文索引（kb_search）
工作区自动清理、回归用例批量重放
网络加强（nftables 按 cgroup 拦截局域网）

M4：Bot 工作组（一期 ✅ 2026-10-26，二期、三期 ✅ 2026-10-27，见 13、ADR-0023/0024）

✅ 一期：机器人定义、Bot Key 与 /bot/v1、工作组与消息、@ 组员的单项工作、审批卡片；BotClient、<TeamChat>；Bot Playground 基本形态
✅ 二期：组长、能力卡片、任务与子任务、限额与暂停、组长申请加入机器人；Playground 的替身组员、逐步执行、任务 / 输入 / 用量页签
✅ 三期：BotClient、<TeamChat> 随 SDK 0.3.0 发布，platform-demo 增加工作组页面；子任务重试与依赖失败的处理；后台查看全部来源的工作组、复制到 Playground、回归用例（工作组）

M5：定时任务（✅ 2026-10-27，见 14）

在对话中由 AI 创建（确认卡片），会话或工作组到点自动执行；Agent API、Bot API、SDK 组件与后台总览
以后：执行结果的 Webhook 通知

M6：后台调用（✅ 2026-10-27，见 15）

外部工具的长调用超过时限（或工具标记为后台执行）时转到后台，完成后把结果发给发起方；工作组子任务等待后台调用后继续
以后：对接 MCP 规范的异步任务机制，重启后可以接续

以后（按需）

内部平台连接器（设计见 08）
专用系统用户（迁移步骤见 06 §5.3）
API Key 类模型凭证（开放给他人使用时，见 ADR-0008）

待决事项

#	问题	计划
Q1	Codex 权限配置能否按 thread 指定	✅ 可以：thread/start 的 config 传入动态权限配置（03 §3.4）
Q2	codex app-server 协议的具体方法名与审批回复格式	✅ 已落定（03 §3.4）
Q3	用 `-c` 能否完整禁用个人 config 中的插件和 MCP	✅ 不再需要：服务使用专用 CODEX_HOME（03 §3.4）
Q4	Claude SDK 中 AskUserQuestion 的回答格式	✅ 已核对：answers 以问题原文为键（03 §6）
Q5	官方 Skills 的许可证是否允许在自托管服务中使用	✅ 采用 ADR-0013：只通过 Claude Code 插件机制安装、按路径加载、仅限 Claude；由管理员在后台确认后安装
Q6	本地资料的规模与存放位置	决定 M3 索引的优先级；建议放在 home 以外
Q7	运行账号在 docker / lxd 组中（相当于 root）	✅ 已迁移到专用用户 agentsvc（ADR-0012）

M1 交付清单

服务端：会话 / 消息 / SSE（断线续传）/ 交互 / 文件 / Profile / 资料库 / 设置 / API Key / 审计 API；Claude 适配器（流式、resume、中断、审批、提问、图片输入、技能、文档转换工具）；三层文件访问策略；后台登录
前端包：@agent-server/client、@agent-server/chat-ui、@agent-server/ui-tokens
后台：Playground（模型和权限模式可切换、调试面板、文件预览）、会话回放、概览、Profiles（含访问策略生效预览）、资料库（路径校验）、API Keys、审计、设置（亮/暗主题）
测试：23 个自动化测试（访问策略、API 全流程、LibreOffice 转换），并用真实 Claude 完成了 4 次端到端验收
未包含（按计划在 M2）：Codex、MCP Gateway、systemd 常驻部署、用量统计图表