@z-qinghui/migpt-claw 1.0.0

package/dist/src/service.js

@@ -0,0 +1,200 @@
+import { getMiService } from "./mi/common.js";
+import { assert, sleep } from "./utils/parse.js";
+import { Debugger } from "./utils/debug.js";
+class _MiService {
+  MiNA;
+  MiOT;
+  _initialized = false;
+  _initializing = false;
+  _speakerControl = "mina";
+  /**
+   * 使用 MIoT 发送 TTS 播报
+   */
+  async playWithMiot(text) {
+    if (!this.MiOT) {
+      console.warn("\u26A0\uFE0F MIoT \u670D\u52A1\u4E0D\u53EF\u7528");
+      return false;
+    }
+    try {
+      const result = await this.MiOT.doAction(5, 1, [text]);
+      return result;
+    } catch (e) {
+      console.error("\u274C MIoT TTS \u5931\u8D25:", e?.message || e);
+      return false;
+    }
+  }
+  /**
+   * 使用 MiNA 发送 TTS 播报
+   */
+  async playWithMina(text) {
+    if (!this.MiNA) {
+      console.warn("\u26A0\uFE0F MiNA \u670D\u52A1\u4E0D\u53EF\u7528");
+      return false;
+    }
+    try {
+      const result = await this.MiNA.play({ text });
+      return result;
+    } catch (e) {
+      console.error("\u274C MiNA TTS \u5931\u8D25:", e?.message || e);
+      return false;
+    }
+  }
+  /**
+   * 发送 TTS 播报（根据配置选择 MiNA 或 MIoT）
+   */
+  async play(text) {
+    if (this._speakerControl === "miot") {
+      return this.playWithMiot(text);
+    } else {
+      return this.playWithMina(text);
+    }
+  }
+  /**
+   * 初始化服务
+   */
+  async init(config, did) {
+    if (this._initialized) {
+      console.log("\u2705 MiService \u5DF2\u521D\u59CB\u5316\uFF0C\u8DF3\u8FC7");
+      return true;
+    }
+    if (this._initializing) {
+      let waitCount = 0;
+      while (this._initializing && waitCount < 30) {
+        await sleep(100);
+        waitCount++;
+      }
+      return this._initialized;
+    }
+    this._initializing = true;
+    try {
+      console.log("\u{1F680} \u5F00\u59CB\u521D\u59CB\u5316 MiService...");
+      console.log("\u{1F4CB} \u914D\u7F6E\u4FE1\u606F:", {
+        did,
+        userId: config.userId,
+        hasPassword: !!config.password,
+        hasPassToken: !!config.passToken,
+        debug: config.debug,
+        timeout: config.timeout,
+        speakerControl: config.speakerControl
+      });
+      assert(!!did, "\u274C Speaker \u7F3A\u5C11 did \u53C2\u6570");
+      assert(
+        !!config.passToken || !!config.userId && !!config.password,
+        "\u274C Speaker \u7F3A\u5C11 passToken \u6216 userId \u548C password"
+      );
+      Debugger.debug = config.debug ?? false;
+      this._speakerControl = config.speakerControl ?? "mina";
+      const serviceConfig = {
+        ...config,
+        did,
+        timeout: Math.max(1e3, config.timeout ?? 5e3)
+      };
+      console.log("\u{1F50C} \u6B63\u5728\u8FDE\u63A5 MiNA \u670D\u52A1...");
+      this.MiNA = await getMiService({ ...serviceConfig, service: "mina" });
+      console.log("\u{1F50C} \u67E5\u8BE2 MiNA \u670D\u52A1\u7ED3\u679C\uFF1A", { mina: !!this.MiNA });
+      console.log("\u{1F50C} \u6B63\u5728\u8FDE\u63A5 MIoT \u670D\u52A1...");
+      this.MiOT = await getMiService({ ...serviceConfig, service: "miot" });
+      console.log("\u{1F50C} \u67E5\u8BE2 MIoT \u670D\u52A1\u7ED3\u679C\uFF1A", { miot: !!this.MiOT });
+      assert(!!this.MiNA, "\u274C \u521D\u59CB\u5316 MiNA \u670D\u52A1\u5931\u8D25");
+      if (!this.MiOT) {
+        console.warn("\u26A0\uFE0F MIoT \u670D\u52A1\u521D\u59CB\u5316\u5931\u8D25\uFF0C\u90E8\u5206\u8BBE\u5907\u63A7\u5236\u529F\u80FD\u53EF\u80FD\u4E0D\u53EF\u7528");
+      }
+      if (Debugger.debug) {
+        const device = this.MiNA?.account?.device;
+        console.debug(
+          "\u{1F41B} \u8BBE\u5907\u4FE1\u606F\uFF1A",
+          JSON.stringify(
+            {
+              name: device?.name,
+              desc: device?.desc,
+              model: device?.model,
+              rom: device?.extra?.fw_version
+            },
+            null,
+            2
+          )
+        );
+      }
+      this._initialized = true;
+      console.log("\u2705 MiService \u521D\u59CB\u5316\u6210\u529F");
+      console.log(`\u{1F50A} \u97F3\u7BB1\u63A7\u5236\u65B9\u5F0F\uFF1A${this._speakerControl}`);
+      const announceOnStart = config.announceOnStart ?? true;
+      if (announceOnStart) {
+        const startupMessage = config.startupMessage ?? "\u60A8\u7684\u5C0F\u9F99\u867E\u5DF2\u4E0A\u7EBF\uFF0C\u968F\u65F6\u4E3A\u60A8\u670D\u52A1";
+        try {
+          console.log("\u{1F50A} \u6B63\u5728\u53D1\u9001\u542F\u52A8\u64AD\u62A5:", startupMessage);
+          await this.play(startupMessage);
+          console.log("\u2705 \u542F\u52A8\u64AD\u62A5\u53D1\u9001\u6210\u529F");
+        } catch (e) {
+          console.warn("\u26A0\uFE0F \u542F\u52A8\u64AD\u62A5\u53D1\u9001\u5931\u8D25:", e?.message || e);
+        }
+      }
+      return true;
+    } catch (err) {
+      console.error("\u274C \u521D\u59CB\u5316\u5931\u8D25:", { err, message: err.message });
+      return false;
+    } finally {
+      this._initializing = false;
+    }
+  }
+  /**
+   * 获取设备列表
+   */
+  async getDevices(config) {
+    try {
+      const tempService = await getMiService({ ...config, service: "mina", relogin: false });
+      if (!tempService) {
+        return [];
+      }
+      const devices = await tempService.getDevices();
+      return (devices || []).map((d) => ({
+        did: d.name || d.alias || d.deviceID,
+        name: d.alias || d.name,
+        model: d.model
+      }));
+    } catch (err) {
+      console.error("\u274C \u83B7\u53D6\u8BBE\u5907\u5217\u8868\u5931\u8D25:", err);
+      return [];
+    }
+  }
+  /**
+   * 重新登录
+   */
+  async relogin(config, did) {
+    this._initialized = false;
+    return this.init(config, did);
+  }
+  /**
+   * 唤醒小爱音箱（进入监听状态）
+   * 使用 MIoT spec 调用唤醒动作 (siid=5, aiid=3)
+   * 基于 mi-gpt 项目的实现
+   */
+  async wakeUp() {
+    if (!this.MiOT) {
+      console.warn("\u26A0\uFE0F MIoT \u670D\u52A1\u4E0D\u53EF\u7528\uFF0C\u65E0\u6CD5\u5524\u9192\u97F3\u7BB1");
+      return false;
+    }
+    try {
+      const result = await this.MiOT.doAction(5, 3, []);
+      return result;
+    } catch (e) {
+      console.warn("\u26A0\uFE0F \u5524\u9192\u97F3\u7BB1\u5931\u8D25:", e?.message || e);
+      return false;
+    }
+  }
+  /**
+   * 退出监听状态（取消唤醒）
+   * 使用 MiNA 暂停使小爱退出监听
+   */
+  async unWakeUp() {
+    if (this.MiNA) {
+      await this.MiNA.pause().catch(() => {
+      });
+    }
+  }
+}
+const MiService = new _MiService();
+export {
+  MiService
+};
+//# sourceMappingURL=service.js.map

package/dist/src/service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/service.ts"],"sourcesContent":["import { MiNA } from './mi/mina.js';\nimport { MIoT } from './mi/miot.js';\nimport { getMiService } from './mi/common.js';\nimport { assert, sleep } from './utils/parse.js';\nimport { Debugger } from './utils/debug.js';\n\nexport interface MiServiceConfig {\n  /** 小米 ID（数字） */\n  userId?: string;\n  /** 密码 */\n  password?: string;\n  /** 登录凭证 */\n  passToken?: string;\n  /** 是否开启调试模式 */\n  debug?: boolean;\n  /** 网络请求超时时长（毫秒） */\n  timeout?: number;\n  /** 音箱控制方式：mina/miot */\n  speakerControl?: 'mina' | 'miot';\n}\n\nclass _MiService {\n  MiNA?: MiNA;\n  MiOT?: MIoT;\n  private _initialized = false;\n  private _initializing = false;\n  private _speakerControl: 'mina' | 'miot' = 'mina';\n\n  /**\n   * 使用 MIoT 发送 TTS 播报\n   */\n  async playWithMiot(text: string): Promise<boolean> {\n    if (!this.MiOT) {\n      console.warn('⚠️ MIoT 服务不可用');\n      return false;\n    }\n    try {\n      // 使用 MIoT spec 调用 TTS 动作 (siid=5, aiid=1 是常见的 TTS 动作)\n      // 不同设备可能不同，需要根据设备 spec 调整\n      const result = await this.MiOT.doAction(5, 1, [text]);\n      return result;\n    } catch (e: any) {\n      console.error('❌ MIoT TTS 失败:', e?.message || e);\n      return false;\n    }\n  }\n\n  /**\n   * 使用 MiNA 发送 TTS 播报\n   */\n  async playWithMina(text: string): Promise<boolean> {\n    if (!this.MiNA) {\n      console.warn('⚠️ MiNA 服务不可用');\n      return false;\n    }\n    try {\n      const result = await this.MiNA.play({ text });\n      return result;\n    } catch (e: any) {\n      console.error('❌ MiNA TTS 失败:', e?.message || e);\n      return false;\n    }\n  }\n\n  /**\n   * 发送 TTS 播报（根据配置选择 MiNA 或 MIoT）\n   */\n  async play(text: string): Promise<boolean> {\n    if (this._speakerControl === 'miot') {\n      return this.playWithMiot(text);\n    } else {\n      return this.playWithMina(text);\n    }\n  }\n\n  /**\n   * 初始化服务\n   */\n  async init(config: MiServiceConfig & { \n    announceOnStart?: boolean; \n    startupMessage?: string; \n  }, did: string): Promise<boolean> {\n    if (this._initialized) {\n      console.log('✅ MiService 已初始化，跳过');\n      return true;\n    }\n\n    if (this._initializing) {\n      // 等待初始化完成\n      let waitCount = 0;\n      while (this._initializing && waitCount < 30) {\n        await sleep(100);\n        waitCount++;\n      }\n      return this._initialized;\n    }\n\n    this._initializing = true;\n\n    try {\n      console.log('🚀 开始初始化 MiService...');\n      console.log('📋 配置信息:', {\n        did,\n        userId: config.userId,\n        hasPassword: !!config.password,\n        hasPassToken: !!config.passToken,\n        debug: config.debug,\n        timeout: config.timeout,\n        speakerControl:config.speakerControl\n      });\n\n      assert(!!did, '❌ Speaker 缺少 did 参数');\n      assert(\n        !!config.passToken || (!!config.userId && !!config.password),\n        '❌ Speaker 缺少 passToken 或 userId 和 password',\n      );\n\n      Debugger.debug = config.debug ?? false;\n      this._speakerControl = config.speakerControl ?? 'mina';\n\n      const serviceConfig = {\n        ...config,\n        did,\n        timeout: Math.max(1000, config.timeout ?? 5000),\n      };\n\n      console.log('🔌 正在连接 MiNA 服务...');\n      this.MiNA = (await getMiService({ ...serviceConfig, service: 'mina' })) as MiNA | undefined;\n      console.log('🔌 查询 MiNA 服务结果：', { mina: !!this.MiNA });\n\n      // MiOT 对于音箱设备是可选的，只记录警告不阻断\n      console.log('🔌 正在连接 MIoT 服务...');\n      this.MiOT = (await getMiService({ ...serviceConfig, service: 'miot' })) as MIoT | undefined;\n      console.log('🔌 查询 MIoT 服务结果：', { miot: !!this.MiOT });\n\n      // 对于音箱设备，MiNA 是必需的，MiOT 是可选的\n      assert(!!this.MiNA, '❌ 初始化 MiNA 服务失败');\n      if (!this.MiOT) {\n        console.warn('⚠️ MIoT 服务初始化失败，部分设备控制功能可能不可用');\n      }\n\n      if (Debugger.debug) {\n        const device: any = this.MiNA?.account?.device;\n        console.debug(\n          '🐛 设备信息：',\n          JSON.stringify(\n            {\n              name: device?.name,\n              desc: device?.desc,\n              model: device?.model,\n              rom: device?.extra?.fw_version,\n            },\n            null,\n            2,\n          ),\n        );\n      }\n\n      this._initialized = true;\n      console.log('✅ MiService 初始化成功');\n      console.log(`🔊 音箱控制方式：${this._speakerControl}`);\n\n      // 初始化成功后发送 TTS 播报（如果启用了启动播报）\n      const announceOnStart = config.announceOnStart ?? true;\n      if (announceOnStart) {\n        const startupMessage = config.startupMessage ?? '您的小龙虾已上线，随时为您服务';\n        try {\n          console.log('🔊 正在发送启动播报:', startupMessage);\n          await this.play(startupMessage);\n          console.log('✅ 启动播报发送成功');\n        } catch (e: any) {\n          console.warn('⚠️ 启动播报发送失败:', e?.message || e);\n        }\n      }\n\n      return true;\n    } catch (err: any) {\n      console.error('❌ 初始化失败:',{err:err,message: err.message});\n      return false;\n    } finally {\n      this._initializing = false;\n    }\n  }\n\n  /**\n   * 获取设备列表\n   */\n  async getDevices(config: MiServiceConfig): Promise<Array<{ did: string; name: string; model?: string }>> {\n    try {\n      // 临时初始化以获取设备列表\n      const tempService = await getMiService({ ...config, service: 'mina', relogin: false });\n      if (!tempService) {\n        return [];\n      }\n\n      const devices = await (tempService as MiNA).getDevices();\n      return (devices || []).map((d: any) => ({\n        did: d.name || d.alias || d.deviceID,\n        name: d.alias || d.name,\n        model: d.model,\n      }));\n    } catch (err) {\n      console.error('❌ 获取设备列表失败:', err);\n      return [];\n    }\n  }\n\n  /**\n   * 重新登录\n   */\n  async relogin(config: MiServiceConfig, did: string): Promise<boolean> {\n    this._initialized = false;\n    return this.init(config, did);\n  }\n\n  /**\n   * 唤醒小爱音箱（进入监听状态）\n   * 使用 MIoT spec 调用唤醒动作 (siid=5, aiid=3)\n   * 基于 mi-gpt 项目的实现\n   */\n  async wakeUp(): Promise<boolean> {\n    if (!this.MiOT) {\n      console.warn('⚠️ MIoT 服务不可用，无法唤醒音箱');\n      return false;\n    }\n    try {\n      const result = await this.MiOT.doAction(5, 3, []);\n      return result;\n    } catch (e: any) {\n      console.warn('⚠️ 唤醒音箱失败:', e?.message || e);\n      return false;\n    }\n  }\n\n  /**\n   * 退出监听状态（取消唤醒）\n   * 使用 MiNA 暂停使小爱退出监听\n   */\n  async unWakeUp(): Promise<void> {\n    if (this.MiNA) {\n      await this.MiNA.pause().catch(() => {});\n    }\n  }\n}\n\nexport const MiService = new _MiService();\n"],"mappings":"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","names":[]}

package/dist/src/speaker.d.ts

@@ -0,0 +1,62 @@
+import { MiMoTTS } from './tts/mimo.js';
+
+interface IPlayOptions {
+    text?: string;
+    url?: string;
+    duration?: number;
+}
+interface IPlayResult {
+    success: boolean;
+    error?: string;
+    duration?: number;
+}
+declare class _MiSpeaker {
+    /** MiMo TTS 实例（延迟注入） */
+    private _mimoTTS;
+    /**
+     * 注入 MiMo TTS 提供者（自动清理旧实例，防止端口泄漏）
+     */
+    setMiMoTTS(tts: MiMoTTS): Promise<void>;
+    /**
+     * 清理 MiMo TTS 资源（释放端口和临时文件）
+     */
+    cleanupMiMoTTS(): Promise<void>;
+    /**
+     * 播放文字、音频链接
+     * 优先使用 MiMo TTS（如果已配置），否则回退到小米原生 TTS
+     */
+    play(options: IPlayOptions): Promise<IPlayResult>;
+    /**
+     * 自定义 TTS 播放前的抑制处理
+     * 暂停当前播放，防止小爱将 TTS 音频误识别为用户语音指令
+     */
+    private _suppressBeforeCustomTTS;
+    /**
+     * 设置音量
+     */
+    setVolume(volume: number): Promise<IPlayResult>;
+    /**
+     * 获取音量
+     */
+    getVolume(): Promise<number | undefined>;
+    /**
+     * 暂停播放
+     */
+    pause(): Promise<IPlayResult>;
+    /**
+     * 停止播放
+     */
+    stop(): Promise<IPlayResult>;
+    /**
+     * 播放或暂停
+     */
+    playOrPause(): Promise<IPlayResult>;
+    /**
+     * 中断小爱音箱的运行（重启设备）
+     * 注意：重启需要大约 1-2s 的时间，在此期间无法使用小爱音箱自带的 TTS 服务
+     */
+    abortXiaoAI(): Promise<boolean>;
+}
+declare const MiSpeaker: _MiSpeaker;
+
+export { type IPlayOptions, type IPlayResult, MiSpeaker };

package/dist/src/speaker.js

@@ -0,0 +1,211 @@
+import { networkInterfaces } from "node:os";
+import { MiService } from "./service.js";
+function getHostLANIP() {
+  const envIP = process.env.MIMO_TTS_HOST_IP;
+  if (envIP) return envIP;
+  const nets = networkInterfaces();
+  for (const name of Object.keys(nets)) {
+    for (const net of nets[name] ?? []) {
+      if (net.internal || net.family !== "IPv4") continue;
+      if (net.address.startsWith("172.17.")) continue;
+      if (net.address.startsWith("192.168.") || net.address.startsWith("10.") || net.address.startsWith("172.16.") || net.address.startsWith("172.18.") || net.address.startsWith("172.19.") || net.address.startsWith("172.2") || net.address.startsWith("172.3")) {
+        return net.address;
+      }
+    }
+  }
+  for (const name of Object.keys(nets)) {
+    for (const net of nets[name] ?? []) {
+      if (!net.internal && net.family === "IPv4") return net.address;
+    }
+  }
+  return "127.0.0.1";
+}
+class _MiSpeaker {
+  /** MiMo TTS 实例（延迟注入） */
+  _mimoTTS = null;
+  /**
+   * 注入 MiMo TTS 提供者（自动清理旧实例，防止端口泄漏）
+   */
+  async setMiMoTTS(tts) {
+    if (this._mimoTTS) {
+      console.log("\u{1F50A} \u6E05\u7406\u65E7 MiMo TTS \u5B9E\u4F8B...");
+      await this._mimoTTS.destroy().catch(() => {
+      });
+    }
+    this._mimoTTS = tts;
+  }
+  /**
+   * 清理 MiMo TTS 资源（释放端口和临时文件）
+   */
+  async cleanupMiMoTTS() {
+    if (this._mimoTTS) {
+      console.log("\u{1F50A} \u6E05\u7406 MiMo TTS \u8D44\u6E90...");
+      await this._mimoTTS.destroy().catch(() => {
+      });
+      this._mimoTTS = null;
+    }
+  }
+  /**
+   * 播放文字、音频链接
+   * 优先使用 MiMo TTS（如果已配置），否则回退到小米原生 TTS
+   */
+  async play(options) {
+    const { text, url } = options;
+    console.log(`\u{1F50A} Speaker.play called: text=${text?.slice(0, 50)}..., url=${url}`);
+    if (!MiService.MiNA && !MiService.MiOT) {
+      console.error("\u274C Speaker.play failed: MiNA/MiOT service not initialized");
+      return { success: false, error: "MiNA/MiOT service not initialized" };
+    }
+    try {
+      let result;
+      if (url) {
+        if (!MiService.MiNA) {
+          return { success: false, error: "MiNA service not initialized for URL playback" };
+        }
+        console.log(`\u{1F50A} Playing URL: ${url}`);
+        result = await MiService.MiNA.play({ url });
+      } else if (text) {
+        if (this._mimoTTS) {
+          console.log(`\u{1F50A} Using MiMo TTS for: ${text.slice(0, 30)}...`);
+          const ttsResult = await this._mimoTTS.synthesize(text);
+          if (ttsResult.success && ttsResult.url) {
+            await this._suppressBeforeCustomTTS();
+            const hostIP = getHostLANIP();
+            const externalUrl = ttsResult.url.replace(/0\.0\.0\.0|127\.0\.0\.1|localhost/g, hostIP);
+            console.log(`\u{1F50A} MiMo TTS \u64AD\u653E: ${externalUrl} (\u65F6\u957F: ${ttsResult.duration?.toFixed(1)}s)`);
+            const duration = ttsResult.duration;
+            result = await MiService.MiNA.play({ url: externalUrl });
+            console.log(`\u{1F50A} MiMo TTS play result: ${result}`);
+            return { success: result, duration };
+          } else {
+            console.warn("\u26A0\uFE0F MiMo TTS \u5931\u8D25\uFF0C\u56DE\u9000\u5230\u539F\u751F TTS:", ttsResult.error);
+            result = await MiService.play(text);
+          }
+        } else {
+          console.log(`\u{1F50A} Using native TTS for: ${text.slice(0, 30)}...`);
+          result = await MiService.play(text);
+        }
+      } else {
+        return { success: false, error: "text or url is required" };
+      }
+      if (result) {
+        return { success: true, duration: options.duration };
+      } else {
+        return { success: false, error: "Playback failed" };
+      }
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  }
+  /**
+   * 自定义 TTS 播放前的抑制处理
+   * 暂停当前播放，防止小爱将 TTS 音频误识别为用户语音指令
+   */
+  async _suppressBeforeCustomTTS() {
+    if (MiService.MiNA) {
+      await MiService.MiNA.pause().catch(() => {
+      });
+    }
+  }
+  /**
+   * 设置音量
+   */
+  async setVolume(volume) {
+    if (!MiService.MiNA && !MiService.MiOT) {
+      return { success: false, error: "MiNA/MiOT service not initialized" };
+    }
+    try {
+      if (MiService.MiNA) {
+        const result = await MiService.MiNA.setVolume(volume);
+        if (result) {
+          return { success: true };
+        } else {
+          return { success: false, error: "Failed to set volume" };
+        }
+      } else {
+        return { success: false, error: "MiNA service required for volume control" };
+      }
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  }
+  /**
+   * 获取音量
+   */
+  async getVolume() {
+    if (!MiService.MiNA) {
+      return void 0;
+    }
+    try {
+      return await MiService.MiNA.getVolume();
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * 暂停播放
+   */
+  async pause() {
+    if (!MiService.MiNA && !MiService.MiOT) {
+      return { success: false, error: "MiNA/MiOT service not initialized" };
+    }
+    try {
+      if (MiService.MiNA) {
+        const result = await MiService.MiNA.pause();
+        return { success: result };
+      } else {
+        return { success: false, error: "MiNA service required for pause" };
+      }
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  }
+  /**
+   * 停止播放
+   */
+  async stop() {
+    if (!MiService.MiNA && !MiService.MiOT) {
+      return { success: false, error: "MiNA/MiOT service not initialized" };
+    }
+    try {
+      if (MiService.MiNA) {
+        const result = await MiService.MiNA.stop();
+        return { success: result };
+      } else {
+        return { success: false, error: "MiNA service required for stop" };
+      }
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  }
+  /**
+   * 播放或暂停
+   */
+  async playOrPause() {
+    if (!MiService.MiNA && !MiService.MiOT) {
+      return { success: false, error: "MiNA/MiOT service not initialized" };
+    }
+    try {
+      if (MiService.MiNA) {
+        const result = await MiService.MiNA.playOrPause();
+        return { success: result };
+      } else {
+        return { success: false, error: "MiNA service required for playOrPause" };
+      }
+    } catch (err) {
+      return { success: false, error: err.message };
+    }
+  }
+  /**
+   * 中断小爱音箱的运行（重启设备）
+   * 注意：重启需要大约 1-2s 的时间，在此期间无法使用小爱音箱自带的 TTS 服务
+   */
+  async abortXiaoAI() {
+    return false;
+  }
+}
+const MiSpeaker = new _MiSpeaker();
+export {
+  MiSpeaker
+};
+//# sourceMappingURL=speaker.js.map

package/dist/src/speaker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/speaker.ts"],"sourcesContent":["import { networkInterfaces } from 'node:os';\nimport { MiService } from './service.js';\nimport type { MiMoTTS } from './tts/mimo.js';\n\n/**\n * 获取小爱音箱可访问的主机 IP\n * 优先使用环境变量 MIMO_TTS_HOST_IP，否则自动检测\n */\nfunction getHostLANIP(): string {\n  // 优先使用环境变量（适用于云服务器场景）\n  const envIP = process.env.MIMO_TTS_HOST_IP;\n  if (envIP) return envIP;\n\n  const nets = networkInterfaces();\n  for (const name of Object.keys(nets)) {\n    for (const net of nets[name] ?? []) {\n      if (net.internal || net.family !== 'IPv4') continue;\n      if (net.address.startsWith('172.17.')) continue;\n      if (\n        net.address.startsWith('192.168.') ||\n        net.address.startsWith('10.') ||\n        net.address.startsWith('172.16.') ||\n        net.address.startsWith('172.18.') ||\n        net.address.startsWith('172.19.') ||\n        net.address.startsWith('172.2') ||\n        net.address.startsWith('172.3')\n      ) {\n        return net.address;\n      }\n    }\n  }\n  for (const name of Object.keys(nets)) {\n    for (const net of nets[name] ?? []) {\n      if (!net.internal && net.family === 'IPv4') return net.address;\n    }\n  }\n  return '127.0.0.1';\n}\n\nexport interface IPlayOptions {\n  text?: string;\n  url?: string;\n  duration?: number;\n}\n\nexport interface IPlayResult {\n  success: boolean;\n  error?: string;\n  duration?: number;\n}\n\nclass _MiSpeaker {\n  /** MiMo TTS 实例（延迟注入） */\n  private _mimoTTS: MiMoTTS | null = null;\n\n  /**\n   * 注入 MiMo TTS 提供者（自动清理旧实例，防止端口泄漏）\n   */\n  async setMiMoTTS(tts: MiMoTTS) {\n    // 清理旧实例，释放端口\n    if (this._mimoTTS) {\n      console.log('🔊 清理旧 MiMo TTS 实例...');\n      await this._mimoTTS.destroy().catch(() => {});\n    }\n    this._mimoTTS = tts;\n  }\n\n  /**\n   * 清理 MiMo TTS 资源（释放端口和临时文件）\n   */\n  async cleanupMiMoTTS() {\n    if (this._mimoTTS) {\n      console.log('🔊 清理 MiMo TTS 资源...');\n      await this._mimoTTS.destroy().catch(() => {});\n      this._mimoTTS = null;\n    }\n  }\n\n  /**\n   * 播放文字、音频链接\n   * 优先使用 MiMo TTS（如果已配置），否则回退到小米原生 TTS\n   */\n  async play(options: IPlayOptions): Promise<IPlayResult> {\n    const { text, url } = options;\n\n    console.log(`🔊 Speaker.play called: text=${text?.slice(0, 50)}..., url=${url}`);\n\n    if (!MiService.MiNA && !MiService.MiOT) {\n      console.error('❌ Speaker.play failed: MiNA/MiOT service not initialized');\n      return { success: false, error: 'MiNA/MiOT service not initialized' };\n    }\n\n    try {\n      let result: boolean;\n      if (url) {\n        // URL 播放只支持 MiNA\n        if (!MiService.MiNA) {\n          return { success: false, error: 'MiNA service not initialized for URL playback' };\n        }\n        console.log(`🔊 Playing URL: ${url}`);\n        result = await MiService.MiNA.play({ url });\n      } else if (text) {\n        // 优先使用 MiMo TTS\n        if (this._mimoTTS) {\n          console.log(`🔊 Using MiMo TTS for: ${text.slice(0, 30)}...`);\n          const ttsResult = await this._mimoTTS.synthesize(text);\n          if (ttsResult.success && ttsResult.url) {\n            await this._suppressBeforeCustomTTS();\n            const hostIP = getHostLANIP();\n            const externalUrl = ttsResult.url.replace(/0\\.0\\.0\\.0|127\\.0\\.0\\.1|localhost/g, hostIP);\n            console.log(`🔊 MiMo TTS 播放: ${externalUrl} (时长: ${ttsResult.duration?.toFixed(1)}s)`);\n            const duration = ttsResult.duration;  // 保存 duration\n            result = await MiService.MiNA!.play({ url: externalUrl });\n            console.log(`🔊 MiMo TTS play result: ${result}`);\n            // 无论播放是否成功，都返回 duration\n            return { success: result, duration };\n          } else {\n            console.warn('⚠️ MiMo TTS 失败，回退到原生 TTS:', ttsResult.error);\n            result = await MiService.play(text);\n          }\n        } else {\n          // 文字播报使用配置的播放方式\n          console.log(`🔊 Using native TTS for: ${text.slice(0, 30)}...`);\n          result = await MiService.play(text);\n        }\n      } else {\n        return { success: false, error: 'text or url is required' };\n      }\n\n      if (result) {\n        return { success: true, duration: options.duration };\n      } else {\n        return { success: false, error: 'Playback failed' };\n      }\n    } catch (err: any) {\n      return { success: false, error: err.message };\n    }\n  }\n\n  /**\n   * 自定义 TTS 播放前的抑制处理\n   * 暂停当前播放，防止小爱将 TTS 音频误识别为用户语音指令\n   */\n  private async _suppressBeforeCustomTTS() {\n    if (MiService.MiNA) {\n      await MiService.MiNA.pause().catch(() => {});\n    }\n  }\n\n  /**\n   * 设置音量\n   */\n  async setVolume(volume: number): Promise<IPlayResult> {\n    if (!MiService.MiNA && !MiService.MiOT) {\n      return { success: false, error: 'MiNA/MiOT service not initialized' };\n    }\n\n    try {\n      // 音量控制只支持 MiNA\n      if (MiService.MiNA) {\n        const result = await MiService.MiNA.setVolume(volume);\n        if (result) {\n          return { success: true };\n        } else {\n          return { success: false, error: 'Failed to set volume' };\n        }\n      } else {\n        return { success: false, error: 'MiNA service required for volume control' };\n      }\n    } catch (err: any) {\n      return { success: false, error: err.message };\n    }\n  }\n\n  /**\n   * 获取音量\n   */\n  async getVolume(): Promise<number | undefined> {\n    if (!MiService.MiNA) {\n      return undefined;\n    }\n\n    try {\n      return await MiService.MiNA.getVolume();\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * 暂停播放\n   */\n  async pause(): Promise<IPlayResult> {\n    if (!MiService.MiNA && !MiService.MiOT) {\n      return { success: false, error: 'MiNA/MiOT service not initialized' };\n    }\n\n    try {\n      // 暂停只支持 MiNA\n      if (MiService.MiNA) {\n        const result = await MiService.MiNA.pause();\n        return { success: result };\n      } else {\n        return { success: false, error: 'MiNA service required for pause' };\n      }\n    } catch (err: any) {\n      return { success: false, error: err.message };\n    }\n  }\n\n  /**\n   * 停止播放\n   */\n  async stop(): Promise<IPlayResult> {\n    if (!MiService.MiNA && !MiService.MiOT) {\n      return { success: false, error: 'MiNA/MiOT service not initialized' };\n    }\n\n    try {\n      // 停止只支持 MiNA\n      if (MiService.MiNA) {\n        const result = await MiService.MiNA.stop();\n        return { success: result };\n      } else {\n        return { success: false, error: 'MiNA service required for stop' };\n      }\n    } catch (err: any) {\n      return { success: false, error: err.message };\n    }\n  }\n\n  /**\n   * 播放或暂停\n   */\n  async playOrPause(): Promise<IPlayResult> {\n    if (!MiService.MiNA && !MiService.MiOT) {\n      return { success: false, error: 'MiNA/MiOT service not initialized' };\n    }\n\n    try {\n      // 播放或暂停只支持 MiNA\n      if (MiService.MiNA) {\n        const result = await MiService.MiNA.playOrPause();\n        return { success: result };\n      } else {\n        return { success: false, error: 'MiNA service required for playOrPause' };\n      }\n    } catch (err: any) {\n      return { success: false, error: err.message };\n    }\n  }\n\n  /**\n   * 中断小爱音箱的运行（重启设备）\n   * 注意：重启需要大约 1-2s 的时间，在此期间无法使用小爱音箱自带的 TTS 服务\n   */\n  async abortXiaoAI(): Promise<boolean> {\n    // 无法通过 MiOT 中断小爱运行\n    // 可以通过 MiOT 重启设备，但这会影响所有功能\n    return false;\n  }\n}\n\nexport const MiSpeaker = new _MiSpeaker();\n"],"mappings":"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","names":[]}

package/dist/src/tts/mimo.d.ts

@@ -0,0 +1,50 @@
+interface MiMoTTSConfig {
+    /** MiMo API Key */
+    apiKey: string;
+    /** MiMo API Base URL，默认 https://api.xiaomimimo.com/v1 */
+    baseUrl?: string;
+    /** TTS 模型，默认 mimo-v2.5-tts */
+    model?: string;
+    /** 预设音色 ID，默认 mimo_default */
+    voice?: string;
+    /** 风格指令（放在 user role 中） */
+    style?: string;
+    /** 是否启用流式传输（减少首字延迟），默认 true */
+    stream?: boolean;
+    /** 本地服务器监听端口，0 = 自动分配 */
+    port?: number;
+    /** 本地服务器监听地址，默认 0.0.0.0 */
+    host?: string;
+}
+declare class MiMoTTS {
+    private _server;
+    private _serverUrl;
+    private _audioDir;
+    private _config;
+    private _ready;
+    constructor(config: MiMoTTSConfig);
+    /**
+     * 初始化：创建临时目录 + 启动 HTTP 服务器
+     */
+    init(): Promise<boolean>;
+    /**
+     * 生成语音并返回可播放的 URL
+     */
+    synthesize(text: string, options?: {
+        voice?: string;
+        style?: string;
+    }): Promise<{
+        url: string;
+        success: boolean;
+        error?: string;
+        duration?: number;
+    }>;
+    /**
+     * 清理临时文件和关闭服务器
+     */
+    destroy(): Promise<void>;
+    get ready(): boolean;
+    get serverUrl(): string;
+}
+
+export { MiMoTTS, type MiMoTTSConfig };