DeepSeek Harness 插件：對話輪次導航與 Codex 風格時間軸 (dsh-conversation-nav)

在 DeepSeek Harness 的 Web GUI 中進行智能體開發時，面對長對話流，快速定位特定輪次、查看消息發送時間以及管理對話進度往往較爲困難。dsh-conversation-nav 插件通過引入 Codex 桌面版風格的左側導航欄，解決了這些問題。

這是一個純客戶端插件，由 Jaeger0624 維護。它爲 DeepSeek Harness Web GUI 提供了 Codex 風格的對話輪次導航。插件將一個垂直的“鋼琴鍵導軌”掛載在對話區左側，每條用戶消息對應一個刻度。它支持鼠標懸浮查看詳情、點擊跳轉，並能持久化輪次標記。

核心功能¶

• 鋼琴鍵導軌：對話區左側的垂直刻度列，每條用戶消息（含 steering）對應一個刻度，長對話會自動壓縮間距。
• 懸浮階梯與詳情卡：鼠標懸停刻度時，顯示詳情懸浮卡，包含消息摘要、模型回覆預覽、發出時間（按日期格式）、輪次耗時和輸出 token 數。
• 點擊跳轉：點擊刻度平滑滾動至該輪次，目標行會短暫高亮。對於虛擬滾動未掛載的行，插件會按比例預估並做有界重試兜底。
• 當前輪追蹤：滾動時，正在閱讀的輪次刻度會自動深色高亮。
• 多色輪次標記：支持右鍵點擊刻度循環切換標記顏色（琥珀/紅/藍/綠），並在懸浮卡中添加備註。標記數據保存在瀏覽器的 localStorage 中，刷新頁面不丟失。
• 主題自適應：支持明暗主題切換，併兼容 prefers-reduced-motion 減少動畫偏好設置。

安裝與啓用¶

使用官方 CLI 安裝該插件：

dsh plugin --profile web add github:Jaeger0624/dsh-conversation-nav

典型用法¶

1. 查看詳情：鼠標懸浮在對話左側的刻度上，查看消息摘要、模型回覆預覽以及時間、耗時和 token 指標。
2. 跳轉定位：點擊刻度，頁面平滑滾動至該輪次，並短暫高亮該行。
3. 標記與備註：右鍵點擊刻度可循環切換標記顏色；在懸浮卡中點擊「☆ 標記」或添加備註。

技術實現與注意事項¶

• 技術棧：純客戶端插件，零依賴，手寫單文件 bundle，無構建步驟。
• 數據源：直接讀取官方 ctx.sessions 會話快照。
• 掛載方式：掛載於官方 shell.overlay 槽位（點擊穿透層，內部自行處理 pointer-events）。
• 持久化：標記數據存儲於 localStorage，鍵名爲 dcn:marks:<sessionId>。
• 注意：該插件運行在客戶端，不涉及後端權限。安裝前建議檢查源碼與許可證（MIT）。

該插件通過純前端實現，降低了長對話管理的門檻。更多細節請查閱插件目錄頁或源碼倉庫。