docs: 添加获取小爱音箱 did 的相关说明

.migpt.example.js

@@ -41,6 +41,10 @@ export default {
     streamResponse: true,
     // 查询是否在播放中指令，请到 https://home.miot-spec.com 查询具体指令
     // playingCommand: [3, 1, 1], // 默认无需配置此参数，播放出现问题时再尝试开启
+    // 是否启用调试
+    debug: false, // 一般情况下不要打开
+    // 是否跟踪 Mi Service 相关日志（打开后可以查看设备 did）
+    enableTrace: false, // 一般情况下不要打开
   },
 };
 

docs/faq.md

@@ -44,6 +44,85 @@ export default {
 
 账号密码不正确。注意小米 ID 并非手机号或邮箱，请在[「个人信息」-「小米 ID」](https://account.xiaomi.com/fe/service/account/profile)查看，相关 [issue](https://github.com/idootop/mi-gpt/issues/10)。
 
+### Q：提示“找不到设备：xxx”，初始化 Mi Services 失败
+
+填写的设备 did 不存在，请检查设备名称是否和米家中的一致。相关 [issue](https://github.com/idootop/mi-gpt/issues/30)。
+
+<details>
+<summary>👉 查看教程</summary>
+
+查看小爱音箱设备名称：打开米家 - 进入小爱音箱主页 - 点击右上角更多 - 设备名称
+
+常见错误设备名称示例，建议直接复制米家中的设备名称：
+
+```js
+// 错别字：响 -> 箱
+❌ 小爱音响 -> ✅ 小爱音箱
+// 多余的空格
+❌ 小爱音箱 Pro -> ✅ 小爱音箱Pro
+// 注意大小写
+❌ 小爱音箱pro -> ✅ 小爱音箱Pro
+```
+
+</details>
+
+某些情况下 Mina 和 MIoT 中的设备名称可能不一致，此时需要填写设备 did。
+
+<details>
+<summary>👉 查看设备 did 教程</summary>
+
+先在 `.migpt.js` 配置文件中打开调试，重启 docker
+
+```js
+// .migpt.js
+export default {
+  speaker: {
+    // 是否启用调试
+    debug: true,
+    // 是否跟踪 Mi Service 相关日志（打开后可以查看设备 did）
+    enableTrace: true,
+    // ...
+  },
+};
+```
+
+docker 启动后会在控制台输出设备列表相关的日志，找到 `MiNA 设备列表`：
+
+```txt
+MiNA 设备列表:  [
+    {
+        "deviceID": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxx",
+        "serialNumber": "xxxx/xxxxxxx",
+        "name": "小爱音箱Pro",
+        "alias": "小爱音箱Pro",
+        "current": false,
+        "presence": "online",
+        "address": "222.xxx.0.xxx",
+        "miotDID": "123456", 👈 这就是你的小爱音箱 did
+        "hardware": "LX06",
+        "romVersion": "1.88.51",
+    }
+]
+```
+
+然后找到你的小爱音箱的 `miotDID` 填入 `.migpt.js` 即可。
+
+```js
+export default {
+  speaker: {
+    // 小爱音箱 DID 或在米家中设置的名称
+    did: "123456",
+    // ...
+  },
+};
+```
+
+获取设备成功后，记得再把之前的 `debug` 和 `enableTrace` 开关关掉。
+
+</details>
+
+注意：Mina 获取不到共享设备，如果你的小爱音箱是共享设备，是无法正常启动本项目的。
+
 ### Q：提示“login failed &&&START&&&{"notificationUrl”，无法正常启动
 
 小米账号触发了异地登录保护，需要先通过安全验证。打开小米官网登录你的小米账号，手动通过安全验证，然后等待 30 分钟左右应该就可以正常登录了。
@@ -60,21 +139,6 @@ export default {
 docker run -d --env-file D:/hello/mi-gpt/.env -v D:/hello/mi-gpt/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest
 ```
 
-### Q：提示“找不到设备：xxx”，初始化 Mi Services 失败
-
-填写的设备 did 不存在，请检查设备名称是否和米家中的一致。相关 [issue](https://github.com/idootop/mi-gpt/issues/30)。
-
-常见错误设备名称的示例：
-
-```js
-// 错别字：响 -> 箱
-❌ 小爱音响 -> ✅ 小爱音箱
-// 多余的空格
-❌ 小爱音箱 Pro -> ✅ 小爱音箱Pro
-// 注意大小写
-❌ 小爱音箱pro -> ✅ 小爱音箱Pro
-```
-
 ## 🔊 播放异常类问题
 
 ### Q：小爱音箱收到消息后，没有调用 AI 进行回复

docs/todo.md

@@ -24,5 +24,6 @@
 - ✅ 添加“小爱同学”唤醒词的相关说明 https://github.com/idootop/mi-gpt/issues/84
 - ✅ 添加进入唤醒模式时小爱莫名开始播放歌曲的说明 https://github.com/idootop/mi-gpt/issues/71
 - ✅ 添加部署和接入本地大语言模型的教程 https://github.com/idootop/mi-gpt/issues/82
+- ✅ 添加获取小爱音箱 did 的相关说明
 - 添加常见小爱音箱型号的支持情况和参数列表
 - 添加更详细的使用和配置视频教程