F2-3(规则族): 动态按钮族/comboBox深层访问族扩展,HARD 86→74,自动化率 81.1%→82.7%

规则族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>
This commit is contained in:
2026-06-11 21:41:16 +08:00
parent a711ecd8f0
commit 252e55cff5
4 changed files with 723 additions and 5 deletions

View File

@@ -0,0 +1,173 @@
# 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
```