48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
# @rpa/core
|
||
|
||
RPA 能力层包：零 Electron 依赖的流程引擎、能力注册表与能力实现。
|
||
抽离路线见 `docs/rpa-core-refactor-tasks.md`，开发规范见 `docs/dev-conventions.md`。
|
||
|
||
## 包边界
|
||
|
||
| 模块 | 说明 |
|
||
|---|---|
|
||
| `src/engine/` | 注册表、运行时、表达式、`createEngine()` 工厂、`host-bridge.ts` 宿主桥 |
|
||
| `src/capabilities/` | 能力实现（副作用注册，经 `@rpa/core/capabilities` 拉起） |
|
||
| `src/browser/` | 外部浏览器 CDP：`external.ts`（Edge/Chrome 进程管理）+ `transport.ts`（CdpTransport 接口、ExternalTransport） |
|
||
|
||
## HostBridge 契约（决策点 4 最小面）
|
||
|
||
宿主（Electron 主进程 / 未来 Agent-Employee product-shell）启动时注入：
|
||
|
||
```ts
|
||
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 起为提交前必跑项。
|