• v2.6.0 73adcf25a7

    ARTEMIS 2.6.0 Stable

    chenmingxuan released this 2026-11-03 14:20:01 +08:00 | 4 commits to main since this release

    ARTEMIS 2.6.0

    本版汇总正式 2.5.0 之后的 Android 原生动作、连续多指手势与精确操作反馈改进。Flash、普通 Pro 和探索共用这些能力,外层任务提交接口保持兼容;CUA 插件保持现有版本,本次不接入 agent-desktop。

    原生控件与连续手势

    • 新增 read_control,读取控件支持动作、范围、当前值、状态、选区与身份 token;新增 control_action,执行控件实际支持的点击、长按、聚焦、原生设进度、文本编辑和 IME 提交。不支持的动作明确拒绝,不自动回退坐标输入。
    • 新增只读条件等待 wait_until,支持出现、消失、可用、状态、文本、数值及持续稳定。短暂不可读在原定预算内继续观测,读取失败不能证明控件消失。
    • 新增 scroll_to,在指定唯一容器内有界查找目标;等待内容停稳,无进展、到达边界、失败或取消时停止。
    • 新增 pinch 双指缩放/旋转与 touch_gesture 连续多指轨迹,支持 1~5 指、分段移动与按住停留。多段/多指动作需要 Android 8.0/API 26 及以上,按助手实际能力启用。
    • 动作序列可组合原生动作、条件等待与手势。输入前校验整组,部分失败后保留已完成、取消或结果不明的动作,不重放整组。前端、报告动作摘要和截图标注补齐简体中文名称。

    状态确保与数值反馈

    • control_action.ensure_state 支持勾选、选中、精确文本/描述及数值条件。已满足时跳过;未满足时只操作一次并回读验证,避免盲目切换状态。
    • 拖动与动作序列可绑定真实控件的数值或时钟 feedback,返回前后读数、残差和容差结果;等待连续稳定后判断。手势已完成但读数不符时保留实际输入回执,不自动重发。
    • 同一目标和策略连续两次没有降低误差后,第三次拒绝继续输入并要求重新观察或调整策略。此保护依赖显式反馈,不能自动理解所有自绘控件。
    • 手势可限制在已观察的 region 内;刻度校准补充像素取整误差与最小有效距离检查。双指跨度倍数不等于 APP 比例尺倍数,仍需读取实际刻度和最终值。
    • 验收允许采用明确绑定当前选时、暂停后持续稳定且与固定指针一致的常驻秒级读数。录像卡片、水印、临时浮层、来源不明或真实证据冲突仍不能作为通过依据;不会改写原有历史任务结论。

    多窗口查询与稳定选择器

    • 修复观察接口能看到控件、原生接口却只查询 active 空壳窗口的问题。查询在当前前台 APP 的相关窗口中有界解析,跨根仍须唯一,不扩大到后台应用。
    • 写入前检查目标可见区域及高层窗口遮挡;完全遮挡时拒绝。Android 11/API 30 及以上使用精确可触区域,旧系统保留矩形近似限制。
    • 观察结果新增可直接复制的 native_selector,优先绑定资源 ID、类名和包名;重复或缺失 ID 时补充原始像素边界,避免把变化中的读数当作身份。
    • 原生选择器边界使用 Android 原始像素,列表手势边界使用 0–1000 归一化坐标,两者不能混用。NOT_FOUND 只表示本次没有匹配,不能据此断言控件没有原生语义。

    完整参数、回执及时间轴使用边界见安卓原生动作说明。

    助手与发布包

    • 随包 Android 助手为 1.3.0 / protocol 3 / versionCode 15。连接时依据已有助手安装设置及能力声明进行检查;旧后端不支持时不暴露新动作,也不会把原生写请求改投其它后端重放。
    • 修复源码 ZIP 将随仓库提供的助手 APK 排除的问题:只保留指定运行载荷,其它 APK、构建目录、签名密钥、用户配置和运行资料继续排除。最终包验证会核对助手文件与 manifest 的 SHA256。
    • 主程序与前端根版本升级到 2.6.0;远程 Python SDK、市场插件及第三方依赖不升版。保持用户已保存的模型、接口、重试与功能配置。

    验证范围

    • 发布前默认 Python 回归、Ruff、质量基线、核心类型检查,以及同一个最终 ZIP 在独立空 npm 缓存下的官方源/国内镜像安装、前端测试与生产构建,实际结果随附件 INSTALL-VERIFICATION.md 提供。不会将历史测试数量当作本次验证。
    • 此前开发验证在 Android 模拟器上完成原生 Activity、连续触摸、取消与窗口解析回归;三次独立 Flash 时间轴定位取得 −3s、−3s、+1s 的暂停后稳定读数。详细范围及保留的失败样本见开发验证记录。这不代表所有设备、OEM 或自绘时间轴均可达到同样精度。
    • 本次发布不新增设备业务任务或付费模型测试;没有原生范围的时间轴仍需手势、实际刻度和稳定读数配合,工具输入完成不等于业务验收通过。

    升级

    已有安装等待任务结束后运行 update-cn.bat 或 update.bat,然后重启 ARTEMIS;Codex 用户重新加载 MCP。新安装下载 artemis-2.6.0-source.zip,按 SHA256SUMS.txt 校验后解压启动,不直接覆盖正在运行的安装目录。

    Downloads