UnisKB/scripts/README_release_review.md

2.2 KiB
Raw Permalink Blame History

本地发布清单与回滚材料

这两个脚本只用于准备和检查,不提供上传、远程回滚、迁移或重启命令。

在 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。