diff --git a/src/test/java/com/codechecker/cache/MqScenarioTest.java b/src/test/java/com/codechecker/cache/MqScenarioTest.java
index 32a814b..63dfb72 100644
--- a/src/test/java/com/codechecker/cache/MqScenarioTest.java
+++ b/src/test/java/com/codechecker/cache/MqScenarioTest.java
@@ -24,6 +24,9 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/**
+ * MQ 端到端场景：生产侧投递点检测、读侧补强、Schema Diff 与报告渲染联动验证。
+ */
 class MqScenarioTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/analyze/GlobMatcherTest.java b/src/test/java/com/codechecker/cache/analyze/GlobMatcherTest.java
index 556cecb..3c2c641 100644
--- a/src/test/java/com/codechecker/cache/analyze/GlobMatcherTest.java
+++ b/src/test/java/com/codechecker/cache/analyze/GlobMatcherTest.java
@@ -5,6 +5,7 @@ import org.junit.jupiter.api.Test;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/** {@link GlobMatcher} 的 glob 规则单测（{@code *} / {@code **} / 字面量）。 */
 class GlobMatcherTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/config/ConfigLoaderTest.java b/src/test/java/com/codechecker/cache/config/ConfigLoaderTest.java
index e5b5fbc..0b50767 100644
--- a/src/test/java/com/codechecker/cache/config/ConfigLoaderTest.java
+++ b/src/test/java/com/codechecker/cache/config/ConfigLoaderTest.java
@@ -11,6 +11,9 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/**
+ * 验证默认配置加载与业务 YAML 深度合并（业务项优先）。
+ */
 class ConfigLoaderTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/detector/CacheReadHintDetectorTest.java b/src/test/java/com/codechecker/cache/detector/CacheReadHintDetectorTest.java
index 8c8f811..5b1645d 100644
--- a/src/test/java/com/codechecker/cache/detector/CacheReadHintDetectorTest.java
+++ b/src/test/java/com/codechecker/cache/detector/CacheReadHintDetectorTest.java
@@ -9,6 +9,7 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/** W06 读侧反序列化类型提示检测单测。 */
 class CacheReadHintDetectorTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/detector/MqReadHintDetectorTest.java b/src/test/java/com/codechecker/cache/detector/MqReadHintDetectorTest.java
index 6efb224..b4b45c8 100644
--- a/src/test/java/com/codechecker/cache/detector/MqReadHintDetectorTest.java
+++ b/src/test/java/com/codechecker/cache/detector/MqReadHintDetectorTest.java
@@ -10,6 +10,7 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/** MQ-R 消费侧类型提示检测单测（RocketMQ Listener / Kafka Listener / parse）。 */
 class MqReadHintDetectorTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/detector/MqWritePointDetectorTest.java b/src/test/java/com/codechecker/cache/detector/MqWritePointDetectorTest.java
index 9bac143..1aa8102 100644
--- a/src/test/java/com/codechecker/cache/detector/MqWritePointDetectorTest.java
+++ b/src/test/java/com/codechecker/cache/detector/MqWritePointDetectorTest.java
@@ -12,6 +12,9 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/**
+ * RocketMQ / Kafka 生产侧投递点检测单测（MQ01~MQ05、MQ-K01~K04 及标量收敛）。
+ */
 class MqWritePointDetectorTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/detector/RedisWritePointDetectorTest.java b/src/test/java/com/codechecker/cache/detector/RedisWritePointDetectorTest.java
index 74cfc6a..ebd3613 100644
--- a/src/test/java/com/codechecker/cache/detector/RedisWritePointDetectorTest.java
+++ b/src/test/java/com/codechecker/cache/detector/RedisWritePointDetectorTest.java
@@ -12,6 +12,9 @@ import java.util.Set;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/**
+ * Redis 写入点检测单测（W01~W05、标量忽略、局部 JSON unwrap、本仓类型门槛）。
+ */
 class RedisWritePointDetectorTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/diff/SchemaDifferTest.java b/src/test/java/com/codechecker/cache/diff/SchemaDifferTest.java
index f395a9d..1b25015 100644
--- a/src/test/java/com/codechecker/cache/diff/SchemaDifferTest.java
+++ b/src/test/java/com/codechecker/cache/diff/SchemaDifferTest.java
@@ -11,6 +11,7 @@ import java.util.stream.Collectors;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/** {@link SchemaDiffer} 包装层 / 字段迁移 / 增删等 Diff 行为单测。 */
 class SchemaDifferTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/key/RedisKeyResolverTest.java b/src/test/java/com/codechecker/cache/key/RedisKeyResolverTest.java
index 017a0db..01b5db8 100644
--- a/src/test/java/com/codechecker/cache/key/RedisKeyResolverTest.java
+++ b/src/test/java/com/codechecker/cache/key/RedisKeyResolverTest.java
@@ -10,6 +10,7 @@ import org.junit.jupiter.api.Test;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
+/** Redis key 表达式静态模式推断单测（常量、format、拼接等）。 */
 class RedisKeyResolverTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/report/ReportBuilderTest.java b/src/test/java/com/codechecker/cache/report/ReportBuilderTest.java
index 0a0476c..73c22c8 100644
--- a/src/test/java/com/codechecker/cache/report/ReportBuilderTest.java
+++ b/src/test/java/com/codechecker/cache/report/ReportBuilderTest.java
@@ -15,6 +15,9 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/**
+ * 企微 Markdown / 控制台报告渲染单测：字段染色、新增写入点整段绿、拆条与转义。
+ */
 class ReportBuilderTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/schema/JavaSchemaExtractorTest.java b/src/test/java/com/codechecker/cache/schema/JavaSchemaExtractorTest.java
index 21f74b4..8584837 100644
--- a/src/test/java/com/codechecker/cache/schema/JavaSchemaExtractorTest.java
+++ b/src/test/java/com/codechecker/cache/schema/JavaSchemaExtractorTest.java
@@ -10,6 +10,7 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/** Java 类型 → 扁平 Schema 提取单测（注解忽略 / 重命名等）。 */
 class JavaSchemaExtractorTest {
 
     @Test
diff --git a/src/test/java/com/codechecker/cache/schema/SkeletonJsonRendererTest.java b/src/test/java/com/codechecker/cache/schema/SkeletonJsonRendererTest.java
index 0b0c3ae..ae6bbd0 100644
--- a/src/test/java/com/codechecker/cache/schema/SkeletonJsonRendererTest.java
+++ b/src/test/java/com/codechecker/cache/schema/SkeletonJsonRendererTest.java
@@ -15,6 +15,7 @@ import java.util.stream.Collectors;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+/** 序列化骨架 JSON 渲染与受保护路径截断单测。 */
 class SkeletonJsonRendererTest {
 
     @Test