UnisKB/scripts/README_release_review.md

40 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 本地发布清单与回滚材料
这两个脚本只用于准备和检查,不提供上传、远程回滚、迁移或重启命令。
在 `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`。