补丁绑定前后两个完整 Core Wasm 文件的原始 SHA-256，携带每次编辑的旧/新物理区间和精确字节。 它不要求认识所有指令或 custom 格式，也不通过 WAT 重编码文件。
wasm-git patch old.wasm new.wasm --output change.uwgp
wasm-git apply old.wasm change.uwgp --check
wasm-git apply old.wasm change.uwgp --output restored.wasm--check 返回重新计算的完整审计 JSON，不创建输出文件。
--output 必须指定尚不存在的文件；它与 --check 互斥，二者必须选一个。
成功退出码为 0，格式、完整性、输入或输出错误为 1。
未知指令、无效标准 payload、无法识别的 custom 约定及合法的非规范 LEB 都可原样保存和重放，
但前后文件必须使用 Core version 1 的文件头；Component Model 不在补丁范围内。
应用时依次核对：
- 格式、摘要编码、整数范围、编辑排序及两侧区间的非重叠性。
- 每个区间长度与 hex 字节数、未编辑间隙长度，以及尾部间隙长度。
- 完整 base 的长度和摘要，以及每次编辑声明的旧字节。
- 重放时实际产生的新位置、最终长度、Core 文件头和目标摘要。
所有校验成功后才允许发布输出。不会根据补丁宣称的目标长度预分配内存；输出只随实际输入和编辑字节增长。
重新生成的 audit 包括未知内容、解码诊断和当前验证状态，补丁本身不携带可被误信的 feature、
上下文、最小性或验证声明。audit.exact_minimal 属于本次重新比较的结果，不是对传入编辑脚本的证明。
生成器会合并相接的编辑，因此补丁 edit_count 与重新比较的编辑分组数不一定相同。
输出使用同目录独占临时文件，完整写入并同步后，通过不覆盖目标的 hard link 原子发布，再同步父目录。 已有文件、目录及软链都不替换；竞争发布失败会清理本操作的临时文件。 发布后的清理或目录同步错误可能留下完整目标文件，进程中断可能留下独特临时文件；最终路径不暴露部分内容。 不支持 hard link 的文件系统会明确报错，不回退为直接写最终文件。 checkout、bundle 等原有新文件输出也使用相同发布方式。
wasm-git patch main incoming --repo ./history --output change.uwgp
wasm-git apply HEAD change.uwgp --repo ./peer --check
wasm-git apply HEAD change.uwgp --repo ./peer --output restored.wasm
wasm-git commit ./peer restored.wasm -m 'apply reviewed byte patch'patch --repo 在同一锁和已验证快照中解析两侧引用，返回 JSON 的 inputs.old/new.commit
记录实际不可变提交 ID。diff --repo 使用同一批读取方式，HEAD HEAD 不会因两次读取之间的提交而变成不同输入。
inspect --repo 和 apply --repo 也返回实际输入提交 ID。
释放锁后的计算始终使用已复制的字节；后续引用变化不改变本次输入。
--check --repo 仍会短暂创建和删除 .uwgit/write.lock，需要仓库可写且没有其他持锁操作；
不创建输出文件不等于零文件系统写入。
补丁中的摘要属于完整原始文件，与包含类型和长度 envelope 的仓库对象 ID 不同。 相同文件可位于不同提交和仓库；应用只要求 base 字节完全相同。 补丁不携带提交 DAG，也不修改对象和引用；需要双父合并历史时使用合并命令。
文件为 UTF-8 的规范 JSON：固定字段顺序、无空白、无尾部换行。 拒绝重复或未知字段、其他字段顺序、替代转义和尾随内容。 请直接传输生成的文件；格式化显示时应保留原文件用于应用。
字段顺序为：
| 字段 | 编码 |
|---|---|
format |
字符串 uwgit-byte-patch-v1 |
old_sha256, new_sha256 |
原始文件摘要，各 64 个小写十六进制字符 |
old_len, new_len |
u64 字节数，必须可由当前主机表示 |
edits |
按旧/新位置排序的编辑数组 |
每项编辑的字段依次为 old_span、new_span、old_hex、new_hex。
span 字段依次为 u64 start、end，使用半开区间 [start,end)。
hex 为无前缀的小写偶数字符串；插入的 old span/hex 为空，删除的 new span/hex 为空。
空编辑和无变化替换被拒绝；相接的插入/删除可表达为一个替换。
生成器对相同文件生成空编辑数组，并仍校验完整文件摘要。
规范 JSON 只约束字节表示，不保证同一对文件只有一种可接受的编辑脚本；导入脚本仍以完整重放校验为准。
摘要保证内容绑定，不提供作者身份认证；补丁验证成功也不等于模块验证或行为等价成功。