前言¶
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 和風格鐵律保證了產物的可分享性和一致性。
