feat: prepare sellable source delivery edition

2026-04-16 23:28:26 +08:00
parent f606d20000
commit 37dc4d8216
93 changed files with 7649 additions and 3096 deletions
--- a/docs/release-checklist.md
+++ b/docs/release-checklist.md
@@ -0,0 +1,227 @@
+# 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 条都满足时，才建议上架：
+
+- 构建通过
+- 核心功能回归通过
+- 源码交付说明验证通过
+- 交付包和商品素材都已准备完成