dsh-tool-codegraph

在大型代码库中让 agent 做结构化代码导航一直是难点：grep 只有文本匹配、缺乏语义，而 codegraph CLI 虽然基于 AST 和 tree-sitter 提供了索引化查询，但其命令行接口并不天然适配 agent 的工作方式。dsh-tool-codegraph 将 codegraph CLI 包装为十个各司其职的专注工具，让 agent 能按"状态检查 → 索引同步 → 区域探索 → 定向查询"的流程有条不紊地理解代码结构，而不必在一个万能工具里猜测 action 参数。

核心设计上，这十个工具（status、sync、search、explore、callers、callees、impact、node、files、affected）各自返回精简的 light 输出，只有需要输出完整源码和调用路径的 explore 才会标记为 heavy 并路由到 subagent，避免主会话上下文被撑爆。插件还会自动向 system prompt 注入 orientation-first 的使用规则，并且在调用关系类工具中明确标注对动态分派边的局限性，提醒模型在不确定时回退到 grep，做到诚实而非过度承诺。

适合需要在中等或大型项目中频繁进行代码理解、重构影响评估、调用链追踪的开发者和团队使用。前提是你已经在本机安装好 codegraph CLI 并确保其在 PATH 中可用，Node 版本需为 22.19 以上。如果你希望 agent 少写猜测、多看结构，这个插件是一个低侵入力的桥梁。