客户端说明
概览
了解 fushou-agent 统一客户端入口及其可用子命令。
更新于
fushou-agent 是测试用例、电脑、手机和设计稿相关命令的统一入口。运行根命令或 fushou-agent --help 可以查看当前操作系统支持的顶级子命令；使用 fushou-agent <COMMAND> --help 可以继续查看具体命令的参数。
编码智能体如何完成设计稿还原与自动化验证？
在 Codex、WorkBuddy 等编码智能体中安装并调用 fushou-agent Skill，可以把设计稿还原、用例生成与真实设备验证接入现有研发流程。接入步骤见安装与 Skill 配置。
- 设计稿还原度差：使用设计稿转代码智能体读取 Sketch / Figma 源文件，生成布局代码与切图，再按项目要求替换组件、接入接口。
- 写完代码自动化验证速度很慢：使用测试用例智能体从 PRD 生成 XLSX，在浏览器、电脑和手机上执行，结果写回表格。
- 不能操作真实的电脑和手机界面：使用GUI智能体根据自然语言操作电脑桌面和手机 App；界面操作支持 Skill、MCP、命令行三种接入方式。
支持 Windows、macOS、Ubuntu 24.04 及以上版本，以及连接到电脑的 Android、HarmonyOS、iOS 设备；iOS 仅由 macOS 客户端操作。浏览器用例单机最多支持 10 个浏览器并行，实际耗时取决于任务和设备条件。
命令格式
fushou-agent <COMMAND> [OPTIONS]
fushou-agent --help
fushou-agent --version不带参数运行 fushou-agent 与运行 fushou-agent --help 的效果相同。--version 或 -V 输出当前客户端版本。
子命令
| 子命令 | 简要说明 |
|---|---|
install | 安装测试用例依赖、通用 AGENTS Skill 和 iOS 真机能力。 |
uninstall | 卸载客户端、登录信息、配置、缓存和赋手智能体 Skill。 |
upgrade | 检查并升级客户端。 |
testcase | 管理测试用例。generate 从 PRD 生成 XLSX，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 逐项澄清，补充完整后继续，无需最终确认。