选类型、填范围、写一句摘要,实时按规范校验并自动拼好 footer 的提交信息
- 本地处理
- 分类 开发运维
- 适合 格式化、校验、压缩或检查和代码相关的文本。
# 选一个类型并写好描述,即可生成提交信息
- 描述为必填。
这个工具能做什么
一个免费的约定式提交(Conventional Commits)生成器,边填边按规范拼出 提交信息并实时校验。选一个类型(feat、fix、docs、style、refactor、 perf、test、build、ci、chore、revert),填可选的范围(scope)比如 (api) 或 (auth),写一句小写的简短描述,工具就把头部拼成 type(scope): description。勾选破坏性变更会自动加上 ! 标记和一行 BREAKING CHANGE 脚注。可选的正文写清「为什么」,脚注写 Closes #123 之类关联 issue。实时预览给出可直接粘进 git commit 的文本, 头部、正文、脚注之间留一个空行,正好符合 semantic-release、changelog 生成器这类解析工具的预期。校验会提示描述过长、末尾带句号、首字母大写 这些问题,让提交历史保持干净,自动 changelog 和 semver 升级照常工作。 全部在浏览器里运行,一键复制。100% 本地处理,不上传任何内容。
工具细节
- 输入
- 文件 + 文本
- 页面会根据工具类型展示文本框、数值控件、文件选择或结构化输入。
- 输出
- 即时结果 + 复制 + 预览
- 结果区优先给出可操作结果，支持项会显示复制、下载或可视化预览。
- 隐私
- 浏览器本地处理
- 主工具逻辑未发现外部 API 调用，输入通常留在当前标签页内处理。
- 保存 / 分享
- 可分享链接状态
- 关键设置会进入 URL，复制链接后别人能复现同一组参数。
- 性能预算
- 首屏 JS ≤ 9 KB
- 没有声明 WASM 依赖，适合快速打开和移动端使用。
- 适用场景
- 开发运维 · 程序员
- 分类和职业标签用于推荐相关工具、组织内链，并帮助用户快速判断是否适合当前任务。
怎么用
-
1. 输入
把内容粘贴或拖入工具面板。
-
2. 处理
点击按钮,在浏览器内本地处理,文件不上传。
-
3. 复制 / 下载
一键复制结果或下载到本地。
约定式提交生成器 适合怎么用
适合穿插在写代码、查问题、做 Review、上线前的小任务里。
适合开发场景
- 格式化、校验、压缩或检查和代码相关的文本。
- 把片段整理好再放进文档、工单、提交或交接材料。
- 不切换工具,快速检查一个小 payload。
开发检查项
- 压缩、混淆这类不可逆处理,先对副本操作。
- 除非确认工具本地处理,不要粘贴密钥和敏感片段。
- 转换后的代码上线前,仍要跑自己的测试或 lint。
下一步可以接着做
这些入口会把当前任务接到更完整的工具链里。
真实使用场景
写一条 changelog 工具能读懂的功能提交
你刚加了 passkey 登录,想让 semantic-release 升 minor 版本并把它 归到 Features 下。选 feat,scope 填 auth,描述写 add passkey login support,复制结果: feat(auth): add passkey login support。头部干净落地,工具把 feat 读成 MINOR 升级,这一行会出现在下一份 changelog 里审查者预期的位置。
标好破坏性 API 改动让 semver 升到新的大版本
你要砍掉 v1 的 REST 接口。选 feat,scope 填 api,打开破坏性开关, 在脚注栏写迁移说明。工具生成 feat(api)!: drop v1 endpoints,空一行, 再加 BREAKING CHANGE: use the v2 routes; see the migration guide。 这样发布流水线会自动切一个 MAJOR 版本,并提醒下游使用方。
给团队统一一套提交风格
新同事不确定提交该怎么写。把工具链接发过去,类型下拉就摆在那: 他选 fix,看到 scope 和描述字段,要是把描述首字母写大了或末尾加了 句号,会立刻收到提示。整个团队不用谁去背规范,就收敛到同一种格式。
在脚注里关联你正在关闭的 issue
一个 bug 工单是 #214,你想让 git 和 GitHub 在合并时自动关掉它。 选 fix,描述写 reject empty payloads,脚注填 Closes #214。 输出是 fix(api): reject empty payloads,空一行,再加 Closes #214, 这样 issue 会自动关闭,提交也能追溯回当初提报的那个工单。
常见踩坑
把描述首字母大写或末尾加句号。头部是标题不是句子,要写小写摘要、末尾 不带句号。工具会替你同时提示首字母大写和末尾句号这两处。
漏掉类型后面的冒号和那一个空格。规范要求 type(scope) 前缀后面跟冒号 再跟恰好一个空格。把前缀和正文挤在一起会让所有解析器报错。
只用头部的 ! 标记破坏性变更却跳过脚注。光一个 ! 只是提示;发布工具靠 BREAKING CHANGE 脚注那一行触发大版本升级。用破坏性开关让两处都写好。
隐私说明
这个工具的每一部分都是浏览器标签页里运行的纯 JavaScript。你填的类型、 范围、描述、正文和脚注都在本地拼装和校验,不发往服务器,也不记录。 有一点要知道:表单字段会写进页面 URL,这样分享链接能重新打开同一份 草稿,也就意味着把链接粘到聊天里,对方服务器的访问日志会留下你的提交 文本。涉及敏感信息时,请用复制按钮粘贴文本,而不是分享网址。
常见问题
类似工具组合
做你这行的人, 还会一起用这些。