@honor-claw/yoyo 0.0.1-beta.2 → 0.0.1-beta.21

package/skills/yoyo-control/references/capture-screenshot.md

@@ -1,66 +1,217 @@
-# capture_screenshot 截屏工具使用说明
+---
+name: capture-screenshot
+description: >
+  截屏功能管理与触发工具。提供对截屏功能的管理与触发能力，
+  支持将当前手机屏幕内容以图片的形式保存，
+  包括普通截屏和滚动截屏等操作。
+---
+
+# Capture Screenshot 截屏管理
 
 ## Tool Command
 
 ```bash
-capture.shot
+capture-screenshot
 ```
 
-## Tool Parameters and Examples
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作类型: 截屏 / 滚动截屏                            │
+│  - 提取修饰词: 应用名称                                     │
+│  - 特殊处理: "保存屏幕/屏幕截图/截图" → 映射为截屏          │
+│  - 特殊处理: "长截图/滚动截图/长图" → 映射为滚动截屏        │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                               │
+│  - 未指定截屏类型时，默认使用普通截屏                          │
+│  - 应用级操作需验证应用名称有效性                              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                 │
+│  - 组装 actionType 及可选参数（app）                          │
+│  - 生成平台特定的命令格式                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 意图分类与参数映射
+
+| 用户意图     | 关键词示例                    | actionType | 可选参数 |
+| :----------- | :---------------------------- | :--------- | :------- |
+| **普通截屏** | 截屏/截图/保存屏幕/屏幕截图   | `截屏`     | `app`    |
+| **滚动截屏** | 滚动截屏/长截图/滚动截图/长图 | `滚动截屏` | `app`    |
+
+## 参数定义
 
 ```json
 {
-  "name": "capture_screenshot",
-  "description": "该工具提供对截屏功能(将当前手机屏幕内容以图片的形式保存)的管理与触发能力，支持截屏和滚动截屏等操作。",
-  "parameters": {
-    "actionType": {
-      "type": "string",
-      "enum": ["截屏", "滚动截屏"],
-      "description": "截屏相关操作的动作类型，用于明确本次指令的主要行为。当需要对当前屏幕内容进行一次性截图保存时使用截屏；当需要对可上下滚动的长页面内容进行连续截图并合成为长图时使用滚动截屏。"
-    },
-    "app": {
-      "type": "string",
-      "description": "指定需要进行截屏操作的应用名称。当明确要求对某个特定应用界面进行截图时填写，用于限定截屏作用范围。"
-    }
+  "actionType": {
+    "type": "string",
+    "enum": ["截屏", "滚动截屏"],
+    "description": "截屏相关操作的动作类型，用于明确本次指令的主要行为。当需要对当前屏幕内容进行一次性截图保存时使用截屏；当需要对可上下滚动的长页面内容进行连续截图并合成为长图时使用滚动截屏。"
   },
-  "required": [],
-  "examples": [
-    {
-      "query": "截屏",
-      "arguments": {
-        "actionType": "截屏"
-      }
-    },
-    {
-      "query": "滚动截屏",
-      "arguments": {
-        "actionType": "滚动截屏"
-      }
-    },
-    {
-      "query": "立刻保存手机屏幕",
-      "arguments": {
-        "actionType": "截屏"
-      }
-    },
-    {
-      "query": "我想要滚动截屏",
-      "arguments": {
-        "actionType": "滚动截屏"
-      }
-    },
-    {
-      "query": "请将屏幕内容保存为图片",
-      "arguments": {
-        "actionType": "截屏"
-      }
-    },
-    {
-      "query": "我需要当前手机屏幕的图片",
-      "arguments": {
-        "actionType": "截屏"
-      }
-    }
-  ]
+  "app": {
+    "type": "string",
+    "description": "指定需要进行截屏操作的应用名称。当明确要求对某个特定应用界面进行截图时填写，用于限定截屏作用范围。"
+  }
+}
+```
+
+### 参数注意事项
+
+1. **截屏类型默认**: 未指定截屏类型时，默认使用普通截屏
+2. **同义词映射**: "截图"、"保存屏幕"、"屏幕截图"等表述均应映射为截屏操作；"长截图"、"滚动截图"、"长图"等表述均应映射为滚动截屏操作
+
+## Query 示例及输出
+
+### 示例 1: 普通截屏
+
+**用户输入**: "截屏"
+
+**工具**: "capture-screenshot"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "截屏"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params "{\"actionType\":\"截屏\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"截屏"}'
+```
+
+---
+
+### 示例 2: 滚动截屏
+
+**用户输入**: "滚动截屏"
+
+**工具**: "capture-screenshot"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "滚动截屏"
 }
 ```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params "{\"actionType\":\"滚动截屏\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"滚动截屏"}'
+```
+
+---
+
+### 示例 3: 口语化保存屏幕
+
+**用户输入**: "立刻保存手机屏幕"
+
+**工具**: "capture-screenshot"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "截屏"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params "{\"actionType\":\"截屏\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"截屏"}'
+```
+
+---
+
+### 示例 4: 口语化滚动截屏
+
+**用户输入**: "我想要滚动截屏"
+
+**工具**: "capture-screenshot"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "滚动截屏"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params "{\"actionType\":\"滚动截屏\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"滚动截屏"}'
+```
+
+---
+
+### 示例 5: 描述性截屏指令
+
+**用户输入**: "请将屏幕内容保存为图片"
+
+**工具**: "capture-screenshot"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "截屏"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params "{\"actionType\":\"截屏\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command capture-screenshot --params '{"actionType":"截屏"}'
+```
+
+---

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

@@ -0,0 +1,235 @@
+---
+name: contact.search
+description: >
+  联系人查找服务工具。提供按姓名、昵称、电话号码检索联系人的能力，
+  支持区分自然人名与机构/黄页条目，可处理模糊匹配、多结果列表展示及序号选择场景。
+---
+
+# Search Contact 联系人查找服务
+
+## Tool Command
+
+```bash
+contact.search
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作类型: 查找/搜索/查询/对应                         │
+│  - 识别操作对象: 姓名/昵称/电话号码/机构名                   │
+│  - 提取修饰词: 实体类型 (人名/机构)、序号 (第几个)            │
+│  - 特殊处理: 区分 nameContact (人名) 与 yellowPageContact (机构) │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                               │
+│  - 未指定具体联系人信息 → 触发槽位追问 (resultCode 100)        │
+│  - 匹配到多个联系人 → 返回卡片列表 (cardInformation), 等待序号选择 │
+│  - 仅输入电话号码 → 反向查询联系人姓名                        │
+│  - 机构/公共服务 → 映射到 yellowPageContact 字段               │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                 │
+│  - 组装 contact, nameContact, phoneNumber, sequence, yellowPageContact │
+│  - 生成平台特定的命令格式                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 意图分类与参数映射
+
+| 用户意图     | 关键词示例          | contact    | nameContact | phoneNumber | yellowPageContact | sequence |
+| :----------- | :------------------ | :--------- | :---------- | :---------- | :---------------- | :------- |
+| 查人名电话   | 找/查 + [人名] 电话 | `[人名]`   | `[人名]`    | -           | -                 | -        |
+| 查电话对应人 | [号码] 是谁/对应谁  | -          | -           | `[号码]`    | -                 | -        |
+| 查最新联系人 | 最新联系人/最近联系 | -          | -           | -           | -                 | -        |
+| 查机构客服   | [机构名] 客服/电话  | `[机构名]` | -           | -           | `[机构名]`        | -        |
+| 序号选择     | 第 X 个 / 选第 X 个 | (上下文)   | (上下文)    | (上下文)    | (上下文)          | `[序号]` |
+
+## 参数定义
+
+```json
+{
+  "contact": {
+    "type": "string",
+    "description": "联系人信息，如张三、李四、王哥等，可以为非自然实体如招办。"
+  },
+  "nameContact": {
+    "type": "string",
+    "description": "判断 contact 是否是人名、昵称之类的。明确为自然实体的人名或昵称，强调“人”的身份，不包含机构或部门。若 contact 为机构，此字段为空。"
+  },
+  "phoneNumber": {
+    "type": "string",
+    "description": "电话号码。用于反向查询联系人姓名。"
+  },
+  "sequence": {
+    "type": "string",
+    "description": "序号。目前只有查找联系人使用，用于用户在列表中选择特定项。示例：'第一'、'第二个'、'3'。"
+  },
+  "yellowPageContact": {
+    "type": "string",
+    "description": "涉及公共服务/企业客服等非私人联系人时的黄页目录名称（如：银行客服、快递客服、医院挂号）。用于限定检索范围或指向黄页条目。"
+  }
+}
+```
+
+### 参数注意事项
+
+1. **人名与机构区分**:
+   若用户查询的是具体的人（如“张三”），nameContact 必须填写，且值与 contact 一致。
+   若用户查询的是机构（如“工商银行”），nameContact 留空，yellowPageContact 填写机构名。
+2. **反向查询**: 当用户仅提供电话号码时，phoneNumber 必填，contact 和 nameContact 留空。
+3. **无参查询**: 查询“最新联系人”等无具体目标的指令，所有参数字段可为空，由后端逻辑处理默认行为。
+4. **无参查询**: 序号格式: sequence 需保持用户原始输入的格式（中文数字或阿拉伯数字），以便前端交互回显。
+
+## Query 示例及输出
+
+### 示例 1: 查找指定人名电话
+
+**用户输入**: "找一下张玉的电话"
+
+**工具**: "contact.search"
+
+**JSON 参数**:
+
+```json
+{
+  "contact": "张玉",
+  "nameContact": "张玉"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params "{\"contact\":\"张玉\",\"nameContact\":\"张玉\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params '{"contact":"张玉","nameContact":"张玉"}'
+```
+
+---
+
+### 示例 2: 电话号码反查联系人
+
+**用户输入**: "13653336777 对应的联系人是谁"
+
+**工具**: "contact.search"
+
+**JSON 参数**:
+
+```json
+{
+  "phoneNumber": "13653336777"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params "{\"phoneNumber\":\"13653336777\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params '{"phoneNumber":"13653336777"}'
+```
+
+---
+
+### 示例 3: 查询最新联系人
+
+**用户输入**: "查看手机中最新联系人号码"
+
+**工具**: "contact.search"
+
+**JSON 参数**:
+
+```json
+{}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params "{}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params '{}'
+```
+
+---
+
+### 示例 4: 查找机构客服电话 (黄页)
+
+**用户输入**: "寻找中国工商银行的客服电话"
+
+**JSON 参数**:
+
+```json
+{
+  "contact": "中国工商银行",
+  "nameContact": "中国工商银行",
+  "yellowPageContact": "中国工商银行"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params "{\"contact\":\"中国工商银行\",\"nameContact\":\"中国工商银行\",\"yellowPageContact\":\"中国工商银行\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params '{"contact":"中国工商银行","nameContact":"中国工商银行","yellowPageContact":"中国工商银行"}'
+```
+
+---
+
+### 示例 5: 多结果列表选择 (模拟场景)
+
+**用户输入**: "(系统返回多个“张磊”后) "选第一个"
+
+**JSON 参数**:
+
+```json
+{
+  "contact": "张磊",
+  "nameContact": "张磊",
+  "sequence": "第一个"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params "{\"contact\":\"张磊\",\"nameContact\":\"张磊\",\"sequence\":\"第一个\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command contact.search --params '{"contact":"张磊","nameContact":"张磊","sequence":"第一个"}'
+```
+
+---