3.6 KiB
Artemis Plugins
ARTEMIS 2.0.0 的插件市场。当前电脑控制插件为 Cua 0.36.0+artemis.4，支持 Windows x64，通过窗口截图与可访问性树操作电脑应用和浏览器窗口，复用 ARTEMIS 的调度、资源互斥、步骤、截图附件和录像。
在 ARTEMIS 的「插件」页面安装「电脑控制 · Cua」，授权并启用即可。安卓任务可根据提示词按需调用电脑控制，不需要单独配置 Codex MCP 或安装 Go、Node、Python。
从 OCU 切换
Open Computer Use（OCU）已从市场索引下架，当前市场只提供 Cua。已安装 OCU 的用户请先安装并启用 Cua，再停用 OCU，避免同一任务加载两套电脑控制工具。排队、暂停或运行中的任务结束后再切换。
旧插件的源码、发行附件、历史任务与证据继续保留。下架不会删除用户的已安装版本，也不会替其他用户自动授权新插件。需要复核旧任务时仍可按其固定版本处理。
验证范围
本版本沿用 Cua 0.1.2 候选的驱动与动作实现，固定上游 Cua Driver 0.36.0 预发布版，继续标注开发预览。
已测试原生窗口表单、34 像素视觉目标、滚动、截图保存、ARTEMIS 窗口录像和子进程退出。对照测试独立验收 3/3 完成；ARTEMIS AI 裁定为 2 次通过、1 次未判定。浏览器复杂控制台、多 DPI、多显示器与安卓混合长程任务仍需进一步验证，详见 验证记录。
适配修订另覆盖应用名发现、浏览器键盘与中文输入、截图缩放与坐标校验，以及前台激活后保持目标可见。Cua 需要前台输入时会占用用户桌面，不提供与用户操作互不干扰的执行环境；复杂业务是否通过仍以任务实际证据为准。
构建与验证
构建机需要 Python 和 Go；最终用户只安装 ZIP。从固定上游发行下载 cua-driver-rs-0.36.0-windows-x86_64-binary.zip，构建脚本校验 SHA256 后打包，不执行全局安装器。
python scripts/build_cua_driver.py <上游ZIP> --go <Go可执行文件>
python tests/cua_smoke.py <安装后的artemis-cua-adapter.exe> artifacts/cua-smoke
python tests/cua_fixture_validation.py <安装后的artemis-cua-adapter.exe>
python tests/cua_discovery_smoke.py <安装后的artemis-cua-adapter.exe> --app Brave --output artifacts/cua-discovery.json
验证脚本使用已安装 ARTEMIS 依赖的 Python，并将 ARTEMIS 源码目录放入 PYTHONPATH。前两项实测只操作自行创建的测试窗口；窗口发现实测只读取指定的已打开应用，不改变其页面。历史 A/B 脚本仍固定 OCU 1.1.0 与 Cua 0.1.2，便于复现已有测量；它不是安装后必须执行的步骤。
catalog.json 是市场索引，包含清单、HTTPS 安装包地址、SHA256 和验证说明。artifacts/ 保存本机安装包与测试资料，不进入 Git。版本文件不可原地覆盖，任务固定使用其启动时的版本。
插件版本跟随所用 Cua Driver 上游版本：当前为 0.36.0，对应上游标签 cua-driver-rs-v0.36.0，当前适配修订为 0.36.0+artemis.4，本仓库发行标签为 cua-driver-v0.36.0+artemis.4。只修改 ARTEMIS 适配而未升级上游时使用 +artemis.N 后缀区分不可变安装包；包内 provenance.json 记录上游提交、原包校验值和适配修订，构建会检查版本对应关系。