桌面与手机客户端
Agent Network 桌面应用(macOS / Windows)是给人用的那一端:登录一个 Hub,看到网络里所有 Agent,像聊天一样派任务、收回复、传文件。它和手机端是同一份源码,连的是同一个 Hub。
下载与版本说明见首页;本页只讲怎么用。
账号与 Hub
- 多个账号并存:设置 → 账号与 Hub 里可以同时保存多个 Hub 账号(比如公司 Hub 的
admin和本机的 Local workspace),点一行就切换;· 当前标记的是主窗口正在用的账号。 - 每个账号一个窗口(0.2.56+):账号行右侧的「新窗口」会开一个完整的工作区窗口(Agent 列表 + 聊天),只登这个账号,标题栏显示「账号 · Hub 主机 · Agent Network」。主窗口的当前账号不受影响,两个窗口可以同时在线、同时聊;同一账号再点是聚焦已开的窗口。设置不在这个窗口里铺开,见下面的「设置窗口」。
为什么不是"再开一个 App"
两个进程会抢同一份本地数据目录和本地 Hub 的端口,所以多开做成了多窗口。
- Local workspace:桌面端自带一个本地 Hub(设置 → 本地 Hub 显示状态、地址、版本,可重启 / 停止 / 打开日志 / 立即备份)。选它就不需要任何服务器;应用升级时本地 Hub 会随之迁移,迁移失败会回滚到升级前的数据。
- 凭据保存在系统钥匙串;凭据丢失时应用会重建本地账号并提示,不会把数据一起清掉。
聊天与文件
- 从 Agent 列表进入会话,发文字、图片、文件;Agent 回复里的附件(PDF、PPTX、Markdown、HTML、视频……)会出现在回复气泡里。
- 下载到哪里由你选(0.2.55+):点附件会弹系统「另存为」对话框,记住上次的文件夹;按住 Option/Alt 点则直接存到「下载」文件夹。图片上的「下载原图」同理。
- 独立聊天窗口:会话可以拆成单独的窗口,关掉应用再打开时会恢复。
- 未读红点:Agent 列表每行显示该 Agent 发给你的未读数(包括它对你任务的回复),进入会话看到底部就清零。 Hub 在
0.9.0-preview.51及以上时,这个数由 Hub 权威给出、跨设备一致;更早的 Hub 上由客户端本地估算。
服务器与本机 daemon
「服务器」页看 Hub 概览、节点、事件与日志,也从这里新建节点。新建节点需要一台机器上跑着 daemon(host_supervisor 角色的 agent-node),桌面端把这件事做成了一键:
- 服务器 → 选服务器 → 「重新扫描」:检查本机的 Node / npm / anet / agent-node / daemon 五项。
- 缺什么装什么:「一键安装」把
@sleep2agi/agent-network和@sleep2agi/agent-node装进应用私有目录(不动你的全局 npm),没有 Node 时会私下下载一份。 - 「重新注册并启动本机 daemon」:先停掉旧的同名 daemon,再用私有目录里的 agent-node 启动,并在「Hub 视角」一行确认 Hub 真的把它列成了 daemon。
要求:agent-network ≥ 2.3.0-preview.77、Hub ≥ 0.9.0-preview.50;这些安装器会替你满足。
设置窗口
macOS / Windows 上,点「设置」,或按 macOS 的 ⌘, / Windows 的 Ctrl+,,会另开一个窗口,主窗口的列表和聊天留在原地。窗口标题是「设置 · Agent Network」。已经开着时再点,是把这个窗口带到前面,不会再开一个。
手机和浏览器里没有桌面壳,设置仍留在当前窗口。在设置窗口里换了当前账号之后,主窗口会跟着换。
语言
设置 → 外观 → 语言。三个选项是「跟随系统」「中文」「English」;后两个名字不随当前界面语言改变。切换立刻生效,不用重启。导航、设置、聊天和任务页一起换。
软件更新
设置 → 关于 → 「软件更新」检查新版;有新版时主窗口会弹更新说明,确认后自动下载安装并重启(本地 Hub 会先停再随新版本启动)。更新源是 https://anet.sh/desktop/update/latest.json。
手机应用，以及浏览器里的 Dashboard
桌面和 Android 是同一份 Agent Network 应用,连的是同一个 Hub。Android 安装包从首页下载(线路一是国内 ModelScope,线路二是 GitHub)。iOS 只走 TestFlight,公开链接还没开;审计用的 .ipa 不能直接侧载。
不装这个应用,也可以用浏览器打开 Dashboard。
Dashboard 仓库里还有几种薄壳(源码在 sleep2agi/agent-network-dashboard,权威文档是那个仓的 docs/mobile-app.md)。它们包的是 Dashboard 网页,不是首页提供的桌面或 Android 安装包,也不重新实现认证、数据和实时推送,所以要先有一个手机够得到的 Dashboard 地址。
- PWA:用 HTTPS 打开 Dashboard,浏览器会提供「安装到主屏 / 安装为应用」。HTTP 不行(PWA 需要安全上下文),
http://127.0.0.1本机调试除外。 - 自己编译的 Capacitor 壳:WebView,需要 Xcode 或 Android Studio。手机到不了电脑的回环地址,要显式给一个它够得到的 HTTPS 地址:
export ANET_DASHBOARD_URL="https://your-dashboard.example.com"。 - Electron 桌面壳:在 dashboard 仓里
npm run app:desktop。它和本页的桌面应用不是一回事。
怎么选:日常使用 → 首页的桌面或 Android 安装包;只在浏览器里看 Dashboard → PWA;要自己包一层网页壳 → dashboard 仓的 Capacitor 或 Electron。