小智手机客户端
多平台Flutter/Dart活跃开发中
项目简介
小智手机客户端是基于Flutter框架开发的跨平台应用,为小智AI生态系统提供了移动端接入能力。通过一套代码,实现了在iOS、Android、Web、Windows、macOS和Linux等多个平台的部署,让用户随时随地都能与小智AI进行实时语音交互和文字对话。

最新版本客户端已全面升级,支持iOS与Android平台,并可自行打包为Web、PC版本。通过精心设计的UI和流畅的交互体验,为用户提供随时随地与小智AI交流的能力。
核心功能
跨平台支持
使用Flutter开发,一套代码支持iOS、Android、Web、Windows、macOS和Linux等多平台
多AI模型集成
支持小智AI服务、Dify、OpenAI等多种AI服务,可随时切换不同模型
丰富交互方式
支持实时语音对话、文字消息、图片消息,以及通话中手动打断功能
语音优化技术
实现安卓设备AEC+NS回音消除,提升语音交互质量
精美界面设计
轻度拟物化设计、流畅动画效果、自适应UI布局
灵活配置选项
支持多种AI服务配置管理,可添加多个小智到聊天列表
功能亮点
实时语音交互

流畅的语音对话体验
- 实时语音识别和响应
- 支持持续对话模式
- 语音交互过程中支持手动打断
- 按住说话快捷模式
- 语音会话历史记录
多AI服务支持
灵活切换不同AI服务
- 集成小智WebSocket实时语音对话
- 支持Dify平台接入
- 支持OpenAI图文消息和流式输出
- 支持官方小智服务一键设备注册
- 可同时添加多个AI服务到对话列表

系统要求
- Flutter: ^3.7.0
- Dart: ^3.7.0
- iOS: 12.0+
- Android: API 21+ (Android 5.0+)
- Web: 现代浏览器
安装与使用
安装方法
- 克隆项目仓库:
bash
git clone https://github.com/TOM88812/xiaozhi-android-client.git
- 安装依赖:
bash
flutter pub get
- 运行应用:
bash
flutter run
构建发布版本
bash
# Android应用
flutter build apk --release
# iOS应用
flutter build ios --release
# Web应用
flutter build web --release
注意: iOS编译完成后,需要在设置-APP中打开网络权限
配置说明
应用支持灵活的服务配置管理,包括:
小智服务配置
- 支持配置多个小智服务地址
- WebSocket URL设置
- Token认证
- 自定义MAC地址
Dify API配置
- 支持配置多个Dify服务
- API密钥管理
- 服务器URL配置
OpenAI配置
- API密钥设置
- 模型选择
- 参数调整
开发计划
已实现功能
- 支持多种AI服务提供商
- 支持OTA自动注册设备
- 增强语音识别准确性
- 实现文字和语音混合会话
- 支持OpenAI接口图文交互
正在开发
- 深色/浅色主题适配
- iOS平台回音消除实现
- 本地ASR语音识别支持
- 本地唤醒词功能
计划实现
- 支持IoT映射手机操作
- 本地TTS实现
- 支持MCP_Client
- OpenAI接口联网搜索功能
项目贡献
欢迎为小智手机客户端贡献代码或提交问题反馈:
- 目前iOS端回音消除尚未实现,欢迎有经验的开发者PR
- 提交Bug、功能请求或改进建议
- 分享您使用小智手机客户端的经验和案例