dsh-write-create-only

dsh·write 仅创建插件

禁止 write 覆盖已存在的文件：write 只允许创建新文件，目标已存在时在工具执行前直接拒绝并提示改用 edit，全局所有会话生效，防止模型用 write 把已有文件整体冲掉。纯 host 端插件，不碰 DSH 源码。

为什么

write 是全文件覆写。模型一旦误用 write 去改一个已有文件，原内容会被整段覆盖，而 dsh 默认的 fs-observation-policy 只要求「先读过」，并不禁止覆写。与其事后靠模型自觉，不如把「write = 仅创建」立成硬约束。

功能

• 只拦 write：edit、read 等其余工具完全不受影响。
• 目标已存在 → 拒绝：在 tools/pre-execute 瀑布里对 write 调用先 fs.stat 目标，已存在则返回 deny，错误信息明确提示「请改用 edit 做定向修改；只有创建新文件时才使用 write」，模型看到后会改走 edit。
• 目标不存在 → 放行：新建文件一切照常。
• 保守放行：路径无效、stat 抛错等不确定情形一律放行，绝不误伤合法调用。
• 全局生效：所有 agent 与会话统一适用。

安装

从 GitHub 安装：源码在 src/，lib/ 不入仓库，安装时 npm 会触发 prepare 脚本现场构建。

dsh plugin --profile web add github:better-er/dsh-write-create-only

从 npm 安装：包内已含构建产物 lib/index.js，安装时不再构建。

dsh plugin --profile web add dsh-write-create-only

两种方式装完都会自动挂载，重启 DSH web 后启用，无需手工编辑任何文件。

卸载

dsh plugin --profile web remove dsh-write-create-only

彻底移除，重启 DSH web 后不再加载。

原理

dsh 的每个工具在执行前都会走 tools/pre-execute 这个异步瀑布，每个监听器按序决定 allow / ask / deny。本插件注册一个全局监听器：

• 只对 exec.name === 'write' 生效；
• 取出 exec.arguments.file_path，用会话工作目录 ctx.fs.resolve 成绝对目标，再 ctx.fs.stat；
• stat 返回非空即目标已存在，返回 { kind: 'deny', reason } 拒绝本次调用；
• 其余情况一律 return next() 放行到瀑布下一环。

选择 tools/pre-execute 而不是 fs/write-intent，是因为后者是单槽瀑布且已被默认的 fs-observation-policy 占用；而 tools/pre-execute 是多监听器瀑布，位置在工具执行最前面，既不影响 write 的 schema，也不与现有策略抢位。

开发与验证

npm install
npm run build     # 产出 lib/index.js
node scripts/smoke.mjs   # 无运行时冒烟验证：5 项断言覆盖拦截/放行/容错

License

MIT