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

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

@@ -0,0 +1,208 @@
+---
+name: hotspot
+description: >
+  个人热点管理工具。提供对个人热点功能的统一管理与控制，支持个人热点的开启与关闭、
+  参数设置以及当前状态查询，并可结合指定应用执行相关操作。
+---
+
+# Hotspot 个人热点管理
+
+## Tool Command
+
+```bash
+hotspot
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                         │
+│  - 识别操作类型: 打开/关闭/设置/查询                        │
+│  - 识别操作对象: 个人热点/热点/便携WLAN/便携式wifi          │
+│  - 提取修饰词: 应用名称、热点名称、密码、共享方式           │
+│  - 特殊处理: "设置页面/配置"类需求 → 标记为设置类型        │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                             │
+│  - 同义词识别: 热点/个人热点/便携WLAN/便携式wifi 统一映射   │
+│  - 应用级操作需验证应用名称有效性                           │
+│  - 状态查询类缺省时，默认查询当前热点开启状态               │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                               │
+│  - 组装 actionType, app 等参数                              │
+│  - 生成平台特定的命令格式                                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 意图分类与参数映射
+
+| 用户意图       | 关键词示例                                     | actionType | 可选参数 |
+| :------------- | :--------------------------------------------- | :--------- | :------- |
+| **开启热点**   | 打开/开启/启用 + 热点/个人热点/便携WLAN        | `打开`     | `app`    |
+| **关闭热点**   | 关闭/停用/停止/断开 + 热点/热点分享/便携WLAN   | `关闭`     | `app`    |
+| **参数设置**   | 设置/配置/修改 + 热点名称/密码/频段/最大连接数 | `设置`     | `app`    |
+| **状态查询**   | 查看/查询/获取 + 热点状态/连接设备/热点信息    | `查询`     | `app`    |
+| **进入设置页** | 进入/打开 + 热点设置/热点配置页面              | `设置`     | `app`    |
+
+## 参数定义
+
+```json
+{
+  "action_type": {
+    "type": "string",
+    "enum": ["设置", "查询", "打开", "关闭"],
+    "description": "个人热点相关操作的动作类型，用于明确本次指令的主要行为。当涉及调整个人热点名称、密码、共享方式或频段等配置时使用设置；当获取当前热点开启状态、配置信息或连接设备列表时使用查询；当要求启用个人热点功能时使用打开；当要求停用个人热点功能时使用关闭。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定执行个人热点相关操作的应用名称。当用户明确要求在某个特定应用内开启、关闭、配置或查询个人热点功能时填写。"
+  }
+}
+```
+
+## Query 示例及输出
+
+### 示例 1: 打开个人热点
+
+**用户输入**: "打开热点"
+
+**工具**: "hotspot"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打开"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params "{\"actionType\":\"打开\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params '{"actionType":"打开"}'
+```
+
+---
+
+### 示例 2: 关闭个人热点
+
+**用户输入**: "关闭热点"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "关闭"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params "{\"actionType\":\"关闭\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params '{"actionType":"关闭"}'
+```
+
+---
+
+### 示例 3: 停止热点分享
+
+**用户输入**: "停止热点分享"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "关闭"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params "{\"actionType\":\"关闭\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params '{"actionType":"关闭"}'
+```
+
+---
+
+### 示例 4: 进入热点设置页面
+
+**用户输入**: "进入热点设置页面"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "设置"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params "{\"actionType\":\"设置\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params '{"actionType":"设置"}'
+```
+
+---
+
+### 示例 5: 在特定应用中打开热点
+
+**用户输入**: "在设置中打开热点"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打开",
+  "app": "设置"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params "{\"actionType\":\"打开\",\"app\":\"设置\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command hotspot --params '{"actionType":"打开","app":"设置"}'
+```
+
+---

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

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