代码图谱 LangLi7/pmh-graphify-plugin

description: "Graphify 作为 DeepSeek Harness 的 PMH 插件：三级交互式代码图、节点搜索、代码查看器，以及一个会自我安装的命令行。"
kind: "plugin"

pmh-graphify-plugin

Graphify 作为 DeepSeek Harness 的 PMH 插件。 侧边栏入口、三级代码图绘制、节点搜索、枢纽节点、代码查看器，还有一个命令行——首次启动时若缺失，它会自己装上。

整张图作为地图

示例数据预览（无宿主环境的检查页面），不是真实仓库的图。

展示内容

- 三级视图，可在工具栏切换：
- 总览 —— 在 16 个最大分组中各取样本；每个分组从最重要的节点开始扩展选取，于是彩色岛屿浮现出来
- 分组 —— 某个分组的全部节点
- 邻域 —— 某个节点的周边，深度 1–3
- 画布图，采用力导向布局：滚轮以指针为中心缩放，拖拽可移动节点和画布，⤢ 适配视图，「Arrange」重新布局
- 搜索覆盖名称、类型和路径；最大枢纽作为快捷入口
- 节点数据：类型、路径、分组、链接；邻居节点可点击
- 代码查看器带行号和语法高亮；编辑支持 Ctrl+S，有未保存改动时会提示
- 构建图通过宿主路由运行 graphify extract
- 自我安装：命令行缺失时，通过 uv、pipx 或 pip 拉取——见下文

安装

要求：带 Web 界面的 DeepSeek Harness 和 Bun。命令行自我安装还需要 uv、pipx 或 Python（可选）。

git clone https://github.com/LangLi7/pmh-graphify-plugin.git
cd pmh-graphify-plugin
bun run build # optional — lib/ is shipped

然后在插件管理器中安装 pmh-graphify-plugin 文件夹（入口为 pmh-graphify），并重启宿主一次。这个包既是 bundle 也是插件：dsh.bundle.patch 注册宿主部分，dsh.client 注册浏览器部分。它没有工作区依赖；宿主部分已打包，浏览器部分以成品模块形式发布。

重启后，Graphify 出现在侧边栏。如果还没有图，构建图按钮会跑第一遍。

Graphify 随包而来

启动时，插件会检查命令行是否可用——在 command 下、在 PATH 中，以及已知的 uv 位置。如果缺失且 setup 为 auto（默认值），服务商会在后台安装一次：

| 顺序 | 检测方式 | 命令 |
| 1 | uv | uv tool install graphifyy |
| 2 | pipx | pipx install graphifyy |
| 3 | python/python3/py | python -m pip install --user graphifyy |

成功后，解析出的路径会存为 command。如果没有可用的包管理器，不会自动做任何事；面板会显示对应平台的说明。

命令行缺失时的安装框命令行缺失时，面板会显示一个框，里面有路由、立即安装、输出，以及「启动时自动安装」开关。要关掉它：

// $DSH_HOME/world/graphify.json
{ "command": "graphify", "outDir": "graphify-out", "root": ".", "setup": "never" }

setup 接受 auto、ask 和 never。只安装 PyPI 包 graphifyy；不用 sudo，不用 curl | sh，不下载安装器，五分钟超时。

MCP 服务器仍然是单独的配置档条目——它跟机器绑定，不该放进插件里：

- insert:
- id: graphify-mcp
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: graphify
transport: stdio
command: 'C:\Users\Chang\.local\bin\graphify-mcp.exe'
args: ['--graph', 'C:\Users\Chang\prometheus-harness\graphify-out\graph.json']
env: {}
cwd: 'C:\Users\Chang\prometheus-harness'

设置

插件设置 → Graphify：

| 字段 | 取值 | 默认值 | 作用 |
| surface | sidebar · plugins · both · none | sidebar | 插件出现的位置 |
| order | 数字 | 12 | 在侧边栏或列表中的位置 |
| label | 文本 | 空 | 自定义标签 |
| view | split · graph · list | split | 打开哪些窗格 |
| level | gesamt · gruppe · nachbarschaft | gesamt | 打开时的层级 |
| depth | 1–3 | 2 | 邻域步数 |
| limit | 20–400 | 160 | 最多绘制的节点数 |
| labels | true/false | true | 节点上显示名称 |
| colour | community · kind | community | 按分组或按类型着色 |
| motion | true/false | true | 拖动时持续计算布局 |
| inspector | right · below · off | right | 节点数据放在哪里 |

路由

所有路由都在 /api/world/graphify 下，只响应回环请求。

| 路径 | 方法 | 响应 |
| /status | GET | 命令行、输出目录、节点/边 |
| /graph | GET | world 形式的图 |
| /run | POST | 运行 { mode: "deep" \| "update" } |
| /config | GET/POST | { command, outDir, root, setup } |
| /setup | GET | 命令行、uv、pipx、Python、路由、上次尝试 |
| /setup | POST | 安装 { method: "uv" \| "pipx" \| "pip" } |
| /file?path=… | GET | 文本文件的 { path, content, language, lines } |
| /file | POST | 保存 { path, content } |

目录结构

src/host/ provider: routes, configuration, self-install, mapping
src/client/ panel, canvas, force layout, texts (de/en)
lib/ built halves (index.js, client.js)
build.mjs builds both halves

host 部分打包后只导入 @deepseek-ai/schemastery。浏览器部分从外部加载 React，自带文本；如果 graphify 命名空间已被语言包占用，则由该语言包的文本接管。

限制

- 概览是采样（16 个分组，默认 160 个节点），不是整张图： 36,000 个节点画不成一张图。搜索和枢纽能带你走完其余部分。
- Group 最多显示该组的 limit 个节点，按度数排序。
- 布局在浏览器里运行；400 个节点仍然流畅，再多就会被截断。
- 文件路由每次请求都读取整张图（本地 21 MB 时约 0.5 秒）。

来源

提取自 LangLi7/prometheus-harness，截至 2026-10-21（packages/plugin/graphify 和 packages/world/graphify）。在原仓库里，插件与语言包一起运行；这份副本是独立构建的。

许可

尚未选定许可证。任何复用该仓库的人都应先选一个（比如 MIT）；在那之前，版权默认适用。