前言¶
DeepSeek Harness (DSH) 採用插件化架構，社區插件生態豐富。在開發或調試智能體時，通常只渲染最近幾十條對話，早期的指令記錄往往難以回溯。這導致查看長會話上下文或定位歷史指令時效率較低。
dsh-command-rail 是一個用於 DSH web 端的插件，它會在會話區左側邊緣生成一列低對比度的指令橫條，實現類似 Codex 的指令歷史軌道。該插件不依賴當前 DOM 渲染窗口，而是通過官方客戶端 API 獲取完整的歷史數據，確保每一條用戶指令都有對應的標記。
核心功能¶
全量歷史與數據源¶
插件通過官方客戶端 API（如 connection.api.sessions.history）獲取全量數據，而非僅讀取 DOM。DOM 僅保留最近約 50 個事件的窗口，軌道顯示不受此限制。
交互方式¶
- 懸浮查看：鼠標懸停在軌道橫條上時，橫條變寬變亮，並彈出 Popover 顯示當前指令的摘要信息（格式爲「第 N / M 條指令」）。即使指令尚未加載進 DOM，只要在歷史記錄中存在，即可查看摘要。
- 點擊跳轉：點擊橫條可平滑滾動定位到該條指令。若目標指令不在當前窗口內，插件會通過
sessions.scope(id).conversation.loadOlder()逐頁加載更早歷史，直至消息進入 DOM 後再執行跳轉並高亮。 - 當前位置高亮：閱讀位置對應的橫條保持品牌色高亮。DOM 行與歷史條目通過文本簽名對齊。
健壯性與適配¶
- 會話切換：插件訂閱 sessions 列表，自動檢測會話切換並重繪歷史。
- 降級處理：當歷史 API 不可用時，會自動退回 DOM 採集模式，確保軌道不會消失。
- 自適應佈局：當指令數量較多時，橫條高度與間距會逐級壓縮（最低 2px）；當指令超過 400 條時，會自動進行均勻採樣，避免界面過於擁擠。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile desktop add dsh-command-rail-0.3.1.tgz
注意事項：
1. 新插件首次安裝後需要重啓 DSH Desktop 才能生效。
2. 已安裝插件的更新支持 HMR（熱模塊替換），無需重啓。
3. 在使用 pnpm 更新時，若版本號未發生變化，pnpm 會跳過重裝，此時必須手動升級版本號。
典型用法¶
- 鼠標懸停在左側的指令橫條上，即可查看該條指令的摘要內容。
- 點擊對應的橫條，頁面會平滑滾動並加載該條指令，若指令較舊會自動加載更早的歷史記錄。
適用場景與注意¶
該插件適合需要在長會話中頻繁回溯、查看歷史指令上下文的開發者。由於插件以當前 DSH 進程的權限運行，安裝前建議查看源碼與許可證（MIT）。
