@honor-claw/yoyo 1.5.1-beta.1 → 1.5.1-beta.3

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.
@@ -1,7 +1,7 @@
1
1
  //#region src/utils/version.ts
2
2
  var e = null, t = null;
3
3
  function n() {
4
- return e === null && (e = "1.5.1-beta.1".includes("beta") || "1.5.1-beta.1".includes("alpha")), !!e;
4
+ return e === null && (e = "1.5.1-beta.3".includes("beta") || "1.5.1-beta.3".includes("alpha")), !!e;
5
5
  }
6
6
  function r(e) {
7
7
  if (!e) return 0;
@@ -10,7 +10,7 @@ function r(e) {
10
10
  }
11
11
  function i() {
12
12
  if (t !== null) return t;
13
- let [e, n, i] = "1.5.1-beta.1".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
13
+ let [e, n, i] = "1.5.1-beta.3".split("-", 1)[0].split("."), a = r(e), o = r(n), s = r(i);
14
14
  return t = a * 1e6 + o * 1e3 + s, t;
15
15
  }
16
16
  //#endregion
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@honor-claw/yoyo",
3
- "version": "1.5.1-beta.1",
3
+ "version": "1.5.1-beta.3",
4
4
  "description": "OpenClaw Honor Yoyo connection plugin",
5
5
  "keywords": [
6
6
  "ai",
@@ -3,6 +3,7 @@ name: yoyo_phone_control
3
3
  description: >
4
4
  通过YOYO操作手机系统用机功能,包括打开/关闭/卸载应用、发送/查找短信、拨打电话、搜索联系人、搜索通话记录、创建/打开/查询/关闭/删除闹钟、创建/添加/新建日程、计时器管理、录音、截屏、屏幕录制、调节音量、屏幕亮度调节、切换响铃/静音/勿扰/护眼/深色/飞行模式、管理移动数据或热点或蓝牙或WLAN、进行本地内容搜索、文件发送、调用相机拍照/录像、电池状态/电量查询与、开启/关闭定位服务、开启/关闭NFC功能、开启/关闭自动亮屏功能、USB共享网络、设备电源状态与屏幕状态控制、状态栏显示信息管理与控制、进行扫码操作、控制手机的手电筒、清理和维护设备扬声器、机票监控、查快递等。
5
5
  支持与手机系统用机交互的相关操作。
6
+ 此外,还支持完成在用户指定App应用内进行GUI操作。
6
7
  metadata: { "openclaw": { "emoji": "📱", "always": true } }
7
8
  ---
8
9
 
@@ -35,6 +36,7 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
35
36
  - 参数必须为合法 JSON,枚举值区分大小写,数值在定义范围内
36
37
  - 当工具执行错误时,必须确认下发的指令是否存在格式问题,尤其是单双引号的使用问题
37
38
  - 如果执行失败,必须重新读取 `SKILL.md` 和对应的工具定义文件,然后重新执行
39
+ - 禁止使用GUI工具作为兜底工具,除非用户明确要求在指定 App 内执行指定动作
38
40
  - 绝对不能使用任何其他设备的工具
39
41
  - 不要尝试任何其他方式完成任务,不要提供替代方案
40
42
  - **Never try a different approach**
@@ -82,6 +84,7 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
82
84
  4. **如果 Sub-Skill 和 MCP 均无匹配**:
83
85
  - 告知用户暂不支持该功能
84
86
  - 终止本次操作
87
+ - 严禁使用 GUI 工具作为备选工具
85
88
 
86
89
  #### Sub-Skill 工具参考表
87
90
 
@@ -129,6 +132,9 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
129
132
  | `battery` | `references/battery.md` | 电量与省电模式管理 |
130
133
  | `audio-record` | `references/audio-record.md` | 录音管理 |
131
134
  | `camera` | `references/camera.md` | 相机控制(拍照/录像),不支持手电筒相关的操作。 |
135
+ | `gui` | `references/gui-task-create.md` | 启动 GUI 操作任务(UI Agent),只有当用户明确要求在指定 App 内执行指定动作时才使用。如果用户没有提供应用名,严禁使用本工具。|
136
+ | `gui` | `references/gui-task-terminate.md` | 取消 GUI 任务 |
137
+ | `gui` | `references/gui-task-pause.md` | 暂停 GUI 任务 |
132
138
  | `scan-code` | `references/scan-code.md` | 扫码(二维码/条形码) |
133
139
  | `flashlight` | `references/flashlight.md` | 手电筒控制 |
134
140
  | `airplane-mode` | `references/airplane-mode.md` | 飞行模式管理 |
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: gui.create
3
+ description: >
4
+ 启动基于 GUI 的应用操作任务(UI Agent)。用于在手机上对指定 App 发起一次独立的操控流程;多 App 或含条件的流程需拆分为多次调用,续办需携带上次任务的 task_id。
5
+ ---
6
+
7
+ # Gui Task Create GUI 任务创建
8
+
9
+ ## Tool Command
10
+ ```bash
11
+ gui.create
12
+ ```
13
+
14
+ ## 3. 业务规则
15
+
16
+ ### 适用场景及操作流程
17
+ 1. 针对单一 App 的一次性 GUI 操作任务,直接发起调用
18
+ 2. 涉及多个 App 的连续操作需拆分为多个独立任务,逐个调用
19
+ 3. 涉及条件判断(如“若…则…”)时,将条件判断与执行任务拆分为两次调用
20
+ 4. 若为对未结束任务的补充/修改/继续,需在请求中补充对应的 task_id
21
+
22
+ ### 特定交互
23
+ - 当用户表达“继续/接着/沿用上次”等续办意图时,应查找并填写上一未结束任务的 task_id
24
+ - 用户 query 中提及多个 App 时需与用户确认目标 App 后再调用
25
+ - task_query 应尽量保持用户原始指令表述,避免改写
26
+
27
+ ## 集成工作流
28
+
29
+ ### Step 1: 意图解析与参数组装
30
+ ```
31
+ ┌─────────────────────────────────────────────────────────────┐
32
+ │ 意图识别与参数提取 │
33
+ │ - 识别操作意图: 创建/发起 + GUI 应用操作任务 │
34
+ │ - 提取应用名称: 官方名/通用别称/拼音 │
35
+ │ - 提取任务指令: 包含明确操作步骤或目标 │
36
+ │ - 判断是否为续办: 根据“继续/接着/上次”等上下文 │
37
+ │ - 特殊处理: query 含多个App时确定目标应用 │
38
+ └─────────────────────────────────────────────────────────────┘
39
+
40
+ ┌─────────────────────────────────────────────────────────────┐
41
+ │ 消歧与槽位填充 │
42
+ │ - 未指定应用名称时,需向用户追问app_name │
43
+ │ - 未提供任务指令时,需向用户追问task_query │
44
+ │ - 多个应用候选时,需追问或让用户选择其一 │
45
+ │ - task_id仅当为未结束任务的更新/补充时填写 │
46
+ │ - "继续/接着/上次那个" → 映射为续办并查找task_id │
47
+ │ - 验证应用名称有效性(是否可被唤起) │
48
+ └─────────────────────────────────────────────────────────────┘
49
+
50
+ ┌─────────────────────────────────────────────────────────────┐
51
+ │ 生成工具调用 │
52
+ │ - 组装 app_name, task_query 及可选参数(task_id) │
53
+ │ - 生成平台特定的命令格式 │
54
+ └─────────────────────────────────────────────────────────────┘
55
+ ```
56
+
57
+ ### Step 2: 执行调用
58
+ - 根据操作系统选择对应的命令格式
59
+ - Windows: Cmd 格式(双引号需转义)
60
+ - Linux: Bash 格式(单引号包裹)
61
+
62
+ ## 参数定义
63
+ ```json
64
+ {
65
+ "app_name": {
66
+ "type": "string",
67
+ "description": "必填参数,需要执行该任务的app名称"
68
+ },
69
+ "task_query": {
70
+ "type": "string",
71
+ "description": "必填参数,需要让GUI执行的任务的明确query,通常为一个包含app名称的指令性query"
72
+ },
73
+ "task_id": {
74
+ "type": "string",
75
+ "description": "任务id,当前query为gui执行,且是对上一个未结束的gui任务的更新、补充,那么则将上一个未结束的gui任务的task_id填入"
76
+ }
77
+ }
78
+ ```
79
+
80
+ ### 参数注意事项
81
+ 1. `task_query` 应尽量保持用户原始意图,并将其改写成包含app名称的指令性query,或明确的gui操作指令。
82
+ 2. **同义词/间接表述映射**: “用X/在X里/打开X然后…”均映射为识别 `app_name`=X;“继续/接着/上次那个”映射为续办语义,需要填写 `task_id`。
83
+ 3. **默认值或缺省行为**: `app_name` 与 `task_query` 为必填,无默认值,如果缺失则需要追问用户;新增任务场景下 `task_id` 留空或不填写。
84
+ 4. **参数间关联/依赖**: `task_query` 通常包含 App 名称,但仍须单独提供 `app_name`;续办场景中 `task_id` 与所指任务保持一致。
85
+ 5. **可选参数填写条件**: 仅当用户明确为未结束任务的更新/补充/继续时才填写 `task_id`,否则不传。
86
+
87
+ ## Query 示例及输出
88
+
89
+ ### 示例 1: 在携程查询最便宜的机票(新增任务)
90
+
91
+ **用户输入**: "帮我在携程查询一下从上海去北京最便宜的机票"
92
+
93
+ **工具**: "gui.create"
94
+
95
+ **JSON 参数**:
96
+ ```json
97
+ {
98
+ "app_name": "携程",
99
+ "task_query": "帮我在携程查询一下从上海去北京最便宜的机票"
100
+ }
101
+ ```
102
+
103
+ **Windows (Cmd) 执行命令**:
104
+ ```bash
105
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"携程\",\"task_query\":\"帮我在携程查询一下从上海去北京最便宜的机票\"}"'
106
+ ```
107
+
108
+ **Linux (Bash) 执行命令**:
109
+ ```bash
110
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"携程","task_query":"帮我在携程查询一下从上海去北京最便宜的机票"}'
111
+ ```
112
+
113
+ ---
114
+
115
+ ### 示例 2: 用汽水音乐识别当前音乐(新增任务)
116
+
117
+ **用户输入**: "用汽水音乐帮我识别一下这个是什么音乐"
118
+
119
+ **工具**: "gui.create"
120
+
121
+ **JSON 参数**:
122
+ ```json
123
+ {
124
+ "app_name": "汽水音乐",
125
+ "task_query": "使用汽水音乐听歌识曲,识别当前的音乐"
126
+ }
127
+ ```
128
+
129
+ **Windows (Cmd) 执行命令**:
130
+ ```bash
131
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"汽水音乐\",\"task_query\":\"使用汽水音乐听歌识曲,识别当前的音乐\"}"'
132
+ ```
133
+
134
+ **Linux (Bash) 执行命令**:
135
+ ```bash
136
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"汽水音乐","task_query":"使用汽水音乐听歌识曲,识别当前的音乐"}'
137
+ ```
138
+
139
+ ---
140
+
141
+ ### 示例 3: 继续上次在高德地图的导航并修改目的地(续办,带 task_id)
142
+
143
+ **用户输入**: "接着刚才在高德地图的导航,把目的地改成北京南站"
144
+
145
+ **工具**: "gui.create"
146
+
147
+ **JSON 参数**:
148
+ ```json
149
+ {
150
+ "app_name": "高德地图",
151
+ "task_query": "继续在高德地图进行导航,将目的地改为北京南站",
152
+ "task_id": "prev-task-id-001"
153
+ }
154
+ ```
155
+
156
+ **Windows (Cmd) 执行命令**:
157
+ ```bash
158
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"高德地图\",\"task_query\":\"继续在高德地图进行导航,将目的地改为北京南站\",\"task_id\":\"prev-task-id-001\"}"'
159
+ ```
160
+
161
+ **Linux (Bash) 执行命令**:
162
+ ```bash
163
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"高德地图","task_query":"继续在高德地图进行导航,将目的地改为北京南站","task_id":"prev-task-id-001"}'
164
+ ```
165
+
166
+ ---
167
+
168
+ ### 示例 4: 在淘宝将指定商品加入购物车(新增任务)
169
+
170
+ **用户输入**: "在淘宝把羽绒服加入购物车"
171
+
172
+ **工具**: "gui.create"
173
+
174
+ **JSON 参数**:
175
+ ```json
176
+ {
177
+ "app_name": "淘宝",
178
+ "task_query": "在淘宝将“羽绒服”加入购物车"
179
+ }
180
+ ```
181
+
182
+ **Windows (Cmd) 执行命令**:
183
+ ```bash
184
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"淘宝\",\"task_query\":\"在淘宝将“羽绒服”加入购物车\"}"'
185
+ ```
186
+
187
+ **Linux (Bash) 执行命令**:
188
+ ```bash
189
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"淘宝","task_query":"在淘宝将“羽绒服”加入购物车"}'
190
+ ```
191
+
192
+ ---
193
+
194
+ ### 示例 5: 在系统设置中关闭蓝牙(新增任务)
195
+
196
+ **用户输入**: "打开设置把蓝牙关闭"
197
+
198
+ **工具**: "gui.create"
199
+
200
+ **JSON 参数**:
201
+ ```json
202
+ {
203
+ "app_name": "设置",
204
+ "task_query": "在设置中关闭蓝牙"
205
+ }
206
+ ```
207
+
208
+ **Windows (Cmd) 执行命令**:
209
+ ```bash
210
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"设置\",\"task_query\":\"在设置中关闭蓝牙\"}"'
211
+ ```
212
+
213
+ **Linux (Bash) 执行命令**:
214
+ ```bash
215
+ openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"设置","task_query":"在设置中关闭蓝牙"}'
216
+ ```
217
+
218
+ ---
219
+
220
+ **注意**:
221
+ - 返回给用户的回复话术严禁包含完整的 `task_id`,以免泄露隐私。
222
+ - 回复话术使用简短的task_id,且task_id不能被特殊字符包裹,例如:成功创建了任务55cd5faf-2871-468c-86bc-415b24ee0cc4,应该返回的回复话术为:✅ GUI 任务已启动,正在规划中。\n📋 任务 ID:55cd5faf
@@ -0,0 +1,188 @@
1
+ ---
2
+ name: gui.pause
3
+ description: >
4
+ GUI 任务暂停工具。用于暂停由 gui_task_create 创建且正在执行中的 GUI 任务(UI Agent 接口)。
5
+ ---
6
+
7
+ # Gui Task Pause GUI任务暂停
8
+
9
+ ## Tool Command
10
+ ```bash
11
+ gui.pause
12
+ ```
13
+
14
+ ## 集成工作流
15
+
16
+ ### Step 1: 意图解析与参数组装
17
+ ```
18
+ ┌─────────────────────────────────────────────────────────────┐
19
+ │ 意图识别与参数提取 │
20
+ │ - 识别操作意图: 暂停 + GUI任务 │
21
+ │ - 提取任务标识: 从会话上下文获取上一个未结束的 task_id │
22
+ │ - 判断任务上下文: 如无未结束任务需提示或追问 │
23
+ │ - 提取修饰词: 用户表述中的时间性短语不影响暂停意图 │
24
+ │ - 特殊处理: "暂停/先停一下/稍后继续/先别动"等同义词统一识别 │
25
+ └─────────────────────────────────────────────────────────────┘
26
+
27
+ ┌─────────────────────────────────────────────────────────────┐
28
+ │ 消歧与槽位填充 │
29
+ │ - 未指定 task_id 时,默认为上一个未结束的 GUI 任务 │
30
+ │ - 无可用任务时,需向用户追问具体 task_id 或返回不可暂停 │
31
+ │ - "先暂停一下/停一停" → 映射为暂停操作 │
32
+ │ - 验证任务状态: 仅当任务处于执行中方可暂停 │
33
+ │ - 特殊约束: query 保持用户原始输入,严禁改写 │
34
+ └─────────────────────────────────────────────────────────────┘
35
+
36
+ ┌─────────────────────────────────────────────────────────────┐
37
+ │ 生成工具调用 │
38
+ │ - 组装 task_id 及可选参数(无) │
39
+ │ - 生成平台特定的命令格式 │
40
+ └─────────────────────────────────────────────────────────────┘
41
+ ```
42
+
43
+ ### Step 2: 执行调用
44
+ - 根据操作系统选择对应的命令格式
45
+ - Windows: Cmd 格式(双引号需转义)
46
+ - Linux: Bash 格式(单引号包裹)
47
+
48
+ ## 参数定义
49
+ ```json
50
+ {
51
+ "task_id": {
52
+ "type": "string",
53
+ "description": "必填参数,任务id,当前query为gui执行,且是对上一个未结束的gui任务的更新、补充,那么则将上一个未结束的gui任务的task_id填入"
54
+ }
55
+ }
56
+ ```
57
+
58
+ ### 参数注意事项
59
+ 1. **同义词/间接表述映射**: 用户表述如`“暂停”/“先暂停一下”/“停一下”/“稍后继续”/“先别动”`均识别为暂停操作,对应调用本工具并填充`task_id`。
60
+ 2. **默认值或缺省行为**: 未显式提供`task_id`时,默认使用“上一个未结束的 GUI 任务”的`task_id`;若不存在此类任务,应向用户追问或返回不可暂停。
61
+ 3. **参数间关联/依赖**: 仅可暂停由`gui_task_create`创建且处于执行中的任务;`task_id`若对应已完成或已取消的任务,应进行状态校验并提示无法暂停。
62
+ 4. **格式/原样保留要求**: `task_id`需精确传递为系统返回的原始字符串,不得改写、截断或格式化。
63
+
64
+ ## Query 示例及输出
65
+
66
+ ### 示例 1: 暂停后台执行中的任务(已知任务ID)
67
+ **用户输入**: "暂停后台的应用操作"
68
+
69
+ **工具**: "gui.pause"
70
+
71
+ **JSON 参数**:
72
+ ```json
73
+ {
74
+ "task_id": "1234567890"
75
+ }
76
+ ```
77
+
78
+ **Windows (Cmd) 执行命令**:
79
+ ```bash
80
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"1234567890\\"}"'
81
+ ```
82
+
83
+ **Linux (Bash) 执行命令**:
84
+ ```bash
85
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"1234567890"}'
86
+ ```
87
+
88
+ ---
89
+
90
+ ### 示例 2: 暂停当前GUI执行(使用上一个未结束任务)
91
+ **用户输入**: "先暂停当前的GUI执行"
92
+
93
+ **工具**: "gui.pause"
94
+
95
+ **JSON 参数**:
96
+ ```json
97
+ {
98
+ "task_id": "gui-20240408-01"
99
+ }
100
+ ```
101
+
102
+ **Windows (Cmd) 执行命令**:
103
+ ```bash
104
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"gui-20240408-01\\"}"'
105
+ ```
106
+
107
+ **Linux (Bash) 执行命令**:
108
+ ```bash
109
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"gui-20240408-01"}'
110
+ ```
111
+
112
+ ---
113
+
114
+ ### 示例 3: 暂停自动化点按流程
115
+ **用户输入**: "把刚才的自动化点按流程停一下"
116
+
117
+ **工具**: "gui.pause"
118
+
119
+ **JSON 参数**:
120
+ ```json
121
+ {
122
+ "task_id": "task_98765"
123
+ }
124
+ ```
125
+
126
+ **Windows (Cmd) 执行命令**:
127
+ ```bash
128
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"task_98765\\"}"'
129
+ ```
130
+
131
+ **Linux (Bash) 执行命令**:
132
+ ```bash
133
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"task_98765"}'
134
+ ```
135
+
136
+ ---
137
+
138
+ ### 示例 4: 暂停,待命令再继续
139
+ **用户输入**: "先别动,等我说继续再跑"
140
+
141
+ **工具**: "gui.pause"
142
+
143
+ **JSON 参数**:
144
+ ```json
145
+ {
146
+ "task_id": "t-001"
147
+ }
148
+ ```
149
+
150
+ **Windows (Cmd) 执行命令**:
151
+ ```bash
152
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"t-001\\"}"'
153
+ ```
154
+
155
+ **Linux (Bash) 执行命令**:
156
+ ```bash
157
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"t-001"}'
158
+ ```
159
+
160
+ ---
161
+
162
+ ### 示例 5: 暂停指定应用场景的GUI任务
163
+ **用户输入**: "暂停抖音店铺浏览任务"
164
+
165
+ **工具**: "gui.pause"
166
+
167
+ **JSON 参数**:
168
+ ```json
169
+ {
170
+ "task_id": "9f2a1c3e"
171
+ }
172
+ ```
173
+
174
+ **Windows (Cmd) 执行命令**:
175
+ ```bash
176
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"9f2a1c3e\\"}"'
177
+ ```
178
+
179
+ **Linux (Bash) 执行命令**:
180
+ ```bash
181
+ openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"9f2a1c3e"}'
182
+ ```
183
+
184
+ ---
185
+
186
+ **注意**:
187
+ - 返回给用户的回复话术严禁包含完整的 `task_id`,以免泄露隐私。
188
+ - 回复话术使用简短的task_id,且task_id不能被特殊字符包裹,例如:成功暂停了任务55cd5faf-2871-468c-86bc-415b24ee0cc4,应该返回的回复话术为:✅ GUI 任务(55cd5faf)已暂停。
@@ -0,0 +1,192 @@
1
+ ---
2
+ name: gui.terminate
3
+ description: >
4
+ GUI 任务取消工具。用于通过 UI Agent 取消由 gui_task_create 创建且正在执行的 GUI 任务。
5
+ ---
6
+
7
+ # Gui Task Terminate GUI 任务取消
8
+
9
+ ## Tool Command
10
+ ```bash
11
+ gui.terminate
12
+ ```
13
+
14
+ ## 集成工作流
15
+
16
+ ### Step 1: 意图解析与参数组装
17
+ ```
18
+ ┌─────────────────────────────────────────────────────────────┐
19
+ │ 意图识别与参数提取 │
20
+ │ - 识别操作意图: 取消 + GUI 任务 │
21
+ │ - 提取任务ID: 从上下文获取上一个未结束 GUI 任务的 task_id │
22
+ │ - 判断场景: 当前是否为对上一个未结束 GUI 任务的更新/补充 │
23
+ │ - 特殊处理: "取消/停止/终止/结束/中止/打断/别做了" 等同义词│
24
+ │ 统一识别 │
25
+ └─────────────────────────────────────────────────────────────┘
26
+
27
+ ┌─────────────────────────────────────────────────────────────┐
28
+ │ 消歧与槽位填充 │
29
+ │ - 未指定task_id且存在唯一未结束任务时,默认为该任务 │
30
+ │ - task_id缺失且无法从上下文确定时,需向用户追问要取消的任务│
31
+ │ - "停止/终止/结束/打断/不要了" → 映射为取消操作 │
32
+ │ - task_id需为非空字符串,若无效需提示用户 │
33
+ │ - query保持用户原始输入,严禁改写 │
34
+ └─────────────────────────────────────────────────────────────┘
35
+
36
+ ┌─────────────────────────────────────────────────────────────┐
37
+ │ 生成工具调用 │
38
+ │ - 组装 task_id 及可选参数(无) │
39
+ │ - 生成平台特定的命令格式 │
40
+ └─────────────────────────────────────────────────────────────┘
41
+ ```
42
+
43
+ ### Step 2: 执行调用
44
+ - 根据操作系统选择对应的命令格式
45
+ - Windows: Cmd 格式(双引号需转义)
46
+ - Linux: Bash 格式(单引号包裹)
47
+
48
+ ## 参数定义
49
+ ```json
50
+ {
51
+ "task_id": {
52
+ "type": "string",
53
+ "description": "必填参数,任务id,当前query为gui执行,且是对上一个未结束的gui任务的更新、补充,那么则将上一个未结束的gui任务的task_id填入"
54
+ }
55
+ }
56
+ ```
57
+
58
+ ### 参数注意事项
59
+ 1. **同义词/间接表述映射**: 用户口语化表述如“取消/停止/终止/结束/中止/打断/别做了/不要了”均视为取消当前 GUI 任务,映射到填写`task_id`并调用本工具。
60
+ 2. **默认值或缺省行为**: 当存在唯一未结束的 GUI 任务且用户未显式提供`task_id`时,默认使用该任务的`task_id`进行取消。
61
+ 3. **参数依赖与来源**: `task_id`通常来源于由`gui_task_create`创建的最近未结束任务的上下文;如有多个未结束任务,必须让用户明确指定目标任务。
62
+
63
+ ## Query 示例及输出
64
+
65
+ ### 示例 1: 取消正在进行的后台应用操作
66
+
67
+ **用户输入**: "取消后台的应用操作"
68
+
69
+ **工具**: "gui.terminate"
70
+
71
+ **JSON 参数**:
72
+ ```json
73
+ {
74
+ "task_id": "1234567890"
75
+ }
76
+ ```
77
+
78
+ **Windows (Cmd) 执行命令**:
79
+ ```bash
80
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"1234567890\"}"'
81
+ ```
82
+
83
+ **Linux (Bash) 执行命令**:
84
+ ```bash
85
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"1234567890"}'
86
+ ```
87
+
88
+ ---
89
+
90
+ ### 示例 2: 用户切换任务,终止上个 GUI 操作
91
+
92
+ **用户输入**: "直接做下一个任务"
93
+
94
+ **工具**: "gui.terminate"
95
+
96
+ **JSON 参数**:
97
+ ```json
98
+ {
99
+ "task_id": "1234567890"
100
+ }
101
+ ```
102
+
103
+ **Windows (Cmd) 执行命令**:
104
+ ```bash
105
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"1234567890\"}"'
106
+ ```
107
+
108
+ **Linux (Bash) 执行命令**:
109
+ ```bash
110
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"1234567890"}'
111
+ ```
112
+
113
+ ---
114
+
115
+ ### 示例 3: 口语化表达终止操作
116
+
117
+ **用户输入**: "把刚才的 GUI 操作停一下"
118
+
119
+ **工具**: "gui.terminate"
120
+
121
+ **JSON 参数**:
122
+ ```json
123
+ {
124
+ "task_id": "9876543210"
125
+ }
126
+ ```
127
+
128
+ **Windows (Cmd) 执行命令**:
129
+ ```bash
130
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"9876543210\"}"'
131
+ ```
132
+
133
+ **Linux (Bash) 执行命令**:
134
+ ```bash
135
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"9876543210"}'
136
+ ```
137
+
138
+ ---
139
+
140
+ ### 示例 4: 指代“上个任务”的场景
141
+
142
+ **用户输入**: "中止上个图形化任务"
143
+
144
+ **工具**: "gui.terminate"
145
+
146
+ **JSON 参数**:
147
+ ```json
148
+ {
149
+ "task_id": "task-abc-001"
150
+ }
151
+ ```
152
+
153
+ **Windows (Cmd) 执行命令**:
154
+ ```bash
155
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"task-abc-001\"}"'
156
+ ```
157
+
158
+ **Linux (Bash) 执行命令**:
159
+ ```bash
160
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"task-abc-001"}'
161
+ ```
162
+
163
+ ---
164
+
165
+ ### 示例 5: 结束刚才的自动执行
166
+
167
+ **用户输入**: "结束刚才的自动操作"
168
+
169
+ **工具**: "gui.terminate"
170
+
171
+ **JSON 参数**:
172
+ ```json
173
+ {
174
+ "task_id": "last-gui-0001"
175
+ }
176
+ ```
177
+
178
+ **Windows (Cmd) 执行命令**:
179
+ ```bash
180
+ cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"last-gui-0001\"}"'
181
+ ```
182
+
183
+ **Linux (Bash) 执行命令**:
184
+ ```bash
185
+ openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"last-gui-0001"}'
186
+ ```
187
+
188
+ ---
189
+
190
+ **注意**:
191
+ - 返回给用户的回复话术严禁包含完整的 `task_id`,以免泄露隐私。
192
+ - 回复话术使用简短的task_id,且task_id不能被特殊字符包裹,例如:成功终止了任务55cd5faf-2871-468c-86bc-415b24ee0cc4,应该返回的回复话术为:✅ GUI 任务(55cd5faf)已终止。
@@ -1,24 +1,26 @@
1
1
  ---
2
2
  name: yoyo-update
3
3
  description: >
4
- 更新 YOYO 插件到最新版本。当用户要求更新、升级 yoyo 插件,或检查 yoyo 插件版本更新时触发。
4
+ 更新 YOYO 插件到最新版本。当用户说“升级 YOYO Claw 插件到最新版本”,或要求更新、升级 yoyo 插件,或检查 yoyo 插件版本更新时触发。
5
5
  metadata: { "openclaw": { "emoji": "🔄", "always": true } }
6
6
  ---
7
7
 
8
8
  # YOYO 插件更新
9
9
 
10
- 按照以下 5 步工作流完成 YOYO 插件的版本更新。
10
+ 按照以下 6 步工作流完成 YOYO 插件的版本更新。
11
11
 
12
12
  ## 全局规则
13
13
 
14
- - [MANDATORY] **严禁在技能流程内重启网关**不得执行 `openclaw gateway stop/start/restart` 或任何网关重启操作
14
+ - [MANDATORY] **更新成功后的重启是内部 best-effort 动作** 只有在 `openclaw plugins update yoyo` 成功完成并确认插件版本已更新后,尝试触发一次 `openclaw gateway restart`
15
+ - [MANDATORY] 除上述更新成功后的单次重启触发尝试外,不得执行 `openclaw gateway stop/start/restart` 或任何网关重启操作;更新失败、无需更新、精确版本停止、状态异常、无法确认版本等场景不得重启
16
+ - [MANDATORY] 更新后的重启触发只能在当前这一次 yoyo-update 对话轮次中处理;若 OpenClaw 已自行重启、正在重启、命令无法触达网关、命令执行中断、或已经进入下一轮对话,则不得补偿重启,除非用户再次明确要求重启
15
17
  - [MANDATORY] **严禁卸载插件** — 不得执行 `openclaw plugins uninstall`,否则用户配置将丢失
16
18
  - [MANDATORY] 出错时仅汇总错误并给出建议,不得尝试自动修复(尤其是不得通过卸载重装来解决问题)
17
19
  - [MANDATORY] 所有面向用户的输出必须使用中文
18
- - [MANDATORY] 不支持精确版本号安装的插件自动升级;检测到精确版本号时必须停止流程并提示用户自行更新插件
19
- - [MANDATORY] 执行 `openclaw plugins update yoyo` 会更新 `plugins.installs` 配置并触发网关自动重启;检测到存在可更新版本后直接进入更新流程,不得向用户二次确认或输出重启风险说明
20
+ - [MANDATORY] 不支持精确版本号安装的插件自动升级;只要 `Spec` 是 `@honor-claw/yoyo@<semver>` 这类精确版本(含预发布版本,例如 `@honor-claw/yoyo@1.3.0-beta.8`),必须立即停止整个流程,不得查询 npm、不得进入更新摘要、不得执行 `openclaw plugins update yoyo`
21
+ - [MANDATORY] 执行 `openclaw plugins update yoyo` 后不能假设网关一定会自动重启;检测到存在可更新版本后直接进入更新流程,不得向用户二次确认或输出重启风险说明
20
22
  - [MANDATORY] 更新后的最终判断必须以实际更新版本为准,不得只依赖步骤 2 查询到的目标版本
21
- - [MANDATORY] 本文件中的"步骤 1/2/3/4/5"、小节标题、处理规则、命令说明均为内部流程,不得原样输出给用户
23
+ - [MANDATORY] 本文件中的"步骤 1/2/3/4/5/6"、小节标题、处理规则、命令说明均为内部流程,不得原样输出给用户
22
24
  - [MANDATORY] 正常更新流程下,面向用户的输出必须严格使用本文指定的可见文案;不得额外输出"步骤1"、"步骤2"、"正在检查版本"、"我将执行"、命令说明、内部判断过程或自由发挥的状态描述
23
25
  - 所有命令在 Windows (bash) 和 Unix (bash) 环境下格式一致,无需区分平台
24
26
 
@@ -29,9 +31,17 @@ metadata: { "openclaw": { "emoji": "🔄", "always": true } }
29
31
  1. 步骤 3 中的更新摘要文案
30
32
  2. 步骤 4.1 的升级流程开头和阶段 1 进度
31
33
  3. 步骤 4.3 的阶段 2 进度
32
- 4. 步骤 5 的成功文案,以及实际版本高于预检查目标版本时的追加说明
34
+ 4. 步骤 5 的插件更新完成文案,以及实际版本高于预检查目标版本时的追加说明
33
35
 
34
- 除上述内容外,不得向用户展示内部步骤名称、命令执行计划、版本检查过程、字段解析过程或监控输出。异常、无需更新、未更新、无法确认版本等停止流程场景,按对应规则输出简短结果即可,也不得展示内部步骤编号。
36
+ 除上述内容外,不得向用户展示内部步骤名称、命令执行计划、版本检查过程、字段解析过程、重启触发动作或监控输出。异常、无需更新、未更新、无法确认版本等停止流程场景,按对应规则输出简短结果即可,也不得展示内部步骤编号。
37
+
38
+ 检测到精确版本号时,必须使用以下文案并停止流程:
39
+
40
+ ```markdown
41
+ 当前 YOYO 插件使用精确版本号安装,自动升级流程已停止。
42
+
43
+ 请修改 OpenClaw 配置文件,将 `plugins.installs.yoyo.spec` 从当前精确版本改为非精确版本规格(例如 `@honor-claw/yoyo@beta`、`@honor-claw/yoyo@alpha` 或 `@honor-claw/yoyo`),然后再重新发起升级。
44
+ ```
35
45
 
36
46
  ## 步骤 1:预检查
37
47
 
@@ -55,7 +65,9 @@ openclaw plugins info yoyo
55
65
  - 若插件未找到(输出为空或提示未安装)→ 告知用户"未检测到 YOYO 插件,请先安装"并停止
56
66
  - 若状态非 `loaded`(如 `error`)→ 告知用户插件状态异常并展示具体信息,停止流程
57
67
  - 若命令本身执行失败 → 告知用户"无法获取插件信息,请确认 OpenClaw 网关正在运行"并停止
58
- - 成功获取信息 → 提取 `Version` 和 `Spec` 字段值,进入步骤 2
68
+ - 成功获取信息 → 提取 `Version` 和 `Spec` 字段值
69
+ - 若 `Spec` 是精确版本号(如 `@honor-claw/yoyo@1.3.0-beta.8`)→ 输出精确版本停止文案并停止流程;不得查询 npm、不得展示更新摘要、不得执行 `openclaw plugins update yoyo`
70
+ - 其他情况 → 进入步骤 2
59
71
 
60
72
  ## 步骤 2:检查最新版本
61
73
 
@@ -66,7 +78,7 @@ openclaw plugins info yoyo
66
78
  - 安装目标为 `alpha` → 渠道为 `alpha`
67
79
  - 安装目标为 `beta` → 渠道为 `beta`
68
80
  - 安装目标为 `latest` 或没有安装目标 → 渠道为 `latest`
69
- - `Spec` 包含精确版本号(如 `@honor-claw/yoyo@1.3.0-beta.8`)→ 告知用户"当前 YOYO 插件使用精确版本号安装,自动升级流程暂不支持判断升级渠道。后续安装 YOYO 插件时请不要携带精确版本号;本次请自行更新插件。"并停止流程
81
+ - `Spec` 包含精确版本号(如 `@honor-claw/yoyo@1.3.0-beta.8`)→ 输出精确版本停止文案并停止流程;不得查询 npm、不得展示更新摘要、不得执行 `openclaw plugins update yoyo`
70
82
  - `Spec` 包含其他未知标签 → 告知用户"当前 YOYO 插件安装来源无法识别,请自行更新插件或联系开发团队确认升级渠道"并停止流程
71
83
 
72
84
  ### 2.2 查询最新版本
@@ -151,7 +163,7 @@ openclaw plugins update yoyo
151
163
  | `Installing plugin dependencies` | 不输出 | 静默跟踪 |
152
164
  | `Updated yoyo:` | 不输出 | 捕获实际更新版本 |
153
165
  | `Config overwrite:` / `Config backup:` | 不输出 | 记录配置备份路径 |
154
- | `Restart the gateway to load plugins` | 不输出 | 更新成功的确认信号,进入步骤 5 |
166
+ | `Restart the gateway to load plugins` | 不输出 | 更新命令成功的确认信号,进入步骤 5 |
155
167
 
156
168
  阶段 2 的进度通知必须使用以下文案:
157
169
 
@@ -180,7 +192,7 @@ openclaw plugins update yoyo
180
192
  openclaw plugins info yoyo
181
193
  ```
182
194
 
183
- 从 `Version` 字段提取最终版本。若此时网关正在自动重启导致命令暂时失败,不要把它直接判定为更新失败;说明"插件更新命令已完成,但网关正在重启,暂时无法确认最终版本"
195
+ 从 `Version` 字段提取最终版本。若此时命令暂时失败,不要把它直接判定为更新失败;告知用户"插件更新命令已完成,但暂时无法确认最终版本,请稍后再次检查插件版本"。此时不得在后续对话中补偿重启,除非用户再次明确要求重启。
184
196
 
185
197
  将实际更新版本与步骤 1 的当前版本、步骤 2 的目标版本进行 semver 比较:
186
198
 
@@ -192,12 +204,11 @@ openclaw plugins info yoyo
192
204
 
193
205
  ### 更新成功
194
206
 
195
- 向用户报告:
207
+ 向用户报告后进入步骤 6:
196
208
 
197
209
  ```markdown
198
210
  3. 插件更新完成
199
211
  Claw 插件更新已完成
200
- 网关即将自动重启,请稍候...
201
212
  ```
202
213
 
203
214
  若实际版本高于步骤 2 获取的目标版本,在成功文案后追加:
@@ -206,7 +217,7 @@ Claw 插件更新已完成
206
217
  说明:本次实际升级到 v{实际版本},高于预检查获取的目标版本 v{目标版本}。
207
218
  ```
208
219
 
209
- **[MANDATORY] 不得在此步骤中询问用户是否重启。** `openclaw plugins update yoyo` 已通过配置变更触发网关自动重启。
220
+ **[MANDATORY] 不得在此步骤中询问用户是否重启。** 插件版本确认更新后,必须在当前对话轮次内继续执行步骤 6。
210
221
 
211
222
  ### 更新失败
212
223
 
@@ -230,3 +241,18 @@ Claw 插件更新已完成
230
241
  - 手动删除插件目录
231
242
  - 修改插件配置文件来绕过错误
232
243
  - 重启网关
244
+
245
+ ## 步骤 6:触发网关重启
246
+
247
+ 仅在步骤 5 已按更新成功处理时执行。本步骤是内部 best-effort 收尾动作,不得向用户输出任何重启相关文案。
248
+
249
+ ```bash
250
+ openclaw gateway restart
251
+ ```
252
+
253
+ **处理规则**:
254
+
255
+ - 更新成功后尝试触发一次 `openclaw gateway restart`;这是为了覆盖少数未自动重启的情况,不改变用户可见成功文案
256
+ - 若触发成功,即使 OpenClaw 因自身机制又重启了一次,也不需要关心,不额外输出、不验证、不补救
257
+ - 若触发前或触发时发现 OpenClaw 已自行重启、正在重启、命令无法触达网关、连接中断或命令失败,视为 best-effort 已完成;不得重试、不得改用 `stop/start`、不得把更新成功改判为失败、不得输出重启失败提示
258
+ - 若当前对话轮次已经结束、用户发起了新的请求、或此前因为任何原因没有执行重启命令 → 不得为了本次更新补偿执行 `openclaw gateway restart`,除非用户明确提出需要重启