Portable AI 支持连接自建 Gateway 与 Agent API Server，在手机上与 AI Agent 多轮对话，支持语音输入、TTS 播报与文件发送。
无需开发插件：Gateway 走 WebSocket，Agent Server 走 HTTP + SSE。在 App 中选择服务器类型即可连接。
设置页可选 Gateway（WebSocket，默认端口 18789）或 Agent Server（API Server，默认端口 8642），访问令牌本地保存，支持多服务器切换与自动重连。
Gateway 使用 sessions.* / chat.* 事件；Agent Server 使用会话 SSE 与兼容流式接口，多轮对话流畅自然。
App 端集成百度 ASR（plus.speech），H5 端支持 Web Speech API，按住麦克风说话，松手即发送。
HomeAi-Tts 原生插件 + 百度 REST 回退，Agent 回复可自动朗读，设置页一键开关。
支持相册选图、预览保存与 iOS 系统分享扩展；Gateway 经 chat.send attachments，Agent Server 优先走 REST 会话聊天。
Gateway 提供更完整的 Token / 费用趋势；Agent Server 展示客户端累计与健康 / 模型信息。状态页可查看连接与服务健康。
延续 App 粉蓝渐变设计语言，圆角卡片与柔和阴影，让移动端 AI 对话既专业又亲切。
按后端类型选择 Gateway 或 Agent API Server，在 App 中配置地址与访问令牌即可开始对话。
确保 Gateway 已运行，在 Portable AI 中选择服务器类型 Gateway，配置地址与访问令牌即可开始对话。
在服务器或本机启动 Gateway 服务。
gateway --port 18789
在 App「服务器配置」页选择 Gateway，填写地址与访问令牌，支持 ws / wss。
ws://192.168.x.x:18789
首次连接若报 pairing required，在 Gateway 主机批准设备。
devices approve <requestId>
连接成功后进入聊天页，文字、语音或附件均可发送给 Agent。
chat.send → 流式 chat 事件
启用 Agent API Server（HTTP + SSE），在 App 中选择服务器类型 Agent Server 并填写访问令牌。
在 Agent Server 环境变量中开启 API Server，并设置访问令牌。
API_SERVER_ENABLED=true
运行 Agent Server；默认在本机 8642 端口提供 API。
agent-server
App 选择 Agent Server，填写主机（API Server 端口，勿填 Dashboard）与访问令牌。
http://192.168.x.x:8642
Bearer 鉴权通过后即可流式聊天；Agent Server 无需设备配对。
Authorization: Bearer <API_SERVER_KEY>
Portable AI 同时支持 Gateway（WebSocket）与 Agent API Server（HTTP + SSE），无需在服务端开发插件，选好类型并配置访问令牌即可在手机上使用。
支持多会话切换、历史记录加载与实时流式输出。Agent 回复逐字呈现，工具调用结果以卡片形式展示，阅读更清晰。
按住麦克风说话，松手即发送；Agent 回复可开启 TTS 自动播报。适合通勤、走路等不方便打字的场景。
从相册选图或接收系统分享内容，作为附件发送给 Agent。聊天中的图片可预览、保存到相册。
查看 Token 消耗、费用趋势与会话排行；「龙虾状态」页可了解 Gateway 健康、当前模型与连接情况。
同一 Wi‑Fi 下填写局域网 IP：Gateway 例如 ws://192.168.x.x:18789；Agent Server 例如 http://192.168.x.x:8642。
远程建议开启 TLS：Gateway 使用 wss://；Agent Server 使用 https://。勿把 Dashboard 管理页当成 App 入口。
Gateway 填写访问令牌（服务器配置中的 auth token）；Agent Server 填写 Bearer 访问令牌。凭证仅保存在本地。
仅 Gateway 远程连接可能需要在服务器端批准设备；Agent Server 仅 Bearer 鉴权。连接成功后断线会自动尝试重连。
未持有正确 Token / API Key 的客户端无法接入。请勿分享凭证；公网部署请配合防火墙限制来源。
新设备首次连远程 Gateway 会触发 pairing，须在服务器端批准设备。Agent Server 不走设备配对流程。
公网请使用 wss://（Gateway）或 https://（Agent Server），避免凭证与对话在传输层明文暴露。
语音输入需麦克风权限，识别数据发送至百度智能云 ASR 服务处理；使用前 App 会弹出说明并征得同意。TTS 播报仅在本地播放 Agent 回复文本。
连接自建 Gateway 或 Agent API Server，在移动端享受流式聊天、语音输入与 TTS 播报。
