proj-doc-builder:让 AI 读得懂、能校验的工程文档索引
proj-doc-builder 由 walvka-code 维护,以 DeepSeek Harness bundle(@walvka-code/proj-doc-builder)和普通 CLI 两种形态发布,归类为工作流插件,面向「让模型读懂陌生代码库」和「文档已同步要有凭据」这两个痛点。它为每个源码目录维护一份 Markdown 大纲,用 _scan_state.json 的内容哈希和 _manifest.json 做改动基线,发布走可回滚事务,退役文档默认只报告不删除。加载器 load_docs.py 先校验 manifest 与磁盘文档逐份一致,再按需输出概览、单份文档或单个小节。文章按它解决什么、七项核心保证、三种安装方式、典型命令、六阶段工作流与数据模型、平台验证状态与测试、适用场景与注意事项的顺序展开,所有命令、字段和阈值均取自 README 与 package.json。
阅读全文