前言¶
DeepSeek Harness (DSH) 在處理文件工具和 shell 命令時，通常需要一個明確的項目目錄。對於臨時對話、單次任務或不需要複雜上下文的場景，每次創建會話都強制選擇項目會帶來額外的操作負擔。
dsh-auto-workspace 插件接管了 DSH 的默認回退邏輯。它允許用戶創建“無項目”會話，併爲這些會話自動分配一個獨立的本地工作目錄。文件工具和 shell 命令將在這個目錄中運行，且恢復會話時，上下文會保持在該位置。
核心功能¶
- 獨立工作目錄：爲無項目的聊天創建獨立的本地工作目錄。
- 上下文隔離：在該目錄中運行文件工具和 shell 命令。
- 持久化：恢復會話時保持在該位置工作，文件得以保留。
- 側邊欄清爽：不會向側邊欄的項目列表添加任何內容。
- 邏輯重寫：重寫默認回退邏輯，提供“不選擇項目”的選項。
- 自動分組：將會話保存在 DSH 原生的 “Ungrouped” 組中。
- 徽章交互：提供清除徽章功能，允許用戶離開當前項目。
安裝與啓用¶
該插件是一個 DSH Bundle，通過配置文件注入。
Web 應用：
在終端執行以下命令安裝：
dsh plugin --profile web add github:Castor6/dsh-auto-workspace
桌面應用：
桌面應用不支持命令行安裝。請打開左側導航欄的 Plugins，輸入 github:Castor6/dsh-auto-workspace 或倉庫 URL https://github.com/Castor6/dsh-auto-workspace 進行安裝。
典型用法¶
- 創建會話：點擊 “new session” 且不選擇任何項目，直接開始輸入。
- 離開項目：在懸停空白聊天界面的項目 chip 時，文件夾圖標會變爲圓形的清除徽章，點擊即可離開該項目。
- 啓動方式：在項目列表中選擇 “Work without a project” 選項。
配置說明¶
在配置文件中（~/.dsh/profiles/<profile>/cordis.patch.yml），通過插件的 loader 行設置參數：
- id: auto-workspace
config:
root: '/Volumes/Work/DSH' # 默認：<home>/Documents/DSH
directoryPrefix: 'chat' # 默認：chat → chat-01, chat-02, ...
enabled: true # 默認：true
配置說明：
* root：指定工作目錄的根路徑。
* directoryPrefix：指定子目錄的命名前綴。
* enabled：是否啓用該插件。
注意事項¶
- 依賴要求：插件依賴
@deepseek-ai/cordis(~4.0.4)。 - 目錄結構：聊天目錄默認位於
~/Documents/DSH/<YYYY-MM-DD>/chat-NN/（Windows 下爲%USERPROFILE%\Documents\DSH）。 - 清理機制：插件不會刪除任何文件或目錄。只有在會話創建失敗且尚未寫入任何內容時，目錄纔會被回收。
- 安裝方式：Web 應用支持 CLI 安裝；Desktop app 僅支持 GUI 安裝。
