1.5 KiB
1.5 KiB
字段说明规则
字段变更采用 引用块 + 单行合并 + font 颜色，遵循企微 markdown v1（不支持列表）。
说明提取优先级
| 优先级 | 来源 |
|---|---|
| 1 | @Schema(description = "...") |
| 2 | @ApiModelProperty |
| 3 | /** ... */ 字段注释 |
| 4 | 空串 |
字段变更行格式
每条变更占一行，标签、说明、类型横向排列，冒号后两空格：
> **共 <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="info">[新增]</font> `storeId` 说明: <font color="comment">门店ID</font>
| 操作 | 标签 | 类型段 |
|---|---|---|
| 新增 | info [新增] |
无 |
| 删除 | warning [删除] |
无 |
| 修改 | warning [修改] |
仅类型变化时出现 |
- 统计行加粗，数字用 warning（橙色），文案为「共 N 项变更」（不含「字段」）
- 多条变更之间用空行分隔
- 说明为空时显示
<font color="comment">（无说明）</font> - 头部四行加粗，用
quoteKvBold；不要在<font>内嵌**bold**
接口行格式
> <font color="info">POST</font> `/apply/clockIn`
实现
ClassFieldParser.extractFieldLabel()FieldDiffEngine— 仅类型变化产生[修改]WeComNotifier.formatFieldChange()