前言¶
在 DeepSeek Harness（DSH）开发中，面对复杂的单体项目或微服务架构，快速理解项目结构、依赖关系和分层设计是常态。传统方式依赖手动阅读代码，效率较低。dsh-kgraph-plugin 是一款组合包插件，专注于只读扫描项目目录，自动生成模块级与文件级知识图谱，辅助理解架构。
插件定位¶
这是一个 DSH 组合包插件，由开发者 lzhphantom 维护。它通过只读方式分析项目，自动构建模块级和文件级知识图谱，为后续的代码优化、重构提供依据。
核心功能¶
- 只读分析：全程使用 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模型工具。
安装与启用¶
安装该插件，使用官方提供的安装命令：
dsh plugin --profile web add dsh-kgraph-plugin@0.3.0
安装完成后，插件会自动加载。
典型用法¶
安装并启动后，页面右下角会出现「项目知识图谱」浮动面板。
- 扫描项目：在面板中输入项目路径（如
X:/xxx/xxx），点击「扫描」。 - 查看总览：扫描完成后，界面展示模块卡片、技术栈、模块依赖图以及架构观察。
- 查看文件级图谱：点击任意模块，进入文件级分层图谱（如 controller → service → mapper），点击节点可查看代码详情。支持
⛶全屏浏览和—折叠面板。 - Agent 调用：在 Agent 侧调用
project_kgraph工具，传入路径参数，即可获取完整的图谱 JSON 数据。该工具与面板共享扫描缓存。
适用场景与注意¶
该插件适用于需要快速理解项目整体架构与设计思路的开发者或架构师。
注意事项：
* 插件以只读模式运行，不会修改被扫描的项目源码。
* 当前版本为 0.3.0，移除了 /kgraph 命令，统一使用右下角面板和 project_kgraph 工具。
了解更多或查看源码，请访问插件目录或 GitHub 仓库。
