developerdh/dsh-sandbox-allowlist

README 摘要

dsh-sandbox-allowlist DSH（DeepSeek Harness）沙箱扩展插件：为官方默认沙箱增加 可配置的可信可写目录 ， 让沙箱内的 CLI 命令与 write/edit 文件工具都能写工作区之外的「沙箱授权目录」—— 不需要每次审批、不需要关闭沙箱 。 - ✅ 通过官方插件机制安装： dsh plugin --profile add dsh-sandbox-allowlist - ✅ 配置支持多个目录、 通配符 （ 子树、 一级子目录、 ? 单字符） - ✅ 覆盖 Windows（ACL 沙箱）与 Linux（bwrap） - ✅ 设置页可编辑（ sandbox-allowlist 设置 namespace，含安全警示说明） - ✅ 纯插件实现：不修改任何 node modules / 官方包代码 原理 DSH 沙箱允许写哪里 = 允许清单（allow-list）。本插件向清单 追加沙箱授权目录 ： - Windows ：沙箱用「工作区写 SID 的 Write ACE」作为允许清单。插件在沙箱授权目录上 物化该 SID 的 继承式写 ACE （ (OI)(CI)(W,D,DC) ）→ 受限 CLI 直接可写、 未来子目录自动继承；write/edit 工具由自研 fs 栅栏放行同一份清单。 - Linux ： bwrap 追加 --bind ；landlock/seatbelt 暂不支持 （会告警并忽略，建议使用 bwrap）。 安装 dsh plugin add 会自动把本包追加进 profile 的 dsh.profile.bundles 层， 其 cordis.patch.yml 作为补丁层挂载：禁用官方 sandbox-policy / fs-sandbox 行（Linux 另禁 sandbox 行），插入本包的替换行。改完后 HMR 自动热应用 ， 无需重启。 配置（设置页 / settings.yaml） 沙箱授权目录清单通过 sandbox-allowlist 设置 namespace 管理（设置页可编辑，写入 $DSH HOME/settings.yaml ，实时生效）： ⚠️ 安全警示 ：沙箱授权目录将被沙箱内的 AI 代理直接写入（无需审批）。请只添加 完全信任的目录；目录必须 已存在且归当前用户所有 ；撤销信任删除条目即可 （Windows 上旧目录的 ACE 用 node scripts/revoke.mjs 清理）。 通配符在 每次调用前懒展开 （TTL 缓存， expandTtlMs 可调）；不存在的路径跳过 并告警（ strict: true 可改为抛错）；锚定盘符/根目录且带 的模式被拒绝 （防整盘遍历）。 包结构 开发与验证 真机验证要点：受限 pwsh / write 工具写沙箱授权目录应成功且…

分类