---
paths:
  - "**/*"
---

## Git 提交消息规范

AI 在生成 commit 消息时必须遵循以下格式。

### 格式

```
<类型>(<范围>): <描述>

[可选的详细说明]

[可选的脚注]
```

### 类型（Type）

| 类型 | 说明 |
|------|------|
| feat | 新功能（feature） |
| fix | 修复 bug |
| docs | 文档更新 |
| style | 代码格式（不影响功能的变动） |
| refactor | 代码重构（既非新功能也非 bug 修复） |
| test | 添加或修改测试 |
| chore | 构建系统或辅助工具的变动 |
| perf | 性能优化 |

### 范围（Scope）

描述提交影响的功能模块或组件（可选）。

### 描述（Description）

- 简明扼要描述变动内容
- 首字母小写
- 不超过 100 个字符
- 使用祈使句（如 "add" 而非 "added"）

### 详细说明（Body）

- 提供更多上下文和详细说明（可选）
- 每行不超过 72 个字符
- 说明"做了什么"和"为什么"

### 脚注（Footer）

- 破坏性变动说明（如 `BREAKING CHANGE: ...`）
- 关闭的 Issue（如 `Closes #123`）

### 示例

**新功能：**

```
feat(api): 添加用户登录端点

- 实现 JWT 认证逻辑
- 添加登录表单前端组件
- 更新用户服务处理登录请求

Closes #45
```

**Bug 修复：**

```
fix(router): 修复路径匹配大小写问题

路径匹配在某些情况下区分大小写导致无法正确路由到处理器。
```

**文档更新：**

```
docs: 更新 README 中的安装说明
```

**重构：**

```
refactor(handler): 简化响应处理逻辑

将文件响应和内联响应的处理逻辑分离到独立函数中。
```
