ccdi/docs/reports/implementation/2026-03-23-deploy-to-nas-sh-implementation.md

Deploy To NAS Shell 入口实施记录

本次改动

• 新增 deploy/deploy-to-nas.sh，提供适用于当前 Unix 环境的 NAS 部署入口。
• 保留原有默认参数：host、port、username、password、remoteRoot。
• 保持与原 BAT 一致的位置参数协议，并继续支持 --dry-run 快速校验。
• 在 Shell 入口内完成本地环境检查、后端打包、前端打包、部署目录组装、paramiko 依赖检查与远端部署调用。
• 复用现有 deploy/remote-deploy.py，不改动 NAS 端上传与 Docker Compose 执行逻辑。
• 新增 tests/deploy/test_deploy_to_nas.py，覆盖默认参数和覆盖参数两类 dry-run 行为。

变更文件

• deploy/deploy-to-nas.sh
• tests/deploy/test_deploy_to_nas.py

验证结果

• python3 -m pytest tests/deploy/test_deploy_to_nas.py -q
• bash -n deploy/deploy-to-nas.sh
• bash deploy/deploy-to-nas.sh --dry-run

说明

• 当前环境未预装 paramiko，脚本会在真实部署前自动执行 python3 -m pip install --user paramiko。
• 本次未执行真实 NAS 部署，只完成了脚本级与 dry-run 级验证，避免在未明确要求下直接触发线上构建上传。