cherrchen/dsh-plugin-multi-root-workspace ↗★ 6

@dsh-electron/dsh-plugin-multi-root-workspace

为沙箱环境添加多个附加工作区根目录 适合需要在沙箱中访问和管理多个外部项目文件夹的开发者。

套件
@dsh-electron/dsh-plugin-multi-root-workspace
相容性
待驗證
Harness 依賴範圍
0.1.5-rc.2 || 0.1.6-alpha.1 || 0.1.6-alpha.2 || 0.1.7-alpha.1 || 0.1.7-alpha.2 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-alpha.2
Cordis 依賴範圍
>=4.0.1 <5.0.0 || 4.0.5-alpha.1
版本
0.1.6
授權
MIT
最近更新
2026年10月13日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:cherrchen/dsh-plugin-multi-root-workspace

使用方法

命令

/workspace-folders [list]                              # 列出主根与附加根(含每根访问级别与状态)
/workspace-folders add  [--read-only|--read-write]   # 不带路径时打开系统目录选择器;默认 read-write
/workspace-folders access  read-only|read-write     # 切换访问级别(升到可写要求该根此刻可用)
/workspace-folders alias  [别名]                     # 不带别名则清除已有别名
/workspace-folders remove                            # 序号即 list 输出的编号
/workspace-folders reveal                            # 在文件管理器中显示
/workspace-folders help                                       # 查看命令帮助

路径可带引号;与已有根重复、嵌套在已有根内部、或就是主根本身的路径会被拒绝。

附加根默认与主根同权(read-write),add 时带 --read-only 或事后 access 可切为只读。每个主根最多登记 16 个附加根(maxAdditionalRoots 配置可调至 64)。宿主还可以在 multi-root-scope 行配置 toolAccess,例如 { bash: 'read-only' } 让 bash 永远不能写任何附加根(仍可写主根)。

add 后执行 list 的预期输出:

Workspace root (primary; access follows the current sandbox mode): /home/me/monorepo
  1 /home/me/payments-service [支付] (read-write)
  2 /home/me/website (read-write)
2 of 16 additional roots.
Writable additional roots: 2 of 2.

面板

侧栏底部的 Folders 对话框列出主根与附加根,支持添加、移除、别名、切换只读/可写、复制路径、在文件管理器中显示与上下移排序。

模型侧

附加根的拓扑信息会注入系统提示词,让模型知道当前有哪些目录可用,授权变化时信息随之更新,不需要向模型提供新的工具。