Files
order-notification-automation/docs/system-updates.md
T

27 lines
2.1 KiB
Markdown

# 版本发布与更新检查
当前版本来自 `package.json.version`,工作台侧栏与扩展健康接口使用同一个来源。
登录后自动检查一次,用户可在菜单底部手动检查。检查只读访问本仓库 Gitea 的 `GET /api/v1/repos/Skyworth_Digital_Hardware/order-notification-automation/releases/latest`;浏览器通过已登录的同源 `GET /api/update` 读取结果,不直接访问远端,不传递工作台账号、Cookie 或业务数据。
| 结果 | 界面显示 |
| --- | --- |
| 远端没有发行版本(404) | 暂无可用发行版本 |
| 最新稳定版本高于当前版本 | 更新标记、发行日期、说明及发行页面入口 |
| 当前版本等于或高于远端版本 | 已是最新版本 |
| 网络、超时、响应格式错误 | 暂时无法检查更新;当前版本仍可见 |
检查总超时为 5 秒,读取响应最多 256 KiB,不跟随重定向。版本按 SemVer 比较,支持 `v` 前缀与 build metadata,跳过草稿和预发行版。发行说明按纯文本显示,链接只允许本仓库的 HTTPS 发行页面。没有安装器、自动下载、源码覆盖或服务重启行为。
## 发布步骤
1. 在准备发行的提交中同步更新 `package.json` 与 `package-lock.json` 根包版本,例如 `0.2.0`。
2. 执行 `npm ci`、`npm test` 与 `npm run test:full`,检查结果后合并对应变更。
3. 给确切的发行提交创建一致的版本标签,例如 `v0.2.0`,推送标签。
4. 在 Gitea 基于该标签发布正式 Release,填写变更说明、更新与备份要求;仅推送标签不会触发提示,草稿或预发行版也不会作为稳定更新。
5. 部署管理员按说明备份本地状态、停服、更新发行源码和依赖、重新启动并核对版本及健康状态。
远端仓库目前公开可读。若以后改为私有仓库,应另行设计服务端只读认证;本功能不读取 Git 凭据,也不要求前端填写 token。私有仓库返回 404 时与“未发行”无法区分。
本次功能提交不创建首个 Release;首发版本应对应经过确认的发行提交。