代码图谱导航 m1khal3v/dsh-tool-codegraph

dsh-tool-codegraph

为 DeepSeek Harness 提供 CodeGraph 导航工具。
一个 DSH 插件，把开源 codegraph 命令行（AST/tree-sitter 代码索引）封装成十个职责明确的智能体工具 —— status、search、 callers/callees、impact、explore 等。

本包只是一层薄封装。 所有索引与查询都由 codegraph 命令行完成 —— 请先安装它，并确保它的可执行文件在 PATH 上。

⚡️ 亮点

- 🧭 先定位再动手的工作流 —— 使用规则（status → sync → explore → 定点查询）会自动注入智能体系统提示词。
- 🧰 十个职责明确的工具，一个工具只做一件事 —— 没有那种带 action 参数的万能工具。
- ⚡ O(1) 索引查询 —— 主会话只拿轻量输出，耗资源的 explore 构建交给子代理。
- ⚠️ 对可靠性实话实说 —— callers/callees/impact 可能漏掉动态分派产生的边；提示词会告诉模型什么时候该退回 grep。

🛠 环境要求

- DeepSeek Harness >=0.2.1-rc.5 <0.3.0
- Node ^22.19 || >=24
- codegraph 命令行在 PATH 上可用（可用 executable 配置项覆盖）

🚀 快速开始

1. 安装插件

dsh plugin add --profile web @m1khal3v/dsh-tool-codegraph

2. 检查被封装的命令行

codegraph status

如果找不到可执行文件，工具会返回安装提示，智能体则退回基于 grep 的搜索。

3. 初始化索引 —— 由你决定

上面这套工具里故意没有 init 工具：按 codegraph 项目自己的建议，索引该由用户发起，而不是由智能体发起。当 codegraph status 报告索引缺失时，你自己跑：

codegraph init

在你跑之前，工具会报告索引缺失，智能体继续用其他搜索工具干活。

🖥 桌面端

本插件在 DSH Desktop 和命令行里都能用：

- 通过应用的 Plugins 页面安装。
- codegraph 命令行必须在桌面宿主进程的 PATH 上可用。
- 十个工具在桌面会话里全部可用；不需要额外的客户端部分。

🧰 工具

| 工具 | 用途 | 输出 |
| codegraph_status | 索引健康状况与统计 | 轻量 |
| codegraph_sync | 同步上次索引以来的改动 | 长 |
| codegraph_search | 按名称查找符号 | 轻量 |
| codegraph_explore | 梳理某个区域，附原文源码与调用路径 | 重量 |
| codegraph_callers | 谁调用了这个符号（不健全） | 轻量 |
| codegraph_callees | 这个符号调用了什么 | 轻量 |
| codegraph_impact | 改动某个符号的影响范围 | 轻量 |
| codegraph_node | 单个符号的详情，或文件视图 | 轻量 |
| codegraph_files | 从索引中读取项目文件结构 | 轻量 |
| codegraph_affected | 找出受改动源文件影响的测试文件 | 轻量 |

⚙️ 配置

| 键 | 默认值 | 说明 |
| executable | codegraph | 被包装命令行的二进制文件名或路径 |
| queryTimeoutMs | 10000 | 普通命令的超时时间 |
| initTimeoutMs | 60000 | init / sync 的超时时间 |

🧑💻 开发

pnpm install
pnpm run verify # typecheck + test
pnpm run build

📄 许可证

MIT

基于 colbymchenry/codegraph 构建。