前言¶
在 DeepSeek Harness（DSH）裏讓助手落盤截圖、下載物、轉碼中間文件或臨時腳本時，文件很容易堆在當前項目根目錄，和源碼混在一起，也不利於按會話區分。手動建目錄、每次在提示里約束路徑，成本高，清理還要自己刪文件夾。
dsh-cache-workspace 是社區維護的客戶端插件，在輸入框上方工具欄增加緩存目錄選擇器，併爲助手注入「緩存工作區」使用規則；支持把工作區外的目錄選爲緩存並自動授予沙箱寫權限，清理在獨立進程裏執行。下文按安裝、用法和限制說明，事實以 GitHub 倉庫 README 爲準。
這是什麼¶
- 名稱與歸屬：
@local/dsh-cache-workspace（npm 包名），維護者 ll4514dvdvdb，版本 0.1.0，許可 MIT。 - 分類：客戶端插件（
dsh.client.platform: web），只依賴 DSH 本體，不需要其他插件。 - 解決的問題：爲每個工作區（會話所在目錄）記住一個「可隨意讀寫」的緩存文件夾，避免助手把中間產物寫在項目根；用完可一鍵遞歸刪除該目錄。
插件目錄頁：SkillHub - dsh-cache-workspace。
核心功能¶
安裝並重啓後，輸入框工具欄會出現緩存控件（README 描述爲文件夾名 + 下拉 + 清理按鈕）。能力可概括爲四類：
看：控件顯示當前緩存文件夾名；每個工作區各自記住選擇。
選：
- 點文件夾名：打開 Windows 資源管理器選目錄。
- 點右側下拉：從工作區已有子目錄中選，或新建文件夾。
- 未選擇時默認使用
<當前工作區>/.dsh-cache，該路徑在沙箱可寫範圍內。
清：點清理按鈕並確認後，遞歸刪除當前緩存目錄；刪除在獨立進程中完成，對話歸檔或客戶端關閉後仍可繼續執行。目錄不存在時清理控件爲灰色。
教：每輪對話開始時，向助手系統提示注入「緩存工作區」規則，內容包括：可在該目錄任意創建、讀取、執行文件；勿在根目錄堆文件，應按工作名建子文件夾；緩存非長期存儲；用過之後提醒用戶可點清理；工作區外路徑仍受沙箱限制。
工作區外目錄：可選工作區外路徑（例如 D:\my-cache）。插件會創建目錄併爲該目錄授予 DSH 沙箱所需寫權限，僅作用於你主動選中的那一個目錄。目錄須屬於當前登錄的 Windows 賬戶，否則授權失敗並在控件上顯示原因。
配置與日誌落在 %USERPROFILE%\.dsh\dsh-cache-workspace\：state.json（各工作區緩存路徑與已授權外部目錄）、log.txt（UTF-8 運行日誌）、grant.ps1（外部目錄授權時生成的臨時腳本）。刪除該配置目錄會重置所有選擇，不會刪除已存在的緩存文件夾本身。
安裝與啓用¶
前提：Windows 上的 DeepSeek Harness 桌面版，且能執行插件相關命令。
- 將插件目錄放到任意位置（建議留在工作區便於備份）。
- 在 DSH 中安裝 bundle，或使用 CLI（路徑換成本機絕對路徑）：
plugin_manager action=install_bundle target=<本目錄的絕對路徑>
dsh plugin --profile desktop add "file:<本目錄的絕對路徑>"
- 重啓 DeepSeek Harness，或在插件列表中禁用後再啓用。
- 輸入框工具欄出現緩存控件即表示安裝成功。
卸載：
dsh plugin --profile desktop remove @local/dsh-cache-workspace
插件以當前 DSH 進程權限運行；安裝前建議瀏覽源碼與 MIT 許可證，確認清理與權限變更行爲可接受。
典型用法¶
選擇緩存目錄
- 點控件上的文件夾名 → 資源管理器選文件夾。
- 點名字右側下拉 → 從當前工作區子目錄挑選，或選「＋ 新建文件夾…」輸入名稱。
- 選中後助手可見路徑會立即更新。
使用默認位置
不操作時默認 <當前工作區>/.dsh-cache，助手的文件工具與命令工具可直接使用。
清理
點清理 → 確認 → 目錄被遞歸刪除（無回收站）。
助手側約定
助手會被告知：緩存目錄可隨便用，但按工作名分子目錄；用完後應提示你可點清理按鈕。
適用場景與注意¶
適合誰：在 Windows 桌面 DSH 上頻繁讓助手寫臨時文件、希望與倉庫根目錄隔離、並需要按工作區記住路徑的開發者。
平臺：README 寫明僅支持 Windows。
風險與限制：
- 清理爲遞歸刪除，不可恢復；勿將含重要數據的目錄設爲緩存。
- 工作區外目錄若被其他賬戶或系統佔用，授權可能失敗。
- 控件不跨機器同步「工作區 → 緩存目錄」映射。
- 選中工作區外目錄時會修改該目錄訪問權限（僅該目錄），用於沙箱內寫入。
- 插件不聯網、不上傳數據；清理前會彈確認框。
安全摘要（來自 README）：不聯網；僅對你選中的工作區外目錄改權限；清理前必確認。
結尾¶
dsh-cache-workspace 把「選目錄、記路徑、教助手、清緩存」收進輸入框工具欄一行，默認 .dsh-cache 即可用，外置目錄則自動授權寫權限。若你在 DSH 裏被項目根目錄裏的臨時文件打擾，可按上文命令本地安裝 bundle 後試用。
- 目錄頁：https://www.skillhub.cn/plugins/ll4514dvdvdb/dsh-cache-workspace
- 源碼與說明：https://github.com/ll4514dvdvdb/dsh-cache-workspace
社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係；DSH 生態以「一切皆插件」爲思路，本插件爲獨立社區作品。
