Files
NapCatQQ/packages/napcat-onebot/action/extends/qzone/SetQzoneMsgRight.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

67 lines
3.5 KiB
TypeScript

import { Static, Type } from '@sinclair/typebox';
import { OneBotAction } from '@/napcat-onebot/action/OneBotAction';
import { ActionName, BaseCheckResult } from '@/napcat-onebot/action/router';
import { normalizeQzoneRight } from '@/napcat-core/data/qzone-web';
import { qzoneIdentity, SlQzoneIdentitySchema } from './common-snowluma';
export const SetQzoneMsgRightPayloadSchema = Type.Object({
tid: SlQzoneIdentitySchema,
ugc_right: Type.Union([Type.Number(), Type.String({ maxLength: 32 })], { description: '查看权限:1所有人,4好友,16部分好友,64仅自己,128排除部分好友' }),
target_uins: Type.Optional(Type.Array(Type.Union([
Type.String({ pattern: '^[1-9][0-9]*$', maxLength: 20 }),
Type.Integer({ minimum: 1, maximum: Number.MAX_SAFE_INTEGER }),
]), { description: 'ugc_right 为16或128时的QQ号列表' })),
}, { additionalProperties: false });
export type SetQzoneMsgRightPayload = Static<typeof SetQzoneMsgRightPayloadSchema>;
const ReturnSchema = Type.Object({
ugc_right: Type.Number({ description: '设置成功的查看权限' }),
});
function rightUpdate (payload: SetQzoneMsgRightPayload) {
if (!payload || typeof payload !== 'object' || Array.isArray(payload) || Object.keys(payload).some(key => !['tid', 'ugc_right', 'target_uins'].includes(key))) {
throw new Error('修改说说权限只支持 tid、ugc_right 和 target_uins 参数');
}
const tid = qzoneIdentity(payload.tid, 'tid');
if ((typeof payload.ugc_right !== 'number' && typeof payload.ugc_right !== 'string') ||
(typeof payload.ugc_right === 'string' && payload.ugc_right.length > 32)) {
throw new Error('ugc_right 必须为有效权限数字');
}
const right = Number(payload.ugc_right);
if (!Number.isFinite(right)) throw new Error('ugc_right 必须为有效权限数字');
if (payload.target_uins !== undefined && !Array.isArray(payload.target_uins)) throw new Error('target_uins 必须为QQ号数组');
const targets = payload.target_uins?.map(value => {
if (typeof value === 'number' && (!Number.isSafeInteger(value) || value <= 0)) throw new Error('target_uins 包含无效QQ号');
if ((typeof value !== 'string' && typeof value !== 'number') || !/^[1-9][0-9]{0,19}$/.test(String(value))) {
throw new Error('target_uins 包含无效QQ号');
}
return String(value);
});
return { ...normalizeQzoneRight(right, targets), tid };
}
export class SetQzoneMsgRight extends OneBotAction<SetQzoneMsgRightPayload, { ugc_right: number; }> {
override actionName = ActionName.SetQzoneMsgRight;
override actionSummary = '修改QQ空间说说权限';
override actionDescription = '仅修改当前账号发表的说说。ugc_right 为16或128时 target_uins 不能为空;其他权限不使用该列表。';
override actionTags = ['扩展接口'];
override payloadExample = { tid: 'shuoshuo-tid', ugc_right: 4 };
override returnExample = { ugc_right: 4 };
override payloadSchema = SetQzoneMsgRightPayloadSchema;
override returnSchema = ReturnSchema;
protected override async check (payload: SetQzoneMsgRightPayload): Promise<BaseCheckResult> {
try {
rightUpdate(payload);
} catch (error) {
return { valid: false, message: (error as Error).message };
}
return await super.check(payload);
}
async _handle (payload: SetQzoneMsgRightPayload): Promise<{ ugc_right: number; }> {
const normalized = rightUpdate(payload);
return await this.core.apis.QzoneApi.setMsgRight(normalized.tid, normalized.right, normalized.targetUins);
}
}