SuperAPI AI 工具集

desktop-release

部署与运维

查看项目

更新于 10-16 09:54

技能介绍

用途:在 GitHub 上剪切并发布 ryOS 的 Electron 桌面构建。桌面版版本存于 package.json 的 version 字段,与网页版(scripts/generate-build-version.ts、public/version.json)无关,不要混用。相关文件:CI 工作流 .github/workflows/build-electron.yml,构建配置 electron-builder.yml,构建脚本 bun run electron:build:mac 与 bun run electron:build:windows,产物输出到 release/(DMG、ZIP、NSIS、latest-mac.yml、latest.yml)。

触发方式:版本发布(推荐)推送匹配 v* 的标签(如 v1.0.9),会构建 macOS 与 Windows、发布 GitHub release ryOS v1.0.9(标签即版本)并标记为 latest;手动/开发构建用 main 上的 workflow_dispatch,会覆盖 desktop 标签下的资产,适合未签名测试构建,不用于语义化发布。

发布清单:确认 main 干净且最新;更新 package.json 版本(semver);提交并推送到 main;创建并推送标签 v{version}(须与 package.json 一致);确认 Build Electron 工作流已启动;CI 完成后核验 release 资产。标准命令:先改 package.json,再执行 git add package.json、git commit、git push origin main、git tag v1.0.9、git push origin v1.0.9。用 gh run list --workflow=build-electron.yml --limit 3 和 gh run watch 验证 CI。成功后查看 https://github.com/ryokun6/ryos/releases/tag/v1.0.9,预期资产:macOS 的 ryOS_{version}aarch64.dmg、.zip、.zip.blockmap、latest-mac.yml;Windows 的 ryOS{version}_x64.exe、.exe.blockmap、latest.yml。

手动触发(不打新标签):gh workflow run build-electron.yml --ref main,仅用于用户明确要重建桌面通道时;不升版本,产物覆盖到 desktop release。

版本规则:桌面发布只升 package.json 版本;标签名为 v 加该版本;选版本前用 git tag -l 'v1.0.*' 和 gh release list --limit 5 检查已有标签;除用户明确要求重建某版本外,不要重新打已有标签的标记(需先询问是否删除/移动旧标签)。Git 安全:未经用户明确要求,禁止强推 main 或标签;不要随版本升级提交无关文件;不要改写已推送提交。

本地构建(可选,仅用于打标签前验证,mac 需 .env.local 中的签名密钥):bun run electron:build:mac、bun run electron:build:windows;本地构建不会发布到 GitHub,生产发布应走 CI。CI 密钥:macOS 签名构建需要工作流中记录的 GitHub Actions secrets(APPLE_、EVS_);CI 因签名失败时查看日志,不要粘贴密钥值。

当用户要求“触发桌面构建”时:若未说明目标版本,询问并建议基于最新标签的下一个补丁版本;然后改 package.json、提交、推送、打标签、推标签;最后报告 Actions 运行 URL 与预期发布标签。