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 与客户端包

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

M3：完善

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

以后（按需）

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

待决事项

#	问题	计划
Q1	Codex 权限配置能否按 thread 指定	M2 实现时核对（03 §3.2）
Q2	codex app-server 协议的具体方法名与审批回复格式	M2 用 `generate-ts` 落定后回填 03 §3
Q3	用 `-c` 能否完整禁用个人 config 中的插件和 MCP	M2 启动自检验证；不行时再评估独立 CODEX_HOME 方案（注意不能复制 auth.json）
Q4	Claude SDK 中 AskUserQuestion 的回答格式	✅ 已核对：answers 以问题原文为键（03 §6）
Q5	官方 Skills 的许可证是否允许在自托管服务中使用	许可证为"受你与 Anthropic 的协议约束"，无法自行判定；当前使用自写技能，是否引入由你决定
Q6	本地资料的规模与存放位置	决定 M3 索引的优先级；建议放在 home 以外
Q7	运行账号在 docker / lxd 组中（相当于 root）	建议移出这两个组，或者提前迁移到专用用户（06 §8）

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 常驻部署、用量统计图表