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

SKILL.md

@@ -29,7 +29,7 @@ description: 自动化克隆、初始化、品牌化、Docker 部署并提交项
    源码包与演示交付包应分开管理。
 7. 本规则约束对外呈现口径，不替代、不免除任何第三方许可证或法律规定的合规义务。
 
-## 20 步工作流
+## 21 步工作流
 
 | 步骤 | 名称 | 必做/跳过 | 要求 |
 |---:|---|---|---|
@@ -53,8 +53,10 @@ description: 自动化克隆、初始化、品牌化、Docker 部署并提交项
 | 17 | 产品截图与全功能录屏 | 必做 | 在最终健康版本上重新采集全套高清界面截图和录屏；逐张核对 README 引用；监控页必须验证真实视频帧、时间轴增长和画面能量，禁止空画面/旧图复用 |
 | 18 | 标准化 README 与版本归档 | 必做 | 按当前产品口径编写 README；不主动出现来源/致谢/版本对比；按授权决定是否提交 |
 | 19 | 交付物核查 | 必做 | 运行交付物阻断式核查，7 项交付物齐备并生成交付 manifest |
+| 20 | 上传交付树双存档 | 授权推送时必做 | 克隆交付树仓库，**同时上传交付 zip 与同名解压目录**（README/截图/录屏/文档），放行 mp4、更新 registry/sidecar/交付登记/README，推送后比对 HEAD 并用 Gitea API 验证解压内容已在远程 |
 
 非 Docker 项目跳过步骤 5、12–14，其余步骤仍有效；步骤 3–4 产物仅内部留存，不对外交付。
+步骤 20 仅在用户**明确授权推送**到交付树仓库时执行；未授权时只在本地 `.Codex/delivery` 产出交付包，沿用“不推送代码”约束。
 
 ## 素材采集时序（内部核对 + 对外素材）
 
@@ -255,6 +257,62 @@ python scripts/deliverables_check.py \
 退出码为 0 才算交付物齐备。
 禁止伪造截图/录屏/网盘链接，禁止把 README 写成与实际不符的宣传稿。
 
+### 上传交付树双存档（步骤 20）
+
+交付核查通过后，把交付物归档到统一的**交付树仓库**（默认 `https://code.xinmi.cloud/depei/panel-delivery-tree`，分支 `main`）。
+该仓库既是标准目录树模板，也是交付登记中心；真实源码以 git submodule 挂在 `项目源码/<key>` 并固定到交付提交。
+
+**强制双存档**：除了正式交付 zip，必须同时上传该 zip 的**同名解压目录**，做到「压缩包 + 解压内容」并存——
+zip 便于整包下载交付，解压目录（README、截图、录屏 mp4、文档）便于在 Gitea 网页直接浏览与增量检索，不必下载解压。
+
+操作流程：
+
+1. 克隆/更新交付树仓库（浅克隆即可），确认 `git status` 干净且与 `origin/main` 同步；若尚未挂源码子模块，
+   用 `git submodule add -b main <源码仓库git> 项目源码/<key>`，再 `git -C 项目源码/<key> checkout <交付提交>` 固定版本。
+2. 复制 zip 到 `交付包/<key>-delivery-<YYYYMMDD>.zip`；再把 zip 的解压目录**保持包内根结构**整体复制到
+   `交付包/<key>-delivery-<YYYYMMDD>/`（`README.md`、`docs/screenshots/`、`截图/界面截图/`、`录屏/*.mp4`、`文档/` 等）。
+   - 含中文路径的递归复制/删除优先用 Python `shutil`（PowerShell 管道处理中文文件名易乱码，删除操作也可能被安全策略拦截）。
+3. 在 `.gitignore` 放行交付目录下被全局忽略的二进制（录屏等），`交付包模板/` 仍保持排除：
+
+   ```gitignore
+   *.mp4
+   *.ts
+   *.m3u8
+   *.zip
+   !交付包/
+   !交付包/**/
+   !交付包/**/*.zip
+   !交付包/**/*.mp4
+   ```
+
+   复制后执行 `git check-ignore -v "交付包/<d>/录屏/x.mp4"`，确认命中的是 `!交付包/**/*.mp4` 取反规则（即已不再被忽略）。
+4. 更新登记引用，人类可读与机器可读都要改，且数值与实际一致：
+   - sidecar `交付包/<key>-delivery-<YYYYMMDD>.json` 与根 `registry.json`：在该交付项补充/核对
+     `package`、`packageSizeBytes`、`packageSizeMB`、`sha256`、`git`（primary/web/upstream/submodulePath/pinnedCommit/branch）、
+     `deploy`、`manifest`，以及 **`extractedDir`、`extractedFileCount`、`extractedSizeBytes`、`extractedSizeMB`、`archiveForm`**；
+   - `交付登记.md`：登记总表增加「解压内容」列，项目小节同时链接 zip 与解压目录；「新增交付项目时」流程写明双存档为必需步骤；
+   - `交付包/README.md` 与根 `README.md`：说明「压缩包 + 同名解压目录双存档」，给出解压内容结构树与 mp4 放行说明。
+5. 数据必须实测：解压文件数/字节数用脚本统计，MB 保留两位；SHA256 用
+   `Get-FileHash <zip> -Algorithm SHA256` 现算，禁止照抄历史值。
+6. `git add -A` 后核对 `git status`：解压目录内 png/md/mp4 为新增、登记文件为修改；
+   两个 JSON 用 `python -m json.tool` 校验合法。
+7. 用具体中文业务信息写提交说明（不出现“工作流”），例如
+   `交付包补充解压内容双存档：README/截图x12/录屏/文档，更新登记与.gitignore放行mp4`，然后 `git push origin main`。
+8. 推送后**双重验证**：
+   - `git rev-parse HEAD` 与 `git ls-remote origin refs/heads/main` 必须完全一致；
+   - 用 Gitea Contents API 列目录，确认解压内容（尤其录屏 mp4）已在远程。中文路径必须**逐段 URL 编码并保留斜杠**，
+     不能对整段路径 `EscapeDataString`（会把 `/` 编成 `%2F`，导致 404）：
+
+   ```powershell
+   function EscPath($p){ ($p -split '/' | ForEach-Object { [uri]::EscapeDataString($_) }) -join '/' }
+   $h = @{ Authorization = 'Basic ' + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes('<user>:<token或密码>')) }
+   $u = "https://<host>/api/v1/repos/<owner>/<repo>/contents/$(EscPath '交付包/<d>/录屏')?ref=main"
+   Invoke-RestMethod -Uri $u -Headers $h
+   ```
+
+> 授权前提：向交付树/源码仓库推送必须有用户明确授权；未授权项目沿用“不推送代码”，只在本地产出交付包。
+> 双存档会让仓库同时保存 zip 与解压目录内的 mp4（体积约为二者之和），这是换取在线可浏览性的预期取舍。
+
 ## 状态管理
 
 状态统一放在目标项目的 `.Codex` 目录：
@@ -322,4 +380,5 @@ python scripts/workflow_manager.py report <project_dir>
 - 标准化 README 覆盖全部必备内容，以当前产品口径编写，图文结合、架构图准确、部署教程可落地，且不作虚假权属表述。
 - 7 项交付物齐备，`.Codex/delivery/manifest.md` 完整；`deliverables_check.py` 退出码为 0。
 - 保密与知识产权要求已遵守：成果不私用/不外传，交付材料与验收记录可溯源。
+- 经授权推送时，交付物已双存档到交付树：zip 与同名解压目录（README/截图/录屏/文档）均已推送，`registry.json`、sidecar、交付登记与各 README 中的 `extractedDir`、文件数、体积、SHA256、Git 地址与锁定提交一致，本地与远程 HEAD 相同，且 Gitea API 能列出解压目录中的录屏文件。
 - 最终 Git 提交信息描述具体业务变化，不出现“工作流”。