用手机监控AI编码代理：Agent of Empires Web仪表盘与PWA完整指南-港品优选

用手机监控AI编码代理：Agent of Empires Web仪表盘与PWA完整指南

【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empires

Agent of Empires（简称 AoE）是一款面向 Linux 和 macOS 的 AI 编码代理会话管理器，支持 Claude Code、OpenCode、Codex CLI、Gemini CLI 等十余种代理。它的 Web 仪表盘让你只需一条命令，就能在手机上以浏览器或 PWA 应用的形式实时监控、审批和操控这些 AI 代理，再也不必守在终端前。

为什么需要手机端的 Web 仪表盘

AoE 的核心设计是让每个 AI 代理都跑在独立的 tmux 会话里，关掉终端、断开 SSH 它们仍在后台运行。但"在跑"不等于"可控"——当代理等待审批、卡住或报错时，你需要第一时间知道。

Web 仪表盘内嵌在aoe二进制中，随每个发行版提供，无需额外安装。会话运行在服务端，浏览器崩溃、断网、重连都不会影响代理本身，刷新页面一切还在原地。

快速启动：三条命令打开手机仪表盘

在安装了 tmux 和 AoE 的机器上（可用brew install aoe安装，详见 docs/installation.md）：

aoe serve # 仅本机访问（默认） aoe serve --remote # 通过 HTTPS 隧道远程访问，手机推荐 aoe url # 打印当前有效的访问地址

本机访问：终端会打印带鉴权 token 的 URL，首次访问后 token 自动变成 Cookie。
远程访问：--remote模式优先使用 Tailscale Funnel（稳定的 HTTPS 域名），其次是你自己命名的 Cloudflare 隧道，最后回退到零配置 quick tunnel（每次重启 URL 会变）。--remote还会在终端打印二维码，手机扫码即可直达。
守护运行：加--daemon放后台，配合--open可自动打开浏览器；--remote模式下 token 每 4 小时轮换一次，用aoe url随时取最新地址。

完整的参数、反向代理与安全配置，见 docs/guides/web-dashboard.md。

手机端使用体验：触控优化的终端与结构化视图

手机上打开后，仪表盘自动切换为单栏布局：顶栏按钮可以在代理终端、配对终端、Diff、文件等面板间切换，切走的面板在后台保活，滚动位置与焦点都不会丢失。

终端视图把 tmux 窗格逐行推送到浏览器渲染成真实文本：滚动、选中即复制、捏合缩放字号都是原生手势。代理在运行中你也能随时翻回历史，滑到底部出现"回到实时"按钮。

对于 ACP 类代理（如 Claude Code），推荐使用结构化视图：对话流、工具调用卡片、Todo 清单和审批框一应俱全，比纯终端更适合触屏操作。

代理请求执行git push等敏感命令时，会弹出审批卡片，点Allow / Always / Deny即可在手机上完成授权：

移动端交互细节（软键盘工具条、中断、粘贴、Ctrl切换等）见 docs/guides/web/terminal.md。

一键安装为 PWA：像原生 App 一样使用

仪表盘是一个标准的渐进式 Web 应用（PWA）：

Chrome/Android：菜单 → 安装 Agent of Empires
Safari/iOS：分享 → 添加到主屏幕

两点建议：

从 Tailscale Funnel 或命名 Cloudflare 隧道安装，因为 PWA 绑定安装时的 URL，quick tunnel 的地址每次重启都会变化，装上去就会失效。
用aoe serve --daemon保活。再次打开 PWA 会自动回到你上次停留的会话（按设备记忆）；服务器重启后客户端秒级自动重连。

推送通知：代理需要你时，锁屏即提醒

AoE 支持标准 Web Push：会话进入等待审批、空闲结束或出错时，浏览器/手机推送通知，iOS 上出现在锁屏，点击深链直达对应会话。审批和问题类通知不受抑制，即使你正开着页面也会弹 Toast 提醒。

在设置页的Notifications标签里开启并发送测试通知即可（iOS 需先从主屏幕打开已安装的 PWA 再授权）。设置页与 TUI 共用同一套配置模式，字段永不漂移：

配置与排障步骤见 docs/push-notifications.md。

手机上审查代码：Diff 视图

代理写完代码后，直接在手机上审查：变更文件按目录树或平铺列表展示，带状态字母（A/M/D）和增删行数；点开文件是语法高亮的统一/分栏 diff。结构化视图会话还能在 diff 行上写批注，一键把评论打包发给代理修改。详情见 docs/guides/diff-view.md。

安全要点速览

默认使用 256 位随机 token（URL 传入后转为 HttpOnly Cookie），也可改用口令墙，--remote下两者强制叠加，token 每 4 小时轮换。
想只看不操作？加--read-only进入只读监控模式，拒绝一切按键输入。
已登录设备可在Settings → Web Dashboard → Connected Devices逐台撤销。
服务端内置 DNS rebinding 防护与--auth=none --host 0.0.0.0等危险组合的启动拦截。

企业官网建设流程全解析