release-bump：升级 ralph-orchestrator 版本发布时使用

eclipse · 2026-02-02 07:32:24 · 20 次点击 · 0 条评论

名称：发布版本更新
描述： 用于在修复提交完毕、准备发布新版本时，更新 ralph-orchestrator 的版本号

版本发布更新

概述

为 ralph-orchestrator 提升版本号并触发发布流程。所有版本信息均位于工作区 Cargo.toml 文件中，各独立 crate 通过 version.workspace = true 继承版本。

请与用户确认新版本号。版本更新提交推送后，请跟踪发布进度。

快速参考

步骤	命令/操作
1. 更新版本号	编辑 `Cargo.toml`：替换所有 `version = "X.Y.Z"`（共 7 处）
2. 构建	`cargo build`（更新 Cargo.lock）
3. 测试	`cargo test`
4. 提交	`git add Cargo.toml Cargo.lock && git commit -m "chore: bump to vX.Y.Z"`
5. 推送	`git push origin main`
6. 打标签	`git tag vX.Y.Z && git push origin vX.Y.Z`

版本号位置（均在 Cargo.toml 中）

# 约第 17 行 - 工作区版本
[workspace.package]
version = "X.Y.Z"

# 约第 113-118 行 - 内部 crate 依赖
ralph-proto = { version = "X.Y.Z", path = "crates/ralph-proto" }
ralph-core = { version = "X.Y.Z", path = "crates/ralph-core" }
ralph-adapters = { version = "X.Y.Z", path = "crates/ralph-adapters" }
ralph-tui = { version = "X.Y.Z", path = "crates/ralph-tui" }
ralph-cli = { version = "X.Y.Z", path = "crates/ralph-cli" }
ralph-bench = { version = "X.Y.Z", path = "crates/ralph-bench" }

提示： 使用编辑工具，将 version = "旧版本" 全部替换为 version = "新版本"，可一次性更新全部 7 处。

CI 自动执行流程

推送标签后，.github/workflows/release.yml 将自动触发并执行以下操作：

创建 GitHub Release，并自动生成发布说明
构建 macOS（arm64、x64）和 Linux（arm64、x64）平台的二进制文件
将构建产物上传至 GitHub Release
按依赖顺序发布至 crates.io
发布至 npm，包名为 @ralph-orchestrator/ralph

常见错误

错误	解决方法
仅更新了 workspace.package.version	必须更新全部 7 处，包括内部依赖
忘记运行测试	提交前务必执行 `cargo test`
手动使用 `gh release create` 创建发布	只需推送标签，CI 会自动创建发布并上传产物
先推送标签再推送主分支	先推送 main 分支，再推送标签

技能包地址：https://github.com/openclaw/skills/tree/main/skills/paulpete/release-bump/SKILL.md

20 次点击 ∙ 0 人收藏

登录后收藏

0 条回复