# 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: 写失败测试**

```python
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: 写失败测试**

```python
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: 通过
