[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"article:muse-charm-mosaico-9a5b2a83":3},{"article":4,"revisions":15},{"id":5,"author_id":6,"firmware_project_id":7,"slug":8,"published_revision_id":9,"visibility":10,"moderation_lock_reason":11,"version":12,"created_at":13,"updated_at":14},"6d8745ad-8169-4be8-be2c-b141f6ae2557","54c8e7dc-c5f3-4b8c-b66c-bb7e32cbae0e","9a5b2a83-6f0d-452c-a8b9-d01e29df5f83","muse-charm-mosaico-9a5b2a83","14ef4075-2fea-4390-a594-b1a99d536279","public",null,6,"2026-10-06T15:50:06.073Z","2026-10-07T03:22:47.271Z",[16],{"id":9,"article_id":5,"revision_no":17,"state":18,"source_revision_id":11,"change_summary":19,"version":12,"submitted_at":20,"reviewed_at":21,"published_at":14,"created_at":13,"description":22,"rendered_description":23,"content":24},1,"published","Initial draft","2026-10-06T15:50:09.875Z","2026-10-07T03:22:47.245Z","# Muse Charm · Mosaico：把 Muse 装进一个可爱的语音 AI 伙伴\n\n按住设备顶部红色 AI 键说话，松开就发送给 Muse。她会在屏幕上回复你，并通过阿里千问语音朗读。黑底奶白角色会跟随聆听、思考和朗读状态活动，也能轻触互动。\n\n本项目基于 Muse Gadget SDK，已开源。这个包是中文版 v1.0.0 完整固件，首次启动默认中文；设置中可以切换 English。已保存的语言与配对信息会保留，不强制覆盖。\n\n**版本范围：本次发布与 GitHub 的 `firmware\u002Fmuse-charm-mosaico-v1.0.0.irisfw` 完全一致，保留第一版奶白色初始形象、齿轮设置入口和原版对话布局。后续开发中的免电脑语音换装、顶部下拉设置和展开阅读面板不属于本包。**\n\n**GitHub 仓库：https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico**\n\n**完整图文教程：https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u002Fblob\u002Fmain\u002Fdocs\u002FSETUP_CN.md**\n\n**实机演示视频：https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u002Fblob\u002Fmain\u002Fdocs\u002Fassets\u002Fdemo\u002Fmuse-charm-demo.mp4**\n\n## 已实现的功能\n\n- 顶部 AI 键按住说话、松开发送，Muse 返回文字并默认朗读。\n- 默认阿里百炼 `qwen3-tts-flash-realtime`，音色 `Cherry`。\n- 待机、聆听、思考、朗读、困倦、错误、开心、开机八种角色动态；轻触角色可以互动。\n- 喇叭图标一键静音，齿轮进入设置，中英文界面可切换。\n- 音量、亮度、语速和自动翻页时间用滑块调整，数值实时变化。\n- 长回复自动翻页，默认间隔 7 秒；熄屏时间可选 5、10、15、20、30、60 秒。\n- 无操作逐渐暗屏、熄屏，触摸、AI 键或主板运动可以唤醒。\n- 手机连接设备免密码 Wi-Fi，在浏览器填写自己的 Muse token、TTS 地址、API Key、模型和音色。\n- 支持通过 Muse 生成新角色，在电脑预览后更新角色资源，操作见 GitHub 文档。\n\n## 需要准备\n\nESP-Mosaico 裸机、USB 数据线、Muse 手机 App 与自己的 Muse Gadget SDK token，以及自己的阿里云百炼 API Key（北京地域）。当前版本不需要扩展插件。\n\n固件不包含作者的 token、家庭 Wi-Fi 或配对数据。Muse 与千问是联网服务，需自行开通相应账号；服务额度和费用以提供方为准。\n\n## 安装固件\n\n本次提供的是 `.irisfw` **system-update 完整包，含角色 UI 资源**。请使用兼容 ESP-Mosaico 的安装工具完成系统更新，不要当作代码专用 app-update 包，也不要整片擦除 Flash。\n\n若希望让本地 Codex 或其他 Agent 帮你安装，把设备通过 USB 连接电脑，直接发送：\n\n> 请将 https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico 的最新版固件安装到我通过 USB 连接的 ESP-Mosaico：阅读仓库说明，自动下载代码、准备依赖并通过 mosaico.py 和仓库提供的完整固件包完成 system-update，保留设备身份、已有凭据与配对信息，不要整片擦除 Flash，安装后检查设备正常启动，并告诉我如何连接设备热点、打开 192.168.4.1 完成首次配置。\n\n手动安装步骤见 GitHub 首页。新设备或 Recovery 未验证时，先按工具说明准备 Recovery；需要物理操作时按提示执行。\n\n## 手机首次配置：只使用新版千问参数\n\n建议先在可上网的网络下准备两个凭据，再连接设备配置热点。\n\n### 1. 连接设备热点\n\n设备首次未配置时，手机打开 Wi-Fi，连接 `Mochi-Setup-XXXX`，无需密码。系统提示无互联网时保持连接。浏览器地址栏输入 **http:\u002F\u002F192.168.4.1**，打开「首次配置」页。\n\n### 2. 填写 Muse token\n\n平台入口：https:\u002F\u002Fmuse.ai\u002Fplatform\n\n官方 SDK token 直接入口：https:\u002F\u002Fgadgets.muse.ai\u002Fsettings\u002Fsdk-tokens\n\n登录自己的 Muse 账号，获取 **Gadget SDK token**，粘贴到「Muse token」。它不是邀请码、账号额度或登录密码。\n\n### 3. 获取并配置千问 API Key\n\n北京地域百炼 API Key 管理：https:\u002F\u002Fbailian.console.aliyun.com\u002Fcn-beijing\u002Fmodel\u002Fsettings\u002Fapi-key\n\n官方获取说明：https:\u002F\u002Fhelp.aliyun.com\u002Fzh\u002Fmodel-studio\u002Fget-api-key\u002F\n\n登录阿里云、开通百炼，确认「华北 2（北京）」地域，创建或复制可用 API Key。在设备配置页选择 `Qwen · 阿里百炼`，按以下值填写：\n\n- **TTS API 地址：** `wss:\u002F\u002Fdashscope.aliyuncs.com\u002Fapi-ws\u002Fv1\u002Frealtime`\n- **TTS token：** 你自己的北京地域百炼 API Key。\n- **模型名称：** `qwen3-tts-flash-realtime`\n- **音色名称：** `Cherry`\n- **语音接口类型：** PCM 16 kHz 的千问选项。\n\n### 4. 保存并在 App 配对\n\n点击「保存并重启」，成功后设备重启、热点关闭。手机切回可上网的网络，打开 Muse App：\n\n1. 设置 → 设备，开启 Developer mode。\n2. 点右上角「＋」，找到 `MuseGadget-……`，点击连接。\n3. App 提示按设备按钮确认时，**短按顶部红色 AI 键**。\n4. 阅读社区设备授权提示，确认是自己的设备与可信固件后继续。\n5. 按 App 提示选择常用 Wi-Fi，输入该网络密码，等待配对完成。\n\n成功后设备左上角显示「Muse 在线」，设置页底部显示「网络已连接 · Muse 已配对」。\n\n### 5. 开始对话\n\n按住顶部 AI 键，说「你好，介绍一下你自己」，松开发送。检查文字与朗读。没有声音时先检查静音和音量，再核对千问 Key、地域与额度。\n\n以后更换凭据：设备齿轮 →「手机配置」，再次连接热点访问 192.168.4.1，完整填写两个凭据后保存。已有 Muse 配对记录保留。\n\n## 当前范围\n\n当前版本以裸机语音伙伴为主，不支持视频播放，扩展光线传感器自动亮度尚未接入。模拟器用于界面与角色预览，不能替代真机联网和音频验证。\n\n应用源码采用 Apache-2.0，第三方组件和字体保留各自许可证，详见仓库 NOTICE。\n\n---\n\n**后续固件、功能与使用说明更新，请以 GitHub 仓库为准：**\n\n**https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico**\n","\u003Ch1>Muse Charm · Mosaico：把 Muse 装进一个可爱的语音 AI 伙伴\u003C\u002Fh1>\n\u003Cp>按住设备顶部红色 AI 键说话，松开就发送给 Muse。她会在屏幕上回复你，并通过阿里千问语音朗读。黑底奶白角色会跟随聆听、思考和朗读状态活动，也能轻触互动。\u003C\u002Fp>\n\u003Cp>本项目基于 Muse Gadget SDK，已开源。这个包是中文版 v1.0.0 完整固件，首次启动默认中文；设置中可以切换 English。已保存的语言与配对信息会保留，不强制覆盖。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>版本范围：本次发布与 GitHub 的 \u003Ccode>firmware\u002Fmuse-charm-mosaico-v1.0.0.irisfw\u003C\u002Fcode> 完全一致，保留第一版奶白色初始形象、齿轮设置入口和原版对话布局。后续开发中的免电脑语音换装、顶部下拉设置和展开阅读面板不属于本包。\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>GitHub 仓库：\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>完整图文教程：\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u002Fblob\u002Fmain\u002Fdocs\u002FSETUP_CN.md\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u002Fblob\u002Fmain\u002Fdocs\u002FSETUP_CN.md\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>实机演示视频：\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u002Fblob\u002Fmain\u002Fdocs\u002Fassets\u002Fdemo\u002Fmuse-charm-demo.mp4\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u002Fblob\u002Fmain\u002Fdocs\u002Fassets\u002Fdemo\u002Fmuse-charm-demo.mp4\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Ch2>已实现的功能\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>顶部 AI 键按住说话、松开发送，Muse 返回文字并默认朗读。\u003C\u002Fli>\n\u003Cli>默认阿里百炼 \u003Ccode>qwen3-tts-flash-realtime\u003C\u002Fcode>，音色 \u003Ccode>Cherry\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>待机、聆听、思考、朗读、困倦、错误、开心、开机八种角色动态；轻触角色可以互动。\u003C\u002Fli>\n\u003Cli>喇叭图标一键静音，齿轮进入设置，中英文界面可切换。\u003C\u002Fli>\n\u003Cli>音量、亮度、语速和自动翻页时间用滑块调整，数值实时变化。\u003C\u002Fli>\n\u003Cli>长回复自动翻页，默认间隔 7 秒；熄屏时间可选 5、10、15、20、30、60 秒。\u003C\u002Fli>\n\u003Cli>无操作逐渐暗屏、熄屏，触摸、AI 键或主板运动可以唤醒。\u003C\u002Fli>\n\u003Cli>手机连接设备免密码 Wi-Fi，在浏览器填写自己的 Muse token、TTS 地址、API Key、模型和音色。\u003C\u002Fli>\n\u003Cli>支持通过 Muse 生成新角色，在电脑预览后更新角色资源，操作见 GitHub 文档。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>需要准备\u003C\u002Fh2>\n\u003Cp>ESP-Mosaico 裸机、USB 数据线、Muse 手机 App 与自己的 Muse Gadget SDK token，以及自己的阿里云百炼 API Key（北京地域）。当前版本不需要扩展插件。\u003C\u002Fp>\n\u003Cp>固件不包含作者的 token、家庭 Wi-Fi 或配对数据。Muse 与千问是联网服务，需自行开通相应账号；服务额度和费用以提供方为准。\u003C\u002Fp>\n\u003Ch2>安装固件\u003C\u002Fh2>\n\u003Cp>本次提供的是 \u003Ccode>.irisfw\u003C\u002Fcode> \u003Cstrong>system-update 完整包，含角色 UI 资源\u003C\u002Fstrong>。请使用兼容 ESP-Mosaico 的安装工具完成系统更新，不要当作代码专用 app-update 包，也不要整片擦除 Flash。\u003C\u002Fp>\n\u003Cp>若希望让本地 Codex 或其他 Agent 帮你安装，把设备通过 USB 连接电脑，直接发送：\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>请将 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u003C\u002Fa> 的最新版固件安装到我通过 USB 连接的 ESP-Mosaico：阅读仓库说明，自动下载代码、准备依赖并通过 mosaico.py 和仓库提供的完整固件包完成 system-update，保留设备身份、已有凭据与配对信息，不要整片擦除 Flash，安装后检查设备正常启动，并告诉我如何连接设备热点、打开 192.168.4.1 完成首次配置。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>手动安装步骤见 GitHub 首页。新设备或 Recovery 未验证时，先按工具说明准备 Recovery；需要物理操作时按提示执行。\u003C\u002Fp>\n\u003Ch2>手机首次配置：只使用新版千问参数\u003C\u002Fh2>\n\u003Cp>建议先在可上网的网络下准备两个凭据，再连接设备配置热点。\u003C\u002Fp>\n\u003Ch3>1. 连接设备热点\u003C\u002Fh3>\n\u003Cp>设备首次未配置时，手机打开 Wi-Fi，连接 \u003Ccode>Mochi-Setup-XXXX\u003C\u002Fcode>，无需密码。系统提示无互联网时保持连接。浏览器地址栏输入 \u003Cstrong>\u003Ca rel=\"nofollow noopener noreferrer\">http:\u002F\u002F192.168.4.1\u003C\u002Fa>\u003C\u002Fstrong>，打开「首次配置」页。\u003C\u002Fp>\n\u003Ch3>2. 填写 Muse token\u003C\u002Fh3>\n\u003Cp>平台入口：\u003Ca href=\"https:\u002F\u002Fmuse.ai\u002Fplatform\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fmuse.ai\u002Fplatform\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>官方 SDK token 直接入口：\u003Ca href=\"https:\u002F\u002Fgadgets.muse.ai\u002Fsettings\u002Fsdk-tokens\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fgadgets.muse.ai\u002Fsettings\u002Fsdk-tokens\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>登录自己的 Muse 账号，获取 \u003Cstrong>Gadget SDK token\u003C\u002Fstrong>，粘贴到「Muse token」。它不是邀请码、账号额度或登录密码。\u003C\u002Fp>\n\u003Ch3>3. 获取并配置千问 API Key\u003C\u002Fh3>\n\u003Cp>北京地域百炼 API Key 管理：\u003Ca href=\"https:\u002F\u002Fbailian.console.aliyun.com\u002Fcn-beijing\u002Fmodel\u002Fsettings\u002Fapi-key\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fbailian.console.aliyun.com\u002Fcn-beijing\u002Fmodel\u002Fsettings\u002Fapi-key\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>官方获取说明：\u003Ca href=\"https:\u002F\u002Fhelp.aliyun.com\u002Fzh\u002Fmodel-studio\u002Fget-api-key\u002F\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fhelp.aliyun.com\u002Fzh\u002Fmodel-studio\u002Fget-api-key\u002F\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>登录阿里云、开通百炼，确认「华北 2（北京）」地域，创建或复制可用 API Key。在设备配置页选择 \u003Ccode>Qwen · 阿里百炼\u003C\u002Fcode>，按以下值填写：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>TTS API 地址：\u003C\u002Fstrong> \u003Ccode>wss:\u002F\u002Fdashscope.aliyuncs.com\u002Fapi-ws\u002Fv1\u002Frealtime\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TTS token：\u003C\u002Fstrong> 你自己的北京地域百炼 API Key。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>模型名称：\u003C\u002Fstrong> \u003Ccode>qwen3-tts-flash-realtime\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>音色名称：\u003C\u002Fstrong> \u003Ccode>Cherry\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>语音接口类型：\u003C\u002Fstrong> PCM 16 kHz 的千问选项。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>4. 保存并在 App 配对\u003C\u002Fh3>\n\u003Cp>点击「保存并重启」，成功后设备重启、热点关闭。手机切回可上网的网络，打开 Muse App：\u003C\u002Fp>\n\u003Col>\n\u003Cli>设置 → 设备，开启 Developer mode。\u003C\u002Fli>\n\u003Cli>点右上角「＋」，找到 \u003Ccode>MuseGadget-……\u003C\u002Fcode>，点击连接。\u003C\u002Fli>\n\u003Cli>App 提示按设备按钮确认时，\u003Cstrong>短按顶部红色 AI 键\u003C\u002Fstrong>。\u003C\u002Fli>\n\u003Cli>阅读社区设备授权提示，确认是自己的设备与可信固件后继续。\u003C\u002Fli>\n\u003Cli>按 App 提示选择常用 Wi-Fi，输入该网络密码，等待配对完成。\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>成功后设备左上角显示「Muse 在线」，设置页底部显示「网络已连接 · Muse 已配对」。\u003C\u002Fp>\n\u003Ch3>5. 开始对话\u003C\u002Fh3>\n\u003Cp>按住顶部 AI 键，说「你好，介绍一下你自己」，松开发送。检查文字与朗读。没有声音时先检查静音和音量，再核对千问 Key、地域与额度。\u003C\u002Fp>\n\u003Cp>以后更换凭据：设备齿轮 →「手机配置」，再次连接热点访问 192.168.4.1，完整填写两个凭据后保存。已有 Muse 配对记录保留。\u003C\u002Fp>\n\u003Ch2>当前范围\u003C\u002Fh2>\n\u003Cp>当前版本以裸机语音伙伴为主，不支持视频播放，扩展光线传感器自动亮度尚未接入。模拟器用于界面与角色预览，不能替代真机联网和音频验证。\u003C\u002Fp>\n\u003Cp>应用源码采用 Apache-2.0，第三方组件和字体保留各自许可证，详见仓库 NOTICE。\u003C\u002Fp>\n\u003Chr \u002F>\n\u003Cp>\u003Cstrong>后续固件、功能与使用说明更新，请以 GitHub 仓库为准：\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\" rel=\"nofollow noopener noreferrer\">https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico\u003C\u002Fa>\u003C\u002Fstrong>\u003C\u002Fp>\n",{"title":25,"categories":26,"boards":30,"tags":31,"cover_images":32,"external_links":34,"attachments":39,"current_version":45,"license":46,"firmware_variants":47},"Muse Charm · Mosaico",[27,28,29],"display","audio","communication",[],[],[33],"\u002Fapi\u002Fv1\u002Ffiles\u002F150569ea-4e0d-4de4-b144-1a767e3817b6.webp",[35],{"label":36,"url":37,"platform":38},"GitHub · 源码与后续更新","https:\u002F\u002Fgithub.com\u002Fsamyeei\u002FMuse-charm-mosaico","github",[40],{"id":41,"name":42,"size":43,"media_type":44,"upload_id":41},"a64ec289-be08-4494-ba7c-028c1d893dd6.md","usage_CN.md",14263,"application\u002Foctet-stream","1.0.0","Apache-2.0",[48],{"type":49,"partitions":50,"iris":51},"iris",[],{"bundle_asset_id":52},"08bd1119-f443-4abb-a757-b513aef42ee3.irisfw"]