dsh-tool-reading-map

当 DeepSeek Harness 的 agent 面对一个陌生仓库时，最常见的失败模式是逐文件试探——打开这个、再看那个，既慢又容易遗漏全局结构。dsh-tool-reading-map 要解决的就是这个问题：在 agent 动笔编辑之前，先给它一张结构化、按优先级排好序的仓库地图，让它带着全局视野工作。

核心能力有三块。第一，文件按「配置 > 入口 > 源码 > 其他」的优先级排列，每个条目附带语言、角色、行数、大小和有限预览，配置和入口文件保持完整不截断。第二，每次运行都会输出一份诚实的覆盖率报告——多少候选文件、保留了多少、跳过了哪些目录、因过大或二进制被丢弃了哪些，绝不让一份局部地图伪装成全局。第三，整个扫描过程是确定性的，不调用模型，廉价、快速、可重放。

排序与跳过启发式移植自 RepoWiki 扫描器，在数千个仓库上经过验证。它适合所有用 dsh 驱动 agent 进行跨仓库开发、代码评审或重构的工程师：只要需要 agent 先「读懂」一个仓库再动手，这张地图就是最经济的起点。