dsh-codegraph-native
plxloyzb/dsh-codegraph-native
Native DSH bundle wrapping the codegraph CLI as model-visible codegraph_* tools (status/init/index/sync/uninit/query/node/explore/files/callers/callees/impact/affected).
インストール
dsh plugin --profile web add github:plxloyzb/dsh-codegraph-nativeREADME
dsh-codegraph-native
把 codegraph CLI（@colbymchenry/codegraph）
包装成 DSH 原生模型工具的 bundle。取代之前的 dsh-mcp-client + codegraph serve --mcp
配置：工具始终可用（不依赖 MCP 的「未索引即 0 工具」行为），且模型能自举和维护索引。
工具
默认（surface: 'full'）注册全部 13 个：
| 工具 | CLI | 用途 |
|---|---|---|
codegraph_status | status --json <path> | 索引状态（是否已初始化等） |
codegraph_init | init -y <path> | 初始化并建索引（模型被指引先询问用户） |
codegraph_index | index <path> | 全量重建索引 |
codegraph_sync | sync <path> | 增量同步（改码后调用） |
codegraph_uninit | uninit --force <path> | 删除索引（模型被指引先确认） |
codegraph_query | query --json --path <p> | 按名搜索符号 |
codegraph_node | node --path <p> | 单符号源码 + 调用轨迹 / 文件模式 |
codegraph_explore | explore --path <p> | 自然语言探索区域，一次返回源码+调用链 |
codegraph_files | files --json --path <p> | 索引内文件结构 |
codegraph_callers | callers --json --path <p> | 谁调用了某符号 |
codegraph_callees | callees --json --path <p> | 某符号调用了什么 |
codegraph_impact | impact --json --path <p> | 改动波及分析 |
codegraph_affected | affected --json --path <p> | 改动后应跑哪些测试 |
surface: 'core' 只注册 status / init / sync / explore。
与社区版 dsh-codegraph 的差异
- 依赖用
inject声明（tools/systemPrompt/subprocess）：cordis 等服务就绪才加载插件， 无惰性解析、无 shell 回退。 - 非零退出是报告不是抛错：输出追加
[exit code: N]marker（官方 bash 工具的约定）， 仅 spawn 级故障走 isError。 init带-y（非交互），避免交互提示挂住工具调用。- 温和指引：
guideSearch（默认开）注入 order 98 的系统提示段——已索引时优先codegraph_explore，未索引时先问用户是否 init，查询无果时回退内置 grep/glob/read。 无 MUST/INSTEAD 措辞。 - 无 frontload：社区版的
agent/inbox/inserted事件在 DSH 0.1.1-rc.2 中不存在（死代码）， 这里不实现任何 prompt 前置注入。
安装
dsh plugin --profile web add /Users/bruceplxl/Workspace/dsh-related/dsh-codegraph-native
dsh plugin --profile headless add /Users/bruceplxl/Workspace/dsh-related/dsh-codegraph-native
dsh plugin --profile desktop add /Users/bruceplxl/Workspace/dsh-related/dsh-codegraph-native
前置要求：codegraph CLI 在 PATH 上（npm i -g @colbymchenry/codegraph）。
依赖解析：web profile 的 node_modules 为 hoisted 布局，@deepseek-ai/dsh-tools 等以
peerDependencies 声明，与 harness 同源（与 dsh-arc-context 同一模式）。
配置
在 profile 的 cordis.patch.yml 里覆盖该行 config：
- id: dsh-codegraph-native
config:
surface: core # 默认 full；core 只注册 4 个工具
guideSearch: false # 默认 true；false 则不注入系统提示段
注意：补丁替换整行 config，需重申全部键。
测试
node test/run.mjs # 24 项检查：注册/门控/真实 CLI 往返/失败路径
目录里的 node_modules 是指向 ~/.dsh/profiles/node_modules 的符号链接，
仅供独立运行测试用；profile 内安装时不参与。