228 lines
4.6 KiB
Markdown
228 lines
4.6 KiB
Markdown
# 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 条都满足时，才建议上架：
|
||
|
||
- 构建通过
|
||
- 核心功能回归通过
|
||
- 源码交付说明验证通过
|
||
- 交付包和商品素材都已准备完成
|