@honor-claw/yoyo 1.2.0 → 1.2.1-beta.1

package/skills/yoyo-control/references/express-logistics-search.md

@@ -0,0 +1,172 @@
+---
+name: express.logistics-search
+description: >
+  快递物流查询工具，支持单号跟踪与签收状态核实。
+---
+
+# Express Logistics Query 快递物流查询
+
+## Tool Provider
+```bash
+com.hihonor.magicvoice
+```
+
+## Tool Command
+```bash
+express_logistics_query
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作意图: 查询 + 快递物流状态/签收核实                │
+│  - 提取运单号: 连续数字/字母组合（如SF123456789）            │
+│  - 提取快递公司: 顺丰/中通/圆通/京东/邮政等                  │
+│  - 判断关注点: 仅签收状态/完整轨迹/最新节点                  │
+│  - 特殊处理: "快递/包裹/快件/物流"等同义词统一识别           │
+│  - 特殊处理: "到了吗/签收了没" → 映射为签收核实              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未提供运单号时，需向用户追问具体单号                      │
+│  - 未指定快递公司时，先按单号前缀尝试识别，失败再追问        │
+│  - 未说明关注点时，默认为查询最新物流节点                    │
+│  - "查签收/到了吗" → 映射为签收状态核实                      │
+│  - query 保持用户原始输入，严禁改写                          │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装空参数对象（无需传参）                                │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{}
+```
+
+### 参数注意事项
+1. **默认值或缺省行为**: 调用时 `params` 传 `{}`，工具基于内部解析从用户输入中抽取运单号、快递公司与关注点（例如签收核实或轨迹查询）。
+2. **同义词/间接表述映射**: “快递/包裹/快件/物流”统一视为物流查询；“到了吗/签收了没/收到了吗/有没有送达”统一视为签收状态核实。
+3. **格式/原样保留要求**: `query` 必须保持用户原始输入，作为上游意图解析依据；本工具不接收 `query` 作为参数，`params` 固定为 `{}`。
+
+## Query 示例及输出
+
+### 示例 1: 通用物流查询（未提供单号）
+**用户输入**: "查一下我的快递"
+
+**工具**: "express-logistics-query"
+
+**JSON 参数**:
+```json
+{}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command express-logistics-query --params \"{}\"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command express-logistics-query --params '{}'
+```
+
+---
+
+### 示例 2: 签收状态核实（未提供单号）
+**用户输入**: "我的快递签收了吗"
+
+**工具**: "express-logistics-query"
+
+**JSON 参数**:
+```json
+{}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command express-logistics-query --params \"{}\"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command express-logistics-query --params '{}'
+```
+
+---
+
+### 示例 3: 指定运单号查询
+**用户输入**: "看看快递单号为123456789的快递"
+
+**工具**: "express-logistics-query"
+
+**JSON 参数**:
+```json
+{}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command express-logistics-query --params \"{}\"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command express-logistics-query --params '{}'
+```
+
+---
+
+### 示例 4: 指定快递公司与单号查询
+**用户输入**: "帮我查一下顺丰快递单号987654321现在到哪了"
+
+**工具**: "express-logistics-query"
+
+**JSON 参数**:
+```json
+{}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command express-logistics-query --params \"{}\"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command express-logistics-query --params '{}'
+```
+
+---
+
+### 示例 5: 到件/签收意图识别
+**用户输入**: "查询我的包裹到了吗"
+
+**工具**: "express-logistics-query"
+
+**JSON 参数**:
+```json
+{}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command express-logistics-query --params \"{}\"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command express-logistics-query --params '{}'
+```

package/skills/yoyo-control/references/flashlight.md

@@ -0,0 +1,183 @@
+---
+name: flashlight
+description: >
+  设备手电筒功能管理工具，支持开启、关闭、参数设置与状态查询，
+  适用于弱光环境下临时照明与应急照明等场景。
+---
+
+# Flashlight 手电筒
+
+## Tool Provider
+```bash
+com.hihonor.magicvoice
+```
+
+## Tool Command
+```bash
+flashlight
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作类型: 设置/查询/打开/关闭                        │
+│  - 提取修饰词: 应用名称                                     │
+│  - 特殊处理: "电筒/手电/手机的灯"等同义词统一识别           │
+│  - 特殊处理: "点亮/开个灯/开闪光灯" → 映射为打开            │
+│  - 特殊处理: "关掉/熄灭/灭灯" → 映射为关闭                  │
+│  - 特殊处理: "调亮/调暗/亮度调低" → 映射为设置              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                             │
+│  - 未指定操作类型时，需根据动词语义推断或追问               │
+│  - 未指定应用名称时，默认为系统手电筒                       │
+│  - "点亮/开灯" → 映射为打开                                 │
+│  - "关灯/灭灯" → 映射为关闭                                 │
+│  - 验证规则：如指定 app，需验证应用名称有效性               │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                               │
+│  - 组装 actionType 及可选参数（app）                        │
+│  - 生成平台特定的命令格式                                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "actionType": {
+    "type": "string",
+    "enum": ["设置", "查询", "打开", "关闭"],
+    "description": "必填参数，手电筒相关操作的核心动作类型。当需要配置手电筒的相关参数或使用规则时使用设置；当获取手电筒当前启用状态或功能状态信息时使用查询；当开启手电筒以提供照明时使用打开；当关闭手电筒并停止照明时使用关闭。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定执行手电筒相关操作的应用名称。当明确要求在某个特定应用或系统入口中进行手电筒操作时填写。"
+  }
+}
+```
+
+### 参数注意事项
+1. **同义词/间接表述映射**: "点亮/开灯/开个灯/开闪光灯"→actionType="打开"；"关灯/关掉/熄灭/灭灯"→actionType="关闭"；"调亮/调暗/亮度调低/亮度调高"→actionType="设置"；"查看/查一下/现在状态"→actionType="查询"。
+2. **默认值或缺省行为**: `actionType` 为必填，无法省略，如语义不明确需追问。
+3. **可选参数填写条件**: `app` 仅在用户明确提及具体应用或入口（如“在相机里”“通过工具箱”）时填写，其余情况不填写。
+
+## Query 示例及输出
+
+### 示例 1: 开启手电筒
+**用户输入**: "打开手电筒"
+
+**工具**: "flashlight"
+
+**JSON 参数**:
+```json
+{"actionType":"打开"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"flashlight\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"flashlight","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
+```
+
+---
+
+### 示例 2: 关闭手电筒
+**用户输入**: "关闭手电筒"
+
+**工具**: "flashlight"
+
+**JSON 参数**:
+```json
+{"actionType":"关闭"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"flashlight\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"关闭\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"flashlight","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"关闭"}}'
+```
+
+---
+
+### 示例 3: 设置类（亮度相关表述）
+**用户输入**: "手电筒亮度调低一点"
+
+**工具**: "flashlight"
+
+**JSON 参数**:
+```json
+{"actionType":"设置"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"flashlight\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"设置\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"flashlight","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"设置"}}'
+```
+
+---
+
+### 示例 4: 同义表达开启
+**用户输入**: "打开手机电筒"
+
+**工具**: "flashlight"
+
+**JSON 参数**:
+```json
+{"actionType":"打开"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"flashlight\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"flashlight","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
+```
+
+---
+
+### 示例 5: 口语化开启
+**用户输入**: "请把手机的灯打开"
+
+**工具**: "flashlight"
+
+**JSON 参数**:
+```json
+{"actionType":"打开"}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"flashlight\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"actionType\":\"打开\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"flashlight","appPkg":"com.hihonor.magicvoice","arguments":{"actionType":"打开"}}'
+```

package/skills/yoyo-control/references/flight-monitor-create.md

@@ -0,0 +1,233 @@
+---
+name: flight-monitor.create
+description: >
+  创建机票价格监控任务。支持设置目的地、出发地、监控时间段与目标价格，缺省或低于最低监控价时给出价格区间与建议价。
+  只支持飞机票价的监控任务创建，其余票务类型（如酒店、机票联程、火车票等）暂不支持。
+---
+
+# Create Flight Monitor Task 创建机票监控任务
+
+## Tool Provider
+```bash
+com.hihonor.magicvoice
+```
+
+## Tool Command
+```bash
+create_flight_monitor_task
+```
+
+## 3. 业务规则
+
+### 适用场景及操作流程
+1. 解析并提取目的地城市、出发地城市、监控时间段与目标价格
+2. 未提供出发地时，默认使用用户当前位置城市
+3. 未提供目的地时，提醒用户指定目的地
+4. 对价格进行币种识别与人民币换算，并向下取整
+5. 当未指定监控价格或设定价格低于最低可监控价时，工具返回可监控价格区间与建议价
+6. 创建机票价格监控任务并开始持续监控
+
+### 特定交互
+- 币种默认人民币；如检测到外币（如 USD、美元），按实时汇率换算为人民币后取整
+- 城市名必须为具体城市中文名，不支持省份或国家级地名
+- 监控时间段使用用户原始的自然语言日期表述（如“下周二到下周三”“10月1日-10月7日”），不做改写
+- 价格仅提取数值部分，取整为不大于该值的整数；“以内/不高于/低于”等等价于上限价
+
+## 4. 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作意图: 创建 + 机票价格监控任务                      │
+│  - 提取目的地城市: 城市中文名（不含省/国家）                  │
+│  - 提取出发地城市: 城市中文名（缺省为当前位置）              │
+│  - 提取监控时间段: 自然语言日期描述（直接保留）              │
+│  - 提取目标价格: 数字，币种识别与换算，向下取整              │
+│  - 特殊处理: "飞/去/到" 等同义词统一识别为目的地              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未指定出发地时，默认为用户当前位置城市                    │
+│  - 未指定监控价格时，返回价格区间与建议价                    │
+│  - 价格低于最低可监控价时，提示范围并给出建议价              │
+│  - date_time 仅当 query 含时间表述时填写                     │
+│  - 验证规则: 目的地与出发地不能相同                          │
+│  - "从/出发地" → 映射为出发地槽位                            │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装 destination_city 及可选参数（departure_city,         │
+│    date_time, price）                                        │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 5. 参数定义
+### 工具输入参数说明
+```json
+{
+  "destination_city": {
+    "type": "string",
+    "description": "必填参数，机票监控的目的地城市中文名称，不支持省份或国家。如：深圳、北京。"
+  },
+  "departure_city": {
+    "type": "string",
+    "description": "机票监控的出发地城市中文名称，默认为用户当前位置所在城市，不支持省份或国家。如：深圳、北京。"
+  },
+  "date_time": {
+    "type": "string",
+    "description": "监控时间段的自然语言描述，直接提取用户输入中日期的描述。如：下周、下周二到下周三、周一下午。"
+  },
+  "price": {
+    "type": "integer",
+    "description": "用户设定的监控目标最高价格。直接提取价格数字，向下取整。默认币种人民币，其他币种需换算人民币。如果没有指定币种，按照人民币处理。"
+  }
+}
+```
+
+### 工具输出参数说明
+```json
+{
+  "result_code": {
+    "type": "integer",
+    "description": "结果状态码。100：执行成功。201：用户没有指定价格时返回，追问用户需要设置的监控价格，同时返回价格区间（suggested_price_range）与推荐价格（suggested_price）。202：追问，没有出发地城市，同时当前城市查询失败时追问。304：未授权三方账号，用户拒绝授权三方。406：授权三方失败。500：出发地不在支持列表范围内。501：目的地不在支持列表范围内。502：监控日期超出监控范围。503：查询监控价格失败，当前航线未查询到直飞航班报价。504：用户设置的监控价格过低，低于最低可监控价格，同时返回价格区间（suggested_price_range）与推荐价格（suggested_price）。505：监控任务创建失败。506：已存在重复监控任务。507：监控任务已达上限。"
+  },
+  "result_content": {
+    "type": "string",
+    "description": "针对不同状态码场景下，详细的执行结果，包含错误原因等。"
+  },
+  "suggested_price_range": {
+    "type": "string",
+    "description": "工具根据历史数据建议的价格区间，货币单位为人民币，格式为最低可监控价格-最高监控价格，如：500-1000。"
+  },
+  "suggested_price": {
+    "type": "integer",
+    "description": "工具建议的监控目标价格，货币单位为人民币。"
+  },
+  "departure_city": {
+    "type": "string",
+    "description": "出发地城市中文名称。如：深圳、北京。"
+  },
+  "destination_city": {
+    "type": "string",
+    "description": "目的地城市中文名称。如：深圳、北京。"
+  },
+  "date_range": {
+    "type": "string",
+    "description": "监控的日期范围，格式为 YYYY-MM-DD~YYYY-MM-DD。"
+  },
+  "price": {
+    "type": "integer",
+    "description": "用户设置的监控价格，货币单位为人民币，未提供或小于最低可监控价格则设为0。"
+  }
+}
+```
+
+
+### 参数注意事项
+1. **默认值或缺省行为**: 未提供`departure_city`时默认取用户当前位置城市；未提供`price`时由工具返回可监控价格区间与建议价；未标明币种时按人民币处理。
+2. **参数间关联/验证**: `destination_city`为必填且不得与`departure_city`相同；外币价格需先换算为人民币后再对`price`进行向下取整。
+3. **可选参数填写条件**: `date_time`仅在用户明确提及时间/日期时填写，不做推断；`departure_city`仅在用户未使用默认定位或明确指定时填写。
+
+### date_time 参数格式转换
+1. 当用户输入包含时间表述时，工具会直接保留原始的自然语言日期表述，然后调用`scripts/time_infer.py`时间推理模型进行转换。具体执行指令如下：
+```bash
+python3 scripts/time_infer.py --query <date_time>
+```
+2. 拿到json-string格式的转换结果，重新改写`date_time`参数，并调用`openclaw nodes invoke`命令执行工具。
+3. 注意：time_infer模型返回的结果格式如下：`{"data_time": {...}}`，用`{...}`JSONstring的完整内容重写`date_time`参数。**不能拆解{...}的内容**
+
+## 6. Query 示例及输出
+
+### 示例 1: 指定出发地、时间段与人民币价格上限
+**用户输入**: "帮我监控一下去上海的机票，出发地是北京，时间是十月一号到十月七号，价格设为1000元以内"
+
+**工具**: "create_flight_monitor_task"
+
+**JSON 参数**:
+```json
+{
+  "destination_city": "上海",
+  "departure_city": "北京",
+  "date_time": "十月一号到十月七号",
+  "price": 1000
+}
+```
+**调用时间推理模型**:
+```bash
+python3 scripts/time_infer.py --query "十月一号到十月七号"
+```
+返回结果: {"data_time": <json-string-data>} (注意字符串转义的问题！！！)
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"create_flight_monitor_task\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"destination_city\":\"上海\",\"departure_city\":\"北京\",\"date_time\":\"<json-string-data>\",\"price\":1000}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"create_flight_monitor_task","appPkg":"com.hihonor.magicvoice","arguments":{"destination_city":"上海","departure_city":"北京","date_time":"<json-string-data>","price":1000}}'
+```
+
+---
+
+### 示例 2: 仅目的地与美元价格（自动换算为人民币）
+**用户输入**: "帮我监控飞广州的机票，价格低于200美元就提醒"
+
+**工具**: "create_flight_monitor_task"
+
+**JSON 参数**:
+```json
+{
+  "destination_city": "广州",
+  "price": 1440
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"create_flight_monitor_task\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"destination_city\":\"广州\",\"price\":1440}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"create_flight_monitor_task","appPkg":"com.hihonor.magicvoice","arguments":{"destination_city":"广州","price":1440}}'
+```
+
+---
+
+### 示例 3: 指定目的地与出发时段，不设价格（工具返回建议价）
+**用户输入**: "帮我关注去杭州的机票，下周三下午出发"
+
+**工具**: "create_flight_monitor_task"
+
+**JSON 参数**:
+```json
+{
+  "destination_city": "杭州",
+  "date_time": "下周三下午"
+}
+```
+**调用时间推理模型**:
+```bash
+python3 scripts/time_infer.py --query "下周三下午"
+```
+返回结果: {"data_time": <json-string-data>} (注意字符串转义的问题！！！)
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command mcp.tool.call --params "{\"name\":\"create_flight_monitor_task\",\"appPkg\":\"com.hihonor.magicvoice\",\"arguments\":{\"destination_city\":\"杭州\",\"date_time\":\"<json-string-data>\"}}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command mcp.tool.call --params '{"name":"create_flight_monitor_task","appPkg":"com.hihonor.magicvoice","arguments":{"destination_city":"杭州","date_time":"<json-string-data>"}}'
+```