AI Code Ratio Tracker
实时统计 AI 生成代码与手动编写代码的比例。
使用说明
查看统计
侧边栏面板：
- 点击左侧活动栏的插件图标
- 查看每个项目的 AI/手动代码占比
- 显示 Git 仓库信息和进度条
底部状态栏：
AI: 156, Mu: 45, 总计: 201, AI占比: 78% [项目名]
清空统计
清空单个项目：
清空所有统计：
- 按
Cmd+Shift+P / Ctrl+Shift+P
- 输入
AI Code Tracker: 清空统计数据
Git 提交统计
每次 git commit 时，自动在提交信息末尾追加统计：
feat: add user authentication
---
📊 AI Code Ratio Tracker
🤖 AI 生成: 120 行 ( 85%)
✍️ 手动编写: 21 行 ( 15%)
📝 合计: 141 行
AI 占比: [█████████████████░░░] 85%
如需关闭此功能，在设置中搜索 git.appendStatsToCommit 并设为 false。
统计规则
| 场景 |
是否统计 |
| 打开已有文件 |
❌ 不统计 |
| 在编辑器中输入代码 |
✅ 统计 |
| AI 生成代码 |
✅ 统计 |
| 复制粘贴代码 |
✅ 统计 |
| 编译产物（.class, .jar 等） |
❌ 不统计 |
配置选项
在 VS Code 设置中搜索 AI Code Ratio Tracker：
基础配置
| 配置项 |
默认值 |
说明 |
git.appendStatsToCommit |
true |
提交时自动追加统计 |
analyzer.gapMsThreshold |
400 |
编辑间隔阈值（毫秒） |
monitor.excludePatterns |
node_modules, dist, out, .git, build, target, .vscode, .idea |
排除监控的目录（glob 模式） |
排除规则说明：
- 支持 glob 模式，如
**/node_modules/**
- 自动排除编译产物（.class, .jar, .pyc, .o, .exe 等）
- 自动排除媒体文件（图片、视频、音频）
- 自动排除压缩文件和文档
API 上报配置（可选）
| 配置项 |
默认值 |
说明 |
api.enabled |
true |
启用统计数据上报 |
api.endpoint |
http://localhost:8080/api/code-stats |
API 端点地址（默认为本机 ai-code-ratio-tracker-api） |
api.token |
"" |
API 认证令牌 |
api.anonymousMode |
true |
匿名模式 |
注意：
- 如果 API 端点返回 404 错误，请联系管理员获取正确的接口地址
- 如不需要上报功能，可将
api.enabled 设为 false
- 上报数据包含：提交 hash、项目名、Git 地址、提交人、AI/手动代码行数
常见问题
Q: 统计数据不准确？
A: 使用 AI Code Tracker: 清空统计数据 命令重新开始统计。
Q: 手动输入被判为 AI？
A: 在设置中增大 analyzer.gapMsThreshold 的值（如 600）。
Q: Git 提交信息没有追加统计？
A: 确保 git.appendStatsToCommit 配置为 true，且项目根目录有 .git 文件夹。
Q: API 上报返回 404 错误？
A: 检查以下几点：
- 确认
api.endpoint 配置的接口地址是否正确
- 联系管理员确认服务端接口是否已部署
- 如不需要上报功能，将
api.enabled 设为 false
- 查看调试控制台（
Cmd+Shift+Y）获取详细错误信息
数据存储
统计数据每分钟自动保存到项目根目录的 .ai-code-tracker.json 文件。
建议添加到 .gitignore：
echo ".ai-code-tracker.json" >> .gitignore
许可证
MIT
