CipherTalk/scripts

📦 发布说明

触发方式

当前仓库不再使用本地 npm run tuisong 发布。

正式发布方式改为：

1. 修改 package.json 中的版本号
2. 提交代码并推送到 main
3. 推送一个与版本号完全一致的 Git tag，例如：

git tag v2.2.14
git push origin v2.2.14

只有推送 v* 标签时，GitHub Actions 才会自动构建和发布。

GitHub Actions 会做什么

.github/workflows/release.yml 会在 v* 标签触发后执行：

1. 安装依赖
2. 重新编译原生模块
3. 执行 npm run build
4. 生成 release/force-update.json
5. 创建/更新 GitHub Release
6. 上传以下文件到 GitHub Release：
   • 安装包
   • latest.yml
   • force-update.json
   • 若存在则上传 .blockmap
7. 将以下文件同步到 Cloudflare R2：
   • 安装包
   • latest.yml
   • force-update.json

版本要求

标签名必须与 package.json.version 完全对应：

• package.json.version = 2.2.14
• Git tag 必须是 v2.2.14

如果不一致，工作流会直接失败。

强制更新策略

工作流会调用：

npm run build:force-update-manifest

默认情况下不会触发强制更新。只有在仓库 Variables / Secrets 中提供以下值时，生成的 force-update.json 才会带上对应策略：

• FORCE_UPDATE_MIN_VERSION
• FORCE_UPDATE_BLOCKED_VERSIONS
• FORCE_UPDATE_TITLE
• FORCE_UPDATE_MESSAGE
• FORCE_UPDATE_RELEASE_NOTES

Secrets / Variables

Cloudflare R2 Secrets

需要在 GitHub 仓库配置以下 Secrets：

• R2_ACCOUNT_ID
• R2_BUCKET_NAME
• R2_ACCESS_KEY_ID
• R2_SECRET_ACCESS_KEY

可选强制更新 Variables / Secrets

可以按需配置：

• FORCE_UPDATE_MIN_VERSION
• FORCE_UPDATE_BLOCKED_VERSIONS
• FORCE_UPDATE_TITLE
• FORCE_UPDATE_MESSAGE
• FORCE_UPDATE_RELEASE_NOTES

不配置时，force-update.json 仍会生成，但只包含当前版本信息，不会强制用户升级。

当前更新源角色

• GitHub Release：主更新源，负责安装包与 latest.yml
• Cloudflare R2：镜像下载源 + 策略补充源
• force-update.json：GitHub 优先，R2 回退