Project 04 · 开发工具

YiyangzaiCQM

基于 Java 字节码增强技术的代码质量监控平台。以一个 Java Agent 探针在类加载阶段对目标类做方法级插桩，在不修改业务源码的前提下采集方法调用、执行耗时与异常抛出等运行期数据；同时结合静态代码分析（圈复杂度、方法规模、异常处理与资源管理规范性），按可配置规则检测违规并计算项目质量得分。

Java Agent Byte Buddy JVM 字节码无侵入探针 McCabe 圈复杂度质量评分 H2

下载发行包 ↓ 源码仓库 GitHub ↗ 查看实时数据导出质量报告 ↗ 系统架构

发行包 v1.0.0（12.89 MB）：含探针、服务端、示例应用与完整源码，解压后只需一个 JDK 即可运行，无需 Maven / Gradle。使用方式见包内 README.md，三步上手： server/start.sh 启动服务端 → 给目标应用加 -javaagent:agent/cqm-agent.jar → 打开监控页面。校验：SHA256 59F5E7ED…23FA4168 （完整校验值）。

本页数据由部署在服务器上的平台实时提供：探针约每 3 秒批量上报一次运行期指标，服务端完成清洗、规则检测与评分后供本页读取。页面每 5 秒自动刷新。

实时数据LIVE

正在连接…

—

规则检测违规明细

规则	位置	说明	等级
加载中…

静态代码指标（按圈复杂度降序）

类	方法	有效行数	圈复杂度	异常处理	资源管理
加载中…

运行期指标（探针采集）

类	方法	调用次数	平均耗时(ms)	最大耗时(ms)	异常数	异常率
加载中…

系统架构

系统总体架构图 — 图 1　系统总体架构：探针端（Java Agent + Byte Buddy 插桩）、服务端、前端三层

技术要点

无侵入采集：以 -javaagent 挂载探针，Byte Buddy 在类加载阶段对目标类插桩，业务代码零改动；匹配器显式排除构造方法与静态初始化块，避免插桩失败。
类加载器可见性：插桩代码被内联进业务类后由业务类的类加载器执行，因此把聚合器单独打成辅助 JAR 追加到引导类加载器，保证全 JVM 只有一份静态状态。
抖动抑制：采样、探针端本地聚合（按「类#方法」压缩为一条记录）、异步批量上报三重措施，实测单次调用固定开销约 0.107 µs，在毫秒级业务方法上额外耗时占比约 0.1%。
静态分析：McCabe 圈复杂度（判定点计数）、有效代码行数、空 catch 检测、资源未关闭检测、跨文件重复代码检测（滑动窗口哈希）。
规则与评分：6 条可配置规则；评分采用极值归一化后加权求和，负向指标（违规数、复杂度、异常率）与正向指标（覆盖率）分别处理，输出 0~100 分与等级。

监控界面

下载与使用

下载 CQM-v1.0.0.zip SHA256 校验值

项	说明
版本 / 大小	v1.0.0 ・ 12.89 MB ・ 58 个文件
运行要求	JDK 8 及以上；无需 Maven / Gradle，无需其他依赖
包含内容	探针（cqm-agent.jar）、服务端（预编译 + H2 驱动）、示例应用、全部源码（src/）、建表脚本（sql/schema.sql）、构建脚本与文档
开箱即用	解压后直接运行 server/start.sh（Windows 用 start.bat）；run-demo.sh 可一键跑示例看效果
接入自己的项目	启动时加 -javaagent:agent/cqm-agent.jar -Dcqm.packages=你的业务包名，业务代码零改动
源码仓库	github.com/969246694/YiyangzaiCQM ↗ （CI 自动构建 + 端到端冒烟测试 + 静态分析器回归测试）
其它下载源	GitHub Releases ↗ —— 与本页附件内容一致，可用 SHA256 交叉校验
许可	MIT License，可自由使用与修改

接入示例（无需改动任何业务代码）：

java -javaagent:/path/to/agent/cqm-agent.jar \
     -Dcqm.packages=com.yourcompany \
     -Dcqm.server=http://127.0.0.1:8080 \
     -Dcqm.app=your-app \
     -jar your-app.jar

全部配置项、质量规则阈值、评分权重与常见问题排查，见包内 README.md。