什么是Universal Release
Universal Release 是一款专为开发者设计的通用发布工作流工具,旨在简化多语言项目的版本管理与发布流程。它能够自动识别多种主流编程语言和框架的项目配置文件,包括 Node.js、Python、Rust 以及 Claude 插件等类型,并支持通用项目结构。该工具通过智能检测机制,自动扫描项目根目录下的版本文件(如 package.json、pyproject.toml、Cargo.toml 或 VERSION 文件),并识别对应的多语言变更日志文件(如 CHANGELOG.md、CHANGELOG.zh.md 等)。其核心优势在于支持多语言变更日志的自动生成与维护,能够根据 Git 提交历史中的约定式提交信息,按语言分类生成格式统一的更新日志,极大提升了国际化项目的协作效率。
核心功能特点
- 自动检测项目类型与版本文件,支持 Node.js、Python、Rust、Claude 插件及通用项目
- 智能识别多语言变更日志文件,支持中英文日等多种语言的独立维护
- 基于约定式提交规范分析变更内容,自动归类功能更新、修复、文档等内容
- 支持破坏性变更检测与版本升级建议,确保语义化版本号正确递增
- 按技能模块分组提交,实现细粒度代码变更追踪与 README 联动更新
- 提供交互式确认流程与 dry-run 预览模式,保障发布过程可控安全
适用场景
Universal Release 特别适用于需要频繁发布且具备多语言支持的开源项目或团队协作开发场景。例如,一个同时面向中文、英文和日语用户的开源工具库,在每次迭代后可通过该工具一键生成各语言版本的详细变更日志,避免人工翻译带来的误差与延迟。对于采用微服务架构或多技能模块划分的复杂项目(如 Claude 插件生态中的多个子技能),该工具能精准定位每个模块的改动,并分别提交,使版本历史清晰可查。此外,当项目使用非标准版本文件路径或需要自定义提交消息格式时,用户还可通过 .releaserc.yml 配置文件进行灵活定制,满足高度个性化的发布需求。无论是个人开发者还是企业级团队,都能借助此工具显著提升版本发布的标准化程度与协作效率。
