08e798c087
目标：ADR-R4 前置修复——①CDP 对端不回包时 send 在有限时间内失败；②同名定位参数在全部网页能力下行为一致 代码逻辑：①ExternalTransport.send 增单命令超时（默认 30s，connect 可传），超时以稳定码 timeout 拒绝并清理 pending（不再依赖引擎级超时兜底+泄漏表项）；RuntimeError 原样透传不经 mapCdpError 改写；②selectorOf 三份重复定义（browser/browser-extended/browser-dom）收敛为 src/main/browser/selector.ts 单一事实源，键集合取并集（补 uiWindowSelector）；browser-common 的 element_position 位置感知定位语义不同，有意保留 验证：宿主 browser+extended 测试 49/49 全绿；rpa-core 引擎域 32/32 全绿；typecheck 归零 风险与回滚：低——超时默认值对既有快流程无感知；定位器统一仅补齐兜底键，行为为超集 |
||
|---|---|---|
| .. | ||
| scripts | ||
| src | ||
| test | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
| vitest.config.ts | ||
@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）。