前言¶

DeepSeek Harness (DSH) 的 Web 界面支持通過插件進行功能擴展。dsh-session-mgr 是一個由用戶 mienfong 維護的客戶端插件，旨在解決 Web 界面下會話管理不便的問題。它允許在設置頁面直接對會話進行移動、歸檔、恢復、備份與刪除，並支持跨工作區操作。

核心功能¶

該插件提供以下能力：

1. 移動會話：支持將任意會話（含已歸檔會話）移動到任意工作區。
2. 歸檔與恢復：將會話從側欄隱藏（歸檔）或取消隱藏（恢復），原位置與排序保留。
3. 備份與匯入：
   • 備份：生成可攜式壓縮檔（.zip 或 .tar.gz），包含 manifest.json、完整日誌及所有附件。
   • 匯入：將便攜式包安裝到指定工作區，並重設會話的 cwd（當前工作目錄），使其在另一臺機器上無縫繼續。
4. 刪除會話：帶紅色二次確認彈窗的永久刪除。
5. 界面與操作：支持英文/簡體中文/繁體中文三語界面，提供批量操作功能以及標題欄快捷操作按鈕。

安裝與啓用¶

需要在使用 Web profile 的環境中安裝。執行以下命令：

dsh plugin --profile web add dsh-session-mgr

安裝完成後，需在 profile 的配置中將插件加入啓動列表（具體配置項名稱需參考官方文檔），並重啓 Web 服務器使插件生效。

使用方法¶

1. 打開「設置 → 會話管理」。
2. 會話按工作區分組，已歸檔會話帶有標記。
3. 使用工具欄按鈕進行單條或批量操作（移動、歸檔、恢復、備份、刪除）。
4. 在打開的會話標題欄，點擊「移動到工作區」按鈕可快速操作當前會話。
5. 切換語言時，可使用工具欄的簡體/繁體按鈕（僅當 Harness 語言設爲中文時顯示）。

技術細節與限制¶

• 跨機器遷移原理：會話通過 header 中的 cwd 關聯工作區，但 cwd 是機器專屬的絕對路徑。因此，備份後需在目標機器上執行「匯入」，將 cwd 重設爲該機器存在的路徑，才能繼續使用。
• 版本兼容性：如果備份包的 DSH 版本高於本機，匯入時會自動將本機不認識的事件標記爲 ignorable: true，以確保會話正常加載。
• 性能與內存：備份和匯入操作在內存中完成，大附件會增加內存佔用。會話清單需遍歷所有會話，但標題讀取已通過緩存優化。
• 安全限制：運行中的會話不可移動、歸檔或刪除。已打開但閒置的會話在操作前會先卸載。刪除操作不可恢復。

總結¶

dsh-session-mgr 爲 DSH Web 用戶提供了對會話的精細化控制能力。通過備份與匯入機制，它解決了跨設備數據遷移的痛點。安裝並啓用後，開發者可以在設置頁面直接管理所有會話，提升工作流效率。