あなたの Muse に、
しゃべる小さなデスクトップ端末を

ムーちゃん は Muse サブスクリプションのユーザー向けの「ファームウェア + チャンネル」サービスです。丸い画面のミニ端末を、あなたの Muse と直接おしゃべりできるデスクトップデバイスに変えます——ボタンを押して話しかけ、返事は画面で読みます。すでに Muse を契約していて、机の上にいつでも声をかけられる小さな端末を置きたい方に向いています。ムーちゃんのハードウェアはご自身でご用意ください（ページ上部の「まず、この3つを用意しましょう」をご覧ください）。

はい、2つの方法があります。①いちばん簡単：当サイトのアバター工房（ステップ2）で一言入力して生成し、アバターファイルをダウンロード。ファームウェア作成のとき作成工房（ステップ3）でアップロードすれば組み込まれます。②自分で作る：公式レシピ（Muse 公式 Gadgets SDK の AVATAR_RECIPE.md）をあなたの Muse に渡すと、レシピに沿って muse_pixel.c のアバターソースを生成します。自作ソースは作成工房でそのままアップロードできます。まず安全プリチェック（こちらの構造チェック＋隔離環境での軽量コンパイル検証、約2分）を通ってから、ファームウェアに組み込まれます。②の方法は、そのまま使える Skill としてまとめました。下のブロックをあなたの Muse に貼ると、欲しいキャラクターを確認し、公式レシピと当サイトの受け入れルールに沿って描き、セルフチェックして muse_pixel.c を渡してくれます（同じ Skill は GitHub 公開リポジトリ にもあります）。
下のブロックを貼ってください（クリックで全選択、コピーできます）：

Mu酱アバターを作ってください。GitHub 公開リポジトリの Skill に従ってください：https://github.com/irol765/muchan-avatar-skill
1. まず欲しいキャラクター（見た目・色・性格）を確認し、はっきりするまで描き始めないでください。
2. 64×64 ピクセルの顔を描き、成果物は muse_pixel.c 1ファイルだけにしてください。
3. リポジトリの受け入れ仕様で項目ごとにセルフチェックし、全て合格したら完全なファイルを渡してください。

完全な Skill は GitHub 公開リポジトリで管理されています。上のリンクから全文を読めます。

3つです。Waveshare ESP32-S3-Touch-AMOLED-1.75C（バッテリー付き版）が1台。正常に使える Muse サブスクリプション。デスクトップ版 Chrome または Edge が入ったパソコンと、データ転送ができる USB ケーブル1本。あわせてスマートフォンも使います。最後のペアリングは Muse アプリで完結します。

いいえ、私たちはファームウェアとチャンネルだけを提供し、ハードウェアは販売していません。中国国内では淘宝・拼多多で「ESP32-S3-Touch-AMOLED-1.75C」を検索、海外では Waveshare 公式サイト（公式ページ）で購入できます。バッテリー付き版を選び、-EN 付きのバッテリーなし版と間違えないでください。ほかのお店で買った同じ型番のムーちゃんでも問題なく使えます。

Muse があなたに発行する専用の認証情報で、全48文字、mgst_ から始まります。このデバイスの身分証のようなもので、ファームウェアに書き込んで初めて、デバイスがあなたの Muse と話せるようになります。取得方法（正式名称は「Gadget SDKトークン」です）：
1. 公式ページ gadgets.muse.ai/settings/sdk-tokens；
2. あなたの Muse アカウントでログイン；
3. 新しいキーを作成；
4. コピーして、ステップ3の入力欄に貼り付けます。私たちに渡す前に、入力欄の下に表示される確認で先頭・末尾と文字数をチェックしてください。1文字でも写し間違えるとペアリングできません。

まずルールを正直にお伝えします。チャンネルキーはそのままあなたのアカウントで、パスワードはありません。ただし取り戻す方法はあります。お支払い時に、控えとして注文メールアドレスへ交付メールを送ります。キーを失くしたら、再送ページで注文メールアドレスを入力して人間チェックを済ませると、キーとコードがそのアドレスへ再送されます。とはいえ、キーを受け取ったら真っ先にコピーして保存するか、お支払い完了ページでファイルとしてダウンロードしておいてください。注文メールアドレス自体も失った場合だけ、再発行できません。

買い直す必要はありません。ステップ3の作成工房に戻り、あなたのコード（魔法ファームウェア＝チャンネルキー、原版ファームウェア＝コンパイルコード）と正しいデバイスキーを入力して、もう一度コンパイルしてください——各コード1日3回まで（北京時間0時にリセット）。完成したら、このページの「進捗確認 / ダウンロード」にコードを入力すればダウンロードできます（24時間以内）。

申し込み後、通常15〜30分お待ちください。ファームウェアは1つひとつあなたのキーに合わせて作成します。ステップ3のページにいれば進捗が自動で更新され、完成するとダウンロードボタンが現れます。途中でページを閉じても大丈夫。ブラウザを変えても大丈夫です。このページの「進捗確認 / ダウンロード（コードで確認）」であなたのコードを入力すれば、確認とダウンロードを続けられます。ダウンロードが完了したら、今回の作成に使ったキーは破棄されます。

基本的に大丈夫です。書き込みはムーちゃんにファイルを書いているだけなので、失敗してもフルパッケージを書き直せば復旧できます。ムーちゃんがパソコンに認識されない場合は、ムーちゃんの BOOT ボタンを押しながら USB をつなぐと、ダウンロードモードに入り直して書き込めます（この種の小さなボード共通のやり方です。ボタンの位置は Waveshare 公式ドキュメントをご確認ください）。どうしても復旧しなければ、サポートにご連絡ください。

面倒ではありません。アバター工房で新しく生成して確定し、ステップ4で「アバターだけ差し替え」で書き込むだけです。全部で約1分、ペアリングも WiFi 設定も消えません。デフォルトのアバターはレインボーの子馬で、変えなくても十分かわいいですよ。

違いは、ミニ端末がどうやって Muse につながるかです。魔法ファームウェア：接続は当サイトの魔法チャンネルを経由し、ご自宅の普通の WiFi で使えます。チャンネルキーは年単位の料金で、デバイス枠付き。中国国内で使うならこちらです。標準ファームウェア：ファームウェアが Muse 公式に直接接続し、私たちを経由しません。作成料は一回払いで、作ってしまえばずっと使えます——ご自宅の回線から公式へ直接つながる方向けです（たとえば端末を常に直結できる回線の場所に置く場合など）。標準ファームウェアはビルドコードで作成を始めます。購入後、お支払い完了ページでその場で受け取り、ステップ3で「標準ファームウェア」を選ぶときに入力してください。迷ったら魔法ファームウェアをどうぞ。ほとんどの方がこちらです。

交換コードは専用アバターを作るための「チケット」で、コード1個で生成1回分と交換できます。アバター工房でコードを入力欄に入れて一言説明を書けば、あなただけのキャラクターが生成されます。入手方法：ファームウェア作成（魔法ファームウェア作成・標準ファームウェア作成のどちらでも）を買うと3個付いてきて、お支払い完了ページで主な受け取り物（チャンネルキーまたはビルドコード）と一緒に受け取れます。自分で使っても、お友達に譲ってもOK。ステップ1のお店で単品購入もできます。なお、アバター作成は交換コードのみ対応です。チャンネルキーはファームウェア作成用なので、アバター工房では使えません。

お支払いが終わると「お支払い完了」ページに進み、チャンネルキーや交換コードがその場で表示されます——すぐにコピーして保存するか、ファイルでダウンロードしておいてください。表示はこの1回だけです。ついでに言っておくと、お支払い後に Stripe から届くメールは領収書のみで、キーやコードはメールには入っていません。メールボックスを探さないでくださいね。

「まるごと書き込み」はムーちゃん内のファームウェアを丸ごと入れ替えます。初めての書き込み、または失敗したムーちゃんの復旧に使います。終わったらペアリングし直しが必要です。「アバターだけ差し替え」はアバターの部分だけを差し替えます。ペアリングと WiFi は残ったまま、約1分で完了。普段のアバター変更はこれで十分です。

保存しません。キーが現れる場所は2つだけです。あなたのブラウザの入力欄と、作成中にクラウドマシンのメモリの中。当サイトはあなたのキーを保存も記録もせず、ダウンロードが完了したら、作成に使ったキーは破棄されます。これはご自身の目で確認できます。送信すると入力欄は自動で空になり、完成時にはページに「作成に使ったキーは破棄されます」と表示されます。第三者監査を受けたわけではないので、きれいごとは言いません——仕組みはここに開示してあるので、ご自身で判断してください。

キー1本にはデバイス枠が含まれていて、現在のプランでは2台分です。更新は買い直し不要です。ステップ1のお店の「チャンネル更新」でお持ちのチャンネルキーを入力してお支払いいただくと、新しい期間分がそのキーに繰り越されます。デバイスが足りなくなったら、お店の「デバイス枠を追加」で1回につき2台分追加できます。

Muse 公式のアップデートで現在のファームウェアが使えなくなった場合は、新しいファームウェアを作り直し、告知でお知らせします。あなたのコードで新バージョンを再コンパイルすればOKです（その日の3回分にカウントされます）。あとは焼き直すだけです。チャンネルキーの有効期限は通常どおり計算され、影響を受けません。

プラットフォーム標準の文字起こしの既知のクセです。短い文、声が小さい場合、中国語と英語の混在では特に文字化けしやすく、ムーちゃんやチャンネルの問題ではありません。正確な文字起こしが欲しい場合は、ローカル文字起こしパイプラインを Muse に追加できます。私たちが実際に使っている仕組みをオープンソースにしました：board-voice-flow。音声を本機の SenseVoice で正確に起こし、アシスタントが照合してから返信します。データが本機の外に出ることはありません。リポジトリの説明どおりに導入してください。
下のブロックをあなたの Muse に貼れば、そのまま導入と検証まで行います（クリックで全選択、そのままコピーできます）：

board-voice-flow のローカル音声文字起こしパイプラインを私の環境に導入してください。リポジトリは https://github.com/irol765/board-voice-flow です。README と SKILL.md に従ってください：
1. SKILL.md と skill.yaml を私の custom-skills にスキル名 board_voice_flow として入れ、スクリプトと systemd サービスのテンプレートをリポジトリどおりに配置する；
2. SenseVoice-Small int8 モデル（リンクは README 内、約 230MB）をダウンロードし、venv を作って sherpa-onnx をインストールする；
3. asr-server と asr-watch の2つのサービスを自動起動に設定し、既存の voice_note 音声で検証する：数秒以内に board-transcripts.txt へ文字起こしが現れること；
4. SKILL.md の Health guard の節に従って asr-guard タイマーを導入し、検証する：ガードスクリプトを一度手動で実行し、OK の1行が出力されること；
5. 今後、メインチャットに届く音声ファイル（voice_note）は SKILL.md の手順で処理する：まずプラットフォームの文字起こしを見て、ローカルの正確な稿と照合し、ローカル稿を正とする。
パスはこのマシンの実情に合わせて調整し、終わったら検証結果を教えてください。

前の返信が終わらないうちに次のメッセージを送ると、送信が詰まって長時間反応しなくなることがあります。前の返信が終わり、デバイスが待機状態に戻ってから次を送ってください。すでに詰まっている場合は、デバイスを一度再起動してから送り直してください。