格式优化测试完成

2026-06-08 14:40:06 +08:00
parent 5821b85578
commit 9141fdbb19
8 changed files with 112 additions and 125 deletions
--- a/.gitea/checker/notify-templates/README.md
+++ b/.gitea/checker/notify-templates/README.md
@@ -8,28 +8,29 @@ Push 触发 CI 后，按变更类的后缀（`Dto` / `Vo` / `Entity` / `Model`

 | 语法 | 说明 |
 |------|------|
-| `#` / `##` / `###` | 标题 |
+| `#` / `##` / `###` | 标题（主区块用【】） |
 | `` `行内代码` `` | 字段名、URI |
 | `>` | 引用行（每项一行） |
+| `**bold**` | 头部四行、统计行加粗 |
 | `<font color="info">` | 绿：类名、新增、HTTP 方法、新类型 |
 | `<font color="comment">` | 灰：说明、路径、无影响 |
-| `<font color="warning">` | 橙：[修改]/[删除]、旧类型 |
+| `<font color="warning">` | 橙：[修改]/[删除]、旧类型、统计数字 |

 ## 布局约定

-1. **# 类变更通知** — 头部 4 项，每项一行 `>标签:值`
-2. **## 对象变更细节** — 每条变更独立引用块，字段间空行分隔
-3. **## 影响范围** — 各 ### 小节内，每项一行引用
+1. **# 【类变更通知】** — 头部 4 项，每项一行 `>**标签:  值**`（加粗，冒号后两空格）
+2. **## 【对象变更细节】** — 统计行 + 每条变更单行（标签/说明/类型合并）
+3. **## 【影响范围】** — 各 ### 小节内，每项一行引用

 ## 公共头部

 ```
-# 类变更通知
+# 【类变更通知】

-> 变更对象:<font color="info">ApplyAttendanceChangeDto</font>（Dto）
-> 修改人:<font color="comment">dongzi</font>
-> 时间:<font color="comment">2026-06-07 20:14:35</font>
-> 路径:<font color="comment">jnpf-ftb/.../ApplyAttendanceChangeDto.java</font>
+> **变更对象:  <font color="info">ApplyAttendanceChangeDto</font>（Dto）**
+> **修改人:  <font color="comment">dongzi</font>**
+> **时间:  <font color="comment">2026-06-07 20:14:35</font>**
+> **路径:  <font color="comment">jnpf-ftb/.../ApplyAttendanceChangeDto.java</font>**
 ```

 ## 影响范围
--- a/.gitea/checker/notify-templates/dto.md
+++ b/.gitea/checker/notify-templates/dto.md
@@ -8,32 +8,26 @@
 ## 完整示例（字段修改）

 ```
-# 类变更通知
+# 【类变更通知】

-> 变更对象:<font color="info">ApplyAttendanceChangeDto</font>（Dto）
-> 修改人:<font color="comment">dongzi</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="info">ApplyAttendanceChangeDto</font>（Dto）**
+> **修改人:  <font color="comment">dongzi</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">共 4 项字段变更</font>
+> **共 <font color="warning">4</font> 项变更**

-> <font color="warning">[修改]</font> `taskId`
-> 说明:<font color="comment">流程主键</font>
-> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
+> <font color="warning">[修改]</font> `taskId`  说明:  <font color="comment">流程主键</font>  类型:  <font color="warning">Integer</font> → <font color="info">String</font>

-> <font color="warning">[修改]</font> `changeUserId`
-> 说明:<font color="comment">变更人员id</font>
-> 类型:<font color="warning">String</font> → <font color="info">Integer</font>
+> <font color="warning">[修改]</font> `changeUserId`  说明:  <font color="comment">变更人员id</font>  类型:  <font color="warning">String</font> → <font color="info">Integer</font>

-> <font color="info">[新增]</font> `storeId`
-> 说明:<font color="comment">门店ID</font>
+> <font color="info">[新增]</font> `storeId`  说明:  <font color="comment">门店ID</font>

-> <font color="warning">[删除]</font> `oldField`
-> 说明:<font color="comment">已废弃字段</font>
+> <font color="warning">[删除]</font> `oldField`  说明:  <font color="comment">已废弃字段</font>

-## 影响范围
+## 【影响范围】

 ### 影响 request 接口
 > <font color="info">POST</font> `/apply/clockIn`
@@ -48,9 +42,9 @@
 ## 示例（类删除）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
+> <font color="warning">[已删除]</font>  <font color="comment">该类文件已被移除</font>
 ```

 ---
@@ -58,9 +52,9 @@
 ## 示例（仅类名变更）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <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>
 ```

@@ -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="comment">变更分钟数</font>
-> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
+> <font color="warning">[修改]</font> `changeMinute`  说明:  <font color="comment">变更分钟数</font>  类型:  <font color="warning">Integer</font> → <font color="info">String</font>
 ```

 ---
--- a/.gitea/checker/notify-templates/entity.md
+++ b/.gitea/checker/notify-templates/entity.md
@@ -8,25 +8,23 @@
 ## 完整示例（字段修改）

 ```
-# 类变更通知
+# 【类变更通知】

-> 变更对象:<font color="info">TrainingPositionEntity</font>（Entity）
-> 修改人:<font color="comment">张三</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="info">TrainingPositionEntity</font>（Entity）**
+> **修改人:  <font color="comment">张三</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">共 1 项字段变更</font>
+> **共 <font color="warning">1</font> 项变更**

-> <font color="warning">[修改]</font> `createTime`
-> 说明:<font color="comment">创建时间</font>
-> 类型:<font color="warning">Date</font> → <font color="info">LocalDateTime</font>
+> <font color="warning">[修改]</font> `createTime`  说明:  <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,9 +32,9 @@
 ## 示例（类删除）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
+> <font color="warning">[已删除]</font>  <font color="comment">该类文件已被移除</font>
 ```

 ---
@@ -44,8 +42,8 @@
 ## 示例（仅类名变更）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <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>
 ```
--- a/.gitea/checker/notify-templates/field-description.md
+++ b/.gitea/checker/notify-templates/field-description.md
@@ -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="comment">流程主键</font>
-> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
+> <font color="warning">[修改]</font> `taskId`  说明:  <font color="comment">流程主键</font>  类型:  <font color="warning">Integer</font> → <font color="info">String</font>

-> <font color="info">[新增]</font> `storeId`
-> 说明:<font color="comment">门店ID</font>
+> <font color="info">[新增]</font> `storeId`  说明:  <font color="comment">门店ID</font>
 ```

-| 操作 | 标签 | 类型行 |
+| 操作 | 标签 | 类型段 |
 |------|------|--------|
 | 新增 | info `[新增]` | 无 |
 | 删除 | warning `[删除]` | 无 |
 | 修改 | warning `[修改]` | 仅类型变化时出现 |

- 字段间用**空行**分隔，便于对照
+- 统计行加粗，数字用 warning（橙色），文案为「共 N 项变更」（不含「字段」）
+- 多条变更之间用**空行**分隔
 - 说明为空时显示 `<font color="comment">（无说明）</font>`
- 不要在 `<font>` 内嵌 `**bold**`
+- 头部四行加粗，用 `quoteKvBold`；不要在 `<font>` 内嵌 `**bold**`

 ## 接口行格式

--- a/.gitea/checker/notify-templates/model.md
+++ b/.gitea/checker/notify-templates/model.md
@@ -8,25 +8,23 @@
 ## 完整示例（字段修改）

 ```
-# 类变更通知
+# 【类变更通知】

-> 变更对象:<font color="info">AttendanceRuleModel</font>（Model）
-> 修改人:<font color="comment">张三</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="info">AttendanceRuleModel</font>（Model）**
+> **修改人:  <font color="comment">张三</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">共 1 项字段变更</font>
+> **共 <font color="warning">1</font> 项变更**

-> <font color="warning">[修改]</font> `ruleType`
-> 说明:<font color="comment">规则类型</font>
-> 类型:<font color="warning">Date</font> → <font color="info">String</font>
+> <font color="warning">[修改]</font> `ruleType`  说明:  <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,9 +32,9 @@
 ## 示例（类删除）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
+> <font color="warning">[已删除]</font>  <font color="comment">该类文件已被移除</font>
 ```

 ---
@@ -44,8 +42,8 @@
 ## 示例（仅类名变更）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <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>
 ```
--- a/.gitea/checker/notify-templates/vo.md
+++ b/.gitea/checker/notify-templates/vo.md
@@ -8,31 +8,28 @@
 ## 完整示例（字段修改）

 ```
-# 类变更通知
+# 【类变更通知】

-> 变更对象:<font color="info">AttendanceDetailVo</font>（Vo）
-> 修改人:<font color="comment">张三</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="info">AttendanceDetailVo</font>（Vo）**
+> **修改人:  <font color="comment">张三</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">共 2 项字段变更</font>
+> **共 <font color="warning">2</font> 项变更**

-> <font color="info">[新增]</font> `overtimeHours`
-> 说明:<font color="comment">加班时长</font>
+> <font color="info">[新增]</font> `overtimeHours`  说明:  <font color="comment">加班时长</font>

-> <font color="warning">[修改]</font> `status`
-> 说明:<font color="comment">考勤状态</font>
-> 类型:<font color="warning">Integer</font> → <font color="info">String</font>
+> <font color="warning">[修改]</font> `status`  说明:  <font color="comment">考勤状态</font>  类型:  <font color="warning">Integer</font> → <font color="info">String</font>

-## 影响范围
+## 【影响范围】

 ### 影响 response 接口
 > <font color="info">GET</font> `/api/attendance/detail`

 ### 类转换影响
-> Entity:<font color="info">AttendanceDetailEntity</font>
+> Entity:  <font color="info">AttendanceDetailEntity</font>
 ```

 ---
@@ -40,9 +37,9 @@
 ## 示例（类删除）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <font color="warning">[已删除]</font> <font color="comment">该类文件已被移除</font>
+> <font color="warning">[已删除]</font>  <font color="comment">该类文件已被移除</font>
 ```

 ---
@@ -50,8 +47,8 @@
 ## 示例（仅类名变更）

 ```
-## 对象变更细节
+## 【对象变更细节】

-> <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>
 ```