前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构。在智能体开发和系统调试中，梳理模型架构、训练管线或论文工作流往往需要手动绘制图表，效率较低。dsh-facet 解决了这个问题，它通过插件形式，让用户在对话中直接将任意文本或链接转化为结构化图谱。
插件定位¶
DeepSeek Harness 插件：切面 —— 任意内容进，结构化图谱出。
- 维护者：wobenshiwomu
- 分类：工作流
- 许可证：MIT
核心功能¶
- 任意内容进，结构化图谱出：输入任意内容，输出结构化图谱。
- 一句话 → 一组图谱：支持生成模型架构、RL·Agent 训练管线、攻防·红蓝关系、论文工作流等。
- 自动识别：自动识别内容类型并选择对应模板。
- 视图词表：支持
diagram（2D 结构图）、tower（3D 层塔）、network（3D 关系网络）、flow（流程管线）、timeline（时间线）。 - 浮窗交互：图谱生成后，界面自动弹出浮窗展示。
- 风格铁律：固定 10 色色板，确保视觉一致性。
- 单文件 HTML：所有视图均为单文件 HTML 产物。
安装与启用¶
使用官方命令安装插件：
dsh plugin --profile web add 'https://codeload.github.com/wobenshiwomu/dsh-facet/tar.gz/v0.2.0'
安装完成后需要重启 DeepSeek Harness 以使插件生效。
典型用法¶
在任意对话中输入以下指令：
/visualize Qwen3-0.6B
/visualize https://arxiv.org/abs/2407.21783
/visualize 把 GRPO 的训练流程画出来
执行过程：
1. 主 agent 进行调研（arXiv 链接优先精读论文，否则走搜索）。
2. 返回一行摘要，告知将生成 N 张图（kind1 + kind2）及来源。
3. 为每个视图派发独立的子代理，并行生成 HTML 文件。
4. 浮窗自动弹出，同时回复中提供各视图直链。
直链格式示例：
- http://127.0.0.1:3080/dsh-facet/<slug>/diagram.html
- http://127.0.0.1:3080/dsh-facet/<slug>/tower.html
注意事项¶
- 浮窗机制：浮窗由实时事件触发，页面刷新后浮窗不会自动还原，需使用回复中的直链重新打开。
- 计算成本：一次
/visualize调用包含 1 轮调研 + N 个子代理（N 为该模式视图数，1~3），按需触发。 - 3D 视图依赖：3D 视图依赖 jsdelivr CDN 的 three.js，首次打开需联网。
- 配置：插件支持可选配置，默认开箱即用。
结语¶
dsh-facet 通过将自然语言转化为结构化图谱，降低了复杂系统可视化的门槛。它不仅提供即时的可视化反馈，还通过单文件 HTML 和风格铁律保证了产物的可分享性和一致性。
