weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/yimiaoban/operations/group-write.js

@@ -0,0 +1,591 @@
+import { ymbValidationError } from '../errors.js';
+import { schemaOf, WRITE, } from './types.js';
+import { assertImOk, compact, splitIds, str, toUint } from './shared.js';
+import { makeWritePair } from './write-util.js';
+/** 解析 uid 列表为 {cid,uid} 成员，支持 failed 移除。 */
+async function resolveMembers(args, env) {
+    const raw = Array.isArray(args.users) ? args.users.map((x) => String(x)) : splitIds(args.users, 'users');
+    const map = await env.host.resolveUsersByIds(raw);
+    const users = [];
+    const failed = [];
+    const names = {};
+    for (const uid of raw) {
+        const p = map[uid];
+        const cid = p?.cid || '';
+        if (p?.name)
+            names[uid] = p.name;
+        if (!uid || uid === '0' || !cid || cid === '0') {
+            failed.push({ uid, name: p?.name || '' });
+            continue;
+        }
+        users.push({ cid, uid });
+    }
+    return { users, failed, names };
+}
+/**
+ * 默认群名：自己的姓名 + 另外最多四个人的姓名（中文顿号连接，自己排第一位）。
+ * 姓名优先取调用方传入的 `names`（与 users 顺序一一对应），其次 hrm 解析结果，最后回退 uid。
+ */
+async function defaultGroupName(members, nameOf, selfUid, env) {
+    let selfName = selfUid ? nameOf(selfUid) : '';
+    if (!selfName) {
+        try {
+            const self = await env.host.getSelfIdentity();
+            if (self.name)
+                selfName = self.name;
+        }
+        catch { /* 回退 uid / 「我」 */ }
+    }
+    if (!selfName)
+        selfName = selfUid || '我';
+    const others = [];
+    for (const member of members) {
+        if (member.uid === selfUid)
+            continue; // 跳过自己，避免默认群名重复
+        if (others.length >= 4)
+            break;
+        others.push(nameOf(member.uid));
+    }
+    return [selfName, ...others].join('、');
+}
+// ── 建群 ──
+const groupCreatePair = makeWritePair({
+    action: 'yimiaoban.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 一致（顺序一一对应）');
+        }
+        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 });
+        }
+        if (users.length === 0)
+            throw ymbValidationError('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}）`);
+        }
+        // 默认群名：调用方 names（与 users 顺序对应）优先，其次 hrm 解析姓名，最后回退 uid
+        const providedNames = {};
+        rawUsers.forEach((uid, index) => {
+            if (names[index])
+                providedNames[uid] = names[index];
+        });
+        const nameOf = (uid) => providedNames[uid] || resolvedNames[uid] || uid;
+        const name = args.name ? String(args.name) : await defaultGroupName(users, nameOf, selfUid, env);
+        // 管理员
+        let admins = [];
+        if (args.admins) {
+            const adminRaw = Array.isArray(args.admins) ? args.admins.map((x) => String(x)) : splitIds(args.admins, 'admins');
+            const adminMap = await env.host.resolveUsersByIds(adminRaw);
+            const adminFailed = adminRaw.filter((uid) => {
+                const cid = adminMap[uid]?.cid || '';
+                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 });
+            }
+            admins = adminRaw.map((uid) => ({ cid: adminMap[uid]?.cid || '', uid }));
+        }
+        return {
+            summary: {
+                action: '创建普通群',
+                name,
+                memberCount: users.length,
+                members: users.map((u) => u.uid),
+                adminCount: admins.length,
+                removeFailed: args.removeFailed === true ? failed.map((f) => f.uid) : [],
+            },
+            snapshot: { name, users, admins, failed, removeFailed: args.removeFailed === true },
+        };
+    },
+    async execute(plan, env) {
+        const { name, users, admins } = plan;
+        const body = compact({
+            name,
+            type: 0,
+            users,
+            attr: admins.length ? { admins } : {},
+        });
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/groupCreate',
+            body,
+            operation: 'yimiaoban.group.create',
+        });
+        assertImOk(res, '创建群');
+        // 群 id 可能位于 data / data.data 的 groupId / group_id / id 字段，统一扫描；同时回传服务端原始数据便于核对
+        const payload = res?.data ?? {};
+        const inner = payload?.data ?? {};
+        const groupId = str(inner.groupId ?? inner.group_id ?? inner.id
+            ?? payload.groupId ?? payload.group_id ?? payload.id
+            ?? '');
+        return { groupId, name, rawData: inner && Object.keys(inner).length ? inner : payload };
+    },
+});
+// ── 邀请入群 ──
+const groupInvitePair = makeWritePair({
+    action: 'yimiaoban.group.invite',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('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`);
+        }
+        if (users.length === 0)
+            throw ymbValidationError('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 },
+        };
+    },
+    async execute(plan, env) {
+        const body = { groupId: plan.groupId, users: plan.users };
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/inviteGroupUsers',
+            body,
+            operation: 'yimiaoban.group.invite',
+        });
+        assertImOk(res, '邀请入群');
+        return { groupId: plan.groupId, invited: plan.users.length };
+    },
+});
+// ── 踢出群 ──
+const groupKickPair = makeWritePair({
+    action: 'yimiaoban.group.kick',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('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`);
+        }
+        if (users.length === 0)
+            throw ymbValidationError('members_empty', '没有可移除的成员');
+        return {
+            summary: { action: '踢出群成员', groupId, kickCount: users.length, users: users.map((u) => u.uid) },
+            snapshot: { groupId, users },
+        };
+    },
+    async execute(plan, env) {
+        const body = { groupId: plan.groupId, users: plan.users };
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/kickGroupUsers',
+            body,
+            operation: 'yimiaoban.group.kick',
+        });
+        assertImOk(res, '踢出群成员');
+        return { groupId: plan.groupId, kicked: plan.users.length };
+    },
+});
+// ── 退群 ──
+const groupExitPair = makeWritePair({
+    action: 'yimiaoban.group.exit',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        return {
+            summary: { action: '退出群聊', groupId },
+            snapshot: { groupId },
+        };
+    },
+    async execute(plan, env) {
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/exit',
+            body: { groupId: plan.groupId },
+            operation: 'yimiaoban.group.exit',
+        });
+        assertImOk(res, '退出群聊');
+        return { groupId: plan.groupId };
+    },
+});
+// ── 解散群 ──
+const groupDestroyPair = makeWritePair({
+    action: 'yimiaoban.group.destroy',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        return {
+            summary: { action: '解散群聊（仅群主可执行，不可恢复）', groupId },
+            snapshot: { groupId },
+        };
+    },
+    async execute(plan, env) {
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/destroy',
+            body: { groupId: plan.groupId },
+            operation: 'yimiaoban.group.destroy',
+        });
+        assertImOk(res, '解散群聊');
+        return { groupId: plan.groupId };
+    },
+});
+// ── 申请入群 ──
+const groupJoinPair = makeWritePair({
+    action: 'yimiaoban.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 至少其一');
+        if (groupId && groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        if (token && token.length > 500)
+            throw ymbValidationError('token_invalid', 'token 过长');
+        const mark = args.mark !== undefined && args.mark !== '' ? String(args.mark) : '';
+        if (mark.length > 100)
+            throw ymbValidationError('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 }),
+        };
+    },
+    async execute(plan, env) {
+        const body = compact({
+            trans_id: 0,
+            dev: 4,
+            rule: 0,
+            auto: 0,
+            group_id: plan.groupId || undefined,
+            mark: plan.mark || undefined,
+            token: plan.token || undefined,
+        });
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/joinGroup',
+            body,
+            operation: 'yimiaoban.group.join',
+        });
+        assertImOk(res, '申请入群');
+        const flag = Number(res?.data?.data?.flag ?? res?.data?.flag ?? -1);
+        return {
+            flag,
+            note: flag === 1 ? '无需验证，已直接加入' : flag === 0 ? '需管理员/群主审批' : '未知结果',
+        };
+    },
+});
+/** --switchs 解析：flag:onoff 逗号分隔。 */
+function parseSwitchs(raw) {
+    const text = String(raw ?? '');
+    if (!text)
+        return [];
+    return text.split(',').map((pair) => {
+        const [flagRaw, onoffRaw] = pair.split(':');
+        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}`);
+        }
+        return { flag, on_off: onOff };
+    });
+}
+// ── 批量改群属性（batModGroupInfo）──
+const groupModifyPair = makeWritePair({
+    action: 'yimiaoban.group.modify',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        if (args.onoff !== undefined) {
+            throw ymbValidationError('field_forbidden', 'onoff 字段服务端不处理，请用 switchs');
+        }
+        const body = { group_id: groupId };
+        let mask = 0;
+        const set = (bit, key, value) => {
+            if (value !== undefined) {
+                mask |= bit;
+                body[key] = value;
+            }
+        };
+        if (args.num !== undefined)
+            set(1 << 1, 'num', toUint(args.num, 'num'));
+        if (args.rsonoff !== undefined)
+            set(1 << 3, 'rsonoff', toUint(args.rsonoff, 'rsonoff'));
+        if (args.history !== undefined)
+            set(1 << 5, 'history', toUint(args.history, 'history'));
+        if (args.switchs !== undefined) {
+            const list = parseSwitchs(args.switchs);
+            if (list.length)
+                set(1 << 8, 'switchs', list);
+        }
+        if (args.gtId !== undefined)
+            set(1 << 11, 'gt_id', String(args.gtId));
+        if (args.copyGroupids) {
+            const ids = Array.isArray(args.copyGroupids) ? args.copyGroupids.map((x) => String(x)) : splitIds(args.copyGroupids, 'copyGroupids');
+            set(1 << 9, 'copy_groupids', ids.map((x) => Number(x)));
+        }
+        /** 解析成员并在失败时中止（确认移除后才继续），与源脚本 resolveMemberUsers 语义一致。 */
+        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 });
+            }
+            return users;
+        };
+        if (args.admins) {
+            const users = await resolveOrFail(args.admins, '管理员');
+            if (users.length === 0)
+                throw ymbValidationError('members_empty', '管理员解析为空');
+            set(1 << 7, 'admins', users);
+        }
+        if (args.delAdmins) {
+            const users = await resolveOrFail(args.delAdmins, '待移除管理员');
+            if (users.length === 0)
+                throw ymbValidationError('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', '新群主解析失败');
+            set(1 << 6, 'creator', users[0]);
+        }
+        if (mask === 0)
+            throw ymbValidationError('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') },
+            snapshot: { groupId, body },
+        };
+    },
+    async execute(plan, env) {
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/batModGroupInfo',
+            body: plan.body,
+            operation: 'yimiaoban.group.modify',
+        });
+        assertImOk(res, '修改群属性');
+        return { groupId: plan.groupId };
+    },
+});
+// ── 改群名/单字段（modifyGroupInfo）──
+const groupRenamePair = makeWritePair({
+    action: 'yimiaoban.group.rename',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('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 会触发高危行为`);
+        }
+        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');
+        if (fieldKeys.length > 1)
+            throw ymbValidationError('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 });
+            }
+            if (!users.length)
+                throw ymbValidationError('members_empty', '新群主解析失败');
+            info = { host: users[0] };
+        }
+        else if (field === 'history' || field === 'display' || field === 'msgSetting' || field === 'mark') {
+            info = { [field === 'msgSetting' ? 'msg_setting' : field]: toUint(args[field], field) };
+        }
+        else {
+            info = { [field]: field === 'gtid' ? String(args[field]) : String(args[field]) };
+        }
+        const data = {
+            trans_id: 0,
+            group_id: groupId,
+            type: 0,
+            dev: 4,
+            mask: maskOrder[field],
+            info,
+        };
+        return {
+            summary: { action: `修改群信息（${field}）`, groupId, field, value: info[field === 'msgSetting' ? 'msg_setting' : field] },
+            snapshot: { groupId, data },
+        };
+    },
+    async execute(plan, env) {
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/modifyGroupInfo',
+            body: { data: plan.data },
+            operation: 'yimiaoban.group.rename',
+        });
+        assertImOk(res, '修改群信息');
+        return { groupId: plan.groupId };
+    },
+});
+// ── 群公告 增改删 ──
+const groupAnnounceModifyPair = makeWritePair({
+    action: 'yimiaoban.group.announce.modify',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('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');
+        if (!isDel) {
+            const annouce = args.annouce !== undefined ? String(args.annouce) : '';
+            if (!annouce)
+                throw ymbValidationError('annouce_required', '新增/修改公告必须提供 annouce');
+            if (annouce.length > 5000)
+                throw ymbValidationError('annouce_too_long', '公告内容过长');
+        }
+        const summary = { action: isDel ? '删除群公告' : (aid && aid !== '0' ? '修改群公告' : '新增群公告'), groupId, aid };
+        const snapshot = { groupId, flag: isDel ? 1 : 0, aid };
+        if (!isDel) {
+            const notice = args.notice !== undefined ? toUint(args.notice, 'notice') : 0;
+            const fmark = args.fmark !== undefined ? toUint(args.fmark, 'fmark') : undefined;
+            summary.notice = notice;
+            summary.mustRead = fmark === 1;
+            snapshot.annouce = String(args.annouce);
+            snapshot.notice = notice;
+            if (fmark !== undefined)
+                snapshot.fmark = fmark;
+            if (args.related !== undefined)
+                snapshot.related = String(args.related);
+        }
+        return { summary, snapshot };
+    },
+    async execute(plan, env) {
+        const body = compact({
+            groupId: plan.groupId,
+            flag: plan.flag,
+            aid: plan.aid,
+            annouce: plan.annouce,
+            notice: plan.notice,
+            fmark: plan.fmark,
+            related: plan.related,
+            sensitive_flag: plan.flag === 1 ? undefined : 1,
+        });
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/group/modifyAnnouce',
+            body,
+            operation: 'yimiaoban.group.announce.modify',
+        });
+        assertImOk(res, '修改群公告');
+        const responseAid = str(res?.data?.data?.aid ?? res?.data?.aid ?? '');
+        const deleted = plan.flag === 1;
+        // 删除后服务端可能回 0/空 aid：对外仍回报被删除的那条公告 id，便于核对
+        return {
+            groupId: plan.groupId,
+            aid: responseAid && responseAid !== '0' ? responseAid : plan.aid,
+            deleted,
+            ...(deleted ? {} : { created: plan.aid === '0' }),
+        };
+    },
+});
+function buildWriteDefinition(name, method, summary, inputProps, pair) {
+    const requiredInput = Object.keys(inputProps).filter((k) => {
+        const prop = inputProps[k];
+        return prop?.required === true;
+    });
+    const prepareSchema = schemaOf({ ...inputProps, removeFailed: { type: 'boolean', description: '确认移除解析失败成员' } }, { required: requiredInput, description: summary });
+    return [
+        {
+            name: `${name}.prepare`,
+            resource: 'group',
+            method: `${method}.prepare`,
+            action: `${name}.prepare`,
+            summary: `${summary}（prepare：只读校验 + 差异摘要 + 签发确认）`,
+            capability: 'group',
+            risk: 'read-before-write',
+            requiresConfirmation: true,
+            inputSchema: prepareSchema,
+            handler: pair.prepare,
+        },
+        {
+            name: `${name}.apply`,
+            resource: 'group',
+            method: `${method}.apply`,
+            action: `${name}.apply`,
+            summary: `${summary}（apply：需 confirm:true + continuation）`,
+            capability: 'group',
+            risk: WRITE,
+            requiresConfirmation: true,
+            inputSchema: schemaOf({
+                confirm: { type: 'boolean', description: '必须为 true' },
+                continuation: { type: 'string', minLength: 1 },
+            }, { required: ['confirm', 'continuation'], description: summary }),
+            handler: pair.apply,
+        },
+    ];
+}
+const groupWriteOps = [
+    ...buildWriteDefinition('yimiaoban.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', '邀请成员入群', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        users: { type: 'array', items: { type: 'string' }, description: '被邀请 uid' },
+    }, groupInvitePair),
+    ...buildWriteDefinition('yimiaoban.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', '退出群聊', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+    }, groupExitPair),
+    ...buildWriteDefinition('yimiaoban.group.destroy', 'group.destroy', '解散群聊（仅群主，不可恢复）', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+    }, groupDestroyPair),
+    ...buildWriteDefinition('yimiaoban.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）', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        num: { type: 'integer', description: '最大人数' },
+        switchs: { type: 'string', description: '群开关（flag:onoff 逗号分隔，如 1:1,8:0）' },
+        rsonoff: { type: 'integer', enum: [0, 1], description: '消息阅读状态开关' },
+        history: { type: 'integer', description: '新人可看历史范围' },
+        admins: { type: 'array', items: { type: 'string' }, description: '新增管理员 uid' },
+        delAdmins: { type: 'array', items: { type: 'string' }, description: '移除管理员 uid' },
+        creator: { type: 'string', description: '转让群主（单 uid）' },
+        copyGroupids: { type: 'array', items: { type: 'string' }, description: '拷贝群列表' },
+        gtId: { type: 'string', description: '关联群类型 id' },
+    }, groupModifyPair),
+    ...buildWriteDefinition('yimiaoban.group.rename', 'group.rename', '修改群信息（一次一项：群名/历史/群主/显示/打扰/标记/gtid）', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        name: { type: 'string', description: '改群名' },
+        history: { type: 'integer', description: '新人历史消息范围' },
+        host: { type: 'string', description: '转让群主（单 uid）' },
+        display: { type: 'integer', enum: [0, 1], description: '是否在群列表显示' },
+        msgSetting: { type: 'integer', description: '消息打扰设置' },
+        mark: { type: 'integer', description: '标记位' },
+        gtid: { type: 'string', description: 'GTID' },
+    }, groupRenamePair),
+    ...buildWriteDefinition('yimiaoban.group.announce.modify', 'group.announce.modify', '新增/修改/删除群公告', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        annouce: { type: 'string', description: '公告内容（删除时不需要）' },
+        aid: { type: 'string', description: '公告 id（0/不传=新增；非 0=修改；删除必填）' },
+        del: { type: 'boolean', description: '删除开关' },
+        notice: { type: 'integer', enum: [0, 1, 2], description: '0 发通知(默认)/1 不发/2 发并@全体' },
+        fmark: { type: 'integer', enum: [0, 1], description: '新人必看' },
+        related: { type: 'string', description: '关联附件 id' },
+    }, groupAnnounceModifyPair),
+];
+export const groupWriteOperations = groupWriteOps;