1.9 KiB
Deploy To NAS Backend Implementation Plan
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
Goal: 为现有后端打包与远端部署链路增加一个可被 .bat 入口复用的 DryRun 模式。
Architecture: 保持 deploy.ps1 作为真实执行器不变，仅增加参数解析和轻量分支，让 BAT 可以先走快速验证，再走真实部署。底层上传与远端部署逻辑继续复用现有 Python 脚本。
Tech Stack: PowerShell, Python, Docker Compose, Windows CMD
Task 1: 为 deploy.ps1 增加 DryRun 模式
Files:
- Modify:
deploy/deploy.ps1 - Test:
tests/deploy/test_deploy_to_nas.py
Step 1: 写失败测试
def test_deploy_ps1_dry_run_prints_target():
...
Step 2: 运行测试确认失败
Run: py -3.12 -m pytest tests/deploy/test_deploy_to_nas.py::test_deploy_ps1_dry_run_prints_target -q
Expected: 失败，因为 deploy.ps1 还不支持 -DryRun
Step 3: 最小实现
- 新增
-DryRun开关 - 打印
Host/Port/Username/RemoteRoot - 直接返回成功
Step 4: 重新运行测试
Run: py -3.12 -m pytest tests/deploy/test_deploy_to_nas.py::test_deploy_ps1_dry_run_prints_target -q
Expected: 通过
Task 2: 保持真实部署行为不变
Files:
- Modify:
deploy/deploy.ps1 - Modify:
deploy/remote-deploy.py - Test:
tests/deploy/test_deploy_to_nas.py
Step 1: 写失败测试
def test_deploy_ps1_still_accepts_default_parameters():
...
Step 2: 运行测试确认失败
Run: py -3.12 -m pytest tests/deploy/test_deploy_to_nas.py::test_deploy_ps1_still_accepts_default_parameters -q
Expected: 因缺少对应输出或参数处理失败而不通过
Step 3: 最小实现
- 保持默认 NAS 参数
- 保持真实执行路径不变
Step 4: 运行测试
Run: py -3.12 -m pytest tests/deploy/test_deploy_to_nas.py -q
Expected: 通过