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

## 目的

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

```text
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，不会直接发布。

## 最新发布包

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

SHA256：

```text
46299832fb78e8cc196f85cf1928f34eea4deee82dbc83b67883394f0359036b
```

## 推荐使用方式

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

```cmd
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

```cmd
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

```cmd
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`。