Files
eip4-platform/tools/s3_rewriter/F2-3规则族报告.md
zhengwr 252e55cff5 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>
2026-06-11 21:41:16 +08:00

174 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
```