mirror of
https://github.com/NapNeko/NapCatQQ.git
synced 2026-02-04 14:41:14 +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.
42 lines
1.4 KiB
TypeScript
42 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: '群号' }),
|
|
robot_member_switch: Type.Optional(Type.Number({ description: '机器人成员开关' })),
|
|
robot_member_examine: Type.Optional(Type.Number({ description: '机器人成员审核' })),
|
|
});
|
|
|
|
type PayloadType = Static<typeof PayloadSchema>;
|
|
|
|
const ReturnSchema = Type.Null({ description: '返回结果' });
|
|
|
|
type ReturnType = Static<typeof ReturnSchema>;
|
|
|
|
export default class SetGroupRobotAddOption extends OneBotAction<PayloadType, ReturnType> {
|
|
override actionName = ActionName.SetGroupRobotAddOption;
|
|
override actionSummary = '设置群机器人加群选项';
|
|
override actionTags = ['群组扩展'];
|
|
override payloadExample = {
|
|
group_id: 123456,
|
|
option: 1
|
|
};
|
|
override returnExample = {
|
|
result: true
|
|
};
|
|
override payloadSchema = PayloadSchema;
|
|
override returnSchema = ReturnSchema;
|
|
async _handle (payload: PayloadType): Promise<ReturnType> {
|
|
const ret = await this.core.apis.GroupApi.setGroupRobotAddOption(
|
|
payload.group_id,
|
|
payload.robot_member_switch,
|
|
payload.robot_member_examine
|
|
);
|
|
if (ret.result !== 0) {
|
|
throw new Error(`设置群机器人添加选项失败, ${ret.result}:${ret.errMsg}`);
|
|
}
|
|
return null;
|
|
}
|
|
}
|