# SSH Manager 发布前检查表

更新时间：2026-04-15

## 发布目标

用于发布可销售版本前的最终检查，覆盖：

- 构建与测试
- 核心功能回归
- 源码交付说明验证
- 交付包生成
- 销售素材准备

## 一、构建与测试

### 前端

```bash
cd frontend
npm run build
```

### 后端

```bash
cd backend
mvn -Dtest=AuthControllerTest,BatchCommandServiceTest,ConnectionControllerTest test
```

### 脚本语法检查

```bash
bash -n scripts/release/build-local-package.sh
```

## 二、核心功能回归

发布前至少手工走一遍下面流程：

### 登录与基础入口

- 打开 `/login`
- 检查商品化登录首页展示是否正常
- 使用默认账号登录
- 检查首次启动引导是否正常显示

### 工作区

- 创建第一条连接
- 左侧树点击连接，右侧终端 / SFTP 正常刷新
- 打开多个工作区实例
- 关闭当前 / 关闭其他 / 关闭右侧 / 关闭全部
- 重置分屏比例

### 终端

- 打开终端
- 执行基本命令
- 模拟断开后验证自动重连
- 修改终端字体和字号后检查是否生效

### SFTP

- 浏览目录
- 上传文件
- 下载文件
- 删除文件
- 新建目录
- 测试上传同名文件策略

### 批量能力

- 打开批量命令弹窗
- 选择多台机器
- 执行命令并检查结果汇总
- 复制输出内容

### 备份恢复

- 导出备份
- 清空或切换到空环境
- 导入备份
- 检查连接和会话树是否恢复

### 历史与日志

- 打开历史日志弹窗
- 检查传输历史是否保留
- 检查操作日志是否保留
- 检查诊断信息是否可复制

## 三、源码交付与诊断

### 关于与交付信息

- 打开“关于与交付信息”
- 检查版本、环境指纹、交付状态显示
- 复制诊断信息

### 源码交付说明

- README、部署文档、环境变量说明齐全
- 默认账号说明齐全
- Docker 启动方式可跑通
- 诊断摘要可用于售后排查

## 四、交付包生成

### Windows 本地版

```bat
scripts\release\build-local-package.bat
```

检查：

- `release/local-package/` 是否生成
- 是否包含后端 jar
- 是否包含 `start-local.bat`
- 是否包含 `README.txt`

### Windows 本地启动

- 双击 `start-local.bat`
- 检查是否自动生成 `runtime/` 和 `data/`
- 检查是否能访问 `http://localhost:48080`

### Windows 安装版

建议先运行：

```bat
scripts\release\check-windows-release.bat
```

再执行：

```bat
scripts\release\build-windows-installer.bat
```

检查：

- 当前版本是否已在 `backend\pom.xml` 中更新
- 已设置 `SSH_MANAGER_WINDOWS_JRE_DIR`
- `release/windows-app/` 是否生成
- 是否包含 `ssh-manager.jar`
- 是否包含 `jre\bin\javaw.exe`
- 是否包含 `start-installed.vbs`
- 是否包含 `ssh-manager.ico`
- 是否包含 `BUYER-GUIDE.txt`
- 是否包含 `AFTER-SALES-FAQ.txt`
- 如果本机安装了 Inno Setup，`release/windows-installer/` 下是否生成 `SSHManager-Setup-*.exe`

### Windows 安装回归

- 安装 `SSHManager-Setup-*.exe`
- 通过桌面或开始菜单快捷方式启动
- 检查浏览器是否自动打开
- 检查 `%LOCALAPPDATA%\SSHManager\data` 是否生成
- 检查 `%LOCALAPPDATA%\SSHManager\logs\backend.log` 是否生成
- 再次点击快捷方式时，不应重复拉起多个实例
- 检查开始菜单里的“买家使用说明”和“售后排查 FAQ”是否可打开

### Docker 版

- 运行 `scripts/windows/start-docker.bat` 或 `make up`
- 检查容器是否正常启动
- 检查页面是否可访问
- 检查数据卷是否正常持久化

## 五、销售素材准备

### 商品截图

建议至少准备这 7 张：

1. 登录首页
2. `/showcase` 头图
3. Moba 工作区主界面
4. 终端 + SFTP 分屏
5. 批量命令执行结果
6. 历史日志与传输记录
7. 关于与交付信息

### 商品文案

参考文档：

- `docs/xianyu-sales-copy.md`

至少准备：

- 标题
- 前 3 行卖点
- 详情页正文
- 常见问答

## 六、发货前最终确认

- JWT 与加密密钥生成方式已确认
- 默认账号说明已写清楚
- 交付包里没有私钥、token、测试数据或敏感配置
- 你自己完整演练过一次“买家购买后流程”

## 七、买家购买后流程

建议你自己按这个顺序演练一次：

1. 生成本地版交付包
2. 打包源码、部署文档和环境变量模板
3. 启动本地版或 Docker 版
4. 登录默认账号
5. 修改密码
6. 创建连接
7. 打开终端和 SFTP
8. 导出一次备份

## 发布结论

只有在下面 4 条都满足时，才建议上架：

- 构建通过
- 核心功能回归通过
- 源码交付说明验证通过
- 交付包和商品素材都已准备完成