@honor-claw/yoyo 1.6.1-beta.8 → 1.6.1-beta.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "1.6.1-beta.8",
+  "version": "1.6.1-beta.9",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",

package/skills/yoyo-control/SKILL.md

@@ -90,7 +90,12 @@ metadata: { "openclaw": { "emoji": "📱", "always": true } }
 
 | 所需 Caps             | 参考文件                                 | 工具说明                             |
 | --------------------- | ---------------------------------------- | ------------------------------------ |
+| `local-search`        | `references/local-search.md`             | 本地搜索（文档、笔记、日程、图库等） |
+| `task-result-query`   | `references/task-result-query.md`        | 任务结果查询（轮询获取异步任务结果） |
 | `file-upload`         | `references/file-upload.md`              | 文件上传                             |
+| `gui`                 | `references/gui-task-create.md`          | 启动 GUI 操作任务（UI Agent），只有当用户明确要求在指定 App 内执行指定动作时才使用。如果用户没有提供应用名，严禁使用本工具。|
+| `gui`                 | `references/gui-task-terminate.md`       | 取消 GUI 任务                        |
+| `gui`                 | `references/gui-task-pause.md`           | 暂停 GUI 任务                        |
 
 ### 2.3 MCP 工具查找流程
 

package/skills/yoyo-control/configs/sub-skills.json

@@ -1,3 +1,8 @@
 [
-  "file_upload"
+  "file_upload",
+  "local_search",
+  "task_result_query",
+  "gui_task_create",
+  "gui_task_pause",
+  "gui_task_terminate"
 ]

package/skills/yoyo-control/references/gui-task-create.md

@@ -0,0 +1,206 @@
+---
+name: gui.create
+description: >
+  启动基于 GUI 的应用操作任务（UI Agent）。用于在手机上对指定 App 发起一次独立的操控流程；单一 App 禁止拆分任务，多 App 或含条件的流程需拆分为多次调用，续办需携带上次任务的 task_id。
+---
+
+# Gui Task Create GUI 任务创建
+
+## Tool Command
+```bash
+gui.create
+```
+
+## 3. 业务规则
+
+### 适用场景及操作流程
+1. 针对单一 App 的任何 GUI 操作任务，禁止拆分任务，必须直接发起调用
+2. 涉及多个 App 的连续操作需拆分为多个独立任务，逐个调用
+3. 涉及条件判断（如“若…则…”）时，将条件判断与执行任务拆分为两次调用
+4. 若为对未结束任务的补充/修改/继续，需在请求中补充对应的 task_id
+
+### 特定交互
+- 当用户表达“继续/接着/沿用上次”等续办意图时，应查找并填写上一未结束任务的 task_id
+- 用户 query 中提及多个 App 时需与用户确认目标 App 后再调用
+- task_query 应尽量保持用户原始指令表述，避免改写
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作意图: 创建/发起 + GUI 应用操作任务                │
+│  - 提取应用名称: 官方名/通用别称/拼音                        │
+│  - 提取任务指令: 包含明确操作步骤或目标                      │
+│  - 判断是否为续办: 根据“继续/接着/上次”等上下文             │
+│  - 特殊处理: query 含多个App时确定目标应用                  │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未指定应用名称时，需向用户追问app_name                    │
+│  - 未提供任务指令时，需向用户追问task_query                  │
+│  - 多个应用候选时，需追问或让用户选择其一                    │
+│  - task_id仅当为未结束任务的更新/补充时填写                  │
+│  - "继续/接着/上次那个" → 映射为续办并查找task_id            │
+│  - 验证应用名称有效性（是否可被唤起）                        │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装 app_name, task_query 及可选参数（task_id）           │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "app_name": {
+    "type": "string",
+    "description": "必填参数，需要执行该任务的app名称"
+  },
+  "task_query": {
+    "type": "string",
+    "description": "必填参数，需要让GUI执行的任务的明确query，通常为一个包含app名称的指令性query"
+  },
+  "task_id": {
+    "type": "string",
+    "description": "任务id，当前query为gui执行，且是对上一个未结束的gui任务的更新、补充，那么则将上一个未结束的gui任务的task_id填入"
+  }
+}
+```
+
+### 参数注意事项
+1. `task_query` 应尽量保持用户原始意图，并将其改写成包含app名称的指令性query，或明确的gui操作指令。
+2. **同义词/间接表述映射**: “用X/在X里/打开X然后…”均映射为识别 `app_name`=X；“继续/接着/上次那个”映射为续办语义，需要填写 `task_id`。
+3. **默认值或缺省行为**: `app_name` 与 `task_query` 为必填，无默认值，如果缺失则需要追问用户；新增任务场景下 `task_id` 留空或不填写。
+4. **参数间关联/依赖**: `task_query` 通常包含 App 名称，但仍须单独提供 `app_name`；续办场景中 `task_id` 与所指任务保持一致。
+5. **可选参数填写条件**: 仅当用户明确为未结束任务的更新/补充/继续时才填写 `task_id`，否则不传。
+
+## Query 示例及输出
+
+### 示例 1: 在携程查询最便宜的机票（新增任务）
+
+**用户输入**: "帮我在携程查询一下从上海去北京最便宜的机票"
+
+**工具**: "gui.create"
+
+**JSON 参数**:
+```json
+{
+  "app_name": "携程",
+  "task_query": "帮我在携程查询一下从上海去北京最便宜的机票"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"携程\",\"task_query\":\"帮我在携程查询一下从上海去北京最便宜的机票\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"携程","task_query":"帮我在携程查询一下从上海去北京最便宜的机票"}'
+```
+
+---
+
+### 示例 2: 单一应用任务（禁止拆解任务）
+
+**用户输入**: "打开微信添加好友A和好友B，并给A发送你好"
+
+**工具**: "gui.create"
+
+**JSON 参数**:
+```json
+{
+  "app_name": "微信",
+  "task_query": "打开微信添加好友A和好友B，并给A发送你好"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"微信\",\"task_query\":\"打开微信添加好友A和好友B，并给A发送你好\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"微信","task_query":"打开微信添加好友A和好友B，并给A发送你好"}'
+```
+
+---
+
+### 示例 3: 多应用任务（必须按app拆解任务）
+
+**用户输入**: "在淘宝把羽绒服加入购物车，然后截图发给微信好友A"
+
+**工具**: "gui.create"
+
+**JSON 参数**:
+sub-task 1: 在淘宝将“羽绒服”加入购物车并截图
+```json
+{
+  "app_name": "淘宝",
+  "task_query": "在淘宝将“羽绒服”加入购物车并截图"
+}
+```
+sub-task 2: 在微信将截图发送给好友A
+```json
+{
+  "app_name": "微信",
+  "task_query": "在微信将截图发送给好友A"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"淘宝\",\"task_query\":\"在淘宝将“羽绒服”加入购物车并截图\"}"'
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"微信\",\"task_query\":\"在微信将截图发送给好友A\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"淘宝","task_query":"在淘宝将“羽绒服”加入购物车并截图"}'
+openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"微信","task_query":"在微信将截图发送给好友A"}'
+```
+
+---
+
+### 示例 4: 继续上次在高德地图的导航并修改目的地（续办，带 task_id）
+
+**用户输入**: "接着刚才在高德地图的导航，把目的地改成北京南站"
+
+**工具**: "gui.create"
+
+**JSON 参数**:
+```json
+{
+  "app_name": "高德地图",
+  "task_query": "继续在高德地图进行导航，将目的地改为北京南站",
+  "task_id": "prev-task-id-001"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.create --params "{\"app_name\":\"高德地图\",\"task_query\":\"继续在高德地图进行导航，将目的地改为北京南站\",\"task_id\":\"prev-task-id-001\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.create --params '{"app_name":"高德地图","task_query":"继续在高德地图进行导航，将目的地改为北京南站","task_id":"prev-task-id-001"}'
+```
+
+---
+
+**注意**:
+- 返回给用户的回复话术严禁包含完整的 `task_id`，以免泄露隐私。
+- 回复话术使用简短的task_id，且task_id不能被特殊字符包裹，例如：成功创建了任务55cd5faf-2871-468c-86bc-415b24ee0cc4，应该返回的回复话术为：✅ GUI 任务已启动，正在规划中。\n📋 任务 ID：55cd5faf

package/skills/yoyo-control/references/gui-task-pause.md

@@ -0,0 +1,188 @@
+---
+name: gui.pause
+description: >
+  GUI 任务暂停工具。用于暂停由 gui_task_create 创建且正在执行中的 GUI 任务（UI Agent 接口）。
+---
+
+# Gui Task Pause GUI任务暂停
+
+## Tool Command
+```bash
+gui.pause
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作意图: 暂停 + GUI任务                              │
+│  - 提取任务标识: 从会话上下文获取上一个未结束的 task_id       │
+│  - 判断任务上下文: 如无未结束任务需提示或追问                │
+│  - 提取修饰词: 用户表述中的时间性短语不影响暂停意图          │
+│  - 特殊处理: "暂停/先停一下/稍后继续/先别动"等同义词统一识别  │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未指定 task_id 时，默认为上一个未结束的 GUI 任务          │
+│  - 无可用任务时，需向用户追问具体 task_id 或返回不可暂停     │
+│  - "先暂停一下/停一停" → 映射为暂停操作                      │
+│  - 验证任务状态: 仅当任务处于执行中方可暂停                  │
+│  - 特殊约束: query 保持用户原始输入，严禁改写                │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装 task_id 及可选参数（无）                             │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "task_id": {
+    "type": "string",
+    "description": "必填参数，任务id，当前query为gui执行，且是对上一个未结束的gui任务的更新、补充，那么则将上一个未结束的gui任务的task_id填入"
+  }
+}
+```
+
+### 参数注意事项
+1. **同义词/间接表述映射**: 用户表述如`“暂停”/“先暂停一下”/“停一下”/“稍后继续”/“先别动”`均识别为暂停操作，对应调用本工具并填充`task_id`。
+2. **默认值或缺省行为**: 未显式提供`task_id`时，默认使用“上一个未结束的 GUI 任务”的`task_id`；若不存在此类任务，应向用户追问或返回不可暂停。
+3. **参数间关联/依赖**: 仅可暂停由`gui_task_create`创建且处于执行中的任务；`task_id`若对应已完成或已取消的任务，应进行状态校验并提示无法暂停。
+4. **格式/原样保留要求**: `task_id`需精确传递为系统返回的原始字符串，不得改写、截断或格式化。
+
+## Query 示例及输出
+
+### 示例 1: 暂停后台执行中的任务（已知任务ID）
+**用户输入**: "暂停后台的应用操作"
+
+**工具**: "gui.pause"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "1234567890"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"1234567890\\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"1234567890"}'
+```
+
+---
+
+### 示例 2: 暂停当前GUI执行（使用上一个未结束任务）
+**用户输入**: "先暂停当前的GUI执行"
+
+**工具**: "gui.pause"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "gui-20240408-01"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"gui-20240408-01\\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"gui-20240408-01"}'
+```
+
+---
+
+### 示例 3: 暂停自动化点按流程
+**用户输入**: "把刚才的自动化点按流程停一下"
+
+**工具**: "gui.pause"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "task_98765"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"task_98765\\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"task_98765"}'
+```
+
+---
+
+### 示例 4: 暂停，待命令再继续
+**用户输入**: "先别动，等我说继续再跑"
+
+**工具**: "gui.pause"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "t-001"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"t-001\\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"t-001"}'
+```
+
+---
+
+### 示例 5: 暂停指定应用场景的GUI任务
+**用户输入**: "暂停抖音店铺浏览任务"
+
+**工具**: "gui.pause"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "9f2a1c3e"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.pause --params "{\\"task_id\\":\\"9f2a1c3e\\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.pause --params '{"task_id":"9f2a1c3e"}'
+```
+
+---
+
+**注意**:
+- 返回给用户的回复话术严禁包含完整的 `task_id`，以免泄露隐私。
+- 回复话术使用简短的task_id，且task_id不能被特殊字符包裹，例如：成功暂停了任务55cd5faf-2871-468c-86bc-415b24ee0cc4，应该返回的回复话术为：✅ GUI 任务（55cd5faf）已暂停。

package/skills/yoyo-control/references/gui-task-terminate.md

@@ -0,0 +1,192 @@
+---
+name: gui.terminate
+description: >
+  GUI 任务取消工具。用于通过 UI Agent 取消由 gui_task_create 创建且正在执行的 GUI 任务。
+---
+
+# Gui Task Terminate GUI 任务取消
+
+## Tool Command
+```bash
+gui.terminate
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作意图: 取消 + GUI 任务                           │
+│  - 提取任务ID: 从上下文获取上一个未结束 GUI 任务的 task_id │
+│  - 判断场景: 当前是否为对上一个未结束 GUI 任务的更新/补充  │
+│  - 特殊处理: "取消/停止/终止/结束/中止/打断/别做了" 等同义词│
+│    统一识别                                                 │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                             │
+│  - 未指定task_id且存在唯一未结束任务时，默认为该任务        │
+│  - task_id缺失且无法从上下文确定时，需向用户追问要取消的任务│
+│  - "停止/终止/结束/打断/不要了" → 映射为取消操作            │
+│  - task_id需为非空字符串，若无效需提示用户                  │
+│  - query保持用户原始输入，严禁改写                          │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                               │
+│  - 组装 task_id 及可选参数（无）                            │
+│  - 生成平台特定的命令格式                                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "task_id": {
+    "type": "string",
+    "description": "必填参数，任务id，当前query为gui执行，且是对上一个未结束的gui任务的更新、补充，那么则将上一个未结束的gui任务的task_id填入"
+  }
+}
+```
+
+### 参数注意事项
+1. **同义词/间接表述映射**: 用户口语化表述如“取消/停止/终止/结束/中止/打断/别做了/不要了”均视为取消当前 GUI 任务，映射到填写`task_id`并调用本工具。
+2. **默认值或缺省行为**: 当存在唯一未结束的 GUI 任务且用户未显式提供`task_id`时，默认使用该任务的`task_id`进行取消。
+3. **参数依赖与来源**: `task_id`通常来源于由`gui_task_create`创建的最近未结束任务的上下文；如有多个未结束任务，必须让用户明确指定目标任务。
+
+## Query 示例及输出
+
+### 示例 1: 取消正在进行的后台应用操作
+
+**用户输入**: "取消后台的应用操作"
+
+**工具**: "gui.terminate"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "1234567890"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"1234567890\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"1234567890"}'
+```
+
+---
+
+### 示例 2: 用户切换任务，终止上个 GUI 操作
+
+**用户输入**: "直接做下一个任务"
+
+**工具**: "gui.terminate"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "1234567890"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"1234567890\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"1234567890"}'
+```
+
+---
+
+### 示例 3: 口语化表达终止操作
+
+**用户输入**: "把刚才的 GUI 操作停一下"
+
+**工具**: "gui.terminate"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "9876543210"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"9876543210\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"9876543210"}'
+```
+
+---
+
+### 示例 4: 指代“上个任务”的场景
+
+**用户输入**: "中止上个图形化任务"
+
+**工具**: "gui.terminate"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "task-abc-001"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"task-abc-001\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"task-abc-001"}'
+```
+
+---
+
+### 示例 5: 结束刚才的自动执行
+
+**用户输入**: "结束刚才的自动操作"
+
+**工具**: "gui.terminate"
+
+**JSON 参数**:
+```json
+{
+  "task_id": "last-gui-0001"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command gui.terminate --params "{\"task_id\":\"last-gui-0001\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command gui.terminate --params '{"task_id":"last-gui-0001"}'
+```
+
+---
+
+**注意**:
+- 返回给用户的回复话术严禁包含完整的 `task_id`，以免泄露隐私。
+- 回复话术使用简短的task_id，且task_id不能被特殊字符包裹，例如：成功终止了任务55cd5faf-2871-468c-86bc-415b24ee0cc4，应该返回的回复话术为：✅ GUI 任务（55cd5faf）已终止。

package/skills/yoyo-control/references/local-search.md

@@ -0,0 +1,307 @@
+---
+name: local-search
+description: >
+  用户手机内容RAG系统。用户使用自然语言统一查询本地数据，
+  信源包括文档、笔记、日程、图库、yoyo记忆、钱包，
+  用于直接回答用户问题或生成概览性内容。
+---
+
+# Local Search 本地数据搜索
+
+## Tool Command
+
+```bash
+local-search
+```
+
+### 输出
+
+```json
+{
+  "task_id": {
+    "type": "string",
+    "description": "任务ID，用于后续查询任务执行结果"
+  }
+}
+```
+
+### Step 2: 获取任务结果
+
+```bash
+task_result_query
+```
+
+### 输入 (task_result_query)
+
+```json
+{
+  "task_id": {
+    "type": "string",
+    "description": "local-search 返回的任务ID"
+  }
+}
+```
+
+### 输出 (task_result_query)
+
+```json
+{
+  "answer": {
+    "type": "string",
+    "description": "工具执行的最新结果"
+  },
+  "isFinal": {
+    "type": "boolean",
+    "description": "任务是否执行完成，true 表示完成，false 表示仍在执行中"
+  }
+}
+```
+
+### 完整调用流程
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Step 1: 调用 local-search                                  │
+│  - 输入: query, isSearchImage                               │
+│  - 输出: task_id                                           │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  Step 2: 轮询 task_result_query                            │
+│  - 输入: task_id                                           │
+│  - 输出: answer, isFinal                                   │
+│  - 循环调用直到 isFinal = true                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别查询内容: 用户原始 query，不做任何改写                │
+│  - 判断是否涉及图片搜索                                     │
+│  - 数据范围: 文档/笔记/日程/图库/yoyo记忆/钱包              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                               │
+│  - 当 query 涉及图片、照片、截图等内容时 isSearchImage = true │
+│  - 其他文本类查询（文档、笔记、日程等）isSearchImage = false  │
+│  - query 保持用户原始输入，严禁改写                           │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                 │
+│  - 组装 query 及可选参数（isSearchImage）                     │
+│  - 生成平台特定的命令格式                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+### Step 3: 获取任务结果
+
+- 使用 local-search 返回的 task_id
+- 调用 task_result_query 轮询获取结果
+- 当 isFinal = false 时继续轮询，当 isFinal = true 时返回最终结果
+
+## 数据范围
+
+| 信源         | 说明                                                                   |
+| :----------- | :--------------------------------------------------------------------- |
+| **文档**     | 本地存储的文档（如 Word、PDF、PPT 等），通过文本抽取和向量化建立索引   |
+| **笔记**     | 便签、备忘录、记事类应用中的文本内容                                   |
+| **日程**     | 日历和日程条目（会议、活动、提醒等），含时间、地点、参与人等结构化信息 |
+| **图库**     | 本地图片、照片、截图等图像内容                                         |
+| **yoyo记忆** | yoyo 智能助理的历史记忆数据                                            |
+| **钱包**     | 钱包相关数据                                                           |
+
+## 意图分类与参数映射
+
+| 用户意图         | 关键词示例                    | 参数组合                      |
+| :--------------- | :---------------------------- | :---------------------------- |
+| **查询文档内容** | 找/搜/查 + 文档/文件/PPT/PDF  | `query`                       |
+| **查询笔记内容** | 找/搜/查 + 笔记/便签/备忘录   | `query`                       |
+| **查询日程信息** | 查看/查 + 日程/会议/日历/活动 | `query`                       |
+| **搜索图片**     | 找/搜 + 图片/照片/截图        | `query`, `isSearchImage`=true |
+| **查询yoyo记忆** | 之前说过/记得/上次提到        | `query`                       |
+| **查询钱包信息** | 查 + 钱包/余额/账单           | `query`                       |
+
+## 参数定义
+
+```json
+{
+  "query": {
+    "type": "string",
+    "description": "用户原始 query，不需要进行任何改写。"
+  },
+  "isSearchImage": {
+    "type": "boolean",
+    "description": "是否搜索图片。"
+  }
+}
+```
+
+### 参数注意事项
+
+1. **query 不做改写**: 必须保持用户的原始输入，严禁对 query 进行任何改写、摘要或重组
+2. **isSearchImage 判断**: 当用户查询明确涉及图片、照片、截图等图像内容时设为 `true`，其他情况设为 `false` 或不传
+
+## Query 示例及输出
+
+### 示例 1: 查询文档内容
+
+**用户输入**: "帮我找一下上次的项目方案文档"
+
+**工具**: "local-search"
+
+**JSON 参数**:
+
+```json
+{
+  "query": "帮我找一下上次的项目方案文档",
+  "isSearchImage": false
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command local-search --params "{\"query\":\"帮我找一下上次的项目方案文档\",\"isSearchImage\":false}"'
+
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command local-search --params '{"query":"帮我找一下上次的项目方案文档","isSearchImage":false}'
+```
+
+---
+
+### 示例 2: 搜索图片
+
+**用户输入**: "找一下上周拍的风景照片"
+
+**工具**: "local-search"
+
+**JSON 参数**:
+
+```json
+{
+  "query": "找一下上周拍的风景照片",
+  "isSearchImage": true
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command local-search --params "{\"query\":\"找一下上周拍的风景照片\",\"isSearchImage\":true}"'
+
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command local-search --params '{"query":"找一下上周拍的风景照片","isSearchImage":true}'
+```
+
+---
+
+### 示例 3: 查询日程信息
+
+**用户输入**: "明天有什么会议安排"
+
+**工具**: "local-search"
+
+**JSON 参数**:
+
+```json
+{
+  "query": "明天有什么会议安排",
+  "isSearchImage": false
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command local-search --params "{\"query\":\"明天有什么会议安排\",\"isSearchImage\":false}"'
+
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command local-search --params '{"query":"明天有什么会议安排","isSearchImage":false}'
+```
+
+---
+
+### 示例 4: 查询笔记内容
+
+**用户输入**: "我之前记的读书笔记里有什么"
+
+**工具**: "local-search"
+
+**JSON 参数**:
+
+```json
+{
+  "query": "我之前记的读书笔记里有什么",
+  "isSearchImage": false
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command local-search --params "{\"query\":\"我之前记的读书笔记里有什么\",\"isSearchImage\":false}"'
+
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command local-search --params '{"query":"我之前记的读书笔记里有什么","isSearchImage":false}'
+```
+
+---
+
+### 示例 5: 搜索截图
+
+**用户输入**: "找一下之前的微信聊天截图"
+
+**工具**: "local-search"
+
+**JSON 参数**:
+
+```json
+{
+  "query": "找一下之前的微信聊天截图",
+  "isSearchImage": true
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command local-search --params "{\"query\":\"找一下之前的微信聊天截图\",\"isSearchImage\":true}"'
+
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command local-search --params '{"query":"找一下之前的微信聊天截图","isSearchImage":true}'
+```
+
+---

package/skills/yoyo-control/references/task-result-query.md

@@ -0,0 +1,59 @@
+---
+name: task-result-query
+description: >
+  轮询查询任务执行结果。通过 task_id 查询异步任务的执行状态和结果，
+  用于获取 local-search 等异步工具的执行结果。
+---
+
+# Task Result Query 任务结果查询
+
+## Tool Command
+
+```bash
+task_result_query
+```
+
+## 输入
+
+```json
+{
+  "task_id": {
+    "type": "string",
+    "description": "local-search 返回的任务ID，用于查询任务执行结果"
+  }
+}
+```
+
+## 输出
+
+```json
+{
+  "answer": {
+    "type": "string",
+    "description": "工具执行的最新结果内容"
+  },
+  "isFinal": {
+    "type": "boolean",
+    "description": "任务是否执行完成，true 表示已完成，false 表示仍在执行中"
+  }
+}
+```
+
+## 使用说明
+
+1. 先调用 local-search 获取 task_id
+2. 使用 task_id 调用本工具查询结果
+3. 当 isFinal = false 时继续轮询（建议间隔 1-2 秒）
+4. 当 isFinal = true 时返回最终结果
+
+## Windows (Cmd) 执行命令
+
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command task_result_query --params "{\"task_id\":\"<task_id>\"}"'
+```
+
+## Linux (Bash) 执行命令
+
+```bash
+openclaw nodes invoke --node <ID> --command task_result_query --params '{"task_id":"<task_id>"}'
+```