dsh-ops 安全机制全解析:fail-closed 沙箱、no-follow 路径与权限三模式如何深度对齐

原创2026-10-16 11:28:471,874 阅读
文章标签:dsh-pluginAI 插件AI 应用

dsh-ops 安全机制全解析:fail-closed 沙箱、no-follow 路径与权限三模式如何深度对齐

dsh-ops 是 DSH(DeepSeek Harness)的底层操作工具插件,旨在减少 Token 消耗与任务耗时。但它的另一面同样值得了解:如何保证 AI 在替你执行命令、改写文件时"不越界"?本文将用新手也能懂的语言,拆解 dsh-ops 的三大安全机制——fail-closed 沙箱、no-follow 路径检查与 DSH 权限三模式(read-only / workspace-write / danger-full-access),以及它们如何互相咬合、形成完整防线。


为什么"省 Token 的工具"必须先谈安全?

dsh-ops 的核心价值是让 AI 用 Rust 重写的高效工具(文件检索、批处理)和独立 bash 替代低效的 PowerShell 试错,官方 benchmark 中 Token 消耗最多降低 97%。

但效率提升的代价是:AI 手里多了"能真正动你文件"的工具。一旦失控,省下的时间会被数据事故成倍抵消。dsh-ops 的答案是把 DSH 宿主自带的权限体系原样贯穿到每一个插件工具里,而不是绕开它。

🧭 一句话总览:权限三模式决定"能做什么",no-follow 路径决定"怎么安全地做",fail-closed 决定"做不了就干脆不做"。


权限三模式:read-only、workspace-write 与 danger-full-access

DSH 会话有一个权限选择器,提供三档模式,全部定义在共享的权限词汇表 lib/permissions.js 中:

模式 含义 dsh-ops 工具可见性
read-only 只读,任何修改都被拒绝 四个文件工具可用,但 ops_replace 写操作被拒绝;不发布 ops_bash 与后台工具
workspace-write 仅允许在工作区与 DSH 临时区域内写入 四个文件工具 + ops_bash(必须通过 OS 沙箱包裹后运行)
danger-full-access 完全访问,不再施加写围栏 全部工具,允许操作工作区之外的显式路径

几个新手容易误解的点:

  • read-only 不是"看不到文件"。 所有模式下,OS 可读的路径都可以被读取;被拒的只是写(如 ops_replace)。拒绝信息会明确告诉你"用户选择了 read-only,没有文件被修改",并给出下一步建议:请用户把权限选择器切换到所需模式,不要重试、不要换目录绕过沙箱(见 lib/permissions.js 中的 permissionError)。
  • workspace-write 的写边界由 Rust 端二次校验。 宿主侧把可写根目录(工作区根 + DSH 临时区)传给原生 worker,worker 在执行替换前会在 Rust 里重新核对白名单(lib/file/worker.js),越界写入返回 POLICY_DENIED。
  • 模式切换是动态的。 会话权限在中途改变时,插件会撤销旧的命令句柄、重新发布工具;同一请求从"受限"变"完全权限"不会发生——审批权始终在 DSH 和用户手里,插件从不自我提权。各模式下的工具发布规则可见验收清单 docs/manual-validation.md。

no-follow 路径检查:让符号链接"无路可走"

威胁从哪里来

AI 工具操作路径时,一个经典漏洞是符号链接逃逸:工作区里一个看似无害的链接 link -> /etc/passwd,如果工具"跟随"链接,限制在 workspace 内的写操作就会落到工作区之外。Windows 上还有 junction、reparse point 和 CON、NUL 这类设备名,同样是陷阱。

dsh-ops 怎么做:逐级打开、逐段拒绝

核心实现在 Rust 原生 worker 的 native/src/file_path.rs。它不用"拿到路径就打开"的常规方式,而是:

  1. 强制绝对路径:拒绝相对路径、超长路径(> 4096 字节)与含空字符的路径,只接受宿主解析后的规范化路径;
  2. 逐段打开目录:从盘符/根目录开始,一个组件一个组件地用 open_dir_nofollow 打开——no-follow 的含义是"打开时绝不跟随链接";
  3. 每一段都验明正身:symlink、Windows reparse point(0x400 属性位)、特殊对象,一律以 POLICY_DENIED 拒绝,错误信息会指出"链接与特殊对象不会被遍历"(native/src/file_path.rs);
  4. 拦截设备名:CON、PRN、AUX、NUL、COM1–9、LPT1–9 以及含 : * ? < > | " 的模糊 Windows 写法,全部在参数阶段就被拒绝,而不是留到 shell 里"碰运气"。

目录遍历(ops_glob / ops_grep)同样贯彻 no-follow:链接目录、隐藏文件、.git、node_modules、target、.venv 一律跳过,并受 128 层深度、10 万条目的预算约束(native/src/file.rs),防止目录炸弹式的资源滥用。

🔒 设计要点:no-follow 不是"检测到链接就警告",而是从操作系统句柄层面就无法跟随——即使恶意进程把中间目录换成链接,worker 看到的也只是"打不开",而不是"换条路继续走"。


fail-closed 沙箱:失败时,默认是"拒绝"

fail-closed(失败关闭) 是安全设计的黄金原则:任何检查不确定、服务缺失或沙箱异常时,宁可拒绝执行,也绝不降级为"直接跑"。dsh-ops 把它贯彻在三层:

1️⃣ 沙箱缺失 → 不执行命令

受限模式下 ops_bash 必须经过 DSH 宿主的 sandbox.confine 包裹。如果沙箱服务不可用、返回结果无效,命令原样终止,报错信息明确写着"这不是用户授权被拒,但也不要重试或绕过"(lib/session-shells.js)。官方文档的原话是:"Shell 与 PTC 代码仍要求 OS 约束,不存在无约束的兜底路径"(docs/native-ptc.md)。

2️⃣ 执行器未认证 → 拒绝运行

受限模式下,ops_bash 只运行固定摘要、IPC 代理已验证的随包 bash。你自己配的 bashPath(哪怕是很可信的 Git for Windows)会按设计返回 EXECUTOR_UNAVAILABLE——系统甚至会用 SHA-256 逐一核对 bash 运行目录下所有可执行文件,防止"被换掉的那一个文件"(lib/bash-ipc.js)。

3️⃣ 权限中途变化 → 终止并如实报告

执行准备期间再次解析权限策略,若模式或工作区根发生变化,直接报 POLICY_DENIED: Authority changed during preparation;worker 被中断、输出超预算等不确定性场景,返回 RESULT_UNKNOWN 并要求先检查后效状态,绝不"猜"结果(lib/file/worker.js)。

💡 新手记忆口诀:dsh-ops 的每种"不"都附带下一步——告诉你该改哪个权限选择器、该删哪个配置项,而不是抛一个看不懂的堆栈。


三机制如何对齐:一次文件替换的安全旅程

以 ops_replace 在 workspace-write 会话中修改一个文件为例,防线依次经过:

阶段 检查 失败结果
① 参数 路径规范化、绝对化、长度与字符校验 INVALID_ARGUMENT
② 模式 read-only 直接拒绝替换 POLICY_DENIED
③ 写围栏 目标必须在工作区根 / DSH 临时区内(Rust 端二次核对) POLICY_DENIED
④ 路径 no-follow 逐段打开,拒绝链接/设备名/特殊对象 POLICY_DENIED
⑤ 权限复查 执行前权限未变化 POLICY_DENIED
⑥ 内容 SHA-256 修订校验(CAS)+ 原子替换 冲突则保留现场

任何一环失败,动作都是不做,且错误值中带有 nextAction 指引——工具从不抛异常,而是返回带 status / error.code 的结构化值(docs/component-reference.md)。


边界声明:dsh-ops 不夸大的那些事

好的安全设计会说清自己不做什么,dsh-ops 的文档做得很坦诚(docs/native-ptc.md):

  • 审计记录存于 <workspace>/.dsh-ops/,是本地明文,不是加密保险箱——工作区属主可以篡改它;
  • no-follow 能防普通符号链接逃逸,但无法防御恶意进程在操作瞬间主动改目录、换内容的竞态;
  • 审批与提权永远归 DSH 与用户所有,插件不自我授权,也不提供"单次调用绕过沙箱"的开关。

小结:一张表看懂 dsh-ops 安全模型

机制 解决什么问题 关键行为 核心代码
权限三模式 AI"能做什么" 读放行、写分域、全开需明示;切换即时生效 lib/permissions.js
no-follow 路径 链接/设备名逃逸 逐段打开、逐段拒绝、预算约束 native/src/file_path.rs
fail-closed 沙箱 沙箱/执行器不可信时怎么办 缺失即拒绝,绝无裸执行兜底 lib/session-shells.js

对于普通用户,日常建议很朴素:默认 workspace-write 足够日常开发,read-only 适合让 AI 纯分析,danger-full-access 留给明确知道后果的高危任务。想深入每个配置项与工具参数,可以从 docs/配置参考.md 和 docs/组件参考.md 开始。

登录后查看全文
dsh-ops