@zhengyizhao/deploy-helper 0.1.0 → 0.2.1

package/PUBLISHING.md

@@ -0,0 +1,86 @@
+# 发布流程
+
+## 1. 版本号
+
+`package.json` 和 `src/index.js` 中的版本号保持一致：
+
+```bash
+# package.json
+"version": "x.y.z"
+
+# src/index.js
+console.log(chalk.cyan.bold('\n🚀 deploy-helper') + chalk.gray(' vx.y.z ...'))
+```
+
+版本规则（语义化版本）：
+- `patch`（0.2.**1**）：bugfix
+- `minor`（0.**3**.0）：新功能，向下兼容
+- `major`（**1**.0.0）：破坏性变更
+
+## 2. 发布前检查
+
+```bash
+# 语法检查
+node --check src/utils/ssh.js
+node --check src/utils/setup.js
+node --check src/utils/config.js
+node --check src/utils/detect.js
+node --check src/commands/init.js
+node --check src/commands/update.js
+node --check src/commands/status.js
+node --check src/commands/rollback.js
+node --check src/commands/backup.js
+node --check src/commands/env.js
+node --check src/index.js
+
+# 加载验证
+node --input-type=module -e "import('./src/index.js').then(()=>{})"
+
+# 预览打包内容（确认无敏感文件）
+npm pack --dry-run
+```
+
+`.npmignore` 已配置排除 `.claude/`、`.git/` 等目录，无需手动处理。
+
+## 3. 提交并推送
+
+```bash
+git add -A
+git commit -m "Bump version to x.y.z"
+git push
+```
+
+## 4. 登录 npm
+
+```bash
+npm login
+# 输入 npmjs.com 用户名、密码
+# 如开启了 2FA，准备好 authenticator OTP
+```
+
+## 5. 发布
+
+```bash
+# 带 OTP（推荐，避免二次提示）
+npm publish --access public --otp=<6位OTP码>
+
+# 不带 OTP（若账号未开启 2FA）
+npm publish --access public
+```
+
+发布成功输出示例：
+```
+npm notice 📦  @zhengyizhao/deploy-helper@0.2.0
+npm notice Publishing to https://registry.npmjs.org/ with tag latest and public access
++ @zhengyizhao/deploy-helper@0.2.0
+```
+
+## 6. 验证
+
+```bash
+# 查看 npm 上的最新版本
+npm view @zhengyizhao/deploy-helper version
+
+# 用 npx 测试（加 --yes 跳过确认）
+npx --yes @zhengyizhao/deploy-helper@latest --version
+```

package/README.md

@@ -1,73 +1,349 @@
-# 🚀 deploy-helper
+# deploy-helper
 
-> 把项目部署到服务器，就这么简单。
+> Deploy your project to any VPS by answering a few questions.
 
-不需要懂 Nginx、PM2、Certbot——回答几个问题，剩下的交给它。
+No need to know Nginx, PM2, Certbot, or supervisor — deploy-helper handles server configuration, process management, HTTPS certificates, and code updates for you.
+
+[中文文档](#中文文档)
+
+---
+
+## Quick Start
+
+```bash
+npx @zhengyizhao/deploy-helper init
+```
+
+Or install globally:
+
+```bash
+npm install -g @zhengyizhao/deploy-helper
+deploy-helper init
+```
+
+---
+
+## How It Works
+
+**Web service** (5 steps):
+
+```
+[1/5] Server credentials    → Enter IP, SSH key/password, connection tested immediately
+[2/5] Project info          → Auto-detect type, version, start command — confirm each
+[3/5] Domain & HTTPS        → Optional, auto-issue Let's Encrypt certificate
+[4/5] Install server env    → Install dependencies as needed, skip if already installed
+[5/5] Upload & start        → Upload → start process → configure Nginx → health check
+```
+
+**Background script / cron job** (4 steps, skips domain and Nginx):
+
+```
+[1/4] Server credentials
+[2/4] Project info (including run mode selection)
+[3/4] Install server env
+[4/4] Upload & start
+```
+
+After deployment:
+
+```
+🎉 Deployment successful!
+
+  # Web service
+  URL: https://example.com
+
+  # Cron job
+  Schedule:  0 2 * * *
+  Logs:      tail -f /var/log/myapp.log
+
+  # Background script
+  Status:    supervisorctl status myapp
+  Stdout:    tail -f /var/log/myapp.out.log
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `deploy-helper init` | First-time deployment, fully guided |
+| `deploy-helper update` | Push latest code and restart (supports multiple servers) |
+| `deploy-helper status` | View process status, memory usage, recent logs |
+| `deploy-helper rollback` | Roll back to a previous snapshot |
+| `deploy-helper env` | Upload / pull / diff `.env` files |
+| `deploy-helper backup` | Database backup (MySQL / PostgreSQL / MongoDB) |
+| `deploy-helper servers` | Manage multiple servers |
+
+---
+
+## Run Modes
+
+Choose one during `init`. This determines process management and whether Nginx is configured:
+
+| Mode | Use case | Process manager | Nginx |
+|------|----------|----------------|-------|
+| **Web service** | API, website, Next.js | PM2 / supervisor (auto-restart) | ✓ Reverse proxy |
+| **Background script** | Crawler, queue consumer, long-running task | PM2 / supervisor (restart on crash only) | ✗ |
+| **Cron job** | Scheduled sync, periodic cleanup | System crontab | ✗ |
+
+---
+
+## Supported Project Types
+
+### Node.js
+
+Auto-detects: `.nvmrc` / `.node-version` / `package.json engines.node` → Node.js version; `package.json scripts.start` / common entry files → start command.
+
+- Process manager: **PM2** (auto-restart, starts on boot)
+- Works with `npm start`, `node server.js`, `next start`, and everything else
+- **Script mode**: PM2 with `--no-autorestart` — won't restart after a clean exit
+- **Cron mode**: writes to crontab, logs to `/var/log/<appname>.log`
+
+### Python
+
+Auto-detects: `.python-version` / `pyproject.toml` → Python version; `requirements.txt` → framework (FastAPI / Django / Flask) → recommended start command; `environment.yml` / `conda-lock.yml` → conda mode.
+
+Process manager: **supervisor** (auto-restart, starts on boot, logs to `/var/log/<appname>.out.log` + `.err.log`)
+
+**pip mode** (has `requirements.txt`)
+- Installs Python automatically if missing (deadsnakes PPA, supports 3.8–3.13), skips if already installed
+- Creates a virtualenv — all packages isolated inside `venv/`, nothing written to the system
+- FastAPI → uvicorn; Django / Flask → gunicorn
+- **Script mode**: supervisor `autorestart=unexpected` — only restarts on crash, not on clean exit
+- **Cron mode**: writes to crontab, runs using the venv Python
+
+**conda mode** (has `environment.yml`)
+- Installs Miniconda to `/opt/miniconda3` automatically, skips if already present
+- Creates the conda environment from `environment.yml` (`conda env create -n <appname>`); on re-deploy, runs `--prune` for incremental updates
+- Start command runs via `conda run -n <appname> --no-capture-output` — no `conda activate` needed
+
+**Generate environment.yml locally**
+
+```bash
+conda activate <your-env-name>
+conda env export > environment.yml
+```
+
+> If your environment includes CUDA / cudatoolkit or other system-level packages, use Docker instead (see below) to avoid GPU driver version mismatches.
+
+### Docker
+
+Works for **everything** deploy-helper doesn't natively support: Java, Go, Rust, C++, CUDA, multi-service orchestration… As long as you have a Dockerfile, the deployment is language-agnostic.
+
+Auto-detects:
+- `Dockerfile` — noted if present, guided if missing
+- `docker-compose.yml` / `docker-compose.yaml` / `compose.yml` / `compose.yaml` — used automatically
+- `EXPOSE` in Dockerfile or `ports` in compose file — reads the host port
+
+Two deploy modes:
+
+| Mode | Condition | Command |
+|------|-----------|---------|
+| Compose mode | compose file detected | `docker compose -f <file> up -d --build --remove-orphans` |
+| Single-container mode | Dockerfile only | `docker build` + `docker run --restart unless-stopped` |
+
+**Docker install**: the tool checks `command -v docker` first and skips installation if Docker is already present. Many cloud provider images ship with Docker pre-installed.
+
+**.env files**: not uploaded by default (may contain secrets). If a local `.env` is detected, you'll be asked whether to upload it; if you decline, the tool shows the server path where you can create it manually.
+
+### Static Sites
+
+Plain HTML / CSS / JS, served directly by Nginx. Gzip and SPA fallback routing are configured automatically. Build output in `dist/` is uploaded normally (not skipped).
 
 ---
 
-## 为什么有这个工具？
+## Other Languages
 
-你写完了一个项目，想放到服务器上让别人访问。但你卡在了这些问题上：
+> Java, C++, Go, Rust, CUDA, R…
 
-- 服务器买好了，然后呢？
-- Nginx 怎么配？
-- HTTPS 证书怎么申请？
-- 代码更新了怎么同步到服务器？
-- 服务挂了怎么知道？
+Recommended path: write a Dockerfile to package your runtime environment, then choose the Docker type. deploy-helper doesn't need to know your language — it just runs the container. When you select `Other`, the tool prints these starter templates:
+
+**Python + conda / CUDA**
+```dockerfile
+FROM continuumio/miniconda3
+WORKDIR /app
+COPY environment.yml .
+RUN conda env create -f environment.yml -n myenv
+COPY . .
+CMD ["conda", "run", "-n", "myenv", "--no-capture-output", "python", "main.py"]
+```
+
+**Java (Maven + JDK 21)**
+```dockerfile
+FROM maven:3.9-eclipse-temurin-21-alpine AS build
+WORKDIR /app
+COPY pom.xml .
+RUN mvn dependency:resolve -q
+COPY src ./src
+RUN mvn package -DskipTests -q
+FROM eclipse-temurin:21-jre-alpine
+COPY --from=build /app/target/*.jar app.jar
+EXPOSE 8080
+CMD ["java", "-jar", "app.jar"]
+```
+
+**Go**
+```dockerfile
+FROM golang:1.22-alpine AS build
+WORKDIR /app
+COPY go.mod go.sum ./
+RUN go mod download
+COPY . .
+RUN go build -o main .
+FROM alpine:latest
+COPY --from=build /app/main .
+EXPOSE 8080
+CMD ["./main"]
+```
+
+Dockerfile reference: https://docs.docker.com/get-started/
+
+---
+
+## update
+
+```bash
+deploy-helper update
+```
 
-`deploy-helper` 就是来解决这些的。
+- Creates a code snapshot before deploying — rollback is always available
+- Reuses init's startup logic: appMode / conda / composeFile all respected
+- Health check after restart (PM2 online / supervisor RUNNING / container running)
+- Multi-server support: parallel, serial, or rolling strategies
+
+---
+
+## rollback
+
+```bash
+deploy-helper rollback
+```
+
+Every `update` creates a snapshot automatically (last 5 kept). Rolling back:
+
+1. Backs up the current version first (so you can undo the rollback)
+2. Stops the service
+3. Restores code via rsync (preserves `venv/` / `node_modules/`, only replaces code)
+4. Restarts the service + health check
+
+---
+
+## env
+
+```bash
+deploy-helper env
+```
+
+- **Push**: local `.env` → server (backs up the old one first, sets permissions to 600, restarts service)
+- **Pull**: server `.env` → local
+- **Diff**: shows key-level differences (added / missing / changed values)
+
+---
+
+## backup
+
+```bash
+deploy-helper backup
+```
+
+Supports MySQL, PostgreSQL, and MongoDB:
+
+- Immediate backup (dump + gzip)
+- List / download previous backups (last 10 kept)
+- Scheduled automatic backups (crontab)
+
+**Security**: database credentials for scheduled backups are stored in `/etc/deploy-helper/<appname>.creds` (chmod 600, owned by root). The backup script itself is chmod 700 — passwords are never exposed in world-readable locations.
+
+---
+
+## Requirements
+
+**Local machine**
+- Node.js 18+
+
+**Server**
+- Ubuntu 20.04 / 22.04 / 24.04
+- Root access or sudo
+- Ports open: 22 (SSH), 80 (HTTP), 443 (HTTPS if needed)
+
+**Nothing needs to be pre-installed on the server** — Nginx, Node.js, Python, Docker, PM2, supervisor, and certbot are all installed on demand, and skipped if already present.
+
+---
+
+## Config File
+
+After the first deployment, `.deploy-config.json` is written to your project root. It stores the server address, deploy path, start command, and more. The tool automatically adds it to `.gitignore` — it may contain passwords or keys and should never be committed.
+
+---
+
+## License
+
+MIT
+
+---
+
+# 中文文档
+
+> 把项目部署到任意 VPS，回答几个问题就够了。
+
+不需要懂 Nginx、PM2、Certbot、supervisor——工具替你搞定服务器配置、进程管理、HTTPS 证书、代码更新。
+
+[English Documentation](#deploy-helper)
 
 ---
 
 ## 快速开始
 
 ```bash
-npx deploy-helper
+npx @zhengyizhao/deploy-helper init
 ```
 
-第一次运行会引导你完成全套配置，大约 5 分钟搞定：
+或全局安装后使用：
 
+```bash
+npm install -g @zhengyizhao/deploy-helper
+deploy-helper init
 ```
-🚀 deploy-helper — 把项目部署到服务器，就这么简单
 
-[1/5] 服务器连接信息
-? 服务器 IP 地址：123.456.78.9
-? SSH 端口：22
-? 登录用户名：root
-? 登录方式：SSH 密钥（推荐）
-? SSH 密钥路径：~/.ssh/id_rsa
-  ✓ 服务器连接成功！
+---
 
-[2/5] 项目信息
-  ℹ 自动检测到项目类型：Node.js 应用
-? 应用名称：my-app
-? 部署路径：/var/www/my-app
-? 启动命令：node index.js
-? 端口：3000
+## 工作流程
 
-[3/5] 域名 & HTTPS
-? 是否配置域名？是
-? 你的域名：example.com
-? 自动申请 HTTPS 证书？是
+**Web 服务**（5 步）：
 
-[4/5] 安装服务器环境
-  ✓ 安装 Nginx
-  ✓ 安装 Node.js 20
-  ✓ 安装 PM2
+```
+[1/5] 服务器连接信息      → 输入 IP、SSH 密钥/密码，立即测试连通性
+[2/5] 项目信息            → 自动检测类型、版本、启动命令，逐一确认
+[3/5] 域名 & HTTPS        → 可选，自动申请 Let's Encrypt 免费证书
+[4/5] 安装服务器环境      → 按需安装依赖，已安装的跳过
+[5/5] 上传代码并启动服务  → 上传 → 启动进程 → 配置 Nginx → 健康检查
+```
 
-[5/5] 上传代码并启动服务
-  ✓ 项目文件上传完成
-  ✓ 安装依赖
-  ✓ 启动应用（PM2）
-  ✓ Nginx 配置完成
-  ✓ HTTPS 证书申请成功
+**后台脚本 / 定时任务**（4 步，跳过域名和 Nginx）：
 
+```
+[1/4] 服务器连接信息
+[2/4] 项目信息（含运行方式选择）
+[3/4] 安装服务器环境
+[4/4] 上传代码并启动
+```
+
+完成后：
+
+```
 🎉 部署成功！
 
+  # Web 服务
   访问地址：https://example.com
-  更新代码 → deploy-helper update
-  查看状态 → deploy-helper status
+
+  # 定时任务
+  定时计划：0 2 * * *
+  日志查看：tail -f /var/log/myapp.log
+
+  # 后台脚本
+  进程状态：supervisorctl status myapp
+  输出日志：tail -f /var/log/myapp.out.log
 ```
 
 ---
@@ -76,42 +352,213 @@ npx deploy-helper
 
 | 命令 | 说明 |
 |------|------|
-| `deploy-helper` 或 `deploy-helper init` | 首次部署，全程引导 |
-| `deploy-helper update` | 把最新代码推送到服务器并重启 |
-| `deploy-helper status` | 查看服务运行状态、内存、最近日志 |
+| `deploy-helper init` | 首次部署，全程引导 |
+| `deploy-helper update` | 推送最新代码并重启（支持多服务器） |
+| `deploy-helper status` | 查看进程状态、内存、最近日志 |
+| `deploy-helper rollback` | 从历史快照中选择一个版本回滚 |
+| `deploy-helper env` | 上传 / 拉取 / 对比 .env 文件 |
+| `deploy-helper backup` | 数据库备份（MySQL / PostgreSQL / MongoDB） |
+| `deploy-helper servers` | 管理多台服务器 |
+
+---
+
+## 应用运行方式
+
+init 时选择三种模式之一，影响进程管理和是否配置 Nginx：
+
+| 模式 | 适用场景 | 进程管理 | Nginx |
+|------|---------|---------|-------|
+| **Web 服务** | API、网站、Next.js | PM2 / supervisor（自动重启） | ✓ 反向代理 |
+| **后台脚本** | 爬虫、消息消费、长任务 | PM2 / supervisor（崩溃才重启） | ✗ |
+| **定时任务** | 数据同步、定期清理 | 系统 crontab | ✗ |
 
 ---
 
 ## 支持的项目类型
 
-| 类型 | 进程管理 | 说明 |
-|------|---------|------|
-| Node.js | PM2 | Express、Koa、Next.js 等 |
-| Python | Supervisor | Flask、FastAPI、Django 等 |
-| Docker | docker compose | 任意容器化应用 |
-| 静态网站 | Nginx | 纯 HTML/CSS/JS |
+### Node.js
+
+自动检测：`.nvmrc` / `.node-version` / `package.json engines.node` → Node.js 版本；`package.json scripts.start` / 常见入口文件 → 启动命令。
+
+- 进程管理：**PM2**（自动重启、开机自启）
+- 支持 `npm start`、`node server.js`、`next start` 等所有启动方式
+- **后台脚本模式**：PM2 加 `--no-autorestart`，进程正常退出后不重启
+- **定时任务模式**：写入 crontab，日志写入 `/var/log/<appname>.log`
+
+### Python
+
+自动检测：`.python-version` / `pyproject.toml` → Python 版本；`requirements.txt` → 框架（FastAPI / Django / Flask）→ 推荐启动命令；`environment.yml` / `conda-lock.yml` → conda 模式。
+
+进程管理：**supervisor**（自动重启、开机自启、日志写入 `/var/log/<appname>.out.log` + `.err.log`）
+
+**pip 模式**（有 `requirements.txt`）
+- 服务器无 Python 时自动安装（deadsnakes PPA，支持 3.8–3.13），已有则跳过
+- 自动创建 virtualenv，所有包装在 `venv/` 内，不污染系统环境
+- FastAPI → uvicorn；Django / Flask → gunicorn
+- **后台脚本模式**：supervisor `autorestart=unexpected`（只有崩溃才重启，正常退出不重启）
+- **定时任务模式**：写入 crontab，用 venv 内的 Python 执行
+
+**conda 模式**（有 `environment.yml`）
+- 服务器自动安装 Miniconda 到 `/opt/miniconda3`，已有则跳过
+- 从 `environment.yml` 创建 conda 环境（`conda env create -n <appname>`），二次部署时 `--prune` 增量更新
+- 启动命令通过 `conda run -n <appname> --no-capture-output` 执行，无需 `conda activate`
+
+**本地生成 environment.yml**
+
+```bash
+conda activate <你的环境名>
+conda env export > environment.yml
+```
+
+> 如果环境包含 CUDA / cudatoolkit 等系统级包，建议改用 Docker 方案（见下文），避免服务器 GPU 驱动版本不一致。
+
+### Docker
+
+适合**所有** deploy-helper 原生不支持的场景：Java、Go、Rust、C++、CUDA、conda 环境、多服务编排……只要你有 Dockerfile，部署流程就与语言无关。
+
+自动检测：
+- `Dockerfile` — 存在则提示，不存在时给出引导
+- `docker-compose.yml` / `docker-compose.yaml` / `compose.yml` / `compose.yaml` — 自动选用
+- Dockerfile `EXPOSE` 或 compose `ports` — 读取宿主机端口
+
+两种部署模式：
+
+| 模式 | 条件 | 命令 |
+|------|------|------|
+| Compose 模式 | 检测到 compose 文件 | `docker compose -f <file> up -d --build --remove-orphans` |
+| 单容器模式 | 仅有 Dockerfile | `docker build` + `docker run --restart unless-stopped` |
+
+**Docker 是否需要安装**：工具先检查服务器是否已有 Docker（`command -v docker`），已有则跳过安装步骤。许多云服务商镜像预装了 Docker，无需重复安装。
+
+**.env 文件**：默认不上传（含敏感信息）。检测到本地 `.env` 时会询问是否上传；选择不上传时，工具会告知在服务器手动创建的路径。
+
+### 静态网站
+
+纯 HTML / CSS / JS，直接由 Nginx 托管，自动配置 gzip 和 SPA 回退路由。`dist/` 等构建产物会正常上传（不会被跳过）。
 
 ---
 
-## 前提条件
+## 对于不在列表里的语言
+
+> Java、C++、Go、Rust、CUDA、R……
 
-- **本地**：Node.js 18+
-- **服务器**：Ubuntu 20.04 / 22.04 / 24.04（root 或 sudo 权限）
+推荐路线：写 Dockerfile 把运行环境封装进镜像，然后选 Docker 类型。deploy-helper 不需要了解你的语言细节，只负责把容器跑起来。选择 `其他` 类型时，工具会在终端直接展示以下模板：
+
+**Python + conda / CUDA**
+```dockerfile
+FROM continuumio/miniconda3
+WORKDIR /app
+COPY environment.yml .
+RUN conda env create -f environment.yml -n myenv
+COPY . .
+CMD ["conda", "run", "-n", "myenv", "--no-capture-output", "python", "main.py"]
+```
+
+**Java（Maven + JDK 21）**
+```dockerfile
+FROM maven:3.9-eclipse-temurin-21-alpine AS build
+WORKDIR /app
+COPY pom.xml .
+RUN mvn dependency:resolve -q
+COPY src ./src
+RUN mvn package -DskipTests -q
+FROM eclipse-temurin:21-jre-alpine
+COPY --from=build /app/target/*.jar app.jar
+EXPOSE 8080
+CMD ["java", "-jar", "app.jar"]
+```
+
+**Go**
+```dockerfile
+FROM golang:1.22-alpine AS build
+WORKDIR /app
+COPY go.mod go.sum ./
+RUN go mod download
+COPY . .
+RUN go build -o main .
+FROM alpine:latest
+COPY --from=build /app/main .
+EXPOSE 8080
+CMD ["./main"]
+```
+
+Dockerfile 入门：https://docs.docker.com/get-started/
 
 ---
 
-## 安装（全局）
+## update — 代码更新
 
 ```bash
-npm install -g deploy-helper
-deploy-helper init
+deploy-helper update
+```
+
+- 部署前自动创建代码快照，失败可立即 rollback
+- 复用 init 的启动逻辑，appMode / conda / composeFile 全部生效
+- 重启后健康检查（PM2 online / supervisor RUNNING / 容器 running）
+- 支持多台服务器：并行 / 串行 / 滚动三种策略
+
+---
+
+## rollback — 版本回滚
+
+```bash
+deploy-helper rollback
 ```
 
+每次 `update` 前自动创建快照，保留最近 5 个版本。回滚时：
+
+1. 备份当前版本（以便反悔）
+2. 停止服务
+3. 用 rsync 还原代码（保留 `venv/` / `node_modules/`，只换代码）
+4. 重启服务 + 健康检查
+
+---
+
+## env — 环境变量管理
+
+```bash
+deploy-helper env
+```
+
+- **上传**：本地 `.env` → 服务器（先备份旧 `.env`，权限自动设为 600，上传后重启服务）
+- **拉取**：服务器 `.env` → 本地
+- **对比**：显示本地和服务器的 key 差异（新增 / 缺失 / 值不同）
+
+---
+
+## backup — 数据库备份
+
+```bash
+deploy-helper backup
+```
+
+支持 MySQL / PostgreSQL / MongoDB，功能：
+
+- 立即备份（导出 + gzip 压缩）
+- 查看 / 下载历史备份（保留最近 10 个）
+- 配置定时自动备份（写入 crontab）
+
+**安全设计**：定时脚本的数据库密码存放在 `/etc/deploy-helper/<appname>.creds`（chmod 600，root 所有），脚本本身 chmod 700，不在可读位置明文暴露密码。
+
+---
+
+## 前提条件
+
+**本地**
+- Node.js 18+
+
+**服务器**
+- Ubuntu 20.04 / 22.04 / 24.04
+- root 权限或可 sudo
+- 开放 22（SSH）、80（HTTP）、443（HTTPS，如需 HTTPS）端口
+
+**不需要**提前在服务器安装任何东西——Nginx、Node.js、Python、Docker、PM2、supervisor、certbot，工具按需安装，已装的跳过。
+
 ---
 
 ## 配置文件
 
-首次部署后，项目根目录会生成 `.deploy-config.json`，记录所有配置。建议加入 `.gitignore`（其中包含服务器密码字段）。
+首次部署后，项目根目录生成 `.deploy-config.json`，记录服务器地址、部署路径、启动命令等。工具会自动将其加入 `.gitignore`（文件中含服务器密码 / 密钥，请勿提交到 git）。
 
 ---