weaver-work-cli 0.1.31 → 0.1.33

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

@@ -1,6 +1,6 @@
 import { imValidationError } from '../errors.js';
 import { schemaOf, WRITE, } from './types.js';
-import { assertImOk, compact, splitIds, str, toUint, unwrapInner } from './shared.js';
+import { assertImOk, compact, extractGroupMembers, isSystemMember, splitIds, str, toUint, unwrapInner } from './shared.js';
 import { makeWritePair } from './write-util.js';
 /** 解析 uid 列表为 {cid,uid} 成员，支持 failed 移除。 */
 async function resolveMembers(args, env) {
@@ -59,7 +59,7 @@ const groupCreatePair = makeWritePair({
         }
         const { users, failed, names: resolvedNames } = await resolveMembers(args, env);
         if (failed.length && args.removeFailed !== true) {
-            throw imValidationError('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`, failed);
         }
         if (users.length === 0)
             throw imValidationError('members_empty', '没有可入群的成员');
@@ -98,6 +98,8 @@ const groupCreatePair = makeWritePair({
                 members: users.map((u) => u.uid),
                 adminCount: admins.length,
                 removeFailed: args.removeFailed === true ? failed.map((f) => f.uid) : [],
+                /** 服务端可选能力：建群时会自动补入系统成员（cid=10002），实际成员数可能比 users 多 1。 */
+                systemMemberNote: '建群后服务端可能自动补入 1 个系统成员（cid=10002，群内系统消息载体，租户侧可选开启）；它不是真实员工，也不是本次传入的成员，不需要也不建议单独踢出。',
             },
             snapshot: { name, users, admins, failed, removeFailed: args.removeFailed === true },
         };
@@ -194,28 +196,29 @@ const groupExitPair = makeWritePair({
         if (!groupId || groupId === '0')
             throw imValidationError('id_invalid', 'groupId 必须非 0');
         /**
-         * 只读回查群人数与群主：实测「群主/最后一个成员退群」后该群会变成无主空群，
+         * 只读回查群主与真实人数：实测「群主/最后一个真实成员退群」后该群会变成无主空群，
          * 之后 join / destroy 都会被服务端拒绝（1210），必须由客户端或管理员处理。
          * 因此这两种情形要求调用方显式传 acknowledgeOrphanRisk:true 才签发 continuation。
+         *
+         * 群主判定只认 **成员列表的 role=3**（getGroupUsers）：group/queryGroupInfo 的 host_uid
+         * 是「群创建者」，转让群主后不会更新，用它判群主会误判（实测已复现）。
          */
         let memberCount;
         let isOwner = false;
         try {
-            const infoRes = await env.host.request({
+            const usersRes = 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',
+                path: '/api/em/msg/executeIm/group/getGroupUsers',
+                body: { group_id: groupId, type: 0, sync_type: 0, member_mask: 142, client_uc: '0' },
+                operation: 'im.group.exit.plan.members',
             });
-            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);
-                }
+            const members = extractGroupMembers(unwrapInner(usersRes));
+            if (members.length) {
+                const self = await env.host.getSelfIdentity();
+                const selfRow = members.find((m) => str(m?.uid) === String(self.uid));
+                isOwner = Number(selfRow?.role_type ?? selfRow?.role ?? -1) === 3;
+                // 系统成员（cid=10002，产品可选能力）不是真实成员，不能算进「是否只剩自己」
+                memberCount = members.filter((m) => !isSystemMember(m)).length;
             }
         }
         catch {
@@ -223,7 +226,7 @@ const groupExitPair = makeWritePair({
         }
         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 } });
+            throw imValidationError('owner_exit_ack_required', `退群风险确认缺失：${isOwner ? '你是该群群主' : '你是该群最后一个成员'}，退群后该群会变成无主空群，之后 join/destroy 都会被服务端拒绝（1210），只能由客户端或管理员处理。确认仍要退群请传 acknowledgeOrphanRisk:true`, { groupId, isOwner, memberCount });
         }
         return {
             summary: {
@@ -537,12 +540,16 @@ const groupAnnounceModifyPair = makeWritePair({
         };
     },
 });
-function buildWriteDefinition(name, method, summary, inputProps, pair) {
+function buildWriteDefinition(name, method, summary, inputProps, pair, condition = {}) {
     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 });
+    const prepareSchema = schemaOf({ ...inputProps, removeFailed: { type: 'boolean', description: '确认移除解析失败成员' } }, {
+        ...condition,
+        required: [...new Set([...(condition.required || []), ...requiredInput])],
+        description: summary,
+    });
     return [
         {
             name: `${name}.prepare`,
@@ -579,30 +586,30 @@ const groupWriteOps = [
         name: { type: 'string', description: '群名（缺省自动生成）' },
         names: { type: 'array', items: { type: 'string' }, description: '与 users 顺序对应姓名（用于默认群名）' },
         admins: { type: 'array', items: { type: 'string' }, description: '管理员 uid' },
-    }, groupCreatePair),
+    }, groupCreatePair, { required: ['users'] }),
     ...buildWriteDefinition('im.group.invite', 'group.invite', '邀请成员入群', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         users: { type: 'array', items: { type: 'string' }, description: '被邀请 uid' },
-    }, groupInvitePair),
+    }, groupInvitePair, { required: ['groupId', 'users'] }),
     ...buildWriteDefinition('im.group.kick', 'group.kick', '踢出群成员', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         users: { type: 'array', items: { type: 'string' }, description: '被踢 uid' },
-    }, groupKickPair),
+    }, groupKickPair, { required: ['groupId', 'users'] }),
     ...buildWriteDefinition('im.group.exit', 'group.exit', '退出群聊', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         acknowledgeOrphanRisk: {
             type: 'boolean',
             description: '群主或最后一个成员退群时必须显式传 true（退群后该群会变成无主空群，无法再 join/destroy）',
         },
-    }, groupExitPair),
+    }, groupExitPair, { required: ['groupId'] }),
     ...buildWriteDefinition('im.group.destroy', 'group.destroy', '解散群聊（仅群主，不可恢复）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
-    }, groupDestroyPair),
+    }, groupDestroyPair, { required: ['groupId'] }),
     ...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),
+    }, groupJoinPair, { requiredAny: ['groupId', 'token'] }),
     ...buildWriteDefinition('im.group.modify', 'group.modify', '批量修改群属性（batModGroupInfo）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         num: { type: 'integer', description: '最大人数' },
@@ -614,7 +621,7 @@ const groupWriteOps = [
         creator: { type: 'string', description: '转让群主（单 uid）' },
         copyGroupids: { type: 'array', items: { type: 'string' }, description: '拷贝群列表' },
         gtId: { type: 'string', description: '关联群类型 id' },
-    }, groupModifyPair),
+    }, groupModifyPair, { required: ['groupId'] }),
     ...buildWriteDefinition('im.group.rename', 'group.rename', '修改群信息（一次一项：群名/历史/群主/显示/打扰/标记/gtid）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         name: { type: 'string', description: '改群名' },
@@ -624,7 +631,7 @@ const groupWriteOps = [
         msgSetting: { type: 'integer', description: '消息打扰设置' },
         mark: { type: 'integer', description: '标记位' },
         gtid: { type: 'string', description: 'GTID' },
-    }, groupRenamePair),
+    }, groupRenamePair, { required: ['groupId'] }),
     ...buildWriteDefinition('im.group.announce.modify', 'group.announce.modify', '新增/修改/删除群公告', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         annouce: { type: 'string', description: '公告内容（删除时不需要）' },
@@ -633,6 +640,6 @@ const groupWriteOps = [
         notice: { type: 'integer', enum: [0, 1, 2], description: '0 发通知(默认)/1 不发/2 发并@全体' },
         fmark: { type: 'integer', enum: [0, 1], description: '新人必看' },
         related: { type: 'string', description: '关联附件 id' },
-    }, groupAnnounceModifyPair),
+    }, groupAnnounceModifyPair, { required: ['groupId'] }),
 ];
 export const groupWriteOperations = groupWriteOps;

package/dist/shortcuts/im/operations/msg-sync.js

@@ -2,6 +2,7 @@ import { imValidationError } from '../errors.js';
 import { READ, schemaOf, imSuccess, } from './types.js';
 import { assertImOk, clampTimeRangeTo7Days, compact, DEFAULT_PAGE_SIZE, formatFullTime, makeMinMaxIdByTm, paginationMeta, parseMsg, parseTimeToSec, pullPaged, rangeShrinkMeta, resolveAuthUid, sortMessagesNewestFirst, str, todayRange, unwrapInner, } from './shared.js';
 import { collapseNewlines, collectI18nIds, collectPersonIds, extractFiles, extractImgs, extractVideos, parseContent, senderName, } from './msg-parse.js';
+import { extractQuoteSummary } from './quote-mention.js';
 const MAX_MSG_ID = String((1n << 63n) - 1n);
 /**
  * 时间/最新/显式 id 计算 start/end（与源 skill 一致）：
@@ -151,6 +152,7 @@ async function enrichMessages(rawRows, host, options = {}) {
             });
         }
         const sender = senderName(msgObj || {}, row.from_uid, options.authUid, nameMap);
+        const quoteSummary = extractQuoteSummary(msgObj);
         enriched.push({
             msgid: str(row.ser_msgid),
             sender,
@@ -161,6 +163,9 @@ async function enrichMessages(rawRows, host, options = {}) {
             typeName: parsed.typeName,
             title: options.titleFirst ? parsed.title : undefined,
             content: collapseNewlines(parsed.content),
+            ...(quoteSummary
+                ? { quote: quoteSummary, quoteTime: Number(quoteSummary.msgtime) > 0 ? formatFullTime(Math.floor(Number(quoteSummary.msgtime) / 1000)) : undefined }
+                : {}),
             must: parsed.must,
             fileName: parsed.fileName,
             media,
@@ -401,7 +406,7 @@ const msgReadSingle = {
         toCid: { type: 'string', pattern: '^\\d+$', description: '对方 cid' },
         msgids: { type: 'array', items: { type: 'string' }, description: '自己发出的消息 id（最多 50）' },
         recvMsgids: { type: 'array', items: { type: 'string' }, description: '自己接收的消息 id（最多 50）' },
-    }, { required: ['toUid', 'toCid'], description: '查询单聊阅读状态（msgids/recvMsgids 至少其一）' }),
+    }, { required: ['toUid', 'toCid'], requiredAny: ['msgids', 'recvMsgids'], description: '查询单聊阅读状态（msgids / recvMsgids 至少其一）' }),
     handler: async (args, { host }) => {
         const hasSent = Array.isArray(args.msgids) && args.msgids.length > 0;
         const hasRecv = Array.isArray(args.recvMsgids) && args.recvMsgids.length > 0;
@@ -449,7 +454,7 @@ const msgReadGroup = {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
         msgids: { type: 'array', items: { type: 'string' }, description: '自己发出的消息 id（最多 50）' },
         recvMsgids: { type: 'array', items: { type: 'string' }, description: '别人发出的消息 id（最多 50）' },
-    }, { required: ['groupId'], description: '查询群消息阅读状态' }),
+    }, { required: ['groupId'], requiredAny: ['msgids', 'recvMsgids'], description: '查询群消息阅读状态（msgids / recvMsgids 至少其一）' }),
     handler: async (args, { host }) => {
         const hasSent = Array.isArray(args.msgids) && args.msgids.length > 0;
         const hasRecv = Array.isArray(args.recvMsgids) && args.recvMsgids.length > 0;

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

@@ -3,6 +3,8 @@ import { resolve } from 'node:path';
 import { imValidationError } from '../errors.js';
 import { schemaOf, } from './types.js';
 import { assertImOk, compact, extractGroupMembers, str } from './shared.js';
+import { buildAtMsgJson, buildAtText, hasAtInput, resolveAtMentions } from './at-mention.js';
+import { hasQuoteInput, resolveQuotedRef } from './quote-mention.js';
 import { fileObjToFile, fileObjToImg, makeWritePair } from './write-util.js';
 /** 校验本地文件存在，返回绝对路径。 */
 function assertLocalFile(pathValue, field) {
@@ -37,7 +39,18 @@ const sendSinglePair = makeWritePair({
         if (!toUid || !toCid || toUid === '0' || toCid === '0') {
             throw imValidationError('id_invalid', 'toUid/toCid 必须非 0');
         }
+        if (hasAtInput(args)) {
+            throw imValidationError('at_not_supported', '@ 提及仅群聊消息支持（单聊发送不接受 atAll/atUids）');
+        }
+        if (args.replyMsgId !== undefined && args.replyMsgId !== null && args.replyMsgId !== '') {
+            throw imValidationError('reply_not_supported', '单聊仅支持引用（quoteMsgId），不支持回复（replyMsgId）');
+        }
         const content = normalizeContent(args);
+        // 引用（仅单聊·文本）：prepare 阶段在单聊会话内定位被引消息并组装 ref
+        const quote = hasQuoteInput(args) ? await resolveQuotedRef(args, env, { toUid, toCid }) : null;
+        if (quote && !content.txt) {
+            throw imValidationError('quote_requires_txt', 'quoteMsgId 仅支持文本消息（txt）');
+        }
         const summary = {
             action: '发送单聊消息',
             toUid,
@@ -51,6 +64,11 @@ const sendSinglePair = makeWritePair({
             snapshot.txt = content.txt;
             summary.textPreview = content.txt.length > 60 ? `${content.txt.slice(0, 60)}…` : content.txt;
         }
+        if (quote) {
+            snapshot.quoteKind = quote.kind;
+            snapshot.quoteRef = quote.ref;
+            summary.quote = { kind: quote.kind, quotedMsgId: quote.quotedMsgId, fromName: quote.fromName, textPreview: quote.text.length > 40 ? `${quote.text.slice(0, 40)}…` : quote.text };
+        }
         if (content.imgPath) {
             const abs = assertLocalFile(content.imgPath, 'img');
             snapshot.imgPath = abs;
@@ -65,8 +83,15 @@ const sendSinglePair = makeWritePair({
     },
     async execute(plan, env) {
         const body = { reciver: { cid: plan.toCid, uid: plan.toUid } };
-        if (plan.txt !== undefined)
+        const quoteRef = plan.quoteRef ?? null;
+        if (quoteRef) {
+            // 引用：完整原生 msg JSON 走 msg 字段（与群聊同款承载方式，实测单聊同样生效）
+            const self = await env.host.getSelfIdentity();
+            body.msg = buildAtMsgJson(String(plan.txt ?? ''), [], self, { ref: quoteRef });
+        }
+        else 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);
@@ -93,12 +118,31 @@ const sendGroupPair = makeWritePair({
         if (!groupId || groupId === '0')
             throw imValidationError('id_invalid', 'groupId 必须非 0');
         const content = normalizeContent(args);
+        // @ 提及（仅群聊）：@具体人必须在群内（prepare 阶段逐个核实），@所有人走服务端固定 id=88
+        const atEntries = await resolveAtMentions(args, env, groupId);
+        if (atEntries.length && !content.txt) {
+            throw imValidationError('at_requires_txt', 'atAll/atUids 仅支持文本消息（txt）');
+        }
+        // 引用/回复（仅群聊文本）：prepare 阶段定位被引消息并组装 ref/rmsg
+        const quote = hasQuoteInput(args) ? await resolveQuotedRef(args, env, { groupId }) : null;
+        if (quote && !content.txt) {
+            throw imValidationError('quote_requires_txt', 'quoteMsgId/replyMsgId 仅支持文本消息（txt）');
+        }
         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 (atEntries.length) {
+            snapshot.atEntries = atEntries;
+            summary.at = atEntries.map((e) => (e.t === '2' ? { target: 'ALL', name: e.nm, id: e.id } : { uid: e.id, cid: e.cid, name: e.nm }));
+        }
+        if (quote) {
+            snapshot.quoteKind = quote.kind;
+            snapshot.quoteRef = quote.ref;
+            summary.quote = { kind: quote.kind, quotedMsgId: quote.quotedMsgId, fromName: quote.fromName, textPreview: quote.text.length > 40 ? `${quote.text.slice(0, 40)}…` : quote.text };
+        }
         if (content.imgPath) {
             const abs = assertLocalFile(content.imgPath, 'img');
             snapshot.imgPath = abs;
@@ -113,8 +157,17 @@ const sendGroupPair = makeWritePair({
     },
     async execute(plan, env) {
         const body = { groupId: plan.groupId };
-        if (plan.txt !== undefined)
+        const atEntries = Array.isArray(plan.atEntries) ? plan.atEntries : [];
+        const quoteRef = plan.quoteRef ?? null;
+        if (atEntries.length || quoteRef) {
+            // @ / 引用 / 回复：完整原生 msg JSON 走 msg 字段（txt 字段无法携带 aus/ref，实测会被当纯文本展示）
+            const { v, aus } = buildAtText(String(plan.txt ?? ''), atEntries);
+            const self = await env.host.getSelfIdentity();
+            body.msg = buildAtMsgJson(v, aus, self, quoteRef ? { [plan.quoteKind === 'reply' ? 'rmsg' : 'ref']: quoteRef } : {});
+        }
+        else 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);
@@ -516,7 +569,7 @@ const dingSendPair = makeWritePair({
         return { id: str(res?.data?.id ?? ''), msg: res?.data?.msg ?? '' };
     },
 });
-function buildMsgWriteDefinition(name, method, summary, inputProps, pair) {
+function buildMsgWriteDefinition(name, method, summary, inputProps, pair, condition = {}) {
     const requiredInput = Object.keys(inputProps).filter((k) => {
         const prop = inputProps[k];
         return prop?.required === true;
@@ -531,7 +584,7 @@ function buildMsgWriteDefinition(name, method, summary, inputProps, pair) {
             capability: 'msg',
             risk: 'read-before-write',
             requiresConfirmation: true,
-            inputSchema: schemaOf(inputProps, { required: requiredInput, description: summary }),
+            inputSchema: schemaOf(inputProps, { required: requiredInput, ...condition, description: summary }),
             handler: pair.prepare,
         },
         {
@@ -552,19 +605,27 @@ function buildMsgWriteDefinition(name, method, summary, inputProps, pair) {
     ];
 }
 const msgWriteOps = [
-    ...buildMsgWriteDefinition('im.msg.send.single', 'msg.send.single', '发送单聊消息（文本/图片/文件）', {
+    ...buildMsgWriteDefinition('im.msg.send.single', 'msg.send.single', '发送单聊消息（文本/图片/文件，文本支持引用）', {
         toUid: { type: 'string', pattern: '^\\d+$', description: '接收人 uid' },
         toCid: { type: 'string', pattern: '^\\d+$', description: '接收人 cid' },
         txt: { type: 'string', description: '文本内容' },
+        quoteMsgId: { type: 'string', pattern: '^\\d+$', description: '引用该消息（单聊仅支持引用，不支持回复；仅 txt 文本消息）；传单聊会话内消息 id（ser_msgid），prepare 阶段自动定位并组装 ref' },
         img: { type: 'string', description: '本地图片路径（发送前会上传到 E10 文件服务）' },
         file: { type: 'string', description: '本地文件路径' },
-    }, sendSinglePair),
-    ...buildMsgWriteDefinition('im.msg.send.group', 'msg.send.group', '发送群聊消息（文本/图片/文件）', {
+    }, sendSinglePair, {
+        required: ['toUid', 'toCid'],
+        requiredAny: ['txt', 'img', 'file'],
+    }),
+    ...buildMsgWriteDefinition('im.msg.send.group', 'msg.send.group', '发送群聊消息（文本/图片/文件，文本支持 @ 提及与引用/回复）', {
         groupId: { type: 'string', pattern: '^\\d+$', description: '群 id' },
-        txt: { type: 'string', description: '文本内容' },
+        txt: { type: 'string', description: '文本内容；@ 位置直接写 @<姓名>（如 @张三）或 @全体成员/@所有人' },
+        atAll: { type: 'boolean', description: '@全体成员（服务端固定 id=88），仅群聊、仅 txt 文本消息生效' },
+        atUids: { type: 'array', items: { type: 'string' }, description: '@具体人 uid 列表，仅群聊；prepare 阶段会逐个核实是否在群内，不在群内则拒绝发送' },
+        quoteMsgId: { type: 'string', pattern: '^\\d+$', description: '引用该消息（与 replyMsgId 互斥，仅群聊、仅 txt 文本消息）；传消息 id（ser_msgid），prepare 阶段自动定位被引消息并组装 ref' },
+        replyMsgId: { type: 'string', pattern: '^\\d+$', description: '回复该消息（与 quoteMsgId 互斥，仅群聊、仅 txt 文本消息）；传消息 id（ser_msgid），prepare 阶段自动定位被引消息并组装 rmsg' },
         img: { type: 'string', description: '本地图片路径' },
         file: { type: 'string', description: '本地文件路径' },
-    }, sendGroupPair),
+    }, sendGroupPair, { required: ['groupId'], requiredAny: ['txt', 'img', 'file'] }),
     ...buildMsgWriteDefinition('im.msg.withdraw', 'msg.withdraw', '撤回消息（单聊/群聊，限本人 2 分钟内）', {
         type: { type: 'string', enum: ['single', 'group'], description: 'single 或 group' },
         msgid: { type: 'string', pattern: '^\\d+$', description: '消息 id（ser_msgid）' },
@@ -588,6 +649,11 @@ const msgWriteOps = [
         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),
+    }, dingSendPair, {
+        allOf: [
+            { anyOf: [{ required: ['groupId'] }, { required: ['toUid'] }] },
+            { anyOf: [{ required: ['txt'] }, { required: ['convertMsgid'] }] },
+        ],
+    }),
 ];
 export const msgWriteOperations = msgWriteOps;

package/dist/shortcuts/im/operations/quote-mention.js

@@ -0,0 +1,119 @@
+import { imValidationError } from '../errors.js';
+import { assertImOk, str, unwrapInner } from './shared.js';
+import { parseContent, parseMsg } from './msg-parse.js';
+/** 调用方是否带了引用/回复入参。 */
+export function hasQuoteInput(args) {
+    return args.quoteMsgId !== undefined || args.replyMsgId !== undefined;
+}
+/** 解析被引消息 id（纯数字、非 0）。 */
+function quotedId(value) {
+    const id = str(value);
+    if (!id || !/^\d+$/.test(id) || id === '0') {
+        throw imValidationError('quote_id_invalid', 'quoteMsgId/replyMsgId 必须是非 0 的纯数字消息 id');
+    }
+    return id;
+}
+/** 从消息对象提取被引内容纯文本（txt 渲染 / [图片] / [文件]名）。 */
+function quotedContentText(msgObj) {
+    if (!msgObj)
+        return '';
+    const parsed = parseContent(msgObj);
+    return str(parsed.content).trim();
+}
+/**
+ * prepare 阶段解析引用/回复入参：定位被引消息并组装 ref/rmsg 对象。
+ * - quoteMsgId 与 replyMsgId 互斥（quote_conflict）；
+ * - 被引消息拉不到/找不到时报 quote_msg_not_found；
+ * - 被引人姓名走 hrm（resolveUsersByIds），回落消息内嵌 sname。
+ */
+export async function resolveQuotedRef(args, env, target) {
+    const hasQuote = args.quoteMsgId !== undefined && args.quoteMsgId !== null && args.quoteMsgId !== '';
+    const hasReply = args.replyMsgId !== undefined && args.replyMsgId !== null && args.replyMsgId !== '';
+    if (hasQuote && hasReply) {
+        throw imValidationError('quote_conflict', 'quoteMsgId（引用）与 replyMsgId（回复）只能二选一');
+    }
+    if (!hasQuote && !hasReply)
+        return null;
+    const kind = hasQuote ? 'quote' : 'reply';
+    const msgId = quotedId(hasQuote ? args.quoteMsgId : args.replyMsgId);
+    const isSingle = !target.groupId;
+    if (isSingle && (!target.toUid || !target.toCid)) {
+        throw imValidationError('quote_target_required', '单聊引用需要 toUid + toCid 才能定位被引消息');
+    }
+    const scopeLabel = isSingle ? `与 ${target.toUid} 的单聊` : `群 ${target.groupId}`;
+    let rows = [];
+    try {
+        // 单条定位：id ± 1 秒（id 为纳秒级时间戳，开边界语义）
+        const idBig = BigInt(msgId);
+        const window = { start: String(idBig + 1000000000n), end: String(idBig - 1000000000n), max_num: 5 };
+        const res = isSingle
+            ? await env.host.request({
+                method: 'POST',
+                path: '/api/em/msg/executeIm/msg/syncSingleMsg',
+                body: { trans_id: 0, dev: 4, enc_type: 0, datas: [{ from_cid: String(target.toCid), from_uid: String(target.toUid), ...window }] },
+                operation: 'im.msg.send.single.quoteResolve',
+            })
+            : await env.host.request({
+                method: 'POST',
+                path: '/api/em/msg/executeIm/chat/syncGroupMsg',
+                body: { trans_id: 0, dev: 4, type: 0, enc_type: 0, datas: [{ group_id: String(target.groupId), ...window }] },
+                operation: 'im.msg.send.group.quoteResolve',
+            });
+        assertImOk(res, '定位被引消息');
+        const outer = unwrapInner(res)?.datas || [];
+        for (const group of outer)
+            rows.push(...(group?.datas || group?.data || []));
+    }
+    catch (error) {
+        throw imValidationError('quote_msg_not_found', `无法定位被引消息 ${msgId}：${error instanceof Error ? error.message : String(error)}`, { ...target, quotedMsgId: msgId });
+    }
+    const row = rows.find((r) => str(r?.ser_msgid) === msgId);
+    if (!row) {
+        throw imValidationError('quote_msg_not_found', `消息 ${msgId} 不在${scopeLabel}内（或已被撤回），无法引用`, {
+            ...target,
+            quotedMsgId: msgId,
+        });
+    }
+    const msgObj = parseMsg(row.msg);
+    const fromUid = str(row.from_uid) || str(msgObj?.suid);
+    const fromCid = str(row.from_cid) || str(msgObj?.scid);
+    let fromName = str(msgObj?.sname);
+    if (fromUid) {
+        try {
+            const personMap = await env.host.resolveUsersByIds([fromUid]);
+            fromName = personMap[fromUid]?.name || fromName;
+        }
+        catch {
+            // hrm 失败时回落消息内嵌姓名
+        }
+    }
+    const ref = {
+        id: msgId,
+        t: str(msgObj?.type ?? row.kind ?? '1') || '1',
+        f: '0',
+        time: Number(row.msgtime) > 0 ? Number(row.msgtime) * 1000 : Date.now(),
+        fname: fromName || fromUid || '',
+        fuser: { cid: fromCid, uid: fromUid },
+        rcon: quotedContentText(msgObj),
+        display: '',
+        ...(kind === 'reply' ? { oid: msgId } : {}),
+    };
+    return { kind, quotedMsgId: msgId, fromName: ref.fname, fromUid, text: ref.rcon, ref };
+}
+/** 拉取侧：从消息对象提取顶层引用/回复摘要（msg.msg.ref / msg.msg.rmsg）。 */
+export function extractQuoteSummary(msgObj) {
+    const raw = msgObj ? (msgObj.rmsg ?? msgObj.ref) : undefined;
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const kind = msgObj?.rmsg ? 'reply' : 'quote';
+    return {
+        kind,
+        id: str(raw.id),
+        msgType: str(raw.t),
+        fromName: str(raw.fname),
+        fromUid: str(raw.fuser?.uid),
+        fromCid: str(raw.fuser?.cid),
+        msgtime: raw.time,
+        text: str(raw.rcon),
+    };
+}

package/dist/shortcuts/im/operations/session.js

@@ -241,7 +241,7 @@ const sysmsgTypeSync = {
     inputSchema: schemaOf({
         gids: { type: 'array', items: { type: 'integer' }, description: '系统分组 id（与 tids 至少其一）' },
         tids: { type: 'array', items: { type: 'integer' }, description: '消息类型 id' },
-    }, { description: 'gids / tids 至少其一' }),
+    }, { requiredAny: ['gids', 'tids'], description: '按 gids/tids 拉取系统消息分组/类型配置（至少其一）' }),
     handler: async (args, { host }) => {
         const gids = Array.isArray(args.gids) ? args.gids.map((x) => Number(x)).filter((n) => Number.isInteger(n)) : [];
         const tids = Array.isArray(args.tids) ? args.tids.map((x) => Number(x)).filter((n) => Number.isInteger(n)) : [];

package/dist/shortcuts/im/operations/shared.js

@@ -244,6 +244,16 @@ export function assertImOk(value, actionLabel) {
 export function unwrapInner(value) {
     return value?.data?.data ?? value?.data;
 }
+/**
+ * 服务端在建群/入群时自动补入的「系统成员」cid（群内系统消息的投递载体）。
+ * 属产品可选能力（租户侧可关闭），不是真实员工：姓名会回落成 uid，hrm 解析不到。
+ * 统计真实成员数、判断「是否只剩自己」时必须排除它。
+ */
+export const SYSTEM_MEMBER_CID = '10002';
+/** 是否服务端系统成员（非真实员工）。 */
+export function isSystemMember(member) {
+    return str(member?.cid) === SYSTEM_MEMBER_CID;
+}
 /** 群成员条目判定（成员行至少含 uid 或 user 身份）。 */
 function isMemberRow(value) {
     return Boolean(value) && typeof value === 'object' && (value.uid !== undefined || value.user !== undefined);

package/dist/shortcuts/im/operations/types.js

@@ -8,11 +8,24 @@ export function imSuccess(action, data, meta) {
 }
 /** 构造「对象类型 + 严格禁止额外字段」的 JSON Schema。 */
 export function schemaOf(properties, options = {}) {
+    const clauses = [];
+    if (options.requiredAny?.length)
+        clauses.push({ anyOf: options.requiredAny.map((key) => ({ required: [key] })) });
+    if (options.anyOf?.length)
+        clauses.push({ anyOf: options.anyOf });
+    if (options.allOf?.length)
+        clauses.push(...options.allOf);
+    const condition = clauses.length === 1
+        ? clauses[0]
+        : clauses.length > 1
+            ? { allOf: clauses }
+            : {};
     return {
         type: 'object',
         additionalProperties: false,
         properties,
         ...(options.required?.length ? { required: options.required } : {}),
+        ...condition,
         ...(options.description ? { description: options.description } : {}),
     };
 }

package/dist/shortcuts/index.js

@@ -35,6 +35,11 @@ export const builtinShortcuts = [
         description: '泛微E10聚才林（人事/出勤/薪酬）CLI',
         load: async () => (await import('./ehr/index.js')).ehrShortcut,
     }),
+    lazyShortcut({
+        name: 'cowork',
+        description: '泛微E10协作区（协作事项/讨论/审批/共享权限）CLI',
+        load: async () => (await import('./cowork/index.js')).coworkShortcut,
+    }),
     lazyShortcut({
         name: 'archive',
         description: 'E10 文书定档案管理 CLI',

package/dist/shortcuts/mail/host.js

@@ -96,7 +96,10 @@ function mailMessage(value) {
 export function createMailHost(ctx, dependencies = {}) {
     let e10Session = null;
     let sessionContext = null;
-    const requireSession = dependencies.requireSession || requireE10Session;
+    // 与 workflow 模块同口径（2026-10-29 实测）：auth 文件里已有登录时落盘的 userId，
+    // 业务命令不需要 teamsCheck 的登录人信息富化 ⇒ 跳过它，省掉每次调用一次串行 HTTPS 往返（实测约 150~250ms）。
+    const requireSession = dependencies.requireSession
+        || ((innerCtx) => requireE10Session(innerCtx, { skipProfileEnrichment: true }));
     async function ensureSession() {
         if (!e10Session) {
             e10Session = await requireSession(ctx);