用途:为 uv 项目提供安全、可重复的版本号读取与递增流程,适用于单包项目与工作区(workspace)项目。
主要能力:读取当前版本(uv version、uv version --short、uv version --output-format json);读取工作区成员版本(uv version --package pykeepass-stubs 及其 JSON 形式);递增版本组件,支持 major、minor、patch、alpha、beta、rc、post、dev、stable。语义示例:major 1.2.3→2.0.0,minor 1.2.3→1.3.0,patch 1.2.3→1.2.4,alpha 1.2.3a4→1.2.3a5,beta 1.2.3b4→1.2.3b5,rc 1.2.3rc4→1.2.3rc5,post 1.2.3.post5→1.2.3.post6,dev 1.2.3a4.dev6→1.2.3.dev7,stable 清除 pre/dev/post 回到稳定核心版本,如 1.2.3b4.post5.dev6→1.2.3。
使用方式:核心规则是任何非平凡递增先加 --dry-run 预览;允许多个 --bump 标志且顺序有意义;工作区成员递增用 --package <name>;脚本消费输出时用 --output-format json。通用形式:uv version [--package <workspace-member>] --bump <major|minor|patch|post|dev|alpha|beta|rc|stable> [--bump <...> ...] [--dry-run]。常见模式如主包 uv version --bump major --bump alpha --dry-run 后再执行不带 --dry-run 的命令;工作区包则在命令中加入 --package pykeepass-stubs。
适用场景:需要快速获取当前版本、执行语义化或预发布递增、通过 --package 递增工作区成员、以及仅预览变更时。
限制与发布卫生:递增命令需与仓库发布触发策略保持一致;在拆分发布的仓库中,不要混用主包与 stubs 包的递增;真实递增后需确认工作流与标签期望的是同一规范化版本。资料未提供安装方式、收费与平台信息。