@z-qinghui/migpt-claw 1.0.0

package/src/config.ts

@@ -0,0 +1,299 @@
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+import type { MiServiceConfig } from './service.js';
+import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk';
+
+/**
+ * 小米音箱 Channel 配置
+ */
+export interface MiGPTConfig extends MiServiceConfig {
+  /** 启用频道 */
+  enabled?: boolean;
+  /** 默认账户 ID */
+  defaultAccount?: string;
+  /** 设备访问策略：pairing/allowlist/open */
+  devicePolicy?: 'pairing' | 'allowlist' | 'open';
+  /** 允许的设备名称白名单 */
+  allowFrom?: Array<string | number>;
+  /** 启用流式 TTS */
+  streaming?: boolean;
+  /** TTS 文本分块长度（汉字） */
+  textChunkLimit?: number;
+  /** TTS 语速（0.5-2.0） */
+  ttsSpeed?: number;
+  /** 默认音量（6-100） */
+  volume?: number;
+  /** 消息轮询间隔（毫秒） */
+  heartbeat?: number;
+  /** 设备名称列表 */
+  devices?: string[];
+  /** 账户配置 */
+  accounts?: Record<string, MiGPTAccountConfig>;
+  /** 音箱控制方式：mina/miot */
+  speakerControl?: 'mina' | 'miot';
+  /** 系统提示词：用于定制 AI 在音箱场景下的行为规范 */
+  systemPrompt?: string;
+  /** 启动时是否播报上线文案 */
+  announceOnStart?: boolean;
+  /** 上线播报文案 */
+  startupMessage?: string;
+  /** 收到消息时是否回复收到 */
+  acknowledgeOnReceive?: boolean;
+  /** 收到消息回复文案 */
+  receiveMessage?: string;
+}
+
+/**
+ * 账户配置
+ */
+export interface MiGPTAccountConfig extends MiServiceConfig {
+  /** 启用账户 */
+  enabled?: boolean;
+  /** 账户名称 */
+  name?: string;
+  /** 设备名称列表 */
+  devices?: string[];
+  /** 系统提示词：用于定制 AI 在音箱场景下的行为规范 */
+  systemPrompt?: string;
+  /** 启动时是否播报上线文案 */
+  announceOnStart?: boolean;
+  /** 上线播报文案 */
+  startupMessage?: string;
+  /** 收到消息时是否回复收到 */
+  acknowledgeOnReceive?: boolean;
+  /** 收到消息回复文案 */
+  receiveMessage?: string;
+}
+
+/**
+ * 解析后的账户信息
+ */
+export interface ResolvedMiAccount {
+  /** 账户 ID */
+  accountId: string;
+  /** 启用状态 */
+  enabled: boolean;
+  /** 是否已配置 */
+  configured: boolean;
+  /** 账户名称 */
+  name?: string;
+  /** 设备列表 */
+  devices: string[];
+  /** 配置详情 */
+  config: MiGPTAccountConfig;
+}
+
+/**
+ * OpenClaw 配置类型扩展
+ */
+export interface ExtendedOpenClawConfig extends OpenClawConfig {
+  channels?: {
+    migpt?: MiGPTConfig;
+  };
+}
+
+/**
+ * 列出所有账户 ID
+ */
+export function listMiAccountIds(cfg: ExtendedOpenClawConfig): string[] {
+  const migptCfg = cfg.channels?.migpt;
+  if (!migptCfg?.accounts) {
+    return [DEFAULT_ACCOUNT_ID];
+  }
+  return [DEFAULT_ACCOUNT_ID, ...Object.keys(migptCfg.accounts)];
+}
+
+/**
+ * 解析账户配置
+ */
+export function resolveMiAccount(
+  cfg: ExtendedOpenClawConfig,
+  accountId?: string,
+): ResolvedMiAccount {
+  const id = accountId ?? DEFAULT_ACCOUNT_ID;
+  const migptCfg = cfg.channels?.migpt;
+  const isDefault = id === DEFAULT_ACCOUNT_ID;
+
+  // 获取账户特定配置
+  const accountConfig = isDefault
+    ? { ...migptCfg }
+    : migptCfg?.accounts?.[id] ?? {};
+
+  // 合并全局和账户特定配置
+  const mergedConfig: MiGPTAccountConfig = {
+    enabled: isDefault ? migptCfg?.enabled : accountConfig.enabled,
+    userId: accountConfig.userId ?? migptCfg?.userId,
+    password: accountConfig.password ?? migptCfg?.password,
+    passToken: accountConfig.passToken ?? migptCfg?.passToken,
+    debug: accountConfig.debug ?? migptCfg?.debug,
+    timeout: accountConfig.timeout ?? migptCfg?.timeout,
+    devices: accountConfig.devices ?? migptCfg?.devices ?? [],
+    speakerControl: accountConfig.speakerControl ?? migptCfg?.speakerControl,
+  };
+
+  // 检查是否已配置
+  const configured = !!(
+    mergedConfig.userId &&
+    (mergedConfig.passToken || mergedConfig.password)
+  );
+
+  return {
+    accountId: id,
+    enabled: mergedConfig.enabled ?? false,
+    configured,
+    name: accountConfig.name ?? (isDefault ? 'Default' : id),
+    devices: mergedConfig.devices ?? [],
+    config: mergedConfig,
+  };
+}
+
+/**
+ * 获取默认账户 ID
+ */
+export function resolveDefaultMiAccountId(cfg: ExtendedOpenClawConfig): string {
+  return cfg.channels?.migpt?.defaultAccount ?? DEFAULT_ACCOUNT_ID;
+}
+
+/**
+ * 应用账户配置
+ */
+export function applyMiAccountConfig(
+  cfg: ExtendedOpenClawConfig,
+  accountId: string,
+  updates: Partial<MiGPTAccountConfig>,
+): ExtendedOpenClawConfig {
+  const isDefault = accountId === DEFAULT_ACCOUNT_ID;
+  const migptCfg = cfg.channels?.migpt ?? {};
+
+  if (isDefault) {
+    return {
+      ...cfg,
+      channels: {
+        ...cfg.channels,
+        migpt: {
+          ...migptCfg,
+          ...updates,
+        },
+      },
+    };
+  }
+
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      migpt: {
+        ...migptCfg,
+        accounts: {
+          ...migptCfg.accounts,
+          [accountId]: {
+            ...migptCfg.accounts?.[accountId],
+            ...updates,
+          },
+        },
+      },
+    },
+  };
+}
+
+/**
+ * 设置账户启用状态
+ */
+export function setMiAccountEnabled(
+  cfg: ExtendedOpenClawConfig,
+  accountId: string,
+  enabled: boolean,
+): ExtendedOpenClawConfig {
+  const isDefault = accountId === DEFAULT_ACCOUNT_ID;
+  const migptCfg = cfg.channels?.migpt ?? {};
+
+  if (isDefault) {
+    return {
+      ...cfg,
+      channels: {
+        ...cfg.channels,
+        migpt: {
+          ...migptCfg,
+          enabled,
+        },
+      },
+    };
+  }
+
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      migpt: {
+        ...migptCfg,
+        accounts: {
+          ...migptCfg.accounts,
+          [accountId]: {
+            ...migptCfg.accounts?.[accountId],
+            enabled,
+          },
+        },
+      },
+    },
+  };
+}
+
+/**
+ * 删除账户
+ */
+export function deleteMiAccount(
+  cfg: ExtendedOpenClawConfig,
+  accountId: string,
+): ExtendedOpenClawConfig {
+  const isDefault = accountId === DEFAULT_ACCOUNT_ID;
+  const migptCfg = cfg.channels?.migpt;
+
+  if (isDefault) {
+    // 删除整个 migpt 配置
+    const next = { ...cfg } as ExtendedOpenClawConfig;
+    const nextChannels = { ...cfg.channels };
+    delete (nextChannels as Record<string, unknown>).migpt;
+    if (Object.keys(nextChannels).length > 0) {
+      next.channels = nextChannels;
+    } else {
+      delete next.channels;
+    }
+    return next;
+  }
+
+  // 删除特定账户
+  const accounts = { ...migptCfg?.accounts };
+  delete accounts[accountId];
+
+  return {
+    ...cfg,
+    channels: {
+      ...cfg.channels,
+      migpt: {
+        ...migptCfg,
+        accounts: Object.keys(accounts).length > 0 ? accounts : undefined,
+      },
+    },
+  };
+}
+
+/**
+ * 解析允许的设备列表
+ */
+export function resolveMiAllowFrom(
+  cfg: ExtendedOpenClawConfig,
+  _accountId?: string,
+): string[] {
+  const migptCfg = cfg.channels?.migpt;
+  const allowFrom = migptCfg?.allowFrom ?? [];
+  return allowFrom.map((entry) => String(entry).trim()).filter(Boolean);
+}
+
+/**
+ * 格式化允许的设备列表
+ */
+export function formatMiAllowFrom(allowFrom: Array<string | number>): string[] {
+  return allowFrom
+    .map((entry) => String(entry).trim())
+    .filter(Boolean)
+    .map((entry) => entry.toLowerCase());
+}

package/src/message.ts

@@ -0,0 +1,186 @@
+import { randomUUID } from 'node:crypto';
+import { MiService } from './service.js';
+import { firstOf, lastOf } from './utils/parse.js';
+
+export interface IMessage {
+  id: string;
+  sender: 'user';
+  text: string;
+  timestamp: number;
+  deviceId: string;
+}
+
+class _MiMessage {
+  private _lastQueryMsg: Record<string, IMessage | undefined> = {};
+  private _tempQueryMsgs: Record<string, IMessage[]> = {};
+
+  /**
+   * 获取下一条消息
+   * @param deviceId 设备 ID
+   */
+  async fetchNextMessage(deviceId: string): Promise<IMessage | undefined> {
+    if (!this._lastQueryMsg[deviceId]) {
+      return this._fetchFirstMessage(deviceId);
+    }
+    return this._fetchNextMessage(deviceId);
+  }
+
+  /**
+   * 拉取第一条消息（初始化）
+   */
+  private async _fetchFirstMessage(deviceId: string) {
+    const msgs = await this._fetchHistoryMsgs(deviceId, {
+      limit: 1,
+      filterAnswer: false,
+    });
+    this._lastQueryMsg[deviceId] = msgs[0];
+    return undefined;
+  }
+
+  /**
+   * 拉取下一条消息
+   */
+  private async _fetchNextMessage(deviceId: string): Promise<IMessage | undefined> {
+    if (this._tempQueryMsgs[deviceId] && this._tempQueryMsgs[deviceId].length > 0) {
+      // 当前有暂存的新消息（从新到旧），依次处理之
+      return this._fetchNextTempMessage(deviceId);
+    }
+    // 拉取最新的 2 条 msg（用于和上一条消息比对是否连续）
+    const nextMsg = await this._fetchNext2Messages(deviceId);
+    if (nextMsg !== 'continue') {
+      return nextMsg;
+    }
+    // 继续向上拉取其他新消息
+    return this._fetchNextRemainingMessages(deviceId);
+  }
+
+  /**
+   * 拉取最新的 2 条消息，用于和上一条消息比对是否连续
+   */
+  private async _fetchNext2Messages(deviceId: string): Promise<IMessage | 'continue' | undefined> {
+    const msgs = await this._fetchHistoryMsgs(deviceId, { limit: 2 });
+    if (msgs.length < 1 || firstOf(msgs)!.timestamp <= this._lastQueryMsg[deviceId]!.timestamp) {
+      // 没有拉到新消息
+      return;
+    }
+    if (
+      firstOf(msgs)!.timestamp > this._lastQueryMsg[deviceId]!.timestamp &&
+      (msgs.length === 1 || lastOf(msgs)!.timestamp <= this._lastQueryMsg[deviceId]!.timestamp)
+    ) {
+      // 刚好收到一条新消息
+      this._lastQueryMsg[deviceId] = firstOf(msgs);
+      return this._lastQueryMsg[deviceId];
+    }
+    // 还有其他新消息，暂存当前的新消息
+    for (const msg of msgs) {
+      if (msg.timestamp > this._lastQueryMsg[deviceId]!.timestamp) {
+        if (!this._tempQueryMsgs[deviceId]) {
+          this._tempQueryMsgs[deviceId] = [];
+        }
+        this._tempQueryMsgs[deviceId].push(msg);
+      }
+    }
+    return 'continue';
+  }
+
+  /**
+   * 继续向上拉取其他新消息
+   */
+  private async _fetchNextRemainingMessages(deviceId: string, options?: {
+    maxPage?: number;
+    pageSize?: number;
+  }) {
+    let currentPage = 0;
+    const { maxPage = 3, pageSize = 10 } = options ?? {};
+    while (true) {
+      currentPage++;
+      if (currentPage > maxPage) {
+        // 拉取新消息超长，取消拉取
+        return this._fetchNextTempMessage(deviceId);
+      }
+      const nextTimestamp = lastOf(this._tempQueryMsgs[deviceId]!)!.timestamp;
+      const msgs = await this._fetchHistoryMsgs(deviceId, {
+        limit: pageSize,
+        timestamp: nextTimestamp,
+      });
+      for (const msg of msgs) {
+        if (msg.timestamp >= nextTimestamp) {
+          // 忽略上一页的消息
+        } else if (msg.timestamp > this._lastQueryMsg[deviceId]!.timestamp) {
+          // 继续添加新消息
+          this._tempQueryMsgs[deviceId].push(msg);
+        } else {
+          // 拉取到历史消息处
+          return this._fetchNextTempMessage(deviceId);
+        }
+      }
+    }
+  }
+
+  /**
+   * 读取暂存的消息
+   */
+  private _fetchNextTempMessage(deviceId: string): IMessage | undefined {
+    const nextMsg = this._tempQueryMsgs[deviceId].pop();
+    if (nextMsg) {
+      this._lastQueryMsg[deviceId] = nextMsg;
+    }
+    return nextMsg;
+  }
+
+  /**
+   * 拉取历史消息
+   */
+  private async _fetchHistoryMsgs(
+    deviceId: string,
+    options?: {
+      limit?: number;
+      timestamp?: number;
+      filterAnswer?: boolean;
+    },
+  ): Promise<IMessage[]> {
+    const filterAnswer = options?.filterAnswer ?? true;
+    const conversation = await MiService.MiNA?.getConversations({
+      limit: options?.limit,
+      timestamp: options?.timestamp,
+    });
+    let records = conversation?.records ?? [];
+    
+    if (filterAnswer) {
+      // 过滤有小爱回答的消息
+      records = records.filter(
+        (e) =>
+          ['TTS', 'LLM'].includes(e.answers[0]?.type ?? '') && // 过滤 TTS 和 LLM 消息
+          e.answers.length === 1, // 播放音乐时会有 TTS、Audio 两个 Answer
+      );
+    }
+    
+    return records.map((e) => {
+      return {
+        id: randomUUID(),
+        sender: 'user',
+        text: e.query,
+        timestamp: e.time,
+        deviceId,
+      };
+    });
+  }
+
+  /**
+   * 清除设备消息缓存
+   */
+  clear(deviceId: string) {
+    delete this._lastQueryMsg[deviceId];
+    delete this._tempQueryMsgs[deviceId];
+  }
+
+  /**
+   * 清除所有缓存
+   */
+  clearAll() {
+    this._lastQueryMsg = {};
+    this._tempQueryMsgs = {};
+  }
+}
+
+export const MiMessage = new _MiMessage();

package/src/mi/account.ts

@@ -0,0 +1,184 @@
+import { encodeQuery, parseAuthPass } from '../utils/codec.js';
+import { md5, sha1 } from '../utils/hash.js';
+import { Http } from '../utils/http.js';
+import { MiNA } from './mina.js';
+import { MIoT } from './miot.js';
+import type { MiAccount } from './typing.js';
+
+const kLoginAPI = 'https://account.xiaomi.com/pass';
+
+export async function getAccount(_account: MiAccount): Promise<MiAccount | undefined> {
+  let account = _account;
+  
+  // 打印使用的认证方式
+  console.log('🔐 认证信息:', {
+    userId: account.userId,
+    hasPassToken: !!account.passToken,
+    hasPassword: !!account.password,
+    hasServiceToken: !!account.serviceToken,
+    authMode: account.password ? 'password' : (account.passToken ? 'passToken' : 'unknown'),
+  });
+  
+  // 如果已经提供了 passToken 和 serviceToken，尝试直接使用缓存的登录态
+  if (account.passToken && account.serviceToken && account.pass?.ssecurity) {
+    console.log('🔄 尝试使用缓存的登录态 (passToken + serviceToken + ssecurity)...');
+    account.pass = {
+      code: 0,
+      passToken: account.passToken,
+      ssecurity: account.pass.ssecurity,
+      nonce: account.pass.nonce || '',
+    };
+    // 尝试直接获取设备列表，如果失败再重新登录
+    // 根据 sid 选择调用对应的服务
+    let devices: any;
+    if (account.sid === 'micoapi') {
+      devices = await MiNA.getDevice(account as any);
+    } else if (account.sid === 'xiaomiio') {
+      devices = await MIoT.getDevice(account as any);
+    } else {
+      devices = account;
+    }
+    if (devices.device) {
+      console.log('✅ 使用缓存的登录态成功');
+      return devices;
+    }
+    // 缓存失效，继续登录流程
+    console.log('⚠️ 缓存的登录态已失效，使用密码重新登录...');
+  }
+  
+  // 优先使用密码登录（如果有密码）
+  if (account.password) {
+    console.log('🔑 使用密码登录（passToken 作为 Cookie 辅助）...');
+  } else if (account.passToken) {
+    console.log('⚠️ 仅有 passToken 无法直接登录，passToken 需要配合密码使用');
+  }
+  
+  let res = await Http.get(
+    `${kLoginAPI}/serviceLogin`,
+    { sid: account.sid, _json: true, _locale: 'zh_CN' },
+    { cookies: _getLoginCookies(account) },
+  );
+  if (res.isError) {
+    console.error('❌ 登录失败', res);
+    return undefined;
+  }
+  let pass = parseAuthPass(res);
+  console.log('📝 serviceLogin 响应:', { code: pass.code, description: pass.description,res: res });
+  
+  if (pass.code !== 0) {
+    // 登录态失效，重新登录
+    console.log('📝 登录态失效，尝试重新认证...');
+    
+    if (!account.password) {
+      console.error('❌ 缺少密码，无法重新登录。请配置 password 字段。');
+      return undefined;
+    }
+    
+    const data = {
+      _json: 'true',
+      qs: pass.qs,
+      sid: account.sid,
+      _sign: pass._sign,
+      callback: pass.callback,
+      user: account.userId,
+      hash: md5(account.password).toUpperCase(),
+    };
+    res = await Http.post(`${kLoginAPI}/serviceLoginAuth2`, encodeQuery(data), {
+      cookies: _getLoginCookies(account),
+    });
+    if (res.isError) {
+      console.error('❌ OAuth2 登录失败', res);
+      return undefined;
+    }
+    console.log('返回结果：', res.data);
+    pass = parseAuthPass(res);
+    console.log('📝 serviceLoginAuth2 响应:', {
+      code: pass.code,
+      hasPassToken: !!pass.passToken,
+      hasSsecurity: !!pass.ssecurity,
+      description: pass.description,
+    });
+  }
+  if (pass.location?.includes('identity/authStart')) {
+    console.error('❌ 本次登录需要验证码，请检查 passToken 是否正确');
+    console.log('💡 当前使用的 passToken:', account.passToken?.slice(0, 20) + '...');
+    return undefined;
+  }
+  if (!pass.location || !pass.nonce || !pass.ssecurity) {
+    console.error('❌ 登录失败，请检查你的账号密码是否正确');
+    console.log('📋 返回数据:', {
+      hasLocation: !!pass.location,
+      hasNonce: !!pass.nonce,
+      hasSsecurity: !!pass.ssecurity,
+      hasPassToken: !!pass.passToken,
+      code: pass.code,
+      description: pass.description,
+    });
+    return undefined;
+  }
+  console.log('✅ 登录成功，获取 serviceToken...');
+  // 刷新登录态
+  const serviceToken = await _getServiceToken(pass);
+  if (!serviceToken) {
+    return undefined;
+  }
+  console.log('✅ 获取 serviceToken 成功',{account:account,serviceToken:serviceToken});
+  account = { ...account, pass: pass as any, serviceToken };
+  console.log('📱 正在获取设备信息... account.did =', account.did);
+  console.log('📱 使用的 deviceId:', account.deviceId);
+  
+  // 根据 sid 选择调用对应的服务
+  if (account.sid === 'micoapi') {
+    account = await MiNA.getDevice(account as any);
+    console.log('📱 MiNA.getDevice 结果：account.device =', account?.device);
+  } else if (account.sid === 'xiaomiio') {
+    account = await MIoT.getDevice(account as any);
+    console.log('📱 MIoT.getDevice 结果：account.device =', account?.device);
+  }
+  
+  if (account.did && !account.device) {
+    console.error(`❌ 找不到设备：${account.did}`);
+    console.log(
+      '🐛 请检查你的 did 与米家中的设备名称是否一致。注意错别字、空格和大小写，比如：音响 👉 音箱',
+    );
+    console.log(
+      '💡 建议打开 debug 选项，查看目标设备的真实 name、miotDID 或 mac 地址，更新 did 参数',
+    );
+    return undefined;
+  }
+  console.log('✅ 设备信息获取成功:', (account.device as any)?.name || (account.device as any)?.alias);
+  return account;
+}
+
+function _getLoginCookies(account: MiAccount): Record<string, string | undefined> {
+  return {
+    userId: account.userId,
+    deviceId: account.deviceId,
+    passToken: account.pass?.passToken,
+    sdkVersion: '3.9',
+  };
+}
+
+async function _getServiceToken(pass: any): Promise<string | undefined> {
+  const { location, nonce, ssecurity } = pass ?? {};
+  if (!location || !nonce || !ssecurity) {
+    console.error('❌ 无法获取 serviceToken，缺少必要参数');
+    return undefined;
+  }
+  const nsec = `nonce=${nonce}&${ssecurity}`;
+  const clientSign = sha1(nsec);
+  const url = location + '&clientSign=' + encodeURIComponent(clientSign);
+  
+  const res = await Http.get(url, {}, { rawResponse: true });
+  
+  // 从 set-cookie 中提取 serviceToken
+  const cookies = res.headers?.['set-cookie'] ?? [];
+  for (const cookie of cookies) {
+    const match = cookie.match(/serviceToken=([^;]+)/);
+    if (match) {
+      return match[1];
+    }
+  }
+  console.error('❌ 获取 Mi Service Token 失败');
+  return undefined;
+}