热门搜索:
martoc/semver
martoc
用于基于规范提交（conventional commits）计算语义化版本的语义化版本二进制工具
下载次数: 0状态：社区镜像维护者：martoc仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
语义化版本计算工具镜像
概述
该Docker镜像提供了一个语义化版本二进制工具，用于基于规范提交（conventional commits）自动计算语义化版本号。它遵循语义化版本（SemVer）标准，能够根据提交信息中的类型（如feat、fix、breaking change等）自动确定版本号的MAJOR、MINOR或PATCH变更。
核心功能与特性
- 规范提交解析：支持解析符合conventional commits规范的提交信息
- 自动版本计算：根据提交类型自动确定版本变更（MAJOR：不兼容变更，MINOR：新功能，PATCH：修复）
- 语义化版本标准：严格遵循SemVer 2.0.0规范
- 轻量级设计：精简的二进制工具，运行高效，资源占用低
使用场景
- CI/CD流水线中自动生成版本号
- 项目发布流程中自动确定版本标签
- 多模块项目的版本统一管理
- 自动化版本变更日志生成前的版本计算
使用方法
基本用法
通过挂载包含提交历史的目录或文件，运行容器计算版本：
bashdocker run --rm -v $(pwd)/.git:/app/.git semantic-version-tool
配置参数
可通过环境变量自定义行为：
COMMIT_RANGE：指定提交范围（默认：所有提交），格式如HEAD~5..HEADINITIAL_VERSION：初始版本号（默认：0.0.0）PRE_RELEASE：预发布版本标识符（如alpha、beta，可选）BUILD_METADATA：构建元数据（可选，如build.123）
示例
1. 基本计算（默认配置）
bashdocker run --rm -v $(pwd)/.git:/app/.git semantic-version-tool # 输出示例：1.2.3
2. 指定初始版本和预发布标识
bashdocker run --rm -e INITIAL_VERSION=1.0.0 -e PRE_RELEASE=beta -v $(pwd)/.git:/app/.git semantic-version-tool # 输出示例：1.1.0-beta
3. 指定提交范围
bashdocker run --rm -e COMMIT_RANGE=HEAD~3..HEAD -v $(pwd)/.git:/app/.git semantic-version-tool # 输出示例：1.0.1
注意事项
- 确保挂载的.git目录包含完整的提交历史
- 提交信息需符合conventional commits规范（如
feat: add new feature、fix: resolve bug、feat!: breaking change） - 预发布版本和构建元数据仅作为附加信息，不影响版本号的核心变更逻辑
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull martoc/semver:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"