接入模型前，先测试 Computer Use API 的动作控制器

Computer Use 集成需要分别回答两个问题：模型能否返回支持的动作，应用能否执行动作并正确判断任务完成？本文先处理后者。下载包提供 Python 控制器与 19 项离线测试，不需要 API Key、浏览器会话或模型费用。

下载控制器源码。已在 Python 3.9.6 下通过测试，并从重新解压的副本复跑。附带的 run_live.py 没有实际执行或通过供应商联调；本文没有真实 API 截图、用量或端点兼容性结论。

先运行离线测试

Python 3.9 或更高版本的标准库即可。在 api-kit 目录执行：

python3 -B -m unittest discover -s . -p 'test_*.py' -v

其中 15 项测试控制器，四项检查接收记录。模型响应和运行时均为模拟，不启动浏览器、不请求网络。模拟截图占位字节并非有效图片，不能发给真实 API。

模型、执行器与验收分开

模型根据观察选择动作；执行器控制浏览器；验收逻辑独立检查应用结果。本例使用 落地页 QA 练习中的表单，输入每次唯一的 @example.test 地址。

开始前读取 /submissions，运行中继续比较：旧记录前缀必须完整不变，只能多出一条与本次地址匹配的记录。旧记录、重复提交或其他地址都不算成功，绿色提示也不够。这个规则只适用于练习表单，生产任务应采用自己的结果凭据，例如已保存的草稿 ID。

固定一种工具协议

参考代码依据 OpenAI Computer Use 文档中的结构化动作路径：先提交截图，接收 computer_call 的有序动作，执行支持的操作，再用匹配的 call_id 返回 computer_call_output 截图；后续请求携带 previous_response_id。

这些 ID 把观察与对应动作关联起来。只有截图而没有正确调用 ID，不能代替工具输出。官方文档是协议依据，不代表附带适配器已兼容某个具体模型。

真实联调前必须一起核对模型、端点和工具 schema。文本请求能成功，不代表该端点支持 Computer Use。示例不默认选择供应商或模型，也不声称 Ofox 端点兼容。

执行前检查动作

支持范围刻意收窄为左键点击、最多 200 字符的输入、指定单键、受限滚动与截图。坐标必须在当前截图范围内，布尔值、非有限数字和错误结构被拒绝。每次响应最多 12 个动作，默认最多四轮模型调用，未知动作停止执行。

每次响应只接受一个 computer call。重复调用 ID、未完成的响应和待处理安全检查会停止流程，不会自动批准。这不是支持全部工具动作或完整审批系统的通用实现。

控制器在每个动作前后检查完成条件，避免表单异步写入成功后还继续点击。参考浏览器适配器在点击或按键后短暂轮询接收记录。这些控制逻辑的本地测试不等于浏览器集成通过。

19 项测试说明了什么

覆盖错误动作结构、越界坐标、不支持的输入、调用与截图关联、轮数上限、重复调用、提前停止和精确记录变更。回归用例检查完成后不再执行同一批剩余动作，重复或错误地址不能通过验收。

对完成且有有效 ID 的响应，审计保留用量，包括没有动作的结束响应；动作失败时记录已尝试执行的动作。模拟用量不是实际账单。代码也不保证所有启动失败都会生成完整故障文件。

这些测试只验证所列本地逻辑，不证明模型准确率、视觉理解质量、浏览器可靠性或现实任务成功率。

真实运行还需要什么

run_live.py 使用全新的 Playwright Chromium 上下文、限制普通页面请求访问范围的来源白名单，以及显式配置的 HTTPS Responses 端点，不连接个人浏览器配置。白名单仅允许练习页面所在来源，页面来源异常或出现新标签时停止；这不是通用浏览器安全沙箱，适配器本身仍待联调。

依据 Playwright 文档在独立环境安装并记录实际版本。本次尚未验证并锁定真实联调所需的依赖版本。通过环境变量提供 COMPUTER_RESPONSES_URL、COMPUTER_MODEL、COMPUTER_API_KEY，不把密钥写入源码或压缩包。

执行须有浏览器与费用授权，不能绕过既有拒绝。每次用新地址和新输出目录，README 给出了带确认参数的调用形式。四次调用与输出 token 上限不是金额预算，还需核查供应商费率和账号端限额。超时仍可能计费，重试前先核对用量和接收状态。

用真实证据验收联调

保留模型 ID、端点主机、运行时版本、任务、脱敏响应、调用 ID、截图与接收结果，分享前检查敏感信息。另用干净环境和新合成地址重复一次，两次结果与实测用量分开记录。不能把不支持工具的失败悄悄换成纯文本输出后称为成功。

目前可以确认的是 19 项离线测试通过；真实供应商与浏览器连接仍需各自的验证证据。