string.patch 库模块帮助文档

预览与原子性

调用要点

所有块对同一份修改前原文匹配，不是按顺序修改后再匹配。
SEARCH 必须非空、大小写与空白一致、唯一且不重叠；失败不返回可误用的部分结果。
匹配视图统一 LF，但只回写最小变更区间，不统一整份文件的换行。
原文确实包含标记行时，使用 string.editor.process 的 replace，不猜测标记含义。

有界返回

previewMaxBytes 默认 1024，0 禁止文本回显，最大 4096。预算是预览/诊断文本的合计 UTF-8 字节数，不含固定有界的 JSON 字段名、行号等元数据。最多 4 个 hunk、6 个定位；远距离改动之间的全文不会回传。

preview.textBytes 为实际展示文本字节数；omittedChanges / omittedBytes / truncated 仅描述展示省略，不表示少改了文件。diagnostics.approximate 只表示建议检查的候选位置，绝不参与写入。

此库只处理字符串；文件工具另行处理 BOM、备份、语法检查和暂存提交。

string.patch 成员列表 #

Autos 精确文本补丁。所有块针对同一原文匹配，拒绝歧义与重叠；保留未修改部分的原始字节与混合换行。

string.patch.apply(text,patchText,options) #

应用原子补丁，返回 newText,null,info 或 null,err,info。
options.previewMaxBytes：展示文本合计硬上限，默认 1024，范围 0..4096，0 关闭文本回显。元数据另有限量。
成功 info：count、changedCount、changed、originalBytes、resultBytes、locations（最多6）、preview（最多4处）。
失败 info：code、blockIndex、hint 及有界诊断；绝不模糊替换。

string.patch.parse(patchText) #

解析独占一行的 SEARCH/REPLACE 标记，允许一层外围 Markdown 围栏。
成功返回 [{search;replace},...]；失败返回 null,err,info，绝不忽略不完整块。

string.patch.version #

实现版本

Markdown 格式