dongzi/AI-Check-Test
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

格式优化测试完成
All checks were successful
类变更检测 / class-change-check (push) Successful in 13s
Details

Browse Source
This commit is contained in:
东子
2026-06-08 14:40:06 +08:00
parent 5821b85578
commit 9141fdbb19
8 changed files with 112 additions and 125 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
.gitea/checker/notify-templates/README.md
View File

@@ -8,28 +8,29 @@ Push 触发 CI 后，按变更类的后缀（`Dto` / `Vo` / `Entity` / `Model`
| 语法 | 说明 | | 语法 | 说明 |
|------|------| |------|------|
| `#` / `##` / `###` | 标题 | | `#` / `##` / `###` | 标题（主区块用【】） |
| `` `行内代码` `` | 字段名、URI | | `` `行内代码` `` | 字段名、URI |
| `>` | 引用行（每项一行） | | `>` | 引用行（每项一行） |
| `**bold**` | 头部四行、统计行加粗 |
| `<font color="info">` | 绿：类名、新增、HTTP 方法、新类型 | | `<font color="info">` | 绿：类名、新增、HTTP 方法、新类型 |
| `<font color="comment">` | 灰：说明、路径、无影响 | | `<font color="comment">` | 灰：说明、路径、无影响 |
| `<font color="warning">` | 橙：[修改]/[删除]、旧类型 | | `<font color="warning">` | 橙：[修改]/[删除]、旧类型、统计数字 |
## 布局约定 ## 布局约定
1. **# 类变更通知** — 头部 4 项，每项一行 `>标签:值` 1. **# 【类变更通知】** — 头部 4 项，每项一行 `>**标签: 值**`（加粗，冒号后两空格）
2. **## 对象变更细节** — 每条变更独立引用块，字段间空行分隔 2. **## 【对象变更细节】** — 统计行 + 每条变更单行（标签/说明/类型合并）
3. **## 影响范围** — 各 ### 小节内，每项一行引用 3. **## 【影响范围】** — 各 ### 小节内，每项一行引用
## 公共头部 ## 公共头部
``` ```
# 类变更通知 # 【类变更通知】
> 变更对象:<font color="info">ApplyAttendanceChangeDto</font>（Dto） > **变更对象: <font color="info">ApplyAttendanceChangeDto</font>（Dto）**
> 修改人:<font color="comment">dongzi</font> > **修改人: <font color="comment">dongzi</font>**
> 时间:<font color="comment">2026-06-07 20:14:35</font> > **时间: <font color="comment">2026-06-07 20:14:35</font>**
> 路径:<font color="comment">jnpf-ftb/.../ApplyAttendanceChangeDto.java</font> > **路径: <font color="comment">jnpf-ftb/.../ApplyAttendanceChangeDto.java</font>**
``` ```
## 影响范围 ## 影响范围

42
.gitea/checker/notify-templates/dto.md
View File

@@ -8,32 +8,26 @@
## 完整示例（字段修改） ## 完整示例（字段修改）
``` ```
# 类变更通知 # 【类变更通知】
> 变更对象:<font color="info">ApplyAttendanceChangeDto</font>（Dto） > **变更对象: <font color="info">ApplyAttendanceChangeDto</font>（Dto）**
> 修改人:<font color="comment">dongzi</font> > **修改人: <font color="comment">dongzi</font>**
> 时间:<font color="comment">2026-06-07 20:14:35</font> > **时间: <font color="comment">2026-06-07 20:14:35</font>**
> 路径:<font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/workflow/dto/ApplyAttendanceChangeDto.java</font> > **路径: <font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/workflow/dto/ApplyAttendanceChangeDto.java</font>**
## 对象变更细节 ## 【对象变更细节】
> <font color="comment">共 4 项字段变更</font> > **共 <font color="warning">4</font> 项变更**
> <font color="warning">[修改]</font> `taskId` > <font color="warning">[修改]</font> `taskId` 说明: <font color="comment">流程主键</font> 类型: <font color="warning">Integer</font> → <font color="info">String</font>
> 说明:<font color="comment">流程主键</font>
> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
> <font color="warning">[修改]</font> `changeUserId` > <font color="warning">[修改]</font> `changeUserId` 说明: <font color="comment">变更人员id</font> 类型: <font color="warning">String</font> → <font color="info">Integer</font>
> 说明:<font color="comment">变更人员id</font>
> 类型:<font color="warning">String</font> → <font color="info">Integer</font>
> <font color="info">[新增]</font> `storeId` > <font color="info">[新增]</font> `storeId` 说明: <font color="comment">门店ID</font>
> 说明:<font color="comment">门店ID</font>
> <font color="warning">[删除]</font> `oldField` > <font color="warning">[删除]</font> `oldField` 说明: <font color="comment">已废弃字段</font>
> 说明:<font color="comment">已废弃字段</font>
## 影响范围 ## 【影响范围】
### 影响 request 接口 ### 影响 request 接口
> <font color="info">POST</font> `/apply/clockIn` > <font color="info">POST</font> `/apply/clockIn`
@@ -48,7 +42,7 @@
## 示例（类删除） ## 示例（类删除）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font> > <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
``` ```
@@ -58,7 +52,7 @@
## 示例（仅类名变更） ## 示例（仅类名变更）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[类名变更]</font> <font color="comment">ApplyAttendanceChangeDto</font> → <font color="info">ApplyAttendanceChangeNewDto</font> > <font color="warning">[类名变更]</font> <font color="comment">ApplyAttendanceChangeDto</font> → <font color="info">ApplyAttendanceChangeNewDto</font>
> <font color="comment">字段无变化</font> > <font color="comment">字段无变化</font>
@@ -69,15 +63,13 @@
## 示例（类名 + 字段同时变更） ## 示例（类名 + 字段同时变更）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[类名变更]</font> <font color="comment">ApplyAttendanceChangeDto</font> → <font color="info">ApplyAttendanceChangeNewDto</font> > <font color="warning">[类名变更]</font> <font color="comment">ApplyAttendanceChangeDto</font> → <font color="info">ApplyAttendanceChangeNewDto</font>
> <font color="comment">共 1 项字段变更</font> > **共 <font color="warning">1</font> 项变更**
> <font color="warning">[修改]</font> `changeMinute` > <font color="warning">[修改]</font> `changeMinute` 说明: <font color="comment">变更分钟数</font> 类型: <font color="warning">Integer</font> → <font color="info">String</font>
> 说明:<font color="comment">变更分钟数</font>
> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
``` ```
--- ---

24
.gitea/checker/notify-templates/entity.md
View File

@@ -8,22 +8,20 @@
## 完整示例（字段修改） ## 完整示例（字段修改）
``` ```
# 类变更通知 # 【类变更通知】
> 变更对象:<font color="info">TrainingPositionEntity</font>（Entity） > **变更对象: <font color="info">TrainingPositionEntity</font>（Entity）**
> 修改人:<font color="comment">张三</font> > **修改人: <font color="comment">张三</font>**
> 时间:<font color="comment">2026-06-07 14:30:00</font> > **时间: <font color="comment">2026-06-07 14:30:00</font>**
> 路径:<font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/entity/training/TrainingPositionEntity.java</font> > **路径: <font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/entity/training/TrainingPositionEntity.java</font>**
## 对象变更细节 ## 【对象变更细节】
> <font color="comment">共 1 项字段变更</font> > **共 <font color="warning">1</font> 项变更**
> <font color="warning">[修改]</font> `createTime` > <font color="warning">[修改]</font> `createTime` 说明: <font color="comment">创建时间</font> 类型: <font color="warning">Date</font> → <font color="info">LocalDateTime</font>
> 说明:<font color="comment">创建时间</font>
> 类型:<font color="warning">Date</font> → <font color="info">LocalDateTime</font>
## 影响范围 ## 【影响范围】
### 类转换影响 ### 类转换影响
> Entity: <font color="info">TrainingPositionEntity</font> > Entity: <font color="info">TrainingPositionEntity</font>
@@ -34,7 +32,7 @@
## 示例（类删除） ## 示例（类删除）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font> > <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
``` ```
@@ -44,7 +42,7 @@
## 示例（仅类名变更） ## 示例（仅类名变更）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[类名变更]</font> <font color="comment">TrainingPositionEntity</font> → <font color="info">TrainingPositionNewEntity</font> > <font color="warning">[类名变更]</font> <font color="comment">TrainingPositionEntity</font> → <font color="info">TrainingPositionNewEntity</font>
> <font color="comment">字段无变化</font> > <font color="comment">字段无变化</font>

20
.gitea/checker/notify-templates/field-description.md
View File

@@ -1,6 +1,6 @@
# 字段说明规则 # 字段说明规则
字段变更采用 **引用块 + 换行 + font 颜色**，遵循企微 `markdown` v1（不支持列表）。 字段变更采用 **引用块 + 单行合并 + font 颜色**，遵循企微 `markdown` v1（不支持列表）。
## 说明提取优先级 ## 说明提取优先级
@@ -13,26 +13,26 @@
## 字段变更行格式 ## 字段变更行格式
每条变更占**一行**，标签、说明、类型横向排列，冒号后两空格：
``` ```
> <font color="comment">共 4 项字段变更</font> > **共 <font color="warning">4</font> 项变更**
> <font color="warning">[修改]</font> `taskId` > <font color="warning">[修改]</font> `taskId` 说明: <font color="comment">流程主键</font> 类型: <font color="warning">Integer</font> → <font color="info">String</font>
> 说明:<font color="comment">流程主键</font>
> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
> <font color="info">[新增]</font> `storeId` > <font color="info">[新增]</font> `storeId` 说明: <font color="comment">门店ID</font>
> 说明:<font color="comment">门店ID</font>
``` ```
| 操作 | 标签 | 类型行 | | 操作 | 标签 | 类型段 |
|------|------|--------| |------|------|--------|
| 新增 | info `[新增]` | 无 | | 新增 | info `[新增]` | 无 |
| 删除 | warning `[删除]` | 无 | | 删除 | warning `[删除]` | 无 |
| 修改 | warning `[修改]` | 仅类型变化时出现 | | 修改 | warning `[修改]` | 仅类型变化时出现 |
- 字段间用**空行**分隔，便于对照 - 统计行加粗，数字用 warning（橙色），文案为「共 N 项变更」（不含「字段」）
- 多条变更之间用**空行**分隔
- 说明为空时显示 `<font color="comment">（无说明）</font>` - 说明为空时显示 `<font color="comment">（无说明）</font>`
- 不要在 `<font>` 内嵌 `**bold**` - 头部四行加粗，用 `quoteKvBold`；不要在 `<font>` 内嵌 `**bold**`
## 接口行格式 ## 接口行格式

24
.gitea/checker/notify-templates/model.md
View File

@@ -8,22 +8,20 @@
## 完整示例（字段修改） ## 完整示例（字段修改）
``` ```
# 类变更通知 # 【类变更通知】
> 变更对象:<font color="info">AttendanceRuleModel</font>（Model） > **变更对象: <font color="info">AttendanceRuleModel</font>（Model）**
> 修改人:<font color="comment">张三</font> > **修改人: <font color="comment">张三</font>**
> 时间:<font color="comment">2026-06-07 14:30:00</font> > **时间: <font color="comment">2026-06-07 14:30:00</font>**
> 路径:<font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/attendance/AttendanceRuleModel.java</font> > **路径: <font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/attendance/AttendanceRuleModel.java</font>**
## 对象变更细节 ## 【对象变更细节】
> <font color="comment">共 1 项字段变更</font> > **共 <font color="warning">1</font> 项变更**
> <font color="warning">[修改]</font> `ruleType` > <font color="warning">[修改]</font> `ruleType` 说明: <font color="comment">规则类型</font> 类型: <font color="warning">Date</font> → <font color="info">String</font>
> 说明:<font color="comment">规则类型</font>
> 类型:<font color="warning">Date</font> → <font color="info">String</font>
## 影响范围 ## 【影响范围】
### 类转换影响 ### 类转换影响
> Entity: <font color="info">AttendanceRuleEntity</font> > Entity: <font color="info">AttendanceRuleEntity</font>
@@ -34,7 +32,7 @@
## 示例（类删除） ## 示例（类删除）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font> > <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
``` ```
@@ -44,7 +42,7 @@
## 示例（仅类名变更） ## 示例（仅类名变更）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[类名变更]</font> <font color="comment">AttendanceRuleModel</font> → <font color="info">AttendanceRuleNewModel</font> > <font color="warning">[类名变更]</font> <font color="comment">AttendanceRuleModel</font> → <font color="info">AttendanceRuleNewModel</font>
> <font color="comment">字段无变化</font> > <font color="comment">字段无变化</font>

27
.gitea/checker/notify-templates/vo.md
View File

@@ -8,25 +8,22 @@
## 完整示例（字段修改） ## 完整示例（字段修改）
``` ```
# 类变更通知 # 【类变更通知】
> 变更对象:<font color="info">AttendanceDetailVo</font>（Vo） > **变更对象: <font color="info">AttendanceDetailVo</font>（Vo）**
> 修改人:<font color="comment">张三</font> > **修改人: <font color="comment">张三</font>**
> 时间:<font color="comment">2026-06-07 14:30:00</font> > **时间: <font color="comment">2026-06-07 14:30:00</font>**
> 路径:<font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/attendance/vo/AttendanceDetailVo.java</font> > **路径: <font color="comment">jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/attendance/vo/AttendanceDetailVo.java</font>**
## 对象变更细节 ## 【对象变更细节】
> <font color="comment">共 2 项字段变更</font> > **共 <font color="warning">2</font> 项变更**
> <font color="info">[新增]</font> `overtimeHours` > <font color="info">[新增]</font> `overtimeHours` 说明: <font color="comment">加班时长</font>
> 说明:<font color="comment">加班时长</font>
> <font color="warning">[修改]</font> `status` > <font color="warning">[修改]</font> `status` 说明: <font color="comment">考勤状态</font> 类型: <font color="warning">Integer</font> → <font color="info">String</font>
> 说明:<font color="comment">考勤状态</font>
> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
## 影响范围 ## 【影响范围】
### 影响 response 接口 ### 影响 response 接口
> <font color="info">GET</font> `/api/attendance/detail` > <font color="info">GET</font> `/api/attendance/detail`
@@ -40,7 +37,7 @@
## 示例（类删除） ## 示例（类删除）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font> > <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
``` ```
@@ -50,7 +47,7 @@
## 示例（仅类名变更） ## 示例（仅类名变更）
``` ```
## 对象变更细节 ## 【对象变更细节】
> <font color="warning">[类名变更]</font> <font color="comment">AttendanceDetailVo</font> → <font color="info">AttendanceDetailNewVo</font> > <font color="warning">[类名变更]</font> <font color="comment">AttendanceDetailVo</font> → <font color="info">AttendanceDetailNewVo</font>
> <font color="comment">字段无变化</font> > <font color="comment">字段无变化</font>

45
.gitea/checker/src/main/java/com/autoCheck/notify/WeComNotifier.java
View File

@@ -18,7 +18,7 @@ import java.util.concurrent.TimeUnit;
* 将 ClassChangeReport 渲染为企业微信 Markdown 并发送（或仅日志输出）。 * 将 ClassChangeReport 渲染为企业微信 Markdown 并发送（或仅日志输出）。
* <p> * <p>
* 使用 webhook {@code markdown}（v1）：引用块 + 换行排版，三色 font（info/comment/warning）。 * 使用 webhook {@code markdown}（v1）：引用块 + 换行排版，三色 font（info/comment/warning）。
* v1 不支持无序列表，各项以 {@code >标签:值} 分行展示。 * v1 不支持无序列表，各项以 {@code >标签: 值} 分行展示（冒号后两空格）。
*/ */
public class WeComNotifier { public class WeComNotifier {
private static final int MAX_LENGTH = 3800; private static final int MAX_LENGTH = 3800;
@@ -82,14 +82,14 @@ public class WeComNotifier {
return truncate(sb.toString()); return truncate(sb.toString());
} }
/** 头部元信息，每项一行引用 */ /** 头部元信息，每项一行引用（加粗） */
private void appendHeader(StringBuilder sb, ClassChangeReport report, private void appendHeader(StringBuilder sb, ClassChangeReport report,
String modifier, String modifyTime) { String modifier, String modifyTime) {
sb.append(quoteKv("变更对象", colorInfo(safe(report.getClassName())) sb.append(quoteKvBold("变更对象", colorInfo(safe(report.getClassName()))
+ "（" + report.getClassType().getLabel() + "）")).append("\n"); + "（" + report.getClassType().getLabel() + "）")).append("\n");
sb.append(quoteKv("修改人", colorComment(modifier))).append("\n"); sb.append(quoteKvBold("修改人", colorComment(modifier))).append("\n");
sb.append(quoteKv("时间", colorComment(modifyTime))).append("\n"); sb.append(quoteKvBold("时间", colorComment(modifyTime))).append("\n");
sb.append(quoteKv("路径", colorComment(report.getSourceFile()))).append("\n"); sb.append(quoteKvBold("路径", colorComment(report.getSourceFile()))).append("\n");
} }
/** 渲染删除 / 重命名 / 字段变更 */ /** 渲染删除 / 重命名 / 字段变更 */
@@ -112,8 +112,9 @@ public class WeComNotifier {
} }
if (!report.getFieldChanges().isEmpty()) { if (!report.getFieldChanges().isEmpty()) {
sb.append(quoteLine(colorComment("共 " int count = report.getFieldChanges().size();
+ report.getFieldChanges().size() + " 项字段变更"))).append("\n\n"); sb.append(quoteLine("**共 " + colorWarning(String.valueOf(count)) + " 项变更**"))
.append("\n\n");
for (int i = 0; i < report.getFieldChanges().size(); i++) { for (int i = 0; i < report.getFieldChanges().size(); i++) {
if (i > 0) { if (i > 0) {
sb.append("\n"); sb.append("\n");
@@ -204,10 +205,7 @@ public class WeComNotifier {
return quoteLine(inlineCode(safe(line))); return quoteLine(inlineCode(safe(line)));
} }
/** /** 单条字段变更：标签、说明、类型合并为一行，字段间空行分隔 */
* 单条字段变更：引用块多行，字段间空行分隔。
* 避免 font 内嵌 bold。
*/
private String formatFieldChange(FieldChange change) { private String formatFieldChange(FieldChange change) {
String fieldName = inlineCode(safe(change.getFieldName())); String fieldName = inlineCode(safe(change.getFieldName()));
String desc = change.getDescription() == null ? "" : change.getDescription(); String desc = change.getDescription() == null ? "" : change.getDescription();
@@ -217,21 +215,19 @@ public class WeComNotifier {
switch (change.getKind()) { switch (change.getKind()) {
case ADDED: case ADDED:
return quoteLine(tagAdded() + " " + fieldName) + "\n" return quoteLine(tagAdded() + " " + fieldName + " 说明: " + descPart);
+ quoteKv("说明", descPart);
case REMOVED: case REMOVED:
return quoteLine(tagRemoved() + " " + fieldName) + "\n" return quoteLine(tagRemoved() + " " + fieldName + " 说明: " + descPart);
+ quoteKv("说明", descPart);
case MODIFIED: case MODIFIED:
default: default:
StringBuilder block = new StringBuilder(); StringBuilder line = new StringBuilder();
block.append(quoteLine(tagModified() + " " + fieldName)).append("\n"); line.append(tagModified()).append(" ").append(fieldName)
block.append(quoteKv("说明", descPart)); .append(" 说明: ").append(descPart);
String detail = change.getDetail(); String detail = change.getDetail();
if (detail != null && !detail.isBlank()) { if (detail != null && !detail.isBlank()) {
block.append("\n").append(quoteKv("类型", formatTypeChange(detail))); line.append(" 类型: ").append(formatTypeChange(detail));
} }
return block.toString(); return quoteLine(line.toString());
} }
} }
@@ -258,11 +254,16 @@ public class WeComNotifier {
return colorWarning("[修改]"); return colorWarning("[修改]");
} }
/** 引用行：{@code >标签:值} */ /** 引用行：{@code >标签: 值}（冒号后两空格） */
private String quoteKv(String key, String value) { private String quoteKv(String key, String value) {
return "> " + key + ": " + value; return "> " + key + ": " + value;
} }
/** 加粗引用行：用于类变更通知头部 */
private String quoteKvBold(String key, String value) {
return "> **" + key + ": " + value + "**";
}
/** 纯引用行 */ /** 纯引用行 */
private String quoteLine(String content) { private String quoteLine(String content) {
return "> " + content; return "> " + content;

4
scripts/build-class-checker.ps1
View File

@@ -1,14 +1,14 @@
# 本地打包 class-checker 并复制到 .gitea/workflows/ # 本地打包 class-checker 并复制到 .gitea/workflows/
$ErrorActionPreference = "Stop" $ErrorActionPreference = "Stop"
$Root = Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path) $Root = Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path)
$CheckerDir = Join-Path $Root ".gitea\class-checker" $CheckerDir = Join-Path $Root ".gitea\checker"
$WorkflowsDir = Join-Path $Root ".gitea\workflows" $WorkflowsDir = Join-Path $Root ".gitea\workflows"
$TargetJar = Join-Path $CheckerDir "target\class-checker.jar" $TargetJar = Join-Path $CheckerDir "target\class-checker.jar"
$OutputJar = Join-Path $WorkflowsDir "class-checker.jar" $OutputJar = Join-Path $WorkflowsDir "class-checker.jar"
Write-Host ">> 编译 class-checker..." Write-Host ">> 编译 class-checker..."
Push-Location $Root Push-Location $Root
& mvn -q -f .gitea/class-checker/pom.xml package -DskipTests & mvn -q -f .gitea/checker/pom.xml package -DskipTests
if ($LASTEXITCODE -ne 0) { if ($LASTEXITCODE -ne 0) {
Pop-Location Pop-Location
Write-Error "Maven 编译失败，exit code: $LASTEXITCODE" Write-Error "Maven 编译失败，exit code: $LASTEXITCODE"