feat: V1.1 - 注释补充

src/main/java/com/codechecker/cache/diff/ChangeType.java

@@ -2,6 +2,8 @@ package com.codechecker.cache.diff;
 
 /**
  * 结构变更类型及其默认严重级别。
+ * <p>用于 Diff 结果分类与报告展示标签；实际严重级别可被 {@code severity_overrides} 覆盖。</p>
+ * @author DD
  */
 public enum ChangeType {
     FIELD_REMOVED(Severity.P0, "字段删除"),

src/main/java/com/codechecker/cache/diff/SchemaChange.java

@@ -1,7 +1,8 @@
 package com.codechecker.cache.diff;
 
 /**
- * 一条结构变更记录。
+ * 一条结构变更记录：关联 key/destination、写入位置、字段路径与前后取值说明。
+ * <p>由 {@link SchemaDiffer} 或分析器在「新增/删除写入点」时生成，再进入报告明细。</p>
  */
 public class SchemaChange {
 

src/main/java/com/codechecker/cache/diff/Severity.java

@@ -1,10 +1,18 @@
 package com.codechecker.cache.diff;
 
 /**
- * 变更严重级别。
+ * 变更严重级别（默认由 {@link ChangeType} 给出，可被配置覆盖）。
+ * <ul>
+ *   <li>{@link #P0} — 高危：字段删除、类型变更、包装层/路径迁移等</li>
+ *   <li>{@link #P1} — 中危：新增字段、删除写入点等</li>
+ *   <li>{@link #P2} — 低危/提示：新增写入点、低置信度变更等</li>
+ * </ul>
  */
 public enum Severity {
+    /** 高危结构破坏 */
     P0,
+    /** 中危兼容性风险 */
     P1,
+    /** 低危或需人工确认 */
     P2
 }