Git 提交信息指南

格式

每条提交信息必须遵循以下结构：

<类型>(<作用域>): <主题>

[可选正文]

[可选脚注]

类型（必填）

作用域（必填）

作用域必须是该项目中的真实模块名称。
完整列表请参见 references/modules.md。

如果不确定作用域，请检查正在更改的文件路径——顶层目录通常是正确的作用域。

主题（必填）

• - 使用祈使语气：add feature 而非 added feature
• 末尾不加句号
• 总长度不超过72个字符（包括类型和作用域前缀）
• 首字母小写

正文（可选）

• - 解释原因，而非内容（差异对比已显示内容变化）
• 每行不超过72个字符
• 与主题之间用空行分隔

破坏性变更

如果提交引入了破坏性变更，请添加脚注：

BREAKING CHANGE: <变更内容描述及迁移路径>

示例

正确示例：

feat(auth): add JWT token refresh endpoint

Tokens now auto-refresh 5 minutes before expiry.
Previously users had to re-login after token expiration.

fix(parser): handle empty input without crashing

refactor(db): extract connection pooling to separate module

BREAKING CHANGE: DatabaseClient constructor no longer accepts
pool config. Use PoolConfig.create() instead.

错误示例：

updated some stuff ← 缺少类型和作用域，表述模糊
feat: Add new Feature. ← 首字母大写，末尾有句号，缺少作用域
fix(misc): various fixes ← misc 不是真实模块