客户端命令行
computer exec
使用自然语言指令在当前电脑上完成一次桌面操作任务。
更新于
fushou-agent computer exec 接收一条自然语言指令，在运行客户端的电脑上完成任务，等待任务结束后输出执行结果。适合一次性操作应用、窗口和本地文件。
本地交互
请先安装 Node.js 22.19.0 或更新版本。任务在本机执行，终端显示回复和工具调用；仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入。会话保存在本机缓存目录。
默认进入交互模式。不连接交互终端时自动使用非交互模式；脚本或其他智能体调用时请显式使用 -p（或 --prompt）。
命令格式
fushou-agent computer exec "<instruction>"
fushou-agent computer exec -p -- "- 请整理这些内容"
fushou-agent computer exec --resume SESSION_ID参数
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
instruction | 交互式可省略 | 无 | 非空自然语言指令。指令中包含空格时必须使用引号包裹；命令只接受一条指令。 |
fushou-agent login
fushou-agent computer exec "打开系统设置并查看当前系统版本"指令需要引用本机文件时，应提供绝对路径：
fushou-agent computer exec \
"打开文本编辑器并读取文件：/absolute/path/notes.txt"系统要求
- 支持 macOS、Windows，以及 Ubuntu Desktop 24.04 x86_64 的 GNOME Wayland 会话。
- macOS 需要为客户端授予辅助功能和屏幕录制权限。
- Linux 不支持 Xorg、WSL、无头会话或 ARM64；首次配置桌面会话后如收到提示，需要注销并重新登录一次。
- 任务期间不要退出目标应用或断开当前桌面会话。
结果与退出状态
交互模式仅在澄清工具提问时显示输入框并接收回答，其余时间不显示输入提示，也不接受补充指令。任务给出最终结果后立即停止接收输入，显示费用并自动退出；开始新任务需重新运行命令。执行期间可按 Ctrl+C 取消。已完成的应用或文件操作不会自动撤销。
非交互模式仅在 stdout 输出最终结果 JSON，不输出会话编号、工具过程或模型中间回复。使用 -p 或非交互终端时，始终不显示输入框，也不接收输入。需要澄清时保存问题和会话 ID，以退出码 2 结束；可在同一电脑的交互终端使用 --resume SESSION_ID 回答并继续，恢复时不要加 -p。其他退出码：0 完成，1 失败，130 取消。
恢复会话不会自动重放结果未知的操作。若提示上次操作或请求状态不确定，请先核对本地执行记录和控制台费用，再开始新任务。
常见错误
- 指令为空或没有使用引号包裹含空格的指令：传入一条完整的非空字符串。
- 客户端尚未登录：运行
fushou-agent login。 - macOS 无法读取或操作窗口：检查辅助功能和屏幕录制权限。
- Linux 没有可用桌面会话：使用受支持的 Ubuntu GNOME Wayland 图形会话。
可以在控制台/GUI智能体/自然语言调用页面查看调用记录。