索引与检索（novel-indexing-and-searching）
目标
-
先检索、再打开文件：把“回读整书”变成“精准定位到行”。
-
索引是派生缓存：写到 WORKDIR/_data/** ，可随时重建，禁止手改（WORKDIR 为工作区目录名，默认 novel ）。
核心约定（让索引靠谱）
-
关键实体使用稳定 ID（禁止用拼音做 ID）：
-
实体：char-中文名 /loc-中文名 /fac-中文名 /item-中文名 /sys-中文名
-
线索/事件：thr-#### /evt-####
-
bible 文件名通常为：char-林瑶.md /loc-旧镇.md /fac-青竹会.md 等
-
open-threads.md 与 timeline.md 尽量保持表格结构（便于解析）
最短路径工作流
- 生成/更新索引
在项目根目录执行：
python .codex/skills/novel-indexing-and-searching/scripts/build_index.py --root .
输出写入：
-
WORKDIR/_data/entities.json
-
WORKDIR/_data/chapter_index.json
-
WORKDIR/_data/threads.json
-
WORKDIR/_data/timeline.json
- 执行检索
在项目根目录执行：
python .codex/skills/novel-indexing-and-searching/scripts/search.py --root . --query "thr-0007"
常用技巧：
-
优先搜 ID（最稳定），其次搜专名（次稳定），最后才搜泛关键词
-
先在 summaries/ 与 continuity/ 搜，再回到 draft/ 精准回读正文
-
若工作区目录名不是 novel ：两条命令都加 --novel-dir WORKDIR 。