Documentation
README
Codebase Index
索引是什么
- 位置:
docs/code-index/<crate>.md,跨模块链路在docs/code-index/cross-crate.md - 本质:行为 → 文件 的速查表。查询者带着「我想改 X 的 Y」进来,带着文件路径和入口函数出去
- 原则:只给定位信息 + 一句话关键逻辑;不解释原理、不复制规范正文、不替代设计文档
- 体积:每个文件 100–200 行,全部读入没有负担。索引存在的意义就是让"找文件"这一步从几十次搜索变成一次读表
查找流程(查询者视角,最常用)
- 判断行为落在哪个 crate;不确定就 Glob
docs/code-index/*.md并全部读入 - 在速查表里按行为关键词匹配条目(compact / keepgoing / is_direct / cancel / middleware / prompt …)
- 打开主文件,跳转到入口函数
- 索引里的一句话关键逻辑只用于导航;行为细节一律以代码为准
- 跨模块链路看各索引的「跨模块契约」节或 cross-crate.md,那里指向
docs/standards/architecture-contracts.md的 ARC 编号(不复制正文)
构建/更新流程(构建者视角)
触发时机:索引缺失、行为变更后索引过期、用户要求重建/扩充。
输入:目标 crate 源码 + 该 crate 的 CLAUDE.md + docs/standards/architecture-contracts.md(跨模块契约)+ 相关 docs/design/ 文档 + spec/issues/ 中最近的相关 issue。
步骤:
This is the opening of the README. Read the full README on GitHub.