feat(qzone): add set_qzone_msg_right to change a feed's visibility (#186)
* feat(qzone): add set_qzone_msg_right to change a feed's visibility Add updateQzoneMsgRight in the protocol layer, porting php-qzone's updateRight: fetch the feed via emotion_cgi_msgdetail_v6, rebuild the full publish-shaped payload (richval/pic_bo/con), then override ugc_right/allow_uins and POST to emotion_cgi_update. Expose it through QzoneApi.updateRight and the OneBot set_qzone_msg_right action, with the same ugc_right/target_uins validation as send_qzone_msg. Covered by protocol, core and onebot tests. * fix(qzone): make qzoneParse more stable and fixed a test example
This commit is contained in:
@@ -5,11 +5,13 @@ import {
|
||||
getQzoneMsgList,
|
||||
publishQzoneMsg,
|
||||
setQzoneLike,
|
||||
updateQzoneMsgRight,
|
||||
uploadQzoneImageFromSource,
|
||||
type QzoneCommentResult,
|
||||
type QzoneFeedsResult,
|
||||
type QzoneMsgListResult,
|
||||
type QzonePublishResult,
|
||||
type QzoneUpdateRightResult,
|
||||
type QzoneUploadImageResult,
|
||||
} from '@snowluma/protocol/web/qzone';
|
||||
import type { BridgeContext } from '../bridge-context';
|
||||
@@ -74,6 +76,15 @@ export class QzoneApi {
|
||||
await deleteQzoneMsg(cookieObject, this.ctx.identity.uin, tid);
|
||||
}
|
||||
|
||||
/**
|
||||
* 修改机器人自己空间一条已发说说的查看权限(按 tid)。
|
||||
* `ugcRight` / `targetUins` 含义同 publish(16/128 时 targetUins 必填)。
|
||||
*/
|
||||
async updateRight(tid: string, ugcRight: number, targetUins?: string): Promise<QzoneUpdateRightResult> {
|
||||
const cookieObject = await this.ctx.apis.web.getCookies('qzone.qq.com');
|
||||
return updateQzoneMsgRight(cookieObject, this.ctx.identity.uin, tid, ugcRight, targetUins);
|
||||
}
|
||||
|
||||
/**
|
||||
* 给一条说说点赞/取消赞。`targetUin` 省略时点赞机器人自己空间的说说;
|
||||
* 点赞好友说说时传好友 uin(tid 来自 get_qzone_feeds / get_qzone_msg_list)。
|
||||
|
||||
@@ -117,6 +117,16 @@ describe('apis/qzone', () => {
|
||||
expect(delSpy).toHaveBeenCalledWith({ p_skey: 'PSK' }, '10001', 'TID9');
|
||||
});
|
||||
|
||||
it('updateRight changes a feed\'s visibility on the bot\'s own space', async () => {
|
||||
const getCookies = vi.fn(async () => ({ p_skey: 'PSK' }));
|
||||
const bridge = mockBridge({ apis: { ...mockApiHub(), web: { getCookies } } as never });
|
||||
const updSpy = vi.spyOn(qzoneWeb, 'updateQzoneMsgRight').mockResolvedValue({ ugc_right: 16 });
|
||||
const out = await new QzoneApi(bridge as never).updateRight('TID9', 16, '10002|10003');
|
||||
expect(getCookies).toHaveBeenCalledWith('qzone.qq.com');
|
||||
expect(updSpy).toHaveBeenCalledWith({ p_skey: 'PSK' }, '10001', 'TID9', 16, '10002|10003');
|
||||
expect(out).toEqual({ ugc_right: 16 });
|
||||
});
|
||||
|
||||
it('like defaults the feed owner to self and passes opUin=self + like flag', async () => {
|
||||
const getCookies = vi.fn(async () => ({ p_skey: 'PSK' }));
|
||||
const bridge = mockBridge({ apis: { ...mockApiHub(), web: { getCookies } } as never });
|
||||
|
||||
@@ -8903,6 +8903,93 @@
|
||||
},
|
||||
"category": "扩展"
|
||||
},
|
||||
{
|
||||
"name": "set_qzone_msg_right",
|
||||
"aliases": [],
|
||||
"summary": "修改一条已发说说的查看权限(QQ 空间,按 tid)",
|
||||
"returns": "更新后的权限对象。",
|
||||
"returnsSchema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"ugc_right": {
|
||||
"type": "integer",
|
||||
"description": "更新后的查看权限"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"ugc_right"
|
||||
]
|
||||
},
|
||||
"readOnly": false,
|
||||
"params": [
|
||||
{
|
||||
"name": "tid",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"desc": "说说 tid(来自 get_qzone_msg_list / send_qzone_msg)"
|
||||
},
|
||||
{
|
||||
"name": "ugc_right",
|
||||
"type": "int",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
},
|
||||
"desc": "查看权限:1=所有人可见,4=好友可见,16=部分好友可见,64=仅自己可见,128=部分好友不可见"
|
||||
},
|
||||
{
|
||||
"name": "target_uins",
|
||||
"type": "uint[]",
|
||||
"required": false,
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
}
|
||||
},
|
||||
"desc": "权限作用 QQ 号数组;ugc_right=16 时表示可见名单,128 时表示不可见名单"
|
||||
}
|
||||
],
|
||||
"invariants": [
|
||||
"ugc_right must be one of 1, 4, 16, 64, 128",
|
||||
"target_uins is required when ugc_right is 16 or 128"
|
||||
],
|
||||
"inputSchema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"tid": {
|
||||
"type": "string",
|
||||
"minLength": 1,
|
||||
"description": "说说 tid(来自 get_qzone_msg_list / send_qzone_msg)"
|
||||
},
|
||||
"ugc_right": {
|
||||
"type": "integer",
|
||||
"minimum": 1,
|
||||
"description": "查看权限:1=所有人可见,4=好友可见,16=部分好友可见,64=仅自己可见,128=部分好友不可见"
|
||||
},
|
||||
"target_uins": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
},
|
||||
"description": "权限作用 QQ 号数组;ugc_right=16 时表示可见名单,128 时表示不可见名单"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"tid",
|
||||
"ugc_right"
|
||||
],
|
||||
"additionalProperties": true
|
||||
},
|
||||
"category": "空间"
|
||||
},
|
||||
{
|
||||
"name": "set_restart",
|
||||
"aliases": [],
|
||||
@@ -9834,7 +9921,7 @@
|
||||
},
|
||||
{
|
||||
"category": "空间",
|
||||
"count": 7
|
||||
"count": 8
|
||||
},
|
||||
{
|
||||
"category": "流式接口",
|
||||
|
||||
@@ -8906,6 +8906,93 @@ export const ACTIONS: CatalogAction[] = [
|
||||
},
|
||||
"category": "扩展"
|
||||
},
|
||||
{
|
||||
"name": "set_qzone_msg_right",
|
||||
"aliases": [],
|
||||
"summary": "修改一条已发说说的查看权限(QQ 空间,按 tid)",
|
||||
"returns": "更新后的权限对象。",
|
||||
"returnsSchema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"ugc_right": {
|
||||
"type": "integer",
|
||||
"description": "更新后的查看权限"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"ugc_right"
|
||||
]
|
||||
},
|
||||
"readOnly": false,
|
||||
"params": [
|
||||
{
|
||||
"name": "tid",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"minLength": 1
|
||||
},
|
||||
"desc": "说说 tid(来自 get_qzone_msg_list / send_qzone_msg)"
|
||||
},
|
||||
{
|
||||
"name": "ugc_right",
|
||||
"type": "int",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
},
|
||||
"desc": "查看权限:1=所有人可见,4=好友可见,16=部分好友可见,64=仅自己可见,128=部分好友不可见"
|
||||
},
|
||||
{
|
||||
"name": "target_uins",
|
||||
"type": "uint[]",
|
||||
"required": false,
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
}
|
||||
},
|
||||
"desc": "权限作用 QQ 号数组;ugc_right=16 时表示可见名单,128 时表示不可见名单"
|
||||
}
|
||||
],
|
||||
"invariants": [
|
||||
"ugc_right must be one of 1, 4, 16, 64, 128",
|
||||
"target_uins is required when ugc_right is 16 or 128"
|
||||
],
|
||||
"inputSchema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"tid": {
|
||||
"type": "string",
|
||||
"minLength": 1,
|
||||
"description": "说说 tid(来自 get_qzone_msg_list / send_qzone_msg)"
|
||||
},
|
||||
"ugc_right": {
|
||||
"type": "integer",
|
||||
"minimum": 1,
|
||||
"description": "查看权限:1=所有人可见,4=好友可见,16=部分好友可见,64=仅自己可见,128=部分好友不可见"
|
||||
},
|
||||
"target_uins": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "integer",
|
||||
"minimum": 1
|
||||
},
|
||||
"description": "权限作用 QQ 号数组;ugc_right=16 时表示可见名单,128 时表示不可见名单"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"tid",
|
||||
"ugc_right"
|
||||
],
|
||||
"additionalProperties": true
|
||||
},
|
||||
"category": "空间"
|
||||
},
|
||||
{
|
||||
"name": "set_restart",
|
||||
"aliases": [],
|
||||
@@ -9838,7 +9925,7 @@ export const CATEGORIES: CatalogCategory[] = [
|
||||
},
|
||||
{
|
||||
"category": "空间",
|
||||
"count": 7
|
||||
"count": 8
|
||||
},
|
||||
{
|
||||
"category": "流式接口",
|
||||
|
||||
@@ -147,6 +147,34 @@ export const actions = [
|
||||
},
|
||||
}),
|
||||
|
||||
// set_qzone_msg_right — 修改机器人自己空间一条已发说说的查看权限(按 tid)。
|
||||
// 写操作;ugc_right/target_uins 语义与 send_qzone_msg 一致。
|
||||
defineAction({
|
||||
name: 'set_qzone_msg_right',
|
||||
returns: '更新后的权限对象。',
|
||||
returnsSchema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
ugc_right: { type: 'integer', description: '更新后的查看权限' },
|
||||
},
|
||||
required: ['ugc_right'],
|
||||
},
|
||||
summary: '修改一条已发说说的查看权限(QQ 空间,按 tid)',
|
||||
params: {
|
||||
tid: f.string({ allowEmpty: false }).describe('说说 tid(来自 get_qzone_msg_list / send_qzone_msg)'),
|
||||
ugc_right: f.int({ min: 1 }).describe('查看权限:1=所有人可见,4=好友可见,16=部分好友可见,64=仅自己可见,128=部分好友不可见'),
|
||||
target_uins: f.array(f.uint()).describe('权限作用 QQ 号数组;ugc_right=16 时表示可见名单,128 时表示不可见名单').optional(),
|
||||
},
|
||||
rules: (r) => [
|
||||
r.rule('ugc_right must be one of 1, 4, 16, 64, 128', (p) => QZONE_UGC_RIGHTS.has(p.ugc_right)),
|
||||
r.rule('target_uins is required when ugc_right is 16 or 128', (p) => (p.ugc_right !== 16 && p.ugc_right !== 128) || !!p.target_uins?.length),
|
||||
],
|
||||
run: async (p, ctx) => {
|
||||
const res = await ctx.bridge.apis.qzone.updateRight(p.tid, p.ugc_right, p.target_uins?.join('|'));
|
||||
return okResponse(res as unknown as JsonValue);
|
||||
},
|
||||
}),
|
||||
|
||||
// like_qzone — 给一条说说点赞。target_uin 省略=机器人自己空间;点赞好友说说传其 uin。
|
||||
// abstime=该说说的发表时间(unix 秒,来自 get_qzone_feeds/get_qzone_msg_list),
|
||||
// 传真实值更可靠;不传按 0。写操作;高频点赞会被 Qzone 风控,调用方需限流。
|
||||
|
||||
@@ -62,4 +62,31 @@ describe('qzone actions', () => {
|
||||
expect(publish).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('set_qzone_msg_right joins target_uins with | and passes through', async () => {
|
||||
const updateRight = vi.fn().mockResolvedValue({ ugc_right: 16 });
|
||||
const handler = makeHandler({ updateRight });
|
||||
|
||||
const res = await handler.handle('set_qzone_msg_right', {
|
||||
tid: 'T1',
|
||||
ugc_right: 16,
|
||||
target_uins: [10001, 10002],
|
||||
});
|
||||
|
||||
expect(res).toMatchObject({ status: 'ok', retcode: 0, data: { ugc_right: 16 } });
|
||||
expect(updateRight).toHaveBeenCalledWith('T1', 16, '10001|10002');
|
||||
});
|
||||
|
||||
it('set_qzone_msg_right rejects invalid ugc_right and 16/128 without target_uins', async () => {
|
||||
const updateRight = vi.fn();
|
||||
const handler = makeHandler({ updateRight });
|
||||
|
||||
const bad = await handler.handle('set_qzone_msg_right', { tid: 'T1', ugc_right: 2 });
|
||||
expect(bad).toMatchObject({ status: 'failed' });
|
||||
|
||||
const missing = await handler.handle('set_qzone_msg_right', { tid: 'T1', ugc_right: 128 });
|
||||
expect(missing).toMatchObject({ status: 'failed' });
|
||||
|
||||
expect(updateRight).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
});
|
||||
|
||||
@@ -64,20 +64,30 @@ export interface QzoneMsgListResult {
|
||||
|
||||
/**
|
||||
* Parse a Qzone CGI body that may be raw JSON or a JSONP callback wrapper
|
||||
* (`_Callback({...});` / `callback({...})`). We slice from the first `{`
|
||||
* to the last `}` and JSON.parse that — robust to either form without
|
||||
* (`_Callback({...});` / `callback({...})`). We first attempt to slice from
|
||||
* the first `{` to the last `}`, when failed attempt from the first `back({`
|
||||
* to the last `})` and JSON.parse that — robust to either form without
|
||||
* pinning the callback name, which Qzone varies. Throws if no object body
|
||||
* is present (e.g. an HTML error page), which the caller turns into a
|
||||
* failed response rather than a silent empty list.
|
||||
*/
|
||||
export function parseQzoneJson<T>(text: string): T {
|
||||
const s = text.trim();
|
||||
const start = s.indexOf('{');
|
||||
const end = s.lastIndexOf('}');
|
||||
try {
|
||||
const start = s.indexOf('{');
|
||||
const end = s.lastIndexOf('}');
|
||||
if (start !== -1 && end !== -1 && end > start) {
|
||||
return JSON.parse(s.slice(start, end + 1)) as T;
|
||||
}
|
||||
} catch {
|
||||
|
||||
}
|
||||
const start = s.indexOf('back({');
|
||||
const end = s.lastIndexOf('})');
|
||||
if (start === -1 || end === -1 || end < start) {
|
||||
throw new Error('invalid response from qzone api');
|
||||
}
|
||||
return JSON.parse(s.slice(start, end + 1)) as T;
|
||||
return JSON.parse(s.slice(start + 5, end + 1)) as T;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -1040,3 +1050,246 @@ export async function commentQzoneMsg(
|
||||
const commentId = data.commentid ?? data.commentId;
|
||||
return { comment_id: commentId !== undefined ? String(commentId) : '' };
|
||||
}
|
||||
|
||||
// ─────── 改说说权限 (update right) — emotion_cgi_msgdetail_v6 + emotion_cgi_update ───────
|
||||
// Changes the view permission (ugc_right) of an EXISTING 说说. The update CGI
|
||||
// is not a partial patch — it re-submits the whole feed (content, richval,
|
||||
// pic_bo, …), so the flow is two-step: GET the feed detail from
|
||||
// emotion_cgi_msgdetail_v6 (NOTE: proxied domain is taotao.qq.com, not
|
||||
// taotao.qzone.qq.com — that's what the working impl hits), rebuild the full
|
||||
// publish-shaped payload from it, override ugc_right/allow_uins, and POST to
|
||||
// emotion_cgi_update. Both the detail param set and the payload rebuild are
|
||||
// CONFIRMED against php-qzone/qzone.class.php updateRight (live-verified
|
||||
// there); success signal is `subcode == 0`, same envelope as the siblings.
|
||||
// WRITE OP — rate-limit like publish.
|
||||
|
||||
interface RawMsgDetailPic {
|
||||
pic_id?: string;
|
||||
pictype?: number | string;
|
||||
type?: number | string;
|
||||
height?: number | string;
|
||||
b_height?: number | string;
|
||||
width?: number | string;
|
||||
b_width?: number | string;
|
||||
smallurl?: string;
|
||||
url1?: string;
|
||||
url2?: string;
|
||||
url3?: string;
|
||||
}
|
||||
|
||||
interface RawMsgDetailResponse {
|
||||
code?: number;
|
||||
subcode?: number;
|
||||
message?: string;
|
||||
msg?: string;
|
||||
tid?: string;
|
||||
uin?: number | string;
|
||||
content?: string;
|
||||
conlist?: Array<{ con?: string }> | null;
|
||||
pic?: RawMsgDetailPic[] | null;
|
||||
richtype?: number | string;
|
||||
richval?: string;
|
||||
pic_template?: string;
|
||||
special_url?: string;
|
||||
t1_subtype?: number | string;
|
||||
subrichtype?: number | string;
|
||||
feedversion?: number | string;
|
||||
ver?: number | string;
|
||||
ugc_right?: number | string;
|
||||
to_sign?: number | string;
|
||||
ugcright_id?: string;
|
||||
code_version?: number | string;
|
||||
}
|
||||
|
||||
interface RawUpdateResponse {
|
||||
code?: number;
|
||||
subcode?: number;
|
||||
message?: string;
|
||||
msg?: string;
|
||||
ugc_right?: number | string;
|
||||
}
|
||||
|
||||
/** Result of changing a 说说's view permission. */
|
||||
export interface QzoneUpdateRightResult {
|
||||
[key: string]: JsonValue;
|
||||
/** The feed's ugc_right after the update (echoed by the server when present). */
|
||||
ugc_right: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Rebuild the full emotion_cgi_update payload from a msgdetail_v6 response.
|
||||
* Field-for-field port of php-qzone's buildUpdatePayloadFromDetail: richval
|
||||
* strings are reconstructed from each `pic[].pic_id` (`,albumid,lloc,sloc,
|
||||
* type,height,width,,0,0`, tab-joined), `pic_bo` from the `bo=` query param
|
||||
* of any picture URL variant (group tab-doubled), and the content from
|
||||
* `conlist` when present. Exported for tests; THROWS on a detail body it
|
||||
* cannot rebuild from (missing tid, or an image post whose pic info is
|
||||
* unusable) rather than submitting a lossy update.
|
||||
*/
|
||||
export function buildQzoneUpdatePayload(detail: RawMsgDetailResponse, selfUin: string): URLSearchParams {
|
||||
if (!detail.tid) {
|
||||
throw new Error('qzone msg detail is missing tid');
|
||||
}
|
||||
|
||||
const pics = detail.pic ?? [];
|
||||
const richtype = detail.richtype !== undefined ? Number(detail.richtype) : (pics.length === 0 ? '' : 1);
|
||||
const richvals: string[] = [];
|
||||
const picBoItems: string[] = [];
|
||||
|
||||
for (const pic of pics) {
|
||||
const picId = String(pic.pic_id ?? '');
|
||||
if (!picId) continue;
|
||||
|
||||
const parts = picId.split(',');
|
||||
const albumId = parts[1] ?? '';
|
||||
const lloc = parts[2] ?? '';
|
||||
if (!albumId || !lloc) {
|
||||
throw new Error('qzone msg detail has unsupported pic info');
|
||||
}
|
||||
|
||||
const sloc = lloc;
|
||||
const picType = String(pic.pictype ?? pic.type ?? 22);
|
||||
const height = String(pic.height ?? pic.b_height ?? 0);
|
||||
const width = String(pic.width ?? pic.b_width ?? 0);
|
||||
richvals.push(`,${albumId},${lloc},${sloc},${picType},${height},${width},,0,0`);
|
||||
|
||||
for (const urlKey of ['smallurl', 'url1', 'url2', 'url3'] as const) {
|
||||
const picUrl = pic[urlKey];
|
||||
if (!picUrl) continue;
|
||||
const match = /[?&]bo=([^&#]+)/.exec(picUrl);
|
||||
if (match) {
|
||||
picBoItems.push(decodeURIComponent(match[1]!));
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (richtype === 1 && richvals.length === 0) {
|
||||
throw new Error('qzone image post detail is missing pic info');
|
||||
}
|
||||
|
||||
let content = detail.content ?? '';
|
||||
const conParts = (detail.conlist ?? [])
|
||||
.map((c) => c.con)
|
||||
.filter((c): c is string => c !== undefined);
|
||||
if (conParts.length > 0) {
|
||||
content = conParts.join('').trim();
|
||||
}
|
||||
|
||||
const subrichtype = detail.t1_subtype ?? detail.subrichtype ?? (richvals.length === 0 ? '' : 1);
|
||||
const boGroup = picBoItems.join(',');
|
||||
const picBo = boGroup ? `${boGroup}\t${boGroup}` : '';
|
||||
|
||||
const hostuin = String(detail.uin ?? selfUin);
|
||||
return new URLSearchParams({
|
||||
syn_tweet_verson: '1',
|
||||
tid: String(detail.tid),
|
||||
paramstr: '1',
|
||||
pic_template: detail.pic_template ?? '',
|
||||
richtype: String(richtype),
|
||||
richval: richvals.length > 0 ? richvals.join('\t') : (detail.richval ?? ''),
|
||||
special_url: detail.special_url ?? '',
|
||||
subrichtype: String(subrichtype),
|
||||
pic_bo: picBo,
|
||||
con: content,
|
||||
feedversion: String(detail.feedversion ?? 1),
|
||||
ver: String(detail.ver ?? 1),
|
||||
ugc_right: String(Number(detail.ugc_right ?? 1)),
|
||||
to_sign: String(Number(detail.to_sign ?? 0)),
|
||||
ugcright_id: String(detail.ugcright_id ?? detail.tid),
|
||||
hostuin,
|
||||
code_version: String(detail.code_version ?? 1),
|
||||
format: 'fs',
|
||||
qzreferrer: `https://user.qzone.qq.com/${hostuin}`,
|
||||
});
|
||||
}
|
||||
|
||||
/** Fetch one 说说's full detail (the update payload's source of truth). */
|
||||
async function getQzoneMsgDetail(
|
||||
cookieObject: Record<string, string>,
|
||||
selfUin: string,
|
||||
tid: string,
|
||||
): Promise<RawMsgDetailResponse> {
|
||||
const bkn = getBknFromCookie(cookieObject);
|
||||
const url = `https://h5.qzone.qq.com/proxy/domain/taotao.qq.com/cgi-bin/emotion_cgi_msgdetail_v6?${new URLSearchParams(
|
||||
{
|
||||
tid,
|
||||
uin: selfUin,
|
||||
t1_source: '1',
|
||||
not_trunc_con: '1',
|
||||
need_right: '1',
|
||||
not_adapt_outpic: '1',
|
||||
g_tk: bkn,
|
||||
},
|
||||
).toString()}`;
|
||||
|
||||
const text = await RequestUtil.HttpGetText(url, 'GET', '', {
|
||||
Cookie: cookieToString(cookieObject),
|
||||
});
|
||||
log.trace('getQzoneMsgDetail raw body (tid=%s): %s', tid, text);
|
||||
const data = parseQzoneJson<RawMsgDetailResponse>(text);
|
||||
|
||||
const code = data.subcode ?? data.code ?? -1;
|
||||
if (code !== 0) {
|
||||
log.warn('getQzoneMsgDetail: non-zero code (tid=%s) code=%d msg=%s', tid, code, data.message ?? data.msg);
|
||||
throw new Error(`qzone msg detail failed: code=${code} ${data.message ?? data.msg ?? ''}`.trim());
|
||||
}
|
||||
return data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Change the view permission of an existing 说说 (`tid`, on the bot's own
|
||||
* space) via the msgdetail_v6 → emotion_cgi_update two-step. `ugcRight` is
|
||||
* one of 1(所有人)/4(好友)/16(部分可见)/64(仅自己)/128(部分不可见);
|
||||
* `targetUins` (|-separated QQ numbers) is required for 16/128 and ignored
|
||||
* otherwise. Errors PROPAGATE from both steps: a transport failure, a
|
||||
* non-zero Qzone code on the detail fetch (unknown/foreign tid, auth), an
|
||||
* unrebuildable detail, or a non-zero `subcode` on the update all throw.
|
||||
*/
|
||||
export async function updateQzoneMsgRight(
|
||||
cookieObject: Record<string, string>,
|
||||
selfUin: string,
|
||||
tid: string,
|
||||
ugcRight: number,
|
||||
targetUins?: string,
|
||||
): Promise<QzoneUpdateRightResult> {
|
||||
if (!cookieObject || typeof cookieObject !== 'object') {
|
||||
throw new Error('cookieObject is required');
|
||||
}
|
||||
if (!tid) {
|
||||
throw new Error('tid is required');
|
||||
}
|
||||
|
||||
const right = normalizeQzoneUgcRight(ugcRight);
|
||||
const effectiveTargetUins = right === 16 || right === 128 ? normalizeTargetUins(targetUins) : '';
|
||||
if ((right === 16 || right === 128) && !effectiveTargetUins) {
|
||||
throw new Error('target_uins is required when ugc_right is 16 or 128');
|
||||
}
|
||||
|
||||
const detail = await getQzoneMsgDetail(cookieObject, selfUin, tid);
|
||||
const bodyParams = buildQzoneUpdatePayload(detail, selfUin);
|
||||
bodyParams.set('ugc_right', String(right));
|
||||
if (effectiveTargetUins) bodyParams.set('allow_uins', effectiveTargetUins);
|
||||
|
||||
const bkn = getBknFromCookie(cookieObject);
|
||||
const url = `https://h5.qzone.qq.com/proxy/domain/taotao.qzone.qq.com/cgi-bin/emotion_cgi_update?g_tk=${bkn}`;
|
||||
const text = await RequestUtil.HttpGetText(url, 'POST', bodyParams.toString(), {
|
||||
Cookie: cookieToString(cookieObject),
|
||||
'Content-Type': 'application/x-www-form-urlencoded',
|
||||
});
|
||||
// format=fs wraps the JSON in a callback (`frameElement.callback({...});`
|
||||
// or `_Callback({...});`) — parseQzoneJson's first-{-to-last-} slice
|
||||
// handles every observed variant.
|
||||
const data = parseQzoneJson<RawUpdateResponse>(text);
|
||||
|
||||
if (typeof data.subcode === 'number' && data.subcode !== 0) {
|
||||
log.warn('updateQzoneMsgRight: non-zero subcode (tid=%s) subcode=%d msg=%s', tid, data.subcode, data.message ?? data.msg);
|
||||
throw new Error(`qzone update right failed: subcode=${data.subcode} ${data.message ?? data.msg ?? ''}`.trim());
|
||||
}
|
||||
if (typeof data.code === 'number' && data.code !== 0) {
|
||||
log.warn('updateQzoneMsgRight: non-zero code (tid=%s) code=%d msg=%s', tid, data.code, data.message ?? data.msg);
|
||||
throw new Error(`qzone update right failed: code=${data.code} ${data.message ?? data.msg ?? ''}`.trim());
|
||||
}
|
||||
|
||||
return { ugc_right: Number(data.ugc_right ?? right) };
|
||||
}
|
||||
|
||||
@@ -0,0 +1,143 @@
|
||||
import { describe, it, expect, vi, afterEach } from 'vitest';
|
||||
import { buildQzoneUpdatePayload, updateQzoneMsgRight } from '@snowluma/protocol/web/qzone';
|
||||
import { RequestUtil } from '@snowluma/protocol/web/request-util';
|
||||
|
||||
// updateQzoneMsgRight is the two-step msgdetail_v6 → emotion_cgi_update flow.
|
||||
// The real logic is the payload REBUILD (detail → publish-shaped form body,
|
||||
// ported from php-qzone's live-verified updateRight): richval reconstruction
|
||||
// from pic_id, pic_bo from the `bo=` query param, conlist → con. We pin that
|
||||
// plus both request shapes and the throw contracts.
|
||||
|
||||
const cookies = { p_skey: 'PSK', skey: 'SK', uin: 'o10000', p_uin: 'o10000' };
|
||||
|
||||
describe('qzone / buildQzoneUpdatePayload', () => {
|
||||
it('rebuilds a text-only payload with ugcright_id defaulting to tid', () => {
|
||||
const body = buildQzoneUpdatePayload(
|
||||
{ tid: 'T1', uin: 10000, content: 'hello', ugc_right: 1 },
|
||||
'10000',
|
||||
);
|
||||
expect(body.get('tid')).toBe('T1');
|
||||
expect(body.get('con')).toBe('hello');
|
||||
expect(body.get('richtype')).toBe('');
|
||||
expect(body.get('richval')).toBe('');
|
||||
expect(body.get('pic_bo')).toBe('');
|
||||
expect(body.get('ugcright_id')).toBe('T1');
|
||||
expect(body.get('hostuin')).toBe('10000');
|
||||
expect(body.get('format')).toBe('fs');
|
||||
});
|
||||
|
||||
it('rebuilds richval from pic_id and pic_bo from the bo= query param', () => {
|
||||
const body = buildQzoneUpdatePayload(
|
||||
{
|
||||
tid: 'T2',
|
||||
uin: 10000,
|
||||
content: 'pics',
|
||||
conlist: [{ con: 'pi' }, { con: 'cs' }],
|
||||
richtype: 1,
|
||||
pic: [
|
||||
{
|
||||
pic_id: 'X,ALBUM1,LLOC1,extra',
|
||||
pictype: 22,
|
||||
height: 800,
|
||||
width: 600,
|
||||
url1: 'https://photo.example/a.jpg?bo=abc%2Cdef&x=1',
|
||||
},
|
||||
],
|
||||
},
|
||||
'10000',
|
||||
);
|
||||
expect(body.get('con')).toBe('pics');
|
||||
expect(body.get('richtype')).toBe('1');
|
||||
expect(body.get('richval')).toBe(',ALBUM1,LLOC1,LLOC1,22,800,600,,0,0');
|
||||
expect(body.get('pic_bo')).toBe('abc,def\tabc,def');
|
||||
});
|
||||
|
||||
it('throws when an image post detail carries unusable pic info', () => {
|
||||
expect(() =>
|
||||
buildQzoneUpdatePayload({ tid: 'T3', richtype: 1, pic: [{ pic_id: 'broken' }] }, '10000'),
|
||||
).toThrow('unsupported pic info');
|
||||
expect(() => buildQzoneUpdatePayload({ tid: 'T3', richtype: 1, pic: [] }, '10000')).toThrow(
|
||||
'missing pic info',
|
||||
);
|
||||
});
|
||||
|
||||
it('throws when the detail has no tid', () => {
|
||||
expect(() => buildQzoneUpdatePayload({}, '10000')).toThrow('missing tid');
|
||||
});
|
||||
});
|
||||
|
||||
describe('qzone / updateQzoneMsgRight (HTTP layer)', () => {
|
||||
afterEach(() => vi.restoreAllMocks());
|
||||
|
||||
const detailBody =
|
||||
'_Callback({"code":0,"subcode":0,"tid":"T1","uin":10000,"content":"hello","ugc_right":1});';
|
||||
|
||||
it('GETs the detail then POSTs the rebuilt payload with the new ugc_right', async () => {
|
||||
const spy = vi
|
||||
.spyOn(RequestUtil, 'HttpGetText')
|
||||
.mockResolvedValueOnce(detailBody)
|
||||
.mockResolvedValueOnce('frameElement.callback({"code":0,"subcode":0,"ugc_right":64});');
|
||||
|
||||
const out = await updateQzoneMsgRight(cookies, '10000', 'T1', 64);
|
||||
expect(out).toEqual({ ugc_right: 64 });
|
||||
|
||||
const [detailUrl, detailMethod] = spy.mock.calls[0]!;
|
||||
expect(detailMethod).toBe('GET');
|
||||
expect(detailUrl).toContain(
|
||||
'https://h5.qzone.qq.com/proxy/domain/taotao.qq.com/cgi-bin/emotion_cgi_msgdetail_v6?',
|
||||
);
|
||||
const dq = new URLSearchParams((detailUrl as string).split('?')[1]);
|
||||
expect(dq.get('tid')).toBe('T1');
|
||||
expect(dq.get('uin')).toBe('10000');
|
||||
|
||||
const [updateUrl, updateMethod, updateBody] = spy.mock.calls[1]!;
|
||||
expect(updateMethod).toBe('POST');
|
||||
expect(updateUrl).toContain(
|
||||
'https://h5.qzone.qq.com/proxy/domain/taotao.qzone.qq.com/cgi-bin/emotion_cgi_update?',
|
||||
);
|
||||
const uq = new URLSearchParams(updateBody as string);
|
||||
expect(uq.get('tid')).toBe('T1');
|
||||
expect(uq.get('con')).toBe('hello');
|
||||
expect(uq.get('ugc_right')).toBe('64');
|
||||
expect(uq.get('allow_uins')).toBeNull();
|
||||
});
|
||||
|
||||
it('sets allow_uins (deduped) for ugc_right 16 and requires it', async () => {
|
||||
const spy = vi
|
||||
.spyOn(RequestUtil, 'HttpGetText')
|
||||
.mockResolvedValueOnce(detailBody)
|
||||
.mockResolvedValueOnce('{"code":0,"subcode":0}');
|
||||
|
||||
await updateQzoneMsgRight(cookies, '10000', 'T1', 16, '10001|10001|10002');
|
||||
const uq = new URLSearchParams(spy.mock.calls[1]![2] as string);
|
||||
expect(uq.get('ugc_right')).toBe('16');
|
||||
expect(uq.get('allow_uins')).toBe('10001|10002');
|
||||
|
||||
await expect(updateQzoneMsgRight(cookies, '10000', 'T1', 128)).rejects.toThrow(
|
||||
'target_uins is required',
|
||||
);
|
||||
});
|
||||
|
||||
it('rejects an invalid ugc_right before any request', async () => {
|
||||
const spy = vi.spyOn(RequestUtil, 'HttpGetText');
|
||||
await expect(updateQzoneMsgRight(cookies, '10000', 'T1', 2)).rejects.toThrow(
|
||||
'ugc_right must be one of',
|
||||
);
|
||||
expect(spy).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('throws on a non-zero detail code and skips the update POST', async () => {
|
||||
const spy = vi
|
||||
.spyOn(RequestUtil, 'HttpGetText')
|
||||
.mockResolvedValueOnce('{"code":-3000,"subcode":-3000,"message":"need login"}');
|
||||
await expect(updateQzoneMsgRight(cookies, '10000', 'T1', 64)).rejects.toThrow('code=-3000');
|
||||
expect(spy).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('throws on a non-zero update subcode', async () => {
|
||||
vi.spyOn(RequestUtil, 'HttpGetText')
|
||||
.mockResolvedValueOnce(detailBody)
|
||||
.mockResolvedValueOnce('{"code":0,"subcode":-200,"message":"denied"}');
|
||||
await expect(updateQzoneMsgRight(cookies, '10000', 'T1', 64)).rejects.toThrow('subcode=-200');
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user