# Awesun Remote Control

> 向日葵远程控制(awesun-remote-control) 提供 22 个工具。使用场景包括：控制命令、控制连接、控制断开。关键词：远程控制，设备管理，桌面控制，远程CMD，远程电源管理。

- Skill: `dvcrn/awesun-remote-control` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add dvcrn/awesun-remote-control`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/awesun-remote-control/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/awesun-remote-control

---


# awesun-remote-control

向日葵远程控制(awesun-remote-control) 提供 22 个远程设备管理与操作工具。包括：设备管理，远程连接，远程桌面控制，远程命令执行，远程电源管理等功能。适用于需要通过编辑器对远程设备进行全面控制的场景。

## Available Tools (22)

### Device

- `device_add` - 将新设备添加到设备列表中，可设置设备名称和描述便于管理。添加成功后可通过 device_search 查询该设备。
    - **Required parameters**:
      - `name` (string): 设备的名称
    - **Optional parameters**:
      - `desc` (string): 设备的描述信息
- `device_info` - 查询指定设备的完整详细信息，包括硬件配置（CPU、内存、硬盘、显卡）、网络信息（IP地址、MAC地址）、系统版本、在线状态、支持的插件等。必须先通过 device_search 获取设备ID。
    - **Required parameters**:
      - `remote_id` (integer): 设备ID
- `device_remove` - 从设备列表中删除指定的设备，仅移除列表记录不会影响被控端软件，删除后无法恢复。删除前建议确认设备已不再需要使用。
    - **Required parameters**:
      - `remote_id` (integer): 设备ID
- `device_search` - 根据关键词模糊搜索设备列表中的设备，支持按设备名称检索，返回匹配的设备基本信息列表。常用于查找特定设备以进行后续远控操作。
    - **Required parameters**:
      - `limit` (integer): 查询结果数量限制，最大值为100
    - **Optional parameters**:
      - `keyword` (string): 查询关键字，支持模糊检索
- `device_shutdown` - 向在线的远程设备发送关机指令，设备需处于在线状态且被控端支持关机功能。指令下发后设备将在1-2分钟内完成关机并离线。
    - **Required parameters**:
      - `remote_id` (integer): 设备ID
- `device_update` - 修改指定设备的名称和描述信息，用于更新设备列表中的显示名称和备注，便于设备管理和识别。
    - **Required parameters**:
      - `remote_id` (integer): 设备ID
    - **Optional parameters**:
      - `desc` (string): 设备的描述信息
      - `name` (string): 设备的名称
- `device_wakeup` - 向绑定了开机硬件的设备发送开机指令，需要设备端配置开机棒或主板支持WOL功能。指令下发后设备将在1-2分钟内完成开机并上线。
    - **Required parameters**:
      - `remote_id` (integer): 设备ID

### Control

- `control_connect` - 发起与指定设备的远控会话连接，支持远程文件(file)、远程桌面(desktop)、远程CMD(cmd2)、远程SSH(ssh)、桌面观看(desktop_view)、远程摄像头(newcamera)、端口转发(forward)。连接成功后返回会话ID，用于后续的桌面操作、截图、命令执行等。
    - **Required parameters**:
      - `type` (string): 远控类型（远程文件=file|远程桌面=desktop|远程CMD=cmd2(适用于Windows)|远程SSH=ssh(适用于Linux/Mac)|桌面观看=desktop_view|摄像头=newcamera|端口转发=forward）
    - **Optional parameters**:
      - `remote_id` (integer): 被控设备ID（通过设备列表已存在的设备发起远控）
- `control_disconnect` - 终止指定的活跃远控会话，立即断开与该会话的连接。断开后如需再次操作需要重新调用 control_connect 建立连接。建议在不使用会话时及时断开以释放资源。
    - **Required parameters**:
      - `session_id` (string): 远控会话ID
- `control_portforward` - 在已建立的端口转发远程会话中配置端口转发规则（覆盖），需先建立有效的端口转发远程会话，用于实现本地与远程主机端口的双向数据转发。
    - **Required parameters**:
      - `session_id` (string): 远控会话ID（仅支持forward类型的远程会话）
      - `target_addresses` (array): 内网目标主机的IP或主机名:协议端口（仅支持TCP协议，支持同时配置多个，如：['127.0.0.1:22'
- `control_screenshot` - 对指定的远程桌面会话(desktop/desktop_view)进行截图，返回Base64编码的图片数据及尺寸信息。截图可用于获取远程设备的当前画面状态，辅助判断操作结果。
    - **Required parameters**:
      - `session_id` (string): 远控会话ID（仅支持desktop/desktop_view类型的远程会话）
- `control_sessions` - 查询所有当前活跃的远控会话，包括会话ID/会话类型和状态。获取的会话ID可用于截图、执行命令、桌面操作、断开连接等后续操作。
    - **Optional parameters**:
      - `type` (string): 远控类型，不传则返回所有远控会话（远程文件=file|远程桌面=desktop|远程CMD=cmd2|远程SSH=ssh|桌面观看=desktop_view|摄像头=newcamera|端口转发=forward）
- `control_command` - 在已建立的CMD远程会话中执行命令，目前支持Windows的CMD。返回命令的退出码、标准输出和错误输出。
    - **Required parameters**:
      - `command` (string): 要执行的命令
      - `session_id` (string): 远控会话ID（仅支持cmd2类型的远程会话）
    - **Optional parameters**:
      - `args` (array): 命令参数

### Desktop

- `desktop_click_mouse` - 在远程桌面会话中模拟鼠标点击操作，支持左键、右键、中键点击及双击。坐标需使用归一化值(0.0-1.0)，通过 x_pixel/屏幕宽度 计算。适用于按钮点击、菜单选择等场景。
    - **Required parameters**:
      - `button` (string): 点击鼠标按钮类型，可选值有：left
      - `clicks` (integer): 点击次数，传2则为双击
      - `coordinates` (array): 需要点击的坐标[x
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
- `desktop_drag_mouse` - 在远程桌面中模拟鼠标拖拽操作，支持按住指定按键(left/right/middle)沿路径移动。可用于文件拖拽、窗口调整大小、选择文本区域等。路径坐标需归一化(0.0-1.0)。
    - **Required parameters**:
      - `button` (string): 拖拽鼠标按钮类型，可选值有：left
      - `paths` (array): 滚动路径，每个坐标一组，格式['x
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
    - **Optional parameters**:
      - `hold_keys` (array): 拖拽鼠标时按下的键，可选值有：shift
- `desktop_move_mouse` - 将鼠标光标移动到远程桌面的指定坐标位置，坐标需归一化(0.0-1.0)。常用于拖拽操作前的定位、悬停触发菜单、或配合截图确定点击位置。仅移动不触发点击。
    - **Required parameters**:
      - `coordinates` (array): 目标坐标[x
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
- `desktop_paste_text` - 在远程桌面中通过系统剪贴板粘贴长文本内容，比逐字符输入更高效。适用于输入大段文本、代码、命令等场景。使用前需确保输入框已获取焦点，且被控端支持剪贴板同步。
    - **Required parameters**:
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
      - `text` (string): 需要粘贴的文本字符串
- `desktop_press_keys` - 在远程桌面中精确控制按键的按下或释放操作，适合需要精细控制按键状态的场景。支持单独按下(down)、单独释放(up)，或不指定时自动按下后释放。可用于长按、连击等复杂操作。
    - **Required parameters**:
      - `keys` (array): 按键序列，如control
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
    - **Optional parameters**:
      - `press` (string): 按键操作，可选值有：up/down (如果不填则默认为先按下后释放，如果传入down，则一定要再调用一次up)
- `desktop_scroll_mouse` - 在远程桌面的指定位置模拟鼠标滚轮滚动，支持向上(up)或向下(down)滚动指定次数。用于滚动网页、文档、列表等内容查看。坐标需归一化(0.0-1.0)。
    - **Required parameters**:
      - `coordinates` (array): 坐标[x
      - `direction` (string): 滚动方向，可选值有：up
      - `scroll_count` (integer): 滚动次数
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
- `desktop_typing_keys` - 在远程桌面中执行组合快捷键操作，如复制(Ctrl+C)、粘贴(Ctrl+V)、保存(Ctrl+S)等。按顺序按下所有按键，延迟后再按相反顺序释放。适合需要同时按住多个键的场景。
    - **Required parameters**:
      - `keys` (array): 按顺序键入的键名称数组，如control
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
    - **Optional parameters**:
      - `delay` (integer): 按下和释放按键之间的延迟（以毫秒为单位）
- `desktop_typing_text` - 在远程桌面中逐字符模拟键盘输入文本，适合输入短文本内容。输入前需确保输入框已获取焦点。可设置字符间延迟(毫秒)控制输入速度。
    - **Required parameters**:
      - `session_id` (string): 远控会话ID（仅支持desktop类型的远程会话）
      - `text` (string): 需要输入的文本字符串
    - **Optional parameters**:
      - `delay` (integer): 字符输入间隔，单位毫秒
- `desktop_waiting` - 在远控操作序列中插入暂停等待，用于在关键操作后等待系统响应或页面加载完成。指定持续时间(毫秒)后自动继续执行后续工具。建议在网络延迟或UI渲染场景中使用。
    - **Required parameters**:
      - `duration` (integer): 暂停时间单位：毫秒（UI 渲染等待建议：≤500ms，避免过长等待）

## Instructions

### Standard Call Flow

1. **Identify the tool** - Choose the appropriate tool from the list above
2. **Get tool parameters** (optional) - If unsure about parameter format:

   ```bash
   cd ~/.claude/skills/awesun-remote-control
   python executor.py --describe <tool_name>
   ```

3. **Execute the tool call**:

   ```bash
   cd ~/.claude/skills/awesun-remote-control
   python executor.py --call '{"tool": "<tool_name>", "arguments": {...}}'
   ```

If `python` command not found, try `python3` instead.

### Error Handling

If execution fails:

- Check tool name is correct
- Use `--describe` to view required parameters
- Ensure MCP server is accessible

## Examples

```bash
# List all tools
python executor.py --list

# Get tool details
python executor.py --describe <tool_name>

# Execute a tool
python executor.py --call '{"tool": "example", "arguments": {}}'
```