🎉 Code Health Monitor v1.0.0 正式发布！Code Health Monitor v1.0.0 Released!

[yzhucn]

🎉 Code Health Monitor v1.0.0 正式发布！

大家好！

我很高兴地宣布 Code Health Monitor 正式开源发布！这是一个基于 Git 的自动化代码质量与团队效能监控平台。

💡 项目背景

在日常的团队协作开发中，我们经常面临这些问题：

• 🤔 代码质量如何？有哪些潜在风险？
• 📊 团队的开发效能如何量化？
• 🚨 如何及时发现技术债务和不稳定代码？
• 💬 如何让团队成员了解项目的健康状况？

为了解决这些问题，我开发了 Code Health Monitor，它可以：

• 自动分析 Git 提交历史
• 生成每日/周报
• 自动推送到钉钉/飞书
• 提供可视化仪表盘

✨ 核心功能

📈 自动化报告

• 日报：每天早上 8:00 自动生成，涵盖提交统计、代码变更、风险预警、健康评分
• 周报：每周五自动生成，包含效能排行、高风险文件、团队健康度、质量趋势
• 钉钉/飞书推送：自动推送到团队协作平台

🔍 代码质量监控

• 代码震荡检测：识别频繁修改的不稳定文件
• 返工率分析：统计无效工作量，发现需求/设计问题
• 高风险文件识别：综合评估文件的修改频率、复杂度、协作冲突风险
• 提交质量评估：检测大提交、微小提交、提交信息规范性

👥 团队效能分析

• 效能排行：提交量、代码行数、文件修改统计
• 工作时间分析：加班、深夜、周末工作检测
• 协作热力图：识别高频协作关系和潜在冲突
• 技能地图：按技术栈分析团队能力分布

📊 可视化仪表盘

• 支持多时间范围：7天、14天、30天、60天、90天
• 健康评分趋势图
• 代码变更热力图
• HTML 报告查看

🎯 适用场景

• 技术 Leader：实时掌握团队开发效能和代码健康度
• 项目经理：通过数据了解项目进展和风险
• 开发团队：自动化的代码质量反馈
• DevOps 工程师：集成到 CI/CD 流程中

🚀 快速开始

# 克隆项目
git clone https://github.com/yzhucn/code-health.git
cd code-health

# 安装依赖
pip3 install -r requirements.txt

# 配置
cp config.example.yaml config.yaml
vim config.yaml  # 配置你的仓库路径和钉钉webhook

# 生成报告
cd scripts
./run.sh daily   # 生成日报
./run.sh weekly  # 生成周报

详细配置请查看：README.md

🌟 项目特色

1. 轻量级：基于 Git CLI 和 Python，无需安装额外服务
2. 易部署：支持本地运行和 ECS 服务器部署
3. 自动化：配合 Crontab 实现完全自动化
4. 可定制：支持自定义风险阈值、工作时间等
5. 双语文档：完整的中英文文档支持
6. 开箱即用：提供完整的配置示例和使用指南

📚 技术栈

• Python 3.8+
• Bash Shell
• Git
• Markdown
• ECharts
• DingTalk/Feishu API

🤝 如何贡献

我们欢迎任何形式的贡献！

• 🐛 报告 Bug
• 💡 提出新功能建议
• 📝 改进文档
• 🔧 提交代码

详细贡献指南：CONTRIBUTING.md

🗺️ 未来规划

• 支持更多通知渠道（企业微信、Slack）
• 集成代码覆盖率数据
• 集成 SonarQube 质量门禁
• 增加月报功能
• 支持自定义报告模板
• 提供 Docker 部署方案
• 增加实时监控告警

📞 联系方式

• GitHub: https://github.com/yzhucn/code-health
• Issues: https://github.com/yzhucn/code-health/issues
• Discussions: https://github.com/yzhucn/code-health/discussions

📄 许可证

MIT License - 可以自由使用、修改和分发

---

如果这个项目对你有帮助，欢迎 ⭐ Star 支持！

也欢迎分享给你的团队和朋友！🙏

🎉 Code Health Monitor v1.0.0 Released!

Hi everyone!

I'm excited to announce the official open-source release of Code Health Monitor - a Git-based automated code quality and team productivity monitoring platform!

💡 Background

During daily team collaboration, we often face these challenges:

• 🤔 How's our code quality? What are the potential risks?
• 📊 How to quantify team productivity?
• 🚨 How to detect technical debt and unstable code early?
• 💬 How to keep the team informed about project health?

To solve these problems, I created Code Health Monitor, which can:

• Automatically analyze Git commit history
• Generate daily/weekly reports
• Auto-push to DingTalk/Feishu
• Provide visualization dashboards

✨ Key Features

📈 Automated Reporting

• Daily Reports: Auto-generated at 8:00 AM with commit stats, code changes, risk alerts, and health scores
• Weekly Reports: Auto-generated every Friday with productivity rankings, high-risk files, team health, and quality trends
• DingTalk/Feishu Integration: Automatic notifications to collaboration platforms

🔍 Code Quality Monitoring

• Code Churn Detection: Identifies frequently modified unstable files
• Rework Rate Analysis: Tracks wasted effort and reveals requirement/design issues
• High-Risk File Identification: Comprehensive assessment of modification frequency, complexity, and collaboration conflicts
• Commit Quality Evaluation: Detects large commits, tiny commits, and message quality

👥 Team Productivity Analysis

• Productivity Rankings: Commit volume, lines of code, file modification statistics
• Working Hours Analysis: Overtime, late-night, and weekend work detection
• Collaboration Heatmap: Identifies high-frequency collaboration and potential conflicts
• Skill Mapping: Team capability distribution by tech stack

📊 Visualization Dashboard

• Multiple time ranges: 7, 14, 30, 60, 90 days
• Health score trends
• Code change heatmap
• HTML report viewing

🎯 Use Cases

• Tech Leads: Real-time monitoring of team productivity and code health
• Project Managers: Data-driven insights into project progress and risks
• Development Teams: Automated code quality feedback
• DevOps Engineers: Integration into CI/CD pipelines

🚀 Quick Start

# Clone the repository
git clone https://github.com/yzhucn/code-health.git
cd code-health

# Install dependencies
pip3 install -r requirements.txt

# Configure
cp config.example.yaml config.yaml
vim config.yaml  # Configure your repository paths and DingTalk webhook

# Generate reports
cd scripts
./run.sh daily   # Generate daily report
./run.sh weekly  # Generate weekly report

For detailed configuration: README_EN.md

🌟 Project Highlights

1. Lightweight: Based on Git CLI and Python, no additional services required
2. Easy Deployment: Supports both local and ECS server deployment
3. Automated: Fully automated with Crontab
4. Customizable: Configurable risk thresholds, working hours, etc.
5. Bilingual Documentation: Complete Chinese and English documentation
6. Ready to Use: Complete configuration examples and usage guides

📚 Tech Stack

• Python 3.8+
• Bash Shell
• Git
• Markdown
• ECharts
• DingTalk/Feishu API

🤝 Contributing

We welcome all kinds of contributions!

• 🐛 Report bugs
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit code

Contribution guide: CONTRIBUTING_EN.md

🗺️ Roadmap

• Support more notification channels (WeChat Work, Slack)
• Integrate code coverage data
• Integrate SonarQube quality gates
• Add monthly reports
• Support custom report templates
• Provide Docker deployment
• Add real-time monitoring alerts

📞 Contact

• GitHub: https://github.com/yzhucn/code-health
• Issues: https://github.com/yzhucn/code-health/issues
• Discussions: https://github.com/yzhucn/code-health/discussions

📄 License

MIT License - Free to use, modify, and distribute

---

If this project helps you, please ⭐ Star to support!

Feel free to share with your team and friends! 🙏