# 本地发布清单与回滚材料 这两个脚本只用于准备和检查,不提供上传、远程回滚、迁移或重启命令。 在 `D:\WorkProjects\zywlw` 的 PowerShell 中运行: ```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,不能把生成清单视为允许发布。后续功能完成后,应更新范围说明并重新构建、核对和验收。 本地安全测试: ```powershell & .\maxkb\.venv\Scripts\python.exe .\maxkb\scripts\test_release_review.py -v ``` 本次实际结果位于 `outputs/release-review-20261026`。