技能介绍

解决什么问题

GUI 自动化脚本最大的痛点不是"写不出来"，而是写出来之后不可靠。一次录制的操作，在界面改版、控件位移或网络延迟之后就会静默走错路径，而且错在哪里很难追溯。工程团队需要的不是一段能跑的脚本，而是一套可审查、可判定、可中止的重放机制——知道这次运行是该被认证通过，还是该因为环境漂移而被拦下。

这个技能基于 OpenAdapt，把"演示一次、重放多次"变成有治理约束的工作流。

核心能力

单次演示即编译：人工完整演示一遍浏览器或受支持的 GUI 流程，系统将其编译为确定性的 replay bundle，后续运行不再依赖人肉操作。
漂移检测与判定：当界面元素发生变化时，不再盲目继续执行，而是依据认证策略输出可审查的报告，认证通过或中止运行，决策依据留痕。
可选隐私脱敏：通过 openadapt[privacy] 扩展接入 Presidio 支持的 PII/PHI 清洗，适合需要对外托管或共享的流程资产。
可选原生捕获：openadapt[capture] 扩展提供原生 GUI 捕获与录制能力，覆盖非浏览器环境。

关键步骤

准备环境：Python 3.10+、openadapt flow CLI，以及浏览器目标或受支持的 GUI 环境。
人工演示一遍完整流程，编译器将其整理为确定性 bundle。
为流程配置认证策略，明确漂移时的判定规则。
重放时由系统比对界面状态，输出可审查报告并执行认证或中止决策。

适用边界

launcher 要求 openadapt-flow>=1.7.0,<2，跨大版本升级前需确认兼容性；无头（headless）系统上的可用性取决于上游环境。
OS 密钥链令牌存储需要额外的 hosted 安装路径；纯环境变量令牌配置仍是替代方案。
托管场景下，工作流产物（如截图、DOM 记录）需预先脱敏，否则重放 bundle 本身可能携带敏感信息。
该技能是引导与治理层，底层能力以 OpenAdapt 上游文档为准。