weaver-work-cli 0.1.32 → 0.1.36

package/dist/chunks/{chunk-QWY6PGL6.js → chunk-2LV74IWP.js}

@@ -1,5 +1,10 @@
 import { createRequire as __esbuildCreateRequire } from 'node:module';
 const require = __esbuildCreateRequire(import.meta.url);
+import {
+  imBusinessError,
+  imConfirmationError,
+  imValidationError
+} from "./chunk-ZEDWSH32.js";
 import {
   collapseNewlines,
   collectI18nIds,
@@ -9,13 +14,9 @@ import {
   extractImgs,
   extractVideos,
   parseContent,
+  parseMsg,
   senderName
 } from "./chunk-YLCYX7LE.js";
-import {
-  imBusinessError,
-  imConfirmationError,
-  imValidationError
-} from "./chunk-ZEDWSH32.js";
 
 // src/shortcuts/im/operations/types.ts
 var READ = "read";
@@ -26,11 +27,17 @@ function imSuccess(action, data, meta) {
   return payload;
 }
 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 } : {}
   };
 }
@@ -202,6 +209,10 @@ function assertImOk(value, actionLabel) {
 function unwrapInner(value) {
   return value?.data?.data ?? value?.data;
 }
+var SYSTEM_MEMBER_CID = "10002";
+function isSystemMember(member) {
+  return str(member?.cid) === SYSTEM_MEMBER_CID;
+}
 function isMemberRow(value) {
   return Boolean(value) && typeof value === "object" && (value.uid !== void 0 || value.user !== void 0);
 }
@@ -326,7 +337,7 @@ function str(value) {
   if (value === void 0 || value === null) return "";
   return String(value);
 }
-function parseMsg(value) {
+function parseMsg2(value) {
   if (!value) return null;
   if (typeof value === "string") {
     try {
@@ -488,7 +499,7 @@ var groupInfo = {
   inputSchema: schemaOf({
     groupIds: { type: "array", items: { type: "string" }, description: "\u7FA4 id \u5217\u8868\uFF08\u9017\u53F7\u4E32\u6216\u6570\u7EC4\uFF09" },
     groupId: { type: "string", description: "\u5355\u7FA4 id\uFF08groupIds \u7684\u4FBF\u6377\u5F62\u5F0F\uFF09" }
-  }, { description: "groupIds / groupId \u81F3\u5C11\u5176\u4E00" }),
+  }, { requiredAny: ["groupIds", "groupId"], description: "\u6309\u7FA4 id \u67E5\u57FA\u7840\u4FE1\u606F\uFF08groupIds / groupId \u81F3\u5C11\u5176\u4E00\uFF09" }),
   handler: async (args, { host }) => {
     let ids = [];
     if (Array.isArray(args.groupIds)) ids = args.groupIds.map((x) => String(x));
@@ -516,12 +527,23 @@ var groupInfo = {
       maskName: maskTypeName(Number(g.mask ?? 0)),
       userNum: g.user_num,
       maxNum: g.max_num,
-      hostUid: str(g.host_uid ?? g.hostUid ?? ""),
+      /** 群创建者 uid（服务端字段 host_uid）；**不是群主**，群主以 group.users 的 role=3 为准。 */
+      creatorUid: str(g.host_uid ?? g.hostUid ?? ""),
+      /** 群创建者 cid（服务端字段 host_cid），与 creatorUid 配对。 */
+      creatorCid: str(g.host_cid ?? g.hostCid ?? ""),
       state: Number(g.state ?? -1),
       stateName: stateName(Number(g.state ?? -1)),
       createTime: formatFullTime(g.create_time ?? g.createTime)
     }));
-    return imSuccess("im.group.info", { total: groups.length, groups });
+    return imSuccess("im.group.info", {
+      total: groups.length,
+      groups,
+      fieldNotes: {
+        creatorUid: "\u7FA4\u521B\u5EFA\u8005\uFF08host_uid\uFF09\uFF0C\u4E0D\u662F\u7FA4\u4E3B\uFF1B\u521B\u5EFA\u540E\u8F6C\u8BA9\u7FA4\u4E3B\u4E5F\u4E0D\u4F1A\u53D8\u3002",
+        creatorCid: "\u7FA4\u521B\u5EFA\u8005 cid\uFF08host_cid\uFF09\u3002",
+        owner: "\u7FA4\u4E3B\u8BF7\u7528 im.group.users \u7684 role=3\uFF08\u6216 im.group.admins\uFF09\u83B7\u53D6\uFF0C\u4E0D\u8981\u7528 creatorUid \u5224\u65AD\u3002"
+      }
+    });
   }
 };
 var groupUsers = {
@@ -562,7 +584,7 @@ var groupUsers = {
     const hasCid = (memberMask & 2) !== 0;
     const hasUid = (memberMask & 4) !== 0;
     const roleNames = { 0: "\u4E0D\u53EF\u7528", 1: "\u666E\u901A\u6210\u5458", 2: "\u7BA1\u7406\u5458", 3: "\u7FA4\u4E3B", 4: "\u5BA2\u6237", 5: "\u8D1F\u8D23\u4EBA", 6: "\u534F\u52A9\u4EBA\u5458" };
-    const personIds = members.map((m) => String(m?.uid ?? "")).filter((x) => x && x !== "0");
+    const personIds = members.filter((m) => !isSystemMember(m)).map((m) => String(m?.uid ?? "")).filter((x) => x && x !== "0");
     const personMap = personIds.length ? await host.resolveUsersByIds([...new Set(personIds)]) : {};
     const rows = members.map((m) => ({
       uid: hasUid ? str(m.uid) : void 0,
@@ -570,11 +592,17 @@ var groupUsers = {
       name: personMap[str(m.uid)]?.name || str(m.uid),
       role: hasRole ? Number(m.role_type ?? m.role ?? -1) : void 0,
       roleName: hasRole ? roleNames[Number(m.role_type ?? m.role ?? -1)] ?? "-" : void 0,
-      addTime: hasAddTime ? formatFullTime(m.add_time ?? m.addTime) : void 0
+      addTime: hasAddTime ? formatFullTime(m.add_time ?? m.addTime) : void 0,
+      /** 服务端自动补入的系统成员（可选功能，不是真实员工），统计真实成员时排除。 */
+      isSystem: hasCid ? isSystemMember(m) : void 0
     }));
+    const personRows = rows.filter((row) => row.isSystem !== true);
     return imSuccess("im.group.users", {
       groupId,
+      /** 成员总数（含系统成员，即服务端返回的原始条数） */
       totalNum: inner?.total_num ?? rows.length,
+      /** 真实成员数（排除系统成员 cid=10002），判断「只剩自己」请用这个 */
+      personNum: personRows.length,
       endFlag: inner?.end_flag,
       serverUc: str(inner?.server_uc ?? ""),
       members: rows
@@ -910,7 +938,7 @@ var groupCreatePair = makeWritePair({
     }
     const { users, failed, names: resolvedNames } = await resolveMembers(args, env);
     if (failed.length && args.removeFailed !== true) {
-      throw imValidationError("members_resolve_failed", `\u4EE5\u4E0B\u6210\u5458\u4FE1\u606F\u83B7\u53D6\u5931\u8D25\uFF08cid/uid \u7F3A\u5931\u6216\u4E3A 0\uFF09\uFF1A${failed.map((f) => f.name || f.uid).join("\u3001")}\uFF1B\u786E\u8BA4\u79FB\u9664\u8BF7\u4F20 removeFailed:true`, { details: failed });
+      throw imValidationError("members_resolve_failed", `\u4EE5\u4E0B\u6210\u5458\u4FE1\u606F\u83B7\u53D6\u5931\u8D25\uFF08cid/uid \u7F3A\u5931\u6216\u4E3A 0\uFF09\uFF1A${failed.map((f) => f.name || f.uid).join("\u3001")}\uFF1B\u786E\u8BA4\u79FB\u9664\u8BF7\u4F20 removeFailed:true`, failed);
     }
     if (users.length === 0) throw imValidationError("members_empty", "\u6CA1\u6709\u53EF\u5165\u7FA4\u7684\u6210\u5458");
     const selfUid = str((await env.host.getSession()).userId);
@@ -950,7 +978,9 @@ var groupCreatePair = makeWritePair({
         memberCount: users.length,
         members: users.map((u) => u.uid),
         adminCount: admins.length,
-        removeFailed: args.removeFailed === true ? failed.map((f) => f.uid) : []
+        removeFailed: args.removeFailed === true ? failed.map((f) => f.uid) : [],
+        /** 服务端可选能力：建群时会自动补入系统成员（cid=10002），实际成员数可能比 users 多 1。 */
+        systemMemberNote: "\u5EFA\u7FA4\u540E\u670D\u52A1\u7AEF\u53EF\u80FD\u81EA\u52A8\u8865\u5165 1 \u4E2A\u7CFB\u7EDF\u6210\u5458\uFF08cid=10002\uFF0C\u7FA4\u5185\u7CFB\u7EDF\u6D88\u606F\u8F7D\u4F53\uFF0C\u79DF\u6237\u4FA7\u53EF\u9009\u5F00\u542F\uFF09\uFF1B\u5B83\u4E0D\u662F\u771F\u5B9E\u5458\u5DE5\uFF0C\u4E5F\u4E0D\u662F\u672C\u6B21\u4F20\u5165\u7684\u6210\u5458\uFF0C\u4E0D\u9700\u8981\u4E5F\u4E0D\u5EFA\u8BAE\u5355\u72EC\u8E22\u51FA\u3002"
       },
       snapshot: { name, users, admins, failed, removeFailed: args.removeFailed === true }
     };
@@ -1040,21 +1070,18 @@ var groupExitPair = makeWritePair({
     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 === void 0 || raw === null ? void 0 : 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;
+        memberCount = members.filter((m) => !isSystemMember(m)).length;
       }
     } catch {
     }
@@ -1063,7 +1090,7 @@ var groupExitPair = makeWritePair({
       throw imValidationError(
         "owner_exit_ack_required",
         `\u9000\u7FA4\u98CE\u9669\u786E\u8BA4\u7F3A\u5931\uFF1A${isOwner ? "\u4F60\u662F\u8BE5\u7FA4\u7FA4\u4E3B" : "\u4F60\u662F\u8BE5\u7FA4\u6700\u540E\u4E00\u4E2A\u6210\u5458"}\uFF0C\u9000\u7FA4\u540E\u8BE5\u7FA4\u4F1A\u53D8\u6210\u65E0\u4E3B\u7A7A\u7FA4\uFF0C\u4E4B\u540E join/destroy \u90FD\u4F1A\u88AB\u670D\u52A1\u7AEF\u62D2\u7EDD\uFF081210\uFF09\uFF0C\u53EA\u80FD\u7531\u5BA2\u6237\u7AEF\u6216\u7BA1\u7406\u5458\u5904\u7406\u3002\u786E\u8BA4\u4ECD\u8981\u9000\u7FA4\u8BF7\u4F20 acknowledgeOrphanRisk:true`,
-        { details: { groupId, isOwner, memberCount } }
+        { groupId, isOwner, memberCount }
       );
     }
     return {
@@ -1346,14 +1373,18 @@ var 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 prepareSchema2 = schemaOf(
     { ...inputProps, removeFailed: { type: "boolean", description: "\u786E\u8BA4\u79FB\u9664\u89E3\u6790\u5931\u8D25\u6210\u5458" } },
-    { required: requiredInput, description: summary }
+    {
+      ...condition,
+      required: [.../* @__PURE__ */ new Set([...condition.required || [], ...requiredInput])],
+      description: summary
+    }
   );
   return [
     {
@@ -1391,30 +1422,30 @@ var groupWriteOps = [
     name: { type: "string", description: "\u7FA4\u540D\uFF08\u7F3A\u7701\u81EA\u52A8\u751F\u6210\uFF09" },
     names: { type: "array", items: { type: "string" }, description: "\u4E0E users \u987A\u5E8F\u5BF9\u5E94\u59D3\u540D\uFF08\u7528\u4E8E\u9ED8\u8BA4\u7FA4\u540D\uFF09" },
     admins: { type: "array", items: { type: "string" }, description: "\u7BA1\u7406\u5458 uid" }
-  }, groupCreatePair),
+  }, groupCreatePair, { required: ["users"] }),
   ...buildWriteDefinition("im.group.invite", "group.invite", "\u9080\u8BF7\u6210\u5458\u5165\u7FA4", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     users: { type: "array", items: { type: "string" }, description: "\u88AB\u9080\u8BF7 uid" }
-  }, groupInvitePair),
+  }, groupInvitePair, { required: ["groupId", "users"] }),
   ...buildWriteDefinition("im.group.kick", "group.kick", "\u8E22\u51FA\u7FA4\u6210\u5458", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     users: { type: "array", items: { type: "string" }, description: "\u88AB\u8E22 uid" }
-  }, groupKickPair),
+  }, groupKickPair, { required: ["groupId", "users"] }),
   ...buildWriteDefinition("im.group.exit", "group.exit", "\u9000\u51FA\u7FA4\u804A", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     acknowledgeOrphanRisk: {
       type: "boolean",
       description: "\u7FA4\u4E3B\u6216\u6700\u540E\u4E00\u4E2A\u6210\u5458\u9000\u7FA4\u65F6\u5FC5\u987B\u663E\u5F0F\u4F20 true\uFF08\u9000\u7FA4\u540E\u8BE5\u7FA4\u4F1A\u53D8\u6210\u65E0\u4E3B\u7A7A\u7FA4\uFF0C\u65E0\u6CD5\u518D join/destroy\uFF09"
     }
-  }, groupExitPair),
+  }, groupExitPair, { required: ["groupId"] }),
   ...buildWriteDefinition("im.group.destroy", "group.destroy", "\u89E3\u6563\u7FA4\u804A\uFF08\u4EC5\u7FA4\u4E3B\uFF0C\u4E0D\u53EF\u6062\u590D\uFF09", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" }
-  }, groupDestroyPair),
+  }, groupDestroyPair, { required: ["groupId"] }),
   ...buildWriteDefinition("im.group.join", "group.join", "\u7533\u8BF7\u52A0\u5165\u7FA4\u804A", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id\uFF08token \u4E8C\u9009\u4E00\uFF09" },
     token: { type: "string", description: "\u7FA4 token/\u4E8C\u7EF4\u7801\u52A0\u5165" },
     mark: { type: "string", maxLength: 100, description: "\u7533\u8BF7\u7406\u7531" }
-  }, groupJoinPair),
+  }, groupJoinPair, { requiredAny: ["groupId", "token"] }),
   ...buildWriteDefinition("im.group.modify", "group.modify", "\u6279\u91CF\u4FEE\u6539\u7FA4\u5C5E\u6027\uFF08batModGroupInfo\uFF09", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     num: { type: "integer", description: "\u6700\u5927\u4EBA\u6570" },
@@ -1426,7 +1457,7 @@ var groupWriteOps = [
     creator: { type: "string", description: "\u8F6C\u8BA9\u7FA4\u4E3B\uFF08\u5355 uid\uFF09" },
     copyGroupids: { type: "array", items: { type: "string" }, description: "\u62F7\u8D1D\u7FA4\u5217\u8868" },
     gtId: { type: "string", description: "\u5173\u8054\u7FA4\u7C7B\u578B id" }
-  }, groupModifyPair),
+  }, groupModifyPair, { required: ["groupId"] }),
   ...buildWriteDefinition("im.group.rename", "group.rename", "\u4FEE\u6539\u7FA4\u4FE1\u606F\uFF08\u4E00\u6B21\u4E00\u9879\uFF1A\u7FA4\u540D/\u5386\u53F2/\u7FA4\u4E3B/\u663E\u793A/\u6253\u6270/\u6807\u8BB0/gtid\uFF09", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     name: { type: "string", description: "\u6539\u7FA4\u540D" },
@@ -1436,7 +1467,7 @@ var groupWriteOps = [
     msgSetting: { type: "integer", description: "\u6D88\u606F\u6253\u6270\u8BBE\u7F6E" },
     mark: { type: "integer", description: "\u6807\u8BB0\u4F4D" },
     gtid: { type: "string", description: "GTID" }
-  }, groupRenamePair),
+  }, groupRenamePair, { required: ["groupId"] }),
   ...buildWriteDefinition("im.group.announce.modify", "group.announce.modify", "\u65B0\u589E/\u4FEE\u6539/\u5220\u9664\u7FA4\u516C\u544A", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     annouce: { type: "string", description: "\u516C\u544A\u5185\u5BB9\uFF08\u5220\u9664\u65F6\u4E0D\u9700\u8981\uFF09" },
@@ -1445,10 +1476,112 @@ var groupWriteOps = [
     notice: { type: "integer", enum: [0, 1, 2], description: "0 \u53D1\u901A\u77E5(\u9ED8\u8BA4)/1 \u4E0D\u53D1/2 \u53D1\u5E76@\u5168\u4F53" },
     fmark: { type: "integer", enum: [0, 1], description: "\u65B0\u4EBA\u5FC5\u770B" },
     related: { type: "string", description: "\u5173\u8054\u9644\u4EF6 id" }
-  }, groupAnnounceModifyPair)
+  }, groupAnnounceModifyPair, { required: ["groupId"] })
 ];
 var groupWriteOperations = groupWriteOps;
 
+// src/shortcuts/im/operations/quote-mention.ts
+function hasQuoteInput(args) {
+  return args.quoteMsgId !== void 0 || args.replyMsgId !== void 0;
+}
+function quotedId(value) {
+  const id = str(value);
+  if (!id || !/^\d+$/.test(id) || id === "0") {
+    throw imValidationError("quote_id_invalid", "quoteMsgId/replyMsgId \u5FC5\u987B\u662F\u975E 0 \u7684\u7EAF\u6570\u5B57\u6D88\u606F id");
+  }
+  return id;
+}
+function quotedContentText(msgObj) {
+  if (!msgObj) return "";
+  const parsed = parseContent(msgObj);
+  return str(parsed.content).trim();
+}
+async function resolveQuotedRef(args, env, target) {
+  const hasQuote = args.quoteMsgId !== void 0 && args.quoteMsgId !== null && args.quoteMsgId !== "";
+  const hasReply = args.replyMsgId !== void 0 && args.replyMsgId !== null && args.replyMsgId !== "";
+  if (hasQuote && hasReply) {
+    throw imValidationError("quote_conflict", "quoteMsgId\uFF08\u5F15\u7528\uFF09\u4E0E replyMsgId\uFF08\u56DE\u590D\uFF09\u53EA\u80FD\u4E8C\u9009\u4E00");
+  }
+  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", "\u5355\u804A\u5F15\u7528\u9700\u8981 toUid + toCid \u624D\u80FD\u5B9A\u4F4D\u88AB\u5F15\u6D88\u606F");
+  }
+  const scopeLabel = isSingle ? `\u4E0E ${target.toUid} \u7684\u5355\u804A` : `\u7FA4 ${target.groupId}`;
+  let rows = [];
+  try {
+    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, "\u5B9A\u4F4D\u88AB\u5F15\u6D88\u606F");
+    const outer = unwrapInner(res)?.datas || [];
+    for (const group of outer) rows.push(...group?.datas || group?.data || []);
+  } catch (error) {
+    throw imValidationError(
+      "quote_msg_not_found",
+      `\u65E0\u6CD5\u5B9A\u4F4D\u88AB\u5F15\u6D88\u606F ${msgId}\uFF1A${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", `\u6D88\u606F ${msgId} \u4E0D\u5728${scopeLabel}\u5185\uFF08\u6216\u5DF2\u88AB\u64A4\u56DE\uFF09\uFF0C\u65E0\u6CD5\u5F15\u7528`, {
+      ...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 {
+    }
+  }
+  const ref = {
+    id: msgId,
+    t: str(msgObj?.type ?? row.kind ?? "1") || "1",
+    f: "0",
+    time: Number(row.msgtime) > 0 ? Number(row.msgtime) * 1e3 : 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 };
+}
+function extractQuoteSummary(msgObj) {
+  const raw = msgObj ? msgObj.rmsg ?? msgObj.ref : void 0;
+  if (!raw || typeof raw !== "object") return void 0;
+  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)
+  };
+}
+
 // src/shortcuts/im/operations/msg-sync.ts
 var MAX_MSG_ID = String((1n << 63n) - 1n);
 function resolveRange(args, idKeys = { start: "start", end: "end" }) {
@@ -1512,7 +1645,7 @@ async function enrichMessages(rawRows, host, options = {}) {
   for (const [uid, p] of Object.entries(personMap)) nameMap[uid] = p.name;
   const enriched = [];
   for (const row of rows) {
-    const msgObj = parseMsg(row.msg);
+    const msgObj = parseMsg2(row.msg);
     const parsed = parseContent(msgObj, { i18nMap, nameMap });
     const imgs = msgObj ? extractImgs(msgObj) : [];
     const videos = msgObj ? extractVideos(msgObj) : [];
@@ -1583,6 +1716,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,
@@ -1593,6 +1727,7 @@ async function enrichMessages(rawRows, host, options = {}) {
       typeName: parsed.typeName,
       title: options.titleFirst ? parsed.title : void 0,
       content: collapseNewlines(parsed.content),
+      ...quoteSummary ? { quote: quoteSummary, quoteTime: Number(quoteSummary.msgtime) > 0 ? formatFullTime(Math.floor(Number(quoteSummary.msgtime) / 1e3)) : void 0 } : {},
       must: parsed.must,
       fileName: parsed.fileName,
       media,
@@ -1820,7 +1955,7 @@ var msgReadSingle = {
     toCid: { type: "string", pattern: "^\\d+$", description: "\u5BF9\u65B9 cid" },
     msgids: { type: "array", items: { type: "string" }, description: "\u81EA\u5DF1\u53D1\u51FA\u7684\u6D88\u606F id\uFF08\u6700\u591A 50\uFF09" },
     recvMsgids: { type: "array", items: { type: "string" }, description: "\u81EA\u5DF1\u63A5\u6536\u7684\u6D88\u606F id\uFF08\u6700\u591A 50\uFF09" }
-  }, { required: ["toUid", "toCid"], description: "\u67E5\u8BE2\u5355\u804A\u9605\u8BFB\u72B6\u6001\uFF08msgids/recvMsgids \u81F3\u5C11\u5176\u4E00\uFF09" }),
+  }, { required: ["toUid", "toCid"], requiredAny: ["msgids", "recvMsgids"], description: "\u67E5\u8BE2\u5355\u804A\u9605\u8BFB\u72B6\u6001\uFF08msgids / recvMsgids \u81F3\u5C11\u5176\u4E00\uFF09" }),
   handler: async (args, { host }) => {
     const hasSent = Array.isArray(args.msgids) && args.msgids.length > 0;
     const hasRecv = Array.isArray(args.recvMsgids) && args.recvMsgids.length > 0;
@@ -1864,7 +1999,7 @@ var msgReadGroup = {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
     msgids: { type: "array", items: { type: "string" }, description: "\u81EA\u5DF1\u53D1\u51FA\u7684\u6D88\u606F id\uFF08\u6700\u591A 50\uFF09" },
     recvMsgids: { type: "array", items: { type: "string" }, description: "\u522B\u4EBA\u53D1\u51FA\u7684\u6D88\u606F id\uFF08\u6700\u591A 50\uFF09" }
-  }, { required: ["groupId"], description: "\u67E5\u8BE2\u7FA4\u6D88\u606F\u9605\u8BFB\u72B6\u6001" }),
+  }, { required: ["groupId"], requiredAny: ["msgids", "recvMsgids"], description: "\u67E5\u8BE2\u7FA4\u6D88\u606F\u9605\u8BFB\u72B6\u6001\uFF08msgids / recvMsgids \u81F3\u5C11\u5176\u4E00\uFF09" }),
   handler: async (args, { host }) => {
     const hasSent = Array.isArray(args.msgids) && args.msgids.length > 0;
     const hasRecv = Array.isArray(args.recvMsgids) && args.recvMsgids.length > 0;
@@ -1956,6 +2091,109 @@ var msgReadOperations = [
 // src/shortcuts/im/operations/msg-write.ts
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
+
+// src/shortcuts/im/operations/at-mention.ts
+var AT_ALL_ENTRY = { cid: "10000", fd: "@", id: "88", nm: "\u5168\u4F53\u6210\u5458", t: "2" };
+function truthy(value) {
+  return value === true || value === "true" || value === "1";
+}
+function uidList(value) {
+  if (value === void 0 || value === null || value === "") return [];
+  const raw = Array.isArray(value) ? value.map((x) => str(x)) : String(value).split(/[,，;；\s]+/);
+  return raw.map((x) => x.trim()).filter((x) => x && x !== "0");
+}
+function hasAtInput(args) {
+  return args.atAll !== void 0 || args.atUids !== void 0;
+}
+async function resolveAtMentions(args, env, groupId) {
+  const atAll = truthy(args.atAll);
+  const atUids = uidList(args.atUids);
+  if (!atAll && !atUids.length) return [];
+  const entries = [];
+  if (atAll) entries.push({ ...AT_ALL_ENTRY });
+  if (atUids.length) {
+    let members = [];
+    try {
+      const res = 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: "im.msg.send.group.atMembers"
+      });
+      members = extractGroupMembers(unwrapInner(res));
+    } catch (error) {
+      throw imValidationError(
+        "at_members_unavailable",
+        `\u65E0\u6CD5\u6838\u5B9E @ \u76EE\u6807\u662F\u5426\u5728\u7FA4\u5185\uFF1A\u62C9\u53D6\u7FA4\u6210\u5458\u5931\u8D25\uFF08${error instanceof Error ? error.message : String(error)}\uFF09`,
+        { groupId, atUids }
+      );
+    }
+    const inGroup = /* @__PURE__ */ new Map();
+    for (const m of members) {
+      if (isSystemMember(m)) continue;
+      inGroup.set(str(m.uid), str(m.cid));
+    }
+    const missing = atUids.filter((uid) => !inGroup.has(uid));
+    if (missing.length) {
+      throw imValidationError(
+        "at_member_not_in_group",
+        `\u4EE5\u4E0B @ \u76EE\u6807\u4E0D\u5728\u7FA4 ${groupId} \u5185\uFF0C\u5DF2\u62D2\u7EDD\u53D1\u9001\uFF1A${missing.join(", ")}`,
+        { groupId, missing, atUids }
+      );
+    }
+    const personMap = await env.host.resolveUsersByIds([...new Set(atUids)]);
+    for (const uid of atUids) {
+      entries.push({ cid: inGroup.get(uid) || "", fd: "@", id: uid, nm: personMap[uid]?.name || uid, t: "1" });
+    }
+  }
+  return entries;
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildAtText(text, entries) {
+  let v = String(text ?? "");
+  const used = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    const names = entry.t === "2" ? ["\u5168\u4F53\u6210\u5458", "\u6240\u6709\u4EBA"] : [entry.nm];
+    for (const nm of names) {
+      const re = new RegExp(`@${escapeRegExp(nm)}`, "g");
+      if (!re.test(v)) continue;
+      v = v.replace(re, () => `:@${entry.id};`);
+      used.add(entry);
+      break;
+    }
+  }
+  const rest = entries.filter((e) => !used.has(e));
+  if (rest.length) {
+    const prefix = rest.map((e) => `:@${e.id};`).join("  ");
+    v = v.trim() ? `${prefix}  ${v}` : prefix;
+  }
+  const aus = [...used, ...rest];
+  return { v, aus };
+}
+function buildAtMsgJson(v, aus, self, extra = {}) {
+  return JSON.stringify({
+    bgc: "",
+    cnt: "0",
+    dev: 5,
+    display: "",
+    dt: [{ txt: { aus, ft: "china", next: "0", v } }],
+    guid: "0",
+    idx: "0",
+    opb: ["received", "reply"],
+    scid: self.cid,
+    sname: self.name,
+    suid: self.uid,
+    sysId: "",
+    type: "1",
+    ver: "1.0",
+    weaOaId: "",
+    ...extra
+  });
+}
+
+// src/shortcuts/im/operations/msg-write.ts
 function assertLocalFile(pathValue, field) {
   const abs = resolve(String(pathValue ?? ""));
   if (!existsSync(abs)) throw imValidationError("file_not_found", `${field} \u6587\u4EF6\u4E0D\u5B58\u5728: ${abs}`);
@@ -1982,7 +2220,17 @@ var sendSinglePair = makeWritePair({
     if (!toUid || !toCid || toUid === "0" || toCid === "0") {
       throw imValidationError("id_invalid", "toUid/toCid \u5FC5\u987B\u975E 0");
     }
+    if (hasAtInput(args)) {
+      throw imValidationError("at_not_supported", "@ \u63D0\u53CA\u4EC5\u7FA4\u804A\u6D88\u606F\u652F\u6301\uFF08\u5355\u804A\u53D1\u9001\u4E0D\u63A5\u53D7 atAll/atUids\uFF09");
+    }
+    if (args.replyMsgId !== void 0 && args.replyMsgId !== null && args.replyMsgId !== "") {
+      throw imValidationError("reply_not_supported", "\u5355\u804A\u4EC5\u652F\u6301\u5F15\u7528\uFF08quoteMsgId\uFF09\uFF0C\u4E0D\u652F\u6301\u56DE\u590D\uFF08replyMsgId\uFF09");
+    }
     const content = normalizeContent(args);
+    const quote = hasQuoteInput(args) ? await resolveQuotedRef(args, env, { toUid, toCid }) : null;
+    if (quote && !content.txt) {
+      throw imValidationError("quote_requires_txt", "quoteMsgId \u4EC5\u652F\u6301\u6587\u672C\u6D88\u606F\uFF08txt\uFF09");
+    }
     const summary = {
       action: "\u53D1\u9001\u5355\u804A\u6D88\u606F",
       toUid,
@@ -1996,6 +2244,11 @@ var sendSinglePair = makeWritePair({
       snapshot.txt = content.txt;
       summary.textPreview = content.txt.length > 60 ? `${content.txt.slice(0, 60)}\u2026` : 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)}\u2026` : quote.text };
+    }
     if (content.imgPath) {
       const abs = assertLocalFile(content.imgPath, "img");
       snapshot.imgPath = abs;
@@ -2010,7 +2263,13 @@ var sendSinglePair = makeWritePair({
   },
   async execute(plan, env) {
     const body = { reciver: { cid: plan.toCid, uid: plan.toUid } };
-    if (plan.txt !== void 0) body.txt = plan.txt;
+    const quoteRef = plan.quoteRef ?? null;
+    if (quoteRef) {
+      const self = await env.host.getSelfIdentity();
+      body.msg = buildAtMsgJson(String(plan.txt ?? ""), [], self, { ref: quoteRef });
+    } else if (plan.txt !== void 0) {
+      body.txt = plan.txt;
+    }
     if (plan.imgPath) {
       const fileObj = await env.host.uploadFile(plan.imgPath, { shareUsers: plan.toUid });
       body.img = fileObjToImg(fileObj);
@@ -2035,12 +2294,29 @@ var sendGroupPair = makeWritePair({
     const groupId = str(args.groupId);
     if (!groupId || groupId === "0") throw imValidationError("id_invalid", "groupId \u5FC5\u987B\u975E 0");
     const content = normalizeContent(args);
+    const atEntries = await resolveAtMentions(args, env, groupId);
+    if (atEntries.length && !content.txt) {
+      throw imValidationError("at_requires_txt", "atAll/atUids \u4EC5\u652F\u6301\u6587\u672C\u6D88\u606F\uFF08txt\uFF09");
+    }
+    const quote = hasQuoteInput(args) ? await resolveQuotedRef(args, env, { groupId }) : null;
+    if (quote && !content.txt) {
+      throw imValidationError("quote_requires_txt", "quoteMsgId/replyMsgId \u4EC5\u652F\u6301\u6587\u672C\u6D88\u606F\uFF08txt\uFF09");
+    }
     const summary = { action: "\u53D1\u9001\u7FA4\u804A\u6D88\u606F", 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)}\u2026` : 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)}\u2026` : quote.text };
+    }
     if (content.imgPath) {
       const abs = assertLocalFile(content.imgPath, "img");
       snapshot.imgPath = abs;
@@ -2055,7 +2331,15 @@ var sendGroupPair = makeWritePair({
   },
   async execute(plan, env) {
     const body = { groupId: plan.groupId };
-    if (plan.txt !== void 0) body.txt = plan.txt;
+    const atEntries = Array.isArray(plan.atEntries) ? plan.atEntries : [];
+    const quoteRef = plan.quoteRef ?? null;
+    if (atEntries.length || quoteRef) {
+      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 !== void 0) {
+      body.txt = plan.txt;
+    }
     if (plan.imgPath) {
       const fileObj = await env.host.uploadFile(plan.imgPath, { shareGroups: plan.groupId });
       body.img = fileObjToImg(fileObj);
@@ -2427,7 +2711,7 @@ var 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;
@@ -2442,7 +2726,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
     },
     {
@@ -2463,19 +2747,27 @@ function buildMsgWriteDefinition(name, method, summary, inputProps, pair) {
   ];
 }
 var msgWriteOps = [
-  ...buildMsgWriteDefinition("im.msg.send.single", "msg.send.single", "\u53D1\u9001\u5355\u804A\u6D88\u606F\uFF08\u6587\u672C/\u56FE\u7247/\u6587\u4EF6\uFF09", {
+  ...buildMsgWriteDefinition("im.msg.send.single", "msg.send.single", "\u53D1\u9001\u5355\u804A\u6D88\u606F\uFF08\u6587\u672C/\u56FE\u7247/\u6587\u4EF6\uFF0C\u6587\u672C\u652F\u6301\u5F15\u7528\uFF09", {
     toUid: { type: "string", pattern: "^\\d+$", description: "\u63A5\u6536\u4EBA uid" },
     toCid: { type: "string", pattern: "^\\d+$", description: "\u63A5\u6536\u4EBA cid" },
     txt: { type: "string", description: "\u6587\u672C\u5185\u5BB9" },
+    quoteMsgId: { type: "string", pattern: "^\\d+$", description: "\u5F15\u7528\u8BE5\u6D88\u606F\uFF08\u5355\u804A\u4EC5\u652F\u6301\u5F15\u7528\uFF0C\u4E0D\u652F\u6301\u56DE\u590D\uFF1B\u4EC5 txt \u6587\u672C\u6D88\u606F\uFF09\uFF1B\u4F20\u5355\u804A\u4F1A\u8BDD\u5185\u6D88\u606F id\uFF08ser_msgid\uFF09\uFF0Cprepare \u9636\u6BB5\u81EA\u52A8\u5B9A\u4F4D\u5E76\u7EC4\u88C5 ref" },
     img: { type: "string", description: "\u672C\u5730\u56FE\u7247\u8DEF\u5F84\uFF08\u53D1\u9001\u524D\u4F1A\u4E0A\u4F20\u5230 E10 \u6587\u4EF6\u670D\u52A1\uFF09" },
     file: { type: "string", description: "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84" }
-  }, sendSinglePair),
-  ...buildMsgWriteDefinition("im.msg.send.group", "msg.send.group", "\u53D1\u9001\u7FA4\u804A\u6D88\u606F\uFF08\u6587\u672C/\u56FE\u7247/\u6587\u4EF6\uFF09", {
+  }, sendSinglePair, {
+    required: ["toUid", "toCid"],
+    requiredAny: ["txt", "img", "file"]
+  }),
+  ...buildMsgWriteDefinition("im.msg.send.group", "msg.send.group", "\u53D1\u9001\u7FA4\u804A\u6D88\u606F\uFF08\u6587\u672C/\u56FE\u7247/\u6587\u4EF6\uFF0C\u6587\u672C\u652F\u6301 @ \u63D0\u53CA\u4E0E\u5F15\u7528/\u56DE\u590D\uFF09", {
     groupId: { type: "string", pattern: "^\\d+$", description: "\u7FA4 id" },
-    txt: { type: "string", description: "\u6587\u672C\u5185\u5BB9" },
+    txt: { type: "string", description: "\u6587\u672C\u5185\u5BB9\uFF1B@ \u4F4D\u7F6E\u76F4\u63A5\u5199 @<\u59D3\u540D>\uFF08\u5982 @\u5F20\u4E09\uFF09\u6216 @\u5168\u4F53\u6210\u5458/@\u6240\u6709\u4EBA" },
+    atAll: { type: "boolean", description: "@\u5168\u4F53\u6210\u5458\uFF08\u670D\u52A1\u7AEF\u56FA\u5B9A id=88\uFF09\uFF0C\u4EC5\u7FA4\u804A\u3001\u4EC5 txt \u6587\u672C\u6D88\u606F\u751F\u6548" },
+    atUids: { type: "array", items: { type: "string" }, description: "@\u5177\u4F53\u4EBA uid \u5217\u8868\uFF0C\u4EC5\u7FA4\u804A\uFF1Bprepare \u9636\u6BB5\u4F1A\u9010\u4E2A\u6838\u5B9E\u662F\u5426\u5728\u7FA4\u5185\uFF0C\u4E0D\u5728\u7FA4\u5185\u5219\u62D2\u7EDD\u53D1\u9001" },
+    quoteMsgId: { type: "string", pattern: "^\\d+$", description: "\u5F15\u7528\u8BE5\u6D88\u606F\uFF08\u4E0E replyMsgId \u4E92\u65A5\uFF0C\u4EC5\u7FA4\u804A\u3001\u4EC5 txt \u6587\u672C\u6D88\u606F\uFF09\uFF1B\u4F20\u6D88\u606F id\uFF08ser_msgid\uFF09\uFF0Cprepare \u9636\u6BB5\u81EA\u52A8\u5B9A\u4F4D\u88AB\u5F15\u6D88\u606F\u5E76\u7EC4\u88C5 ref" },
+    replyMsgId: { type: "string", pattern: "^\\d+$", description: "\u56DE\u590D\u8BE5\u6D88\u606F\uFF08\u4E0E quoteMsgId \u4E92\u65A5\uFF0C\u4EC5\u7FA4\u804A\u3001\u4EC5 txt \u6587\u672C\u6D88\u606F\uFF09\uFF1B\u4F20\u6D88\u606F id\uFF08ser_msgid\uFF09\uFF0Cprepare \u9636\u6BB5\u81EA\u52A8\u5B9A\u4F4D\u88AB\u5F15\u6D88\u606F\u5E76\u7EC4\u88C5 rmsg" },
     img: { type: "string", description: "\u672C\u5730\u56FE\u7247\u8DEF\u5F84" },
     file: { type: "string", description: "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84" }
-  }, sendGroupPair),
+  }, sendGroupPair, { required: ["groupId"], requiredAny: ["txt", "img", "file"] }),
   ...buildMsgWriteDefinition("im.msg.withdraw", "msg.withdraw", "\u64A4\u56DE\u6D88\u606F\uFF08\u5355\u804A/\u7FA4\u804A\uFF0C\u9650\u672C\u4EBA 2 \u5206\u949F\u5185\uFF09", {
     type: { type: "string", enum: ["single", "group"], description: "single \u6216 group" },
     msgid: { type: "string", pattern: "^\\d+$", description: "\u6D88\u606F id\uFF08ser_msgid\uFF09" },
@@ -2499,7 +2791,12 @@ var msgWriteOps = [
     toUids: { type: "array", items: { type: "string" }, description: "\u6307\u5B9A\u63A5\u6536\u4EBA uid" },
     sendMsg: { type: "integer", enum: [0, 1], description: "\u53D1\u77ED\u4FE1\uFF08\u9ED8\u8BA4 1 \u53D1\uFF09" },
     showType: { type: "integer", enum: [0, 1], description: "0 \u5168\u4F53\u53EF\u89C1\uFF08\u9ED8\u8BA4\uFF09/1 \u4EC5\u53D1\u9001\u4EBA\u53EF\u89C1" }
-  }, dingSendPair)
+  }, dingSendPair, {
+    allOf: [
+      { anyOf: [{ required: ["groupId"] }, { required: ["toUid"] }] },
+      { anyOf: [{ required: ["txt"] }, { required: ["convertMsgid"] }] }
+    ]
+  })
 ];
 var msgWriteOperations = msgWriteOps;
 
@@ -2607,7 +2904,7 @@ var sessionList = {
       const unread = s?.unread_count ?? s?.unread ?? 0;
       const dontDisturb = Number(s?.reminder ?? s?.reminder_type ?? 0) === 1;
       const titleRaw = s?.title;
-      const titleObj = typeof titleRaw === "string" ? parseMsg(titleRaw) : titleRaw && typeof titleRaw === "object" ? titleRaw : null;
+      const titleObj = typeof titleRaw === "string" ? parseMsg2(titleRaw) : titleRaw && typeof titleRaw === "object" ? titleRaw : null;
       let subtitleSender = "";
       let subtitleContent = "";
       let subtitleMedia = "";
@@ -2716,7 +3013,7 @@ var sysmsgTypeSync = {
   inputSchema: schemaOf({
     gids: { type: "array", items: { type: "integer" }, description: "\u7CFB\u7EDF\u5206\u7EC4 id\uFF08\u4E0E tids \u81F3\u5C11\u5176\u4E00\uFF09" },
     tids: { type: "array", items: { type: "integer" }, description: "\u6D88\u606F\u7C7B\u578B id" }
-  }, { description: "gids / tids \u81F3\u5C11\u5176\u4E00" }),
+  }, { requiredAny: ["gids", "tids"], description: "\u6309 gids/tids \u62C9\u53D6\u7CFB\u7EDF\u6D88\u606F\u5206\u7EC4/\u7C7B\u578B\u914D\u7F6E\uFF08\u81F3\u5C11\u5176\u4E00\uFF09" }),
   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)) : [];
@@ -2857,7 +3154,7 @@ var sysmsgQuery = {
     for (const [uid, p] of Object.entries(personMap)) nameMap[uid] = p.name;
     const authUid = await resolveAuthUid(host);
     const messages = msgRows.map((row) => {
-      const msgObj = parseMsg(row.msg);
+      const msgObj = parseMsg2(row.msg);
       const parsed = parseContent(msgObj, { i18nMap, nameMap });
       const sender = senderName(msgObj || {}, row.from_uid, authUid, nameMap);
       const statusLabel = dealMode ? Number(row.deal_status) === 1 ? "\u5DF2\u5904\u7406" : "\u672A\u5904\u7406" : row.read_status === true || row.read_status === 1 ? "\u5DF2\u8BFB" : "\u672A\u8BFB";
@@ -3031,7 +3328,11 @@ var filePreview = {
     toUid: { type: "string", description: "\u5355\u804A\u573A\u666F\u5BF9\u65B9 uid" },
     toCid: { type: "string", description: "\u5355\u804A\u573A\u666F\u5BF9\u65B9 cid" },
     imgFormat: { type: "string", enum: ["small", "large", "original"], description: "\u56FE\u7247\u89C4\u683C\uFF08\u9ED8\u8BA4 small\uFF09" }
-  }, { required: ["fileId", "msgid"], description: "\u5A92\u4F53\u9884\u89C8 URL" }),
+  }, {
+    required: ["fileId", "msgid"],
+    anyOf: [{ required: ["groupId"] }, { required: ["toUid", "toCid"] }],
+    description: "\u5A92\u4F53\u9884\u89C8 URL\uFF08groupId \u7FA4\u804A \u6216 toUid+toCid \u5355\u804A\uFF0C\u4E8C\u9009\u4E00\uFF09"
+  }),
   handler: async (args, { host }) => {
     const kind = String(args.kind ?? "img") === "video" ? "video" : "img";
     const fileId = String(args.fileId);
@@ -3090,7 +3391,11 @@ var fileDownload = {
     toCid: { type: "string", description: "\u5355\u804A\u573A\u666F\u5BF9\u65B9 cid\uFF08\u4E0E groupId \u4E8C\u9009\u4E00\uFF09" },
     imgFormat: { type: "string", enum: ["small", "large", "original"], description: "\u56FE\u7247\u89C4\u683C\uFF08\u9ED8\u8BA4 small\uFF1B\u8981\u539F\u56FE\u4F20 original\uFF09" },
     output: { type: "string", minLength: 1, description: "\u672C\u5730\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84\uFF08\u7236\u76EE\u5F55\u5FC5\u987B\u5B58\u5728\uFF0C\u5DF2\u5B58\u5728\u5219\u62D2\u7EDD\uFF09" }
-  }, { required: ["fileId", "msgid", "output"], description: "\u5A92\u4F53/\u6587\u4EF6\u843D\u5730\u5230\u672C\u5730" }),
+  }, {
+    required: ["fileId", "msgid", "output"],
+    anyOf: [{ required: ["groupId"] }, { required: ["toUid", "toCid"] }],
+    description: "\u5A92\u4F53/\u6587\u4EF6\u843D\u5730\u5230\u672C\u5730\uFF08groupId \u7FA4\u804A \u6216 toUid+toCid \u5355\u804A\uFF0C\u4E8C\u9009\u4E00\uFF09"
+  }),
   handler: async (args, { host }) => {
     const fileId = String(args.fileId ?? "");
     const msgid = String(args.msgid ?? "");