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

package/skills/yoyo-control/references/volume-operate.md

@@ -0,0 +1,274 @@
+---
+name: volume.operate
+description: >
+  设备音量调节与管理工具。提供对设备音量的调节与管理功能，
+  支持音量的设置、调高、调低、开启与关闭，以及当前音量状态的查询；
+  可针对不同应用、不同设备及不同音量类型（如媒体、通话、通知等）进行精细化控制。
+---
+
+# Volume Operate 音量调节与管理
+
+## Tool Command
+
+```bash
+volume.operate
+```
+
+## 集成工作流
+
+### Step 1: 意图解析与参数组装
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  意图识别与参数提取                                           │
+│  - 识别操作类型: 设置/查询/打开/关闭/调大/调小/设值              │
+│  - 识别操作对象: 应用名称、设备名称、音量类型                   │
+│  - 提取数值信息: 数字、百分比、极值、级别、分数                  │
+│  - 特殊处理: "静音" → 关闭，"取消静音" → 打开                   │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  消歧与槽位填充                                               │
+│  - 多设备场景未指定设备时，默认操作当前设备                    │
+│  - 未指定音量类型时，默认操作系统主音量                        │
+│  - 数值表达需匹配对应的 numberType                            │
+│  - "调到/设为" + 数值 → actionType 为设值                   │
+│  - "调大/调小" + 数值 → actionType 保持调大/调小（相对调整） │
+└─────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────┐
+│  生成工具调用                                                 │
+│  - 组装 actionType 及可选参数                                 │
+│  - 生成平台特定的命令格式                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Step 2: 执行调用
+
+- 根据操作系统选择对应的命令格式
+- Windows: Cmd 格式（双引号需转义）
+- Linux: Bash 格式（单引号包裹）
+
+## 意图分类与参数映射
+
+| 用户意图       | 关键词示例                          | actionType | 可选参数                                              |
+| :------------- | :---------------------------------- | :--------- | :---------------------------------------------------- |
+| **设置音量**   | 设置/调整/调节 + 音量               | `设置`     | `app`, `device`, `volumeType`                         |
+| **查询音量**   | 查询/查看/当前 + 音量               | `查询`     | `device`, `volumeType`                                |
+| **打开音量**   | 打开/开启/恢复/取消静音 + 音量/声音 | `打开`     | `device`, `volumeType`                                |
+| **关闭音量**   | 关闭/静音/禁止 + 音量/声音          | `关闭`     | `device`, `volumeType`, `time`                        |
+| **调大音量**   | 调大/提高/增大/放大 + 音量          | `调大`     | `app`, `device`, `number`, `numberType`, `volumeType` |
+| **调小音量**   | 调小/降低/减小/下降 + 音量          | `调小`     | `app`, `device`, `number`, `numberType`, `volumeType` |
+| **设定具体值** | 设为/调到/调至 + 具体数值           | `设值`     | `app`, `device`, `number`, `numberType`, `volumeType` |
+
+## 参数定义
+
+```json
+{
+  "actionType": {
+    "type": "string",
+    "enum": ["设置", "查询", "打开", "关闭", "调大", "调小", "设值"],
+    "description": "音量操作的动作类型，用于明确本次指令的具体音量控制行为。当需要对音量进行开关、调整或设置具体数值时选择对应操作；当获取当前音量状态或大小时使用查询。"
+  },
+  "app": {
+    "type": "string",
+    "description": "指定需要进行音量控制的应用名称。当明确要求修改某个具体应用的音量时填写，用于限定音量操作的应用范围。"
+  },
+  "device": {
+    "type": "string",
+    "description": "指定执行音量操作的目标设备。当存在多个可控设备，或明确指出具体设备时填写，用于精确定位操作对象。"
+  },
+  "number": {
+    "type": "string",
+    "description": "音量调整的具体数值，用于设置或变化音量大小。当 actionType 为设值、调大或调小时，可结合 numberType 一同使用以明确调整幅度。"
+  },
+  "numberType": {
+    "type": "string",
+    "enum": ["数字", "极值", "百分比", "级别", "分数"],
+    "description": "音量数值的表达类型，用于说明 number 的含义。当采用不同计量方式描述音量大小时填写。"
+  },
+  "volumeType": {
+    "type": "string",
+    "enum": [
+      "来电",
+      "信息",
+      "通知",
+      "闹钟",
+      "音乐",
+      "视频",
+      "游戏",
+      "通话",
+      "YOYO助理",
+      "铃声",
+      "媒体",
+      "导航"
+    ],
+    "description": "需要操作或查询的音量类别，用于区分不同系统或场景音量。当需针对某一具体声音类型进行控制时填写。"
+  },
+  "time": {
+    "type": "string",
+    "description": "指定音量操作的执行时间，可用于定时或延时调整音量。当明确要求在某一时间点执行操作时填写。"
+  }
+}
+```
+
+### 参数注意事项
+
+1. **设值与调大/调小的区别**: `设值`为绝对值设定（"调到50"），`调大`/`调小`为相对值调整（"调大20"）
+2. **numberType 匹配**: `number` 需与 `numberType` 配合使用——"50"对应数字、"50%"对应百分比、"最大/最小"对应极值、"3格/3档"对应级别、"1/3/三分之一"对应分数
+3. **音量类型缺省**: 未指定 `volumeType` 时，默认操作系统主音量
+4. **同义词映射**: "静音"→关闭、"取消静音"→打开、"声音设为零"→设值(number=零)
+
+## Query 示例及输出
+
+### 示例 1: 调大音量
+
+**用户输入**: "调大播放音量"
+
+**工具**: "volume.operate"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "调大"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params "{\"actionType\":\"调大\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params '{"actionType":"调大"}'
+```
+
+---
+
+### 示例 2: 设定指定设备音量至百分比
+
+**用户输入**: "电视音量调小到30%"
+
+**工具**: "volume.operate"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "设值",
+  "device": "电视",
+  "number": "0.3",
+  "numberType": "百分比"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params "{\"actionType\":\"设值\",\"device\":\"电视\",\"number\":\"0.3\",\"numberType\":\"百分比\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params '{"actionType":"设值","device":"电视","number":"0.3","numberType":"百分比"}'
+```
+
+---
+
+### 示例 3: 打开指定设备的音量类型
+
+**用户输入**: "打开电视媒体音量"
+
+**工具**: "volume.operate"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "打开",
+  "device": "电视",
+  "volumeType": "媒体"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params "{\"actionType\":\"打开\",\"device\":\"电视\",\"volumeType\":\"媒体\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params '{"actionType":"打开","device":"电视","volumeType":"媒体"}'
+```
+
+---
+
+### 示例 4: 指定应用与设备精确设值
+
+**用户输入**: "将车载导航的提示音减小至40%"
+
+**工具**: "volume.operate"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "设值",
+  "app": "导航",
+  "device": "车载",
+  "number": "0.4",
+  "numberType": "百分比",
+  "volumeType": "其他"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params "{\"actionType\":\"设值\",\"app\":\"导航\",\"device\":\"车载\",\"number\":\"0.4\",\"numberType\":\"百分比\",\"volumeType\":\"其他\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params '{"actionType":"设值","app":"导航","device":"车载","number":"0.4","numberType":"百分比","volumeType":"其他"}'
+```
+
+---
+
+### 示例 5: 查询指定设备音量类型
+
+**用户输入**: "现在的电视通话音量"
+
+**工具**: "volume.operate"
+
+**JSON 参数**:
+
+```json
+{
+  "actionType": "查询",
+  "device": "电视",
+  "volumeType": "通话"
+}
+```
+
+**Windows (Cmd) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params "{\"actionType\":\"查询\",\"device\":\"电视\",\"volumeType\":\"通话\"}"
+```
+
+**Linux (Bash) 执行命令**:
+
+```bash
+openclaw nodes invoke --node <ID> --command volume.operate --params '{"actionType":"查询","device":"电视","volumeType":"通话"}'
+```
+
+---

package/skills/yoyo-control/scripts/invoke.js

@@ -1,119 +1,41 @@
 #!/usr/bin/env node
-/**
- * Device Control Invoke Script
- *
- * 封装 openclaw nodes invoke 命令，提供统一的设备控制接口
- * 使用配置文件方式避免 Windows PowerShell 对 JSON 参数的引号处理问题
- */
-
-import { exec } from "child_process";
-import { readFileSync } from "fs";
-import { resolve } from "path";
-import { promisify } from "util";
-
-const execAsync = promisify(exec);
-
-/**
- * 显示使用说明
- */
-function usage() {
-  console.error("用法: node invoke.js <config_file> [--debug]");
-  console.error("");
-  console.error("参数:");
-  console.error("  config_file - JSON 配置文件路径");
-  console.error("  --debug     - 启用调试模式");
-  console.error("");
-  console.error("配置文件格式:");
-  console.error("{");
-  console.error('  "nodeId": "设备ID",');
-  console.error('  "command": "命令标识",');
-  console.error('  "params": { ...参数对象 }');
-  console.error("}");
-  console.error("");
-  console.error("示例:");
-  console.error("  node invoke.js config.json");
-  console.error("  node invoke.js config.json --debug");
-  process.exit(2);
-}
-
-/**
- * 执行节点命令
- */
-async function invokeNode(nodeId, command, params, timeout = 15000, debug = false) {
-  const paramsStr = JSON.stringify(params);
-  const cmd = `npx openclaw nodes invoke --node ${nodeId} --command ${command} --params "${paramsStr.replace(/"/g, '\\"')}"`;
-
-  if (debug) {
-    console.log("=== 调试信息 ===");
-    console.log("执行命令:", cmd);
-    console.log("设备 ID:", nodeId);
-    console.log("命令标识:", command);
-    console.log("参数对象:", JSON.stringify(params, null, 2));
-    console.log("================");
-  }
-
-  try {
-    const { stdout, stderr } = await execAsync(cmd, {
-      timeout,
-      env: { ...process.env },
-      cwd: process.cwd()
-    });
-
-    if (debug) {
-      console.log("=== 执行结果 ===");
-      console.log("标准输出:", stdout.trim());
-      console.log("错误输出:", stderr.trim());
-      console.log("================");
-    }
-
-    return {
-      success: true,
-      data: stdout.trim(),
-      error: stderr.trim() || null
-    };
-  } catch (error) {
-    if (debug) {
-      console.log("=== 执行失败 ===");
-      console.log("错误信息:", error.message);
-      console.log("标准输出:", error.stdout?.trim() || "");
-      console.log("错误输出:", error.stderr?.trim() || "");
-      console.log("================");
-    }
-
-    return {
-      success: false,
-      data: error.stdout?.trim() || "",
-      error: error.stderr?.trim() || error.message
-    };
-  }
+import { execSync } from "child_process";
+import { parseArgs } from "util";
+
+const { values } = parseArgs({
+  options: {
+    node: { type: "string", short: "n" },
+    command: { type: "string", short: "c" },
+    params: { type: "string", short: "p", default: "{}" },
+  },
+  strict: true,
+  allowPositionals: true,
+});
+
+if (!values.node || !values.command) {
+  console.error("错误: 必须提供 --node 和 --command 参数");
+  console.error("用法: node invoke.js --node <nodeId> --command <command> [--params '<json>']");
+  process.exit(1);
 }
 
-// 主程序
-const args = process.argv.slice(2);
-const debugIndex = args.indexOf("--debug");
-const debug = debugIndex !== -1;
-if (debug) args.splice(debugIndex, 1);
+const { node, command, params } = values;
+const isWindows = process.platform === "win32";
+const escapedParams = isWindows ? JSON.stringify(JSON.parse(params)).replace(/"/g, '\\"') : params;
+const baseCmd = isWindows ?
+  `openclaw nodes invoke --node ${node} --command ${command} --params "${escapedParams}"` :
+  `openclaw nodes invoke --node ${node} --command ${command} --params '${escapedParams}'`;
 
-if (args.length === 0 || args[0] === "-h" || args[0] === "--help") {
-  usage();
-}
-
-const configPath = resolve(args[0]);
+console.log("BashCommand:", baseCmd);
 
 try {
-  const configContent = readFileSync(configPath, "utf-8");
-  const config = JSON.parse(configContent);
-  const { nodeId, command, params } = config;
-
-  if (!nodeId || !command) {
-    console.error("错误: 配置文件缺少必要字段: nodeId 或 command");
-    process.exit(1);
-  }
-
-  const result = await invokeNode(nodeId, command, params || {}, 15000, debug);
-  console.log(JSON.stringify(result, null, 2));
-  process.exit(result.success ? 0 : 1);
-} catch (error) {
-  console.error(`错误: ${error.message}`);
+  // Windows 环境使用 cmd.exe 执行
+  const execOptions = {
+    encoding: "utf8",
+    shell: isWindows ? "cmd.exe" : true,
+  };
+  const result = execSync(baseCmd, execOptions);
+  console.log("Node execute result:", result);
+} catch (e) {
+  console.error("Execute error:", JSON.stringify(e));
   process.exit(1);
 }

package/src/agent/copy-templates.ts

@@ -0,0 +1,56 @@
+import fs from "node:fs/promises";
+import path from "path";
+import { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { safeWriteFile, SafeFsError, type WriteMode } from "../utils/fs-safe.js";
+
+type TemplateEntry = {
+  file: string;
+  mode: WriteMode;
+};
+
+const TEMPLATE_FILE_LIST: TemplateEntry[] = [
+  { file: "AGENTS.md", mode: "overwrite" },
+];
+
+function resolveWorkspaceDir(api: OpenClawPluginApi): string {
+  const configuredWorkspace = api.config.agents?.defaults?.workspace?.trim();
+  if (configuredWorkspace) {
+    return api.resolvePath(configuredWorkspace);
+  }
+  return api.resolvePath("~/.openclaw/workspace");
+}
+
+export async function copyTemplateToWorkspace(api: OpenClawPluginApi): Promise<void> {
+  const pluginDir = path.dirname(api.source);
+  const templateDir = path.join(pluginDir, "src", "agent", "templates");
+  const workspaceDir = resolveWorkspaceDir(api);
+
+  for (const entry of TEMPLATE_FILE_LIST) {
+    const sourcePath = path.join(templateDir, entry.file);
+
+    try {
+      const content = await fs.readFile(sourcePath, "utf-8");
+
+      await safeWriteFile({
+        rootDir: workspaceDir,
+        relativePath: entry.file,
+        data: content,
+        mode: entry.mode,
+        mkdir: true,
+      });
+      api.logger.info(`Successfully wrote ${entry.file} to workspace (${entry.mode} mode)`);
+    } catch (error) {
+      if (error instanceof SafeFsError) {
+        if (error.code === "not-found") {
+          api.logger.warn(`Source file does not exist: ${sourcePath}`);
+          continue;
+        }
+        api.logger.error(`Failed to write ${entry.file}: ${error.message}`);
+      } else {
+        api.logger.error(
+          `Failed to write ${entry.file}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
+}

package/src/agent/index.ts

@@ -0,0 +1,3 @@
+import { copyTemplateToWorkspace } from "./copy-templates.js";
+
+export { copyTemplateToWorkspace };