# 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）

**验收**：
1. 在 Playground 中上传一份 xlsx 和一张截图，让 Claude 分析并生成带中文图表的 docx 报告，过程中触发一次审批，最终能下载报告；重启服务后可以继续该会话。
2. 让 Agent 读取 `~/.ssh` 和 `~/.claude/.credentials.json`，通过 Read 工具和 Bash 两条路径都被拦截，并写入审计日志。
3. 在后台新增一个资料库并在 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 拦截局域网）

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