# 远端文本补丁

- 远端文本修改固定使用 quoted stdin heredoc：

```bash
trans <route> apply-patch <<'PATCH'
*** Begin Patch
*** Update File: path/to/file
@@
-old
+new
*** End Patch
PATCH
```

- 最短路径：
  - 先用 `cat`、`head`、`tail` 或 `rg` 读取足够的当前上下文；
  - 直接把标准 apply-patch envelope 送入 stdin；
  - hunk 保持小且只覆盖当前修改；
  - 上下文不匹配时重读目标块并缩小 hunk。
- 禁止路径：
  - 不先创建临时 patch 文件再用 `< file` 转交；
  - 不使用 download/edit/upload、`sed -i`、远端 Python 或整文件覆盖替代文本 patch；
  - 不因 v2 上下文错误回退 `apply-patch-v1`。
- 输入判定：
  - `apply-patch` 在交互 TTY 且没有 stdin 时立即返回 `apply-patch-stdin-required`；
  - 该错误直接给出 quoted heredoc 示例，不等待 60 秒传输超时；
  - Windows route 继续优先使用 filesystem adapter，不使用 shell 编码写入块绕行。
