From 47921eee1249168f2ca32912eaa4e80f130537d5 Mon Sep 17 00:00:00 2001 From: DrSmoothl <1787882683@qq.com> Date: Sat, 16 May 2026 00:39:32 +0800 Subject: [PATCH] fix(sdk): catch up SNOWLUMA_ACTIONS with the 14 new core actions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `actions-sync.test.ts` walks every `registerAction(...)` in `@snowluma/core/src/onebot/actions/` and asserts the SDK's exported list matches. The napcat-parity work (Tier 1 + Tier 2 + Tier 3 + AI voice) added 14 actions to core without ever touching the SDK, so the test caught the drift: bot_exit cancel_group_todo complete_group_todo delete_group_folder get_ai_characters get_ai_record get_group_ignore_add_request nc_get_packet_status nc_get_rkey nc_get_user_status send_group_ai_record send_packet set_diy_online_status set_group_todo Added them to `SNOWLUMA_ACTIONS` and gave each one a typed `SnowLumaActionMap` entry. Where the request body shape is non-trivial (AI voice, group todo, DIY status, send_packet, nc_get_user_status), introduced dedicated param types in `types/params.ts`; where the response is structured (AI character list, user-status word), introduced result types in `types/results.ts`. Everything else routes through `JsonObject` / `EmptyData` so the SDK surface stays small. Verified: pnpm --filter @snowluma/sdk typecheck → clean pnpm --filter @snowluma/sdk test → 17/17 pass --- packages/sdk/src/actions.ts | 18 +++++++++++++ packages/sdk/src/types/actions.ts | 32 +++++++++++++++++++++- packages/sdk/src/types/params.ts | 44 +++++++++++++++++++++++++++++++ packages/sdk/src/types/results.ts | 23 ++++++++++++++++ 4 files changed, 116 insertions(+), 1 deletion(-) diff --git a/packages/sdk/src/actions.ts b/packages/sdk/src/actions.ts index 3618bb8f..f3782ca7 100644 --- a/packages/sdk/src/actions.ts +++ b/packages/sdk/src/actions.ts @@ -122,6 +122,24 @@ export const SNOWLUMA_ACTIONS = [ 'rename_group_file', 'get_file', '.send_packet', + + // napcat-parity extensions (Tier 1 + Tier 2) + 'send_packet', + 'bot_exit', + 'nc_get_packet_status', + 'nc_get_rkey', + 'nc_get_user_status', + 'get_group_ignore_add_request', + 'delete_group_folder', + 'set_group_todo', + 'complete_group_todo', + 'cancel_group_todo', + // Tier 3: DIY status + 'set_diy_online_status', + // AI voice trio + 'get_ai_characters', + 'get_ai_record', + 'send_group_ai_record', ] as const satisfies readonly (keyof SnowLumaActionMap)[]; export type SnowLumaKnownAction = typeof SNOWLUMA_ACTIONS[number]; diff --git a/packages/sdk/src/types/actions.ts b/packages/sdk/src/types/actions.ts index f784504a..53b4a0d3 100644 --- a/packages/sdk/src/types/actions.ts +++ b/packages/sdk/src/types/actions.ts @@ -60,6 +60,13 @@ import type { UploadPrivateFileParams, UserIdParams, QuickOperationParams, + SetDiyOnlineStatusParams, + NcGetUserStatusParams, + GroupTodoParams, + GetAiCharactersParams, + AiVoiceParams, + DeleteGroupFolderParams, + SendPacketParams, } from './params'; import type { CapabilityInfo, @@ -84,6 +91,9 @@ import type { UploadForwardResult, UrlSafetyInfo, VersionInfo, + AiCharacterCategory, + UserOnlineStatus, + SendGroupAiRecordResult, } from './results'; export type ActionData = JsonValue; @@ -209,7 +219,27 @@ export interface SnowLumaActionMap { trans_group_file: { params: JsonObject; data: JsonValue }; rename_group_file: { params: JsonObject; data: JsonValue }; get_file: { params: GetMediaParams; data: JsonValue }; - '.send_packet': { params: JsonObject; data: JsonValue }; + '.send_packet': { params: SendPacketParams; data: string }; + + // — napcat-parity extensions (Tier 1 + Tier 2) — + send_packet: { params: SendPacketParams; data: string }; + bot_exit: { params: JsonObject; data: EmptyData }; + nc_get_packet_status: { params: JsonObject; data: JsonValue }; + nc_get_rkey: { params: JsonObject; data: JsonObject[] }; + nc_get_user_status: { params: NcGetUserStatusParams; data: UserOnlineStatus }; + get_group_ignore_add_request: { params: JsonObject; data: JsonArray }; + delete_group_folder: { params: DeleteGroupFolderParams; data: EmptyData }; + set_group_todo: { params: GroupTodoParams; data: EmptyData }; + complete_group_todo: { params: GroupTodoParams; data: EmptyData }; + cancel_group_todo: { params: GroupTodoParams; data: EmptyData }; + + // — Tier 3: DIY status — + set_diy_online_status: { params: SetDiyOnlineStatusParams; data: EmptyData }; + + // — AI voice trio — + get_ai_characters: { params: GetAiCharactersParams; data: AiCharacterCategory[] }; + get_ai_record: { params: AiVoiceParams; data: string }; + send_group_ai_record: { params: AiVoiceParams; data: SendGroupAiRecordResult }; } export type SnowLumaAction = keyof SnowLumaActionMap | (string & {}); diff --git a/packages/sdk/src/types/params.ts b/packages/sdk/src/types/params.ts index 4935154c..df741b51 100644 --- a/packages/sdk/src/types/params.ts +++ b/packages/sdk/src/types/params.ts @@ -316,3 +316,47 @@ export interface SetOnlineStatusParams extends JsonObject { ext_status?: number; battery_status?: number; } + +// DIY online status — status/extStatus are forced to 10/2000 server-side, +// and these three fields land in the customExt sub-message. +export interface SetDiyOnlineStatusParams extends JsonObject { + face_id: number | string; + wording?: string; + face_type?: number | string; +} + +// nc_get_user_status — read the QQ-side online/ext-status word for a uin. +export interface NcGetUserStatusParams extends UserIdParams {} + +// set_/complete_/cancel_group_todo all share this shape; the action verb +// lives in the route, not the body. +export interface GroupTodoParams extends GroupIdParams { + message_id: number | string; +} + +// AI voice — fetch the in-group AI character list. +export interface GetAiCharactersParams extends GroupIdParams { + chat_type?: number | string; +} + +// AI voice — `get_ai_record` and `send_group_ai_record` share params. +// The action's verb (read vs send) is the route, not the body. +export interface AiVoiceParams extends GroupIdParams { + character: string; + text: string; + chat_type?: number | string; +} + +// delete_group_folder — napcat's alias for delete_group_file_folder. +// Same body, different action name. +export interface DeleteGroupFolderParams extends GroupIdParams { + folder_id: string; +} + +// send_packet — debug endpoint, sends a hex-encoded raw packet. +// `rsp=false` skips waiting for a response. +export interface SendPacketParams extends JsonObject { + cmd: string; + data?: string; + rsp?: boolean; +} diff --git a/packages/sdk/src/types/results.ts b/packages/sdk/src/types/results.ts index 37cd1e35..f7e26cbe 100644 --- a/packages/sdk/src/types/results.ts +++ b/packages/sdk/src/types/results.ts @@ -101,3 +101,26 @@ export interface GroupAtAllRemainInfo { } export type EmptyData = null; + +// — AI 语音角色:get_ai_characters 返回的分类数组 — +export interface AiCharacter { + character_id: string; + character_name: string; + preview_url: string; +} + +export interface AiCharacterCategory { + type: string; + characters: AiCharacter[]; +} + +// — nc_get_user_status 返回的状态字 — +export interface UserOnlineStatus { + status: number; + ext_status: number; +} + +// — send_group_ai_record 返回(合成是异步副作用,message_id 总为 0) — +export interface SendGroupAiRecordResult { + message_id: number; +}