diff --git a/docs/maintenance/README.md b/docs/maintenance/README.md index 199e350..b6a2d3b 100644 --- a/docs/maintenance/README.md +++ b/docs/maintenance/README.md @@ -15,6 +15,7 @@ | 文件 | 用途 | | --- | --- | +| RESOURCE_CLIENT_DOWNLOADS.md | DPL客户端下载接入resource、固定链接、Git迁移与验收/回退 | | ARCHITECTURE.md | 服务入口、前后端边界、配置来源、开发与检查 | | BUSINESS_RULES.md | 邮件、提醒、账号与支付等不可随意改变的约束 | | DEPLOYMENT.md | Git 发布、备份、运行依赖、恢复及故障排查 | diff --git a/scripts/dpl-resource-downloads/README.md b/docs/maintenance/RESOURCE_CLIENT_DOWNLOADS.md similarity index 53% rename from scripts/dpl-resource-downloads/README.md rename to docs/maintenance/RESOURCE_CLIENT_DOWNLOADS.md index 3c2eb7e..c0fa2c3 100644 --- a/scripts/dpl-resource-downloads/README.md +++ b/docs/maintenance/RESOURCE_CLIENT_DOWNLOADS.md @@ -8,17 +8,17 @@ Windows默认Clash Verge Rev x64，macOS保留Apple/Intel选择，Android默认F ## 执行 -本目录脚本是DPL专用配置迁移，不通过更新XB公共分支实施。先以Git把本任务脚本发布到目标服务器隔离工具目录，记录确切提交；经登记白色机在site-jp02执行： +`scripts/dpl-resource-downloads/migrate.py`是DPL专用配置迁移，不通过更新XB公共分支实施。先以Git把本任务脚本发布到目标服务器隔离工具目录，记录确切提交；经登记白色机在site-jp02执行： ```sh -python3 migrate.py plan -python3 migrate.py apply +python3 scripts/dpl-resource-downloads/migrate.py plan +python3 scripts/dpl-resource-downloads/migrate.py apply ``` 脚本只允许已登记DPL本地根和生产根；修改前对所有用到的resource安装包核对当前目录、大小、完整SHA256和真实HTTPS Range206字节。保留全部其他env字段及教程并行修改；发现目标文案不符或并发文件变化就停止。更改保留文件权限和属主，原文件备份至root-only `/root/codex-backups/dpl/resource-downloads-时间/`，回退指令： ```sh -python3 migrate.py rollback --backup /root/codex-backups/dpl/本次实际备份目录 +python3 scripts/dpl-resource-downloads/migrate.py rollback --backup /root/codex-backups/dpl/本次实际备份目录 ``` 回退前检查部署后摘要，避免覆盖后续修改；有冲突须人工合并。重复执行无变化时不重复写入。 @@ -30,3 +30,13 @@ python3 migrate.py rollback --backup /root/codex-backups/dpl/本次实际备份 部署后经白色机在服务器请求DPL实际HTTPS的env、下载选择页及四份教程，验证返回内容与目标地址及对应架构；只下载resource的Range片段，校验完整哈希在服务器本地进行。未打开线上浏览器时明确报告“已完成服务器侧验收，未做线上页面验收”。选择页保持简单原生HTML及锚点，实际下载不经过DPL PHP代理。 本地源配置/教程、线上运行配置、工具Git发布、真实HTTP结果分别记录；不能因脚本已提交就认定DPL已经切换。 + +## 2026-10-28 已实施状态 + +DPL本地与线上已切换。迁移提交`3f9ad377c49397e7f6b0ab1b15d8b6884ff25634`已推送登记REPO-DPL独立分支`codex/dpl-resource-downloads-20261028`，以生产`7e8fbf6`为基线，仅包含DPL专用迁移脚本和说明；未合入XB公共分支。服务器隔离Git工作树为`/opt/dpl-resource-downloads-20261028`，DPL业务代码HEAD保持`7e8fbf6`，通过该明确Git版本的脚本只改本实例运行配置及教程。 + +生产备份及无秘密验收收据：`/root/codex-backups/dpl/resource-downloads-20261028T101137Z/manifest.json`与`acceptance.json`。改动为storage/public两份env、两份静态选择页及四份教程，共8个文件；保留此前教程并行改动。两份env均与备份比较，确认仅windows、macos、macos_arm64、macos_x64、android、linux六字段变化。 + +真实核对10个安装包完整SHA256、大小与HTTPS Range206/首32字节；DPL公开HTTPS的env配置、10链接选择页、四份教程共6项检查通过。resource当时提供Clash Verge Rev v2.5.8与FlClash v0.9.2；版本是当次快照，固定链接由既有采集器更新。iOS与路由器入口未改，未新增认证、API密钥、调度器或目录请求。已完成服务器侧验收，未做线上页面验收。 + +本地使用现有dpl.loc，选择页返回200，10个唯一resource链接检查通过，env JS语法及六字段以外配置不变检查通过。本地迁移备份在本次聊天work/local-downloads-backup与work/local-public-downloads-backup，dev配置另存修改前副本；生产恢复不依赖这些本机文件。