MIT 授權的 DSH 外掛（TypeScript）：登記附加專案根、依根設定存取等級，並提供 Folders 對話框、Files 頁籤瀏覽與命名空間化的技能。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-10
授權條款
MIT
01它能幫你完成什麼？
讓 DeepSeek Harness 的 agent 在一個工作階段裡跨多個獨立 Git 儲存庫做事
一個主根加上每工作階段最多 16 個附加根，每個根有自己的存取等級
專案由多個儲存庫組成、而不是一個 monorepo 的開發者
在不改變 agent 工具的前提下，給出比工作階段模式更窄的權限
每個根三態存取等級——inherit、read-only、read-write——由行程內檔案圍欄加核心沙箱執行
想讓 agent 讀某個共享儲存庫、但絕不允許寫入的團隊
在 Files 頁籤裡瀏覽並預覽附加根的檔案
Files 頁籤標頭的根切換器，每個根都保留原生目錄樹、延遲載入、watch 自動重新整理與在應用程式中開啟的行為
需要檢視主工作區之外檔案的使用者
02如何將外掛接入 DeepSeek Harness？
先決條件
- DSH 版本必須落在外掛給出的精確比對表內——依系列從 0.1.5-rc.2 到 0.2.2-rc.1；版本不在表內或 @deepseek-ai/dsh-* 各套件版本不一致時外掛不會啟動
- 受支援的執行平台：macOS（Seatbelt）、Linux（bwrap / Landlock）、Windows（root-set ACL runner）
安裝步驟
- 01
在 DSH 側邊欄的外掛頁點「新增外掛」並填入 `@dsh-electron/dsh-plugin-multi-root-workspace`，或執行 `dsh plugin --profile web add @dsh-electron/dsh-plugin-multi-root-workspace`
$ dsh plugin --profile web add @dsh-electron/dsh-plugin-multi-root-workspace
- 02
首次安裝時 `dsh plugin add` 可能以 [ERR_PNPM_IGNORED_BUILDS] 失敗：在該 profile 的 pnpm-workspace.yaml 的 allowBuilds 下補上 `koffi: true`，再執行一次 add
$ dsh plugin add
- 03
用你的 profile 啟動 DSH；側邊欄底部會出現 Folders（🗂）入口
- 04
用 `/workspace-folders add ~/code/another-repo [--inherit|--read-only|--read-write]` 登記一個附加根
驗證整合成功
- `dsh --profile web --dump-config | grep -A3 'multi-root'` 會顯示上游 fs-sandbox 與 sandbox 兩行被停用、外掛的 multi-root-* 行已掛載
03DSH 整合程度與能力邊界
用 `dsh plugin add` 裝進 profile 的 DSH 外掛：它會停用上游的 fs-sandbox 與 sandbox 兩行，改由自己的 multi-root-* 行接管，同時加上 Folders 入口與 /workspace-folders 指令。
/workspace-folders 指令族
絕對路徑、根序號或路徑，以及存取等級→對已登記根做 list / add / access / skills / alias-id / alias / remove / reveal / isolate-profiles
與既有根重複、巢狀在既有根內部、或就是主根本身的路徑會被拒絕Folders 對話框與 Files 頁籤根切換器
側邊欄底部的 Folders 入口（DSH 0.2.1-alpha.3+ 還有新工作階段頁工作區列的同一入口）→同一個對話框完成新增、移除、別名、切換存取等級與在檔案管理員中顯示；Files 頁籤標頭提供根切換器
視窗寬度 ≤560px 時新工作階段入口退化為圖示按鈕附加根 Skills
已登記根裡的 `.dsh/skills` 與 `.agents/skills`→以 `/alias-id:skill-name` 呼叫的技能，每個根獨立開關，aliasId 可編輯
全域開關在 Settings → Plugins → Multi-root Workspace，預設開啟選用的 Auto review 適配
在外掛管理員裡開啟預設關閉的 auto-review 列→向 Reviewer 補充多根上下文：目前工作區拓撲、各根存取等級與即時指令檔
啟用時會接管官方同名 bundle，且僅面向 DSH 0.2.1-rc.2
04適合誰？何時不該用？
適合
- 專案由多個儲存庫組成、而不是一個 monorepo 的開發者
- 想讓 agent 讀某個共享儲存庫、但絕不允許寫入的團隊
- 需要檢視主工作區之外檔案的使用者
不適合
- 支援範圍是精確的 DSH 版本白名單；宿主版本不在清單上、或核心套件混裝了不同版本時，fs / sandbox / registry / instructions / lsp / workspace-files 六行都不啟動，組合退化為「沒裝這個外掛」。
- 在 Windows 上，UNC（\\server\share）、\\?\、\\.\ 與對應的網路磁碟在登記時即以 unsupported-path 拒絕，因為受限 token 的 capability SID 無法綁定 SMB 存取。
- Windows 上的受限 shell 是 pwsh，不含 Git Bash：MSYS 在 restricted Low-integrity token 下無法啟動。
- 存取等級是三態的：inherit 跟隨工作階段模式，read-only 在任何模式下都拒寫（包含 Full-access），read-write 固定在唯讀工作階段裡仍可寫。已啟動的行程與常駐終端機保留啟動時的 deny 集合。
05相容性、維護與安全提醒
- 支援範圍是精確的 DSH 版本白名單；宿主版本不在清單上、或核心套件混裝了不同版本時，fs / sandbox / registry / instructions / lsp / workspace-files 六行都不啟動，組合退化為「沒裝這個外掛」。
- 在 Windows 上，UNC（\\server\share）、\\?\、\\.\ 與對應的網路磁碟在登記時即以 unsupported-path 拒絕，因為受限 token 的 capability SID 無法綁定 SMB 存取。
- Windows 上的受限 shell 是 pwsh，不含 Git Bash：MSYS 在 restricted Low-integrity token 下無法啟動。
- 存取等級是三態的：inherit 跟隨工作階段模式，read-only 在任何模式下都拒寫（包含 Full-access），read-write 固定在唯讀工作階段裡仍可寫。已啟動的行程與常駐終端機保留啟動時的 deny 集合。
- 指令輸出文案是英文（host 側沒有目前語言資訊），面板文案中英雙語並跟隨介面語言。
MIT · 最新發布 v0.1.16（2026-11-08）；精確比對的 DSH 版本白名單，從不修改上游套件
06常見問題
怎麼安裝 Multi-root Workspace？
在 DSH 外掛頁點「新增外掛」並填入 `@dsh-electron/dsh-plugin-multi-root-workspace`，或執行 `dsh plugin --profile web add @dsh-electron/dsh-plugin-multi-root-workspace`。首次安裝可能要在該 profile 的 pnpm-workspace.yaml 的 allowBuilds 下補 `koffi: true`，再執行一次 add。
怎麼新增一個目錄？
用 `/workspace-folders add ~/code/another-repo [--inherit|--read-only|--read-write]`，或從側邊欄開啟 Folders 對話框。新登記的根預設是 inherit，跟隨工作階段模式。
它會給 agent 新增可呼叫的工具嗎？
不會。README 說明 agent 照舊使用原生 read / write / edit / bash，只是被授權的目錄變多了。
支援哪些 DSH 版本？
只支援支援表裡精確列出的版本，從 0.1.5-rc.2 到 0.2.2-rc.1。版本不在表內、或 @deepseek-ai/dsh-* 各套件版本不一致時，外掛不會啟動，行為等同沒裝。
唯讀根在 Full-access 模式下還能寫嗎？
不能。read-only 在任何模式下都拒寫，包含 Full-access；README 記錄的唯一例外是使用者針對單次呼叫核准的一次性提權。
07相關的 DSH 工作流程
dsh-our-free-model
作者 ebony-vinyl
在 dsh 里装上这个插件即可，无需登录、注册或填 API Key，就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费，不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness（dsh）路由套件：先装运行时注入器，再加载任务感知的推理模式路由预设（已实测 P1-P23）。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底层操作工具插件，旨在减少 Token 消耗与任务耗时
brooks-lint
作者 hyhmrright
基于 12 本经典工程书籍的 AI 代码评审工具，提供腐化风险诊断、书籍引用、严重度标签及 6 种分析模式。
08資料與來源
本插件将 DSH 的工作区范围拓展到“一个主目录 + 多个附加目录”。
dsh plugin --profile web add @dsh-electron/dsh-plugin-multi-root-workspace
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-11-10。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。