@z-qinghui/migpt-claw 1.0.0

package/src/mi/common.ts

@@ -0,0 +1,105 @@
+import { readJSON, writeJSON } from '../utils/io.js';
+import { getAccount } from './account.js';
+import { MiNA } from './mina.js';
+import { MIoT } from './miot.js';
+import { Debugger } from '../utils/debug.js';
+import type { MiAccount, MiPass } from './typing.js';
+
+interface Store {
+  miot?: MiAccount;
+  mina?: MiAccount;
+}
+
+const kConfigFile = '.mi.json';
+
+export function updateMiAccount(account: MiAccount): (updated: MiAccount) => void {
+  return (updated: MiAccount) => {
+    if (updated.serviceToken) {
+      account.serviceToken = updated.serviceToken;
+    }
+    if (updated.deviceId) {
+      account.deviceId = updated.deviceId;
+    }
+    if (updated.pass?.ssecurity) {
+      if (!account.pass) account.pass = { code: 0 } as MiPass;
+      (account.pass as MiPass).ssecurity = updated.pass.ssecurity;
+    }
+    if (updated.pass?.nonce) {
+      if (!account.pass) account.pass = { code: 0 } as MiPass;
+      (account.pass as MiPass).nonce = updated.pass.nonce;
+    }
+    if (updated.pass?.passToken) {
+      if (!account.pass) account.pass = { code: 0 } as MiPass;
+      (account.pass as MiPass).passToken = updated.pass.passToken;
+    }
+  };
+}
+
+export async function getMiService(config: {
+  service: 'miot' | 'mina';
+  userId?: string;
+  password?: string;
+  passToken?: string;
+  did?: string;
+  relogin?: boolean;
+}): Promise<MiNA | MIoT | undefined> {
+  const { service, relogin, ...rest } = config;
+  const overrides: any = relogin ? {} : rest;
+
+  // 如果有 passToken，同时设置 pass 对象
+  if (overrides.passToken) {
+    overrides.pass = {
+      ...overrides.pass,
+      passToken: overrides.passToken,
+    };
+  }
+
+  const store: Store = (await readJSON(kConfigFile)) ?? {};
+  
+  // 从缓存中获取 deviceId，如果没有则生成新的（16 位随机大写字母）
+  let deviceId = store[service]?.deviceId;
+  if (!deviceId) {
+    deviceId = Array(16).fill(0).map(() => 
+      'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'[Math.floor(Math.random() * 36)]
+    ).join('');
+  }
+  
+  // 构建账户信息，优先使用传入的参数，其次使用缓存
+  let account = {
+    deviceId,
+    ...store[service],
+    ...overrides,
+    sid: service === 'miot' ? 'xiaomiio' : 'micoapi',
+  } as MiAccount;
+  
+  // 从缓存中补充 pass 信息（如果有）
+  const cached = store[service];
+  if (cached?.pass) {
+    account.pass = {
+      ...account.pass,
+      ...cached.pass,
+    };
+  }
+  
+  // 检查是否有足够的凭证
+  // passToken 是可选的辅助凭证，password 是必需的登录凭证
+  const hasPassword = !!account.userId && !!account.password;
+  
+  if (!hasPassword) {
+    console.error('❌ 缺少必需的登录凭证：需要 userId 和 password');
+    console.log('💡 passToken 是可选的辅助凭证，不能完全替代密码');
+    console.log('💡 配置示例：{ userId: "123", password: "xxx", passToken: "yyy" }');
+    return;
+  }
+
+  const result = await getAccount(account);
+  if (Debugger.debug) {
+    console.log('💡 getAccount 结果：',{result:result});
+  }
+  if (!result?.serviceToken || !result.pass?.ssecurity) {
+    return undefined;
+  }
+  store[service] = result;
+  await writeJSON(kConfigFile, store);
+  return service === 'miot' ? new MIoT(result as any) : new MiNA(result as any);
+}

package/src/mi/index.ts

@@ -0,0 +1,4 @@
+export { MiNA } from './mina.js';
+export { MIoT } from './miot.js';
+export { getMiService } from './common.js';
+export * from './typing.js';

package/src/mi/mina.ts

@@ -0,0 +1,261 @@
+import { encodeQuery } from '../utils/codec.js';
+import { Debugger } from '../utils/debug.js';
+import { jsonEncode,jsonDecode } from '../utils/parse.js';
+import { uuid } from '../utils/hash.js';
+import { Http } from '../utils/http.js';
+import { updateMiAccount } from './common.js';
+import type { MiAccount, MiConversations, MiNADevice } from './typing.js';
+
+type MiNAAccount = MiAccount & { device: MiNADevice };
+
+export class MiNA {
+  account: MiNAAccount;
+
+  constructor(account: MiNAAccount) {
+    this.account = account as any;
+  }
+
+  static async getDevice(account: MiNAAccount): Promise<MiNAAccount> {
+    if (account.sid !== 'micoapi') {
+      return account;
+    }
+    const devices = await MiNA.__callMiNA(account, 'GET', '/admin/v2/device_list');
+    if (Debugger.debug) {
+      console.log('🐛 MiNA 设备列表：', jsonEncode(devices, { prettier: true }));
+    }
+
+    console.log('🔍 查找设备 account.did:', account.did);
+    
+    const device = (devices ?? []).find((e: any) => {
+      const matches = [e.deviceID, e.miotDID, e.name, e.alias, e.mac].includes(account.did);
+      console.log(`🔍 检查设备 ${e.name} (miotDID: ${e.miotDID}):`, {
+        deviceID: e.deviceID,
+        miotDID: e.miotDID,
+        name: e.name,
+        alias: e.alias,
+        mac: e.mac,
+        matches,
+      });
+      return matches;
+    });
+    
+    if (device) {
+      account.device = { ...device, deviceId: device.deviceID };
+      console.log('✅ 找到设备:', device.name);
+    } else {
+      console.error('❌ 未找到匹配的设备，account.did:', account.did);
+    }
+    return account;
+  }
+
+  private static async __callMiNA(
+    account: MiNAAccount,
+    method: 'GET' | 'POST',
+    path: string,
+    _data?: any,
+  ): Promise<any> {
+    const data = {
+      ..._data,
+      requestId: uuid(),
+      timestamp: Math.floor(Date.now() / 1000),
+    };
+    const url = `https://api2.mina.mi.com${path}`;
+    const config = {
+      account,
+      setAccount: updateMiAccount(account),
+      headers: { 'User-Agent': 'MICO/AndroidApp/@SHIP.TO.2A2FE0D7@/2.4.40' },
+      cookies: {
+        userId: account.userId,
+        serviceToken: account.serviceToken,
+        sn: account.device?.serialNumber,
+        hardware: account.device?.hardware,
+        deviceId: account.device?.deviceId,
+        deviceSNProfile: account.device?.deviceSNProfile,
+      },
+    };
+    let res: any;
+    if (method === 'GET') {
+      res = await Http.get(url, data, config);
+    } else {
+      res = await Http.post(url, encodeQuery(data), config);
+    }
+    if (res.code !== 0) {
+      if (Debugger.debug) {
+        console.error('❌ _callMiNA failed', res);
+      }
+      return undefined;
+    }
+    return res.data;
+  }
+
+  private async _callMiNA(method: 'GET' | 'POST', path: string, data?: any): Promise<any> {
+    return MiNA.__callMiNA(this.account, method, path, data);
+  }
+
+  /**
+   * 调用小爱音箱上的 ubus 服务
+   */
+  callUbus(scope: string, command: string, _message?: any) {
+    const message = jsonEncode(_message ?? {});
+    return this._callMiNA('POST', '/remote/ubus', {
+      deviceId: this.account.device?.deviceId,
+      path: scope,
+      method: command,
+      message,
+    });
+  }
+
+  /**
+   * 获取设备列表
+   */
+  getDevices() {
+    return this._callMiNA('GET', '/admin/v2/device_list');
+  }
+
+  /**
+   * 获取设备播放状态
+   */
+  async getStatus(): Promise<
+    | {
+        volume: number;
+        status: 'idle' | 'playing' | 'paused' | 'stopped' | 'unknown';
+        media_type?: number;
+        loop_type?: number;
+      }
+    | undefined
+  > {
+    const data = await this.callUbus('mediaplayer', 'player_get_play_status');
+    const res = jsonDecode(data?.info);
+    if (!data || data.code !== 0 || !res) {
+      return;
+    }
+    const map = { 0: 'idle', 1: 'playing', 2: 'paused', 3: 'stopped' } as any;
+    return {
+      ...res,
+      status: map[res.status] ?? 'unknown',
+      volume: res.volume,
+    };
+  }
+
+  /**
+   * 获取音量
+   */
+  async getVolume() {
+    const data = await this.getStatus();
+    return data?.volume;
+  }
+
+  /**
+   * 设置音量
+   */
+  async setVolume(_volume: number) {
+    const volume = Math.round(clamp(_volume, 6, 100));
+    const res = await this.callUbus('mediaplayer', 'player_set_volume', {
+      volume,
+    });
+    return res?.code === 0;
+  }
+
+  /**
+   * 播放
+   */
+  async play({ text, url, save = 0 }: { text?: string; url?: string; save?: 0 | 1 } = {}) {
+    let res: any;
+    if (url) {
+      console.log(`🔊 MiNA.play URL: ${url}`);
+      res = await this.callUbus('mediaplayer', 'player_play_url', {
+        url,
+        type: 1,
+      });
+      console.log(`🔊 MiNA.play URL result:`, JSON.stringify(res));
+    } else if (text) {
+      console.log(`🔊 MiNA.play text: ${text.slice(0, 50)}...`);
+      res = await this.callUbus('mibrain', 'text_to_speech', {
+        text,
+        save,
+      });
+      console.log(`🔊 MiNA.play text result:`, JSON.stringify(res));
+    } else {
+      res = await this.callUbus('mediaplayer', 'player_play_operation', {
+        action: 'play',
+      });
+    }
+    return res?.code === 0;
+  }
+
+  /**
+   * 暂停播放
+   */
+  async pause() {
+    const res = await this.callUbus('mediaplayer', 'player_play_operation', {
+      action: 'pause',
+    });
+    return res?.code === 0;
+  }
+
+  /**
+   * 播放或暂停
+   */
+  async playOrPause() {
+    const res = await this.callUbus('mediaplayer', 'player_play_operation', {
+      action: 'toggle',
+    });
+    return res?.code === 0;
+  }
+
+  /**
+   * 停止播放
+   */
+  async stop() {
+    const res = await this.callUbus('mediaplayer', 'player_play_operation', {
+      action: 'stop',
+    });
+    return res?.code === 0;
+  }
+
+  /**
+   * 获取对话消息列表
+   */
+  async getConversations(options?: {
+    limit?: number;
+    timestamp?: number;
+  }): Promise<MiConversations | undefined> {
+    const { limit = 10, timestamp } = options ?? {};
+    const res = await Http.get(
+      'https://userprofile.mina.mi.com/device_profile/v2/conversation',
+      {
+        limit,
+        timestamp,
+        requestId: uuid(),
+        source: 'dialogu',
+        hardware: this.account.device?.hardware,
+      },
+      {
+        account: this.account,
+        setAccount: updateMiAccount(this.account),
+        headers: {
+          'User-Agent':
+            'Mozilla/5.0 (Linux; Android 10; 000; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/119.0.6045.193 Mobile Safari/537.36 /XiaoMi/HybridView/ micoSoundboxApp/i appVersion/A_2.4.40',
+          Referer: 'https://userprofile.mina.mi.com/dialogue-note/index.html',
+        },
+        cookies: {
+          userId: this.account.userId,
+          serviceToken: this.account.serviceToken,
+          deviceId: this.account.device?.deviceId,
+        },
+      },
+    );
+    if (res.code !== 0) {
+      if (Debugger.debug) {
+        console.error('❌ getConversations failed', res);
+      }
+      return undefined;
+    }
+    return jsonDecode(res.data);
+  }
+}
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max);
+}
+

package/src/mi/miot.ts

@@ -0,0 +1,193 @@
+import { jsonEncode } from '../utils/parse.js';
+import { decodeMIoT, encodeFormData, encodeMIoT } from '../utils/codec.js';
+import { Http } from '../utils/http.js';
+import { updateMiAccount } from './common.js';
+import { Debugger } from '../utils/debug.js';
+import type { MIoTDevice, MiAccount } from './typing.js';
+
+type MIoTAccount = MiAccount & { device: MIoTDevice };
+
+export class MIoT {
+  account: MIoTAccount;
+
+  constructor(account: MIoTAccount) {
+    this.account = account;
+  }
+
+  static async getDevice(account: MIoTAccount): Promise<MIoTAccount> {
+    if (account.sid !== 'xiaomiio') {
+      return account;
+    }
+    const devices = await MIoT.__callMIoT(account, 'POST', '/home/device_list', {
+      getVirtualModel: false,
+      getHuamiDevices: 0,
+    });
+    if (Debugger.debug) {
+      console.log('🐛 MIoT 设备列表：', jsonEncode(devices, { prettier: true }));
+    }
+    const device = (devices?.list ?? []).find((e: any) =>
+      [e.did, e.name, e.mac].includes(account.did),
+    );
+    if (device) {
+      account.device = device;
+    }
+    return account;
+  }
+
+  private static async __callMIoT(
+    account: MIoTAccount,
+    method: 'GET' | 'POST',
+    path: string,
+    _data?: any,
+  ) {
+    const url = `https://api.io.mi.com/app${path}`;
+    const config = {
+      account,
+      setAccount: updateMiAccount(account),
+      rawResponse: true,
+      validateStatus: () => true,
+      headers: {
+        'User-Agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1',
+        'x-xiaomi-protocal-flag-cli': 'PROTOCAL-HTTP2',
+      },
+      cookies: {
+        userId: account.userId,
+        serviceToken: account.serviceToken,
+        PassportDeviceId: account.deviceId,
+      },
+    };
+
+    const data = encodeMIoT(path, _data, account.pass!.ssecurity!);
+    if (Debugger.debug) {
+      console.log('MIoT 请求:', {
+        url,
+        method,
+        cookies: config.cookies,
+        body: data,
+      });
+    }
+
+    let res: any;
+    if (method === 'GET') {
+      res = await Http.get(url, data, config);
+    } else {
+      // POST body 使用 application/x-www-form-urlencoded 格式
+      const formData = encodeFormData(data);
+      if (Debugger.debug) {
+        console.log('POST body:', formData);
+      }
+      res = await Http.post(url, formData, {
+        ...config,
+        headers: {
+          ...config.headers,
+          'Content-Type': 'application/x-www-form-urlencoded',
+        },
+      });
+    }
+    
+    // 检查错误
+    if (res.status === 401) {
+      console.error('❌ 401 错误响应:', res.data);
+      return undefined;
+    }
+    
+    // MiService 返回的是明文 JSON，直接解析
+    if (res.data && typeof res.data === 'object' && res.data.code === 0) {
+      return res.data.result;
+    }
+    
+    // 如果是加密字符串，尝试解密
+    if (typeof res.data === 'string') {
+      try {
+        res = await decodeMIoT(
+          account.pass!.ssecurity!,
+          data._nonce,
+          res.data,
+          res.headers['miot-content-encoding'] === 'GZIP',
+        );
+        return res?.result;
+      } catch (e) {
+        console.error('❌ 解密失败:', e);
+        return undefined;
+      }
+    }
+    
+    console.error('❌ 未知响应格式:', res);
+    return undefined;
+  }
+
+  private async _callMIoT(method: 'GET' | 'POST', path: string, data?: any) {
+    return MIoT.__callMIoT(this.account, method, path, data);
+  }
+
+  /**
+   * 获取 MIoT 设备列表
+   */
+  async getDevices(getVirtualModel = false, getHuamiDevices = 0) {
+    const res = await this._callMIoT('POST', '/home/device_list', {
+      getVirtualModel: getVirtualModel,
+      getHuamiDevices: getHuamiDevices,
+    });
+    return res?.list;
+  }
+
+  /**
+   * 获取 MIoT 设备属性值
+   */
+  async getProperty(scope: number, property: number) {
+    const res = await this._callMIoTSpec('prop/get', [
+      {
+        did: this.account.device.did,
+        siid: scope,
+        piid: property,
+      },
+    ]);
+    return (res ?? [])?.[0]?.value;
+  }
+
+  /**
+   * 设置 MIoT 设备属性值
+   */
+  async setProperty(scope: number, property: number, value: any) {
+    const res = await this._callMIoTSpec('prop/set', [
+      {
+        did: this.account.device.did,
+        siid: scope,
+        piid: property,
+        value: value,
+      },
+    ]);
+    return (res ?? [])?.[0]?.code === 0;
+  }
+
+  /**
+   * 调用 MIoT 设备能力指令
+   */
+  async doAction(scope: number, action: number, args: any = []) {
+    const res = await this._callMIoTSpec('action', {
+      did: this.account.device.did,
+      siid: scope,
+      aiid: action,
+      in: Array.isArray(args) ? args : [args],
+    });
+    return res?.code === 0;
+  }
+
+  /**
+   * 调用 MIoT 设备 RPC 指令
+   */
+  rpc(method: string, params: any, id = 1) {
+    return this._callMIoT('POST', `/home/rpc/${this.account.device.did}`, {
+      id,
+      method,
+      params,
+    });
+  }
+
+  private _callMIoTSpec(command: string, params: any, datasource = 2) {
+    return this._callMIoT('POST', `/miotspec/${command}`, {
+      params,
+      datasource,
+    });
+  }
+}

package/src/mi/typing.ts

@@ -0,0 +1,93 @@
+/**
+ * 小米账号类型定义
+ */
+export interface MiAccount {
+  /** 小米 ID（数字） */
+  userId?: string;
+  /** 密码 */
+  password?: string;
+  /** 登录凭证 */
+  passToken?: string;
+  /** 服务类型 */
+  sid: 'micoapi' | 'xiaomiio';
+  /** 设备 ID */
+  deviceId?: string;
+  /** 服务 Token */
+  serviceToken?: string;
+  /** 登录态 */
+  pass?: MiPass;
+  /** 设备标识（名称/ID/MAC） */
+  did?: string;
+  /** 设备信息 */
+  device?: MiNADevice | MIoTDevice;
+}
+
+/**
+ * 登录态
+ */
+export interface MiPass {
+  code: number;
+  qs?: string;
+  _sign?: string;
+  callback?: string;
+  location?: string;
+  nonce?: string;
+  ssecurity?: string;
+  passToken?: string;
+  notificationUrl?: string;
+  cUserId?: string;
+}
+
+/**
+ * MiNA 设备
+ */
+export interface MiNADevice {
+  deviceID: string;
+  deviceId?: string;
+  miotDID: string;
+  name: string;
+  alias: string;
+  mac: string;
+  hardware: string;
+  serialNumber: string;
+  rom: string;
+  deviceSNProfile?: string;
+  extra?: {
+    fw_version: string;
+  };
+}
+
+/**
+ * MIoT 设备
+ */
+export interface MIoTDevice {
+  did: string;
+  name: string;
+  mac: string;
+  model: string;
+  extra?: {
+    fw_version: string;
+  };
+}
+
+/**
+ * 对话消息
+ */
+export interface MiConversation {
+  query: string;
+  time: number;
+  answers: Array<{
+    type: string;
+    tts?: string;
+    url?: string;
+  }>;
+}
+
+/**
+ * 对话列表
+ */
+export interface MiConversations {
+  records: MiConversation[];
+  hasMore: boolean;
+  cursor?: number;
+}