weaver-work-cli 0.1.4 → 0.1.5

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

@@ -0,0 +1,593 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { ymbValidationError } from '../errors.js';
+import { schemaOf, } from './types.js';
+import { assertImOk, compact, extractGroupMembers, str } from './shared.js';
+import { fileObjToFile, fileObjToImg, makeWritePair } from './write-util.js';
+/** 校验本地文件存在，返回绝对路径。 */
+function assertLocalFile(pathValue, field) {
+    const abs = resolve(String(pathValue ?? ''));
+    if (!existsSync(abs))
+        throw ymbValidationError('file_not_found', `${field} 文件不存在: ${abs}`);
+    return abs;
+}
+/**
+ * 单聊/群聊发送内容归一化：txt / img / file 至少一种。
+ * 🔴 全空白文本（空格 / 换行）不算内容，禁止发送空白消息。
+ */
+function normalizeContent(args) {
+    const txtRaw = args.txt !== undefined && args.txt !== null ? String(args.txt) : '';
+    const txt = txtRaw.trim() !== '' ? txtRaw : undefined;
+    const imgPath = args.img || args.imgPath ? String(args.img || args.imgPath) : undefined;
+    const filePath = args.file || args.filePath ? String(args.file || args.filePath) : undefined;
+    if (!txt && !imgPath && !filePath) {
+        throw ymbValidationError('content_required', 'txt / img / file 至少提供一种（空白文本不算内容，禁止发送空白消息）');
+    }
+    if (imgPath && filePath) {
+        throw ymbValidationError('content_conflict', 'img 与 file 不能同时提供（一次发一种媒体）');
+    }
+    return { txt, imgPath, filePath };
+}
+// ── 发单聊 ──
+const sendSinglePair = makeWritePair({
+    action: 'yimiaoban.msg.send.single',
+    async plan(args, env) {
+        const toUid = str(args.toUid);
+        const toCid = str(args.toCid);
+        if (!toUid || !toCid || toUid === '0' || toCid === '0') {
+            throw ymbValidationError('id_invalid', 'toUid/toCid 必须非 0');
+        }
+        const content = normalizeContent(args);
+        const summary = {
+            action: '发送单聊消息',
+            toUid,
+            toCid,
+            hasTxt: Boolean(content.txt),
+            hasImg: Boolean(content.imgPath),
+            hasFile: Boolean(content.filePath),
+        };
+        const snapshot = { toUid, toCid };
+        if (content.txt) {
+            snapshot.txt = content.txt;
+            summary.textPreview = content.txt.length > 60 ? `${content.txt.slice(0, 60)}…` : content.txt;
+        }
+        if (content.imgPath) {
+            const abs = assertLocalFile(content.imgPath, 'img');
+            snapshot.imgPath = abs;
+            summary.fileName = abs.split(/[\\/]/).pop();
+        }
+        if (content.filePath) {
+            const abs = assertLocalFile(content.filePath, 'file');
+            snapshot.filePath = abs;
+            summary.fileName = abs.split(/[\\/]/).pop();
+        }
+        return { summary, snapshot };
+    },
+    async execute(plan, env) {
+        const body = { reciver: { cid: plan.toCid, uid: plan.toUid } };
+        if (plan.txt !== undefined)
+            body.txt = plan.txt;
+        if (plan.imgPath) {
+            const fileObj = await env.host.uploadFile(plan.imgPath, { shareUsers: plan.toUid });
+            body.img = fileObjToImg(fileObj);
+        }
+        if (plan.filePath) {
+            const fileObj = await env.host.uploadFile(plan.filePath, { shareUsers: plan.toUid });
+            body.file = fileObjToFile(fileObj);
+        }
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/send/sendSingleMsg',
+            body,
+            operation: 'yimiaoban.msg.send.single',
+        });
+        assertImOk(res, '发送单聊消息');
+        return { toUid: plan.toUid, toCid: plan.toCid, sent: true };
+    },
+});
+// ── 发群聊 ──
+const sendGroupPair = makeWritePair({
+    action: 'yimiaoban.msg.send.group',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        const content = normalizeContent(args);
+        const summary = { action: '发送群聊消息', groupId, hasTxt: Boolean(content.txt), hasImg: Boolean(content.imgPath), hasFile: Boolean(content.filePath) };
+        const snapshot = { groupId };
+        if (content.txt) {
+            snapshot.txt = content.txt;
+            summary.textPreview = content.txt.length > 60 ? `${content.txt.slice(0, 60)}…` : content.txt;
+        }
+        if (content.imgPath) {
+            const abs = assertLocalFile(content.imgPath, 'img');
+            snapshot.imgPath = abs;
+            summary.fileName = abs.split(/[\\/]/).pop();
+        }
+        if (content.filePath) {
+            const abs = assertLocalFile(content.filePath, 'file');
+            snapshot.filePath = abs;
+            summary.fileName = abs.split(/[\\/]/).pop();
+        }
+        return { summary, snapshot };
+    },
+    async execute(plan, env) {
+        const body = { groupId: plan.groupId };
+        if (plan.txt !== undefined)
+            body.txt = plan.txt;
+        if (plan.imgPath) {
+            const fileObj = await env.host.uploadFile(plan.imgPath, { shareGroups: plan.groupId });
+            body.img = fileObjToImg(fileObj);
+        }
+        if (plan.filePath) {
+            const fileObj = await env.host.uploadFile(plan.filePath, { shareGroups: plan.groupId });
+            body.file = fileObjToFile(fileObj);
+        }
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/send/sendGroupMsg',
+            body,
+            operation: 'yimiaoban.msg.send.group',
+        });
+        assertImOk(res, '发送群聊消息');
+        return { groupId: plan.groupId, sent: true };
+    },
+});
+// ── 撤回消息 ──
+/** 递归查找撤回时限字段（time_out，接口返回，单位秒）。 */
+function findWithdrawTimeOut(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    if (value.time_out !== undefined && value.time_out !== null && String(value.time_out) !== '') {
+        return String(value.time_out);
+    }
+    for (const key of Object.keys(value)) {
+        const found = findWithdrawTimeOut(value[key]);
+        if (found !== null)
+            return found;
+    }
+    return null;
+}
+/** 撤回时限展示：秒 → 「X 分钟 Y 秒」（>=60 秒时）。 */
+function formatWithdrawInterval(seconds) {
+    const total = parseInt(seconds, 10);
+    if (!Number.isFinite(total) || total <= 0)
+        return `${seconds} 秒`;
+    if (total < 60)
+        return `${total} 秒`;
+    const minutes = Math.floor(total / 60);
+    const rest = total % 60;
+    return rest > 0 ? `${minutes} 分钟 ${rest} 秒` : `${minutes} 分钟`;
+}
+const withdrawPair = makeWritePair({
+    action: 'yimiaoban.msg.withdraw',
+    async plan(args, env) {
+        const type = String(args.type || 'single');
+        if (type !== 'single' && type !== 'group')
+            throw ymbValidationError('type_invalid', 'type 必须是 single 或 group');
+        const msgid = str(args.msgid);
+        if (!msgid || msgid === '0')
+            throw ymbValidationError('id_invalid', 'msgid 必须非 0');
+        const snapshot = { type, msgid };
+        let source;
+        if (type === 'single') {
+            const toUid = str(args.toUid);
+            const toCid = str(args.toCid);
+            if (!toUid || !toCid || toUid === '0' || toCid === '0')
+                throw ymbValidationError('id_invalid', 'toUid/toCid 必须非 0（撤回单聊消息）');
+            snapshot.toUid = toUid;
+            snapshot.toCid = toCid;
+            source = { flag: 0, user: { cid: toCid, uid: toUid } };
+        }
+        else {
+            const groupId = str(args.groupId);
+            if (!groupId || groupId === '0')
+                throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+            snapshot.groupId = groupId;
+            source = { flag: 1, group_id: groupId };
+        }
+        return {
+            summary: { action: type === 'single' ? '撤回单聊消息' : '撤回群聊消息', msgid, source },
+            snapshot: { ...snapshot, source },
+        };
+    },
+    async execute(plan, env) {
+        // 撤回体需操作者自身 cid/uid/姓名（auth 非 0）
+        const self = await env.host.getSelfIdentity();
+        const name = self.name || self.uid || '我';
+        const withdrawMsg = JSON.stringify({
+            display: '0',
+            dt: [{ txt: { id18n: '103838', kvs: { '%NAME%': name, '%UNAME%': '' }, ot: '1', ou: { c: self.cid, u: self.uid }, v: `${name}撤回了一条消息` } }],
+            scid: self.cid,
+            suid: self.uid,
+            sname: name,
+            type: '10',
+            ver: '1.0',
+        });
+        const body = {
+            source: plan.source,
+            msgid: plan.msgid,
+            dev: 5,
+            msg: withdrawMsg,
+            title: withdrawMsg,
+            trans_id: String(Math.floor(Date.now() / 1000)),
+            sensitive_confirm: '0',
+        };
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/msg/makeMsgWithdraw',
+            body,
+            operation: 'yimiaoban.msg.withdraw',
+        });
+        const actCode = Number(res?.data?.actionMsg?.code ?? res?.code ?? -1);
+        const timeOut = findWithdrawTimeOut(res);
+        const interval = timeOut !== null ? formatWithdrawInterval(timeOut) : '';
+        if (actCode === 1505) {
+            throw ymbValidationError('withdraw_timeout', `撤销超时${interval ? `（撤回时限 ${interval}）` : '（发出超过约 2 分钟）'}：消息发送已超过可撤回时限，无法撤回`, { code: 1505, details: interval ? { withdrawInterval: interval } : undefined });
+        }
+        if (actCode === 1506)
+            throw ymbValidationError('withdraw_not_owner', '消息不是自己发送的，无法撤回', { code: 1506 });
+        if (actCode === 1507)
+            throw ymbValidationError('withdraw_edit_timeout', '编辑撤回超时', { code: 1507 });
+        if (actCode !== 0)
+            throw ymbValidationError('withdraw_failed', `撤回失败（code=${actCode}）`, { code: actCode });
+        return {
+            msgid: plan.msgid,
+            withdrawn: true,
+            ...(interval ? { withdrawInterval: interval, withdrawIntervalSeconds: Number(timeOut) } : {}),
+        };
+    },
+});
+// ── 群置顶/取消置顶 ──
+const topSetPair = makeWritePair({
+    action: 'yimiaoban.msg.top.set',
+    async plan(args, env) {
+        const groupId = str(args.groupId);
+        if (!groupId || groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        const msgid = str(args.msgid);
+        if (!msgid || msgid === '0')
+            throw ymbValidationError('id_invalid', 'msgid 必须非 0');
+        let type;
+        if (args.cancel === true)
+            type = 2;
+        else if (args.type !== undefined) {
+            type = Number(args.type);
+            if (type !== 1 && type !== 2)
+                throw ymbValidationError('type_invalid', 'type 必须是 1（置顶）或 2（取消置顶）');
+        }
+        else
+            type = 1;
+        return {
+            summary: { action: type === 1 ? '群消息置顶' : '取消群消息置顶', groupId, msgid },
+            snapshot: { groupId, msgid, type },
+        };
+    },
+    async execute(plan, env) {
+        const body = { group_id: plan.groupId, type: plan.type, msgid: plan.msgid };
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/executeIm/msg/setGroupTopMsg',
+            body,
+            operation: 'yimiaoban.msg.top.set',
+        });
+        assertImOk(res, plan.type === 1 ? '置顶消息' : '取消置顶');
+        return { groupId: plan.groupId, msgid: plan.msgid, type: plan.type };
+    },
+});
+// ── 必达 sendDing ──
+const dingSendPair = makeWritePair({
+    action: 'yimiaoban.ding.send',
+    async plan(args, env) {
+        const groupId = args.groupId !== undefined && args.groupId !== '' ? str(args.groupId) : '';
+        const toUid = args.toUid !== undefined && args.toUid !== '' ? str(args.toUid) : '';
+        const convertMsgid = args.convertMsgid !== undefined && args.convertMsgid !== '' ? str(args.convertMsgid) : '';
+        if (!groupId && !toUid)
+            throw ymbValidationError('target_required', 'groupId（群必达）与 toUid（单聊必达）至少其一');
+        if (groupId && groupId === '0')
+            throw ymbValidationError('id_invalid', 'groupId 必须非 0');
+        const txtRaw = args.txt !== undefined && args.txt !== null ? String(args.txt) : '';
+        const txt = txtRaw.trim() !== '' ? txtRaw : '';
+        if (!convertMsgid && !txt)
+            throw ymbValidationError('content_required', '普通必达需 txt；转必达需 convertMsgid');
+        if (args.unreadOnly === true && !groupId) {
+            throw ymbValidationError('unread_only_group_only', 'unreadOnly 仅支持群聊转必达（需提供 groupId）');
+        }
+        if (!groupId && convertMsgid && !str(args.toCid)) {
+            throw ymbValidationError('to_cid_required', '单聊转必达需提供 toCid（用于按消息 id 拉取源消息）');
+        }
+        const summary = {
+            action: convertMsgid ? '已有消息转必达' : '发送必达消息',
+            targetType: groupId ? '群聊' : '单聊',
+            ...(groupId ? { groupId } : { toUid }),
+            ...(convertMsgid ? { convertMsgid } : { textPreview: txt.length > 60 ? `${txt.slice(0, 60)}…` : txt }),
+            sendMsg: args.sendMsg !== undefined ? Number(args.sendMsg) : 1,
+            showType: args.showType !== undefined ? Number(args.showType) : 0,
+        };
+        const snapshot = {
+            groupId: groupId || undefined,
+            toUid: toUid || undefined,
+            toCid: args.toCid !== undefined ? str(args.toCid) : undefined,
+            txt: txt || undefined,
+            convertMsgid: convertMsgid || undefined,
+            unreadOnly: args.unreadOnly === true,
+            toUids: args.toUids !== undefined ? (Array.isArray(args.toUids) ? args.toUids.map((x) => String(x)) : String(args.toUids).split(',').map((s) => s.trim()).filter(Boolean)) : undefined,
+            sendMsg: args.sendMsg !== undefined ? Number(args.sendMsg) : 1,
+            showType: args.showType !== undefined ? Number(args.showType) : 0,
+            removeFailed: args.removeFailed === true,
+        };
+        // 群场景：接收人集合在 prepare（只读）阶段确定并进入确认摘要，写阶段直接使用，
+        // 避免「用户确认后才发现没有可发对象」，也与源 sendDing.js 的先算接收人再发送一致。
+        if (groupId) {
+            const self = await env.host.getSelfIdentity();
+            const myUid = self.uid || (await env.host.getSession()).userId;
+            const requested = Array.isArray(snapshot.toUids)
+                ? [...new Set(snapshot.toUids.map((x) => String(x)))]
+                : [];
+            const groupUsers = [];
+            let receiverSource = '全体成员';
+            if (requested.length) {
+                receiverSource = '指定人员';
+                const map = await env.host.resolveUsersByIds(requested);
+                const failed = requested.filter((uid) => !map[uid]?.cid || map[uid].cid === '0');
+                if (failed.length && snapshot.removeFailed !== true) {
+                    throw ymbValidationError('members_resolve_failed', `指定接收人信息获取失败（cid 缺失或为 0）：${failed.map((uid) => map[uid]?.name || uid).join('、')}；确认跳过请传 removeFailed:true`, { details: failed });
+                }
+                for (const uid of requested) {
+                    const cid = map[uid]?.cid;
+                    if (!cid || cid === '0' || uid === myUid)
+                        continue;
+                    groupUsers.push({ cid, uid });
+                }
+            }
+            else if (snapshot.unreadOnly === true) {
+                receiverSource = '仅未读人员';
+                const readRes = await env.host.request({
+                    method: 'POST',
+                    path: '/api/em/msg/executeIm/group/syncGroupReadStatus',
+                    body: { trans_id: 0, group_id: groupId, msgid: convertMsgid || '0' },
+                    operation: 'yimiaoban.ding.send.unread',
+                });
+                const readDatas = readRes?.data?.data?.datas || [];
+                const unread = readDatas.filter((d) => Number(d.status) === 0);
+                const uidArr = [
+                    ...new Set(unread.map((d) => String(d?.user?.uid)).filter((uid) => Boolean(uid) && uid !== myUid)),
+                ];
+                if (uidArr.length === 0) {
+                    throw ymbValidationError('unread_empty', '群内没有未读人员（unreadOnly=true 不自动回退全员）：请确认改发全体成员、指定人员，或放弃发送');
+                }
+                const map = await env.host.resolveUsersByIds(uidArr);
+                for (const uid of uidArr) {
+                    const cid = map[uid]?.cid;
+                    if (cid && cid !== '0')
+                        groupUsers.push({ cid, uid });
+                }
+            }
+            else {
+                const memRes = await env.host.request({
+                    method: 'POST',
+                    path: '/api/em/msg/executeIm/group/getGroupUsers',
+                    body: { group_id: groupId, type: 0, sync_type: 0, member_mask: 6, client_uc: '0' },
+                    operation: 'yimiaoban.ding.send.members',
+                });
+                const uidArr = [...new Set(extractGroupMembers(memRes?.data?.data)
+                        .map((m) => String(m?.uid))
+                        .filter((uid) => uid && uid !== myUid))];
+                const map = await env.host.resolveUsersByIds(uidArr);
+                for (const uid of uidArr) {
+                    const cid = map[uid]?.cid;
+                    if (cid && cid !== '0')
+                        groupUsers.push({ cid, uid });
+                }
+            }
+            if (groupUsers.length === 0) {
+                throw ymbValidationError('members_empty', '群内没有可接收必达消息的成员（已排除本人；指定/未读人员可能为空）');
+            }
+            snapshot.groupUsers = groupUsers;
+            snapshot.receiveUserIds = groupUsers.map((u) => u.uid).join(',');
+            summary.receiverSource = receiverSource;
+            summary.receiverCount = groupUsers.length;
+        }
+        else {
+            summary.receiverSource = '单聊对方';
+            summary.receiverCount = 1;
+        }
+        return { summary, snapshot };
+    },
+    async execute(plan, env) {
+        const self = await env.host.getSelfIdentity();
+        const session = await env.host.getSession();
+        const myUid = self.uid || session.userId;
+        const myCid = self.cid;
+        const myName = self.name || myUid;
+        let receiveUserIds = '';
+        let targetType;
+        let targetId = '';
+        let mkind;
+        let msgEntity;
+        let msgTitle;
+        let groupUsers;
+        let fileIds = '';
+        let extraInfo = '';
+        let content = '';
+        if (plan.convertMsgid) {
+            // 转必达：先取源消息
+            const sourceReq = plan.groupId
+                ? { trans_id: 0, dev: 4, type: 0, enc_type: 0, datas: [{ group_id: plan.groupId, start: plan.convertMsgid, end: '0', max_num: 1 }] }
+                : { trans_id: 0, dev: 4, enc_type: 0, datas: [{ from_cid: plan.toCid, from_uid: plan.toUid, start: plan.convertMsgid, end: '0', max_num: 1 }] };
+            const sourcePath = plan.groupId ? '/api/em/msg/executeIm/chat/syncGroupMsg' : '/api/em/msg/executeIm/msg/syncSingleMsg';
+            const srcRes = await env.host.request({ method: 'POST', path: sourcePath, body: sourceReq, operation: 'yimiaoban.ding.send.source' });
+            const srcMsg = srcRes?.data?.data?.datas?.[0]?.datas?.[0] ?? srcRes?.data?.data?.datas?.[0];
+            if (!srcMsg?.msg)
+                throw ymbValidationError('source_not_found', `未找到源消息 ${plan.convertMsgid}`);
+            let msgObj;
+            try {
+                msgObj = typeof srcMsg.msg === 'string' ? JSON.parse(srcMsg.msg) : srcMsg.msg;
+            }
+            catch {
+                throw ymbValidationError('source_invalid', '源消息内容无法解析');
+            }
+            const mtype = Number(msgObj.type ?? 0);
+            let tag;
+            let titleDt;
+            const nm = msgObj.dt?.[0]?.file?.nm || msgObj.dt?.[0]?.img?.nm || msgObj.dt?.[0]?.media?.nm || '';
+            if (mtype === 4) {
+                tag = '2';
+                content = `[文件]${nm}`;
+                mkind = 512;
+                titleDt = [{ txt: { v: nm } }];
+                fileIds = String(msgObj.dt?.[0]?.file?.id || '');
+            }
+            else if (mtype === 2) {
+                tag = '0';
+                content = '[图片]';
+                mkind = 64;
+                titleDt = [];
+                fileIds = String(msgObj.dt?.[0]?.img?.src || msgObj.dt?.[0]?.img?.id || '');
+            }
+            else if (mtype === 7) {
+                tag = '1';
+                content = '[视频]';
+                mkind = 2048;
+                titleDt = [];
+                fileIds = String(msgObj.dt?.[0]?.media?.src || msgObj.dt?.[0]?.media?.id || '');
+            }
+            else {
+                tag = '3';
+                content = msgObj.dt?.[0]?.txt?.v || '';
+                mkind = 1;
+                titleDt = [{ txt: { v: content } }];
+            }
+            msgEntity = JSON.stringify({ ...msgObj, tf: '1' });
+            msgTitle = JSON.stringify({ sname: myName, suid: myUid, scid: myCid, display: '0', type: String(mtype), dt: titleDt, vv: '', des: '', tf: '1' });
+            extraInfo = JSON.stringify({ msgSource: { source: { tag, msgid: String(plan.convertMsgid), flag: plan.groupId ? 1 : 0, ...(plan.groupId ? { group_id: plan.groupId } : { user: { cid: plan.toCid, uid: plan.toUid } }) } } });
+        }
+        else {
+            // 普通必达
+            content = plan.txt;
+            mkind = 1;
+            msgEntity = JSON.stringify({
+                ver: '1.0', dev: 5, guid: '0', cnt: '0', idx: '0',
+                sname: myName, suid: myUid, scid: myCid, display: '', sysId: '', weaOaId: '', bgc: '',
+                type: '1', dt: [{ txt: { v: plan.txt, next: '0', ft: 'china' } }], tf: '1',
+            });
+            msgTitle = JSON.stringify({ sname: myName, suid: myUid, scid: myCid, display: '0', type: '1', dt: [{ txt: { v: plan.txt, next: '0', ft: 'china' } }], vv: '', des: '', tf: '1' });
+        }
+        // 接收人
+        if (plan.groupId) {
+            targetType = 2;
+            targetId = plan.groupId;
+            // 接收人已在 prepare 阶段解析并写入快照（用户确认的就是这批人）
+            groupUsers = Array.isArray(plan.groupUsers) ? plan.groupUsers : [];
+            receiveUserIds = str(plan.receiveUserIds) || groupUsers.map((u) => u.uid).join(',');
+            if (!receiveUserIds)
+                throw ymbValidationError('members_empty', '群内没有可接收必达消息的成员');
+        }
+        else {
+            targetType = 1;
+            const toUid = plan.toUid;
+            targetId = `${myUid}|${toUid}`;
+            receiveUserIds = toUid;
+        }
+        const body = compact({
+            content,
+            receiveUserIds,
+            fileIds,
+            sendMsg: plan.sendMsg,
+            showType: plan.showType,
+            mkind,
+            msgEntity,
+            msgTitle,
+            targetType,
+            targetId,
+            groupUsers,
+            extraInfo: extraInfo || undefined,
+        });
+        const res = await env.host.request({
+            method: 'POST',
+            path: '/api/em/msg/createDing',
+            body,
+            operation: 'yimiaoban.ding.send',
+        });
+        const code = Number(res?.code ?? -1);
+        if (code !== 200 || !res?.status) {
+            throw ymbValidationError('ding_failed', `必达发送失败：code=${code} msg=${res?.msg ?? ''}`, { code });
+        }
+        return { id: str(res?.data?.id ?? ''), msg: res?.data?.msg ?? '' };
+    },
+});
+function buildMsgWriteDefinition(name, method, summary, inputProps, pair) {
+    const requiredInput = Object.keys(inputProps).filter((k) => {
+        const prop = inputProps[k];
+        return prop?.required === true;
+    });
+    return [
+        {
+            name: `${name}.prepare`,
+            resource: 'msg',
+            method: `${method}.prepare`,
+            action: `${name}.prepare`,
+            summary: `${summary}（prepare：只读校验 + 差异摘要 + 签发确认）`,
+            capability: 'msg',
+            risk: 'read-before-write',
+            requiresConfirmation: true,
+            inputSchema: schemaOf(inputProps, { required: requiredInput, description: summary }),
+            handler: pair.prepare,
+        },
+        {
+            name: `${name}.apply`,
+            resource: 'msg',
+            method: `${method}.apply`,
+            action: `${name}.apply`,
+            summary: `${summary}（apply：需 confirm:true + continuation）`,
+            capability: 'msg',
+            risk: 'high-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 msgWriteOps = [
+    ...buildMsgWriteDefinition('yimiaoban.msg.send.single', 'msg.send.single', '发送单聊消息（文本/图片/文件）', {
+        toUid: { type: 'string', pattern: '^\\d+$', description: '接收人 uid' },
+        toCid: { type: 'string', pattern: '^\\d+$', description: '接收人 cid' },
+        txt: { type: 'string', description: '文本内容' },
+        img: { type: 'string', description: '本地图片路径（发送前会上传到 E10 文件服务）' },
+        file: { type: 'string', description: '本地文件路径' },
+    }, sendSinglePair),
+    ...buildMsgWriteDefinition('yimiaoban.msg.send.group', 'msg.send.group', '发送群聊消息（文本/图片/文件）', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        txt: { type: 'string', description: '文本内容' },
+        img: { type: 'string', description: '本地图片路径' },
+        file: { type: 'string', description: '本地文件路径' },
+    }, sendGroupPair),
+    ...buildMsgWriteDefinition('yimiaoban.msg.withdraw', 'msg.withdraw', '撤回消息（单聊/群聊，限本人 2 分钟内）', {
+        type: { type: 'string', enum: ['single', 'group'], description: 'single 或 group' },
+        msgid: { type: 'string', pattern: '^\\d+$', description: '消息 id（ser_msgid）' },
+        toUid: { type: 'string', pattern: '^\\d+$', description: '单聊：对方 uid' },
+        toCid: { type: 'string', pattern: '^\\d+$', description: '单聊：对方 cid' },
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群聊：群 id' },
+    }, withdrawPair),
+    ...buildMsgWriteDefinition('yimiaoban.msg.top.set', 'msg.top.set', '群消息置顶 / 取消置顶', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
+        msgid: { type: 'string', pattern: '^\\d+$', description: '目标消息 id' },
+        type: { type: 'integer', enum: [1, 2], description: '1 置顶 / 2 取消' },
+        cancel: { type: 'boolean', description: '等价 type=2' },
+    }, topSetPair),
+    ...buildMsgWriteDefinition('yimiaoban.ding.send', 'ding.send', '发送必达消息 / 已有消息转必达（createDing）', {
+        groupId: { type: 'string', pattern: '^\\d+$', description: '群场景群 id' },
+        toUid: { type: 'string', pattern: '^\\d+$', description: '单聊场景对方 uid' },
+        toCid: { type: 'string', pattern: '^\\d+$', description: '单聊转必达对方 cid' },
+        txt: { type: 'string', description: '普通必达文本' },
+        convertMsgid: { type: 'string', pattern: '^\\d+$', description: '转必达源消息 id' },
+        unreadOnly: { type: 'boolean', description: '群转必达仅发给未读人员' },
+        toUids: { type: 'array', items: { type: 'string' }, description: '指定接收人 uid' },
+        sendMsg: { type: 'integer', enum: [0, 1], description: '发短信（默认 1 发）' },
+        showType: { type: 'integer', enum: [0, 1], description: '0 全体可见（默认）/1 仅发送人可见' },
+    }, dingSendPair),
+];
+export const msgWriteOperations = msgWriteOps;