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

# 概览

> 了解 fushou-agent 统一客户端入口及其可用子命令。

`fushou-agent` 是测试用例、电脑、手机和设计稿相关命令的统一入口。运行根命令或 `fushou-agent --help` 可以查看当前操作系统支持的顶级子命令；使用 `fushou-agent <COMMAND> --help` 可以继续查看具体命令的参数。

## 编码智能体如何完成设计稿还原与自动化验证？

在 Codex、WorkBuddy 等编码智能体中安装并调用 fushou-agent Skill，可以把设计稿还原、用例生成与真实设备验证接入现有研发流程。接入步骤见[安装与 Skill 配置](/docs/client/install)。

- **设计稿还原度差**：使用[设计稿转代码智能体](/product/design-to-code)读取 Sketch / Figma 源文件，生成布局代码与切图，再按项目要求替换组件、接入接口。
- **写完代码自动化验证速度很慢**：使用[测试用例智能体](/product/testcase-agent)从 PRD 生成 XLSX，在浏览器、电脑和手机上执行，结果写回表格。
- **不能操作真实的电脑和手机界面**：使用[GUI智能体](/product/gui-agent)根据自然语言操作电脑桌面和手机 App；界面操作支持 Skill、MCP、命令行三种接入方式。

支持 Windows、macOS、Ubuntu 24.04 及以上版本，以及连接到电脑的 Android、HarmonyOS、iOS 设备；iOS 仅由 macOS 客户端操作。浏览器用例单机最多支持 10 个浏览器并行，实际耗时取决于任务和设备条件。

## 命令格式

```bash title="Terminal"
fushou-agent <COMMAND> [OPTIONS]
fushou-agent --help
fushou-agent --version
```

不带参数运行 `fushou-agent` 与运行 `fushou-agent --help` 的效果相同。`--version` 或 `-V` 输出当前客户端版本。

## 子命令

| 子命令 | 简要说明 |
| --- | --- |
| `install` | [安装测试用例依赖、通用 AGENTS Skill 和 iOS 真机能力](/docs/client/install)。 |
| `uninstall` | [卸载客户端、登录信息、配置、缓存和赋手智能体 Skill](/docs/client/install#卸载客户端)。 |
| `upgrade` | [检查并升级客户端](/docs/client/upgrade)。 |
| `testcase` | 管理测试用例。[`generate`](/docs/client/testcase/generate) 从 PRD 生成 XLSX，[`exec`](/docs/client/testcase/exec) 创建并等待执行任务。 |
| `design` | 转换本地 Sketch/Figma 设计稿，或在本地列出和过滤 OpenAPI、Swagger、ApiFox 接口定义。 |
| `computer` | 操作当前电脑。提供自然语言任务 `exec`、已保存脚本 `rpa exec` 和本地 MCP 服务 `mcp`。 |
| `android` | 操作 Android 设备。提供 `exec`、`rpa exec` 和 `mcp`。 |
| `harmony` | 操作 HarmonyOS 设备。提供 `exec`、`rpa exec` 和 `mcp`。 |
| `ios` | 操作 iOS 真机。提供 `exec`、`rpa exec` 和 `mcp`，仅在 macOS 客户端中可用。 |

非 macOS 客户端的根帮助不会列出 `ios`。各命令的参数、环境变量和设备要求以对应页面为准。

## 本地 Agent 与会话

电脑、手机和测试用例任务由本机 Agent 执行。请安装 Node.js 22.19.0 或更新版本，首次运行会准备依赖。交互终端默认显示执行过程并允许回答问题；自动化调用显式加 `-p` 或 `--prompt`。`design` 保持原有用法。

本地 Agent 可读取指定行区间、局部编辑文件、搜索文件内容和执行命令。开始任务前执行 `fushou-agent install --browser`，提前安装文件搜索所需组件；Windows 另可执行 `install --bash` 准备 Git Bash，并支持 PowerShell。

任务给出最终结果后，会话关闭输入，显示结果与费用并自动退出。已结束的会话不能继续追问；新任务需重新运行命令。RPA 生成的中间阶段和测试任务中的单条用例结束时，整个任务仍会继续。

会话记录位于客户端本地缓存目录下的 `agent/sessions`，截图附件保存在同一缓存目录。需要澄清时可根据返回的会话 ID 使用对应命令的 `--resume` 继续。删除本机缓存会失去这些记录，控制台不保存完整执行过程。

交互模式仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入。除 `rpa generate` 外，`-p` 或非交互终端始终不接收输入；需要澄清时保存问题并以退出码 `2` 结束。可稍后在交互终端通过 `--resume` 恢复，恢复时不要加 `-p`。

交互模式显示工具调用名称、参数及失败时的具体错误，不显示执行中或输入检查提示，也不显示工具成功提示。非交互模式只输出最终结果 JSON；完整执行过程仍保存在本地会话中。

本地 Agent 执行期间显示系统活动图标：macOS 位于菜单栏，Windows 位于系统托盘，Linux 显示在支持状态图标的桌面环境中。任务退出后图标消失；电脑操作会显示当前目标应用，手机任务使用手机标识。

澄清问题提供选项时，Agent 如有明确推荐，会将该选项放在第一位并标注“（推荐）”。你可以输入选项编号，也可以直接填写自己的答案。

模型由服务端任务配置选择，费用可在控制台查看。同一任务可能产生多条消费明细；任务页面显示汇总费用。

任务执行期间，模型请求遇到临时网络错误或服务繁忙时，会自动重试最多 3 次，依次等待 2、4、8 秒。交互终端显示重试次数和错误原因，等待期间可以取消任务；已完成的工具操作会保留。重试仍失败时，终端显示具体错误。连接中断前的请求可能已经产生费用，因此重试可能增加模型费用。

`rpa generate` 仅支持交互模式，即使传入 `-p/--prompt` 也保持交互；没有交互终端时退出 `1`。需求完整时直接开始生成，缺失或有歧义时通过 `ask_user` 逐项澄清，补充完整后继续，无需最终确认。

## 相关主题

- [安装客户端能力](/docs/client/install.md)
- [testcase generate](/docs/client/testcase/generate.md)
- [testcase exec](/docs/client/testcase/exec.md)
- [computer exec](/docs/client/computer/exec.md)
- [android exec](/docs/client/android/exec.md)
- [design](/docs/client/design.md)