生成文件守护 acus9345/dsh-protect-generated-files

dsh-protect-generated-files

智能体会去改那些本不该手动编辑的文件。它们会把版本号直接打进 pnpm-lock.yaml，修掉 user.pb.go 里的错别字，或者「纠正」Prisma 生成客户端里的类型。改完看着没问题，直到下一次 pnpm install 或 protoc 跑起来把它冲掉；更糟的是，锁文件和 package.json 对不上，你得花一下午才能理清。

这个 DeepSeek Harness 插件会拒绝针对生成文件和锁文件的 write、edit 调用，也会拒绝用 shell 原地改它们（sed -i、perl -pi、> file、tee file）。它不会只回一句「不行」，而是告诉模型这个文件该怎么改：

dsh-protect-generated-files blocked this edit to db/query.sql.go: its header says it is
generated (// Code generated by sqlc. DO NOT EDIT.). A hand edit will be overwritten
the next time it is regenerated, or leave it out of sync with its source.
Instead: edit the SQL queries/schema and run sqlc generate.

安装

dsh plugin --profile web add dsh-protect-generated-files

这里用的是 web 配置档，也就是你用 dsh web 启动的浏览器界面。如果你用别的方式跑 DSH，就换成 headless（脚本和 CI）或 acp（编辑器集成）。每个配置档各管一份插件列表，所以你用到的每个配置档都要加一遍。装完立刻生效。卸载用 dsh plugin --profile web remove dsh-protect-generated-files。

从克隆仓库安装

想试本地改动，就打个 tarball 再装：

git clone https://github.com/acus9345/dsh-protect-generated-files
cd dsh-protect-generated-files
npm install
npm pack
dsh plugin --profile web add ./dsh-protect-generated-files-0.2.0.tgz

它怎么判断一个文件是生成的

有三种方式会把文件标记出来。

锁文件，按文件名识别。 package-lock.json、pnpm-lock.yaml、yarn.lock、bun.lock(b)、deno.lock、Cargo.lock、go.sum、poetry.lock、uv.lock、pdm.lock、Pipfile.lock、Gemfile.lock、composer.lock、mix.lock、pubspec.lock、Podfile.lock、flake.lock、gradle.lockfile、packages.lock.json、conan.lock。每一种都配了对应包管理器的正确命令，比如「用 cargo add / cargo update -p <crate> 改依赖」。

已知的输出路径。 Protobuf 输出（.pb.go、_pb2.py……）、Dart build_runner 输出、.Designer.cs、压缩文件和 source map，以及 node_modules/、__generated__/、.venv/、site-packages/ 里的任何东西。构建输出目录（dist/、target/、.next/、vendor/ 等）只有在紧挨着 package.json、Cargo.toml、go.mod 这类项目清单文件时才算数，所以碰巧叫 target 的源码目录不会被误伤。
文件头会说明一切。 它读取文件前 15 行，查找 Code generated ... DO NOT EDIT、@generated、DO NOT EDIT、auto-generated、This file was generated、<auto-generated>，或者 Generated by <tool> 注释。如果文件头说这个文件可以编辑（「edit freely」「safe to edit」），或者是有条件的 DO NOT EDIT without ...，那就不算。当文件头提到它认识的工具时，提示里也会点名那个工具：protoc/buf、Prisma、GraphQL Codegen、OpenAPI generators、sqlc、go generate、Drizzle、Alembic 等等。「Generated by hand」和「generated by ChatGPT」不算。

文件头检查只对已经存在的文件生效。文件名和路径规则也覆盖新文件，因为从零手写一个 lockfile 同样是错的。

在 Windows 上，DSH 通过 PowerShell 执行命令，所以它还会盯着 Set-Content、Add-Content、Out-File 和 Tee-Object。

什么时候手动编辑是对的

这种情况确实存在：解决 lockfile 的合并冲突，或者上游还没修，先在 vendored 代码里打个一行的热修复。模型会被告知可以重复一次完全相同的调用以确认，这次会放行。如果你想自己批准这些操作，用 mode: ask。如果某个目录看起来像生成的，但其实是手工维护的，把它加进 ignore。

设置

最简单的办法：打开 DSH 侧边栏里的 Plugins，点击 dsh-protect-generated-files，改你要改的，然后按 Save。它会在下一次工具调用时生效，不用重启。

或者往 ~/.dsh/profiles/<profile>/cordis.patch.yml 里加一行这样的配置，想对所有配置档生效就加到 ~/.dsh/cordis.patch.yml。没写的键保持默认值。

- id: protect-generated-files
config:
mode: deny # or ask for an approval prompt
extraGlobs: # your own generated paths, each with the hint the model gets
'src/api/client/': 'edit openapi.yaml and run npm run gen:api'
ignore: ['vendor/'] # never treat these as generated
defaultGlobs: true # false: only lockfiles, headers and extraGlobs
headerLines: 15
guardShell: true # also watch sed -i / perl -pi / > / tee
allowIdenticalRetry: true # false: a refusal is final
shellTools: [bash, pwsh] # pwsh is the shell DSH uses on Windows

extraGlobs 是最值得设置的。告诉模型哪个脚本能重新生成你的代码，它就不用猜了。

开发

npm install
npm test # detector unit tests
npm run test:e2e # real dsh runs against a scripted local model, no API key needed

安装测试会运行 dsh plugin add，这需要 pnpm 在你的 PATH 里。

MIT 协议。作者 acus9345。欢迎在 issues 里提 bug 和想法。