mirror of
https://github.com/NapNeko/NapCatQQ.git
synced 2026-02-05 23:19:37 +00:00
Added or updated actionSummary, actionTags, payloadExample, and returnExample properties for all OneBot action classes in the napcat-onebot package. This improves API documentation and discoverability by providing concise summaries, categorization tags, and usage examples for each action.
41 lines
1.4 KiB
TypeScript
41 lines
1.4 KiB
TypeScript
import { OneBotAction } from '@/napcat-onebot/action/OneBotAction';
|
|
import { ActionName } from '@/napcat-onebot/action/router';
|
|
import { Static, Type } from '@sinclair/typebox';
|
|
|
|
const PayloadSchema = Type.Object({
|
|
group_id: Type.String({ description: '群号' }),
|
|
no_code_finger_open: Type.Optional(Type.Number({ description: '是否开启无码指纹' })),
|
|
no_finger_open: Type.Optional(Type.Number({ description: '是否开启无指纹' })),
|
|
});
|
|
|
|
type PayloadType = Static<typeof PayloadSchema>;
|
|
|
|
const ReturnSchema = Type.Null({ description: '返回结果' });
|
|
|
|
type ReturnType = Static<typeof ReturnSchema>;
|
|
|
|
export default class SetGroupSearch extends OneBotAction<PayloadType, ReturnType> {
|
|
override actionName = ActionName.SetGroupSearch;
|
|
override actionSummary = '设置群搜索选项';
|
|
override actionTags = ['群组扩展'];
|
|
override payloadExample = {
|
|
group_id: 123456,
|
|
is_searchable: true
|
|
};
|
|
override returnExample = {
|
|
result: true
|
|
};
|
|
override payloadSchema = PayloadSchema;
|
|
override returnSchema = ReturnSchema;
|
|
async _handle (payload: PayloadType): Promise<ReturnType> {
|
|
const ret = await this.core.apis.GroupApi.setGroupSearch(payload.group_id, {
|
|
noCodeFingerOpenFlag: payload.no_code_finger_open,
|
|
noFingerOpenFlag: payload.no_finger_open,
|
|
});
|
|
if (ret.result !== 0) {
|
|
throw new Error(`设置群搜索失败, ${ret.result}:${ret.errMsg}`);
|
|
}
|
|
return null;
|
|
}
|
|
}
|