Files
NapCatQQ/packages/napcat-onebot/action/extends/qzone/SetQzoneBan.ts
T
Qiao 49ecfe0f56 feat(qzone): 完善空间 API 并兼容 SnowLuma API 格式 (#2124)
* feat(qzone): 接入内置空间动态、说说和赞评接口

新增好友动态、个人说说、详情及点赞、取消赞、评论和回复动作。
纯文本发表接入QQ内置空间接口,保留原有图片发表和删除路径。
保留完整动态身份和原始数据,约束游标、权限转换及请求错误处理。

验证:全工作区类型检查,367项测试通过、1项既有条件测试跳过,
变更文件ESLint及WebUI、Shell、Framework、OpenAPI构建通过。

* feat(qzone): 补齐空间管理、评论分页及 SnowLuma 兼容

* fix(qzone): 兼容真实 FormSender 回执与评论字段

* fix(qzone): 兼容黑名单回执中的空间名称

* docs(qzone): remove redundant API readme
2026-10-30 00:17:49 +08:00

55 lines
2.7 KiB
TypeScript

import { Static, Type } from '@sinclair/typebox';
import { OneBotAction } from '@/napcat-onebot/action/OneBotAction';
import { ActionName, BaseCheckResult } from '@/napcat-onebot/action/router';
import { qzoneBoolean } from './common-snowluma';
export const SetQzoneBanPayloadSchema = Type.Object({
user_id: Type.Union([
Type.String({ pattern: '^[1-9][0-9]*$', maxLength: 20 }),
Type.Integer({ minimum: 1, maximum: Number.MAX_SAFE_INTEGER }),
], { description: '需要设置空间访问限制的QQ号' }),
enable: Type.Optional(Type.Union([
Type.Boolean(), Type.Integer({ minimum: 0, maximum: 1 }), Type.String({ maxLength: 128 }),
], { description: '默认true;支持布尔值及true/false、1/0、yes/no、on/off拼写' })),
}, { additionalProperties: false });
export type SetQzoneBanPayload = Static<typeof SetQzoneBanPayloadSchema>;
function banUpdate (payload: SetQzoneBanPayload): { uin: string; enable: boolean; } {
if (!payload || typeof payload !== 'object' || Array.isArray(payload) || Object.keys(payload).some(key => key !== 'user_id' && key !== 'enable')) {
throw new Error('设置空间访问限制只支持 user_id 和 enable 参数');
}
const value = payload.user_id;
if (typeof value === 'number' && (!Number.isSafeInteger(value) || value <= 0)) throw new Error('user_id 必须为有效QQ号');
if ((typeof value !== 'string' && typeof value !== 'number') || !/^[1-9][0-9]{0,19}$/.test(String(value))) {
throw new Error('user_id 必须为有效QQ号');
}
if (typeof payload.enable === 'string' && payload.enable.length > 128) throw new Error('enable 超出允许长度');
return { uin: String(value), enable: qzoneBoolean(payload.enable) };
}
export class SetQzoneBan extends OneBotAction<SetQzoneBanPayload, null> {
override actionName = ActionName.SetQzoneBan;
override actionSummary = '设置QQ空间访问限制';
override actionDescription = '在当前账号的空间设置指定用户的访问限制;enable 默认为 true,传 false 取消禁止。';
override actionTags = ['扩展接口'];
override payloadExample = { user_id: '10002', enable: true };
override returnExample = null;
override payloadSchema = SetQzoneBanPayloadSchema;
override returnSchema = Type.Null();
protected override async check (payload: SetQzoneBanPayload): Promise<BaseCheckResult> {
try {
banUpdate(payload);
} catch (error) {
return { valid: false, message: (error as Error).message };
}
return await super.check(payload);
}
async _handle (payload: SetQzoneBanPayload): Promise<null> {
const normalized = banUpdate(payload);
await this.core.apis.QzoneApi.setBan(normalized.uin, normalized.enable);
return null;
}
}