From da3821ced40e2560293ff7c990cd9abef39fcb35 Mon Sep 17 00:00:00 2001 From: DrSmoothl <1787882683@qq.com> Date: Mon, 10 Aug 2026 00:26:29 +0800 Subject: [PATCH] feat(sdk): expose group request query options Add typed group, pending-state, and per-inbox limit options to group-system message queries while preserving existing call sites. Regenerate the shared action catalog so SDK and MCP consumers receive consistent validation rules and updated request-flag guidance. --- packages/mcp/src/generated/catalog.json | 21 ++++++++++++++++++++- packages/mcp/src/generated/catalog.ts | 21 ++++++++++++++++++++- packages/sdk/src/client/api-client.ts | 12 ++++++++++-- packages/sdk/src/types/actions.ts | 3 ++- packages/sdk/src/types/params.ts | 6 ++++++ 5 files changed, 58 insertions(+), 5 deletions(-) diff --git a/packages/mcp/src/generated/catalog.json b/packages/mcp/src/generated/catalog.json index 4b586994..ac14206c 100644 --- a/packages/mcp/src/generated/catalog.json +++ b/packages/mcp/src/generated/catalog.json @@ -4781,7 +4781,7 @@ }, "flag": { "type": "string", - "description": "处理用 flag(eventType:groupId:targetUid:filtered)" + "description": "处理请求使用的规范 flag" } }, "required": [ @@ -5815,6 +5815,18 @@ "type": "boolean" }, "default": false + }, + { + "name": "count", + "type": "int", + "required": false, + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100 + }, + "default": 50, + "desc": "每个收件箱最多读取的记录数" } ], "invariants": [], @@ -5829,6 +5841,13 @@ "only_pending": { "type": "boolean", "default": false + }, + "count": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "description": "每个收件箱最多读取的记录数", + "default": 50 } }, "additionalProperties": true diff --git a/packages/mcp/src/generated/catalog.ts b/packages/mcp/src/generated/catalog.ts index 8aceee23..c1bd818a 100644 --- a/packages/mcp/src/generated/catalog.ts +++ b/packages/mcp/src/generated/catalog.ts @@ -4784,7 +4784,7 @@ export const ACTIONS: CatalogAction[] = [ }, "flag": { "type": "string", - "description": "处理用 flag(eventType:groupId:targetUid:filtered)" + "description": "处理请求使用的规范 flag" } }, "required": [ @@ -5818,6 +5818,18 @@ export const ACTIONS: CatalogAction[] = [ "type": "boolean" }, "default": false + }, + { + "name": "count", + "type": "int", + "required": false, + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100 + }, + "default": 50, + "desc": "每个收件箱最多读取的记录数" } ], "invariants": [], @@ -5832,6 +5844,13 @@ export const ACTIONS: CatalogAction[] = [ "only_pending": { "type": "boolean", "default": false + }, + "count": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "description": "每个收件箱最多读取的记录数", + "default": 50 } }, "additionalProperties": true diff --git a/packages/sdk/src/client/api-client.ts b/packages/sdk/src/client/api-client.ts index 05ded173..7ad2d3c4 100644 --- a/packages/sdk/src/client/api-client.ts +++ b/packages/sdk/src/client/api-client.ts @@ -132,8 +132,16 @@ export abstract class SnowLumaApiClient { return this.call('get_group_honor_info', params, options); } - getGroupSystemMessages(options?: RequestOptions) { - return this.call('get_group_system_msg', {}, options); + getGroupSystemMessages(options?: RequestOptions & { + groupId?: number; + onlyPending?: boolean; + count?: number; + }) { + return this.call('get_group_system_msg', { + group_id: options?.groupId, + only_pending: options?.onlyPending, + count: options?.count, + }, options); } setGroupKick(groupId: number, userId: number, options?: RequestOptions & { rejectAddRequest?: boolean }) { diff --git a/packages/sdk/src/types/actions.ts b/packages/sdk/src/types/actions.ts index ea06a6ae..d9d786d8 100644 --- a/packages/sdk/src/types/actions.ts +++ b/packages/sdk/src/types/actions.ts @@ -18,6 +18,7 @@ import type { GetGroupFilesParams, GetGroupFileUrlParams, GetGroupHonorInfoParams, + GetGroupSystemMsgParams, GetGroupInfoParams, GetGroupListParams, GetGroupMemberInfoParams, @@ -131,7 +132,7 @@ export interface SnowLumaActionMap { get_group_member_list: { params: GetGroupMemberListParams; data: JsonObject[] }; get_group_member_info: { params: GetGroupMemberInfoParams; data: JsonObject }; get_group_honor_info: { params: GetGroupHonorInfoParams; data: JsonValue }; - get_group_system_msg: { params: JsonObject; data: JsonObject[] }; + get_group_system_msg: { params: GetGroupSystemMsgParams; data: JsonObject[] }; set_group_kick: { params: SetGroupKickParams; data: EmptyData }; set_group_kick_members: { params: SetGroupKickMembersParams; data: EmptyData }; set_group_ban: { params: SetGroupBanParams; data: EmptyData }; diff --git a/packages/sdk/src/types/params.ts b/packages/sdk/src/types/params.ts index 693ea1a2..9ac0f156 100644 --- a/packages/sdk/src/types/params.ts +++ b/packages/sdk/src/types/params.ts @@ -57,6 +57,12 @@ export interface GetGroupHonorInfoParams extends GroupIdParams { type?: 'talkative' | 'performer' | 'legend' | 'strong_newbie' | 'emotion' | 'all' | string; } +export interface GetGroupSystemMsgParams extends JsonObject { + group_id?: number; + only_pending?: boolean; + count?: number; +} + export interface DeleteFriendParams extends UserIdParams { block?: boolean; }