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

package/skills/yoyo-control/references/app-open.md

@@ -0,0 +1,178 @@
+---
+name: app.open
+description: >
+  应用打开工具。用于帮助用户打开指定的 APP 应用，
+  且不涉及任何具体 App 内部操作。
+---
+
+# App Open 应用打开工具
+
+## Tool Command
+
+```bash
+app.open
+```
+
+## 集成工作流
+
+### app_name_to_pkgName
+
+| app        | pkgName                        |
+| :--------- | :----------------------------- |
+| 手机淘宝   | com.taobao.taobao              |
+| 支付宝     | com.eg.android.AlipayGphone    |
+| 微信       | com.tencent.mm                 |
+| QQ         | com.tencent.mobileqq           |
+| 抖音短视频 | com.ss.android.ugc.aweme       |
+| 小红书     | com.xingin.xhs                 |
+| 美团       | com.sankuai.meituan            |
+| 美团外卖   | com.sankuai.meituan.takeoutnew |
+| 京东       | com.jingdong.app.mall          |
+| 拼多多     | com.xunmeng.pinduoduo          |
+| 高德地图   | com.autonavi.minimap           |
+| 百度地图   | com.baidu.BaiduMap             |
+| 爱奇艺     | com.qiyi.video                 |
+| 腾讯视频   | com.tencent.qqlive             |
+| 微博       | com.sina.weibo                 |
+| 今日头条   | com.ss.android.article.news    |
+
+**⚠️ 重要: 打开应用前请遵循以下工作流程**
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Step 1: 检查输入参数                                        │
+│  - 有应用名称? → 进入 Step 2                                │
+│  - 有包名(pkgName)? → 进入 Step 3                           │
+│  - 仅有类型描述(appDescription)? → 进入 Step 4              │
+│  - 都没有? → 向用户追问应用名称或包名                        │
+│  - 值为 "all"? → 不支持打开所有应用，提示用户               │
+└─────────────────────────────────────────────────────────────┘
+
+↓
+┌─────────────────────────────────────────────────────────────┐
+│  Step 2: 通过应用名称解析包名                                │
+│  调用: app_name_to_pkgName（上文），用App名称去查找App包名    │
+│  若匹配到多个结果 → 请用户选择                               │
+│  若无匹配结果 → 通知用户并请求提供包名                       │
+└─────────────────────────────────────────────────────────────┘
+
+↓
+┌─────────────────────────────────────────────────────────────┐
+│  Step 3: 通过包名解析应用名称                                 │
+│  调用: app_name_to_pkgName（上文），用App包名去查找App名称      │
+│  若匹配到多个结果 → 请用户选择                                  │
+│  若无匹配结果 → 通知用户并请求提供应用名称                        │
+└─────────────────────────────────────────────────────────────┘
+
+↓
+┌─────────────────────────────────────────────────────────────┐
+│  Step 4: 通过类型描述解析包名                                  │
+│  调用: 根据你的理解，基于app类型找到App名称和APP包名              │
+│  若匹配到多结果 → 请用户选择                                   │
+│  若无匹配结果 → 通知用户并请求提供应用名称或包名                   │
+└─────────────────────────────────────────────────────────────┘
+
+↓
+┌─────────────────────────────────────────────────────────────┐
+│  Step 5: 执行打开应用                                         │
+│  调用: app.open，传入 app, pkgName                           │
+│  - 根据操作系统选择对应的命令格式                               │
+│  - Windows: Cmd 格式（双引号需转义）                           │
+│  - Linux: Bash 格式（单引号包裹）                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 意图分类与参数映射
+
+| 用户意图                 | 关键词示例                   | 参数组合                           |
+| :----------------------- | :--------------------------- | :--------------------------------- |
+| **打开指定应用**         | 打开/启动/运行 + [应用名]    | `app`, `pkgName`                   |
+| **打开带序号的应用**     | 打开 + [序号] + [应用名]     | `app`, `pkgName`, `sequence`       |
+| **打开带类型描述的应用** | 打开 + [应用名] + [类型描述] | `app`, `pkgName`, `appDescription` |
+
+## 参数定义
+
+```json
+{
+    "app": {
+        "type": "string",
+        "description": "必填参数，应用名称。需要打开的应用名称，若用户指定具体应用，则填写应用名称，若用户明确表示"所有应用"，则参数值为 all。"
+    },
+    "pkgName": {
+        "type": "string",
+        "description": "必填参数，应用包名。根据集成工作流中 app_name_to_pkgName 的映射表，填写应用包名。"
+    },
+    "appDescription": {
+        "type": "string",
+        "description": "类型描述。对 app 的补充描述，无论是否为空，都可以有这个参数，当且仅当 app 为空时才调用 description。示例：办公应用、聊天软件、音乐类应用。"
+    }
+}
+```
+
+### 参数注意事项
+
+1. **app 与 appDescription 的关系**: `appDescription` 是对 `app` 的补充描述，当 `app` 为空时可单独通过 `appDescription` 进行类型匹配
+2. **不支持打开所有应用**: 当用户要求打开"所有应用"时，应提示该功能暂不支持
+3. **序号选择**: `sequence` 需保持与用户原始输入一致的表述形式（如"第一"、"倒数第二个"、"3"）
+4. **未找到应用**: 若设备上未找到目标应用，可询问用户是否需要安装
+
+## Query 示例及输出
+
+### 示例1: 打开指定应用
+
+**用户输入**: "打开微信"
+
+**工具**: "app.open"
+
+**JSON 参数**:
+
+```json
+{
+  "app": "微信",
+  "pkgName": "com.tencent.mm"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command app.open --params "{\"app\":\"微信\",\"pkgName\":\"com.tencent.mm\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command app.open --params '{"app":"微信", "pkgName":"com.tencent.mm"}'
+```
+
+---
+
+### 示例2: 通过类型描述打开应用
+
+**用户输入**: "打开生活类软件"
+
+**工具**: "app.open"
+
+**JSON 参数**:
+
+```json
+{
+  "app": "支付宝",
+  "pkgName": "com.eg.android.AlipayGphone",
+  "appDescription": "生活"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command app.open --params "{\"app\":\"支付宝\", \"pkgName\":\"com.eg.android.AlipayGphone\", Description\":\"生活\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command app.open --params '{"app":"支付宝","pkgName":"com.eg.android.AlipayGphone","Description":"生活"}'
+```
+
+---

package/skills/yoyo-control/references/call-phone.md

@@ -0,0 +1,250 @@
+---
+name: call
+description: >
+  智能电话拨打与管理工具。提供全面的电话呼叫功能，
+  支持通过姓名、电话号码或黄页服务发起呼叫；
+  支持指定拨号使用的SIM卡（移动/联通/电信/卡槽）；
+  具备重拨最后号码、回拨已接听来电、回拨未接听来电及通用回拨功能；
+  能够处理联系人重名消歧、多号码选择及二次确认流程。
+---
+
+# Call 电话拨打
+
+## Tool Command
+
+```bash
+call.phone
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作类型: 打电话/重拨/回拨                            │
+│  - 识别回拨子类型: 已接听/未接听/通用回拨                     │
+│  - 识别联系人: 自然人名、昵称、机构/部门名称                  │
+│  - 识别号码: 完整电话号码、黄页服务号码                       │
+│  - 识别卡槽: 卡1/卡2/移动/联通/电信等                        │
+│  - 识别设备: 手机/固定电话等                                 │
+│  - 识别选择序号: 多候选时的列表序号                          │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                               │
+│  - 多联系人匹配时，返回候选列表等待用户选择序号                │
+│  - 联系人存在，电话号码缺失时，调用 search-contact 工具查找联系人号码 │
+│  - 多SIM卡设备未指定卡槽时，需向用户确认使用哪张卡             │
+│  - 黄页服务需确认具体机构/部门分支                            │
+│  - 号码归属地/运营商信息辅助确认                              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                 │
+│  - 组装 actionType, recallType 及可选参数                     │
+│  - 区分自然人联系人与黄页机构联系人                           │
+│  - 生成平台特定的命令格式                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+
+```json
+{
+  "actionType": {
+    "type": "string",
+    "enum": ["打电话", "重拨", "回拨"],
+    "description": "必填参数，拨打业务类型。打电话：主动发起呼叫；重拨：重新拨打上一次通话号码；回拨：对历史通话记录进行回拨"
+  },
+  "recallType": {
+    "type": "string",
+    "enum": ["回拨已接听来电", "回拨未接听来电", "回拨电话"],
+    "description": "回拨类型，仅在actionType为'回拨'时有值。用于区分回拨目标的通话记录类型"
+  },
+  "deviceType": {
+    "type": "string",
+    "description": "设备类型，如：手机、固定电话等"
+  },
+  "phoneCard": {
+    "type": "string",
+    "description": "电话卡选择，如：移动、联通、电信、卡1、卡2等。用于多卡设备指定拨号SIM卡"
+  },
+  "phoneNumber": {
+    "type": "string",
+    "description": "必填参数，完整的电话号码，数字格式"
+  },
+  "contact": {
+    "type": "string",
+    "description": "泛化的'联系人'概念，可为自然人名/昵称（如：张三、王总），或非自然实体（机构、部门、服务名称，如：招生办、物业客服）"
+  },
+  "sequence": {
+    "type": "string",
+    "description": "列表序号。用于多候选项场景（联系人重名、同一联系人多号码、黄页多分支）时的选择。应与系统返回的候选列表序号一致；目标唯一时可省略"
+  },
+  "nameContact": {
+    "type": "string",
+    "description": "明确标识contact为自然人名或昵称，强调'人'的身份，不包含机构或部门。用于区分自然人联系人与机构联系人"
+  },
+  "yellowPageContact": {
+    "type": "string",
+    "description": "黄页目录名称，涉及公共服务/企业客服等非私人联系人时使用（如：银行客服、快递客服、医院挂号）。用于限定检索范围或指向黄页条目"
+  }
+}
+```
+
+### 参数注意事项
+
+1. **消歧逻辑**: 当 contact 对应多个联系人或号码时，工具不应直接执行，而应返回 resultCode: 101 并携带 contactCardInformation 供用户选择。
+2. **回拨类型**: 若用户仅说“回拨”，未指明是未接还是已接，recallType 默认为 回拨电话（通常指最近的一条来电记录，具体策略依系统而定）。
+
+## Query 示例及输出
+
+### 示例 1: 拨打指定号码
+
+**用户输入**: "拨打15651621029"
+
+**工具**: "call"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打电话",
+  "phoneNumber": "15651621029"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params "{\"actionType\":\"打电话\",\"phoneNumber\":\"15651621029\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params '{"actionType":"打电话","phoneNumber":"15651621029"}'
+```
+
+---
+
+### 示例 2: 拨打联系人
+
+**用户输入**: "打电话给张三"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打电话",
+  "phoneNumber": "15651621029",
+  "contact": "张三",
+  "nameContact": "张三"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params "{\"actionType\":\"打电话\",\"phoneNumber\":\"15651621029\",\"contact\":\"张三\",\"nameContact\":\"张三\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params '{"actionType":"打电话","contact":"张三","nameContact":"张三"}'
+```
+
+---
+
+### 示例 3: 使用指定SIM卡拨打
+
+**用户输入**: "用移动手机卡打电话给于洋"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打电话",
+  "phoneNumber": "15651621029",
+  "contact": "于洋",
+  "nameContact": "于洋",
+  "phoneCard": "移动手机卡"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params "{\"actionType\":\"打电话\",\"phoneNumber\":\"15651621029\",\"contact\":\"于洋\",\"nameContact\":\"于洋\",\"phoneCard\":\"移动手机卡\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params '{"actionType":"打电话","phoneNumber":"15651621029","contact":"于洋","nameContact":"于洋","phoneCard":"移动手机卡"}'
+```
+
+---
+
+### 示例 4: 重拨
+
+**用户输入**: "重拨"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "重拨"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params "{\"actionType\":\"重拨\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params '{"actionType":"重拨"}'
+```
+
+---
+
+### 示例 5: 回拨未接来电
+
+**用户输入**: "回拨未接来电"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "回拨",
+  "phoneNumber": "15651621029",
+  "recallType": "回拨未接听来电"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params "{\"actionType\":\"回拨\",\"phoneNumber\":\"15651621029\",\"recallType\":\"回拨未接听来电\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command call.phone --params '{"actionType":"回拨","phoneNumber":"15651621029","recallType":"回拨未接听来电"}'
+```
+
+---