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 与客户端包（进行中：① Codex 接入 ✅、② MCP Gateway ✅、第三方技能（skills.sh，ADR-0017）✅、Codex openai-curated 插件目录（仅 Playground，ADR-0018）✅；之后：④ 用量统计、③ 业务平台接入）

CodexAdapter：app-server 进程管理、个人配置覆盖与自检、协议类型生成、事件映射、审批桥接、权限配置映射
MCP Gateway 上线（内置 web_fetch、kb_list_roots、ask_user）
Profile 管理（另存为、版本历史）
packages/client 与 packages/chat-ui，在一个上层平台中接入
用量统计、概览页、审计日志页
~~systemd 常驻部署~~（已提前完成，ADR-0012）

M3：完善

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

以后（按需）

内部平台连接器（设计见 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 常驻部署、用量统计图表