dsh-kgraph-plugin — 项目知识图谱
English | 中文
> DSH（DeepSeek Harness）组合包插件：只读扫描任意项目目录，自动构建模块级 + 文件级知识图谱，帮助快速理解项目整体架构与设计思路，为后续进化、优化提供依据。 > > 按 DSH 官方发布文档 打包为标准组合包（bundle），支持 npm / GitHub / tarball 安装。
📸 界面预览
✨ 功能特性
- 只读分析：全程使用 DSH 的
fs服务，绝不修改被扫描项目 - 多模块识别：按 manifest（
pom.xml/package.json/go.mod/requirements.txt/pyproject.toml等）自动拆分模块 - 多语言依赖解析：Java/Kotlin（类索引）、TS/JS/Vue（别名与相对路径）、Python（点路径）、Go（根相对路径）
- 分层分类：controller / service / mapper / entity / dto / config / pages / components / router / store / api / util 等
- 图谱输出：模块依赖图、文件级依赖图、技术栈、入口点、关键文件、架构观察
- 使用入口：页面右下角可视化面板（主入口，输入路径即可扫描）·
project_kgraph模型工具（Agent 可读，与面板共享扫描缓存）
📦 安装
推荐（显式版本号，避免 pnpm lockfile 缓存旧版本）：
dsh plugin --profile web add dsh-kgraph-plugin@0.3.0🚀 使用
安装启动后，页面右下角出现「项目知识图谱」浮动面板：
1. 输入项目路径（如 X:/xxx/xxx）→ 点「扫描」 2. 总览：模块卡片、技术栈、模块依赖图、架构观察 3. 点击模块进入文件级分层图谱（controller → service → mapper → …），点击节点查看代码详情 4. 大型图谱用 ⛶ 全屏浏览，— 折叠面板
Agent 侧可调用 project_kgraph 工具（{ "path": "X:/xxx/xxx" }）获取完整图谱 JSON，与面板共享同一份扫描缓存。
🗂️ 代码结构
kgraph-plugin/
├── package.json # dsh.bundle + dsh.client 声明
├── cordis.patch.yml # 组合包配置层
├── index.js # Host: 扫描引擎 + project_kgraph 工具 + /api/kgraph 数据路由
├── lib/client.js # 浏览器端: 浮动图谱面板 (ModuleLoader 协议)
├── asserts/ # 截图
└── dynamic/ # 动态插件模式源码 (备选)📜 版本历史
| 版本 | 说明 |
|---|---|
| 0.1.0 | 打包为标准组合包 |
| 0.1.1 | 修复 tools 服务注入 |
| 0.2.x | 新增浏览器 UI 面板、全屏/折叠、缓存共享与多项 UI 修复 |
| 0.3.0 | 当前版本：移除 /kgraph 命令，统一以右下角面板 + project_kgraph 工具使用 |
License
[MIT](LICENSE)