OpenAdapt
将界面操作演示编译成可验证、可本地执行的确定性工作流。
README 明确描述最小化能力安装、客户控制的运行边界、原始录制默认留在本地、工件须经脱敏及逐字节批准方可越界，并规定重大操作前置身份、状态和目标检查，无法确认时停止。CI 权限受限，依赖审查和 CodeQL 动作均固定到提交。扣分在于关键执行机制位于未提供的 openadapt-flow，隐私清理是可选 extra，人工确认并非所有写操作的强制默认；所述回滚主要针对修复版本，未证明业务侧操作可撤销。维护者、作者、许可证及图片来源清楚，但发布者企业身份仍未验证。
README、pyproject 和安全策略对 Beta 生命周期、Python 3.10–3.12、启动器角色及维护路径保持一致。依赖具有兼容范围并按平台拆分，但核心执行依赖外部 openadapt-flow，浏览器首次使用还需下载 Chromium，FFmpeg 需另行配置，因此离线和环境可用性并非完全自包含。报告文件和精确非成功结果有所说明，但没有提供当前启动器或引擎的错误处理代码来证明消息覆盖全面。
材料清楚区分浏览器、原生桌面、RDP、Citrix/VDI，以及本地、客户控制和托管模式，并为开发者、敏感数据部署和合作伙伴交易给出场景。能力边界、成熟度、API 优先原则、精确环境资格认证和可选依赖都写得具体。满分依据是静态材料对适用场景、触发条件和环境适配的覆盖充分；这不等同于已执行验证。
README 结构清晰，包含快速开始、录制流程、产品差异、部署模式、项目地图、研究与遗留边界以及支持渠道。安装命令、平台引号差异、可选 extra 和首次浏览器下载均有说明；统一 CLI、兼容 extra、仓库职责和旧版冻结也支持命名稳定性。MIT 文本完整，版本号和语义发布配置明确，维护及私密漏洞报告责任清楚。扣分在于没有独立 FAQ，且虽引用并打包 CHANGELOG.md，所给材料未包含其内容，无法评估更新记录质量。
输出被设计为可检查的 bundle、可视化图、lint 结果、REPORT.md、receipt.json 和明确的 VERIFIED 或停止结果，直接服务于 UI-only 工作并强调独立效果验证。相较普通点击自动化，其增量价值描述具体。扣分在于成本收益证据仅为 README 中的命名基准和客户案例摘要，未附本次材料内的方法、资源消耗、部署成本或完整结果数据。
多数主张被映射到具体产物、配置、资格认证边界或命名案例，并明确区分合成教程、生产认证、研究包、遗留代码和当前产品；对推断与事实的分离尤其谨慎。README、pyproject、工作流和许可证可交叉印证包装、版本、平台和治理信息。扣分在于核心编译器、运行时、符合性测试、锁文件、CHANGELOG、基准方法和案例材料均未提供，安全及零模型调用等核心产品主张主要仍是 README 声明。
- 当前仓库主要是启动器和兼容层；核心编译、治理运行时、修复和符合性测试位于未提供的 openadapt-flow，因此不能从这些文件独立审计关键安全保证。
- “健康运行零模型调用”、身份门控、效果验证和失败关闭均未在所给实现代码中得到验证；不要把静态声明视为运行证明。
- 生产部署前应验证精确的应用版本、身份契约、效果验证器和故障案例，并确认任何托管元数据或工件的实际跨界内容。
- 隐私清理是可选依赖，业务操作回滚能力也未建立；敏感或不可逆流程需要额外的数据治理与恢复控制。
- 遗留测试会调用 Anthropic 和 Google 模型，但 README 将 legacy 标为冻结且非受支持产品路径；部署和测试发现应确保不会误纳入该遗留树。
这个 Agent 能做什么，适合哪些场景？
OpenAdapt 面向只能通过图形界面完成、又需要可靠结果证明的业务流程，可覆盖浏览器、Windows、macOS、Linux、RDP 与 Citrix/VDI。此仓库是旗舰入口，提供 `pip install openadapt`、统一的 `openadapt` CLI 和兼容层；实际编译器、受治理运行时及一致性测试位于 `openadapt-flow`。它把一次操作演示编译为可检查的工作流包，在健康运行中不调用生成式模型，并通过独立接口、只读会话或重新读取持久化状态来验证业务结果。运行会生成操作、证据、结果和停止原因报告，以及保护隐私的本地回执；无法确认身份、目标、授权或效果时会停止等待审查。它既可本地或自托管，也可运行在客户控制的敏感环境中；托管执行主要面向获准的浏览器及非敏感流程。项目处于 Beta，真实部署仍须针对具体应用、版本、环境、身份规则和效果验证器进行资格验证。
端到端流程由 openadapt flow record、openadapt flow compile 和 openadapt flow replay 组成：先从 Web、本机桌面、RDP 或 Citrix 可见界面记录人工操作及目标证据，再将记录编译为包含可移植意图和环境绑定的工作流包，最后在指定界面上确定性重放。编译器保留结构、无障碍、视觉、OCR、空间关系和状态转换证据；运行时根据执行表面选择最强的可用信号。关键写入前可核对授权、工作流状态、记录身份、目标唯一性及最新界面，操作后等待界面稳定并验证声明的业务效果。openadapt flow visualize 可生成工作流图，openadapt flow lint 可检查部署缺口。快速教程输出 recording/、bundle/、run/REPORT.md 和 run/receipt.json；健康结果为 VERIFIED，不需要模型或云端调用。若明确允许，生成式模型只能提出受治理的修复候选；修复须版本化，并可审查、测试、发布和回滚。
- 医疗或其他敏感行业的运营团队需要在没有合适 API 的旧系统中执行写入，并通过独立只读接口确认记录确已保存。
- 企业自动化团队需要从客户控制的运行器操作 RDP、Citrix 或 VDI 应用，同时避免在远程会话内部安装 OpenAdapt。
- 合规要求较高的团队希望自动化在身份、目标或结果不确定时停止，而不是让通用计算机操作模型猜测下一步。
- Windows、macOS 或 Linux 桌面应用维护者希望把人工演示编译为可检查、可重放的本机界面流程。
- 浏览器流程团队需要在 Chromium 应用中结合 DOM、无障碍、视觉与 OCR 证据执行并验证事务。
- 软件或服务提供商需要通过 OpenAdapt Execute 在已资格验证的客户环境中完成一个明确授权的事务，并异步获取
VERIFIED或精确的非成功回执。
这个 Agent 有哪些优点和局限？
- 健康运行采用确定性执行且不调用生成式模型，降低模型波动直接影响关键业务操作的风险。
- 将点击是否送达与业务效果是否成立分开验证，可通过独立接口、只读会话或持久化状态复核后才报告
VERIFIED。 - 采用失败关闭策略：授权、身份、目标唯一性、状态或效果无法确认时保留证据并停止，而不是猜测。
- 同一工作流模型覆盖浏览器、本机桌面、RDP 与 Citrix/VDI，并允许原始记录和实时观察默认留在本地。
- 工作流包、图形、检查结果、运行报告和隐私安全回执均可检查，修复也具有版本、审查和回滚流程。
- 项目生命周期为 Beta；每个真实流程都必须针对确切应用、版本、环境、身份合同和效果验证器单独资格验证。
- 此仓库只是安装器、统一 CLI 和兼容入口，核心编译器与运行时开发位于另一个
openadapt-flow仓库，维护者需理解跨仓库边界。 - 浏览器能力首次使用需要下载匹配的 Chromium；本机自动化还要安装操作系统专用的 Windows UI Automation、macOS Accessibility 或 Linux AT-SPI 能力。
- RDP、Citrix/VDI 和本机桌面的证据成熟度取决于具体任务与环境，Citrix 的 ICA/HDX 真实环境资格验证尤其属于部署特定工作。
- 快速教程使用合成 MockMed 数据，公开的 20/20 基准和客户收益仅适用于其命名任务与环境，不能直接外推到新部署。
如何安装或部署这个 Agent？
需要 Python 3.10–3.12。浏览器教程安装命令为 python -m pip install --upgrade 'openadapt[browser]'；Windows cmd.exe 使用 python -m pip install --upgrade "openadapt[browser]"。本机或远程场景按需安装能力：python -m pip install "openadapt[capture]"，或加入 windows、macos、linux、rdp；需要清理 PII/PHI 时安装 python -m pip install "openadapt[privacy]"。浏览器首次执行会下载匹配的 Chromium。本地快速教程不需要账户、API 密钥、目标应用或操作系统自动化权限；真实桌面和远程部署的权限取决于所选界面能力及资格验证边界。
如何使用这个 Agent？
安装浏览器能力后运行 openadapt quickstart。它会在 MockMed 合成环境中记录、编译、认证并按 Standard 配置执行教程流程，成功时返回 VERIFIED。随后运行 openadapt flow visualize openadapt-quickstart/bundle --out graph.html 和 openadapt flow lint openadapt-quickstart/bundle 检查程序与部署缺口。实际 Web 流程可依次执行 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。生产使用前还需定义应用边界、操作风险、身份、效果验证器、故障场景与部署策略；快速教程本身不构成生产认证。
这个 Agent 与同类方案有什么区别？
若目标系统提供合适的受支持 API，应优先使用 API；OpenAdapt 专门处理接口不可避免且需要结果证明的 UI 工作。与依赖通用计算机操作模型逐步决策的方案相比，它把一次演示编译成确定性程序，健康路径不调用生成式模型；模型只能在明确许可下提出受治理的修复候选。代价是每个应用环境和业务效果都要单独建立资格验证合同。
常见问题
本地运行是否需要 OpenAdapt Cloud 或模型 API 密钥？
openadapt quickstart 无需账户、API 密钥或云端调用，健康执行也不调用生成式模型。Cloud 是用于托管运行、机群治理、计费和企业集成的商业控制平面。