Status: AUTHORITATIVE（仅指本索引） Last updated: 2026-10-18

英文使用者从 README.md 开始。技术文档为中文。本文是文档路由：先看状态等级，再按读者路径选文档。

English readers start at README.md. This index is bilingual; the technical documents themselves are written in Chinese.

每份文档顶部标注四种状态之一。这是本仓库最重要的一条约定：没有状态标注的文档不能被当成事实依据。

每份文档必须在顶部自带状态标注；本索引只做汇总，不能代替标注。跳过本索引直接打开权威文档时，也应能从文件顶部看到状态与核对情况。

按顺序读，不要通读全仓库文档：

1. docs/PROJECT_STATE.md —— 当前状态快照（稳定 / 实验 / 不支持 / 调查中）
2. docs/ARCHITECTURE.md —— 系统现在怎么工作
3. docs/INTERFACES.md —— 合同与兼容边界
4. docs/decisions/README.md —— 已批准决策索引
5. 只在需要证据时读 docs/research/

不要默认读 docs/archive/。

1. 本任务涉及的合同文档（INTERFACES.md / ZCODE_RUNTIME.md / SHARED_CORE.md）
2. 对应组件的架构（ARCHITECTURE.md）
3. AGENTS.md 里的硬规则

实现不能自行改写合同。需要改合同先提 DECISION。

最后核对 表示上一次有人把文档内容与代码对照的日期及范围；标记为未记录的条目仍缺少核对证据。新建和修改文档时必须填写，否则该文档只能算"最后更新"，不能算"已验证"。本地回归不代表真实 provider 或长期运行通过。

带日期的研究目录可以自带 README 作为该主题的文档地图；逐篇条目写在那份 README 里，不重复列在本索引。

以下内容有意不放进仓库，追溯时按下表位置查找：

桥接运行数据根 .tasks/ 只放任务记录，不要在那里存放研究用的外部仓库克隆。

公开审查说明汇总修改、来源、历史实测与当前分支验证；决策为ADR-007和ADR-008。私人任务状态索引、日志和快照不进入本分支。