ssh-manager/docs/release-checklist.md

SSH Manager 发布前检查表

更新时间：2026-04-15

发布目标

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

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

一、构建与测试

前端

cd frontend
npm run build

后端

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

脚本语法检查

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

二、核心功能回归

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

登录与基础入口

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

工作区

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

终端

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

SFTP

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

批量能力

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

备份恢复

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

历史与日志

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

三、源码交付与诊断

关于与交付信息

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

源码交付说明

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

四、交付包生成

Windows 本地版

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 安装版

建议先运行：

scripts\release\check-windows-release.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 条都满足时，才建议上架：

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