修复:Windows 离线启动误校验 Python 可再生缓存,提供原地修复工具
This commit is contained in:
@@ -16,6 +16,14 @@ Linux 默认只允许本机访问,使用 `./start.sh --lan` 开启内网监听
|
||||
|
||||
不能在服务运行时移动安装目录。迁移业务数据应使用逻辑备份与对应版本的恢复流程,不得直接将 macOS 的 MySQL 数据目录复制到其他系统。
|
||||
|
||||
## 旧 Windows 包的 Python 缓存校验修复
|
||||
|
||||
若启动提示 `文件缺失或校验失败:runtimes/python/Lib/__pycache__/...pyc`,原因是旧包把运行时可能重建的字节码缓存纳入了固定文件校验。Python 本身已随包提供。
|
||||
|
||||
将维护人员生成的 `修复缓存校验并启动.cmd` 放在原 `QualityCenter` 根目录,与“一键部署启动.cmd”并列,普通双击运行即可。该文件使用原包 Python 的标准库,不联网、不要求管理员权限,也不需要重新解压完整包。它先校验缓存对应的全部源码,再清除缓存及其清单记录;原清单备份在 `.runtime/cache-repair-backups/`,其他校验项、程序版本、更新序号和运行时指纹均保留。业务数据库、迁移文件和私有配置不改动。完成后继续原启动流程,后续可使用原入口。
|
||||
|
||||
维护人员可运行 `python3 deploy/offline/repair_windows_cache.py --write-command /path/to/修复缓存校验并启动.cmd` 生成单文件修复工具。后续构建会在生成清单前移除可再生缓存,Windows 入口同时设置 `PYTHONDONTWRITEBYTECODE=1`。
|
||||
|
||||
## Windows 增量更新包(维护人员)
|
||||
|
||||
离线签名工具读取 Windows x64 部署包的 `manifest.json`,只打包 `update_manager.program_path` 认可的完整程序清单,并使用包内运行环境和 wheel 信息计算运行时指纹。私有配置、业务数据、迁移文件、启动引导和密钥不会进入更新包。普通发布的序号必须大于部署包当前的 `updateSequence`。首次通道种子可显式加 `--allow-baseline`,但版本和序号必须分别与 `updateVersion`、`updateSequence` 完全相同;低序号始终拒绝。私钥必须是与包内更新公钥匹配的 Ed25519 PEM 文件,并保存在部署包及产物目录之外。
|
||||
|
||||
Reference in New Issue
Block a user