在 DeepSeek Harness (DSH) 中开发智能体时,让模型理解代码库的结构、依赖关系和调用链是一个常见挑战。dsh-gitnexus-plugin 作为一个插件,将代码库索引为知识图谱,并通过 MCP 工具暴露给 DSH 代理。
插件定位¶
这是一个针对 DeepSeek Harness (DSH) 的 GitNexus 集成插件。由维护者 akash-digitavision 开发。它建立在 GitNexus 之上,为代理提供架构清晰度,以便分析依赖关系和执行流。
核心功能¶
插件通过 mcp__gitnexus__* 工具暴露以下能力:
- query:跨图谱搜索概念或执行流。
- context:获取特定符号的完整上下文。
- impact:在编辑符号之前分析波及范围(调用者、进程、风险)。
- explain:解释文件/符号的污点发现和结构。
- detect_changes:提交前分析图变更。
- rename:执行调用图感知的重命名。
此外,插件会生成 GitNexus stdio MCP 服务器,并在配置中插入 HOST-plane 行 mcp-gitnexus。
安装与启用¶
要安装此插件,请使用官方 DSH CLI:
dsh plugin --profile web add github:akash-digitavision/dsh-gitnexus-plugin
安装后,重启 DeepSeek Harness。DSH 将在启动时自动加载并注册插件。配置完全由 cordis.patch.yml 文件提供。
先决条件¶
此插件依赖于 GitNexus 环境:
- Node.js >= 20:由 GitNexus 要求。
- GitNexus CLI:推荐全局安装以实现快速启动,避免
npx的冷缓存延迟。
安装 GitNexus:
npm i -g gitnexus
索引任意仓库以使其可查询:
cd your-repo
gitnexus analyze
配置与使用¶
插件通过 stdio 传输生成 GitNexus MCP 服务器。命令解析优先级如下:
GITNEXUS_COMMAND环境变量(绝对路径)。- 否则,从
PATH检索gitnexus。
Windows 注意事项: npm 的全局 gitnexus 是一个 .cmd shim。如果 MCP 客户端无法生成它,请显式固定并重启 DSH:
setx GITNEXUS_COMMAND "%APPDATA%\npm\gitnexus.cmd"
注意事项¶
- 超时:工具超时设置为 120 秒。
- 许可证:MIT。