本文档反映 2026-07-16 的当前代码。历史实施过程、已完成 issue 和一次性 SDD 通过 Git
历史查询，不再长期留在 docs/。
| 文档 | 用途 |
|---|---|
| ARCHITECTURE.md | main 进程模块、所有权、生命周期和依赖方向 |
| FLOWS.md | 启动、Session、Agent、Tool、Remote、Scheduler、Sync 和退出流程 |
| architecture/agent-system.md | DeepChat / ACP backend、Run、权限和 Subagent 合同 |
| architecture/session-management.md | Session 数据、binding、恢复、删除和 transfer |
| architecture/tool-system.md | Tool、MCP、Skill、Plugin 和权限边界 |
| architecture/memory-system.md | Memory 存储、检索、写入、隔离和维护 |
| architecture/tape-system.md | Tape、ViewManifest、回放和 Subagent lineage |
| architecture/event-system.md | typed route、typed event 和 main 内部调用规则 |
| guides/getting-started.md | 当前代码入口和本地开发命令 |
| guides/plugin-packaging.md | .dcplugin 打包、内置分发和 release 规则 |
| release-flow.md | 版本、分支、tag 和平台构建流程 |
| spec-driven-dev.md | SDD 分类、产物和清理规则 |
只有尚未完成或仍需外部验证的工作保留 plan.md / tasks.md。
| 文档 | 状态 |
|---|---|
| features/acp-v1-reliability/ | ACP capability、auth、session lifecycle 与 diagnostics 待实施 |
| features/cua-cross-platform-computer-use/ | 已实现主体，等待 CI platform matrix 验证 |
| features/mcp-oauth-authentication/ | 已实现主体，等待真实 OAuth smoke |
| architecture/chat-scroll-ownership/ | chat viewport ownership、windowing 与真实 Chromium 验证进行中 |
| architecture/remove-mcp-permission-system/ | MCP permission removal 尚未实施 |
| architecture/memory-quality-gates-and-observability/ | retrieval artifact upload 待完成 |
| architecture/memory-vector-store-v2/ | v2 已落地，保留 migration window 后的 VSS removal follow-up |
| issues/chat-history-search-scroll-coordinates/ | 等待 Electron/macOS 物理滚动验证 |
以下 feature spec 仍承担跨模块产品或扩展合同，不是实施历史：
| 文件 | 使用方 |
|---|---|
| agent-system-layered-runtime-baseline.json | architecture baseline generator test 的 canonical fixture |
| main-kernel-bridge-register.json | architecture baseline generator 的 retired boundary register |
其它 dependency、scoreboard、zero-inbound 报表由 pnpm run architecture:baseline 按需生成，
不作为长期文档。
- 当前事实写入核心 architecture、flow 或 guide，不再保留重复的 implemented SDD。
- 完成的 feature / architecture 删除
plan.md和tasks.md；只有维护合同需要时保留压缩后的spec.md。 - 已修复 issue 直接删除；历史和验证证据由 Git 与测试保存。
- active goal、未完成 task 和
[NEEDS CLARIFICATION]不得在 cleanup 中删除。 - 文档引用的路径必须存在；旧实现只通过
git log/git show查询。