> ## 文档索引
> 获取完整文档索引： https://fushouagent.com/docs/llms.txt
> 先阅读此索引，了解所有可用页面。

# harmony rpa exec

> 按 ID 执行已验证的 RPA 脚本。

执行已保存脚本前，请先运行 `fushou-agent install --harmony` 准备 HDC。此命令只复用已有手机工具。

```bash
fushou-agent harmony rpa exec --script-id ID [--script-args JSON]
```

`--script-id` 必填；`--script-args` 是一个完整的 JSON 对象，可省略以使用参数默认值。脚本详情页的“复制客户端执行说明”和生成命令返回完全相同的调用说明。

```bash
fushou-agent harmony rpa exec --script-id '00000000-0000-0000-0000-000000000000' --script-args '{"members":["建国","居易"],"group_name":"测试群聊"}'
```

成功时 stdout 输出一行 JSON 格式的执行结果，失败时使用非零退出码。

请授予与普通 `exec` 相同的设备权限。设备锁定、未登录或缺少权限等不可恢复情况报错退出。按 Ctrl+C 或终止进程会停止本地任务，已完成操作不自动撤销。


`fushou-agent harmony rpa generate` 会输出脚本 ID，可以在控制台/GUI智能体/自动化脚本查看具体的脚本信息。调用成功后，可以在控制台/GUI智能体/脚本调用页面查看执行记录。

## 执行费用

RPA 脚本执行与 MCP 共用分钟单价，标准价为 0.1 元/分钟。仅从脚本实际执行开始计时，按实际时长折算分钟；下载、校验等准备时间不计费，执行不足一分钟也按实际时长计费。余额为负时请先充值。

限时免费：截至 2026 年 12 月 31 日，此功能免费；之后恢复标准价格 0.1 元/分钟。当前实际价格以[价格页面](/pricing)为准。

## 本地执行与自动调用

请先安装 Node.js 22.19.0 或更新版本。任务在本机执行，默认在终端显示执行过程；脚本调用请加 `-p`，非交互终端也会自动使用非交互模式。脚本执行费只计算执行时间，准备和下载时间不计费。已发生的模型调用与脚本执行费用在任务取消后仍会保留。

## 相关主题

- [harmony rpa generate](/docs/client/harmony/rpa/generate.md)
- [harmony exec](/docs/client/harmony/exec.md)