# 📱 LiveKit Voice AI - 局域网测试方案

## 🔧 问题分析

LiveKit Server 本身**不包含 Web UI**，`/explore` 路径返回 404 是正常的。

## ✅ 解决方案

### 方案一：HTML 测试页面（已创建）

访问: http://192.168.31.229:8888/web-test.html

测试页面功能:
- 连接 LiveKit Server
- 麦克风开关
- 实时日志显示
- 已预设 Token

### 方案二：React Native App

```bash
npx react-native run-ios --device
```

### 方案三：LiveKit Playground (云端)

访问: https://livekit-agent-playground.vercel.app/

## 📡 当前服务状态

```
✅ Agent Worker:   PID 74404 (voice-ai-agent)
✅ FunASR STT:    localhost:8080 (healthy)
✅ LiveKit Server: localhost:7880 (Docker)
✅ HTTP Server:   localhost:8888 (测试页面)
```

## 🔗 测试链接

| 用途 | 地址 |
|------|------|
| 浏览器测试 | http://192.168.31.229:8888/web-test.html |
| LiveKit Playground | https://livekit-agent-playground.vercel.app/ |
| Token 生成 | `python3 gen_token.py voice-ai-meeting user1` |

## 📱 手机测试步骤

1. **同一 WiFi** - 确保手机和 Mac 在同一网络
2. **打开浏览器** - Safari/Chrome 访问 http://192.168.31.229:8888/web-test.html
3. **点击连接** - 已自动填充 Token
4. **按住麦克风** - 按住说话，松开后 Agent 回复

## ⚠️ 注意事项

- 如果无法连接，检查 macOS 防火墙设置
- iOS Safari 要求 HTTPS/WSS，测试可使用 localhost 或 HTTPS 代理
- 手机端建议用 React Native App 获得最佳体验