客户端与 Web UI 的关系说明
一、核心区别
Web UI（网页控制台）
定位：Gateway 的管理界面
访问方式：
- 浏览器访问：
http://localhost:18789
- 任何设备的浏览器都可以访问主要功能：
- ✅ 配置 Gateway（渠道、模型、路由）
- ✅ 查看会话历史
- ✅ 监控运行状态
- ✅ 管理 Cron 任务
- ✅ 直接与 AI 对话（测试用）
- ❌ 没有设备能力（摄像头、屏幕、语音）
- ❌ 没有后台运行
- ❌ 没有系统集成（菜单栏、通知）
类比：就像路由器的管理后台（192.168.1.1）
原生客户端（macOS/iOS/Android App）
定位：Gateway 的设备节点 + 管理界面
访问方式：
- 安装原生应用
- 系统级集成
主要功能：
- ✅ 配置 Gateway（与 Web UI 相同）
- ✅ 查看会话历史（与 Web UI 相同）
- ✅ 监控运行状态（与 Web UI 相同）
- ✅ 提供设备能力（摄像头、屏幕、语音、位置）
- ✅ 语音交互（语音唤醒、语音播报）
- ✅ 后台运行（持续监听、自动启动）
- ✅ 系统集成（菜单栏、通知、快捷键）
- ✅ 本地 Gateway 管理（启动/停止/重启）
类比：就像智能音箱（既能管理，又能交互）
二、架构关系图
三、具体对比
场景 1：配置 Telegram Bot
使用 Web UI
使用 macOS 客户端
结果：完全相同！两者都是在配置同一个 Gateway。
场景 2：与 AI 对话
使用 Web UI
使用 macOS 客户端
区别：macOS 客户端支持语音交互，Web UI 只支持文字。
场景 3：AI 需要看屏幕
使用 Web UI
使用 macOS 客户端
区别：macOS 客户端可以提供设备能力，Web UI 不能。
场景 4：跨设备协作
用户在 Telegram 问：“帮我拍一张我桌面的照片”
如果只有 Web UI：
如果有 iOS 客户端在线：
关键：原生客户端作为”设备节点”，可以被其他渠道调用。
四、完整的使用场景
典型部署架构
使用流程示例
早上 8:00 - 在家
上午 10:00 - 在办公室
中午 12:00 - 外出
下午 3:00 - 需要配置
晚上 8:00 - 在家
五、关键理解
1. Web UI 是”管理后台”
就像你的路由器管理界面：
- 可以配置设置
- 可以查看状态
- 但不能提供额外功能
2. 原生客户端是”设备节点 + 管理后台”
就像智能音箱：
- 可以配置设置（与 Web UI 相同）
- 可以查看状态（与 Web UI 相同）
- 还能提供设备能力（摄像头、语音、屏幕）
- 还能作为交互界面（语音对话）
3. 它们都连接到同一个 Gateway
所有的配置、会话、数据都存储在 Gateway 中。
4. 原生客户端可以被其他渠道调用
这是 Web UI 做不到的！
六、选择使用哪个？
只需要管理 Gateway
→ 使用 Web UI（浏览器访问即可）
需要语音交互
→ 使用 macOS/iOS 客户端
需要设备能力（摄像头、屏幕、位置）
→ 使用 macOS/iOS 客户端
需要后台运行、自动启动
→ 使用 macOS 客户端
需要跨设备协作
→ 使用 多个原生客户端
只是偶尔配置一下
→ 使用 Web UI（最方便）
七、总结
Web UI：
- 纯管理界面
- 浏览器访问
- 无设备能力
- 适合配置和监控
原生客户端：
- 管理界面 + 设备节点
- 原生应用
- 有设备能力（摄像头、语音、屏幕等）
- 适合日常交互和跨设备协作
关键点：
1. 它们都连接到同一个 Gateway
2. 它们的管理功能完全相同
3. 原生客户端额外提供设备能力
4. 原生客户端可以被其他渠道调用
5. 你可以同时使用多个（Web UI + macOS + iOS）
类比：
- Web UI = 路由器管理后台
- macOS 客户端 = 智能音箱 + 管理后台
- iOS 客户端 = 手机助手 + 管理后台
Loading...
