Skip to content

小智手机客户端

多平台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服务到对话列表
多AI服务支持

系统要求

  • Flutter: ^3.7.0
  • Dart: ^3.7.0
  • iOS: 12.0+
  • Android: API 21+ (Android 5.0+)
  • Web: 现代浏览器

安装与使用

安装方法

  1. 克隆项目仓库:
bash
git clone https://github.com/TOM88812/xiaozhi-android-client.git
  1. 安装依赖:
bash
flutter pub get
  1. 运行应用:
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、功能请求或改进建议
  • 分享您使用小智手机客户端的经验和案例

相关链接