技能新增步骤20：交付树仓库双存档（zip+同名解压内容），更新登记字段与推送后双重验证规范

references/delivery-contract.md

@@ -29,7 +29,7 @@
            → [此后才允许改代码] 品牌/界面/AI/标识规范(6-11)
            → 产品构建启动(15) → 健康验证(16)
            → 产品界面截图 + 全功能录屏(17)
-           → README/版本归档(18) → 交付核查(19)
+           → README/版本归档(18) → 交付核查(19) → 交付树双存档(20，授权推送时)
 ```
 
 - 内部基线截图必须是代码零改动状态下的真实画面，仅用于内部核对，任何情况下不进入交付物。
@@ -106,6 +106,24 @@ docs/screenshots/         # README 引用的全部配图，相对路径完整，
 4. 包内不出现内部工具、执行过程、外部项目线索及版本对比信息，命名使用甲方可读的中性名称。
 5. 交付清单列出每项交付物的包内路径/链接、默认账号、验收记录与售后说明。
 
+### 4.2 交付树仓库双存档（授权推送时，强制）
+
+用户明确授权推送到交付树仓库（默认 `https://code.xinmi.cloud/depei/panel-delivery-tree`）时，必须做到：
+
+1. **压缩包 + 解压内容双存档**：`交付包/<key>-delivery-<YYYYMMDD>.zip` 与同名解压目录
+   `交付包/<key>-delivery-<YYYYMMDD>/`（README、`docs/screenshots/`、`截图/界面截图/`、`录屏/*.mp4`、`文档/`）同时入库；
+   前者用于整包下载，后者用于在 Gitea 网页直接浏览，内容必须与 zip 一致。
+2. 真实源码以 git submodule 挂到 `项目源码/<key>` 并固定到交付提交；登记 Git 主地址、上游来源、分支与锁定 commit。
+3. 录屏等被全局 `.gitignore` 忽略的二进制，须在 `交付包/**` 下显式取反放行（`!交付包/**/*.mp4` 等），
+   并用 `git check-ignore -v` 确认实际命中取反规则；`交付包模板/` 仍不入库二进制。
+4. 机器与人工登记一致：sidecar JSON 与 `registry.json` 记录 `package`、字节数、`sha256`、
+   `git`、`deploy`、`extractedDir`、`extractedFileCount`、`extractedSizeBytes/MB`、`archiveForm`；
+   `交付登记.md`、`交付包/README.md`、根 `README.md` 同步链接 zip 与解压目录。文件数、体积、SHA256 必须实测，禁止照抄。
+5. 推送后双重验证：`git rev-parse HEAD` 与 `git ls-remote origin refs/heads/main` 一致；
+   用 Gitea Contents API 分段编码中文路径（保留 `/`）确认解压目录与录屏 mp4 已在远程。
+6. 含中文路径的批量复制/删除优先用 Python `shutil`，避免 PowerShell 管道中文乱码与删除策略拦截。
+7. 未获推送授权时不推送任何仓库，只在项目内 `.Codex/delivery` 本地留档，沿用“不推送代码”约束。
+
 ## 5. 验收标准（7 条，全部达标方可验收）
 
 1. **运行**：正常启动、稳定运行；所有功能可正常操作，无报错、失效、页面错乱或接口异常。