前言¶
在 DeepSeek Harness(DSH)的 Web UI 中,會話管理會涉及歸檔、刪除、移動工作區,以及單條 Agent preset 遷移。dsh-session-manager 是一個 DSH plugin,把這些操作放到 Web UI 中,並對不可逆操作增加確認。
這是什麼¶
hkkz9522/dsh-session-manager 由 hkkz9522 維護,是一個用於從 Web UI 安全管理會話的 DeepSeek Harness (DSH) plugin。
它採用 MIT license,package.json 聲明版本爲 0.4.1。該插件是 Cordis plugin,聲明 cordis >=4.0.0-rc <5 爲 peer dependency。
核心功能¶
下面介紹已覈實的幾項能力。
- 歸檔和取消歸檔會話。
- 刪除會話,並要求顯式確認不可逆操作。
- 將會話移動到目標工作區,同時保留會話歷史、標題、歸檔狀態和派生會話關係。
- 按單條會話遷移 Agent preset。
- 在側邊欄提供 Session manager,可瀏覽 active 和 archived conversations;每行支持 Open、Archive/Unarchive、Move、Delete 和 Migrate preset。
- 在當前會話頭部提供 Archive/Unarchive、Move to workspace 和 Delete conversation 操作。
移動會話¶
移動會話會改變其存儲的 cwd;後續工具調用會運行在目標工作區。
如果移動的是一個正在運行的會話,插件會先中斷並關閉該會話,然後自動刷新側邊欄。
刪除會話¶
刪除會話是永久性的。刪除動作需要顯式確認。
預設遷移¶
預設遷移只改變會話元數據,不改變消息歷史、文件或已選擇的工作區。
該功能一次只處理一個會話,沒有批量遷移操作。Subagent 和 transient blank-session placeholders 會被排除在破壞性或遷移操作之外。
安裝與啓用¶
下面介紹安裝命令。可以從 npm 安裝,也可以從 GitHub 安裝。
dsh plugin --profile web add npm:dsh-session-manager
dsh plugin --profile web add github:hkkz9522/dsh-session-manager
安裝後,重啓 DSH Web。如果瀏覽器仍加載舊的 client bundle,執行硬刷新:
Ctrl+Shift+R
典型用法¶
在 UI 中遷移預設¶
1、打開 Session manager。
2、定位目標會話,選擇 Migrate preset。
3、選擇一個當前可用的目標 preset,並確認。
調用本機接口遷移預設¶
下面是遷移一條會話到 standard 的示例:
curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
-H 'content-type: application/json' \
-d '{"sessionId":"session-...","toPreset":"standard"}'
示例中的 sessionId 應替換爲實際會話標識。
適用場景與注意¶
適合需要在 DSH Web UI 中管理會話的開發者。如果你需要歸檔、刪除、跨工作區移動,或只想遷移某一條會話的 Agent preset,可以使用這個插件。
使用前注意:
- 刪除會話是永久性的,操作前確認目標會話。
- 移動會話會改變存儲的
cwd;後續工具調用會運行在目標工作區。 - 移動正在運行的會話會先中斷並關閉它,然後刷新側邊欄。
- 預設遷移只改變會話元數據,不會改變消息歷史、文件或已選擇的工作區。
- Subagent 和 transient blank-session placeholders 不在破壞性或遷移操作範圍內。
- 該插件沒有批量遷移操作。
- 插件會以當前
dsh進程權限運行。安裝前建議檢查源碼與MITlicense。
結尾¶
經過上面的步驟,dsh-session-manager 可以將會話管理操作集中到 DSH Web UI:歸檔、刪除、移動和單條預設遷移都有明確入口。
倉庫地址: