MIT 开源的 DeepSeek Harness 原生插件，对接 Graphify 本地代码知识图谱引擎：`/graphify` 建图，agent 直接查询符号、依赖与架构社区，compact 模式专为本地小模型设计。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-10-31
许可证
MIT
01它能帮你完成什么？
用图驱动的代码地图回答架构问题，不再反复猜路径、翻文件
从 `graphify-out/graph.json` 取出符号、依赖路径、架构社区和图支撑的项目上下文
在 DSH 会话里探索或接手一个仓库的开发者
改动接口之前先评估影响面
到调用方的依赖路径、被依赖方、最短路径、所属社区，以及 PR 影响分析（full 模式）
在 DSH 会话里评审高风险改动的工程师
让本地小模型在会话里稳定地用上图谱
compact 模式注册六个高频工具：状态、图谱查询、节点查看、邻居、最短路径、会话级图谱资源
在 DeepSeek Harness 里跑本地 20B–30B 模型、工具选择能力有限的团队
02如何接入 DeepSeek Harness？
前置条件
- 一个可用的 DeepSeek Harness（DSH）profile
- Node.js 22.18 或更高版本
- Python 3.10 或更高版本
- `uv`——安装 Graphify 运行时要用
安装步骤
- 01
把插件加入 DSH profile：运行 `dsh plugin --profile <profile> add dsh-graphify`（把 <profile> 换成你平时跑 DSH 的那个；bundle 会自行激活，默认配置不用手动改 Cordis 配置）
$ dsh plugin --profile <profile> add dsh-graphify
- 02
安装本地 Graphify 运行时：运行 `uv tool install 'graphifyy[mcp]==0.9.57'`——如果是 DSH 启动之后才装的，装完喊一声 `graphify_status`，插件会在下次检查或工具调用时自动发现运行时，不用重启 DSH
- 03
建图：在你想探索的仓库目录下启动 DSH（`cd /path/to/your/repository && dsh --profile <profile>`），会话里运行 `/graphify`——完整构建，会在仓库里写入 `graphify-out/graph.json`
验证接入成功
- 在 DSH 会话里运行 `graphify_status`：它会报告解析出的项目、图路径、运行时可用性、连接状态，以及图是否与已索引的源码状态一致
03DSH 适配与能力边界
DSH 原生插件，通过 `dsh plugin add` 加入：解析当前会话项目、管理 Graphify MCP 进程、在会话里注册图谱工具
/graphify 建图与更新
DSH 会话启动时所在的仓库→完整构建并写入 `graphify-out/graph.json`，或通过 `/graphify update` 做保守的纯代码增量更新
会在仓库里写入 `graphify-out/graph.json`增量更新只对插件能证明是纯代码的改动执行；否则图保持「已过期」标记，直到跑一次完整 `/graphify` 构建full / compact 工具模式
`toolMode` 配置——`full`（默认）或 `compact`→full 暴露完整 Graphify 能力集（含社区、god node、PR 影响）；compact 只注册六个高频导航工具，面向本地 20B–30B 模型
graphify_status 诊断
在 DSH 会话里调用→解析出的项目、图路径、运行时可用性、连接状态，以及图与已索引源码状态是否一致
会话级项目解析与隔离
当前 DSH 工作区→图谱请求跟随当前会话项目
默认阻止模型访问工作区之外的项目；需要时显式设置 `allowExternalProjects: true`本地运行时韧性管理
本地安装的 Graphify 运行时（uv tool）→自动发现运行时、MCP 进程意外退出后自动重连、可通过 `graphifyVersion` 固定 uv 回退版本
插件会为会话管理 Graphify MCP 进程
04适合谁？何时不该用？
适合
- 在 DSH 会话里探索或接手一个仓库的开发者
- 在 DSH 会话里评审高风险改动的工程师
- 在 DeepSeek Harness 里跑本地 20B–30B 模型、工具选择能力有限的团队
不适合
- 增量更新只覆盖代码提取。改了文档、包元数据或配置之后，图会进入过期状态，需要完整 `/graphify` 重建；`freshness.mode` 默认 `warn`（想要查询前自动做安全更新就设 `auto`，只在刻意接受静态图时才设 `off`）。
05兼容性、维护与安全提示
- 仅在 macOS 和 Ubuntu Linux 上测试过，Windows 尚未验证。整套栈还需要 Node.js 22.18+、Python 3.10+ 和 `uv`。
- 支持 `@deepseek-ai/cordis` >=4.0.4 <5；针对 DeepSeek Harness 0.2.0-rc.2（及 0.2.1-alpha 通道）和 Graphify 0.9.57 测试，契约与 schema 漂移检查在 Graphify 0.9.90 上也通过。
- 增量更新只覆盖代码提取。改了文档、包元数据或配置之后，图会进入过期状态，需要完整 `/graphify` 重建；`freshness.mode` 默认 `warn`（想要查询前自动做安全更新就设 `auto`，只在刻意接受静态图时才设 `off`）。
- 图谱请求跟随当前 DSH 工作区；除非刻意设置 `allowExternalProjects: true`，模型无法访问工作区之外的项目。
- 仓库里的 BENCHMARK.md 定义的是针对 Graphify 辅助 agent 的规划中评估协议——是实验性方案，不是已发布的性能数据。
MIT · 持续维护中（最新发布 v0.2.1，2026-10-13）
06常见问题
Graphify 是什么？
Graphify 是一个本地代码知识图谱引擎，把仓库里的符号、依赖和架构社区建成一张图，上游项目托管在 GitHub（Graphify-Labs/graphify）。dsh-graphify 则是 DeepSeek Harness 原生的插件层，负责把 DSH 会话接到这张图上——引擎和插件分开安装：引擎用 `uv tool install 'graphifyy[mcp]==0.9.57'`，插件用 `dsh plugin add dsh-graphify`。
dsh-graphify 怎么安装？
三步：先用 `dsh plugin --profile <profile> add dsh-graphify` 把插件加入 DSH profile；再用 `uv tool install 'graphifyy[mcp]==0.9.57'` 装运行时；最后在你想探索的仓库目录下启动 DSH，运行 `/graphify`。前置条件：可用的 DSH profile、Node.js 22.18+、Python 3.10+ 和 `uv`。
Graphify 如何把代码库变成知识图谱？
在你的仓库目录下启动 DSH，会话里运行 `/graphify`：命令会做一次完整构建，生成 `graphify-out/graph.json`，把符号、依赖、架构社区和 god node 都映射进图。更新策略偏保守——增量更新只覆盖代码提取，改了文档或配置之后要跑一次完整 `/graphify` 重建。
full 和 compact 模式有什么区别？
默认的 `full` 模式暴露完整 Graphify 能力集，包括社区、god node 和 PR 影响分析。`compact` 只注册六个高频工具——状态、图谱查询、节点查看、邻居、最短路径、会话级图谱资源——更适合本地 20B–30B 模型：选择变少，小模型反而能更稳定地用上图谱。
支持 Windows 吗？
插件在 macOS 和 Ubuntu Linux 上测试过，Windows 尚未验证。兼容 `@deepseek-ai/cordis` >=4.0.4 <5，针对 DeepSeek Harness 0.2.0-rc.2（含 0.2.1-alpha 通道）和 Graphify 0.9.57 测试，Graphify 0.9.90 也通过了契约与 schema 漂移检查。
07相关的 DSH 工作流
weknora
作者 tencent
开源的 LLM 知识库平台：把原始文档转化为可检索的 RAG 知识库、自主推理智能体和自动维护的 Wiki 系统，支持多租户部署。
honcho
作者 plastic-labs
用于构建有状态 AI 智能体的记忆库，支持跨会话连续学习与上下文工程。
webnovel-writer
作者 lingfengqaq
基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。
mirage
作者 strukto-ai
全球首个面向 AI 智能体的统一虚拟文件系统。
08数据与来源
`dsh-graphify` connects [Graphify](https://github.com/Graphify-Labs/graphify)'s code knowledge graph to DeepSeek Harness…
The plugin resolves the active session project, manages the Graphify process, and provides `graphify_status` for diagnos…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-10-31。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。