前言¶
在 DeepSeek Harness（DSH）裏開新對話前，通常要先選定或添加工作區。若項目目錄已在磁盤上、但還沒在客戶端裏登記，往往要在文件管理器和 DSH 之間反覆切換、手動填路徑或走其它導入流程。dsh-workspace-drop 把這一步收成一次拖放：從系統文件管理器把文件夾拖到工作區列表或新對話的工作區選擇器，即可用原有路徑註冊工作區。該能力屬於客戶端插件，依賴 DSH 桌面應用的本地路徑橋，無法在普通瀏覽器裏等價復現。
這是什麼¶
dsh-workspace-drop（倉庫 MeirinRuan/dsh-workspace-drop）由維護者 MeirinRuan 發佈，當前包版本爲 0.1.0，採用 MIT 許可證。插件通過 Cordis 補丁掛載 workspace-drop 加載項，在客戶端 shell.overlay 插槽追加提示層，不新增模型工具、系統提示或會話事件；新對話的工作目錄仍由所選工作區決定。
社區目錄條目見 SkillHub：dsh-workspace-drop。該目錄爲社區獨立站點，與 DeepSeek、幻方無官方從屬關係；DSH 生態奉行「一切皆插件」，安裝前宜自行查閱源碼與許可證。插件在 當前 dsh 進程的權限 下運行。
核心功能¶
下面介紹的能力均來自倉庫 README 與中文指南。
- 拖放註冊：將一個或多個本地文件夾拖到左側工作區列表，或新對話頁的工作區選擇器；鬆開後通過 DSH 的
workspaces.create服務註冊原路徑。列表立即更新，選中即可對話；已存在的目錄會複用已有工作區，文件仍留在原位置。 - 路徑與隊列：拖放期間通過桌面
__DSH_HOST_PATHS__.pathFor同步解析目錄路徑；同次拖放內重複路徑去重，多目錄按順序註冊，單個失敗不影響後續項。 - 反饋與約束：成功時頂部居中提示工作區名稱，約六秒後淡出；部分失敗時列出成功項與錯誤，可點「關閉」收起。普通文件會被拒絕並提示僅支持文件夾；註冊進行中再次拖入會被攔截，不啓動第二次操作。
- 範圍邊界：聊天輸入框附件拖放、列表內會話移動保持 DSH 默認行爲。無路徑橋的環境會顯示限制說明，不會猜測路徑或上傳文件副本。
安裝與啓用¶
本插件包要求 DSH 0.2.2-rc.1（見 package.json 的 engines.dsh）。開發構建需要 Node.js ^22.19.0 || >=24.0.0 與 pnpm 11.28.5；日常使用在插件管理器中安裝即可。
- 打開 DSH 插件管理器。
- 安裝發佈壓縮包（使用指南中的官方地址，勿憑倉庫名拼接 CLI 命令）：
https://github.com/MeirinRuan/dsh-workspace-drop/releases/latest/download/dsh-workspace-drop.tgz
- 啓用插件包名
dsh-workspace-drop。 - 若仍啓用舊的
@local/dsh-workspace-drop，請先禁用。兩者共用提示層、事件監聽器與語言命名空間，不能同時啓用。
禁用或卸載後，監聽器、語言字典、樣式與提示層會移除；卸載會等待已開始的註冊完成並停止未開始的隊列，已添加的工作區仍保留。
典型用法¶
- 確認使用 DSH 桌面客戶端，且本地路徑橋可用（非純瀏覽器、非與主機分離的遠程場景）。
- 在文件管理器中選中項目文件夾（可多選）。
- 拖到 DSH 左側工作區列表或「新對話」頁的工作區選擇器上並鬆開。
- 根據頂部提示確認名稱；在列表中選擇該工作區開始對話。
無需額外配置字段；行爲由拖放目標上的 UI 與 workspaces.create 完成。
適用場景與注意¶
適合誰：經常在多個本地倉庫或文檔目錄間切換、希望用磁盤上已有文件夾快速登記爲 DSH 工作區的桌面用戶。
前提與限制：
- 必須有桌面路徑橋；普通瀏覽器無法讀取拖入文件夾的絕對路徑。
- 拖放目標綁定 DSH 的
sidebar.workspaces與conversation.hero.workspaceDOM 插槽，未聲明兼容其它 DSH 版本。 - 安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證；插件與 DSH 同進程權限，不宜在未審計的情況下啓用不可信來源的包。
自研或本地打包時，可在檢出倉庫後執行 pnpm install --frozen-lockfile、pnpm run build 與 pnpm test，再用 pnpm pack 產出 tgz 後在管理器中安裝；詳見指南「開發」一節（指南含 git clone 說明，本文不復述克隆步驟）。
小結¶
dsh-workspace-drop 在客戶端用拖放調用 workspaces.create，把本地文件夾路徑登記爲工作區，減少手動路徑錄入。安裝使用發佈 tgz 並啓用 dsh-workspace-drop，且需 DSH 0.2.2-rc.1 與桌面路徑橋。
