dsh-session-navigator: DeepSeek Harness 會話導航與縮略圖插件

前言¶

DeepSeek Harness (DSH) 是用於構建智能體的平臺。在長對話場景下，面對幾十輪的 Prompt-Response 和工具執行輸出，單純滾動瀏覽來定位特定輪次非常低效。官方 DSH Web UI 缺少會話縮略圖或快速導航輪廓。

dsh-session-navigator 爲 DSH Web UI 增加了一個全高的會話導航軌和刻度圖。它通過在聊天流右側邊緣添加導航軌，解決了長對話定位困難的問題，同時保持了界面的簡潔性。

插件定位¶

這是一個爲 DeepSeek Harness 提供會話導航和輪次刻度圖的客戶端插件。由開發者 wuxiangru915 維護。

該插件的核心價值在於：
* 零侵入：無需修改官方核心包，通過官方 shell.overlay 槽位掛載。
* 可視化：將長對話流轉化爲可視化的垂直刻度。
* 交互增強：提供懸浮預覽、平滑跳轉和統一滾動條。

核心功能¶

該插件包含以下具體能力：

1. 全高極簡導航軌
   在對話流右側邊緣提供 1px 寬的垂直導航軌，無需額外膠囊樣式，完全融入 UI。
2. 比例刻度標記
   自動根據用戶輪次在滾動容器中的物理高度，生成比例刻度。
3. 當前輪次指示器
   顯示當前視口的垂直高亮藥丸，配合 ScrollSpy 實現平滑跟隨。
4. 統一拖拽滾動條
   提供一個可拖拽的統一滾動條，用於在導航軌上直接滾動會話，避免原生滾動條重複出現。
5. 懸浮預覽卡片
   懸停在刻度標記上時，顯示預覽卡片。卡片包含：
   • 輪次編號（如 #2 Prompt）。
   • 3 行截斷的 Prompt 摘要。
   • 快捷操作按鈕：導出 Markdown、一鍵複製文本、上一輪/下一輪跳轉。
6. 平滑跳轉與脈衝
   點擊標記或卡片後，視圖會平滑滾動至目標消息，並伴隨高亮脈衝動畫。

安裝與啓用¶

安裝該插件需要 DeepSeek Harness >= 0.1.0-rc.5 (Cordis 4.x) 以及 Node.js >= 22。

通過官方命令行工具安裝：

dsh plugin --profile web add github:wuxiangru915/dsh-session-navigator

安裝後，重啓 Web 服務器並刷新頁面即可生效。本地開發時，可直接使用本地路徑安裝：

dsh plugin --profile web add /path/to/dsh-session-navigator

插件爲純 Bundle 插件，安裝時無需構建步驟。

典型用法¶

在 DSH Web 中打開任意會話後：

1. 查看導航軌
   在聊天流右側會出現垂直導航軌，每個用戶輪次對應一個刻度標記。
2. 懸浮預覽
   將鼠標懸停在刻度標記上，會彈出懸浮預覽卡片，顯示輪次摘要和狀態。
3. 快速跳轉
   點擊標記或預覽卡片，視圖會平滑滾動到對應的消息氣泡處。
4. 操作與滾動
   在預覽卡片上點擊按鈕可導出 Markdown 或複製文本；拖拽導航軌上的滾動條可滾動會話內容。

注意事項¶

• 版本要求：必須使用 DeepSeek Harness >= 0.1.0-rc.5，確保 Cordis 版本爲 4.x。
• 運行權限：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
• 架構：插件通過 dsh.bundle 補丁層掛載，不涉及對官方包的修改。

結語¶

dsh-session-navigator 通過提供直觀的導航軌和交互式預覽，顯著提升了長對話場景下的操作效率。對於需要頻繁在大量輪次中定位 Prompt 或 Response 的開發者，該插件能減少手動滾動的操作成本。

插件目錄頁
GitHub 倉庫