README-local.md

MoreCode 文档全局索引与导航

本工作区是一套围绕 MoreCode 多 Agent 编排系统整理的设计文档集。

为避免阅读时混淆，这里先说明两套编号：

• 文件编号：文件名中的 01-29，表示拆分后的文档顺序。
• 文内章节号：各文档内部的 1-31，表示从总纲拆分后保留的概念章节序列。

推荐阅读入口：

1. 00-MoreCode-agent开发选型-总纲.md
2. README.md
3. 按文件编号 01 → 23 顺序阅读，或按下表中的文内章节跳转。

文档映射

文件号	文内章节	文档	主题
01	1	01-架构总览	系统定位、整体架构、设计原则
02	2	02-Coordinator	主协调者、六步管道、项目记忆集成
03	3-5	03-认知层Agent	Explorer、Impact Analyzer、Planner
04	6-8	04-执行层Agent	Coder、Reviewer、Tester
05	9-11	05-专项能力Agent	Research、DocWriter、Debugger
06	12	06-平台与环境检测	OS、Shell、编码、路径与平台注入
07	13	07-路由决策机制	路由矩阵、复杂度评估、记忆感知
08	14	08-Git并发控制	两阶段 Git、Commit Point、回滚
09	15-16	09-上下文管理与通信	上下文池、摘要通信、递归隔离
10	17	10-完整流程示例	端到端任务执行示例
11	18-19	11-能力矩阵与代码实现	能力矩阵与 Rust 核心实现
12	20	12-上下文压缩策略	四层压缩、滚动摘要、记忆联动
13	21	13-权限与沙箱安全	Guardian、任务级权限、双层沙箱
14	22	14-LLM Provider 与 Token 管理	Provider 抽象、语义缓存中间件、预算模型、多模态 Token
15	23	15-Prompt 缓存与模板管理	Prompt 分层缓存、模板管理
16	24	16-可观测性与 Hook 系统	Span、Hook、隐私控制、指标
17	25	17-递归编排模式	Map-Filter-Reduce、多层递归
18	26	18-项目记忆系统	长期记忆、增量更新、失效检测
19	27	19-设计决策记录	全局设计决策与取舍
20	28	20-Daemon模式	长程自主运行、Checkpoint、恢复
21	29	21-大文件智能读取	文件级智能读取、结构感知解析
22	30	22-中断与取消机制	分级取消、信号协议、自适应超时
23	31	23-记忆系统增强（Letta 式分层）	四层记忆、Sleep-Time Compute、迁移
24	—	24-Agent系统提示词定义	所有 Agent 的结构化 System Prompt
25	—	25-代码目录与文件命名设计	Crate 结构、目录规划、Feature Flags
26	—	26-测试体系设计	单元/集成/E2E 测试策略与 CI
27	—	27-架构统一修复方案	跨文档一致性修复方案
28	—	28-CLI颜色设计	终端 UI 颜色体系、主题、语义配色
29	—	29-用户偏好自动记录学习	用户偏好学习、自适应行为记录

推荐路径

如果你想快速理解系统：

1. 01-架构总览
2. 02-Coordinator
3. 10-完整流程示例
4. 12-上下文压缩策略
5. 17-递归编排模式
6. 18-项目记忆系统

如果你按实现层面阅读：

1. Agent 定义：01-05
2. 系统机制：06-16
3. 高级模式：17-23

如果你按概念章节阅读：

1. 先看文内章节 1-19 的基础架构。
2. 再看文内章节 20-24 的核心机制扩展。
3. 最后看文内章节 25-31 的高级能力。