前言¶
DSH 的會話默認和項目工作區綁定。遇到臨時問答或小任務時，爲了不污染當前工作區，通常要先新建一個目錄、切換過去再開始；如果同時處理幾個不相干的任務，目錄管理會更麻煩。
zsqbfan/dsh-chat-sessions 做的是這件事：一鍵新建自帶獨立工作區的會話，讓日常問答和小型任務無需手動選擇項目目錄即可開始，各個會話產生的文件互不影響。外觀與交互貼近 DSH 原生側欄，沿用現有的會話操作習慣。
它由 zsqbfan 個人維護，分類爲客戶端，是社區目錄收錄的第三方插件，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
一句話定位：一個 DeepSeek Harness 插件，爲主界面新增“自帶獨立工作區”的會話，並把新建、切換、歸檔等操作接入原生側欄。
它解決的是多任務並行時“先準備目錄、再開工”的負擔。新房間有獨立的工作區和目錄，標題鏈接提供文件入口，不需要先手動選擇項目目錄。派生或後續會話可能共享該目錄。
宿主要求：DeepSeek Harness >=0.2.0-rc.2 <0.3.0-0，開發與測試基線爲 0.2.2-rc.1。許可證爲 MIT。當前版本 v0.1.1。
核心功能¶
- 一鍵開始，工作區獨立。一鍵新建帶獨立工作區的對話，各自存放任務產生的文件，不同任務互不混雜，無需先手動選擇項目目錄。
- 現有的會話操作習慣。交互方式與原版 DSH 保持一致，切換、置頂、歸檔與恢復等操作沿用熟悉的方式，上手無需重新適應。
- 文件管理，方便查找。按會話標題整理文件入口，方便找到某次對話中產生的文件，隨時查看、編輯或繼續使用。
需要明確的一點：獨立目錄不等於系統沙箱。房間位於 <root>/.sessions/，標題鏈接只是文件入口。插件不會在系統層面隔離進程或權限。
安裝與啓用¶
下面是 README 給出的官方安裝步驟，命令與路徑照原文記錄：
1. 從 Release 下載 dsh-chat-sessions-0.1.1.tgz（另附 SHA256 校驗文件）。
2. 在 DSH「插件 → 添加插件」中填寫下載文件的絕對路徑，安裝並啓用；按宿主提示重新加載或重啓。
當前 Release 爲 v0.1.1。main 分支用於後續開發，需要固定版本時使用對應 Release 的安裝包，不要直接跟蹤 main。
典型用法¶
- 在側欄新建會話，直接得到一個帶獨立工作區的房間，無需先選目錄。
- 在該房間中正常提問、生成文件；文件落在房間自己的工作區，不進入其他會話的目錄。
- 用原生會話菜單歸檔該房間；需要恢復時從原生歸檔列表找回。歸檔會取消置頂，恢復後可重新置頂。
- 通過標題鏈接作爲文件入口，查看、編輯或繼續使用該會話產生的文件。
後臺約每 15 秒同步一次標題鏈接和工作區歸屬；未發送的草稿保存在瀏覽器中。
適用場景與注意事項¶
適合相信把 DSH 用於並行小任務、希望每個任務有獨立目錄的開發者，以及不想爲臨時任務反覆切換項目工作區的人。
安裝前請注意，插件以當前 DSH 進程的權限運行，能讀寫該進程可訪問的目錄；啓用前先檢查源碼與 MIT 許可證，確認來源後再使用。它通過插件頁面向宿主注入原生會話與工作區相關模塊，DSH 大版本更新後可能需要適配；目前主要在 macOS 的 0.2.2-rc.1 環境驗證，其他平臺與版本尚待驗證。
使用中需要注意的幾點：
- 升級時保留原有
root配置。更改存放位置不會自動遷移舊數據；舊版已歸檔的會話可從原生歸檔列表手動恢復。 - 啓動或重新啓用插件時，只回收已經歸檔、且沒有未歸檔會話共享的自有空目錄（允許僅有
.DS_Store），保留歸檔狀態和會話日誌；非空目錄保留。 - 停用、卸載走 DSH 插件頁面操作。停用後可能顯露底層工作區，房間、日誌和已有工作區保留；本版沒有自動停用回收，也沒有多會話房間退出管理功能。備份時同時保留房間文件和 DSH 的會話、工作區及歸檔記錄。
- 舊配置項
idleMs已停用，保留舊配置也不會生效。
v0.1.1 修復了空白對話等待約 90 秒後被自動歸檔、編輯器退回工作區選擇的問題。
小結¶
這個插件把“會話先綁工作區”改成一鍵開始，適合在 DSH 裏並行處理多個小任務、又不想互相干擾的場景。它依賴原生側欄結構，屬於個人維護項目，遇到問題建議附上 DSH 版本、系統和復現步驟到 GitHub Issues。
目錄頁：https://www.skillhub.cn/plugins/ZSQBFan/dsh-chat-sessions
GitHub：https://github.com/ZSQBFan/dsh-chat-sessions
