很多企业的自动化项目，第一眼看起来都“成功”了：浏览器点到了按钮，页面弹出绿色提示，流程也没有报错。月底一查，系统记录却没写进去，或者重复写了两次。真正难的不是让电脑完成点击，而是确认业务结果真的落账。
如果旧后台没有 API，企业不一定要立刻重写系统，也不应该直接把真实账号交给一个“会点网页”的 Agent。更稳妥的顺序是：先选一个低风险任务，录制一次，编译成可读的流程包，重放后从独立的 system of record 回读结果，再决定是否扩大。
本文依据 OpenAdapt 官方仓库与 README、官方 pyproject.toml、MIT LICENSE 和 v1.16.0 Release 整理。我们没有在本机安装、下载 Chromium、运行 quickstart 或录制真实流程；命令和回执均标为官方说明。
OpenAdapt 先解决什么问题
OpenAdapt 的官方定位不是“让模型自由操作所有软件”，而是把一次 GUI 演示编译成确定性、可在本地执行的程序。健康运行不把模型放在执行回路中；运行结束前，还要对照独立系统记录检查声明的业务效果。
这对旧系统尤其重要。页面出现“保存成功”只能说明界面画了一个状态，不能证明数据库、订单表或后台记录已经更新。一个值得交接的流程至少要回答四件事：写了哪条记录、由谁的身份写、写入后从哪里读回来、读不到时谁有权暂停。
官方最低安装与 quickstart
官方 pyproject.toml 要求 Python >=3.10,<3.13，也就是 Python 3.10、3.11 或 3.12。基础安装路径为：
python -m pip install --upgrade openadapt
openadapt quickstartREADME 写明，基础 quickstart 不要求账号、API Key 或额外包；第一次浏览器动作会自行下载 Chromium。官方示例在 MockMed 合成练习 fixture 中完成记录、编译、认证、执行和只读回查，示例回执包含：
VERIFIED in 4.1s; 0 model calls
VERIFIED: openadapt-quickstart/run/REPORT.md
effects 2/2 confirmed at evidence tier 1 (independent system of record)这里的秒数、模型调用数和记录数量都属于 README 的示例环境，不能改写成本机性能或企业结果。基础包之外，原生桌面、RDP、Windows UI Automation、macOS Accessibility、Linux AT-SPI 和隐私清洗等能力需要按目标环境安装相应 extras。
录制、编译、重放：一条流程的官方路径
真实 Web 流程的 README 示例是：
openadapt flow record --backend web --url https://your-app.example --out rec
openadapt flow compile rec --out bundle --name my-workflow
openadapt flow replay bundle --url https://your-app.example --run-dir run这三步不等于“任意后台都能稳定运行”。录制前先写清应用边界、身份、动作风险、目标唯一性和效果字段；编译后检查 bundle 是否包含这些契约；重放后从独立记录读取，不要只看页面颜色或成功横幅。openadapt flow visualize 可以帮助审阅图形化流程，openadapt flow lint 可以检查编译内容和未覆盖的条件。
企业试点应按什么顺序做
第一轮建议使用合成或公开 Web 表单，不接客户真实账号、不改真实业务数据：
- 选一个任务：例如测试环境中的新增记录、报表录入或内部样品归档。
- 列出效果字段：明确什么记录变化才算成功，如何识别重复写入。
- 固定身份与权限：写下运行者、批准者、暂停者和目标系统的最小权限。
- 录制并编译：保留原始录制、bundle 版本、目标环境和回滚点。
- 重放并回读：执行后用独立只读接口或人工核对确认记录真的存在。
- 制造一个失败分支：让页面显示成功但记录不落账，确认运行会停下。
- 做停止决定：根据错误类型、维护成本和业务方反馈决定继续、缩小边界或停止。
失败状态不能混写
README 把不同结果分开命名：
VERIFIED：声明的效果和旁作用检查都通过，才是生产意义上的成功。HALTED_BEFORE_EFFECT：在产生后果前安全停止，并有证据表明没有发生业务效果。RECONCILIATION_REQUIRED：状态冲突、交付不确定或暂时无法核对，必须重新读取现场，不能盲目重试。FAILED_PLATFORM、CANCELED、REJECTED_POLICY、COMPLETED_UNVERIFIED和ROLLED_BACK：分别说明平台失败、主动取消、策略拒绝、只有演示完成但缺少生产级证据，或重复/旁作用已补偿并重新核验。
其中最容易被忽略的是 RECONCILIATION_REQUIRED。如果页面说成功、独立记录却查不到，正确动作不是再点一次，而是保留证据、暂停流程、让负责人重新核对目标记录和权限。把不确定状态写成成功，后续的重复写入和责任追踪都会更难。
七天验证一条可停止流程
| 天数 | 动作 | 需要留下的证据 | | ---: | --- | --- | | 1 | 选合成或公开 Web 任务 | 唯一目标和不做什么 | | 2 | 列动作、身份、权限和效果字段 | 业务负责人确认 | | 3 | 按官方命令安装 | Python、版本、Chromium 状态 | | 4 | 录制、编译、重放一次 | bundle、运行目录和回执 | | 5 | 制造页面成功但未落账 | 停止状态与人工核对记录 | | 6 | 给三位潜在买方看样品 | 是否愿意提供脱敏流程 | | 7 | 做停、缩小或继续决定 | 维护成本和下一步 |
这张表的目的是缩短试错，不是承诺七天交付生产系统。真实系统的页面改版、验证码、网络波动、权限变化、效果接口和数据权利，都要在目标环境重新验收。
交接前的八项清单
- 一个明确的流程边界，以及明确不做的动作；
- 动作、身份、权限和目标记录的唯一性；
- 独立 system of record 的读取方式和证据等级；
- 页面改版、网络异常和失败分支的处理方式；
- 凭据、审批、日志和运行权限的归属；
- 回执、版本、原始录制和 bundle 的留档位置；
- 停用、回滚、重复写入保护和人工接管步骤；
- 客户资料、模型/第三方服务条款和持续维护成本。
本地、客户控制和托管边界
官方 README 区分 Local / self-hosted、Customer-controlled 和 Managed execution。原始录制与现场观察默认留在本地；只有经过显式清洗和逐字节批准，产物才跨越边界。企业不能因为“本地运行”四个字，就推断目标系统、远程桌面、模型或日志都没有离开自己的控制范围。
如果目标是桌面应用、RDP、Citrix 或私有网络，需确认对应 adapter、屏幕/窗口范围、凭据隔离和回读证据。基础 quickstart 的浏览器样例不能代替这些环境的资格验证。
适用边界与服务入口
OpenAdapt 适合操作固定、风险可控、效果可读取、有人负责的流程小样；不适合没有数据负责人、无法定义业务效果、要求一次上线永远正确，或尚未取得目标系统授权的项目。流程梳理、录制/编译、目标环境适配、验收、回执巡检和版本维护可以成为服务项，但本文没有价格、客户、订单、节省比例或收入证据。
上海煜企智能科技有限公司可协助上海及周边企业梳理流程边界、搭建低敏感样品、设置独立效果校验和交接文件。具体系统、身份、数据权限、第三方条款与服务范围，仍要以企业审批、官方文档和目标环境实测为准。