新增NAS一键打包部署脚本及Docker部署方案

docs/plans/2026-03-13-deploy-to-nas-backend-implementation.md

@@ -0,0 +1,69 @@
+# 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: 通过