XIAOFENG FASTAPI SERVICE
服务导航
这里是本地语音助手和 ESP32 服务的统一入口。选择下面的页面进行设备监控、文字技能测试、语音配置或 API 联调。
设备控制台
查看设备连接、请求、对话记录、意图、命令结果、耗时和错误。
进入控制台 →系统管理后台
监管用户、设备权限、对话记录、接口日志和 TTS 设置。
进入管理后台 →文字对话与技能测试
不使用 ESP32，直接输入自然语言，验证技能识别、上下文和设备命令生成。
开始文字测试 →TTS 与会话设置
切换 MeloTTS/EdgeTTS，设置音色、语速、音调和无对话自动关断时间，并试听。
打开设置 →Swagger API 文档
查看并调用服务提供的 OpenAPI 接口，适合接口调试。
打开 Swagger →ReDoc API 文档
以阅读形式浏览 API 契约、请求参数和响应结构。
打开 ReDoc →助手 API
文字消息、完整语音链路和会话上下文接口，详细参数以 OpenAPI 为准。
查看助手接口 →设备连接与联调
ESP32 WebSocket
ws://电脑局域网IP:8000/xiaozhi/v1/设备不能使用 127.0.0.1 或 localhost。技能命令文档
backend-api/13-设备技能接口联调文档.md，包含自然语言示例、命令和回执格式。连接协议文档
backend-api/12-ESP32-WebSocket连接协议.md，包含 Hello、音频、TTS 和空闲关断规则。服务状态
HTTP 服务监听 0.0.0.0:8000。如需启动服务，请按项目根目录的 服务入口.md 执行 Uvicorn 命令。