已发布项目

muse-charm-mosaico-9a5b2a83

Revision 1

Initial draft

Muse Charm · Mosaico：把 Muse 装进一个可爱的语音 AI 伙伴

按住设备顶部红色 AI 键说话，松开就发送给 Muse。她会在屏幕上回复你，并通过阿里千问语音朗读。黑底奶白角色会跟随聆听、思考和朗读状态活动，也能轻触互动。

本项目基于 Muse Gadget SDK，已开源。这个包是中文版 v1.0.0 完整固件，首次启动默认中文；设置中可以切换 English。已保存的语言与配对信息会保留，不强制覆盖。

版本范围：本次发布与 GitHub 的 firmware/muse-charm-mosaico-v1.0.0.irisfw 完全一致，保留第一版奶白色初始形象、齿轮设置入口和原版对话布局。后续开发中的免电脑语音换装、顶部下拉设置和展开阅读面板不属于本包。

GitHub 仓库：https://github.com/samyeei/Muse-charm-mosaico

完整图文教程：https://github.com/samyeei/Muse-charm-mosaico/blob/main/docs/SETUP_CN.md

实机演示视频：https://github.com/samyeei/Muse-charm-mosaico/blob/main/docs/assets/demo/muse-charm-demo.mp4

已实现的功能

  • 顶部 AI 键按住说话、松开发送，Muse 返回文字并默认朗读。
  • 默认阿里百炼 qwen3-tts-flash-realtime，音色 Cherry。
  • 待机、聆听、思考、朗读、困倦、错误、开心、开机八种角色动态；轻触角色可以互动。
  • 喇叭图标一键静音，齿轮进入设置，中英文界面可切换。
  • 音量、亮度、语速和自动翻页时间用滑块调整，数值实时变化。
  • 长回复自动翻页，默认间隔 7 秒；熄屏时间可选 5、10、15、20、30、60 秒。
  • 无操作逐渐暗屏、熄屏，触摸、AI 键或主板运动可以唤醒。
  • 手机连接设备免密码 Wi-Fi，在浏览器填写自己的 Muse token、TTS 地址、API Key、模型和音色。
  • 支持通过 Muse 生成新角色，在电脑预览后更新角色资源，操作见 GitHub 文档。

需要准备

ESP-Mosaico 裸机、USB 数据线、Muse 手机 App 与自己的 Muse Gadget SDK token，以及自己的阿里云百炼 API Key（北京地域）。当前版本不需要扩展插件。

固件不包含作者的 token、家庭 Wi-Fi 或配对数据。Muse 与千问是联网服务，需自行开通相应账号；服务额度和费用以提供方为准。

安装固件

本次提供的是 .irisfw system-update 完整包，含角色 UI 资源。请使用兼容 ESP-Mosaico 的安装工具完成系统更新，不要当作代码专用 app-update 包，也不要整片擦除 Flash。

若希望让本地 Codex 或其他 Agent 帮你安装，把设备通过 USB 连接电脑，直接发送：

请将 https://github.com/samyeei/Muse-charm-mosaico 的最新版固件安装到我通过 USB 连接的 ESP-Mosaico：阅读仓库说明，自动下载代码、准备依赖并通过 mosaico.py 和仓库提供的完整固件包完成 system-update，保留设备身份、已有凭据与配对信息，不要整片擦除 Flash，安装后检查设备正常启动，并告诉我如何连接设备热点、打开 192.168.4.1 完成首次配置。

手动安装步骤见 GitHub 首页。新设备或 Recovery 未验证时，先按工具说明准备 Recovery；需要物理操作时按提示执行。

手机首次配置：只使用新版千问参数

建议先在可上网的网络下准备两个凭据，再连接设备配置热点。

1. 连接设备热点

设备首次未配置时，手机打开 Wi-Fi，连接 Mochi-Setup-XXXX，无需密码。系统提示无互联网时保持连接。浏览器地址栏输入 http://192.168.4.1，打开「首次配置」页。

2. 填写 Muse token

平台入口：https://muse.ai/platform

官方 SDK token 直接入口：https://gadgets.muse.ai/settings/sdk-tokens

登录自己的 Muse 账号，获取 Gadget SDK token，粘贴到「Muse token」。它不是邀请码、账号额度或登录密码。

3. 获取并配置千问 API Key

北京地域百炼 API Key 管理：https://bailian.console.aliyun.com/cn-beijing/model/settings/api-key

官方获取说明：https://help.aliyun.com/zh/model-studio/get-api-key/

登录阿里云、开通百炼，确认「华北 2（北京）」地域，创建或复制可用 API Key。在设备配置页选择 Qwen · 阿里百炼，按以下值填写：

  • TTS API 地址： wss://dashscope.aliyuncs.com/api-ws/v1/realtime
  • TTS token： 你自己的北京地域百炼 API Key。
  • 模型名称： qwen3-tts-flash-realtime
  • 音色名称： Cherry
  • 语音接口类型： PCM 16 kHz 的千问选项。

4. 保存并在 App 配对

点击「保存并重启」，成功后设备重启、热点关闭。手机切回可上网的网络，打开 Muse App：

  1. 设置 → 设备，开启 Developer mode。
  2. 点右上角「＋」，找到 MuseGadget-……，点击连接。
  3. App 提示按设备按钮确认时，短按顶部红色 AI 键。
  4. 阅读社区设备授权提示，确认是自己的设备与可信固件后继续。
  5. 按 App 提示选择常用 Wi-Fi，输入该网络密码，等待配对完成。

成功后设备左上角显示「Muse 在线」，设置页底部显示「网络已连接 · Muse 已配对」。

5. 开始对话

按住顶部 AI 键，说「你好，介绍一下你自己」，松开发送。检查文字与朗读。没有声音时先检查静音和音量，再核对千问 Key、地域与额度。

以后更换凭据：设备齿轮 →「手机配置」，再次连接热点访问 192.168.4.1，完整填写两个凭据后保存。已有 Muse 配对记录保留。

当前范围

当前版本以裸机语音伙伴为主，不支持视频播放，扩展光线传感器自动亮度尚未接入。模拟器用于界面与角色预览，不能替代真机联网和音频验证。

应用源码采用 Apache-2.0，第三方组件和字体保留各自许可证，详见仓库 NOTICE。

后续固件、功能与使用说明更新，请以 GitHub 仓库为准：

https://github.com/samyeei/Muse-charm-mosaico