前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。官方 Harness 雖然支持會話歸檔,但在用戶界面層面缺少查看、恢復或刪除歸檔會話的功能。dsh-session-plus 由維護者 SZMY-haruhi 開發,通過補充側欄歸檔目錄和分支對話功能,將通常分散在不同插件中的操作整合到一個入口。該插件走公開 slot 和 workspace 域,不修改 @deepseek-ai 核心文件,也不向官方「視圖選項」菜單插入 DOM。
插件信息¶
- 插件名:dsh-session-plus
- 維護者:SZMY-haruhi
- 許可證:MIT
- 安裝命令:
dsh plugin --profile web add dsh-session-plus
*注意:npm 上的 0.1.0 是更早的佔名包,請安裝 0.1.1 版本。*
核心功能¶
該插件提供以下功能:
- 歸檔目錄:列出官方
archivedSessionIds,不是插件自己維護的影子列表。 - 恢復:從歸檔集合中移除,回到原工作區位置。
- 刪除:居中二次確認,卸工作區記賬並刪除會話日誌(包括
.zstd兄弟文件和會話目錄)。刪除後不會再次觸發取消歸檔邏輯。 - 空白新會話:空白草稿狀態的會話不能歸檔、也不能刪除。
- 分支對話:在用戶消息旁顯示 Y 形帶箭頭的分叉圖標,點擊後彈出就近浮窗,可修改提問並分支。如果不填寫新標題,默認沿用官方
increaseTitle疊加(1)(2)的方式。 - 空閒等待:插件會在歸檔前儘量等待空閒(包含
runningCalls和partial狀態),最多等待約 30 秒,超時會提示「請先等當前回覆結束,或點停止後再歸檔」。
典型用法¶
- 歸檔會話:在側欄底部、設置旁邊點擊「歸檔」按鈕。
- 管理歸檔:在彈出的歸檔目錄列表中,點擊「恢復」或「刪除」。
- 分支對話:在用戶消息旁點擊 Y 形圖標,在浮窗中修改提問後發送,原對話保留。
注意事項¶
- 禁止在工具調用時歸檔:這是插件最關鍵的限制。如果正在調工具時歸檔,會導致會話日誌損壞,恢復後會出現
tool-call received more than one start Match或SessionPersistenceCorruptionError。一旦出現這種情況,需重啓服務或刪除會話。 - 不修復損壞日誌:如果會話日誌已經損壞,插件無法修復,只能刪除該會話。
- 空白會話限制:空白新會話(未發送過消息的會話)不能被歸檔或刪除。
生態背景¶
DSH 插件生態由社區維護。相關插件目錄託管在獨立站點,與 DeepSeek 或幻方無官方從屬關係。本插件依賴公開 Harness API 開發,不覆蓋官方 plugin 行(僅使用 insert),不僞裝成官方菜單項。