dsh-code-atlas —— 给 agent 一张能核对的仓库地图（tree-sitter WASM + 每文件一行 F/R/A/S）

[qlheric]

同类里已经有 dsh-code-index（好用的符号索引）。我这个补的是它没有的那一层：每文件一行的 F/R/A/S，而且每条都能指回出处。

• F 这文件负责啥 —— 文件开头注释的原文，带行号；没注释就用主要导出兜底
• R 谁依赖我 / 我依赖谁 —— 仓内解析出来的 import；解析不了的相对导入单独列出来，不抛异常
• A 对外入口 —— 导出符号 名字@行号
• S 不能弄错的地方 —— 注释里的纪律词（必须/禁止/注意/IMPORTANT/NEVER）和危险写法（eval、child_process、rm -rf、shell:true、硬编码密钥、关 TLS 校验、777），每条带行号

S 只给候选，不给结论 —— 它只负责指出"这里有人写过规矩"或"这里出现了危险写法"，判断留给你。这样它不会编。

跑出来是什么样（本机一个真实工作区）：

252 个文件 · 2723 个符号 · 0.82 秒      （tree-sitter 252 个文件，正则兜底 0 个）

_research/dsh-cron-upstream/lib/logger.js :: F:Unified logging wrapper for dsh-cron (#204) | 被依赖 15 | 导出 2 | 关键符号 setLogger@7 logger@17

装

dsh plugin --profile <你的 profile> add github:qlheric/dsh-code-atlas

两个 WASM 依赖（web-tree-sitter、tree-sitter-wasms）会跟着装上，不用装编译器。

两个取舍值得说一下

• 解析器是增强，不是单点 —— 拿不到语法文件（版本漂了、扩展名不认）就退回正则层，索引照常出，每条符号标了来源（tree-sitter / regex）。解析器出问题不该毁掉整次索引。
• 点目录默认不扫 —— 这条是踩出来的：第一版把 .dsh_probe/ 下克隆来参考的几个仓库也扫进去了，1094 个文件、9.46 秒；加了这条线之后 252 个文件、0.82 秒。不设这道线，别人的仓库就会污染你的地图。

"导出"的判据按语言写死了：JS/TS 看 export_statement、Go 看首字母大写、Rust 看 pub / visibility_modifier、Python 和 Ruby 与 Bash 看是不是 _ 开头、C/C++ 看是不是 static。

19 个用例。已知边界：调用图还没做（R 列只到文件级依赖），索引现在是全量重建、单文件上限 512KB。

https://github.com/qlheric/dsh-code-atlas