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

package/skills/yoyo-control/references/message-send.md

@@ -0,0 +1,246 @@
+---
+name: message-send
+description: >
+  提供发送短信的服务。支持通过电话号码或联系人名称发送短信内容，
+  可使用黄页发送短信至公共服务号码，以及发送名片信息给指定联系人。
+---
+
+# Message Send 短信发送服务
+
+## Tool Command
+
+```bash
+message.send
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装，并进行缺失参数判断
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  - 有phoneNumber？→ Step 3                                 │
+│  - 只有contact？→ Step 2                                    │
+│  - 有yellowPageContact？→ Step 3             │
+│  - 两者都没有？→ 询问用户contact 或 phoneNumber                          │
+│  - 有名片参数？→ 确认联系人/电话号码已提供             │
+│  - 内容缺失？→ 询问用户短信内容                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 将联系人解析为电话号码
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  - 调用 contact-search 工具(./references/contact-search.md）传入联系人名称                      |
+│  - 从搜索结果中获取phoneNumber                         │
+│  - 如有多个匹配 → 请用户选择（序号）                             │
+│  - 如无匹配 → 告知用户并询问phoneNumber                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 3: 执行调用
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  - 调用message-send工具 并传入 phoneNumber 和 actionType + content        │
+│  - 或 yellowPageContact + content                                       │
+│  - 或 nameCard + phoneNumber 和 actionType                                   │
+│  - 根据操作系统选择对应的命令格式                              │
+│  - Windows: cmd 格式（双引号需转义）                   │
+│  - Linux: Bash 格式（单引号包裹）                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 意图分类与参数映射
+
+| 用户意图       | 关键词示例            | 核心参数                   | 辅助参数      | 输出处理      |
+| :------------- | :-------------------- | :------------------------- | :------------ | :------------ |
+| **发送短信**   | 发短信/发消息/给...发 | `contact` 或 `phoneNumber` | `content`     | 成功/失败播报 |
+| **黄页短信**   | 发给银行客服/快递客服 | `yellowPageContact`        | `content`     | 服务号码匹配  |
+| **名片分享**   | 把...名片发给...      | `nameCard`, `contact`      | `phoneNumber` | 二次确认      |
+| **联系人选择** | 第几个/第一个/第二个  | `sequence`                 | -             | 列表选择确认  |
+
+## 参数定义
+
+```json
+{
+  "contact": {
+    "type": "string",
+    "description": "接收短信的联系人名称，如张三、李四、王哥等。可为非自然实体如招生办、客服中心。"
+  },
+  "content": {
+    "type": "string",
+    "description": "必填参数，短信的文本内容。用户未提供时需追问填充。"
+  },
+  "phoneNumber": {
+    "type": "string",
+    "description": "必填参数，接收短信的手机号码。与contact参数二选一或同时使用。"
+  },
+  "nameCard": {
+    "type": "string",
+    "description": "要发送的名片信息，值为联系人名称。使用场景：将某人的名片分享给另一人。"
+  },
+  "sequence": {
+    "type": "string",
+    "description": "当找到多个匹配联系人时，指定要发送的目标序号，如'1'、'2'、'第一个'。"
+  },
+  "nameContact": {
+    "type": "string",
+    "description": "标记contact是否为自然人名或昵称。明确为'人'的身份，排除机构、部门、公共服务等。"
+  },
+  "yellowPageContact": {
+    "type": "string",
+    "description": "黄页目录名称，用于公共服务/企业客服等非私人联系人。如：银行客服、快递客服、医院挂号。"
+  }
+}
+```
+
+### 参数注意事项
+
+1. **黄页服务识别**: 涉及公共服务号码（10086、95588等）时，优先使用yellowPageContact
+2. **内容缺失处理**: content为空时，resultCode=100触发槽位追问
+
+## Query 示例及输出
+
+### 示例 1: 基础发送短信
+
+**用户输入**: "发短信给张姐"
+
+**工具**: "message-send"
+
+**JSON 参数**:
+
+```json
+{
+  "contact": "张姐",
+  "content": "你好",
+  "phoneNumber": "13588462151"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params "{\"contact\":\"张姐\",\"content\":\"你好\",\"phoneNumber\":\"13588462151\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params '{"contact":"张姐","content":"你好","phoneNumber":"13588462151"}'
+```
+
+---
+
+### 示例 2: 发给电话号码并指定内容
+
+**用户输入**: "发短信给10086说我要办理宽带"
+
+**JSON 参数**:
+
+```json
+{
+  "phoneNumber": "10086",
+  "content": "我要办理宽带"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params "{\"phoneNumber\":\"10086\",\"content\":\"我要办理宽带\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params '{"phoneNumber":"10086","content":"我要办理宽带"}'
+```
+
+---
+
+### 示例 3: 发给联系人并指定内容
+
+**用户输入**: "发短信给史芹说表格准备好了"
+
+**JSON 参数**:
+
+```json
+{
+  "contact": "史芹",
+  "content": "表格准备好了",
+  "nameContact": "史芹"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params "{\"contact\":\"史芹\",\"content\":\"表格准备好了\",\"nameContact\":\"史芹\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params '{"contact":"史芹","content":"表格准备好了","nameContact":"史芹"}'
+```
+
+---
+
+### 示例 4: 发送名片
+
+**用户输入**: "把黄龙的名片发给赵民电话13588462151"
+
+**JSON 参数**:
+
+```json
+{
+  "contact": "赵民",
+  "phoneNumber": "13588462151",
+  "nameCard": "黄龙",
+  "nameContact": "赵民"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params "{\"contact\":\"赵民\",\"phoneNumber\":\"13588462151\",\"nameCard\":\"黄龙\",\"nameContact\":\"赵民\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params '{"contact":"赵民","phoneNumber":"13588462151","nameCard":"黄龙","nameContact":"赵民"}'
+```
+
+---
+
+### 示例 5: 黄页服务发送
+
+**用户输入**: "给银行客服发短信查余额"
+
+**JSON 参数**:
+
+```json
+{
+  "yellowPageContact": "中国移动",
+  "phoneNumber": "10086",
+  "content": "查余额"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params "{\"yellowPageContact\":\"中国移动\",\"phoneNumber\":\"10086\",\"content\":\"查余额\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command message-send --params '{"yellowPageContact":"中国移动","phoneNumber":"10086","content":"查余额"}'
+```
+
+---

package/skills/yoyo-control/references/mobile-data.md

@@ -0,0 +1,248 @@
+---
+name: mobile-data
+description: >
+  移动数据与流量管理工具。提供对移动数据及流量管理相关功能的综合管理与控制，
+  支持开关移动数据、切换SIM卡、查询流量使用情况/账单/排行、设置流量限额与提醒、
+  控制应用级流量、流量校准及省流量模式等功能。
+---
+
+# Mobile Data 移动数据与流量管理
+
+## Tool Command
+
+```bash
+mobile-data
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作类型: 打开/关闭/设置/切换/查询/问答               │
+│  - 识别操作对象: 移动数据/SIM卡/流量使用情况/账单/限额等      │
+│  - 提取修饰词: 卡槽、应用名称、统计周期                       │
+│  - 特殊处理: "如何/怎么"类问题 → 标记为问答类型             │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                               │
+│  - 多卡设备未指定卡槽时，需向用户确认目标SIM卡                 │
+│  - 应用级操作需验证应用名称有效性                              │
+│  - 时间范围查询缺省时，默认使用"本月"                         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                 │
+│  - 组装 actionType, target 及可选参数                         │
+│  - 生成平台特定的命令格式                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 意图分类与参数映射
+
+| 用户意图      | 关键词示例                      | actionType           | target             | 可选参数                |
+| :------------ | :------------------------------ | :------------------- | :----------------- | :---------------------- |
+| **连接控制**  | 打开/关闭/启用/停用 + 移动数据  | `打开`/`关闭`        | `移动数据`         | `app`                   |
+| **SIM卡管理** | 切换/默认/主卡 + 卡1/卡2/运营商 | `切换`/`设置`        | `流量卡`           | `card`                  |
+| **用量查询**  | 查询/查看 + 流量使用情况        | `查询`               | `流量使用情况`     | `card`, `period`, `app` |
+| **余额查询**  | 剩余/还有多少 + 流量            | `查询`               | `剩余流量`         | `card`, `period`        |
+| **账单查询**  | 账单/套餐/费用 + 查看           | `查询`               | `流量账单`         | `card`, `period`, `app` |
+| **限额提醒**  | 提醒/限额/阈值 + 设置           | `设置`/`打开`/`关闭` | `流量套餐限额提醒` | `card`, `value`         |
+| **应用控制**  | 控制/限制 + [应用名]            | `设置`/`打开`/`关闭` | `流量控制`         | `app`                   |
+| **排行查询**  | 排行/哪个应用 + 最多            | `查询`               | `流量排行`         | `period`, `card`        |
+| **流量校准**  | 校准/校正 + 流量                | `打开`/`设置`        | `流量校准`         | `card`                  |
+| **省流模式**  | 省流量/智能节流 + 开/关         | `打开`/`关闭`/`设置` | `省流量模式`       | -                       |
+| **使用帮助**  | 怎么/如何 + 查看/设置           | `问答`               | -                  | `query`                 |
+
+## 参数定义
+
+```json
+{
+  "action_type": {
+    "type": "string",
+    "enum": ["设置", "查询", "打开", "关闭", "切换"],
+    "description": "移动数据相关操作的动作类型，用于明确本次指令的主要行为。当涉及调整移动数据或流量相关配置时使用设置；当获取流量使用情况、账单、状态等信息时使用查询；当要求启用蜂窝移动数据连接时使用打开；当要求停用蜂窝移动数据连接时使用关闭；当在多张流量卡或不同配置之间进行选择时使用切换。"
+  },
+  "target": {
+    "type": "string",
+    "enum": [
+      "流量卡",
+      "流量使用情况",
+      "剩余流量",
+      "流量账单",
+      "移动数据",
+      "流量套餐限额提醒",
+      "流量控制",
+      "流量排行",
+      "流量校准",
+      "省流量模式"
+    ],
+    "description": "移动数据操作的具体对象，用于限定 action_type 的作用范围。当操作或查询指向对应流量管理模块时选择相应对象，以明确具体操作内容。"
+  },
+  "card": {
+    "type": "string",
+    "description": "指定需要操作或查询的本机手机卡类型。当设备支持多张流量卡或需区分主副卡流量情况时填写，用于精确定位目标流量卡。"
+  },
+  "period": {
+    "type": "string",
+    "description": "指定流量统计或查询的时间范围，用于限定流量使用情况、排行或账单数据的统计周期。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定执行移动数据或流量管理相关操作的应用名称。当明确要求在某个应用场景下进行流量控制、统计或策略配置时填写。"
+  }
+}
+```
+
+## Query 示例及输出
+
+### 示例 1: 打开移动数据
+
+**用户输入**: "帮我打开移动数据"
+
+**工具**: "mobile-data"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打开",
+  "target": "移动数据"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params "{\"actionType\":\"打开\",\"target\":\"移动数据\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params '{"actionType":"打开","target":"移动数据"}'
+```
+
+---
+
+### 示例 2: 切换默认流量卡
+
+**用户输入**: "把流量切换到卡2"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "切换",
+  "target": "流量卡",
+  "card": "卡2"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params "{\"actionType\":\"切换\",\"target\":\"流量卡\",\"card\":\"卡2\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params '{"actionType":"切换","target":"流量卡","card":"卡2"}'
+```
+
+---
+
+### 示例 3: 查询本月流量使用情况
+
+**用户输入**: "这个月用了多少流量"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "查询",
+  "target": "流量使用情况",
+  "period": "本月"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params "{\"actionType\":\"查询\",\"target\":\"流量使用情况\",\"period\":\"本月\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params '{"actionType":"查询","target":"流量使用情况","period":"本月"}'
+```
+
+---
+
+### 示例 4: 查询特定应用流量
+
+**用户输入**: "抖音这个月用了多少流量"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "查询",
+  "target": "流量使用情况",
+  "app": "抖音",
+  "period": "本月"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params "{\"actionType\":\"查询\",\"target\":\"流量使用情况\",\"app\":\"抖音\",\"period\":\"本月\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params '{"actionType":"查询","target":"流量使用情况","app":"抖音","period":"本月"}'
+```
+
+---
+
+### 示例 5: 设置流量限额提醒
+
+**用户输入**: "设置流量限额提醒为10GB"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "设置",
+  "target": "流量套餐限额提醒",
+  "value": "10GB"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params "{\"actionType\":\"设置\",\"target\":\"流量套餐限额提醒\",\"value\":\"10GB\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command mobile-data --params '{"actionType":"设置","target":"流量套餐限额提醒","value":"10GB"}'
+```
+
+---