@honor-claw/yoyo 2026.7.1-alpha.1 → 2026.7.1-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -4,7 +4,8 @@ description: >
|
|
|
4
4
|
启动基于 GUI 的应用操作任务（UI Agent），调用后立即返回 task_id，
|
|
5
5
|
需通过 task-result-query 轮询查询执行结果。用于在手机上对指定 App
|
|
6
6
|
发起一次独立的操控流程；单一 App 禁止拆分任务，多 App 或含条件的流程
|
|
7
|
-
|
|
7
|
+
需拆分为多次调用，且必须串行下发（等前一任务 isFinal=true 后再下发下一个，
|
|
8
|
+
设备同一时刻仅允许一个 GUI 任务，并发会被拒为 busy），续办需携带上次任务的 task_id。
|
|
8
9
|
---
|
|
9
10
|
|
|
10
11
|
# Gui Task Create GUI 任务创建
|
|
@@ -77,10 +78,16 @@ description: >
|
|
|
77
78
|
|
|
78
79
|
## 3. 业务规则
|
|
79
80
|
|
|
81
|
+
### GUI 任务全局串行约束
|
|
82
|
+
|
|
83
|
+
> ⚠️ **同一设备同一时刻只允许执行一个 GUI 任务**。若在上一任务尚未执行完成（未轮询到 `isFinal = true`）时再次调用 `gui.create`，设备会直接对后续任务返回 **busy** 状态码——这些任务会被拒收、不会执行。例如用户一次说出多个 App 的操作（如”用小红书搜…、在文件管理找…、在通讯录搜…、在 QQ 音乐收藏…”），拆解出的多个子任务只有第一个能执行，其余全部 busy 失败。
|
|
84
|
+
>
|
|
85
|
+
> 因此，凡需要多次调用 `gui.create` 的场景，**必须严格串行**：下发 task1 → 轮询 `task-result-query` 直至 `isFinal = true` → 才能下发 task2 → 再轮询至完成 → …依此类推。严禁并发下发，也严禁”仍在轮询前一任务时就提前下发后一任务”。
|
|
86
|
+
|
|
80
87
|
### 适用场景及操作流程
|
|
81
88
|
1. 针对单一 App 的任何 GUI 操作任务，禁止拆分任务，必须直接发起调用
|
|
82
|
-
2. 涉及多个 App
|
|
83
|
-
3.
|
|
89
|
+
2. 涉及多个 App 的连续操作需拆分为多个独立任务，**串行下发**：必须等上一个任务轮询到 `isFinal = true`（执行完成）后，才能发起下一个 `gui.create`（详见上方「GUI 任务全局串行约束」）
|
|
90
|
+
3. 涉及条件判断（如”若…则…”）时，将条件判断与执行任务拆分为两次调用
|
|
84
91
|
4. 若为对未结束任务的补充/修改/继续，需在请求中补充对应的 `task_id`（输入参数）
|
|
85
92
|
|
|
86
93
|
### 特定交互
|
|
@@ -84,16 +84,25 @@ metadata: { "openclaw": { "emoji": "🔄", "always": true } }
|
|
|
84
84
|
- 无法比较：输出 `插件更新命令已完成，但无法可靠确认最终版本，请稍后再次检查插件版本`，停止。
|
|
85
85
|
- 实际版本等于或高于目标版本：继续步骤 6。
|
|
86
86
|
|
|
87
|
-
|
|
87
|
+
**只有在插件确实存在可用更新且更新已成功完成（即走到本步骤的成功分支）时，才允许执行步骤 6 的网关重启。** 任何未更新、更新失败、版本未变化的分支都不得重启网关。
|
|
88
88
|
|
|
89
|
-
若实际版本高于步骤 2 获取的目标版本，在步骤
|
|
89
|
+
若实际版本高于步骤 2 获取的目标版本，在步骤 7 成功文案后追加：
|
|
90
90
|
|
|
91
91
|
说明：本次实际升级到 v{实际版本}，高于预检查获取的目标版本 v{目标版本}。
|
|
92
92
|
|
|
93
|
-
## 步骤 6
|
|
93
|
+
## 步骤 6：执行安全重启
|
|
94
|
+
|
|
95
|
+
插件更新完成后，必须主动执行网关安全重启（安装插件不再自动触发网关重启）。
|
|
96
|
+
|
|
97
|
+
- 执行命令：`openclaw gateway restart --safe`
|
|
98
|
+
- **`--safe` 参数不可省略**，不得执行裸 `openclaw gateway restart`、`openclaw gateway stop` / `start` 或任何其它重启方式。
|
|
99
|
+
- 重启会断开当前长连接，属于预期行为；执行前无需等待，执行后继续步骤 7。
|
|
100
|
+
- 命令执行失败时，不要改用其它重启方式，输出 `插件已更新完成，但网关安全重启失败，请在 OpenClaw 设备上手动重启网关生效插件`，停止。
|
|
101
|
+
|
|
102
|
+
## 步骤 7：输出完成结果
|
|
94
103
|
|
|
95
104
|
输出阶段 3 文案：
|
|
96
105
|
|
|
97
106
|
3. 插件更新完成
|
|
98
107
|
Claw 插件更新已完成
|
|
99
|
-
|
|
108
|
+
网关已重启，连接即将断开，稍等片刻后恢复...
|