常见问题
基本问题
Dish AI Commit Gen 是什么？
Dish AI Commit Gen 是一个 VSCode 扩展，使用 AI 技术帮助开发者自动生成标准化的 Git 和 SVN 提交消息。它能分析代码变更，理解修改内容，并生成符合 Conventional Commits 规范的提交消息。
使用这个扩展需要付费吗？
Dish AI Commit Gen 扩展本身是免费的。但是，某些 AI 服务提供商（如 OpenAI）可能需要付费使用。不过，我们也支持多种免费的 AI 服务选项：
- 智谱 AI (GLM-4-Flash) - 提供固定月度免费额度
- Gemini AI - 每天可免费使用约 1500 次请求
- 本地模型 (Ollama) - 完全免费，但需要本地部署
支持哪些版本控制系统？
扩展同时支持 Git 和 SVN 版本控制系统。
AI 模型相关
我担心将我的代码发送到云 AI 服务，有隐私保护吗？
我们理解您的隐私担忧。Dish AI Commit Gen 提供了多种选择：
- 使用本地模型：您可以设置 Ollama 在本地运行 AI 模型，代码数据完全不会离开您的计算机
- 限制发送数据：可以配置仅发送差异统计信息而不是完整代码
- 自定义提示词：可以控制发送给 AI 的提示词内容
我在中国，有推荐的 AI 服务提供商吗？
是的，对于中国用户，我们推荐以下服务：
- 智谱 AI (GLM-4)：提供优秀的中文处理能力，有固定月度免费额度
- 阿里云 DashScope：提供通义千问系列模型，企业级可靠性
- Ollama 本地模型：完全本地运行，不受网络限制
功能问题
为什么我配置了 API Key 但生成失败？
可能有以下原因：
- API Key 格式不正确：检查 API Key 是否完整且正确
- API 访问受限：确认 API Key 有足够的权限和使用额度
- 网络连接问题：确保您的网络可以访问相应的 AI 服务
- 服务提供商配置错误：检查 baseUrl 等配置是否正确
解决方案：
- 在 VS Code 输出面板中查看详细错误信息（查看 "Dish AI Commit" 输出通道）
- 尝试使用其他 AI 提供商
生成的提交消息质量不高怎么办？
提高提交消息质量的方法：
- 使用更强大的模型：如从 GPT-3.5 升级到 GPT-4
- 调整系统提示：通过
dish-ai-commit.base.systemPrompt自定义提示词 - 启用代码分析功能：开启
dish-ai-commit.features.codeAnalysis.simplifyDiff - 尝试不同的 AI 提供商：不同 AI 服务对代码的理解能力不同
如何生成更规范的提交消息？
提交消息规范性提升方法：
- 确保遵循 Conventional Commits：扩展默认遵循此规范
- 指定作用域：在设置中配置项目的作用域列表
- 自定义系统提示：强调您团队的提交消息规范
- 使用提交模板：结合 Git 提交模板使用
错误排查
扩展安装后找不到命令怎么办？
如果安装后找不到 Dish AI Commit 命令：
- 检查扩展是否正确安装：在扩展面板中确认扩展已启用
- 重新加载窗口：使用命令面板执行 "Developer: Reload Window" 命令
- 确认 VS Code 版本兼容：确保您的 VS Code 版本 >= 1.74.0
生成周报时出现错误怎么办？
生成周报错误的常见原因：
- Git 历史获取失败：确保仓库有提交历史且能正常访问
- 时间范围太大：尝试缩小周报的时间范围
- AI 提供商限制：某些 AI 提供商可能限制输入长度，尝试更换提供商
高级配置
如何自定义提交消息生成？
您可以通过以下方式自定义提交消息生成：
- 自定义系统提示：修改
dish-ai-commit.base.systemPrompt - 调整提交格式：配置
dish-ai-commit.features.commitFormat.*选项 - 语言设置：选择 19 种支持语言中的任一种
如何在团队中统一使用此扩展？
团队统一使用的建议：
- 共享配置：使用 VS Code 设置同步或
.vscode/settings.json共享配置 - 配置 AI 服务：使用团队共享的 AI 服务账号
- 制定使用指南：为团队成员提供扩展使用的最佳实践
- 统一提交规范：结合扩展的配置，确保团队遵循相同的提交消息规范