前言¶
DeepSeek Harness (DSH) 的會話歷史通常以流水賬形式呈現。dsh-history 是一個 DSH 客戶端插件，由 konanzheng 維護。它讀取當前會話的歷史事件，把每一輪交互組織成卡片，用一條藍→紫→粉漸變的能量連線按 S 形串起來，並從工具調用中歸納過程洞察。
核心功能¶
- S 形能量軌跡與佈局：輪次卡片按 boustrophedon（犁田式）排列，使用藍→紫→粉漸變能量連線連接卡片中心。支持 Ctrl/Cmd + 滾輪縮放畫布（0.4× – 2.5×），光標錨定縮放。
- 過程洞察與歸納：從工具調用中歸納模式，如定位（多次 grep/glob）、讀寫（多次 read/write）、驗證（bash）或報錯。卡片展示意圖標籤與里程碑標記（⚠ 首次報錯 / 🔧 修復 / ⚡ 重點動作）。
- 邏輯鏈與詳情：可視化因果邏輯鏈（如 讀→改→驗），點擊卡片頭部彈出詳情窗口，包含完整對話、過程歸納、邏輯鏈、最終總結及文件操作明細。
安裝與啓用¶
- 前提：需要本地 DSH 開發環境。插件按 cordis 插件包方式裝配。
- 依賴注入：需要在
package.json的dsh.client.inject中聲明以下模塊（由宿主提供）：@deepseek-ai/dsh-client-runtime：用於獲取當前會話ctx.sessions.list.current。@deepseek-ai/dsh-client-ui-slots：UI 擴展。@deepseek-ai/dsh-client-connection：用於讀取事件歷史connection.api.sessions.history。
- 裝配方式：
cordis.patch.yml已內置{ id: dsh-history, name: dsh-history }的註冊，隨 DSH profile 裝配時自動加載 client bundle。
典型用法¶
- 打開一個有歷史消息的會話。
- 切到 軌跡 視圖，時間軸會自動打開。
- 自下而上瀏覽卡片：查看意圖標籤、邏輯鏈、問/答摘要、文件條。
- 點擊卡片頭部查看詳情窗口（包含過程歸納、邏輯鏈、最終總結和文件明細）。
- 使用 Ctrl/Cmd + 滾輪縮放畫布，按 ESC 逐層關閉詳情或時間軸。
適用場景與注意¶
該插件需要本地 DSH 開發環境。安裝前應檢查源碼與許可證（Apache License 2.0）。
結語¶
dsh-history 將原本雜亂的對話記錄轉化爲可視化的能量軌跡，幫助開發者快速定位 AI 的思考路徑與操作邏輯。
