Files
Artemis-Plugins/README.md

6.2 KiB
Raw Permalink Blame History

Artemis Plugins

ARTEMIS 3.x 使用独立测试分支 codex/rust3-plugin-market 和 catalog-v5.json,包含 Cua 0.38.0+artemis.2、任务人工评审 1.1.1、device-test 0.5.0+artemis.7。三个新版本各自记录验证范围;device-test 使用独立 Python worker。构建输入、来源和下载校验要求见 3.0 测试市场说明。下文保留对应 2.x 发行的历史说明。

ARTEMIS 的插件市场。配套 ARTEMIS 2.2.0 发布的电脑控制插件为 Cua 0.38.0+artemis.1,支持 Windows x64,通过窗口截图与可访问性树操作电脑应用和浏览器窗口,复用 ARTEMIS 的调度、资源互斥、步骤、截图附件和录像。

在 ARTEMIS 的「插件」页面安装「电脑控制 · Cua」,授权并启用即可。安卓任务可根据提示词按需调用电脑控制,不需要单独配置 Codex MCP 或安装 Go、Node、Python。

从 OCU 切换

Open Computer Use(OCU)已从市场索引下架,电脑控制使用 Cua。已安装 OCU 的用户请先安装并启用 Cua,再停用 OCU,避免同一任务加载两套电脑控制工具。排队、暂停或运行中的任务结束后再切换。

旧插件的源码、发行附件、历史任务与证据继续保留。下架不会删除用户的已安装版本,也不会替其他用户自动授权新插件。需要复核旧任务时仍可按其固定版本处理。

验证范围

本版本固定上游 Cua Driver 0.38.0,增加 ARTEMIS 窗口归属与焦点适配、已知无标题 Shell/菜单兼容补丁,修正滚动重复缩放。插件继续标注开发预览,升级内容见发行说明。

此版本通过 Go 检查与构建、菜单/任务栏 9 次调用、隔离 Brave 表单 38 次调用验证,并参与 2.2.0 仅 PC 与跨端集中回归。旧版窗口录像、对照与性能记录保留各自版本范围,不计为新版重测。复杂控制台、多 DPI、多显示器与混合长程任务仍需进一步验证,详见验证记录。

适配修订另覆盖应用名发现、浏览器键盘与中文输入、截图缩放与坐标校验,以及前台激活后保持目标可见。Cua 需要前台输入时会占用用户桌面,不提供与用户操作互不干扰的执行环境;复杂业务是否通过仍以任务实际证据为准。

构建与验证

当前发布源码为 0.38.0+artemis.1。构建机需要 Python、Go、Rust 与 Windows C++/Spectre 依赖;最终用户只安装 ZIP。准备固定上游源码并应用包内兼容补丁后,从官方发行下载 cua-driver-rs-0.38.0-windows-x86_64-binary.zip;脚本校验来源后构建,不执行全局安装器,详见构建说明。

python scripts/build_cua_driver.py <上游ZIP> --upstream-source <已应用补丁的上游源码目录> --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+artemis.4,发行标签 cua-driver-v0.36.0+artemis.4;当前源码候选为 0.38.0+artemis.1,对应上游标签 cua-driver-rs-v0.38.0。只修改 ARTEMIS 适配而未升级上游时使用 +artemis.N 后缀区分不可变安装包;包内 provenance.json 记录上游提交、原包校验值和适配修订,构建会检查版本对应关系。

发行说明 · ARTEMIS 主项目

工作区扩展:任务人工评审 1.1.0

task-review 使用 ARTEMIS 清单版本 3,为任务回放增加原始用例与人工评审侧栏,支持自动保存和上一条/下一条,并将选填结果写入报告。此插件不运行 MCP 或设备操作,需要 ARTEMIS 2.4.0+,在主程序插件市场安装并启用;2.2.x 尚不支持。

构建:python scripts/build_task_review.py。输出 ZIP 与校验文件位于 artifacts/task-review/。验证范围见 VERIFICATION。发行标签 task-review-v1.1.0,市场安装包与 SHA256 以 catalog-v4.json 为准;catalog.json 保留给 2.2.x。

家庭安防多工具测试 0.5.0+artemis.6(预览)

artemis-device-test 提供环境自检、用例路由、媒体/抓包/串口、设备协议及联合证据工具。仅声明 Windows x64;需要已安装 MCP、dotenv 的 Python 和对应外部工具/驱动,按部署说明配置。纯电脑任务还需选择 Cua 等已授权视觉插件;固件写入默认关闭。

本修订统一子进程生命周期并纠正未知执行的回执。134 项单元测试通过,正常 ARTEMIS 离线证据任务 5/5 通过,完成暂停恢复与报告导出核验;真实固件升级、设备发现、抓包、串口及全部 357 条业务用例未测,详见审查记录。原资料按公司市场分发授权记录,适配层 Apache-2.0。

构建:python scripts/build_device_test.py --ref <固定提交>。输出 ZIP、SHA256 和源码提交记录位于 artifacts/device-test/;发行标签 artemis-device-test-v0.5.0+artemis.6。安装包与校验值以对应市场索引及不可变发行附件为准。