weaver-work-cli 0.1.5 → 0.1.7

package/dist/shortcuts/{yimiaoban → im}/operations/group-write.js

@@ -1,6 +1,6 @@
-import { ymbValidationError } from '../errors.js';
+import { imValidationError } from '../errors.js';
 import { schemaOf, WRITE, } from './types.js';
-import { assertImOk, compact, splitIds, str, toUint } from './shared.js';
+import { assertImOk, compact, splitIds, str, toUint, unwrapInner } from './shared.js';
 import { makeWritePair } from './write-util.js';
 /** 解析 uid 列表为 {cid,uid} 成员，支持 failed 移除。 */
 async function resolveMembers(args, env) {
@@ -50,23 +50,23 @@ async function defaultGroupName(members, nameOf, selfUid, env) {
 }
 // ── 建群 ──
 const groupCreatePair = makeWritePair({
-    action: 'yimiaoban.group.create',
+    action: 'im.group.create',
     async plan(args, env) {
         const rawUsers = Array.isArray(args.users) ? args.users.map((x) => String(x)) : splitIds(args.users, 'users');
         const names = Array.isArray(args.names) ? args.names.map((x) => String(x)) : [];
         if (names.length && names.length !== rawUsers.length) {
-            throw ymbValidationError('names_mismatch', 'names 数量必须与 users 一致（顺序一一对应）');
+            throw imValidationError('names_mismatch', 'names 数量必须与 users 一致（顺序一一对应）');
         }
         const { users, failed, names: resolvedNames } = await resolveMembers(args, env);
         if (failed.length && args.removeFailed !== true) {
-            throw ymbValidationError('members_resolve_failed', `以下成员信息获取失败（cid/uid 缺失或为 0）：${failed.map((f) => f.name || f.uid).join('、')}；确认移除请传 removeFailed:true`, { details: failed });
+            throw imValidationError('members_resolve_failed', `以下成员信息获取失败（cid/uid 缺失或为 0）：${failed.map((f) => f.name || f.uid).join('、')}；确认移除请传 removeFailed:true`, { details: failed });
         }
         if (users.length === 0)
-            throw ymbValidationError('members_empty', '没有可入群的成员');
+            throw imValidationError('members_empty', '没有可入群的成员');
         // 🔴 群成员必须包含操作者自己（服务端依据 eteamsid 把操作者设为群主）
         const selfUid = str((await env.host.getSession()).userId);
         if (selfUid && !users.some((u) => u.uid === selfUid)) {
-            throw ymbValidationError('self_not_included', `不允许创建不包含自己的群聊：users 必须包含操作者自己（uid=${selfUid}）`);
+            throw imValidationError('self_not_included', `不允许创建不包含自己的群聊：users 必须包含操作者自己（uid=${selfUid}）`);
         }
         // 默认群名：调用方 names（与 users 顺序对应）优先，其次 hrm 解析姓名，最后回退 uid
         const providedNames = {};
@@ -86,7 +86,7 @@ const groupCreatePair = makeWritePair({
                 return !uid || uid === '0' || !cid || cid === '0';
             });
             if (adminFailed.length) {
-                throw ymbValidationError('admins_resolve_failed', `管理员信息获取失败（cid/uid 缺失或为 0）：${adminFailed.map((uid) => adminMap[uid]?.name || uid).join('、')}；请确认后重试（不可静默替换操作人身份）`, { details: adminFailed });
+                throw imValidationError('admins_resolve_failed', `管理员信息获取失败（cid/uid 缺失或为 0）：${adminFailed.map((uid) => adminMap[uid]?.name || uid).join('、')}；请确认后重试（不可静默替换操作人身份）`, { details: adminFailed });
             }
             admins = adminRaw.map((uid) => ({ cid: adminMap[uid]?.cid || '', uid }));
         }
@@ -114,7 +114,7 @@ const groupCreatePair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/groupCreate',
             body,
-            operation: 'yimiaoban.group.create',
+            operation: 'im.group.create',
         });
         assertImOk(res, '创建群');
         // 群 id 可能位于 data / data.data 的 groupId / group_id / id 字段，统一扫描；同时回传服务端原始数据便于核对
@@ -128,17 +128,17 @@ const groupCreatePair = makeWritePair({
 });
 // ── 邀请入群 ──
 const groupInvitePair = makeWritePair({
-    action: 'yimiaoban.group.invite',
+    action: 'im.group.invite',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         const { users, failed } = await resolveMembers(args, env);
         if (failed.length && args.removeFailed !== true) {
-            throw ymbValidationError('members_resolve_failed', `以下成员解析失败：${failed.map((f) => f.name || f.uid).join('、')}；确认移除请传 removeFailed:true`);
+            throw imValidationError('members_resolve_failed', `以下成员解析失败：${failed.map((f) => f.name || f.uid).join('、')}；确认移除请传 removeFailed:true`);
         }
         if (users.length === 0)
-            throw ymbValidationError('members_empty', '没有可邀请的成员');
+            throw imValidationError('members_empty', '没有可邀请的成员');
         return {
             summary: { action: '邀请入群', groupId, inviteCount: users.length, users: users.map((u) => u.uid), removeFailed: args.removeFailed === true ? failed.map((f) => f.uid) : [] },
             snapshot: { groupId, users },
@@ -150,7 +150,7 @@ const groupInvitePair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/inviteGroupUsers',
             body,
-            operation: 'yimiaoban.group.invite',
+            operation: 'im.group.invite',
         });
         assertImOk(res, '邀请入群');
         return { groupId: plan.groupId, invited: plan.users.length };
@@ -158,17 +158,17 @@ const groupInvitePair = makeWritePair({
 });
 // ── 踢出群 ──
 const groupKickPair = makeWritePair({
-    action: 'yimiaoban.group.kick',
+    action: 'im.group.kick',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         const { users, failed } = await resolveMembers(args, env);
         if (failed.length && args.removeFailed !== true) {
-            throw ymbValidationError('members_resolve_failed', `以下成员解析失败：${failed.map((f) => f.name || f.uid).join('、')}；确认移除请传 removeFailed:true`);
+            throw imValidationError('members_resolve_failed', `以下成员解析失败：${failed.map((f) => f.name || f.uid).join('、')}；确认移除请传 removeFailed:true`);
         }
         if (users.length === 0)
-            throw ymbValidationError('members_empty', '没有可移除的成员');
+            throw imValidationError('members_empty', '没有可移除的成员');
         return {
             summary: { action: '踢出群成员', groupId, kickCount: users.length, users: users.map((u) => u.uid) },
             snapshot: { groupId, users },
@@ -180,7 +180,7 @@ const groupKickPair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/kickGroupUsers',
             body,
-            operation: 'yimiaoban.group.kick',
+            operation: 'im.group.kick',
         });
         assertImOk(res, '踢出群成员');
         return { groupId: plan.groupId, kicked: plan.users.length };
@@ -188,14 +188,57 @@ const groupKickPair = makeWritePair({
 });
 // ── 退群 ──
 const groupExitPair = makeWritePair({
-    action: 'yimiaoban.group.exit',
+    action: 'im.group.exit',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
+        /**
+         * 只读回查群人数与群主：实测「群主/最后一个成员退群」后该群会变成无主空群，
+         * 之后 join / destroy 都会被服务端拒绝（1210），必须由客户端或管理员处理。
+         * 因此这两种情形要求调用方显式传 acknowledgeOrphanRisk:true 才签发 continuation。
+         */
+        let memberCount;
+        let isOwner = false;
+        try {
+            const infoRes = await env.host.request({
+                method: 'POST',
+                path: '/api/em/msg/executeIm/group/queryGroupInfo',
+                body: { trans_id: 0, type: 0, mask: 0, group_id: [groupId], flag: 0 },
+                operation: 'im.group.exit.plan.info',
+            });
+            const info = (unwrapInner(infoRes)?.datas || [])[0];
+            if (info) {
+                const raw = info.user_num ?? info.userNum;
+                memberCount = raw === undefined || raw === null ? undefined : Number(raw);
+                const hostUid = str(info.host_uid ?? info.hostUid ?? '');
+                if (hostUid) {
+                    const self = await env.host.getSelfIdentity();
+                    isOwner = hostUid === String(self.uid);
+                }
+            }
+        }
+        catch {
+            // 回查失败（如已不在群内）不阻断退群，仅在摘要里说明未能核对风险
+        }
+        const orphanRisk = isOwner || (memberCount !== undefined && memberCount <= 1);
+        if (orphanRisk && args.acknowledgeOrphanRisk !== true) {
+            throw imValidationError('owner_exit_ack_required', `退群风险确认缺失：${isOwner ? '你是该群群主' : '你是该群最后一个成员'}，退群后该群会变成无主空群，之后 join/destroy 都会被服务端拒绝（1210），只能由客户端或管理员处理。确认仍要退群请传 acknowledgeOrphanRisk:true`, { details: { groupId, isOwner, memberCount } });
+        }
         return {
-            summary: { action: '退出群聊', groupId },
-            snapshot: { groupId },
+            summary: {
+                action: '退出群聊',
+                groupId,
+                ...(memberCount === undefined ? {} : { memberCount }),
+                isOwner,
+                ...(orphanRisk
+                    ? {
+                        orphanRisk: true,
+                        riskNote: `${isOwner ? '你是群主' : '你是最后一个成员'}：退群后该群会成为无主空群，无法再从 CLI 重新进群或解散（实测 1210 没有权限），需由客户端或管理员处理。`,
+                    }
+                    : {}),
+            },
+            snapshot: { groupId, acknowledgeOrphanRisk: args.acknowledgeOrphanRisk === true },
         };
     },
     async execute(plan, env) {
@@ -203,7 +246,7 @@ const groupExitPair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/exit',
             body: { groupId: plan.groupId },
-            operation: 'yimiaoban.group.exit',
+            operation: 'im.group.exit',
         });
         assertImOk(res, '退出群聊');
         return { groupId: plan.groupId };
@@ -211,11 +254,11 @@ const groupExitPair = makeWritePair({
 });
 // ── 解散群 ──
 const groupDestroyPair = makeWritePair({
-    action: 'yimiaoban.group.destroy',
+    action: 'im.group.destroy',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         return {
             summary: { action: '解散群聊（仅群主可执行，不可恢复）', groupId },
             snapshot: { groupId },
@@ -226,7 +269,7 @@ const groupDestroyPair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/destroy',
             body: { groupId: plan.groupId },
-            operation: 'yimiaoban.group.destroy',
+            operation: 'im.group.destroy',
         });
         assertImOk(res, '解散群聊');
         return { groupId: plan.groupId };
@@ -234,19 +277,19 @@ const groupDestroyPair = makeWritePair({
 });
 // ── 申请入群 ──
 const groupJoinPair = makeWritePair({
-    action: 'yimiaoban.group.join',
+    action: 'im.group.join',
     async plan(args, env) {
         const groupId = args.groupId !== undefined && args.groupId !== '' ? str(args.groupId) : '';
         const token = args.token !== undefined && args.token !== '' ? String(args.token) : '';
         if (!groupId && !token)
-            throw ymbValidationError('target_required', 'groupId 与 token 至少其一');
+            throw imValidationError('target_required', 'groupId 与 token 至少其一');
         if (groupId && groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         if (token && token.length > 500)
-            throw ymbValidationError('token_invalid', 'token 过长');
+            throw imValidationError('token_invalid', 'token 过长');
         const mark = args.mark !== undefined && args.mark !== '' ? String(args.mark) : '';
         if (mark.length > 100)
-            throw ymbValidationError('mark_too_long', 'mark 不能超过 100 字节');
+            throw imValidationError('mark_too_long', 'mark 不能超过 100 字节');
         return {
             summary: { action: '申请加入群聊', groupId: groupId || '(token)', hasMark: Boolean(mark), needApproval: true },
             snapshot: compact({ groupId: groupId || undefined, token: token || undefined, mark: mark || undefined }),
@@ -266,7 +309,7 @@ const groupJoinPair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/joinGroup',
             body,
-            operation: 'yimiaoban.group.join',
+            operation: 'im.group.join',
         });
         assertImOk(res, '申请入群');
         const flag = Number(res?.data?.data?.flag ?? res?.data?.flag ?? -1);
@@ -286,20 +329,20 @@ function parseSwitchs(raw) {
         const flag = Number(flagRaw);
         const onOff = Number(onoffRaw);
         if (!Number.isInteger(flag) || !Number.isInteger(onOff)) {
-            throw ymbValidationError('switchs_invalid', `switchs 必须形如 flag:onoff（如 1:1,2:0），收到：${pair}`);
+            throw imValidationError('switchs_invalid', `switchs 必须形如 flag:onoff（如 1:1,2:0），收到：${pair}`);
         }
         return { flag, on_off: onOff };
     });
 }
 // ── 批量改群属性（batModGroupInfo）──
 const groupModifyPair = makeWritePair({
-    action: 'yimiaoban.group.modify',
+    action: 'im.group.modify',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         if (args.onoff !== undefined) {
-            throw ymbValidationError('field_forbidden', 'onoff 字段服务端不处理，请用 switchs');
+            throw imValidationError('field_forbidden', 'onoff 字段服务端不处理，请用 switchs');
         }
         const body = { group_id: groupId };
         let mask = 0;
@@ -330,31 +373,31 @@ const groupModifyPair = makeWritePair({
         const resolveOrFail = async (raw, label) => {
             const { users, failed } = await resolveMembers({ users: raw }, env);
             if (failed.length && args.removeFailed !== true) {
-                throw ymbValidationError('members_resolve_failed', `${label}信息获取失败（cid/uid 缺失或为 0）：${failed.map((f) => f.name ? `${f.name}(${f.uid})` : f.uid).join('、')}；确认移除请传 removeFailed:true`, { details: failed });
+                throw imValidationError('members_resolve_failed', `${label}信息获取失败（cid/uid 缺失或为 0）：${failed.map((f) => f.name ? `${f.name}(${f.uid})` : f.uid).join('、')}；确认移除请传 removeFailed:true`, { details: failed });
             }
             return users;
         };
         if (args.admins) {
             const users = await resolveOrFail(args.admins, '管理员');
             if (users.length === 0)
-                throw ymbValidationError('members_empty', '管理员解析为空');
+                throw imValidationError('members_empty', '管理员解析为空');
             set(1 << 7, 'admins', users);
         }
         if (args.delAdmins) {
             const users = await resolveOrFail(args.delAdmins, '待移除管理员');
             if (users.length === 0)
-                throw ymbValidationError('members_empty', '待移除管理员解析为空');
+                throw imValidationError('members_empty', '待移除管理员解析为空');
             // 源 modGroupInfo.js：移除管理员走 del_admins 字段（mask 与 admins 同为 admins 位），不能写进 admins
             set(1 << 7, 'del_admins', users);
         }
         if (args.creator) {
             const users = await resolveOrFail(args.creator, '新群主');
             if (!users.length)
-                throw ymbValidationError('members_empty', '新群主解析失败');
+                throw imValidationError('members_empty', '新群主解析失败');
             set(1 << 6, 'creator', users[0]);
         }
         if (mask === 0)
-            throw ymbValidationError('field_required', '至少修改一项（num/rsonoff/history/switchs/gtId/copyGroupids/admins/delAdmins/creator）');
+            throw imValidationError('field_required', '至少修改一项（num/rsonoff/history/switchs/gtId/copyGroupids/admins/delAdmins/creator）');
         body.mask = mask;
         return {
             summary: { action: '批量修改群属性', groupId, mask, changedFields: Object.keys(body).filter((k) => k !== 'group_id' && k !== 'mask') },
@@ -366,7 +409,7 @@ const groupModifyPair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/batModGroupInfo',
             body: plan.body,
-            operation: 'yimiaoban.group.modify',
+            operation: 'im.group.modify',
         });
         assertImOk(res, '修改群属性');
         return { groupId: plan.groupId };
@@ -374,31 +417,31 @@ const groupModifyPair = makeWritePair({
 });
 // ── 改群名/单字段（modifyGroupInfo）──
 const groupRenamePair = makeWritePair({
-    action: 'yimiaoban.group.rename',
+    action: 'im.group.rename',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         const forbidden = ['announce', 'type', 'state'];
         for (const key of forbidden) {
             if (args[key] !== undefined)
-                throw ymbValidationError('field_forbidden', `${key} 字段禁用：announce 请用公告操作，type/state 会触发高危行为`);
+                throw imValidationError('field_forbidden', `${key} 字段禁用：announce 请用公告操作，type/state 会触发高危行为`);
         }
         const fieldKeys = ['name', 'history', 'host', 'display', 'msgSetting', 'mark', 'gtid'].filter((k) => args[k] !== undefined);
         if (fieldKeys.length === 0)
-            throw ymbValidationError('field_required', '至少修改一项：name/history/host/display/msgSetting/mark/gtid');
+            throw imValidationError('field_required', '至少修改一项：name/history/host/display/msgSetting/mark/gtid');
         if (fieldKeys.length > 1)
-            throw ymbValidationError('field_conflict', '本接口一次只能改一项');
+            throw imValidationError('field_conflict', '本接口一次只能改一项');
         const field = fieldKeys[0];
         const maskOrder = { name: 0, history: 8, host: 4, display: 5, msgSetting: 6, mark: 7, gtid: 9 };
         let info = {};
         if (field === 'host') {
             const { users, failed } = await resolveMembers({ users: args.host }, env);
             if (failed.length) {
-                throw ymbValidationError('members_resolve_failed', `群主信息获取失败（cid/uid 缺失或为 0）：${failed.map((f) => f.name ? `${f.name}(${f.uid})` : f.uid).join('、')}`, { details: failed });
+                throw imValidationError('members_resolve_failed', `群主信息获取失败（cid/uid 缺失或为 0）：${failed.map((f) => f.name ? `${f.name}(${f.uid})` : f.uid).join('、')}`, { details: failed });
             }
             if (!users.length)
-                throw ymbValidationError('members_empty', '新群主解析失败');
+                throw imValidationError('members_empty', '新群主解析失败');
             info = { host: users[0] };
         }
         else if (field === 'history' || field === 'display' || field === 'msgSetting' || field === 'mark') {
@@ -425,7 +468,7 @@ const groupRenamePair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/modifyGroupInfo',
             body: { data: plan.data },
-            operation: 'yimiaoban.group.rename',
+            operation: 'im.group.rename',
         });
         assertImOk(res, '修改群信息');
         return { groupId: plan.groupId };
@@ -433,21 +476,21 @@ const groupRenamePair = makeWritePair({
 });
 // ── 群公告 增改删 ──
 const groupAnnounceModifyPair = makeWritePair({
-    action: 'yimiaoban.group.announce.modify',
+    action: 'im.group.announce.modify',
     async plan(args, env) {
         const groupId = str(args.groupId);
         if (!groupId || groupId === '0')
-            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            throw imValidationError('id_invalid', 'groupId 必须非 0');
         const isDel = args.del === true || String(args.del) === '1' || String(args.flag) === '1';
         const aid = args.aid !== undefined && args.aid !== '' ? String(args.aid) : '0';
         if (isDel && (!aid || aid === '0'))
-            throw ymbValidationError('aid_required', '删除公告必须指定 aid');
+            throw imValidationError('aid_required', '删除公告必须指定 aid');
         if (!isDel) {
             const annouce = args.annouce !== undefined ? String(args.annouce) : '';
             if (!annouce)
-                throw ymbValidationError('annouce_required', '新增/修改公告必须提供 annouce');
+                throw imValidationError('annouce_required', '新增/修改公告必须提供 annouce');
             if (annouce.length > 5000)
-                throw ymbValidationError('annouce_too_long', '公告内容过长');
+                throw imValidationError('annouce_too_long', '公告内容过长');
         }
         const summary = { action: isDel ? '删除群公告' : (aid && aid !== '0' ? '修改群公告' : '新增群公告'), groupId, aid };
         const snapshot = { groupId, flag: isDel ? 1 : 0, aid };
@@ -480,7 +523,7 @@ const groupAnnounceModifyPair = makeWritePair({
             method: 'POST',
             path: '/api/em/msg/executeIm/group/modifyAnnouce',
             body,
-            operation: 'yimiaoban.group.announce.modify',
+            operation: 'im.group.announce.modify',
         });
         assertImOk(res, '修改群公告');
         const responseAid = str(res?.data?.data?.aid ?? res?.data?.aid ?? '');
@@ -531,32 +574,36 @@ function buildWriteDefinition(name, method, summary, inputProps, pair) {
     ];
 }
 const groupWriteOps = [
-    ...buildWriteDefinition('yimiaoban.group.create', 'group.create', '创建普通群', {
+    ...buildWriteDefinition('im.group.create', 'group.create', '创建普通群', {
         users: { type: 'array', items: { type: 'string' }, description: '群成员 uid（逗号串或数组）' },
         name: { type: 'string', description: '群名（缺省自动生成）' },
         names: { type: 'array', items: { type: 'string' }, description: '与 users 顺序对应姓名（用于默认群名）' },
         admins: { type: 'array', items: { type: 'string' }, description: '管理员 uid' },
     }, groupCreatePair),
-    ...buildWriteDefinition('yimiaoban.group.invite', 'group.invite', '邀请成员入群', {
+    ...buildWriteDefinition('im.group.invite', 'group.invite', '邀请成员入群', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         users: { type: 'array', items: { type: 'string' }, description: '被邀请 uid' },
     }, groupInvitePair),
-    ...buildWriteDefinition('yimiaoban.group.kick', 'group.kick', '踢出群成员', {
+    ...buildWriteDefinition('im.group.kick', 'group.kick', '踢出群成员', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         users: { type: 'array', items: { type: 'string' }, description: '被踢 uid' },
     }, groupKickPair),
-    ...buildWriteDefinition('yimiaoban.group.exit', 'group.exit', '退出群聊', {
+    ...buildWriteDefinition('im.group.exit', 'group.exit', '退出群聊', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        acknowledgeOrphanRisk: {
+            type: 'boolean',
+            description: '群主或最后一个成员退群时必须显式传 true（退群后该群会变成无主空群，无法再 join/destroy）',
+        },
     }, groupExitPair),
-    ...buildWriteDefinition('yimiaoban.group.destroy', 'group.destroy', '解散群聊（仅群主，不可恢复）', {
+    ...buildWriteDefinition('im.group.destroy', 'group.destroy', '解散群聊（仅群主，不可恢复）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
     }, groupDestroyPair),
-    ...buildWriteDefinition('yimiaoban.group.join', 'group.join', '申请加入群聊', {
+    ...buildWriteDefinition('im.group.join', 'group.join', '申请加入群聊', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id（token 二选一）' },
         token: { type: 'string', description: '群 token/二维码加入' },
         mark: { type: 'string', maxLength: 100, description: '申请理由' },
     }, groupJoinPair),
-    ...buildWriteDefinition('yimiaoban.group.modify', 'group.modify', '批量修改群属性（batModGroupInfo）', {
+    ...buildWriteDefinition('im.group.modify', 'group.modify', '批量修改群属性（batModGroupInfo）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         num: { type: 'integer', description: '最大人数' },
         switchs: { type: 'string', description: '群开关（flag:onoff 逗号分隔，如 1:1,8:0）' },
@@ -568,7 +615,7 @@ const groupWriteOps = [
         copyGroupids: { type: 'array', items: { type: 'string' }, description: '拷贝群列表' },
         gtId: { type: 'string', description: '关联群类型 id' },
     }, groupModifyPair),
-    ...buildWriteDefinition('yimiaoban.group.rename', 'group.rename', '修改群信息（一次一项：群名/历史/群主/显示/打扰/标记/gtid）', {
+    ...buildWriteDefinition('im.group.rename', 'group.rename', '修改群信息（一次一项：群名/历史/群主/显示/打扰/标记/gtid）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         name: { type: 'string', description: '改群名' },
         history: { type: 'integer', description: '新人历史消息范围' },
@@ -578,7 +625,7 @@ const groupWriteOps = [
         mark: { type: 'integer', description: '标记位' },
         gtid: { type: 'string', description: 'GTID' },
     }, groupRenamePair),
-    ...buildWriteDefinition('yimiaoban.group.announce.modify', 'group.announce.modify', '新增/修改/删除群公告', {
+    ...buildWriteDefinition('im.group.announce.modify', 'group.announce.modify', '新增/修改/删除群公告', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         annouce: { type: 'string', description: '公告内容（删除时不需要）' },
         aid: { type: 'string', description: '公告 id（0/不传=新增；非 0=修改；删除必填）' },