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

2.1 KiB
Raw Blame History

版本发布与更新检查

当前版本来自 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;首发版本应对应经过确认的发行提交。