@honor-claw/yoyo 1.1.4-beta.4 → 1.1.4-beta.5

package/index.ts

@@ -1,5 +1,6 @@
 import { type OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { registerCommands } from "./src/commands/index.js";
+import { AGENT_PROMPT } from "./src/modules/prompt/index.js";
 import { setYoyoRuntime } from "./src/runtime.js";
 import { YoyoPluginConfigSchema } from "./src/schemas.js";
 import { createClawConnectionService } from "./src/services/connection/index.js";
@@ -17,6 +18,11 @@ const plugin = {
     // 利用服务来管理核心连接任务进行~
     api.registerService(createClawConnectionService(api));
 
+    // Inject core skill & safety rules into system prompt every turn
+    api.on("before_prompt_build", async () => ({
+      prependSystemContext: AGENT_PROMPT,
+    }));
+
     // 注册所有的命令行
     registerCommands(api);
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "1.1.4-beta.4",
+  "version": "1.1.4-beta.5",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",
@@ -31,12 +31,14 @@
     "test:unit:watch": "vitest"
   },
   "dependencies": {
+    "@honor-claw/safe-exec": "0.0.1",
     "http-proxy-agent": "^8.0.0",
     "https-proxy-agent": "^8.0.0",
     "jsonwebtoken": "^9.0.3",
     "nanoid": "^5.1.6",
     "open": "^11.0.0",
     "undici": "^7.3.0",
+    "winreg": "^1.2.5",
     "ws": "^8.18.0",
     "zod": "^4.3.6"
   },

package/skills/yoyo-control/SKILL.md

@@ -107,6 +107,16 @@ Before executing any device control operation, you **MUST** consult the correspo
 | `schedule`           | `references/schedule-update.md`    | 日程编辑修改工具。用于修改设备上已创建日程的属性，支持修改时间、内容、地点等。当用户询问"修改/编辑/更改日程"等意图时调用。用于更新日程的工具。当用户意图涉及修改日程/安排属性时,属于编辑修改日程。               |
 | `wlan`               | `references/wlan.md`               | WLAN（无线网络、WiFi）管理工具。提供对WLAN及其相关能力的统一管理与控制，支持WLAN的开启与关闭、参数设置与状态查询，并可对WLAN使用的流量与流量提醒进行管理。                                                       |
 | `bluetooth`          | `references/bluetooth.md`          | 蓝牙设备管理工具。提供蓝牙设备的统一管理与控制，支持蓝牙的打开/关闭、参数设置、状态查询、设备搜索与配对，并能管理已接收的蓝牙文件。                                                                              |
+| `location-service`   | `references/location-service.md`   | 设备定位服务管理工具。支持开启/关闭定位、设置相关权限或策略，并查询当前定位服务状态。 |
+| `nfc`                | `references/nfc.md`                | 设备 NFC 管理与控制工具。支持开启/关闭、设置使用策略与参数、查询当前状态，以及基于 NFC 的刷卡感应操作。 |
+| `usb-shared-network` | `references/usb-shared-network.md` | 统一管理与控制 USB 共享网络功能，支持开启/关闭、参数设置与状态查询，可结合指定应用进行操作。 |
+| `eyecomfort`         | `references/eye-comfort.md`        | 护眼模式与视觉健康功能管理工具。支持开启/关闭、设置、查询与定时控制，并可独立管理助眠显示、干眼友好、视力舒缓、自然色彩显示及照明闪烁检测。 |
+| `brightness`         | `references/brightness.md`         | 屏幕亮度管理工具。支持开启/关闭、调高/调低、设定指定亮度值、查询当前亮度与自动调节状态，并可管理自动调节亮度功能。 |
+| `dark-mode`          | `references/dark-mode.md`          | 深色模式管理工具。支持开启、关闭、设置与查询，并可按指定应用执行操作，提升夜间或弱光环境下的观看舒适度。 |
+| `device-operation`   | `references/device-operation.md`   | 设备电源与屏幕控制工具，支持开机、关机、重启、待机、休眠、灭屏、亮屏、锁屏等操作，并可结合定时、二次确认与指定应用执行。 |
+| `status-bar-show`    | `references/status-bar-show.md`    | 状态栏显示统一管理工具。支持对运营商名称、实时网速、流量、通知与纯净模式进行开启、关闭、设置与查询，并可结合指定应用执行显示策略。 |
+| `autoscreen-onnotice`| `references/autoscreen-onnotice.md`| 管理收到通知时自动亮屏功能。支持开启/关闭、进入设置、查询当前状态，并可按指定应用进行精细化控制。 |
+
 
 ### Command and Parameters Construction Workflow
 

package/skills/yoyo-control/references/autoscreen-onnotice.md

@@ -0,0 +1,196 @@
+---
+name: autoscreen-onnotice
+description: >
+  管理收到通知时自动亮屏功能。支持开启/关闭、进入设置、查询当前状态，并可按指定应用进行精细化控制。
+---
+
+# Autoscreen Onnotice 通知自动亮屏
+
+## Tool Command
+```bash
+autoscreen-onnotice
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作类型: 设置/查询/打开/关闭                         │
+│  - 提取应用名称: 明确提及具体应用时识别                      │
+│  - 特殊处理: "开启/启用" → 映射为打开；"禁用/停用" → 关闭     │
+│  - 特殊处理: "设置/配置/进入设置页面" → 映射为设置；"查看状态 │
+│    /是否开启" → 映射为查询                                    │
+│  - 特殊处理: "消息"等同"通知"统一识别                         │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未指定应用时，默认为系统全局设置                          │
+│  - 未明确操作类型时，需向用户追问目标操作                    │
+│  - app仅当query含具体应用名称时填写                          │
+│  - 应用级操作需验证应用名称有效性                            │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装 actionType 及可选参数（app）                         │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "actionType": {
+    "type": "string",
+    "enum": [
+      "设置",
+      "查询",
+      "打开",
+      "关闭"
+    ],
+    "description": "必填参数，通知自动亮屏相关操作的动作类型，用于明确本次指令的主要行为。当涉及调整通知亮屏触发规则或应用范围时使用设置；当获取当前通知自动亮屏功能是否启用及其配置状态时使用查询；当要求启用收到通知时自动点亮屏幕的功能时使用打开；当要求关闭通知触发亮屏功能以减少干扰或节省电量时使用关闭。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定与通知自动亮屏功能相关的应用名称。当需要仅对某个特定应用的通知启用或禁用亮屏行为时填写。"
+  }
+}
+```
+
+### 参数注意事项
+1. 必填参数取值：`actionType` 为必填参数，且 `actionType` 的取值必须在枚举列表中。
+2. 同义词/间接表述映射: "开启/启用"→`打开`；"禁用/停用"→`关闭`；"设置/配置/进入设置页面"→`设置`；"查看状态/是否开启"→`查询`。
+3. 默认值或缺省行为: 未指定`app`时，操作作用于系统全局通知亮屏设置；当`actionType`为`查询`且未指定`app`时，返回系统全局状态。
+4. 参数间关联/依赖/互斥关系: 指定`app`时，`打开/关闭/查询`均限定在该应用范围内；`设置`一般为进入配置页面，`app`可选，用于进入某应用的相关配置。
+5. 可选参数填写条件: `app`仅在用户明确提及具体应用名称时填写，不做推断；应用名称需为设备上已安装或可识别的应用。
+
+## Query 示例及输出
+
+### 示例 1: 全局开启通知自动亮屏
+**用户输入**: "打开收到通知自动亮屏"
+
+**工具**: "autoscreen-onnotice"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "打开"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params "{\"actionType\":\"打开\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params '{"actionType":"打开"}'
+```
+
+---
+
+### 示例 2: 全局关闭通知自动亮屏
+**用户输入**: "关闭收到通知自动亮屏"
+
+**工具**: "autoscreen-onnotice"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "关闭"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params "{\"actionType\":\"关闭\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params '{"actionType":"关闭"}'
+```
+
+---
+
+### 示例 3: 进入通知自动亮屏设置页面
+**用户输入**: "进入收到通知自动亮屏设置页面"
+
+**工具**: "autoscreen-onnotice"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "设置"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params "{\"actionType\":\"设置\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params '{"actionType":"设置"}'
+```
+
+---
+
+### 示例 4: 仅微信通知自动亮屏
+**用户输入**: "打开微信消息亮屏"
+
+**工具**: "autoscreen-onnotice"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "打开",
+  "app": "微信"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params "{\"actionType\":\"打开\",\"app\":\"微信\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params '{"actionType":"打开","app":"微信"}'
+```
+
+---
+
+### 示例 5: 查询当前状态（全局）
+**用户输入**: "查看通知亮屏是否开启"
+
+**工具**: "autoscreen-onnotice"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "查询"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params "{\"actionType\":\"查询\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command autoscreen-onnotice --params '{"actionType":"查询"}'
+```
+
+---

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

@@ -0,0 +1,224 @@
+---
+name: brightness
+description: >
+  屏幕亮度管理工具。支持开启/关闭、调高/调低、设定指定亮度值、查询当前亮度与自动调节状态，并可管理自动调节亮度功能。
+---
+
+# Brightness 屏幕亮度管理
+
+## Tool Command
+```bash
+brightness
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                        │
+│  - 识别操作类型: 设置/查询/打开/关闭/调大/调小/设值         │
+│  - 识别操作对象: 亮度/自动调节亮度                         │
+│  - 提取设备名称: 设备名/别称（手机、电视、灯等）            │
+│  - 提取数值信息: 数字、百分比、级别、分数、极值、倍数       │
+│  - 判断数值表达类型: 数字/百分比/级别/分数/极值             │
+│  - 特殊处理: “变亮/提高/增强”→调大，“变暗/降低/减少”→调小   │
+│  - 特殊处理: “自动亮度/自适应亮度”统一识别为自动调节亮度    │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                             │
+│  - 未明确目标对象时，默认对“亮度”进行操作                   │
+│  - 未指定设备时，默认当前设备                               │
+│  - 数值缺失时，需向用户追问具体目标值或调整幅度             │
+│  - numberType仅当query含明确数值表达时填写，可据number推断  │
+│  - “最高/最大/最亮”与“最低/最小/最暗” → 映射为极值          │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                               │
+│  - 组装 actionType, target 及可选参数（device, number,      │
+│    numberType, app）                                        │
+│  - 生成平台特定的命令格式                                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "actionType": {
+    "type": "string",
+    "enum": ["设置", "查询", "打开", "关闭", "调大", "调小", "设值"],
+    "description": "必填参数，亮度相关操作的动作类型，用于明确本次指令的主要行为。当涉及亮度参数或调节策略的配置时使用设置；当获取当前亮度水平或自动调节状态时使用查询；当要求启用亮度显示或自动亮度功能时使用打开；当要求停用亮度相关功能（如自动调节）时使用关闭；当基于当前亮度基础上进行提升时使用调大；当基于当前亮度基础上进行降低时使用调小；当需要直接指定目标亮度数值时使用设值。"
+  },
+  "device": {
+    "type": "string",
+    "description": "指定执行亮度相关操作的设备名称。当存在多个可控设备或需明确作用对象时填写。"
+  },
+  "target": {
+    "type": "string",
+    "enum": ["亮度", "自动调节亮度"],
+    "description": "亮度调节的具体对象，用于限定 actionType 的作用范围。当进行屏幕亮度数值调整时选择亮度；当管理系统根据环境状态自动调整亮度的功能时选择自动调节亮度。"
+  },
+  "number": {
+    "type": "string",
+    "description": "亮度调整所使用的具体数值或表达结果，用于配合设值、调大或调小等操作，表示期望的调整幅度或目标亮度。"
+  },
+  "numberType": {
+    "type": "string",
+    "enum": ["数字", "极值", "百分比", "级别", "分数"],
+    "description": "用于描述 number 参数所采用的数值表达类型。当以具体数值表示亮度水平时使用数字；当使用最大或最小等边界值表达时使用极值；当按比例描述亮度变化时使用百分比；当以系统预设档位进行调节时使用级别；当以分段或分数形式描述亮度大小时使用分数。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定执行亮度相关操作的应用名称。当明确要求仅在某个特定应用场景下调整亮度显示效果时填写。"
+  }
+}
+```
+
+### 参数注意事项
+1. 必填参数取值：`actionType` 为必填参数，且 `actionType` 的取值必须在枚举列表中。
+2. **设置与调大/调小的区别**：`设值`为绝对值设定（"调到50"），`调大`/`调小`为相对值调整（"调大20"）
+3. **numberType 匹配**: `number` 需与 `numberType` 配合使用——"50"对应数字、"50%"对应百分比、"最大/最小"对应极值、"3格/3档"对应级别、"1/3/三分之一"对应分数
+4. **number取值规则**：如果numberType为“百分比”，该值必须为小数！！！如：用户说“调节音量到30%”，number取值为0.3"
+5. 同义词/间接表述映射: “变亮/调高/提高/增加/增强”统一识别为`actionType`=`调大`；“变暗/调低/降低/减少/减弱”统一识别为`actionType`=`调小`；“固定/锁定亮度/不要自动”识别为`actionType`=`关闭`且`target`=`自动调节亮度`；“自动亮度/自适应亮度”统一识别为`target`=`自动调节亮度`。
+6. 默认值或缺省行为: 未指明`target`时默认使用`亮度`；未提供`device`时默认当前设备；`numberType`可依据`number`内容推断，若`actionType`=`设值`但未提供`number`，需追问目标值。
+7. 参数间关联/依赖关系: `number`与`numberType`需一致（如含“%”对应`百分比`，“档/格”对应`级别`，“最高/最低”对应`极值`）。
+
+## Query 示例及输出
+
+### 示例 1: 打开自动调节亮度
+**用户输入**: "打开屏幕自动调节亮度"
+
+**工具**: "brightness"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "打开",
+  "target": "自动调节亮度"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command brightness --params "{\"actionType\":\"打开\",\"target\":\"自动调节亮度\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command brightness --params '{"actionType":"打开","target":"自动调节亮度"}'
+```
+
+---
+
+### 示例 2: 设定亮度为一半
+**用户输入**: "亮度调到一半"
+
+**工具**: "brightness"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "设值",
+  "target": "亮度",
+  "number": "一半",
+  "numberType": "分数"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command brightness --params "{\"actionType\":\"设值\",\"target\":\"亮度\",\"number\":\"一半\",\"numberType\":\"分数\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command brightness --params '{"actionType":"设值","target":"亮度","number":"一半","numberType":"分数"}'
+```
+
+---
+
+### 示例 3: 亮度设为3档
+**用户输入**: "亮度调大到3档"
+
+**工具**: "brightness"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "设值",
+  "target": "亮度",
+  "number": "3档",
+  "numberType": "级别"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command brightness --params "{\"actionType\":\"设值\",\"target\":\"亮度\",\"number\":\"3档\",\"numberType\":\"级别\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command brightness --params '{"actionType":"设值","target":"亮度","number":"3档","numberType":"级别"}'
+```
+
+---
+
+### 示例 4: 台灯亮度设为最高值
+**用户输入**: "台灯亮度调到最高值"
+
+**工具**: "brightness"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "设值",
+  "device": "台灯",
+  "target": "亮度",
+  "number": "最高",
+  "numberType": "极值"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command brightness --params "{\"actionType\":\"设值\",\"device\":\"台灯\",\"target\":\"亮度\",\"number\":\"最高\",\"numberType\":\"极值\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command brightness --params '{"actionType":"设值","device":"台灯","target":"亮度","number":"最高","numberType":"极值"}'
+```
+
+---
+
+### 示例 5: 查询电视当前亮度
+**用户输入**: "查询当前电视的亮度"
+
+**工具**: "brightness"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "查询",
+  "device": "电视",
+  "target": "亮度"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command brightness --params "{\"actionType\":\"查询\",\"device\":\"电视\",\"target\":\"亮度\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command brightness --params '{"actionType":"查询","device":"电视","target":"亮度"}'
+```

package/skills/yoyo-control/references/dark-mode.md

@@ -0,0 +1,200 @@
+---
+name: dark-mode
+description: >
+  深色模式管理工具。支持开启、关闭、设置与查询，并可按指定应用执行操作，提升夜间或弱光环境下的观看舒适度。
+---
+
+# Dark Mode 深色模式
+
+## Tool Command
+```bash
+dark-mode
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                          │
+│  - 识别操作类型: 设置/查询/打开/关闭                         │
+│  - 提取修饰词: 应用名称                                      │
+│  - 判断是否涉及应用级操作: 是否提及具体应用名                │
+│  - 特殊处理: "浅色外观/亮色模式/明亮模式" → 映射为关闭       │
+│  - 特殊处理: "夜间模式/黑暗模式/深色主题"等同义词统一识别    │
+│  - 特殊处理: "切换至/启用/打开"→打开；"关闭/禁用/退出"→关闭 │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                              │
+│  - 未指定操作类型时，需向用户追问动作意图                    │
+│  - 未指定应用名称时，默认为系统全局操作                      │
+│  - app仅当query含具体应用名时填写                            │
+│  - "切换深色模式"语义不明确时需确认目标状态                  │
+│  - 应用级操作需验证应用名称有效性                            │
+│  - query保持用户原始输入，不改写                              │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                │
+│  - 组装 actionType 及可选参数（app）                         │
+│  - 生成平台特定的命令格式                                    │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 参数定义
+```json
+{
+  "actionType": {
+    "type": "string",
+    "enum": [
+      "设置",
+      "查询",
+      "打开",
+      "关闭"
+    ],
+    "description": "必填参数，深色模式相关操作的动作类型，用于明确本次指令的主要行为。当涉及调整深色模式相关显示参数或策略时使用设置；当获取当前深色模式开启状态或配置信息时使用查询；当要求启用深色模式显示效果时使用打开；当要求停用深色模式并恢复其他显示样式时使用关闭。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定执行深色模式相关操作的应用名称。当用户明确要求仅在某个特定应用内启用、关闭或配置深色模式时填写。"
+  }
+}
+```
+
+### 参数注意事项
+1. 必填参数取值：`actionType` 为必填参数，且 `actionType` 的取值必须在枚举列表中。
+2. 同义词/间接表述映射: 用户口语化表述需映射到`actionType`。例如：`"浅色外观"、"亮色模式"、"明亮模式"`→`"关闭"`；`"夜间模式"、"黑暗模式"、"深色主题"`统一识别为深色模式相关；`"进入设置/配置深色模式"`→`"设置"`；`"启用/打开/切换到深色模式"`→`"打开"`；`"禁用/关闭/退出深色模式"`→`"关闭"`。
+3. 默认值或缺省行为: 未指定`app`时默认为系统全局操作；当无法从用户输入中可靠判断`actionType`时需追问确认，不进行默认推断。
+4. 参数间关联/依赖关系: 当`actionType`为`"设置"`、`"打开"`或`"关闭"`时，`app`可用于限定到某个应用；当`actionType`为`"查询"`时，若提供`app`则查询该应用的深色模式状态，未提供则查询系统全局状态。
+5. 可选参数填写条件: `app`仅在用户明确提及具体应用（如`"微信"、"微博"、"浏览器"`）时填写，不进行应用名称的推断或改写。
+
+## Query 示例及输出
+
+### 示例 1: 系统级开启深色模式
+
+**用户输入**: "打开深色模式"
+
+**工具**: "dark-mode"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "打开"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command dark-mode --params "{\"actionType\":\"打开\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command dark-mode --params '{"actionType":"打开"}'
+```
+
+---
+
+### 示例 2: 系统级关闭深色模式
+
+**用户输入**: "关闭深色模式"
+
+**工具**: "dark-mode"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "关闭"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command dark-mode --params "{\"actionType\":\"关闭\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command dark-mode --params '{"actionType":"关闭"}'
+```
+
+---
+
+### 示例 3: 进入深色模式设置页面
+
+**用户输入**: "进入深色模式设置页面"
+
+**工具**: "dark-mode"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "设置"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command dark-mode --params "{\"actionType\":\"设置\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command dark-mode --params '{"actionType":"设置"}'
+```
+
+---
+
+### 示例 4: 通过浅色外观反向关闭深色模式
+
+**用户输入**: "打开浅色外观"
+
+**工具**: "dark-mode"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "关闭"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command dark-mode --params "{\"actionType\":\"关闭\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command dark-mode --params '{"actionType":"关闭"}'
+```
+
+---
+
+### 示例 5: 口语化切换为开启
+
+**用户输入**: "请帮我切换深色模式"
+
+**工具**: "dark-mode"
+
+**JSON 参数**:
+```json
+{
+  "actionType": "打开"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+```bash
+cmd /c 'openclaw nodes invoke --node <ID> --command dark-mode --params "{\"actionType\":\"打开\"}"'
+```
+
+**Linux (Bash) 执行命令**:
+```bash
+openclaw nodes invoke --node <ID> --command dark-mode --params '{"actionType":"打开"}'
+```