前言¶
DeepSeek Harness(DSH)裏,本機會話可能同時存在運行中、空閒和已歸檔狀態。對需要維護本地工作流的開發者來說,缺少統一入口會繼續舊會話、查看近期活動,或在安全確認後清理不再使用的會話。
dsh-session-manager 是一個 DSH 會話管理插件。它列出本機全部已物化會話,提供繼續、大綱和永久刪除能力,並且不需要修改 deepseek-harness 源碼。下面介紹它的功能、安裝方式和需要注意的限制。
插件定位¶
倉庫爲 Vim0x3c/dsh-session-manager,許可證爲 MIT。它的目標版本是 DeepSeek Harness 0.1.0-rc.8,用於在 dsh web 中集中管理本機會話。
核心功能¶
會話列表¶
- 列出本機全部已物化會話,包括運行中、空閒和已歸檔會話。
- 按更新時間展示標題、狀態、工作目錄等信息。
繼續會話¶
- 通過瀏覽器 sessions 服務繼續已有會話。
大綱¶
- 在瀏覽器內摺疊
session.history尾部窗口。 - 展示輪次、用戶/助手消息數及工具調用統計。
- 大綱來自
session.history的近期窗口,不是完整日誌統計。
刪除¶
- 停止並等待目標 Agent 靜默後永久刪除會話。
- 級聯刪除受管
origin: subagent子會話。 - 支持多選批量刪除。
- 刪除不可恢復。
持久化後端¶
JSONL後端刪除會話目錄,包括日誌和同目錄快照。SQLite後端在當前後端連接中執行事務刪除,事件行通過外鍵級聯清理。- 已支持官方持久化後端
session-persistence-jsonl和session-persistence-sqlite。 - 自定義持久化後端必須自行提供
delete(id);級聯刪除多個 durable 會話還必須提供原子deleteMany(ids)。
安全與兼容¶
- 執行
loopback、Host、Origin和Fetch Metadata安全校驗。 - 刪除端點僅允許 loopback authority,例如
localhost、127.0.0.0/8、[::1]。 - 通過局域網地址打開頁面時只顯示繼續和大綱。
- 非 loopback 頁面不顯示刪除能力。
- 若後續 harness 原生提供
AgentLoop.stop或SessionPersistence.delete,插件優先調用原生能力。
安裝與啓用¶
先構建 tarball,再安裝到 web profile,最後重啓 dsh web。資料給出的安裝命令爲:
dsh plugin --profile web add -w ./dsh-session-manager-0.2.2.tgz
README 建議使用 -w 安裝;裸 add 會觸發 ERR_PNPM_ADDING_TO_ROOT。資料中 package.json 的版本爲 0.2.3,但安裝命令使用 dsh-session-manager-0.2.2.tgz;兩者當前安裝關係未在資料中說明。
經過上面的步驟後,重啓 dsh web 啓用插件。
典型用法¶
1、打開 設置 -> 會話。
2、點擊“繼續”進入已有對話。
3、點擊“大綱”查看近期活動統計。
4、點擊“刪除”打開確認框並永久刪除會話。
適用場景與注意¶
適合已經在本機使用 DeepSeek Harness,並需要集中查看、繼續或清理會話的開發者。
使用前需要注意:
- 目標版本爲 DeepSeek Harness
0.1.0-rc.8。 - 刪除操作不可恢復。
- 會話列表沒有跨標籤頁即時推送,頁面會在刪除和重連後刷新。
- 刪除已歸檔會話不會清理 workspace 中過期的
archivedSessionIds。 - 插件以當前
dsh進程權限運行,安裝前應檢查源碼和MIT許可證。
鏈接¶
- 社區目錄頁:
https://www.skillhub.cn/plugins/Vim0x3c/dsh-session-manager - GitHub 倉庫:
https://github.com/Vim0x3c/dsh-session-manager