前言¶
DeepSeek Harness（DSH）作爲插件化平臺，其原生工作區與會話管理功能在深度使用時存在操作繁瑣、文件交互受限等問題。本插件以標準 DSH 插件包的形式發佈，通過 overlay 補丁集覆蓋官方 17 個 bundle，對會話生命週期、文件處理流程及工作區沙箱能力進行增強。它旨在爲開發者提供更靈活的會話歸檔、跨工作區流轉以及完善的文件預覽與 Git 操作支持。
核心功能¶
會話回收站與歸檔¶
插件接管了 session.delete 與 workspace.delete 的默認行爲，將其改爲軟刪除（移入回收站）。
* 軟刪除：刪除操作僅標記會話或工作區，不會立即清除物理文件。
* 徹底刪除：物理刪除需通過回收站界面執行，調用 session.purge 或 workspace.purge。
* 會話合併：新會話已自帶整個工作區上下文，插件移除了原有的會話合併功能，相關按鈕已刪除。
工作區與會話管理¶
- 跨工作區拖動：支持將會話行直接拖拽至其他工作區行或「未分組」組，關係持久化，會話自身目錄與日誌保持不變。
- 未分組工作區：頂部「新會話」按鈕創建的會話默認歸屬「未分組」組，該組常駐顯示。
- 多文件夾掛載：每個工作區可掛載多個根目錄（
additionalPaths），沙箱權限同步授權全部根目錄。 - 文件夾與文件區：工作區側邊欄分爲上下兩層。上層爲文件夾區（藍色底，列出主目錄及附加目錄），下層爲文件區（紫色底，列出公共文件或空態提示）。未分組區域不渲染這兩塊。
文件交互與預覽¶
- 上傳方式：支持粘貼（Ctrl+V）或拖拽文件到文件區。文件經
workspace.importFiles落盤至工作區.dsh-uploads/目錄（重名自動編號，單文件 ≤5MB）。 - 會話文件：粘貼到會話的文件會以 sessionId 掛載，顯示爲綠色區塊（含左豎條強調線），標題格式爲「會話文件 · N 個文件 · 會話標題」。文件行支持移除與預覽。
- 附件限制放開：粘貼/拖拽任意格式文件均可作爲附件（圖片仍走圖片管線）。二進制文件僅標註
[附件 文件名]，大小限制僅作用於傳輸內容。 - 內置選擇器：Windows 下使用應用內瀏覽式選擇器（含驅動器列表），替代原生對話框。
- 多選支持：文件夾區/文件區標題欄的「+」按鈕打開多選瀏覽器，支持勾選框多選與跨目錄保持選擇。
文件預覽面板¶
點擊側邊欄文件夾樹中的文件，右側滑出 520px 預覽面板。
* 渲染能力：正文使用 Markdown 渲染。
* 代碼高亮：支持 .md 及 30+ 種代碼文件（.js/.ts/.vue/.java/.py/.xml/.yml/.css/.html 等）的語法高亮。
* 限制：內容由服務端 host.readFile RPC 提供，限制在工作區根目錄內，≤256KB，二進制文件拒絕預覽。
文件夾 Git 面板¶
文件夾區中，Git 倉庫文件夾行顯示當前分支 chip 與三色狀態點：
* 🟡 黃 = 有未提交修改
* 🔵 藍 = 落後遠程
* 🟢 綠 = 與遠程一致
點擊 chip 彈出菜單，支持切換分支、新建分支、更新代碼（git pull --ff-only）以及推送代碼（自動暫存、AI 生成中文提交信息、提交、推送）。所有操作直接作用於磁盤工作區。
安裝與啓用¶
前置條件¶
確保已安裝 DeepSeek Harness（目標版本 @deepseek-ai/dsh@0.1.0-rc.6，Windows）。
安裝步驟¶
使用 npm 將插件安裝到 DSH profiles 目錄。安裝後 postinstall 腳本會自動應用 overlay 補丁集。
npm install --prefix "$env:USERPROFILE\.dsh\profiles" dsh-workspace-enhance
啓用與生效¶
安裝完成後，需重啓 DSH 服務並刷新瀏覽器頁面以使補丁生效。
# 重啓 DSH 服務（具體命令視宿主方式而定，如 npx -y @deepseek-ai/dsh web）
# 瀏覽器 Ctrl+Shift+R 強刷
補丁機制說明¶
- 冪等性：插件宿主側每次加載時自動檢查並補打 overlay。已補打的文件不會重複操作。
- 持久性：overlay 採用「刪除後複製」方式落盤，與官方包硬鏈接斷開。即使使用
npx -y @deepseek-ai/dsh web重啓服務重新拉取官方包，已打的補丁也不會被覆蓋。 - 版本守衛：overlay 僅匹配
@deepseek-ai/dsh@0.1.0-rc.6。檢測到其他版本時會跳過並告警，直接覆蓋新版 bundle 會破壞運行。 - 自動恢復：官方包刷新或 DSH 升級導致補丁丟失時，會自動恢復。
注意事項與兼容性¶
- 版本鎖定：當前插件僅兼容
@deepseek-ai/dsh@0.1.0-rc.6（Windows）。升級 DSH 後需同步更新 overlay 補丁，否則功能可能失效或報錯。 - 目錄權限：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
- 回滾：如遇問題，可通過提供的腳本進行校驗或回滾。
