2.2 KiB
2.2 KiB
本地发布清单与回滚材料
这两个脚本只用于准备和检查,不提供上传、远程回滚、迁移或重启命令。
在 D:\WorkProjects\zywlw 的 PowerShell 中运行:
$env:PYTHONIOENCODING = 'utf-8'
$reviewName = 'outputs/release-review-' + (Get-Date -Format 'yyyyMMdd-HHmmss')
& .\maxkb\.venv\Scripts\python.exe .\maxkb\scripts\release_review.py --output $reviewName
& .\maxkb\.venv\Scripts\python.exe .\maxkb\scripts\release_restore_local.py $reviewName
& .\maxkb\.venv\Scripts\python.exe .\maxkb\scripts\release_restore_local.py $reviewName --destination ($reviewName + '/local-rollback-preview')
连接复用项目原有私有连接设置和已固定的 SSH 主机密钥;脚本没有复制或输出凭据。新输出目录必须位于本工作区,不能覆盖已有目录。远程只做指定源文件、静态资源哈希及已知进程入口的读取,不调用 Django、业务接口、数据库或缓存。
输出内容:
| 文件 | 用途 |
|---|---|
| README.md | 本轮差异摘要、发布边界与回滚条件 |
| release-plan.json | 源码、构建、远程资源哈希及将来发布顺序 |
| rollback-plan.json | 旧文件哈希、将来新增文件的处理清单 |
| source.diff / static-entry.diff | 源码及两处入口的文本差异 |
| publish-candidate.zip | 核对时刻的本地候选源文件与构建,未发布 |
| rollback-before.zip | 远程旧源文件、旧入口及入口直接引用的 JS/CSS |
| inspection-status.json | 核对是否完成;失败时保留 incomplete 状态 |
回滚归档不是完整站点或数据库备份。旧 JS 的间接依赖没有全部收录,将来发布必须保留现有静态资源。回滚脚本仅验证归档,或者重建到新的本地目录;不会连接服务器、删除文件或覆盖现有代码。
当前脚本中的待办说明针对本次中断范围:单行操作栏、访问记录分页及五类筛选仍待实现;release_ready 固定为 false,不能把生成清单视为允许发布。后续功能完成后,应更新范围说明并重新构建、核对和验收。
本地安全测试:
& .\maxkb\.venv\Scripts\python.exe .\maxkb\scripts\test_release_review.py -v
本次实际结果位于 outputs/release-review-20261026。