Appearance
核心概念
理解以下概念，有助于快速上手工作流设计与二次开发。
工作流 (Workflow)
工作流是由节点与连线组成的自动化流程。每个工作流可独立调度、并发执行，并在独立浏览器窗口中隔离运行。
text
[启动] → [打开页面] → [执行脚本] → [提取数据] → [写入数据库] → [结束]节点 (Node)
节点是工作流中的最小执行单元，由三部分组成：
- 类型定义 —
src/automa/types/node-types.ts - UI 配置 — 设计器中的图标、表单与连线规则
- 执行器 —
src/main/engine/executors/中的运行时逻辑
节点按功能分为浏览器、桌面、流程控制、数据处理、AI 等类别。
变量 (Variables)
流程变量在节点间传递数据：
- 页面脚本中通过
handler.variables()读写 - Node 执行器中通过
ExecutionContext访问
三层通信
text
Renderer (Vue UI)
↕ IPC
Main Process (引擎 / 控制器 / 数据库)
↕ Preload Bridge
BrowserWindow (automa / handler 脚本环境)| 层级 | 职责 |
|---|---|
| Renderer | 工作流设计器、AI 仪表盘、配置界面 |
| Main | WorkflowEngine、BizApi、定时任务、原生能力 |
| BrowserWindow | 注入 automa 与 handler，执行页面级自动化 |
脚本类型
| 类型 | 说明 |
|---|---|
| 内置脚本 | 封装常用操作，随应用分发 |
| 路径脚本 | 存储在本地文件系统的 .js 文件 |
| 管理端脚本 | 在 UI 中编写并持久化 |
脚本在隔离环境中执行，运行时直接可用 automa 与 handler：
js
const fn = new Function('automa', 'handler', `return (async()=>{ /* 你的代码 */ })();`);
await fn(automa, handler);完整 API 见 automa & handler 手册。
AI 自动执行
AI 工作台将用户意图转化为 BizApi 调用序列，并在多轮循环中根据真实执行结果继续决策。
| 能力 | 说明 |
|---|---|
| 内置助手 | 工作流设计、自动执行、桌面脚本、通用对话 |
| 模型接入 | Ollama、DeepSeek、Cursor、自定义 OpenAI 兼容 Provider |
| 多轮执行 | 解析 bizapi-exec → 执行 API → 回灌 data → 模型总结或下一步 |
| 截图分析 | captureMonitorApi + chatAiCompleteApi，视觉模型描述屏幕 |
| 消息通道 | 钉钉 Stream、飞书 WebSocket，IM 触发 AI 回复 |