SuperAPI AI 工具集

test-mac-app-control

测试与质量

查看项目

更新于 11-04 00:38

技能介绍

该技能用于修改 Mac 应用观察、后台输入、owner 查看或 helper wire 契约时,指导运行相匹配的测试。

用途:帮助开发者在改动 Opensteer 桌面端计算机使用相关代码后,选择覆盖该改动且成本最低的测试路径,包括单元测试、协议测试、Web 测试和 VM 端到端验证。

主要能力:

  • 列出按层面划分的测试命令:Swift 包 ComputerUseCoreTests、Host 的 computer-repl Vitest、protocol 的 computer-use-helper-wire 与 action schema 测试、@opensteer/web 的 computer-windows 测试。
  • 提供 VM 真实旅程命令,覆盖 AppKit/Electron owner 输入与解码 H.264。
  • 支持环境变量 OPENSTEER_MAC_OWNER_VIEW_ONLY_JOURNEY=1 做基线被动检查,OPENSTEER_MAC_OWNER_ENGINES=appkit 指定单一引擎。
  • 说明后台按键场景参考 ChromeBackgroundJourney fixture README,并建议扩展现有流程而非复制。
  • 说明仅在有意变更契约时用 OPENSTEER_WRITE_WIRE_FIXTURE=1 重新生成 wire fixture 并检查 diff。

使用方式:从仓库根目录运行;按改动选择命令;核心测试保持完全虚构,不驱动宿主窗口、焦点或输入;真实交互在 VM 中执行;跳过或部分通过的用例视为未验证;启动的所有进程(包括失败时)都要停止;发布路径改动需通过签名 helper 与 renderer 验证真实带标题的 AppKit/Chromium 窗口,并检查首次运行 TCC、本地化 Services 和挂起应用;真实 Contacts/EventKit 与 Apple 账户 Messages 行为需安排人工确认,不得将个人数据存储用作无人值守测试 fixture。

适用场景:Mac 应用控制相关代码的测试与发布前验证。

限制:原生 fixture 成功不能证明 Host/Runner 路由或签名责任进程归属;VM 基础设施与发布流程需参考仓库现有测试与发布文档;具体通过标准与后续发布步骤暂未提供。