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

6.3 KiB
Raw Blame History

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 种等价写法)

// 形态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):

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);

改写后:

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 单测全绿,无预期外替换)


七、验证命令

# 单元测试(118 条,含 13 条新增)
python3 -m pytest test_rewriter.py -v

# 全量改写(产出到 staging,不覆盖 output/)
python3 run_rewrite.py --cache scripts_cache.json --out output_staging