迁移手册：导入 → 双跑 → 切换

import { AppClient } from '@ni-paas-im/server-sdk';

const app = new AppClient({ appKey: process.env.IM_APP_KEY, appSecret: process.env.IM_APP_SECRET, baseUrl: 'http://127.0.0.1:8080' });

// 用户：分批导入，单批 ≤100（与 batch.get 上限一致，便于逐批校验）
for (const batch of chunk(legacyUsers, 100)) {
  for (const user of batch) {
    await app.registerUser({ userId: user.newId, name: user.nickname, avatarUrl: user.avatar });
  }
}
const check = await app.batchGetUsers({ userIds: legacyUsers.slice(0, 100).map((u) => u.newId) });
if (check.missing.length) throw new Error(`missing users: ${check.missing.join(',')}`);

// 群：单次 ≤50，逐条幂等；失败明细保留重试
for (const batch of chunk(legacyGroups, 50)) {
  const result = await app.openApi('group.import', {
    groups: batch.map((g) => ({
      groupId: g.newGroupId,
      name: g.name,
      owner: g.ownerNewId,
      members: g.memberIds,
      groupType: g.memberCount > 3000 ? 'super' : 'normal',
    })),
  });
  if (result.failed?.length) console.warn('group import failed', result.failed);
}

// 好友：直接建立双向关系（幂等）
for (const rel of legacyFriends) {
  await app.openApi('friend.add', { userId: rel.a, friendId: rel.b });
}