dsh-graphify-plugin

把 Graphify 代码知识图谱接入 DSH，注册依赖遍历、God Nodes、社区聚类、最短路径和 PR 影响分析工具，并通过本地 MCP stdio 子进程查询 graphify-out。

• 隔离代码仓库（必需）：只在可恢复的测试仓库生成图谱，不让插件扫描个人目录或生产源码。
• Python 3.10+ 与 Graphify（必需）：预先固定并审查 graphifyy 版本；不要依赖首次启动时临时下载未知版本。
• Node.js 20+ 与 DSH Web（必需）：使用独立 DSH Web Profile，确保子进程和索引可随时停止及清理。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.1.1-rc.2

安装来源

GitHub 源码（锁定提交）

固定目标

dsh-graphify@0.1.0

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   GitHub 源码（锁定提交）复制命令

   npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add dsh-graphify@0.1.0

3. 03
   如遇构建脚本拦截

   GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。

4. 04
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-graphify或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config

5. 05
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-graphify

隔离仓库/graphify-out/graph.json

Graphify 生成的代码知识图谱，插件默认从工作区及父目录自动发现。

profiles/web/cordis.patch.yml

启用 dsh-graphify，并限制工作目录、图谱路径和单次工具超时。

- insert:
    - id: graphify
      name: dsh-graphify
      config:
        cwd: /绝对路径/隔离测试仓库
        graphPath: /绝对路径/隔离测试仓库/graphify-out/graph.json
        autoDetect: false
        enablePromptSection: true
        timeoutMs: 60000

1. 先在隔离仓库中用已固定的 Graphify 版本执行索引，确认 graphify-out/graph.json、GRAPH_REPORT.md 和 graph.html 生成。
2. 把 cwd 与 graphPath 写成隔离仓库绝对路径并关闭 autoDetect，避免向父目录扩大扫描范围。
3. 重启独立 DSH Web Profile，观察 Graphify MCP 子进程是否只在该仓库内启动。

1. 01
   检查隔离仓库中的 graphify-out/graph.json 是否存在，并记录生成工具的固定版本。

   期望结果：图谱文件位于预期目录，未在仓库父目录或其他工作区产生额外 graphify-out。

2. 02
   查看 web Profile 组合配置，确认 cwd、graphPath、autoDetect=false 和 60 秒超时生效。

   期望结果：组合配置只指向隔离仓库，不包含个人目录或生产仓库路径。

3. 03
   在测试会话中请求只读查询关键节点，不触发重新索引或 GitHub PR 工具。

   期望结果：Agent 返回图谱节点或明确错误；测试过程中不修改源码，也不访问未授权 GitHub 数据。

• 查询隔离仓库的 God Nodes，并解释它们为什么可能影响多个模块；不要修改文件。
• 查找测试模块 A 到模块 B 的最短依赖路径，只返回节点和边。

会启动 uv 或 Python Graphify MCP 子进程、扫描项目及父目录、读取或生成 graphify-out，并允许模型工具或斜杠命令传入项目路径；PR 工具还可能访问 GitHub。

数据存储：Graphify 把 graph.json、报告和 HTML 写入测试仓库 graphify-out；dsh-graphify 通过本地 stdio 子进程读取这些文件，本身不声明独立云端存储。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

找不到 uv、Python 或 graphify

不要让插件临时拉取未知版本；先在隔离环境固定安装 graphifyy，并把 command 与 args 指向该受控环境。

提示找不到 graph.json

在隔离仓库重新生成 graphify-out/graph.json，并使用明确 graphPath 和 cwd，保持 autoDetect 关闭。

大型仓库查询超时

先缩小测试仓库或重新生成图谱；确认资源占用可接受后再谨慎提高 timeoutMs。