pikasTech-unidesk/.agents/skills/unidesk-trans/references/apply-patch.md

远端文本补丁

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

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 编码写入块绕行。