From a704f1294564ef90046cffae607deefd6cd68c57 Mon Sep 17 00:00:00 2001 From: DrSmoothl <1787882683@qq.com> Date: Sat, 20 Jun 2026 01:47:50 +0800 Subject: [PATCH] =?UTF-8?q?feat(qzone):=20delete=5Fqzone=5Fmsg=20=E2=80=94?= =?UTF-8?q?=20delete=20a=20=E8=AF=B4=E8=AF=B4=20by=20tid=20via=20web=20API?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit deleteQzoneMsg POSTs a form-urlencoded tid to taotao.qzone.qq.com's emotion_cgi_delete_v6 (proxied through h5.qzone), on the bot's own space. Success has no positive payload beyond code 0, so the contract is throw-on-non-zero-code (foreign/unknown tid or auth failure); the server only deletes feeds the hostUin owns. Rejects empty tid pre-flight. - core: QzoneApi.delete; onebot: delete_qzone_msg action; regen catalog. - tests: tid form-body/url/headers lock, empty-tid preflight, non-zero code throw, and bridge self-space threading. --- packages/core/src/bridge/apis/qzone.ts | 7 +++ packages/core/tests/actions/qzone.test.ts | 9 ++++ packages/mcp/src/generated/catalog.ts | 36 ++++++++++++++- packages/onebot/src/actions/qzone.ts | 18 ++++++++ packages/protocol/src/web/qzone.ts | 55 +++++++++++++++++++++++ packages/protocol/tests/web/qzone.test.ts | 36 ++++++++++++++- 6 files changed, 159 insertions(+), 2 deletions(-) diff --git a/packages/core/src/bridge/apis/qzone.ts b/packages/core/src/bridge/apis/qzone.ts index 60ad975a..d462fd0c 100644 --- a/packages/core/src/bridge/apis/qzone.ts +++ b/packages/core/src/bridge/apis/qzone.ts @@ -1,4 +1,5 @@ import { + deleteQzoneMsg, getQzoneFeeds, getQzoneMsgList, publishQzoneMsg, @@ -41,4 +42,10 @@ export class QzoneApi { const cookieObject = await this.ctx.apis.web.getCookies('qzone.qq.com'); return publishQzoneMsg(cookieObject, this.ctx.identity.uin, content); } + + /** 删除机器人自己空间的一条说说(按 tid)。 */ + async delete(tid: string): Promise { + const cookieObject = await this.ctx.apis.web.getCookies('qzone.qq.com'); + await deleteQzoneMsg(cookieObject, this.ctx.identity.uin, tid); + } } diff --git a/packages/core/tests/actions/qzone.test.ts b/packages/core/tests/actions/qzone.test.ts index fe6afbd5..c3ecf391 100644 --- a/packages/core/tests/actions/qzone.test.ts +++ b/packages/core/tests/actions/qzone.test.ts @@ -58,4 +58,13 @@ describe('apis/qzone', () => { expect(pubSpy).toHaveBeenCalledWith({ p_skey: 'PSK' }, '10001', 'hello'); expect(out).toEqual({ tid: 'T', time: 1 }); }); + + it('delete removes a feed by tid from the bot\'s own space', async () => { + const getCookies = vi.fn(async () => ({ p_skey: 'PSK' })); + const bridge = mockBridge({ apis: { ...mockApiHub(), web: { getCookies } } as never }); + const delSpy = vi.spyOn(qzoneWeb, 'deleteQzoneMsg').mockResolvedValue(); + await new QzoneApi(bridge as never).delete('TID9'); + expect(getCookies).toHaveBeenCalledWith('qzone.qq.com'); + expect(delSpy).toHaveBeenCalledWith({ p_skey: 'PSK' }, '10001', 'TID9'); + }); }); diff --git a/packages/mcp/src/generated/catalog.ts b/packages/mcp/src/generated/catalog.ts index d1edc9d4..69a0f8cf 100644 --- a/packages/mcp/src/generated/catalog.ts +++ b/packages/mcp/src/generated/catalog.ts @@ -1015,6 +1015,40 @@ export const ACTIONS: CatalogAction[] = [ }, "category": "消息" }, + { + "name": "delete_qzone_msg", + "aliases": [], + "summary": "删除一条说说(QQ 空间,按 tid)", + "readOnly": false, + "params": [ + { + "name": "tid", + "type": "string", + "required": true, + "schema": { + "type": "string", + "minLength": 1 + }, + "desc": "说说 tid(来自 get_qzone_msg_list / send_qzone_msg)" + } + ], + "invariants": [], + "inputSchema": { + "type": "object", + "properties": { + "tid": { + "type": "string", + "minLength": 1, + "description": "说说 tid(来自 get_qzone_msg_list / send_qzone_msg)" + } + }, + "required": [ + "tid" + ], + "additionalProperties": true + }, + "category": "空间" + }, { "name": "do_group_album_comment", "aliases": [], @@ -6727,6 +6761,6 @@ export const CATEGORIES: CatalogCategory[] = [ }, { "category": "空间", - "count": 3 + "count": 4 } ]; diff --git a/packages/onebot/src/actions/qzone.ts b/packages/onebot/src/actions/qzone.ts index 06471a08..afe0ef95 100644 --- a/packages/onebot/src/actions/qzone.ts +++ b/packages/onebot/src/actions/qzone.ts @@ -67,6 +67,24 @@ export const actions = [ } }, }), + + // delete_qzone_msg — 删除机器人自己空间的一条说说(按 tid)。写操作。 + defineAction({ + name: 'delete_qzone_msg', + summary: '删除一条说说(QQ 空间,按 tid)', + params: { + tid: f.string({ allowEmpty: false }).describe('说说 tid(来自 get_qzone_msg_list / send_qzone_msg)'), + }, + run: async (p, ctx) => { + try { + await ctx.bridge.apis.qzone.delete(p.tid); + return okResponse(null); + } catch (error) { + const message = error instanceof Error ? error.message : 'failed to delete qzone msg'; + return failedResponse(RETCODE.INTERNAL_ERROR, message); + } + }, + }), ]; export function register(h: ApiHandler, ctx: ApiActionContext): void { diff --git a/packages/protocol/src/web/qzone.ts b/packages/protocol/src/web/qzone.ts index 3ab14bb9..6241cc54 100644 --- a/packages/protocol/src/web/qzone.ts +++ b/packages/protocol/src/web/qzone.ts @@ -394,3 +394,58 @@ export async function publishQzoneMsg( // numeric fallback) uniformly. return { tid: String(tid), time: Number(data.t1_time ?? data.now ?? 0) }; } + +// ─────────────── 删说说 (delete emotion) — emotion_cgi_delete_v6 ─────────────── +// Deletes one of the bot's OWN 说说 by tid. Same form-POST mechanics as +// publish. No positive payload on success beyond `code: 0`, so the contract +// is throw-on-non-zero-code; a clean parse with code 0 (or absent) is a +// success. WRITE OP. + +interface RawDeleteResponse { + code?: number; + subcode?: number; + message?: string; +} + +/** + * Delete a 说说 by `tid` via taotao.qzone.qq.com's emotion_cgi_delete_v6 CGI + * (proxied through h5.qzone.qq.com), on the bot's own space. Resolves on + * success; THROWS on a transport failure or a non-zero Qzone `code` (e.g. an + * unknown/foreign tid, or an auth failure). Only the bot's own feeds can be + * deleted — the server rejects a tid the `hostUin` doesn't own. + */ +export async function deleteQzoneMsg( + cookieObject: Record, + hostUin: string, + tid: string, +): Promise { + if (!cookieObject || typeof cookieObject !== 'object') { + throw new Error('cookieObject is required'); + } + if (!tid) { + throw new Error('tid is required'); + } + + const bkn = getBknFromCookie(cookieObject); + const url = `https://h5.qzone.qq.com/proxy/domain/taotao.qzone.qq.com/cgi-bin/emotion_cgi_delete_v6?g_tk=${bkn}`; + const body = new URLSearchParams({ + hostuin: hostUin, + tid, + t1_source: '1', + code_version: '1', + format: 'json', + json: '1', + qzreferrer: `https://user.qzone.qq.com/${hostUin}`, + }).toString(); + + const text = await RequestUtil.HttpGetText(url, 'POST', body, { + Cookie: cookieToString(cookieObject), + 'Content-Type': 'application/x-www-form-urlencoded', + }); + const data = parseQzoneJson(text); + + if (typeof data.code === 'number' && data.code !== 0) { + log.warn('deleteQzoneMsg: non-zero code (uin=%s tid=%s) code=%d msg=%s', hostUin, tid, data.code, data.message); + throw new Error(`qzone delete failed: code=${data.code} ${data.message ?? ''}`.trim()); + } +} diff --git a/packages/protocol/tests/web/qzone.test.ts b/packages/protocol/tests/web/qzone.test.ts index 8b7e47c1..8fca7d2c 100644 --- a/packages/protocol/tests/web/qzone.test.ts +++ b/packages/protocol/tests/web/qzone.test.ts @@ -1,5 +1,5 @@ import { describe, it, expect, vi, afterEach } from 'vitest'; -import { getQzoneFeeds, getQzoneMsgList, mapFeeds, mapMsgList, parseQzoneJson, publishQzoneMsg } from '@snowluma/protocol/web/qzone'; +import { deleteQzoneMsg, getQzoneFeeds, getQzoneMsgList, mapFeeds, mapMsgList, parseQzoneJson, publishQzoneMsg } from '@snowluma/protocol/web/qzone'; import { RequestUtil } from '@snowluma/protocol/web/request-util'; // The 说说 list comes from taotao.qzone.qq.com's emotion_cgi_msglist_v6 CGI, @@ -243,3 +243,37 @@ describe('qzone / publishQzoneMsg (HTTP layer)', () => { await expect(publishQzoneMsg(cookies, '10000', 'hi')).rejects.toThrow('缺少 tid'); }); }); + +describe('qzone / deleteQzoneMsg (HTTP layer)', () => { + afterEach(() => vi.restoreAllMocks()); + + it('POSTs the tid form body to the proxied delete CGI and resolves on code 0', async () => { + const spy = vi.spyOn(RequestUtil, 'HttpGetText').mockResolvedValue('{"code":0,"subcode":0,"message":""}'); + + await expect(deleteQzoneMsg(cookies, '10000', 'TID123')).resolves.toBeUndefined(); + + const [url, method, body, headers] = spy.mock.calls[0]!; + expect(method).toBe('POST'); + expect(url).toBe( + `https://h5.qzone.qq.com/proxy/domain/taotao.qzone.qq.com/cgi-bin/emotion_cgi_delete_v6?g_tk=${expectedGtk}`, + ); + const h = headers as Record; + expect(h['Content-Type']).toBe('application/x-www-form-urlencoded'); + expect(h.Cookie).toContain('p_skey=PSK'); + const form = new URLSearchParams(body as string); + expect(form.get('tid')).toBe('TID123'); + expect(form.get('hostuin')).toBe('10000'); + expect(form.get('format')).toBe('json'); + }); + + it('rejects an empty tid before any request', async () => { + const spy = vi.spyOn(RequestUtil, 'HttpGetText'); + await expect(deleteQzoneMsg(cookies, '10000', '')).rejects.toThrow('tid is required'); + expect(spy).not.toHaveBeenCalled(); + }); + + it('throws on a non-zero qzone code (foreign/unknown tid or auth failure)', async () => { + vi.spyOn(RequestUtil, 'HttpGetText').mockResolvedValue('{"code":-4001,"message":"no permission"}'); + await expect(deleteQzoneMsg(cookies, '10000', 'TID123')).rejects.toThrow('code=-4001'); + }); +});