AI 智能分析

Git Doctor 集成了国产大模型，提供智能化的仓库分析能力。

支持的 AI 提供商

提供商	特点	API 地址
DeepSeek	性价比高，推荐	https://platform.deepseek.com
Kimi	支持超长上下文	https://platform.moonshot.cn

配置 API Key

方式一：命令面板

Git Doctor: 配置 AI API Key

按提示选择提供商并输入 API Key。

方式二：VS Code 设置

{
  "gitDoctor.ai.enabled": true,
  "gitDoctor.ai.provider": "deepseek",
  "gitDoctor.ai.apiKey": "sk-xxx",
  "gitDoctor.ai.model": ""  // 留空使用默认模型
}

方式三：CLI

git-doctor ai --api-key sk-xxx -a analyze

AI 功能列表

1. AI 生成提交消息

自动分析暂存区变更，生成规范的提交消息。

使用方式：

1. 暂存需要提交的文件（git add）
2. 运行 Git Doctor: AI 生成提交消息
3. 预览生成的消息
4. 确认后直接提交

生成示例：

feat(parser): 添加 Tree 对象解析功能

- 实现 parseTreeObject 函数解析目录结构
- 支持递归遍历子目录
- 添加文件权限模式解析

2. AI 生成 CHANGELOG

根据提交历史自动生成版本日志。

使用方式：

Git Doctor: AI 生成 CHANGELOG

输出示例：

## [1.2.0] - 2024-12-08

### 新功能
- 添加代码热点分析功能
- 支持热力图可视化展示

### 修复
- 修复大文件检测阈值问题
- 修复分支名称解析错误

### 优化
- 提升诊断性能 50%
- 优化内存使用

3. AI 诊断助手

交互式问答，解答仓库健康相关问题。

打开方式：

Git Doctor: 打开 AI 诊断助手

示例对话：

用户：这个项目有哪些技术债务？

AI：根据分析，您的项目存在以下技术债务：

1. src/core/parser.ts - TDI 85.3，修改频繁且 Bug 修复率高
2. src/utils/helper.ts - 函数过多，建议拆分
3. 僵尸分支 2 个，建议清理 ...

更多示例问题：

• "哪些文件需要重点重构？"
• "如何改善提交质量？"
• "项目的安全风险有哪些？"
• "建议的优化顺序是什么？"

4. AI 生成优化计划

基于诊断报告生成仓库优化建议。

使用方式：

1. 先运行完整诊断
2. 运行 Git Doctor: AI 生成优化计划

输出示例：

# Git Doctor 优化计划

## 高优先级（本周）
- [ ] 清理 2 个僵尸分支
- [ ] 修复敏感信息泄露风险

## 中优先级（本月）
- [ ] 重构 src/core/parser.ts
- [ ] 建立提交规范检查机制

## 低优先级（季度）
- [ ] 迁移大文件到 Git LFS
- [ ] 优化仓库体积

5. AI 分析热点建议

针对代码热点提供重构建议。

Git Doctor: AI 分析热点建议

6. AI 生成债务治理计划

生成结构化的技术债务治理方案。

Git Doctor: AI 生成债务治理计划

模型选择

DeepSeek 模型

模型	说明
deepseek-chat	默认，通用对话
deepseek-coder	代码专用

Kimi 模型

模型	上下文长度	适用场景
moonshot-v1-8k	8K	短文本分析
moonshot-v1-32k	32K	中等文档
moonshot-v1-128k	128K	超长文档

配置选项

{
  // 启用 AI 功能
  "gitDoctor.ai.enabled": true,

  // AI 提供商
  "gitDoctor.ai.provider": "deepseek",

  // API Key
  "gitDoctor.ai.apiKey": "",

  // 自定义 API 地址（可选）
  "gitDoctor.ai.baseUrl": "",

  // 模型名称（留空使用默认）
  "gitDoctor.ai.model": ""
}

注意事项

数据安全

• AI 分析会将仓库元数据（提交消息、文件名等）发送到 AI 服务
• 不会发送文件实际内容
• 建议在敏感项目中谨慎使用

API 费用

• DeepSeek 和 Kimi 均为按量计费
• 单次分析约消耗 1-5K tokens
• 建议设置 API 配额限制

网络要求

• 需要能访问 AI 服务 API
• 支持流式响应，首字符延迟 < 2s
• 网络不稳定时会自动重试

常见问题

API Key 无效

1. 检查 Key 是否正确复制
2. 确认 Key 是否已激活
3. 检查账户余额是否充足

响应超时

1. 检查网络连接
2. 尝试切换提供商
3. 减少分析范围

生成内容不准确

1. 提供更多上下文（先运行完整诊断）
2. 尝试重新生成
3. 使用更强的模型