dsh-diff-writer
Advanced tools
Precise file editing for DeepSeek Harness: apply search/replace patches to files instead of full-file rewrites, minimizing accidental changes.
精确文件编辑插件（v0.2.1）：用 search/replace 补丁和行号模式补丁修改文件，避免整文件覆盖带来的误改风险。与 dsh-file-manager-cli（整体读写）和 dsh-git-helper（提交）形成互补的文件工作流。
npm install dsh-diff-writer
import { apply_patch } from "./index.js"
// 示例：修改配置文件中的特定值
await apply_patch({
path: "config.json",
patches: [
{
search: '"debug": false',
replace: '"debug": true',
all: true
},
{
search: '"port": 3000',
replace: '"port": 8080'
}
]
})
// 示例：使用行号范围删除和插入
await apply_patch({
path: "README.md",
patches: [
{
startLine: 10,
endLine: 15,
replace: "" // 删除第 10-15 行
},
{
startLine: 20,
endLine: 20,
replace: "# 新增内容\n" // 在第 20 行前插入
}
]
})
// 示例：创建新文件
await apply_patch({
path: "new-file.js",
create: true,
patches: [
{
search: "",
replace: "console.log('Hello World!')"
}
]
})
apply_patch 与 apply_patches 都支持 dry_run: true，先看改动再决定是否落地：
await apply_patch({
path: "src/app.js",
patches: [{ search: "const DEBUG = false", replace: "const DEBUG = true" }],
dry_run: true
})
// [dry-run] src/app.js
// 修改：12 行 → 12 行，替换 1 处
// @@ -3,1 +3,1 @@
// ...
// - const DEBUG = false
// + const DEBUG = true
预览输出包含文件路径、行数变化、替换处数与统一 diff 片段（默认前后各 3 行上下文，超过 40 行的增删块会被截断说明）。
apply_patch对目标文件按顺序应用一组补丁，支持两种补丁模式。
| 参数 | 类型 | 说明 |
|---|---|---|
path | string | 必填，目标文件路径（相对或绝对，必须在工作目录内） |
patches | array | 必填，补丁列表，按顺序应用 |
create | boolean | 可选，文件不存在时创建新文件（此时 patches 可为空） |
dry_run | boolean | 可选，true 时只输出改动预览，不写入磁盘 |
apply_patches（多文件批量）一次调用对多个文件应用补丁，适合同一批改动的跨文件落地。
| 参数 | 类型 | 说明 |
|---|---|---|
files | array | 必填，文件列表，每项为 { path, patches, create? }，语义同 apply_patch |
dry_run | boolean | 可选，true 时逐个输出预览，不写入磁盘 |
批量语义：先对全部文件做校验与计算，任一文件出错则整体不写入（此时磁盘上不留任何修改）；全部通过后才逐个原子写入。单次最多 20 个文件、每文件最多 20 个补丁。
{
search: "要匹配的内容",
replace: "替换后的内容",
all?: false // 可选，默认 false，仅替换唯一匹配处
}
{
startLine: 10, // 起始行号（1 基）
endLine: 20, // 结束行号（包含）
replace: "替换内容" // 空字符串表示删除该行范围
}
匹配规则：
search 必须与文件内容精确匹配（含缩进与换行）all: true 时全量替换所有匹配search 不允许；空 replace 表示删除安全边界：
create=true 不能用于已存在的文件dry_run=true 只读不写，可安全用于任何目标路径apply_patch 会直接修改目标文件，调用前请确认目标与范围。A: 补丁失败时会立即中止执行，失败的补丁之前的修改已经写入文件（不自动回滚）。你需要根据错误信息修复问题后重试整个操作。建议在非生产环境或使用版本控制操作。
A: 精确匹配确保不会意外修改相似但不完全相同的内容，避免产生误改。如果需要模糊匹配，可以扩展搜索内容包含更多上下文使其唯一。
A: 有两种方式：
all: true 参数替换所有匹配处（需谨慎使用）A: 行号模式适用于：
搜索模式适用于：
A:
apply_patches 工具：多文件批量补丁，先整体校验再写入apply_patch 与 apply_patches 新增 dry_run 预览模式，输出统一 diff 片段{ startLine, endLine, replace }create=true 且 patches=[]）npm test
覆盖所有核心功能：
cd dsh-diff-writer
npm install
npm test
package.json 中的版本号npm test 确保测试通过npm publish1. 精确修改长文件中的几行
用户：把配置文件第 42-45 行换成新内容
apply_patch 按行号范围替换，避免整文件重写带来的意外改动。
2. 大文件局部修补
用户：这个 3000 行的文件只改一处，不要重写整个文件
按行号打补丁，改动范围可控、可复核。
3. 与 diff 结果配合
用户：先看看差异，再决定改不改
先用 dsh-text-diff 得到差异，确认后用 apply_patch 落地。
4. 批量文件的一致性修补
用户：这几个文件都要把同一段替换掉
对每个文件分别调用，补丁范围明确，失败时不会留下半个文件。
| 协作插件 | 集成方式 |
|---|---|
| dsh-text-diff | 改动前用 diff_text 预览差异，确认后再用本插件落盘 |
| dsh-line-ops | extract_lines 取出目标行内容，apply_patch 负责写回 |
| dsh-regex-lab | 先用 replace_preview 预览正则替换结果，再按行号精确写入 |
| dsh-hash-checksum | 补丁前后计算文件摘要，确认只有预期文件被改动 |
| dsh-fs-inspector | 改动前用 recent_files 确认目标文件与备份状态 |
FAQs
Precise file editing for DeepSeek Harness: apply search/replace patches to files instead of full-file rewrites, minimizing accidental changes.
The npm package dsh-diff-writer receives a total of 10 weekly downloads. As such, dsh-diff-writer popularity was classified as not popular.
We found that dsh-diff-writer demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.
Security News
PHP releases emergency patches for two critical RCE vulnerabilities as agencies urge organizations to take unpatched sites offline.
Threat Research
/Security News
A supply chain attack compromised LiteLLM 1.107.0 on PyPI and Docker, spreading malware that steals cloud credentials, developer secrets, and AI provider keys.