在 DeepSeek Harness Web 中,歸檔會話通常需要兩步操作:懸停會話行,點擊“…”菜單,再選擇“歸檔”。這種操作流在會話數量較多時較爲繁瑣。dsh-hover-archive 旨在將這一流程簡化爲“懸停即顯示,點擊即歸檔”。
是什麼¶
這是一個純客戶端插件,由 zhifengjiang 維護。它通過在側邊欄會話行的右側注入歸檔按鈕,復刻了 Codex 的會話管理體驗。它直接調用官方的 workspaces.archiveSession API,保證歸檔行爲與內置菜單一致。
核心功能¶
- 懸停顯示:鼠標懸停在側邊欄會話行上時,右側會出現歸檔圖標。
- 一鍵歸檔:點擊圖標即可歸檔會話,點擊事件被捕獲,不會打開會話內容。
- 空白行處理:新建會話的空白行(placeholder)不受影響,不會出現按鈕。
- 多語言與鍵盤支持:圖標文本隨應用語言切換;按鈕支持
:focus-within顯示,且可用 Enter 或 Space 鍵觸發。 - 狀態反饋:歸檔過程中圖標會變暗;失敗時圖標會閃爍錯誤顏色並顯示提示信息。
- 零依賴:無額外構建步驟,純 JavaScript 實現。
安裝與啓用¶
安裝命令如下:
dsh plugin --profile web add github:zhifengjiang/dsh-hover-archive
安裝後需要重啓 dsh web 或刷新頁面使插件生效。
典型用法¶
- 在 DSH Web 側邊欄找到目標會話行。
- 鼠標懸停在行上,右側出現歸檔圖標。
- 點擊圖標,會話即被歸檔。
適用場景與注意¶
- 平臺限制:僅適用於 DSH Web。如果終端使用的是原生列表替換了側邊欄,可能無法顯示。
- 版本兼容:插件基於 DSH 0.1.0-rc.6 構建。如果運行舊版本 Harness 且缺少
workspaces.archiveSession接口,插件會自動檢測並禁用自身,避免破壞 UI。 - 共存性:可與
dsh-session-manager、dsh-plugin-session-delete以及內置的“…”菜單共存。 - 運行環境:插件在客戶端運行,安裝前建議查看源碼與許可證(MIT)。
dsh-hover-archive 通過引入懸停即歸檔的交互,減少了點擊次數,提升了側邊欄會話管理的效率。完整源碼與文檔可參考下方鏈接。