在 DeepSeek Harness (DSH) 的会话权限控制中,通常只有“仅工作区”或“全部”两个选项。当需要在两者之间取得平衡,即限制智能体仅能写入特定目录时,dsh-workspace-scope-selection 插件提供了第四个选项:Selected Workspace Write。
插件简介¶
该插件由 jiangr100 维护,采用 MIT 许可证。它通过在 composer 中新增权限选项,允许用户通过目录树编辑器精确指定哪些目录是可写的,并在文件系统和 Shell 工具中强制执行该限制。
安装与启用¶
使用 file: 协议安装,然后重启 dsh web。
dsh plugin --profile web add file:/path/to/dsh-workspace-scope-selection
安装完成后,重启 dsh web 进程以加载插件。
核心功能¶
-
权限选项
在 composer 的权限芯片(或通过/permission命令)中增加了 Selected Workspace Write 选项。 -
目录树编辑器
选择该选项后,会打开一个目录树编辑器。勾选的目录即为可写范围。默认勾选工作区根目录,可取消勾选以使其变为只读。取消勾选父目录会移除其整个子树;通过父目录勾选的子目录会显示“via parent”标记。 -
沙箱模式
插件在文件系统和 Shell/终端沙箱中添加了selected-workspace-write模式。只有选中的目录(加上平台临时区域)是可写的。 -
会话持久化
选择结果存储在会话日志中,在会话重启后依然有效。 -
访问控制
任何超出选中范围的写入操作均被拒绝,需要通过批准升级流程。
使用步骤¶
- 点击权限芯片或输入
/permission,选择 Selected Workspace Write。 - 在编辑器中,勾选允许智能体写入的目录。
- 点击 Done 以立即应用范围限制。
注意事项¶
- 通用设置差异:在“通用设置”的权限行中,仍仅显示三个内置选项;该插件提供的选项是每会话的开关。
- Windows 平台限制:在 Windows 上,只有工作区和临时区域可写;额外的选定根目录将被拒绝写入。
- 写入审批:任何超出选定范围的写入操作总是需要升级批准。