《Muse Gadgets 实战》第5章：领SDK Token + 配对准备
Muse Gadgets 的项目 star 数已经 1647 个（2026-10-08 实测），关注的人不少。这一章不碰代码，先把两个前置条件搞定：SDK Token 和手机配对准备。
没有这两样，后面刷完机也连不上，白干。
先去领 SDK Token
打开浏览器，访问：
https://gadgets.muse.ai/settings/sdk-tokens
没注册就先注册。登录后在 Account > SDK tokens 里领 token。
有个死规则：每个设备都要一个 token，包括你自己做的板子。官方原文就是"Every gadget needs one to pair, including ones you build for yourself"。
多说一句：token 领完别关掉页面就忘。复制到记事本里存好。刷机的时候要把这个 token 塞进固件（第 6 章讲，具体是 idf.py menuconfig 里填），弄丢了就得重走一遍。
刷机前先把条款读了
同一网站还有个页面：
https://gadgets.muse.ai/sdk-terms
这是 Gadget SDK 的使用条款。官方 README 里写的是"review the Terms before you flash or pair"。
条款不长，扫一遍就行。主要是让你知道这套东西的使用边界。用人家的 SDK，连上人家的 Muse 服务，先搞清楚规则，再动手。
手机装好 Muse App，打开开发者模式
这是个硬性要求：必须有手机。
Muse Gadgets 的配对走手机上的 Muse App，iOS 和 Android 都有。电脑替代不了。
装完打开 App，按这个路径走：
Settings > Devices > 打开 Developer mode
然后点 Add Device（Devices 页面右上角的 + 号）。刷好固件的板子会出现在列表里，名字长这样：MuseGadget-XXXXXX，后面那串是设备编号。
说白了，开发者模式就是给这群 DIY 玩家开的后门。正式版用户看不到这些选项。
配对前确认三件事
1. 手机：装好 Muse App，开好开发者模式。
2. 网络：可信的 Wi-Fi。公司内网、咖啡馆公共网，尽量别用。
3. Token：领好的那个，别弄丢。
第 2 点要解释一下。官方有明确警告：配对没有厂商层面的验证，"can't prevent an active man-in-the-middle attack"。翻译一下：在不安全的网络下，中间人可能截你的配对连接。所以在家配，别在公共场合配。
配对的流程是这样的：板子刷完机，灯会呼吸橙色，意思是"等配对"。手机上点 Add Device 找到它，灯变呼吸蓝色，这时候按一下板子上的 BOOT 键确认是你本人。配对成功，灯变绿色。
想重新配？长按按钮 5 秒重置，从头来。
常见问题直接答
没手机行不行？
不行。ESP32 和 Linux 两种板子，配对都走手机 App。没手机就别往下玩了。
Muse 要付费订阅吗？
官方文档里没写死这一项。待验证。
我只写能确定的事：订阅要求目前是未知数，不确定的地方不要编。以 Muse App 里的实际提示为准。
刷不动了去哪问？
官方社区 Discord：https://discord.gg/3bhjCkZdd6。开发者和老玩家都在那，问问题有人回。
事实核实声明
– SDK Token 领取地址及"一设备一 Token"规则：2026-10-12 实测，来源仓库主 README（"Before you flash or pair a gadget, get an SDK token"）。
– SDK 条款链接：2026-10-12 实测，来源同上。
– 配对路径（Settings > Devices > Developer mode，Add Device，设备名 MuseGadget-XXXXXX）：2026-10-12 实测，来源 esp32/README.md 第 40 行、第 131-136 行。
– 灯效含义（橙等配对 / 呼吸蓝按 BOOT 确认 / 绿连上 / 长按 5 秒重置）：2026-10-12 实测，来源 esp32/README.md 第 131-150 行。
– 安全警告（无厂商验证、防中间人、可信网络配对）：2026-10-12 实测，来源 esp32/README.md 第 152-155 行。
– Linux 版权限警告：2026-10-08 验证结论，来源仓库主 README 安全章节，计划大纲第 5 条已确认坑位。
– GitHub star 数 1647：2026-10-08 实测，计划大纲"项目有效性验证结论"表。
– "Muse 订阅要求"：未确认，标注"待验证"，不编造。
相关章节
– 上一章：《Muse Gadgets 实战》第 4 章：装ESP-IDF v6.0.1（https://jinbufenzi.com/13221.html）
– 下一章：《Muse Gadgets 实战》第 6 章：第一次编译和刷机（待发布）
因信息存在时效性以及人为主动性提交的情况（比如有人故意提交错误的信息，人力有限无法进一步做背调确认），因此可能存在信息上的错误，介意请勿支付，如果支付则视为已知晓可能存在的信息错误问题，愿意承担信息错误的支付损失（本站提供的是虚拟信息服务，不支持退款，介意请勿支付）