代码图谱 Asaka-RUM/dsh-codegraph

dsh-codegraph

CodeGraph for DeepSeek Harness — 预索引的代码知识图谱

Credits / 署名 — 本插件集成了 colbymchenry/codegraph（MIT，★67k+）——Rust 内核的最快完整代码图谱，随代码变更自动同步，100% 本地运行。全部图谱能力均为 CodeGraph 原作，经其自包含 CLI 原样调用；本仓库只添加了 DeepSeek Harness 插件壳。许可证与上游相同：MIT。

署名声明 — 本插件集成了 colbymchenry 的 codegraph（MIT，★67k+）——Rust 内核的最快完整代码图谱，随代码变更自动同步，100% 本地运行。全部图谱能力均为 CodeGraph 原作，经其自包含 CLI 原样调用；本仓库只添加了 DeepSeek Harness 插件壳。许可证与上游相同：MIT。

CodeGraph 为智能体提供语义级代码智能：符号、调用图、框架感知路由、爆炸半径分析，全部来自预索引图谱——比 grep 加读取的循环更省 token，更少工具调用。

本插件把 DSH 接到 codegraph CLI 上，以子进程方式运行。它刻意沿用上游自己的工具哲学：一个强工具胜过一堆窄工具，所以接口面保持极小。

工具

| 工具 | 用途 |
| codegraph_explore | 一次调用回答几乎所有代码问题——「X 怎么工作」、某条流程（「X 到达 Y」）、或某个区域的概览。返回按文件分组的符号原文 + 调用路径 + 爆炸半径。能跟踪 grep 追不到的动态派发 |
| codegraph_sync | 重构后做增量索引更新（快，只处理脏文件） |
| codegraph_status | 索引统计；最省事的「装了吗？索引了吗？」检查 |

前置条件

1. install the CLI (self-contained binary, no Node needed)
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex
or: npm i -g @colbymchenry/codegraph

2. initialize each project you want explorable (once per project)
cd your-project
codegraph init

插件会优雅降级：没有 CLI → 提示安装；项目里没有 .codegraph/ → 指向 codegraph init。

安装（插件）

git clone https://github.com/Asaka-RUM/dsh-codegraph E:\path\to\dsh-codegraph
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-codegraph" -Target "E:\path\to\dsh-codegraph"
New-Item -ItemType Junction -Path "E:\path\to\dsh-codegraph\node_modules" -Target "$env:USERPROFILE\.dsh\profiles\node_modules"
register in cordis.patch.yml insert list:
- id: codegraph
name: 'dsh-codegraph'
restart DSH

配置（cordis 补丁）

- id: codegraph
name: 'dsh-codegraph'
config:
bin: 'codegraph' # absolute path to pin a specific binary
projectPath: '' # default project root (with .codegraph/); empty = process cwd
timeoutExploreMs: 120000
maxOutputChars: 40000

设计说明

- 为什么用子进程，而不是库： npm SDK 要求宿主进程内 Node 22.5+（node:sqlite）。驱动自包含 CLI 则对宿主运行时零要求。
- 工具经济学： 上游实测「一个强探索工具」比七个窄工具更能引导智能体正确选择。其余查询（node/search/callers/callees/impact/files）在 CLI 上仍然可用。

CodeGraph 给智能体提供语义级代码智能：来自预索引图谱的符号、调用图、框架感知路由与爆炸半径分析——比 grep-再读循环更省 token、更少工具调用。

本插件以子进程方式驱动 codegraph CLI，并遵循上游自己的工具哲学：一个强工具胜过一排窄工具，插件面保持极小。

工具

| 工具 | 用途 |
| codegraph_explore | 一次调用回答几乎所有代码问题——「X 怎么实现的」「X 如何到达 Y」、区域普查。返回按文件分组的符号原文 + 调用路径 + 爆炸半径。能跟上 grep 跟不了的动态分发 |
| codegraph_sync | 重构后的增量索引更新（只解析脏文件） |
| codegraph_status | 索引统计；也是最快的「装没装 / 索没索引」检查 |

前置条件

1. 安装 CLI（自包含二进制，不需要 Node） irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex 或: npm i -g @colbymchenry/codegraph

2. 每个想查询的项目初始化一次
cd your-project
codegraph init

优雅降级：没有 CLI → 安装指引；项目无 .codegraph/ → 指向 codegraph init。

安装（插件本体）

git clone https://github.com/Asaka-RUM/dsh-codegraph E:\path\to\dsh-codegraph
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-codegraph" -Target "E:\path\to\dsh-codegraph"
New-Item -ItemType Junction -Path "E:\path\to\dsh-codegraph\node_modules" -Target "$env:USERPROFILE\.dsh\profiles\node_modules"
cordis.patch.yml insert 列表注册：
- id: codegraph
name: 'dsh-codegraph'
重启 DSH

配置（cordis patch）

- id: codegraph
name: 'dsh-codegraph'
config:
bin: 'codegraph' # 可填绝对路径锁定特定二进制 projectPath: '' # 默认项目根（含 .codegraph/）；空 = 进程 cwd timeoutExploreMs: 120000 maxOutputChars: 40000

设计说明

- 为什么用子进程而不是库： npm SDK 要求宿主进程内 Node 22.5+（node:sqlite）。驱动自包含 CLI 则对宿主运行时零要求。
- 工具经济学： 上游实测「一个强探索工具」比七个窄工具更能引导模型正确选择。其余查询（node/search/callers/callees/impact/files）在 CLI 上仍然可用。

License / 许可证

MIT — see LICENSE.

Integrates colbymchenry/codegraph (MIT). Original copyrights belong to the respective authors; DeepSeek Harness adaptation by Asaka-RUM.

集成了 colbymchenry 的 codegraph（MIT）。原始版权归各自作者所有；DeepSeek Harness 适配由 Asaka-RUM 完成。