文件操作扩展 Rieko0328/dsh-fs-extra

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