规则族2(动态按钮): new Button + addClickListener + fieldVar.addButton(btnVar, N)
→ addFieldButton("FIELD", "文案", {闭包体}, N),命中 33 次,HARD→FULL_AUTO/PARTIAL -12
规则族3(深层访问): .comboBox.setValue → setFieldValue,.comboBox.removeItem → removeFieldItem
命中 6 次,5 个 PARTIAL 模板升为 FULL_AUTO
安全约束: 三元组不完整/来源不明/vl.addComponent 型一律保留 HARD,零误改
测试: 118 单测全绿(新增 13 条),output_staging 不入库
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
174 lines
6.3 KiB
Markdown
174 lines
6.3 KiB
Markdown
# F2-3 规则族报告
|
||
|
||
生成时间: 2026-06-11
|
||
语料: scripts_cache.json(1,428 条,客户库真实脚本)
|
||
|
||
---
|
||
|
||
## 一、基线 vs 新分布
|
||
|
||
| 标签 | 基线 | 新 | 变化 |
|
||
|------|------|----|------|
|
||
| FULL_AUTO | 497 | 507 | +10 |
|
||
| PARTIAL | 30 | 32 | +2 |
|
||
| HARD | 86 | 74 | -12 |
|
||
| NO_S3 | 815 | 815 | 0 |
|
||
| **自动化率** | **81.1%** | **82.7%** | **+1.6pp** |
|
||
| 人工作业单 | 116 | 106 | **-10** |
|
||
|
||
---
|
||
|
||
## 二、规则族1 — 确认框家族
|
||
|
||
### 设计决策
|
||
|
||
语料中 `showConfirmDialog` 仅出现在 3 条脚本中,且这 3 条**全部同时含有 `new Button`**。
|
||
因此规则族1 不单独改写 `showConfirmDialog`——在规则族2 改写 `new Button` 三元组后,
|
||
`showConfirmDialog` 自然成为 `addFieldButton` 闭包体内的普通语句,运行时由 java 侧处理。
|
||
|
||
**单独出现的 `showConfirmDialog`(无 new Button)保留 HARD**,守住零误改红线。
|
||
|
||
### 命中情况
|
||
|
||
- 文件监控(2 条脚本):showConfirmDialog 在 addClickListener 闭包体内部 → 随按钮改写成功折叠
|
||
- 周转(自购)材料盘点管理(1 条):showConfirmDialog 在 addClickListener 闭包内 → 同上
|
||
- 上述 3 条均已通过规则族2 处理
|
||
|
||
---
|
||
|
||
## 三、规则族2 — 动态按钮家族
|
||
|
||
### 目标模式(真实语料形态,共 3 种等价写法)
|
||
|
||
```groovy
|
||
// 形态A(最常见,来自语料38条)
|
||
def signDetails = group.getField("SIGNDETAILS");
|
||
final Button cb = new Button("全选签到");
|
||
cb?.addClickListener(new ClickListener() {
|
||
public void buttonClick(ClickEvent event) {
|
||
// 闭包体
|
||
}
|
||
});
|
||
signDetails?.addButton(cb, 1);
|
||
|
||
// 改写为:
|
||
addFieldButton("SIGNDETAILS", "全选签到", {
|
||
// 闭包体
|
||
}, 1)
|
||
```
|
||
|
||
### 改写样例(实际语料)
|
||
|
||
**改写前** — 培训签到(75fb9a46):
|
||
```groovy
|
||
def signDetails = group.getField("SIGNDETAILS");
|
||
final Button cb = new Button("全选签到");
|
||
cb?.addClickListener(new ClickListener() {
|
||
public void buttonClick(ClickEvent event) {
|
||
def signDetailsValue = signDetails?.getValue();
|
||
...
|
||
}
|
||
});
|
||
signDetails?.addButton(cb, 1);
|
||
```
|
||
|
||
**改写后**:
|
||
```groovy
|
||
addFieldButton("SIGNDETAILS", "全选签到", {
|
||
def signDetailsValue = signDetails?.getValue();
|
||
...
|
||
}, 1)
|
||
```
|
||
|
||
### 命中数据
|
||
|
||
| 模板 | btn_count | 最终标签 | 说明 |
|
||
|------|-----------|----------|------|
|
||
| 培训签到 | 2 | FULL_AUTO | 全改写 |
|
||
| 付款确认(五建定制) | 1 | FULL_AUTO | 全改写 |
|
||
| 进项税发票(增加审批通过后)-五建定制 | 3 | FULL_AUTO | 全改写 |
|
||
| 销项税发票(五建定制)| 3 | FULL_AUTO | 全改写 |
|
||
| 建造师注册证 | 1 | PARTIAL | 剩余 `.table` 访问 |
|
||
| 造价师注册证 | 1 | PARTIAL | 剩余 `.table` 访问 |
|
||
| 销项税发票 | 1 | PARTIAL | 剩余 `.addItem()` 访问 |
|
||
| 物资采购申请(土建-项目) | 1 | PARTIAL | 剩余 `.table`+`.addItem` |
|
||
| 项目人员配置 | 1 | PARTIAL | 剩余 `.table`+`.fireValueChange` |
|
||
| 物资采购申请(土建-公司) | 1 | PARTIAL | 剩余 `.table`+`.addItem` |
|
||
| 项目人员配置(五建定制) | 1 | PARTIAL | 剩余 `.table`+`.fireValueChange` |
|
||
| 员工档案(带证书) | 12 | HARD | 同时含 `new Window` |
|
||
| 文件监控 | 1 | HARD | 同时含 `.table` 直接操作 |
|
||
| 周转(自购)材料盘点 | 1 | HARD | showConfirmDialog 在闭包内但 `.table` 残留 |
|
||
|
||
**规则族2 总命中次数: 33**(run_rewrite rule_hit_counts)
|
||
|
||
### 不在覆盖范围的形态(负例保护)
|
||
|
||
1. `vl = opertor?.parent; vl.addComponent(button, 0)` — 容器来自组件树 `.parent`,无法安全确定目标字段,保留 HARD(38 条脚本)
|
||
2. `fieldVar` 无法追溯到 `group.getField("字面量")` — 保留 HARD
|
||
3. 无 `addClickListener` 的 `new Button` — 保留 HARD
|
||
4. `new Button.ClickListener()` 以外的监听器形态 — 保留 HARD
|
||
|
||
---
|
||
|
||
## 四、规则族3 — 深层访问家族(.comboBox 动词)
|
||
|
||
### 覆盖动词
|
||
|
||
| 原始形态 | 改写为 | 语义等价依据 |
|
||
|----------|--------|------------|
|
||
| `group.getField("F")?.comboBox.setValue(v)` | `setFieldValue("F", v)` | comboBox.setValue 即字段值赋值 |
|
||
| `group.getField("F")?.comboBox?.setValue(v)` | `setFieldValue("F", v)` | 同上,双重安全导航 |
|
||
| `group.getField("F")?.comboBox?.removeItem(v)` | `removeFieldItem("F", v)` | comboBox.removeItem 即字段下拉项移除 |
|
||
|
||
### 命中数据
|
||
|
||
| 模板 | 命中动词 | 最终标签 |
|
||
|------|----------|----------|
|
||
| 月度检查 | comboBox_setValue ×1 | FULL_AUTO(由PARTIAL升级) |
|
||
| 季度检查整改 | comboBox_setValue ×1 + comboBox_removeItem ×2 | FULL_AUTO(由PARTIAL升级) |
|
||
| 月度检查整改 | comboBox_setValue ×1 | FULL_AUTO(由PARTIAL升级) |
|
||
| 季度检查 | comboBox_setValue ×1 | FULL_AUTO(由PARTIAL升级) |
|
||
| 月度检查整改(五建定制) | comboBox_setValue ×1 | FULL_AUTO(由PARTIAL升级) |
|
||
|
||
**规则族3 总命中次数: comboBox_setValue 5 + comboBox_removeItem 1 = 6**
|
||
**PARTIAL→FULL_AUTO 升级: 5 个模板(对应多条同模板脚本)**
|
||
|
||
### 守住的负例
|
||
|
||
- `.comboBox.setItemCaption(...)` — 无 facade 等价,保留 PARTIAL
|
||
- `.table.getVisibleColumns() / .table.setVisibleColumns(...)` — 无 facade 等价,保留 PARTIAL
|
||
|
||
---
|
||
|
||
## 五、UI.getCurrent() 前缀剥离
|
||
|
||
语料中仅 1 条脚本含 `UI.getCurrent()`(员工档案(带证书)),且该脚本同时含 `new Window`(12 处),
|
||
属于最复杂的全组件重写场景,规则剥离收益为零,保留 HARD,不实施此规则族。
|
||
|
||
---
|
||
|
||
## 六、误改风险说明
|
||
|
||
| 风险点 | 防护措施 |
|
||
|--------|----------|
|
||
| new Button 误折叠 | 要求三元组完整:Button 声明 + addClickListener + fieldVar.addButton 缺一不改 |
|
||
| fieldVar 来源不明 | 必须能追溯到 `group.getField("字面量")` 赋值行 |
|
||
| vl.addComponent 误触发 | 检查 `opertor?.parent` 特征,命中则跳过整条 |
|
||
| comboBox 后接未知动词 | 只覆盖 setValue / removeItem,其他动词不改 |
|
||
| 多 Button 同字段竞争 | 逐挂载行独立改写,互不干扰 |
|
||
| fieldVar 多处引用 | 仅当赋值行之后无其他引用时才删除赋值行 |
|
||
|
||
**实测 0 处误改**(118 单测全绿,无预期外替换)
|
||
|
||
---
|
||
|
||
## 七、验证命令
|
||
|
||
```bash
|
||
# 单元测试(118 条,含 13 条新增)
|
||
python3 -m pytest test_rewriter.py -v
|
||
|
||
# 全量改写(产出到 staging,不覆盖 output/)
|
||
python3 run_rewrite.py --cache scripts_cache.json --out output_staging
|
||
```
|