docs: 优化 .migpt.example.js 设置注释

.migpt.example.js

@@ -1,3 +1,6 @@
+// 注意：如果你是使用 Docker 启动，配置文件更新后需要重启 Docker 才会生效。
+// 若重启后仍未生效（比如：修改名称简介），请删除旧的 Docker 实例后重新创建。
+
 // 小爱音箱扮演角色的简介
 const botProfile = `
 性别：女
@@ -83,14 +86,21 @@ export default {
     profile: masterProfile,
   },
   speaker: {
-    // TTS 引擎
-    tts: "xiaoai",
+    /**
+     * 🏠 账号基本信息
+     */
+
     // 小米 ID
     userId: "987654321", // 注意：不是手机号或邮箱，请在「个人信息」-「小米 ID」查看
     // 账号密码
     password: "123456",
     // 小爱音箱 DID 或在米家中设置的名称
-    did: "小爱音箱Pro",
+    did: "小爱音箱Pro", // 注意空格、大小写和错别字（音响 👉 音箱）
+
+    /**
+     * 💡 唤醒词与提示语
+     */
+
     // 当消息以下面的关键词开头时，会调用 AI 来回复消息
     callAIKeywords: ["请", "你", "傻妞"],
     // 当消息以下面的关键词开头时，会进入 AI 唤醒状态
@@ -98,25 +108,57 @@ export default {
     // 当消息以下面的关键词开头时，会退出 AI 唤醒状态
     exitKeywords: ["关闭", "退出", "再见"],
     // 进入 AI 模式的欢迎语
-    onEnterAI: ["你好，我是傻妞，很高兴认识你"],
+    onEnterAI: ["你好，我是傻妞，很高兴认识你"], // 设为空数组时可关闭提示语
     // 退出 AI 模式的提示语
-    onExitAI: ["傻妞已退出"],
+    onExitAI: ["傻妞已退出"], // 为空时可关闭提示语
     // AI 开始回答时的提示语
-    onAIAsking: ["让我先想想", "请稍等"],
+    onAIAsking: ["让我先想想", "请稍等"], // 为空时可关闭提示语
     // AI 结束回答时的提示语
-    onAIReplied: ["我说完了", "还有其他问题吗"],
+    onAIReplied: ["我说完了", "还有其他问题吗"], // 为空时可关闭提示语
     // AI 回答异常时的提示语
-    onAIError: ["啊哦，出错了，请稍后再试吧！"],
-    // 无响应一段时间后，多久自动退出唤醒模式（默认 30 秒）
-    exitKeepAliveAfter: 30,
+    onAIError: ["啊哦，出错了，请稍后再试吧！"], // 为空时可关闭提示语
+
+    /**
+     * 🧩 MIoT 设备指令
+     *
+     * 常见型号的配置参数 👉 https://github.com/idootop/mi-gpt/issues/92
+     */
+
     // TTS 指令，请到 https://home.miot-spec.com 查询具体指令
     ttsCommand: [5, 1],
     // 设备唤醒指令，请到 https://home.miot-spec.com 查询具体指令
     wakeUpCommand: [5, 3],
-    // 是否启用流式响应，部分小爱音箱型号不支持查询播放状态，此时需要关闭流式响应
-    streamResponse: true,
     // 查询是否在播放中指令，请到 https://home.miot-spec.com 查询具体指令
-    // playingCommand: [3, 1, 1], // 默认无需配置此参数，播放出现问题时再尝试开启
+    // playingCommand: [3, 1, 1], // 默认无需配置此参数，查询播放状态异常时再尝试开启
+
+    /**
+     * 🔊 TTS 引擎
+     */
+
+    // TTS 引擎
+    tts: "xiaoai",
+    // 切换 TTS 引擎发言人音色关键词，只有配置了第三方 TTS 引擎时才有效
+    // switchSpeakerKeywords: ["把声音换成"], // 以此关键词开头即可切换音色，比如：把声音换成东北老铁
+
+    /**
+     * 💬 连续对话
+     *
+     * 查看哪些机型支持连续对话 👉 https://github.com/idootop/mi-gpt/issues/92
+     */
+
+    // 是否启用连续对话功能，部分小爱音箱型号无法查询到正确的播放状态，需要关闭连续对话
+    streamResponse: true,
+    // 连续对话时，无响应多久后自动退出
+    exitKeepAliveAfter: 30, // 默认 30 秒，建议不要超过 1 分钟
+    // 连续对话时，下发 TTS 指令多长时间后开始检测设备播放状态（默认 3 秒）
+    checkTTSStatusAfter: 3, // 当小爱长文本回复被过早中断时，可尝试调大该值
+    // 连续对话时，播放状态检测间隔（单位毫秒，最低 500 毫秒，默认 1 秒）
+    checkInterval: 1000, // 调小此值可以降低小爱回复之间的停顿感，请酌情调节
+
+    /**
+     * 🔌 其他选项
+     */
+
     // 是否启用调试
     debug: false, // 一般情况下不要打开
     // 是否跟踪 Mi Service 相关日志（打开后可以查看设备 did）