dsh-code-atlas
在终端中运行以下命令:
dsh plugin install qlheric/dsh-code-atlas
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install qlheric/dsh-code-atlas 安装本插件(源码:https://github.com/qlheric/dsh-code-atlas),装完重启 dsh。
插件介绍
Agent 每次新开会话,往往要先在仓库里到处翻文件,才能摸清结构。代价往往不在「读」,而在「不知道该读哪个」——缺少一张能核对、能落地的仓库地图。
dsh-code-atlas 用 tree-sitter 做符号索引(走 WASM,无需本机装编译器),并生成按重要度排序的仓库地图。每个被索引文件提供一行 F/R/A/S:文件职责(F)、仓内依赖关系(R)、对外入口(A)、以及纪律词与危险写法的候选提示(S,带行号,供你自行判断,不替你做结论)。索引落在工作区内的派生缓存,删掉会重建;除缓存外只读,不写仓库。
解析器是增强而非单点:语法文件不可用或扩展名未收录时会退回正则层,索引仍会产出,符号会标明 tree-sitter 或 regex 来源。点目录默认不扫,避免无关克隆或探针目录污染地图。提供 code_atlas_index、code_atlas_map、code_atlas_search、code_atlas_symbols、code_atlas_fras 等工具,让 agent 先建图、再定点查。
适合在 DeepSeek Harness 里跑 coding agent、需要快速建立可核对仓库认知的场景。若你需要文件级调用图、增量索引或对超大单文件的覆盖,README 也标明了当前边界(如 R 仅到文件级、全量重建、单文件 512KB 上限等),可按行号回原文做精确判断。
使用场景
- 新会话要先摸清仓库结构与重点文件
- 需要按重要度浏览地图并核对符号与导出
- 要在不盲读全仓的前提下查依赖、入口与风险候选
适合人员
- 在 Harness 中运行 coding agent 的开发者
- 维护中大型仓库、希望减少「不知道该读哪个」的团队
- 需要可核对 F/R/A/S 摘要而非凭猜测导航代码的人