前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，模型或工具往往會吐出時間線、關係網、日曆統計或自定義圖表配置。若只在工具卡正文裏堆 JSON 或文字摘要，排期、拓撲和趨勢很難一眼對齊，更談不上在同一會話裏並排比較多張圖。社區插件 dsh-viz（維護者 leolee9086，分類：客戶端）面向這類需求：宿主註冊 viz_show，客戶端用同一套 ECharts / vis-network 渲染器，在工具卡內保留完整圖表，並在右側欄集中查看、多選對比。
這是什麼¶
dsh-viz 是 DeepSeek Harness 的雙位置可視化插件。事實來源是持久化的工具調用參數，而不是工具卡 DOM 或右欄導航參數。圖表身份爲 sessionId + callId；目錄從會話事件窗口恢復，並識別直接調用與 PTC 網關子調用，外層網關不重複計數。
倉庫：https://github.com/leolee9086/dsh-viz
社區目錄頁：https://www.skillhub.cn/plugins/leolee9086/dsh-viz
當前 package 版本：0.2.1，許可證 MIT。
核心功能¶
雙位置渲染¶
- 調用
viz_show後，展開工具卡仍看到完整圖表，而不是僅有一個摘要入口。 - 工具卡與右欄各自持有圖表實例，縮放、選擇和卸載互不影響。
- 當前會話中新成功的圖表調用會自動打開右欄；歷史重放不自動打開，後臺會話不會搶佔當前右欄。
會話級目錄與對比¶
- 點擊會話標題欄的「圖表」，或工具卡上的「加入對比」，打開本會話的圖表集合。
- 勾選多張圖，可選自適應、上下或並排佈局；時間線支持底部滑塊或滾輪縮放。
- 圖表下的「回到工具卡」會展開原生摺疊組並定位到對應調用；「來源記錄」可查看調用 ID、事件序號、根調用 ID（若有）和原始數據。
- 若提示還有歷史未載入，可點「載入更早的圖表」，通過正式會話分頁接口向前加載；大會話可能耗時較長。
支持的視圖（kind）¶
| kind | 用途 | 主要數據字段 |
|---|---|---|
timeline |
時間線 / 泳道甘特、分鏡和排期 | items[]：label, start, end, group, note |
network |
關係網 | nodes[], edges[] |
calendar |
日曆熱力 | items[]：date, value |
echarts |
原生 ECharts | JSON option |
gallery |
圖冊 | images[]（瀏覽器可訪問的圖片 URL） |
時間字段支持純秒數、"0:05"、"1:02:03"、ISO 或日期串。
安裝與啓用¶
桌面版請使用 Electron 應用內的插件管理器，安裝地址如下（資料原文，含版本錨點）：
https://github.com/leolee9086/dsh-viz#v0.2.1
非桌面 profile 可使用官方 CLI，將 <name> 換成對應 profile 名稱：
dsh plugin --profile <name> add 'https://github.com/leolee9086/dsh-viz#v0.2.1'
不要在 profile 目錄手工運行 pnpm add 或改組合來代替管理器；desktop profile 由 Electron 管理，CLI 會拒絕操作。安裝後刷新頁面；若管理器要求重載或重啓，按其提示操作。倉庫已包含構建產物，使用者無需自行編譯客戶端。
插件在 DSH 進程權限下運行；安裝前建議閱讀源碼與 MIT 許可證，確認符合你的環境策略。
典型用法¶
智能體或工具側調用 viz_show，傳入 kind 與對應字段。下面是一個時間線分鏡示例（與 README 一致）：
{
"kind": "timeline",
"title": "分鏡排期",
"items": [
{ "label": "S01", "start": "0:00", "end": "0:05", "group": "場一", "note": "近景" },
{ "label": "S02", "start": "0:05", "end": "0:10", "group": "場一", "note": "切到中景" }
]
}
經過上面的步驟，工具卡內會渲染完整時間線；新成功的調用還會按規則打開右欄。需要對比時，從標題欄或工具卡進入集合，多選佈局即可。關係網、日曆、ECharts option 與圖冊 URL 同理，字段需符合上表約定。
數據生命週期與邊界¶
- 失敗記錄會保留，但不觸發右欄自動打開；替換或補頁記錄不會當作新結果。
- 事件訂閱與會話綁定：工具組隱藏或原位卡卸載，不影響已打開的右欄圖表；刷新或釋放會話後，目錄從日誌恢復，默認選中最新圖表。
- 客戶端按需加載歷史，不等於把全部歷史重新塞進模型上下文；工具參數可追蹤，也不等於壓縮後永久留在模型活躍上下文中。
- 圖表只讀：可縮放、懸停、比較，不能直接編輯原始調用數據。
- 本地圖片須先變爲瀏覽器可訪問的 URL；
option不接受可執行 JavaScript 回調字符串。 - 同時勾選很多複雜圖會增加瀏覽器內存與繪製成本，可減少選擇或改用上下佈局。
- 「回到工具卡」依賴與宿主對齊的兼容橋（如
data-chat-call-id、beforematch）；宿主升級後若接縫變化，回跳可能明確失敗。README 註明v0.2.1已通過部分邏輯/靜態測試與構建，實際安裝後的點擊回跳仍需驗收；插件管理器安裝、正式插槽掛載與跨會話行爲也需在安裝後自行驗證。
結尾¶
若你希望在 DSH 會話裏把時間線、關係網、日曆和 ECharts 從「可讀 JSON」變成「可對比的圖」，dsh-viz 提供了 viz_show 與雙位置 UI 的一整套路徑。更多細節見 GitHub README 與 SkillHub 目錄頁。DSH 生態強調「一切皆插件」；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
