FlowOnce 桌面操作录制引擎

它解决什么问题

macOS 上大量重复操作——提 PR、在企业微信里回消息、按固定流程改代码——要么靠人肉重做，要么写脆弱的自动化脚本。坐标点击类工具换个分辨率就可能失效，让 AI 从零生成自动化又缺少真实的操作上下文。FlowOnce 的解法是：你演示一遍，它把操作流编译成结构化的 Workflow IR，再生成可复用的便携技能，后续一句话就能触发回放。

核心工作流

• 录制：event_stream_start 开启事件流，原始操作以 JSONL 写入系统临时目录——不截图、不录音、不读剪贴板。
• 归一化与编译：recording_normalize 清洗原始事件，workflow_compile 产出 Workflow IR 草案。
• 审查：演示中出现的收件人、文件路径、搜索词被识别为候选输入（变量）而非写死；密码、Token、验证码替换为 {{PASSWORD}} 等命名占位符；发送消息、删除、付款、系统设置变更等步骤标记 requiresConfirmation: true。
• 生成与验证：skill_generate 支持 portable / workbuddy / codex 三种 target。验收标准是生成的技能能用变化后的安全输入成功复现一次，失败最多自动修订两轮。

控件定位基于 Accessibility 的 role/title/identifier 而非坐标，跨分辨率回放更稳，且能捕获窗口切换、应用激活等跨应用事件。默认走置信度审查，也可切换严格/快速模式。

适用边界

• 仅支持 macOS，依赖 Accessibility API，首次使用需完成系统授权；回放还要求宿主具备可用的执行后端，否则技能会被保留但标记为未验证。
• 全屏独占游戏、3D 渲染窗口、语音操作不在范围内；录制与回放都在本机，不支持云端远程执行。
• FlowOnce 只负责录制与编译，不会替你编写技能业务逻辑。
• 组件本身无上传、遥测与后端；宿主如何处理读到的事件，取决于宿主自身的数据策略。