表情符号

Dish AI Commit Gen 提供表情符号功能，使您的提交消息更加生动直观，帮助团队成员一目了然地识别提交类型。

功能介绍

表情符号功能会自动在提交消息的类型前添加相应的表情符号，使提交历史更加直观。每种提交类型都有特定的表情符号，反映其性质和目的。该功能与所有支持的 AI 提供商无缝集成，包括 OpenAI、VSCode 内置 AI、智谱 AI、Gemini AI 等，无论使用哪种 AI 服务，都能保持一致的表情符号风格。

配合分层提交功能使用时，表情符号会同时应用于全局摘要和每个文件的详细变更描述，使整个提交消息体系更加清晰有序。

启用表情符号

表情符号功能默认开启。您可以通过以下配置选项启用或禁用：

{
  "dish-ai-commit.features.commitFormat.enableEmoji": true // 设置为 false 可禁用
}

表情符号映射

每种提交类型都有对应的表情符号：

提交类型	表情符号	完整示例	使用场景
feat	✨	✨ feat: 添加用户注册功能	添加新功能
fix	🐛	🐛 fix: 修复登录验证问题	修复 bug
docs	📝	📝 docs: 更新 API 文档	文档更新
style	💄	💄 style: 优化按钮样式	代码样式/UI 外观调整
refactor	♻️	♻️ refactor: 重构数据处理逻辑	代码重构
perf	⚡️	⚡️ perf: 优化查询性能	性能优化
test	✅	✅ test: 添加单元测试	测试相关更改
build	📦	📦 build: 更新构建配置	构建系统或外部依赖项更改
ci	👷	👷 ci: 配置 CI 工作流	CI 配置文件和脚本的更改
chore	🔧	🔧 chore: 更新依赖版本	其他不修改源代码的更改
revert	⏪	⏪ revert: 回滚到上一版本	回滚之前的提交

使用表情符号的好处

提高可读性

表情符号能够使提交历史一目了然。例如，看到 🐛 就立即知道是修复问题的提交，看到 ✨ 则表示新功能。

增强信息传递

表情符号是跨语言的视觉元素，无论团队成员使用哪种语言，都能快速理解提交的性质。

提升团队氛围

适当的表情符号可以为开发过程增添一些乐趣，减轻工作压力，促进积极的团队氛围。

最佳实践

合理搭配类型和表情符号

确保使用正确的提交类型，AI 会自动添加相应的表情符号。例如，不要在修复 bug 时使用 feat 类型。

在提交历史中的应用

表情符号在 Git 历史查看工具中非常有效：

git log --oneline

输出示例：

a1b2c3d ✨ feat: 添加用户注册功能
e5f6g7h 🐛 fix: 修复登录验证问题
i8j9k0l 📝 docs: 更新 API 文档

与其他工具集成

表情符号兼容大多数 Git 工具和平台，如 GitHub、GitLab、Bitbucket 等，使团队协作更加直观。

自定义表情符号

目前，表情符号与提交类型的映射是预设的，未来版本可能支持自定义映射。如果您有特定需求，可以通过以下方法实现自定义：

1. 禁用内置表情符号功能：

{
  "dish-ai-commit.features.commitFormat.enableEmoji": false
}

2. 使用自定义系统提示词来实现：

{
  "dish-ai-commit.base.systemPrompt": "生成提交消息时，请使用以下自定义表情符号映射：feat → 🚀, fix → 🔧, docs → 📚, 其他类型保持不变。"
}

常见问题

表情符号在某些终端显示不正确

如果您的终端无法正确显示某些表情符号，可能是因为字体或编码问题。解决方法：

1. 使用支持 Unicode 表情符号的现代终端
2. 安装支持表情符号的字体，如 "Noto Color Emoji"
3. 确保终端使用 UTF-8 编码

表情符号与公司提交规范冲突

如果您的组织有严格的提交消息格式要求，不允许使用表情符号，可以禁用此功能：

{
  "dish-ai-commit.features.commitFormat.enableEmoji": false
}

是否影响语义化版本控制

表情符号仅是视觉增强，不会影响基于 Conventional Commits 的语义化版本控制工具。工具会忽略表情符号，仍然能够正确解析提交类型。