jiangzhenguo/dsh-codegraph

README 摘要

dsh-codegraph 让 DSH 会话直接使用 CodeGraph （ @colbymchenry/codegraph ）的预索引代码知识图谱能力。 这是一个 可一键安装的 DSH 插件 （bundle）：它把 codegraph CLI 包装成 模型可见的原生工具 ，模型在分析代码时无需 grep/读大量文件，直接按符号、 按区域、按调用链查询索引，并能自举并维护索引（ init / index / sync ）。 工具面（surface） ：借鉴上游项目「 codegraph explore 是唯一稳定赢得模型调用的工具」 的实测结论（其官方 MCP server 默认只暴露 explore），本插件 默认只注册 4 个核心工具 （ codegraph status / codegraph init / codegraph sync / codegraph explore ）， 保持模型工具列表精简、引导集中。需要全部 13 个工具时，在组合层配置 surface: 'full' （见下文「配置」）。 提供的工具 工具 对应 CLI 用途 codegraph status status --json 索引状态（是否已初始化、版本、文件/节点/边数、待同步变更、建议重建等） codegraph init init 初始化项目并建立初始索引（ .codegraph/ ） codegraph index index 全量（重）索引； status 建议 reindex 时用 codegraph sync sync 增量同步索引（改代码后调用，让查询反映新代码） codegraph uninit uninit -f 删除项目索引 codegraph query query --json 按名称/子串搜索符号，返回结构化 JSON codegraph node node 单个符号源码 + 调用/被调用轨迹，或带行号读文件 + 依赖 codegraph explore explore 自然语言探索一块代码区域，直接返回相关文件源码与调用路径 codegraph files files --json 索引内的项目文件结构 codegraph callers callers --json 谁调用了某个符号 codegraph callees callees --json 某个符号调用了什么 codegraph impact impact --json 改动某个符号会波及哪些代码（重构/改名前用） codegraph affected affected --json 改动若干源文件后应运行哪些测试文件 工具名与 CodeGraph 官方 MCP 工具同名，模型的使用心智与官方文档一致。 前置要求 1. 已安装 DSH（本插件为 DSH bundle，随 DSH we…

分类