代码图谱 lovedheart/dsh-plugin-codegraph

dsh-plugin-codegraph

一个 DeepSeek Harness 插件，将本地 CodeGraph CLI 暴露为面向模型的工具。

CodeGraph 是一个 100% 本地的代码智能引擎：它将项目的符号及其关系索引到 .codegraph/ 知识图谱中，并以远少于 grep/read 循环的 token 数和往返次数回答结构性问题（X 在哪里、谁调用了 Y、如果我修改 Z 会破坏什么、给我看看 W 附近的区域）。此插件通过 shell 调用 codegraph 二进制文件，因此智能体可以获得与 CodeGraph 自带 MCP 服务器相同的强大能力——无需管理额外的守护进程。

提供的工具

| 工具 | 描述 |
| codegraph_status | 索引健康检查（是否已初始化、文件/节点/边数量、语言、待处理的更改）。始终成功退出。 |
| codegraph_init | 在项目目录中初始化 CodeGraph 并构建初始索引。 |
| codegraph_sync | 使用最近的更改增量同步现有索引（快速）。 |
| codegraph_search | 按名称快速搜索符号——仅返回位置，不返回代码。 |
| codegraph_explore | 主要工具——在一次有上限的调用中返回相关符号的逐字、带行号源代码 + 调用路径。 |
| codegraph_node | 读取一个符号（源代码 + 调用者/被调用者轨迹）或一个完整文件（行号 + 依赖方）。对于已索引的源文件，请使用此工具代替 Read。 |
| codegraph_files | 已索引的文件结构（路径、语言、符号数量、大小）。 |
| codegraph_callers | 列出调用某个符号的函数/方法。 |
| codegraph_callees | 列出某个符号所调用的函数/方法。 |
| codegraph_impact | 影响范围分析——修改某个符号会影响哪些内容。 |

每个工具都接受一个可选的 path（项目根目录，或其中的任意文件夹）以定位特定的代码库；省略它则使用配置的默认项目。

先决条件

1. 已安装 DeepSeek Harness（dsh CLI 可用）。
2. 已安装 CodeGraph 并在 PATH 中：
npm install -g @colbymchenry/codegraph
(or review and run the installer script from the CodeGraph repo)
codegraph version # sanity check

3. pnpm 可用（DSH 插件管理底层使用 pnpm）。

安装

从本地目录（开发）

cd /path/to/dsh-plugin-codegraph
dsh plugin --profile add ./dsh-plugin-codegraph

从 git 仓库

dsh plugin --profile add git+https://github.com/you/dsh-plugin-codegraph.git

从 npm registry（发布后）

dsh plugin --profile add dsh-plugin-codegraph

验证该层已组合到你的 profile 中：

dsh --profile --dump-config # look for a "# == dsh-plugin-codegraph" layer

之后可使用 dsh plugin --profile remove dsh-plugin-codegraph 移除。

配置

该插件从它所贡献的 tool-codegraph 条目中读取配置 (参见 cordis.patch.yml)。覆盖你配置文件中 cordis.patch.yml 的任何值：

- id: tool-codegraph
config:
binPath: 'codegraph' # codegraph 二进制文件（通过 PATH 解析） defaultProjectPath: '' # 空 = harness 工作目录 timeoutMs: 60000 # 查询工具 indexTimeoutMs: 300000 # 大型仓库上的 init/sync defaultLimit: 10 # 符号搜索限制

补丁层会替换某一行的整个 config 值，因此请重新声明你想保留的每一个键。

用法

1. 安装插件

dsh plugin --profile web add ./dsh-plugin-codegraph

2. 确保目标项目已建立索引

智能体可以检查并（在你同意后）构建索引：

Is my project at /home/me/myapp indexed by CodeGraph?

或直接从 shell 执行：

cd /home/me/myapp
codegraph init # first time
codegraph sync # after edits

3. 提出结构性问题

How does authentication work in this codebase?
Who calls the parseConfig function?
What would break if I change SessionStore.get?

智能体会自动将这些请求路由到 codegraph_explore / codegraph_callers / codegraph_impact。

开发

npm install # resolves peer deps for local testing
node test-plugin.mjs

冒烟测试会针对一个伪造的 Cordis 上下文启动 apply()，并针对一个已建立索引的小型项目（CG_TEST_PROJECT，默认为 /tmp/cg-test）执行每一个工具。要构建测试项目：

codegraph init /tmp/cg-test

架构

┌──────────────────────────────────────────┐
│ DeepSeek Harness agent │
│ ┌────────────────────────────────────┐ │
│ │ dsh-plugin-codegraph │ │
│ │ - 10 tool definitions │ │
│ │ - CLI runner (lib/client.js) │ │
│ └──────────────────┬─────────────────┘ │
│ │ spawn(codegraph) │
└─────────────────────┼────────────────────┘
▼
┌─────────────────────────────┐
│ codegraph CLI (local) │
│ .codegraph/ SQLite index │
└─────────────────────────────┘

许可证

MIT