前言¶
在 DeepSeek Harness (DSH) 中，Agent 通常依赖大量 grep、glob 和 read_file 调用来重构代码库结构。这种方式消耗昂贵的上下文，且效率低下。dsh-simple-codegraph 旨在解决这一痛点，它为每个 DSH Agent 提供独立的、项目范围的 CodeGraph MCP 连接，使 Agent 能够通过一次集中的探索调用获取相关的源代码、调用层次结构和影响范围。
插件简介¶
dsh-simple-codegraph 是一个由 QuantumKuba 维护的 DSH 插件。它提供生产级、按代理隔离的 CodeGraph 集成，采用 MIT 许可证。
核心特性¶
- 真正的代理隔离：每个活动 Agent 都会收到一个作用域内的 CodeGraph MCP stdio 进程，并固定在各自的工作目录中。
- 同时多项目支持：多个 Agent 可以在零跨项目泄漏的情况下在单独的仓库中并发工作。
- 单工具理念：默认仅暴露
codegraph_explore，以最小化模式开销并消除工具选择混淆。 - 零配置捆绑：通过
dsh plugin add原生安装，并自动向上发现仓库根目录（.codegraph/）。 - 压缩安全架构：保持
CODEGRAPH_EXPLORE_DEDUP禁用，确保 DSH 上下文修剪不会使后续模型查询无效。 - 第一回合握手保证：预组装提示工具，确保 MCP stdio 握手在第一回合提示分发前完成。
安装与前置要求¶
在安装插件之前，需确保已安装 CodeGraph CLI 并对目标项目进行了索引。
- 检查安装
codegraph --version
- 初始化项目
cd /path/to/my-project
codegraph init
- 安装插件
将插件添加到指定的 DSH 配置文件（例如web、coding或默认配置）：
dsh plugin --profile web add dsh-simple-codegraph
典型用法¶
安装完成后，在已索引的仓库中启动 DSH。插件会自动为每个 Agent 会话启动 CodeGraph MCP 服务器，并在第一回合中暴露 mcp__codegraph__codegraph_explore。
cd /path/to/my-project
dsh --profile web
注意事项¶
- 环境要求：需要先安装 CodeGraph CLI。
- 模型优化：插件针对本地 20B–30B 模型进行了优化（例如 Qwen 2.5/3.x 27B/32B，DeepSeek 蒸馏版）。在资源受限的环境中，工具模式消耗宝贵的上下文，重复的文件读取速度较慢，且不必要的 Agent 循环会导致漂移。
- 许可证：插件采用 MIT 许可证。
总结¶
该插件通过提供独立的 MCP 连接和单工具接口，简化了 Agent 对代码库的理解过程。开发者可以通过标准的 DSH 插件命令直接启用，无需手动配置复杂的 MCP 连接参数。
