dsh-compass
在终端中运行以下命令:
dsh plugin install LIghtJUNction/dsh-compass
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install LIghtJUNction/dsh-compass,即可从 GitHub 仓库 https://github.com/LIghtJUNction/dsh-compass 安装该插件。
插件介绍
在 DSH 里让智能体快速摸清一个本地仓库长什么样,往往比逐文件打开更费回合。 dsh-compass 面向宿主机上的真实工作区,提供 codebase_map 与 code_tour 两个工具:先给出文件清单、各 package.json 摘要、候选入口与可校验的 map 修订号,再按路径主题(例如 auth)在支持的源码里抽取声明行,并附带路径与行号。
每次调用都会重新扫描本地文件,跳过常见构建与依赖目录,并在文件数、遍历深度等上限处明确标记截断。 map 修订号由路径、大小、时间与 package.json 文本等指纹构成,可用于 expectedRevision 拒绝过期结果;code_tour 在读文件前后还会再次核对 map,避免与并发改动严重不一致。它不做 Git ignore 语义、不做 AST 索引或引用图,也不生成架构叙事,适合需要「先有一张可信地图、再定点看声明」的场景。
插件默认以调用方智能体的工作目录为根;无智能体的宿主调用需显式指定 root,并可在 profile 的 cordis.patch.yml 里固定本地工程路径。远程 DSH 世界或沙箱不会重定向这些读写,因此只应在可信的 host-local 项目上启用。对需要在 Cordis/ToolRuntime 里做真实工具派发、限额与路径边界验证的维护者,仓库内还包含离线脚本化模型的集成测试套件。
使用场景
- 新接手仓库时先让智能体生成 codebase_map,再决定从哪些入口读起
- 按主题路径做 code_tour,例如快速浏览路径含 auth 的声明行
- 用 expectedRevision 拒绝过期地图,避免在并发改动下基于旧扫描继续操作
适合人员
- 在 DSH 中为智能体配置宿主本地工程工具链的开发者
- 需要可控、可限额扫描而非语义索引的 Agent 工作流用户
- 维护 dsh-compass 或类似 Cordis 工具插件的插件作者