简体中文 · English · 日本語 · 한국어 · 繁體中文
在电脑和手机上统一看 Codex、Claude Code、Antigravity 和 Grok 的任务进度、随时续跑对话与批复权限 —— 一条命令装好即用,不改动原工具的任何配置与记录。 如果这个工具帮到了你,欢迎点击右上角 Star ⭐️ 支持一下。

14 秒总览:3D 梦工厂 · 多账号只读看板 · 5 秒扫码手机操控 · 开车免提语音审批
| 手机端 · 项目总控与 4 家实时监控 | 手机端 · 富文本对话、代码块与排队控制 |
![]() |
![]() |
只需要本机有 Node.js 22+ 和 Git(如未安装,脚本会自动提示安装命令)。
macOS / Linux(打开「终端」粘贴回车):
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bashLinux 支持 GTK/WebKitGTK 原生桌面壳和 systemd 用户服务;桌面依赖安装及无桌面、SSH、容器、WSL 的运行方式见 Linux 安装与运行。
Windows(打开 PowerShell 粘贴回车):
(irm https://hub.guuguo.top/install/agent-control.ps1).TrimStart([char]0xFEFF) | iex- 打开即用:安装完成后会自动打开控制台(macOS 会在「应用程序」生成 Agent Control 独立桌面应用,也可浏览器打开
http://127.0.0.1:43310)。 - 电脑端统一管理:左侧按项目查看所有正在跑或历史中的智能体任务,点进去即可续发消息、切换模型、设置自动推进或批量归档;同一智能体存在多个账号(如多 Codex 账号)时,列表与顶部栏自动标出具体账号归属。
- 手机扫码远程看:点页面右上角 「手机远程」 生成二维码,手机扫一下就能随时看输出、发指令、批权限。👉 查看手机扫码图文教程 · 固定链接与容器部署全指南
- 🚗 开车 / 免提语音总控(不强依赖 Gemini):点击顶部 「通话」 按钮即可开启免提语音通话(支持屏幕常亮、VAD 自动断句、说话打断、后台任务完成/待审批自动语音提醒与口头批准/拒绝)。
- 可选低延迟模型:不是所有人都有 Gemini/Antigravity,语音弹窗顶部支持直接切换后端模型——自动优选或手动选用 Claude Sonnet(低思考)、GPT-6.1 Terra(低思考)、Antigravity Hydrogen / Flash、Grok。所有非空语音内容均交由所选模型理解意图、定位目标并决定操作;模型不可用时明确报错,不回退到关键词规则。
- 跨平台语音收发:macOS 优先使用本地
mlx-whisper离线识别与edge-tts/say播报;未装本地 Whisper 时可回退为浏览器语音识别。播放只使用服务端生成的音频,不再调用手机或浏览器本机 TTS;没有可播放音频时保留文字并标记未播报(也可随时点击键盘图标打字调度)。
- 🔄 自动检测与跨端一键更新:左上/左下角与手机端菜单实时展示版本状态,支持定期检查远端提交、闲时自动平滑重启,并在更新时按源码指纹自动联动更新 macOS / Windows / Linux 桌面 App 壳子或快捷入口(也可执行
npm run version:bump统一维护服务与 UI 版本)。
展开 Agent 实时监控 可查看执行统计:按 Agent、模型、思考强度汇总成功轮次的中位/P90耗时、首输出、协议 Token 均值和工具次数,并查看最近30轮明细。支持24小时、7天、30天及全部记录筛选。数据从启用后的新轮次开始记录,最多保留5000轮,独立保存在数据目录的 execution-stats.json,不保存指令或回复正文。耗时含工具和审批等待,不含排队;/goal 续跑按轮记录。估算、部分上报、未上报分别标注,不混入协议 Token 均值;跨服务重启未收到终态的轮次标为“结束状态未记录”,不计入成功耗时。
安装时默认推荐 Cloudflare 免费临时隧道,同时支持以下固定链接与一键容器方案(在弹窗或命令行随时切换,不用重装):
| 方案 | 费用 | 域名是否固定 | 适合谁 | 特点 |
|---|---|---|---|---|
| Cloudflare 免费临时隧道(默认) | 0 元 | 临时随机 | 大多数人、零门槛体验 | 免服务器、免注册账号,5 秒出二维码、关闭即焚 |
| Tailscale Funnel | 0 元 | 永久固定(*.ts.net) |
想长期收藏到手机、不买域名/服务器 | 免费个人版即送固定 HTTPS 域名,支持在面板一键开启 |
| Cloudflare Named Tunnel | 0 元隧道 | 永久固定(自定义域名) | 手头已有 Cloudflare 托管域名 | 隧道永久免费不限时,服务常驻本机 |
| Sealos / Docker 一键中继 | Sealos 约 ¥5~15/月 | 永久固定 | 高频日用、多设备中继、不暴露本机端口 | 断网/重启自动重连,提供一键容器脚本与 Sealos 模板 |
| 仅本机使用 | 0 元 | — | 只在电脑上使用 | 不装任何隧道组件,后续随时可切换 |
macOS / Linux:
curl -fsSL https://hub.guuguo.top/uninstall/agent-control.sh | bashWindows (PowerShell):
(irm https://hub.guuguo.top/uninstall/agent-control.ps1).TrimStart([char]0xFEFF) | iex进阶用法、命令行切换、自托管部署与开发者说明(按需展开)
agent-control open # 打开桌面应用或控制台
agent-control status # 查看服务状态
agent-control logs # 查看服务日志
agent-control restart # 重启后台服务
agent-control remote status # 查看当前隧道/中继/固定链接状态
agent-control remote cloudflare # 切换或补装 Cloudflare 免费隧道
agent-control remote tailscale # 开启 Tailscale Funnel(0 元永久 *.ts.net)
agent-control remote relay # 切换并绑定自托管固定中继
agent-control update # 拉取最新版本并更新桌面端# 默认:Cloudflare 免费临时隧道
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote cloudflare
# Tailscale Funnel(0 元免域名固定链接)
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote tailscale
# 直接连接自己的中继服务器
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote relay --relay-url https://relay.example.com --invite 你的邀请码
# 仅本机使用
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote local- 任意带 Docker 的服务器(一行容器脚本):
git clone https://github.com/guuguo/agent-control.git && cd agent-control
./deploy/one-click.sh --url https://relay.example.com
# 如无公网 80/443 入站,可加 --cf-token <CloudflareTunnelToken> 自动打通 HTTPS- Sealos 容器云(实测约 ¥5~15/月):
- 图形界面 App Launchpad 直接填镜像
ghcr.io/guuguo/agent-control-relay:latest(端口8080、挂128Mi存储到/data); - 或用一键脚本
KUBECONFIG=~/.kube/sealos.yaml ./deploy/sealos/deploy.sh --host xxxx.cloud.sealos.run。 - 👉 完整图文步骤与环境变量说明见 docs/remote-deploy.md。
- 图形界面 App Launchpad 直接填镜像
- 签发一次性配对邀请码并在控制台「手机远程」或
agent-control remote relay中绑定:
RELAY_PUBLIC_URL=https://relay.example.com RELAY_KEY=你的密钥 npm run invite -- "My Mac"- 所有会话通过
<provider>:<profileId>:<rawId>复合 ID 只读索引,重命名/归档/置顶持久化于独立数据目录(macOS:~/Library/Application Support/Agent Control;Windows:%APPDATA%\Agent Control;Linux:~/.local/share/agent-control),不会修改原工具数据库。 - 常用环境变量:
PORT(默认43310)、HOST(默认127.0.0.1)、AGENT_CONTROL_DATA_DIR、AGENT_CONTROL_DISABLE_RELAY、AGENT_CONTROL_TITLE_RULES_FILE、AGENT_CONTROL_CODEX_HOMES、AGENT_CONTROL_CLAUDE_CONFIG_DIRS、AGENT_CONTROL_AGY_APP_DATA_DIRS、CODEX_BIN、CLAUDE_BIN、AGY_BIN。
按 Qoder 官方安装说明 安装 CLI,并在服务运行用户下执行 qoder login(旧命令名为 qodercli login,控制台同时支持发现两者)。Agent Control 使用官方 ACP 接口及本机登录状态,不读取登录凭证。
在底部 Agent 选择器选择 Qoder,可使用 Auto、Lite、Performance 模型档位,设置思考强度和权限,发送图片、查看流式回复与工具执行、处理审批、中断任务或加入控制端队列。切换模型、思考或权限后,下一轮重新加载原会话。
规划模式通过规划指令和控制端只读约束执行:拒绝文件写入、终端执行及工具授权请求;不会向不支持 --permission-mode plan 的 CLI 传入该值。
本次接入管理从 Agent Control 创建的 Qoder 会话,历史副本保存在 Agent Control 数据目录下的 qoder-threads.json;不会扫描或修改 Qoder 的外部历史。重启服务后仍通过原 session ID 续接。未提供积分余额查询;赠送额度、模型可用性和费用以对应 Qoder 账号为准。
可通过 QODER_BIN 指定 CLI 路径,AGENT_CONTROL_QODER_CONFIG_DIR 指定 Qoder 配置目录(默认 ~/.qoder)。侧边栏智能体筛选栏右侧的设置按钮可隐藏不常用的入口,显示偏好保存在当前浏览器中;隐藏后会话仍在“全部”中。
git clone https://github.com/guuguo/agent-control.git
cd agent-control
npm install
npm run check
npm test
npm run desktop:install # macOS 构建安装 /Applications/Agent Control.app全部自动测试均使用 Mock CLI 模拟智能体进程,不消耗任何真实模型 Token。
- 感谢 LINUX DO 社区佬友们的交流与反馈






