Nexus/docs/release/20260708/Nexus-release-python-publisher-20260708.md

Nexus Python 发布辅助脚本（2026-07-08）

目的

为避免 Windows PowerShell 管道、编码和引号问题，新增 Python 发布辅助脚本：

C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\work\nexus_code_context\snapshots\nexus-source-20260707-112042\scripts\publish_release_bundle.py

它使用 subprocess 参数列表调用 scp / ssh，不依赖本地 shell 管道；默认只上传发布包并执行服务器侧 preflight，不会直接发布。

最新发布包

C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\outputs\nexus-release-20260708.tar.gz

SHA256：

46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b

推荐使用方式

1. 只上传并执行 preflight（默认安全模式）

cd /d C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\work\nexus_code_context\snapshots\nexus-source-20260707-112042
.venv-py312-codex\Scripts\python.exe scripts\publish_release_bundle.py ^
  --remote nexus ^
  --tarball C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\outputs\nexus-release-20260708.tar.gz ^
  --sha256 46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b

2. 如果不使用 SSH config

cd /d C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\work\nexus_code_context\snapshots\nexus-source-20260707-112042
.venv-py312-codex\Scripts\python.exe scripts\publish_release_bundle.py ^
  --remote root@你的线上服务器IP ^
  --tarball C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\outputs\nexus-release-20260708.tar.gz ^
  --sha256 46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b ^
  --deploy-path /opt/nexus

3. preflight 确认无误后执行 apply

cd /d C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\work\nexus_code_context\snapshots\nexus-source-20260707-112042
.venv-py312-codex\Scripts\python.exe scripts\publish_release_bundle.py ^
  --remote nexus ^
  --tarball C:\Users\uzuma\Documents\Codex\2026-07-06\yuu\outputs\nexus-release-20260708.tar.gz ^
  --sha256 46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b ^
  --apply

行为说明

脚本会：

1. 本地校验 tarball SHA256；
2. 使用 scp 上传到 /tmp/nexus-release-20260708.tar.gz；
3. 在远端从发布包解出：
   • deploy/preflight-release-host.sh
   • deploy/apply-release-bundle.sh
4. 执行 preflight；
5. 只有传入 --apply 时才执行正式 apply。

已验证

• --help 正常；
• --dry-run --no-upload 正常；
• Windows 下远端路径保持 POSIX /tmp/...，不会被转换成 \tmp\...；
• 已纳入 scripts/run_local_release_gate.py 的 py_compile。

本轮新增测试

• tests/test_publish_release_bundle.py：5 个离线测试，覆盖默认 preflight、显式 apply、SHA mismatch、no-upload dry-run、远端 POSIX 路径。
• 已纳入 scripts/run_local_release_gate.py --with-pytest。