chore(release): prepare 2.6.0 with bundled Android helper
This commit is contained in:
1 parent
dc3a48f6b2
commit
73adcf25a7
8 files changed
+69
-9
No files matched your search
@@ -0,0 +1,44 @@
|
||||
# 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-native-actions.md)。
|
||||
|
||||
## 助手与发布包
|
||||
|
||||
- 随包 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 的暂停后稳定读数。详细范围及保留的失败样本见[开发验证记录](../plans/2026-11-02-native-actions-validation.md)。这不代表所有设备、OEM 或自绘时间轴均可达到同样精度。
|
||||
- 本次发布不新增设备业务任务或付费模型测试;没有原生范围的时间轴仍需手势、实际刻度和稳定读数配合,工具输入完成不等于业务验收通过。
|
||||
|
||||
## 升级
|
||||
|
||||
已有安装等待任务结束后运行 `update-cn.bat` 或 `update.bat`,然后重启 ARTEMIS;Codex 用户重新加载 MCP。新安装下载 `artemis-2.6.0-source.zip`,按 `SHA256SUMS.txt` 校验后解压启动,不直接覆盖正在运行的安装目录。
|
||||
Reference in new issue
Block a user