Git RC OKR - 代码统计分析插件
一个功能强大的 VSCode 扩展,用于分析 Git 仓库的代码贡献度、技术债务、重构建议和代码热点图。
功能特性
1. 贡献度分析
统计和评估团队成员的代码贡献质量:
- 提交次数、代码行数统计
- 提交频率和活跃度分析
- 代码质量评分系统(0-100分)
- 生成详细的个人/团队贡献度报告
- 支持多维度指标评估
2. 技术债务追踪
智能识别项目中的潜在技术债务:
- 检测高频修改文件(代码流失风险)
- 识别高复杂度文件,提供拆分建议
- 发现大型文件(超过阈值需要拆分)
- 追踪不稳定的代码模块
- 按严重程度四级分类(严重/高/中/低)
- 提供量化的技术指标和改进建议
3. 代码热点图
可视化展示代码修改频率分布:
- 热度评分系统(0-100分)
- 交互式 HTML 热点图界面
- 按类别智能分组(热点/温热/冷却/冷门)
- 帮助识别需要重点关注的代码区域
4. 完整分析报告
一键生成综合分析文档:
- 整合所有分析模块的结果
- Markdown 格式,易于阅读和分享
- 包含团队总览和详细性能指标
- 支持导出和存档
使用方法
方式一:命令面板
按 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板,输入以下命令:
Git 统计: 贡献度分析 - 分析团队成员代码贡献
Git 统计: 技术债务追踪 - 识别和追踪技术债务
Git 统计: 代码热点图 - 查看代码修改热点图
Git 统计: 生成完整分析报告 - 生成综合分析报告
方式二:侧边栏面板
- 点击 VS Code 左侧活动栏中的 "Git 代码统计" 图标
- 在打开的分析面板中点击对应功能按钮
- 查看生成的分析结果
方式三:右键菜单
在编辑器中右键点击文件,选择 Git 统计: 当前文件重构建议 快速查看当前文件的重构建议。
环境要求
必需条件:
- Visual Studio Code 版本 >= 1.105.0
- 项目目录必须是 Git 仓库
- 系统已安装 Git 并可在命令行中使用
推荐配置:
- Git 版本 >= 2.0
- 项目具有一定的提交历史(建议至少 10 次提交)
应用场景
团队管理
- 量化评估团队成员的代码贡献
- 识别高产出和高质量的开发者
- 为绩效考核提供数据支持
代码审查
- 识别需要重点审查的高风险代码模块
- 发现频繁修改的不稳定区域
- 优化代码审查流程和资源分配
项目优化
- 系统性发现技术债务
- 制定基于数据的重构计划
- 追踪代码质量改进进度
质量提升
- 基于数据驱动的代码质量改进
- 建立代码质量评分标准
- 持续监控项目健康度
OKR 评估
- 量化团队和个人的工作成果
- 生成可视化的绩效报告
- 支持目标达成度追踪
报告示例
贡献度分析报告
## [作者] ruocheng@121
- **提交次数**: 204
- **代码行数**: 128,428 (净增: +59,606)
- **平均提交大小**: 630 行
- **提交频率**: 13.45 次/周
- **影响文件数**: 473
- **代码质量评分**: 82/100 [A级] ★★★★★
- **活跃天数**: 106 天
技术债务报告
## [严重级别] 严重 (11项)
### [文件] src/types/components.d.ts
- **债务类型**: 高频修改
- **健康评分**: 48/100
- **问题描述**:
此文件在过去6个月被修改了 55 次,可能存在设计问题或需求不稳定
文件复杂度评分为 110,建议拆分或重构
稳定性评分为 0/100,经常被修改
- **技术指标**:
1. 修改次数: 55
2. 复杂度: 110
3. 代码行数: 暂无数据
4. 稳定性: 0/100
- **建议措施**:
- 考虑按功能模块拆分文件
- 重新审视类型定义的合理性
- 建立更稳定的接口规范
技术实现
核心技术栈:
- TypeScript - 类型安全的开发语言
- VSCode Extension API - 扩展开发框架
- Git CLI - 版本控制数据采集
- Node.js - 运行时环境
功能模块:
- Git 数据分析引擎
- 代码质量评估算法
- 可视化报告生成器
- Webview 交互界面
贡献指南
欢迎提交 Issue 和 Pull Request!
贡献方式:
- 报告 Bug 或提出功能建议
- 提交代码改进或新功能
- 完善文档和使用示例
- 分享使用经验和最佳实践
许可证
MIT License - 详见 LICENSE 文件
| |