dsh-cdrive-guard
DiscoveredDSH Plugin: Default Deny Agent Writes to C Drive, Manual Approval to Allow, Prefix-Based Whitelist Configuration, Directory Redirection to D Drive + Junction Back-Link
dsh-cdrive-guard
DSH 插件:默认拒绝 Agent 向 C 盘写入,必须经人工确认才放行;支持按路径前缀配置的免检清单,可把目录转存 D 盘并用 Junction 回链,内置磁盘清理流水线。
策略链
按优先级判定每一次写入 / 编辑:
1. 免检 exemptPrefixes → 放行(系统、驱动、安装目录,避免误拦导致 Windows 更新失败)
2. 授权 grants → 放行(人工审批后的一次性 / 限时 / 永久)
3. 默认拒绝 → 抛 CDRIVE_WRITE_BLOCKED,要求 Agent 申请
模式:
deny(默认)— 拦下所有未授权 C 盘写入observe— 只记录审计,不拦截(灰度观察用)off— 关闭守卫
安装
把本目录放进 DSH profile 的 node_modules,或在注入器里指向本目录:
dev_inject_plugin({ dir: "D:/path/to/dsh-cdrive-guard" })
插件不声明任何 inject,运行期懒获取 fs / tools / userQuestions。
这样服务缺失时许永不 pending,loader.create() 不会永不 settle。
工具
| 工具 | 用途 |
|---|---|
cdrive_guard_status | 模式、豁免清单、有效授权、拦截统计、审计位置 |
cdrive_guard_config | get / set / addExempt / removeExempt |
cdrive_request_write | 申请写入:发起人工确认卡片 |
cdrive_relocate | 搬 C 盘目录到 D 盘 + Junction 回链(默认 dryRun) |
cdrive_report | 各盘可用空间 + 目录体积排行 |
cdrive_clean | 清理流水线(6 步,默认 dryRun) |
人工审批
审批走 user-questions 服务,不走 approval.request()。
原因:某些部署会给审批打「自动放行」补丁(例如把所有 approval 请求直接返回 allowed-once),那条路上的「人工确认」是假的。user-questions 是真正把卡片递到用户面前的通道。
四个选项决定授权范围:
允许这一次 → 10 分钟一次性授权
允许限时 → grantTtlMinutes(默认 30 分钟)
并加入豁免清单 → 写入 exemptPrefixes(永久)
拒绝 → 保持拒绝
拿不到 user-questions 时 fail closed(按拒绝处理),绝不静默放行。
数据文件
全部在 ~/.dsh/cdrive-guard/:
config.json— 模式、数据根、exemptPrefixes、relocatablePrefixesgrants.json— 有效授权(读取时剔除过期项)audit.jsonl— 每行一条判定:ts, op, path, decision, reason, grantId
审计语义:decision=deny 是拦截,reason=exempt:C:\Windows 是豁免放行,reason=human-approved:once 带 grantId 是人工批准。
默认免检前缀
按路径前缀匹配,大小写无关、带边界判断(C:\Windows 不会误匹配 C:\WindowsOld):
C:\Windows
C:\Program Files
C:\Program Files (x86)
C:\ProgramData
C:\$Recycle.Bin
C:\System Volume Information
C:\Recovery
C:\PerfLogs
按前缀配置是刻意的设计:驱动目录、系统目录必须免检,否则一次系统更新就可能因为被拦而失败。
测试
node test/guard.test.mjs
41 条断言,打桩 ctx 与其服务,不启动 loader,覆盖:装载时序、默认拒绝、豁免前缀、D 盘放行、C 盘工作区开关、审批放行、用户拒绝、addExempt、observe 与 deny 切换、审计内容、搬迁敏感目录拒绝、状态输出。
通过 41 / 失败 0
已知限制
- 只拦截走
ctx.fs.writeText/editText的写入。shell(bash / pwsh)里的重定向、以及自行fs.write的插件不经过这条接缝。 - 单文件无法用 Junction 回链(Junction 只对目录有效);单文件走「申请授权」而不是「搬迁」。
- Windows 上创建目录符号链接需管理员,本插件一律用
junction类型,免提权。
License
MIT
Comments
Loading…
Similar plugins
by AGImentu
DSH 插件:在「更多设置」里查看、修改并保存所有 agent 共用的全局系统提示词,保存后立即生效。
★ 0
MIT
JavaScript
Oct 6, 2026
dsh plugin --profile web add dsh-prompt-editorby Knot-chord
DSH 插件:让多个自动化插件不抢同一窗口——同一目标一回合一个动手类,决策写入 JSONL 审计。
★ 0
MIT
JavaScript
Nov 15, 2026
dsh plugin --profile web add @local/dsh-capability-policyby Shiro-Design-16
在 DSH「插件」页里编辑 daily agent preset 的子条目列表(persona 与工具组合)——内存挂载,不写任何文件
★ 0
MIT
JavaScript
Oct 14, 2026
dsh plugin --profile web add dsh-daily-chat-configby NEVSTOP-LAB
DSH 审批模式插件,在 DSH 窗口的权限下拉框(Read Only / Workspace Write / Full Access)旁边加一个「审批模式」按钮,在 Workspace Write 模式下工具调用自动放行
★ 10
MIT
JavaScript
Nov 13, 2026
dsh plugin --profile web add dsh-approval-modeby developerdh
为 DSH 默认沙箱增加可配置的「沙箱授权目录」,允许工作区外的受信修改。
★ 11
↓ 216/wk
MIT
JavaScript
Nov 10, 2026
dsh plugin --profile web add dsh-sandbox-allowlistby tianyaojiudi-prog
DSH(DeepSeek Harness) 插件:把一段可在设置页随时改写的文字,作为全局系统提示词段注入到所有会话,含子代理与工作流内部子代理;文本与开关即时生效,无需重启。
★ 9
MIT
JavaScript
Oct 4, 2026
dsh plugin --profile web add dsh-djy-xttsc