dsh-fs-extra

仓库: https://github.com/Rieko0328/dsh-fs-extra License: MIT · 在 DSH 0.2.0-rc.2（Windows）上开发并实测通过

为 DeepSeek Harness 补齐文件工具缺失的删除 / 建目录 / 移动能力。

DSH 内置的文件工具（write / edit）只有写入能力，没有删除、建目录、移动。 而能删除的 shell 通路（ops_bash / pwsh）受会话工作区沙箱限制，工作区外一律拒绝。

本插件补上这块，并且严格遵守会话的沙箱档位，不做越狱。

---

提供的工具

工具	用途	受档位限制
fsx_delete	删除文件或目录（目录递归）	✅ 是
fsx_mkdir	创建目录（可递归多级）	✅ 是
fsx_move	移动 / 重命名（支持跨盘）	✅ 是（源和目标都要通过）
fsx_list	列目录（含大小与类型）	❌ 只读
fsx_policy	报告本会话解析到的档位与工作区根	— 自检用

fsx_delete 支持 dryRun，便于先确认再动手。

---

权限模型（重点）

插件在每次调用时读取会话的沙箱档位 （ctx.get('sandboxPolicy').resolve({ session })，与 dsh-ops 同源），并按档位限制：

会话档位	插件行为
danger-full-access	允许任意路径
workspace-write	仅允许会话工作区（workspaceRoot）子树内，区外抛错
read-only	写 / 删 / 建 / 移 全部拒绝
档位无法确定	保守处理，按 workspace-write 限制

另外内置系统目录黑名单，任何档位下都拒绝操作 C:\Windows、C:\Program Files、C:\ProgramData 等。

⇒ 把权限调成「工作区内可写」时，模型无法用本插件越狱。

随时可用 fsx_policy 确认当前生效的边界：

沙箱档位: workspace-write
工作区根: E:\myproject
⇒ 本插件仅允许 E:\myproject 子树内操作

---

为什么需要它

一个真实场景（Windows）：

权限设为「完全权限」后，逐目录实测：
  ✅ E:\project        可写（已获沙箱授权，有 S-1-4-* ACE）
  ❌ C:\Users\me        拒绝
  ❌ C:\Users\me\Desktop 拒绝
  ❌ D:\               拒绝

⇒ shell 子进程被套了受限令牌（低完整性），只有带沙箱授权项的目录可写
⇒ 而文件工具虽然不受限，却只能写、不能删

结果：删文件 / 建目录 这两件最基础的事，在工作区外做不到。

本插件走进程内 node:fs 通路，与文件工具同级，不受子进程令牌限制， 同时保留沙箱档位的语义。

---

安装

从 GitHub 安装

dsh plugin --profile <profile> add "github:Rieko0328/dsh-fs-extra"

作为本地 bundle（独立于任何注入器）

dsh plugin --profile <profile> add "E:\path\to\dsh-fs-extra"

或在 profile 的 package.json 中加：

{
  "dsh": {
    "profile": {
      "bundles": ["dsh-fs-extra"]
    }
  },
  "dependencies": {
    "dsh-fs-extra": "link:E:/path/to/dsh-fs-extra"
  }
}

然后重启 DSH。

运行时注入（需要 dsh-super-injector）

dev_inject_plugin {"dir": "E:/path/to/dsh-fs-extra"}

---

兼容性

• 需要 @deepseek-ai/dsh-tools（工具注册）
• 需要 @deepseek-ai/dsh-sandbox-policy（档位解析）—— 缺失时会保守降级为工作区限制
• Node.js ≥ 22.19
• 在 DSH 0.2.0-rc.2（Windows）上开发并实测通过

---

工具定义格式说明（给插件作者）

本插件的工具定义形状对齐 dsh-ops/lib/shells.js。 注意 parameters 必须是完整 JSON Schema，简写会被拒绝：

// ❌ 错误 —— 会报 'schema must be a JSON Schema of type: "object", got "type: null"'
parameters: { path: { type: 'string', required: true } }

// ✅ 正确
parameters: {
  type: 'object',
  properties: { path: { type: 'string', description: '...' } },
  required: ['path'],
  additionalProperties: false,
}

---

License

MIT