yu
e25121660d
- 点击可信验证增加两类生效旁证: 页面跳转/新开标签页(淘宝搜索按钮), 点击后元素整体消失(关闭登录弹窗); 此前均被误报为"目标未收到可信点击" 并在节点超时内反复重试, 造成"点击生效却等很久还报错" - 相似元素列表引用增加 index 序号: 动态id泛化后各卡片选择器相同, 46 条引用全部命中第一张卡导致抓取结果全重复; 修复 NodeList 无 indexOf 的 TypeError 被静默吞掉导致序号从未写入 - 元素定位改为两段式: 先在当前附着页查找, 找不到才跟随前台标签页, 避免多标签环境下被无条件切到 pages[0] 导致找错页面 - 新开标签页优先复用启动残留的 about:blank 空白页, 不再堆积空标签 - AI 能力输入识别增加 hint_word 字段(此前提示词读到的是空) - try_catch 捕获子步骤失败时记录 warn 日志, 不再静默 - Excel 落盘遇 EBUSY(文件被打开占用)时自动另存为带时间戳的文件 - 新增 similar-list.test.ts 端到端回归(46 卡片动态 id 真实浏览器验证) - 新增 export-last-run.js: 从运行记录导出比价 Excel
@rpa/core
RPA 能力层包：零 Electron 依赖的流程引擎、能力注册表与能力实现。
抽离路线见 docs/rpa-core-refactor-tasks.md，开发规范见 docs/dev-conventions.md。
包边界
| 模块 | 说明 |
|---|---|
src/engine/ |
注册表、运行时、表达式、createEngine() 工厂、host-bridge.ts 宿主桥 |
src/driver/ |
types.ts 五域 AutomationDriver 接口（mouse/keyboard/window/screen/element）+ windows/powershell.ts 进程助手 + windows/windows-driver.ts PowerShell 实现 |
src/capabilities/ |
能力实现（副作用注册，经 @rpa/core/capabilities 拉起） |
src/browser/ |
外部浏览器 CDP：external.ts（Edge/Chrome 进程管理）+ transport.ts（CdpTransport 接口、ExternalTransport） |
HostBridge 契约（决策点 4 最小面）
宿主（Electron 主进程 / 未来 Agent-Employee product-shell）启动时注入：
import { setHostBridge, setSubflowSource } from "@rpa/core";
setHostBridge({
createFormWindow({ title }) { /* 返回 HostDialogWindow 适配（BrowserWindow） */ },
dipToScreenPoint(p) { /* screen.dipToScreenPoint */ },
screenToDipPoint(p) { /* screen.screenToDipPoint */ },
loadAiConfig() { /* settings.aiConfig */ }
});
setSubflowSource({ listFlows, getFlow }); // 子流程仓库
未注入时的行为：window-extended 的 DPI 换算回退恒等（与旧 vitest 行为一致）；
ai-service 返回空配置（requireAiConfig 统一抛 ai_not_configured）；
human-dialog 抛 host_unavailable。
Electron 相关能力留守清单（宿主适配层，不入包）
src/main/browser/session.ts：BrowserSession 编排 + 内置运行浏览器（依赖BrowserWindow与应用生命周期）src/main/browser/transport.ts：EmbeddedTransport（包装webContents.debugger）src/main/capabilities/browser*.ts/web-batch2.ts/web-crawl.ts：经 BrowserSession 操作浏览器窗口src/main/capabilities/ai-caps.ts：AI 编排能力（依赖宿主注入的 chatCompletion 配置面，可随后续阶段评估迁入）src/main/overlay.ts/desktop-pick.ts/vision-lab.ts/fixture/：Electron 窗口强耦合src/main/local-vision/：onnxruntime-node 原生依赖，Bun 兼容性单独立项验证src/main/flows.ts/run//settings.ts：应用级编排与持久化
依赖护栏
npm run check:deps（根目录亦可）扫描 src/**：禁止 import "electron"、
相对引用逃出包 src/、引用宿主 src/main。阶段 2 起为提交前必跑项。
Driver（阶段 3）
- 五域接口
AutomationDriver（决策点 6）：RpaEngine.driver默认new WindowsDriver()，createEngine()可注入自定义实现（CLI/Linux driver 等未来形态）。 - 驱动只承载原始注入原语（单次 SetCursorPos / SendKeys / 窗口操作）；拟真抖动、 DIP 坐标换算、多步组合等策略留在能力文件，保证机械替换不改时序行为。
- element 域实现承载在
capabilities/desktop-uia.ts（经setElementDriverImplementation注册到 WindowsDriver），handler 层面向 driver 的收口在阶段 5/6 按需进行。 powershell()助手统一位于driver/windows/powershell.ts，包内能力禁止自行execFile("powershell.exe")（check:deps 与 review 双重把关）。- 平台标记：
npm run catalog构建时按组填充platformTag: "win32"（desktop/app/ office/vision 组），渲染层置灰延后（决策点 7）。