docs: 收口 apply-patch 权限保留任务

2026-07-16 17:34:41 +02:00
parent e49b2e0386
commit 3c2b8e8738
3 changed files with 37 additions and 0 deletions
@@ -51,6 +51,7 @@ trans gh:/owner/repo/issue/<number> cat
 - `apply-patch` 检测到交互 TTY 且没有 stdin 时立即返回 `apply-patch-stdin-required` 和 quoted heredoc 示例，不等待 60 秒超时。
 - Host/WSL 与 Windows route 的 `apply-patch` 优先走 fs adapter bulk update path；不要为了规避旧的 `read-b64-block` / `write-b64-argv` 慢路径改用临时脚本写文件。
 - `apply-patch v2` 字节与完整性边界：
+  - POSIX host/workspace 更新已有文件时必须保留原 mode，包括可执行位；新建文件继续服从目标端 umask，不按扩展名猜测权限。
  - localized replacement 必须保留纯 CRLF 和 `legacy-single-byte` 文件的原始字节风格。
  - legacy 文件只允许可保持的单字节 replacement。
  - original/final integrity mismatch 会重新只读采集当前文件并输出 adapter、stage、expected/current bytes、SHA-256、newline 和 encoding 摘要。