specific-ai-cli 0.0.0-stage → 0.1.1

package/dist/platforms/kuaishou/web/api.js

@@ -0,0 +1,694 @@
+import { SpecificAIError } from '../../../core/errors.js';
+import { compactJson, jsonLoads, quote } from '../../../core/py.js';
+import * as rand from '../../../core/rand.js';
+import { liveContext } from './client.js';
+import * as gql from './gql.js';
+import { genLikeToken } from './oracle.js';
+import { ACCEPT_AXIOS, ACCEPT_ENCODING, ACCEPT_LANGUAGE, ACCEPT_LANGUAGE_SHORT, buildHeaders, CP, ID_HOST, LIVE, LIVE_SENTRY_BAGGAGE, PASSPORT, PRODUCT_LIVE, SEQUENCES, UA, WWW } from './profile.js';
+import { mergeIssued, responseCookies } from './session.js';
+/**
+ * 上游请求构造，一个函数对应一个上游方法，字段与顺序照抄（对拍测试逐字节比较）：
+ * ks_apis/kuaishou_api.py（www）、login_api.py（passport / STS）、live_api.py（直播）、publish_api.py（创作者中心）、
+ * utils/ksuploader.py（分片上传）。
+ */
+// ================================================================ www：KuaishouAPI
+/** get_feed_hot：首屏是 0 字节 POST，翻页发字面量 `{}`。 */
+export function feedHot(ks, pcursor = '') {
+    return ks.wwwPost('/rest/v/feed/hot', pcursor ? {} : null);
+}
+/** get_video_detail：visionVideoDetail GraphQL。 */
+export async function videoDetail(ks, photoId) {
+    const data = await ks.graphql('visionVideoDetail', { photoId, page: 'detail' }, gql.VIDEO_DETAIL, `${WWW}/short-video/${photoId}`, 'www_graphql_detail');
+    const detail = data?.data?.visionVideoDetail;
+    if (!detail || typeof detail !== 'object')
+        throw new SpecificAIError('UPSTREAM', 'visionVideoDetail 没有返回作品', { detail: { photoId } });
+    if (detail.status !== 1)
+        throw new SpecificAIError('UPSTREAM', `作品不可见或不存在（status=${detail.status}）`, { detail: { photoId, status: detail.status } });
+    return detail;
+}
+/** get_short_video_reco：详情页旁路的推荐流。 */
+export async function shortVideoReco(ks, photoId) {
+    const data = await ks.graphql('visionShortVideoReco', { page: 'detail', photoId }, gql.SHORT_VIDEO_RECO, `${WWW}/short-video/${photoId}`, 'www_graphql_detail');
+    return data?.data?.visionShortVideoReco ?? {};
+}
+/** get_comment_list：REST 一级评论。 */
+export function commentList(ks, photoId, pcursor = '') {
+    return ks.wwwPost('/rest/v/photo/comment/list', { photoId, pcursor });
+}
+/** get_comment_list_gql：作品详情页用的 GraphQL 评论（数据在 V2 字段里）。 */
+export async function commentListGql(ks, photoId, pcursor = '') {
+    const data = await ks.graphql('commentListQuery', { photoId, pcursor }, gql.COMMENT_LIST, `${WWW}/short-video/${photoId}`, 'www_graphql_detail');
+    return data?.data?.visionCommentList ?? {};
+}
+/** get_sub_comment_list：“查看更多回复”。 */
+export async function subCommentList(ks, photoId, rootCommentId, pcursor = '') {
+    const data = await ks.graphql('visionSubCommentList', { photoId, rootCommentId, pcursor }, gql.SUB_COMMENT_LIST, `${WWW}/short-video/${photoId}`, 'www_graphql_detail');
+    return data?.data?.visionSubCommentList ?? {};
+}
+/** get_profile：当前登录用户资料，顺带缓存本人 eid。 */
+export async function profile(ks, referer) {
+    const result = await ks.wwwGet('/rest/v/profile/get', { referer });
+    const eid = String(result?.eid ?? result?.userDefineId ?? '');
+    if (eid)
+        ks.s.selfEid = eid;
+    return result;
+}
+/** get_profile_feed：指定用户的作品，body 键名是 user_id；请求头多一个空的 profile_referer。 */
+export function profileFeed(ks, eid, pcursor = '') {
+    return ks.wwwPost('/rest/v/profile/feed', { user_id: eid, pcursor, page: 'profile' }, { referer: `https://www.kuaishou.com/profile/${eid}`, extraHeaders: [['profile_referer', '']] });
+}
+const searchReferer = (keyword) => `https://www.kuaishou.com/search/video?searchKey=${quote(keyword, '')}`;
+/** search_feed：首屏带 page / webPageArea，翻页带首屏返回的 searchSessionId。 */
+export function searchFeed(ks, keyword, pcursor = '', sessionId = '') {
+    const body = pcursor ? { keyword, pcursor, searchSessionId: sessionId } : { keyword, page: 'search', webPageArea: '', pcursor: '' };
+    return ks.wwwPost('/rest/v/search/feed', body, { referer: searchReferer(keyword) });
+}
+/** search_user。 */
+export function searchUser(ks, keyword, pcursor = '', sessionId = '') {
+    return ks.wwwPost('/rest/v/search/user', { keyword, pcursor, searchSessionId: sessionId }, { referer: searchReferer(keyword) });
+}
+/** get_relation：关注（ftype=1）/ 粉丝（2），只有本人；Referer 是本人主页。 */
+export function relation(ks, ftype, pcursor = '') {
+    return ks.wwwPost('/rest/v/relation/fol', { pcursor, ftype }, { referer: `${WWW}/profile/${ks.s.selfEid}`, cookieProfile: ftype === 1 ? 'www_relogin_relation_following' : 'www_relogin_relation_fans' });
+}
+/** get_liked_list：我的喜欢。 */
+export function likedList(ks, pcursor = '', referer) {
+    return ks.wwwPost('/rest/v/feed/liked', { pcursor, page: 'profile' }, { referer });
+}
+/** get_collect_list：收藏，body 里是 eid（驼峰 userId）。 */
+export function collectList(ks, eid, pcursor = '') {
+    return ks.wwwPost('/rest/v/collect/list', { userId: eid, pcursor, page: 'collect' }, { referer: eid ? `https://www.kuaishou.com/profile/${eid}` : undefined });
+}
+/** get_playback_list：用户的直播回放。 */
+export function playbackList(ks, eid, pcursor = '') {
+    return ks.wwwPost('/rest/v/live/playBack/list', { userId: eid, pcursor }, { referer: `https://www.kuaishou.com/profile/${eid}` });
+}
+const MY_FOLLOW = 'https://www.kuaishou.com/myFollow';
+/** like_data：关注页的 likeDataQuery，token 由抓包 bundle 的引擎按 {did, ts, uri} 生成。 */
+export async function likeData(ks, page = 'follow') {
+    const st = rand.now();
+    const token = genLikeToken(ks.s.did, st, '/rest/v/feed/myfollow');
+    const data = await ks.graphql('likeDataQuery', { token, st, page }, gql.LIKE_DATA, MY_FOLLOW);
+    return data?.data?.likeData ?? {};
+}
+/** vision_profile_reduced：用户资料（不带 userId 时是当前用户）。 */
+export async function profileReduced(ks, userId) {
+    const data = await ks.graphql('visionProfileReduced', userId == null ? {} : { userId }, gql.VISION_PROFILE_REDUCED, MY_FOLLOW);
+    return data?.data?.visionProfileReduced ?? {};
+}
+/** get_user_info：userInfoQuery，登录用户的轻量信息（直接给 eid）。 */
+export async function userInfo(ks) {
+    const data = await ks.graphql('userInfoQuery', {}, gql.USER_INFO, MY_FOLLOW);
+    return data?.data?.userInfo ?? {};
+}
+// ================================================================ 登录：KuaishouLoginAPI
+export const SID_LIVE = 'kuaishou.live.web';
+export const SID_WEB_API = 'kuaishou.web.api';
+export const SID_WWW = 'kuaishou.server.webday7';
+export const SID_CP = 'kuaishou.web.cp.api';
+const CHANNEL_PC = 'PC_PAGE';
+const CHANNEL_UNKNOWN = 'UNKNOWN';
+const SITE_BY_SID = { [SID_WWW]: WWW, [SID_CP]: CP, [SID_LIVE]: LIVE };
+const SESSION_KEYS = ['passToken', 'userId', 'ssecurity', 'bUserId'];
+export const channelFor = (sid) => (sid === SID_WWW ? CHANNEL_UNKNOWN : CHANNEL_PC);
+/** 扫码流程实抓的页面来源：www sid 在 www 页面，直播 / 手机号在 passport 页面。 */
+function qrPageOrigin(sid, channel) {
+    if (sid === SID_WWW || (!sid && channel === CHANNEL_UNKNOWN))
+        return WWW;
+    return PASSPORT;
+}
+/** 登录响应的票据：Set-Cookie，加上正文里的 passToken / userId / *_st / *.at。 */
+function sessionCookies(data, res) {
+    const cookies = responseCookies(res);
+    for (const key of SESSION_KEYS)
+        if (data?.[key])
+            mergeIssued(cookies, [[key, String(data[key])]]);
+    for (const [key, value] of Object.entries(data ?? {})) {
+        if (typeof value === 'string' && value && (key.endsWith('_st') || key.endsWith('.at')))
+            mergeIssued(cookies, [[key, value]]);
+    }
+    return cookies;
+}
+export async function qrStart(ks, sid, channel = channelFor(sid)) {
+    const [data] = await ks.loginForm('/rest/c/infra/ks/qr/start', [
+        ['sid', sid],
+        ['channelType', channel],
+        ['isWebSig4', 'true'],
+    ], qrPageOrigin(sid, channel));
+    return data;
+}
+export async function qrScanResult(ks, token, signature, channel) {
+    const [data] = await ks.loginForm('/rest/c/infra/ks/qr/scanResult', [
+        ['qrLoginToken', token],
+        ['qrLoginSignature', signature],
+        ['channelType', channel],
+        ['isWebSig4', 'true'],
+    ], qrPageOrigin('', channel), 70);
+    return data;
+}
+export async function qrAcceptResult(ks, token, signature, sid, channel) {
+    const [data] = await ks.loginForm('/rest/c/infra/ks/qr/acceptResult', [
+        ['qrLoginToken', token],
+        ['qrLoginSignature', signature],
+        ['sid', sid],
+        ['channelType', channel],
+        ['isWebSig4', 'true'],
+    ], qrPageOrigin(sid, channel), 70);
+    return data;
+}
+/** qr_callback：用 qrToken 换登录态，票据在正文和 Set-Cookie 里。 */
+export async function qrCallback(ks, qrToken, sid, channel) {
+    const [data, res] = await ks.loginForm('/pass/kuaishou/login/qr/callback', [
+        ['qrToken', qrToken],
+        ['sid', sid],
+        ['channelType', channel],
+        ['isWebSig4', 'true'],
+    ], qrPageOrigin(sid, channel));
+    return [data, sessionCookies(data, res)];
+}
+/** request_mobile_code：手机号登录短信（type=53 即 LOGIN）。 */
+export async function requestMobileCode(ks, phone, countryCode = '+86') {
+    const [data] = await ks.loginForm('/pass/kuaishou/sms/requestMobileCode', [
+        ['channelType', CHANNEL_PC],
+        ['countryCode', countryCode],
+        ['isWebSig4', 'true'],
+        ['phone', phone],
+        ['sid', SID_WEB_API],
+        ['type', '53'],
+    ], PASSPORT, 30);
+    return data;
+}
+/** login_by_mobile_code 的登录请求本身。 */
+export async function mobileCodeLogin(ks, phone, smsCode, countryCode = '+86') {
+    const [data, res] = await ks.loginForm('/pass/kuaishou/login/mobileCode', [
+        ['channelType', CHANNEL_PC],
+        ['countryCode', countryCode],
+        ['createId', 'true'],
+        ['isWebSig4', 'true'],
+        ['phone', phone],
+        ['setCookie', 'true'],
+        ['sid', SID_WEB_API],
+        ['smsCode', smsCode],
+    ], PASSPORT);
+    return [data, sessionCookies(data, res)];
+}
+/** STS 两跳是 iframe 导航，不是 XHR。 */
+function navHeaders(referer) {
+    return [
+        ['user-agent', UA],
+        ['upgrade-insecure-requests', '1'],
+        ['accept', 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7'],
+        ['sec-fetch-site', 'same-site'],
+        ['sec-fetch-mode', 'navigate'],
+        ['sec-fetch-dest', 'iframe'],
+        ['referer', referer],
+        ['accept-encoding', ACCEPT_ENCODING],
+        ['accept-language', ACCEPT_LANGUAGE_SHORT],
+    ];
+}
+/**
+ * sts_login：用 passToken 换站点域名下的 `<sid>_st` / `<sid>_ph`（两跳 302，第二跳的 authToken 由服务端补上）。
+ */
+export async function stsLogin(ks, sid, site = SITE_BY_SID[sid]) {
+    ks.s.useSite(site);
+    const ssoId = `SSO_${rand.now()}`;
+    const result = (ok) => `${PASSPORT}/pc/account/passToken/result?successful=${ok}&id=${ssoId}&for=passTokenSuccess`;
+    const stsUrl = `${site}/rest/infra/sts?followUrl=${quote(result('true'), '')}&failUrl=${quote(result('false'), '')}&setRootDomain=${sid === SID_CP ? 'true' : 'false'}`;
+    const loginPage = `${PASSPORT}/pc/account/passToken/result?successful=false&id=${ssoId}&for=pullTokenFail`;
+    const url = `${ID_HOST}/pass/kuaishou/login/passToken?callback=${quote(stsUrl, '')}&__loginPage=${quote(loginPage, '')}&sid=${quote(sid, '')}`;
+    const headers = navHeaders(`${site}/`);
+    const first = await ks.send({ method: 'GET', url, headers, cookie: await ks.s.currentLine(), redirect: 'manual' });
+    const issued = responseCookies(first);
+    const location = first.headers.get('location');
+    if (!location) {
+        ks.s.update(issued);
+        return issued;
+    }
+    const second = await ks.send({ method: 'GET', url: location, headers, cookie: await ks.s.currentLine(), redirect: 'manual' });
+    mergeIssued(issued, responseCookies(second));
+    ks.s.update(issued);
+    return issued;
+}
+/** bootstrap_document：加载站点文档，接收页面级 Set-Cookie（如 ktrace-context）。 */
+export async function bootstrapDocument(ks, site, path) {
+    const h = buildHeaders('DOC');
+    h.set('sec-fetch-site', 'none');
+    const res = await ks.send({ method: 'GET', url: `${site}${path}`, headers: h.get(), cookie: await ks.s.currentLine() });
+    const issued = responseCookies(res);
+    ks.s.update(issued);
+    return issued;
+}
+/** 直播页换票时的 Cookie 线序：没有创作者中心票据时是 `_direct` 那一套。 */
+function passTokenProfile(ks, referer) {
+    const base = liveContext(referer) === 'room' ? 'live_pass_token_room' : 'live_pass_token_home';
+    return ks.s.cookies.get('kuaishou.web.cp.api_st') ? base : `${base}_direct`;
+}
+/** get_cdns：passToken 之前的预检，也是一次直播页导航的开始（新的 Sentry trace）。 */
+export async function getCdns(ks, referer) {
+    ks.s.beginLiveTransaction(referer);
+    const cookie = await ks.s.cookieHeader(passTokenProfile(ks, referer));
+    const h = buildHeaders('POST', 'login_pass_token');
+    h.set('content-type', 'application/json');
+    h.set('referer', referer);
+    h.set('origin', LIVE);
+    h.set('sec-fetch-site', 'same-site');
+    const res = await ks.send({ method: 'POST', url: `${ID_HOST}/pass/kuaishou/getCdns`, headers: h.get(), cookie, body: compactJson({ sid: SID_LIVE, did: ks.s.did }) });
+    return res.json().catch(() => ({}));
+}
+/** pass_token_login：用 passToken 给直播站铸一份新鲜的 `<sid>_st` / `<sid>.at`。 */
+export async function passTokenLogin(ks, referer = `${LIVE}/`) {
+    await getCdns(ks, referer);
+    const h = buildHeaders('POST', 'login_pass_token');
+    h.set('referer', referer);
+    h.set('origin', LIVE);
+    h.set('sec-fetch-site', 'same-site');
+    const cookie = await ks.s.cookieHeader(passTokenProfile(ks, referer));
+    const body = `sid=${quote(SID_LIVE, '')}&channelType=${quote(CHANNEL_UNKNOWN, '')}&encryptHeaders=`;
+    const res = await ks.send({ method: 'POST', url: `${ID_HOST}/pass/kuaishou/login/passToken`, headers: h.get(), cookie, body });
+    const data = await res
+        .clone()
+        .json()
+        .catch(() => ({}));
+    return [data, sessionCookies(data, res)];
+}
+/** user_login_session：直播站 userLogin(authToken)，真正可用的 live web_st / web_ph 在 Set-Cookie 里。 */
+export async function userLoginSession(ks, authToken, referer = `${LIVE}/`) {
+    const context = liveContext(referer);
+    const hasPh = Boolean(ks.s.cookies.get('kuaishou.live.web_ph'));
+    let profile = context === 'room' ? ks.roomProfile('login') : context === 'home' ? ks.homeProfile('login') : `live_${context}_login`;
+    if (context === 'room' && !hasPh)
+        profile = ks.s.liveOnly ? 'live_room_current_login_bootstrap' : 'live_room_login_bootstrap';
+    if (context === 'home' && !hasPh)
+        profile = ks.s.liveOnly ? ks.homeProfile('login_bootstrap') : 'live_home_login_bootstrap';
+    const [data, res] = await ks.live('POST', '/live_api/baseuser/userLogin', {
+        body: { userLoginInfo: { authToken, sid: SID_LIVE } },
+        referer,
+        sentry: true,
+        cookieProfile: profile,
+    });
+    const ok = data?.data?.result === 1;
+    if (ok) {
+        if (context === 'room' && ks.s.liveOnly)
+            ks.s.advanceLive(context, 'authenticated');
+        else
+            ks.s.advanceLive(context, context === 'home' ? 'authenticated_1' : 'login');
+    }
+    return [ok, responseCookies(res)];
+}
+/** refresh_site_session：passToken 换票 + userLogin，重建直播站会话。 */
+export async function refreshLiveSession(ks, referer = `${LIVE}/`) {
+    const [data, cookies] = await passTokenLogin(ks, referer);
+    if (data?.result !== 1)
+        return false;
+    ks.s.update(cookies);
+    const token = data?.[`${SID_LIVE}.at`] ?? cookies.find(([k]) => k === `${SID_LIVE}.at`)?.[1] ?? '';
+    if (!token)
+        return false;
+    const [ok, issued] = await userLoginSession(ks, token, referer);
+    if (!ok)
+        return false;
+    ks.s.update(issued);
+    return true;
+}
+// ================================================================ 直播：KuaishouLiveAPI
+export const roomReferer = (eid) => `${LIVE}/u/${eid}`;
+export async function homeList(ks) {
+    const [data] = await ks.live('GET', '/live_api/home/list', { referer: `${LIVE}/`, cookieProfile: ks.homeProfile('initial') });
+    return data;
+}
+export async function categoryClassify(ks, referer = `${LIVE}/`) {
+    const [data] = await ks.live('GET', '/live_api/category/classify', {
+        query: [
+            ['type', 4],
+            ['source', 2],
+            ['page', 1],
+            ['pageSize', 20],
+        ],
+        referer,
+    });
+    return data;
+}
+/**
+ * gift_list：首屏（只有 liveStreamId，带 Sentry，当前阶段的 Cookie 线序）；
+ * 传 sortType 时是点击“更多礼物”（`liveStreamId&sortType=0`，不带 Sentry，authenticated 线序）。
+ */
+export async function giftList(ks, liveStreamId, eid, sortType) {
+    const more = sortType != null;
+    const query = [['liveStreamId', liveStreamId]];
+    if (more)
+        query.push(['sortType', sortType]);
+    const [data] = await ks.live('GET', '/live_api/emoji/gift-list', {
+        query,
+        referer: roomReferer(eid),
+        sentry: !more,
+        cookieProfile: more ? ks.roomProfile('authenticated') : undefined,
+    });
+    return data;
+}
+/** emoji_all_gifts：房间首屏的完整礼物字典（`/emoji/allgifts`，带 Sentry，房间资源的 Cookie 线序）。 */
+export async function emojiAllGifts(ks, eid) {
+    const [data] = await ks.live('GET', '/live_api/emoji/allgifts', { referer: roomReferer(eid), sentry: true, cookieProfile: 'live_room_assets_initial' });
+    return data;
+}
+/** 登出只放行上游抓包保留的那个房间页 Referer（上游拒绝外推到别的页面）。 */
+export const LIVE_LOGOUT_EID = '3xtgiecv6inq83i';
+const LIVE_LOGOUT_REFERER = roomReferer(LIVE_LOGOUT_EID);
+const PASSPORT_LOGOUT_BODY = 'sid=kuaishou.live.web&channelType=UNKNOWN&encryptHeaders=';
+const LOGOUT_SET_COOKIE = { passport: ['userId', 'userId', 'passToken'], live: ['kuaishou.live.web_st', 'kuaishou.live.web_ph', 'userId'] };
+const LOGOUT_CONTENT_TYPE = { passport: 'application/json;charset=utf-8', live: 'application/json; charset=utf-8' };
+/** 登出响应：状态码、content-type、Set-Cookie 删除的名字与顺序；已清理过的会话还要求响应体一致。 */
+async function checkLogout(res, kind, requireBody) {
+    const text = await res.text();
+    let payload;
+    try {
+        payload = jsonLoads(text);
+    }
+    catch {
+        payload = { result: -1, error: text.slice(0, 500) };
+    }
+    const fail = (why) => new SpecificAIError('UPSTREAM', `快手登出（${kind}）${why}`, { detail: { status: res.status, payload } });
+    if (res.status !== 200)
+        throw fail(`HTTP 状态不是 200：${res.status}`);
+    if ((res.headers.get('content-type') ?? '').toLowerCase() !== LOGOUT_CONTENT_TYPE[kind])
+        throw fail('content-type 与浏览器不一致');
+    const names = res.headers.getSetCookie().flatMap((line) => [...line.matchAll(/(?:^|,\s*)([A-Za-z0-9._-]+)=/g)].map((m) => m[1]));
+    if (names.join() !== LOGOUT_SET_COOKIE[kind].join())
+        throw fail(`Set-Cookie 与浏览器不一致：${names.join(', ')}`);
+    if (requireBody && compactJson(payload) !== (kind === 'passport' ? '{"result":1}' : '{"data":{"result":1}}'))
+        throw fail('响应体与浏览器不一致');
+    return payload;
+}
+/**
+ * _assert_passport_logout_cookie：passport 登出的 Cookie 线必须与 Chrome 抓包的字段、顺序完全一致（缺字段也不行），
+ * webweapon 四件套的值形态也要对（PCLive、174 位 kwfv1、88 位 secToken、64 位十六进制 kwscode），否则不发登出请求。
+ */
+function assertPassportLogoutCookie(raw, profile) {
+    const pairs = raw.split('; ').filter((part) => part.includes('=')).map((part) => [part.slice(0, part.indexOf('=')), part.slice(part.indexOf('=') + 1)]);
+    const names = pairs.map(([name]) => name);
+    const values = (name) => pairs.filter(([key]) => key === name).map(([, value]) => value);
+    const fail = (message) => new SpecificAIError('UPSTREAM', `快手登出：${message}，没有发登出请求`, { detail: { profile, cookies: names } });
+    if (names.join('; ') !== (SEQUENCES[profile] ?? []).join('; '))
+        throw fail('passport 登出的 Cookie 字段或顺序与浏览器不一致');
+    if (values('kwpsecproductname').join() !== PRODUCT_LIVE ||
+        values('kwfv1').map((v) => v.length).join() !== '174' ||
+        values('kwssectoken').map((v) => v.length).join() !== '88' ||
+        !/^[0-9a-f]{64}$/.test(values('kwscode')[0] ?? '')) {
+        throw fail('passport 登出的 webweapon Cookie 形态与浏览器不一致');
+    }
+}
+/**
+ * logout_session：直播页的“退出登录”——先 `POST id.kuaishou.com/pass/kuaishou/login/logout`，再
+ * `POST /live_api/baseuser/userLogout`。两条请求的请求头与 Cookie 线都是动作之前的快照；每一步按响应删掉
+ * passToken、userId 与直播票据（apply_live_logout）。上游对响应还检查 HTTP/1.1 与 Set-Cookie 的属性，这里不查。
+ */
+export async function liveLogout(ks) {
+    const referer = LIVE_LOGOUT_REFERER;
+    const present = ['userId', 'kuaishou.live.web_st', 'kuaishou.live.web_ph'].map((k) => Boolean(ks.s.cookies.get(k)));
+    const state = present.every(Boolean) ? 'authenticated' : present.some(Boolean) ? null : 'clean';
+    if (!state)
+        throw new SpecificAIError('UPSTREAM', '直播站票据不全（只有一部分登录 cookie），无法按浏览器的方式登出', { detail: { present } });
+    const kww = await ks.s.kww();
+    const passportCookie = await ks.s.cookieHeader(`live_logout_passport_${state}`);
+    const liveCookie = await ks.s.cookieHeader(`live_room_logout_${state}`);
+    assertPassportLogoutCookie(passportCookie, `live_logout_passport_${state}`);
+    const ph = buildHeaders('POST', 'login_pass_token');
+    ph.set('referer', referer);
+    ph.set('origin', LIVE);
+    ph.set('sec-fetch-site', 'same-site');
+    const [trace, span] = ks.s.nextLiveSentry(referer);
+    const lh = buildHeaders('GET', 'live');
+    lh.set('referer', referer);
+    lh.set('origin', LIVE);
+    lh.set('sentry-trace', `${trace}-${span}-0`);
+    lh.set('baggage', LIVE_SENTRY_BAGGAGE);
+    lh.set('kww', kww);
+    const passport = await checkLogout(await ks.send({ method: 'POST', url: `${ID_HOST}/pass/kuaishou/login/logout`, headers: ph.get(), cookie: passportCookie, body: PASSPORT_LOGOUT_BODY }), 'passport', state === 'clean');
+    ks.s.applyLiveLogout({ passport: true });
+    const live = await checkLogout(await ks.send({ method: 'POST', url: `${LIVE}/live_api/baseuser/userLogout`, headers: lh.get(), cookie: liveCookie, body: '' }), 'live', state === 'clean');
+    ks.s.applyLiveLogout({ live: true });
+    return { result: 1, state, passport, live };
+}
+export async function websocketInfo(ks, liveStreamId, eid) {
+    const [data] = await ks.live('GET', '/live_api/liveroom/websocketinfo', {
+        query: [['liveStreamId', liveStreamId]],
+        referer: roomReferer(eid),
+        cookieProfile: ks.roomProfile('authenticated'),
+    });
+    return data;
+}
+// ================================================================ 创作者中心：KuaishouPublishAPI
+const CREATOR_AXIOS = { style: 'cp_creator_axios', withKww: false, creator: true };
+export async function authorityAccountCurrent(ks) {
+    const result = await ks.cpPost('/rest/v2/creator/pc/authority/account/current', {}, { style: 'cp_creator_json', withKww: false, creator: true });
+    if (result?.result === 1 && result?.data?.ab?.enablePublish === true)
+        ks.cpAuthority = result;
+    return result;
+}
+/** require_publish_authority：上传之前复现发布页的账号权限门禁。 */
+export async function requirePublishAuthority(ks) {
+    if (ks.cpAuthority)
+        return ks.cpAuthority;
+    const result = await authorityAccountCurrent(ks);
+    if (result?.result === 119120)
+        throw new SpecificAIError('UPSTREAM', '创作者中心：账号异常，暂时无法发布（result=119120）', { detail: { result: 119120 } });
+    ks.check(result, '创作者中心');
+    if (result?.data?.ab?.enablePublish !== true)
+        throw new SpecificAIError('UPSTREAM', '创作者中心：这个账号当前没有发布权限', { detail: { result: result?.result } });
+    return result;
+}
+export function notificationUnreadCount(ks) {
+    return ks.cpPost('/rest/v2/creator/pc/notification/unReadCountV3', {}, CREATOR_AXIOS);
+}
+/** 视频提交后浏览器跳到的作品管理页。 */
+export const POST_PUBLISH_MANAGE_REFERER = `${CP}/article/manage/video?status=2&from=publish`;
+const POST_PUBLISH_SITE = 'cp_post_publish_manage';
+/**
+ * video_photo_list：作品管理页的作品列表（字段顺序固定）。postPublish 为发布后的管理页：
+ * Referer 是发布后管理页，Cookie 线序保留视频上传上下文的 kuaishou-vision 产品。
+ */
+export function videoPhotoList(ks, q, o = {}) {
+    return ks.cpPost('/rest/cp/works/v2/video/pc/photo/list', {
+        queryType: q.queryType,
+        cursor: q.cursor,
+        startTime: q.startTime,
+        endTime: q.endTime,
+        limit: q.limit,
+        timeRangeType: q.timeRangeType,
+        keyword: q.keyword,
+    }, o.postPublish ? { ...CREATOR_AXIOS, referer: POST_PUBLISH_MANAGE_REFERER, wireSite: POST_PUBLISH_SITE } : CREATOR_AXIOS);
+}
+/**
+ * 发布后管理页 photo/list 的这一行能不能拿去轮询（上游 video_photo_list 的 post_publish 判定）：
+ * 只有一行、还在发布中（publishStatus=2、没有 workId）、未发布封面是本次 upload/finish 的 coverKey、publishId 是正整数。
+ */
+export function publishRefreshId(list, coverKey) {
+    const rows = list?.result === 1 ? (list.data?.list ?? []) : [];
+    const row = rows.length === 1 ? rows[0] : null;
+    if (!row || typeof row !== 'object' || row.publishStatus !== 2 || row.workId != null || row.unPublishCoverKey !== coverKey)
+        return null;
+    return Number.isInteger(row.publishId) && row.publishId > 0 ? row.publishId : null;
+}
+/** video_publish_refresh：用本次 photo/list 返回的 publishId 轮询发布状态（body 只有 ids 与 api_ph）。 */
+export function videoPublishRefresh(ks, ids) {
+    return ks.cpPost('/rest/cp/works/v2/video/pc/publish/refresh', { ids }, { ...CREATOR_AXIOS, referer: POST_PUBLISH_MANAGE_REFERER, wireSite: POST_PUBLISH_SITE });
+}
+export const UPLOAD_TYPE_VIDEO = 1;
+export const UPLOAD_TYPE_ATLAS = 10;
+export function videoUploadPre(ks) {
+    return ks.cpPost('/rest/cp/works/v2/video/pc/upload/pre', { uploadType: UPLOAD_TYPE_VIDEO });
+}
+export async function videoUploadFinish(ks, token, fileName, fileType, fileLength) {
+    const result = await ks.cpPost('/rest/cp/works/v2/video/pc/upload/finish', { token, fileName, fileType, fileLength });
+    if (result?.result === 1)
+        ks.cpLastVideoFinish = { ...(result.data ?? {}) };
+    return result;
+}
+/** video_cover_report：submit 之前上报封面，bizKey 就是 upload/finish 返回的 coverKey。 */
+export function videoCoverReport(ks, coverKey) {
+    return ks.cpPost('/rest/cp/works/v2/common/pc/report', { bizKey: coverKey, bizType: 1, data: '{}' });
+}
+export const PHOTO_STATUS = { public: 1, private: 2, friends: 4 };
+/** publish_video 的当前 51 键 submit（走 sig4）。 */
+export function videoSubmitBody(o) {
+    return {
+        fileId: o.fileId,
+        coverKey: o.coverKey,
+        coverTimeStamp: 0,
+        caption: o.caption.replace(/(\S)#/g, '$1 #'),
+        photoStatus: o.photoStatus,
+        coverType: 1,
+        coverTitle: '',
+        photoType: 0,
+        collectionId: 0,
+        publishTime: o.publishTime,
+        longitude: '',
+        latitude: '',
+        poiId: 0,
+        notifyResult: 0,
+        domain: '',
+        secondDomain: '',
+        coverCropped: false,
+        pkCoverKey: '',
+        profileCoverKey: '',
+        downloadType: 1,
+        disableNearbyShow: false,
+        allowSameFrame: true,
+        movieId: '',
+        openPrePreview: false,
+        declareInfo: { source: 0, platform: 0, time: 0, location: '', sourceId: 0, sourceName: '', statementId: 0 },
+        activityIds: [],
+        riseQuality: false,
+        chapters: null,
+        videoComposite: null,
+        useAiCaptionCover: false,
+        useAiCaption: false,
+        isUseIdealTime: false,
+        useAiCover: false,
+        kceInfo: '',
+        coverSize: '',
+        pkCoverTimeStamp: -1,
+        pkCoverType: 1,
+        pkCoverSize: '',
+        innerChannel: 0,
+        mediaId: o.mediaId,
+        videoInfoMeta: '',
+        triggerH265: false,
+        recTagIdList: [],
+        onvideoDuration: 0,
+        disallowRecreation: false,
+        previewUrlErrorMessage: '',
+        coPublishUser: [],
+        coPublishRole: 0,
+        extraInfo: '',
+        videoDuration: o.videoDuration,
+    };
+}
+/** publish_video：先上报封面（必须 result=1），紧接着 submit。 */
+export async function publishVideo(ks, o) {
+    const report = await videoCoverReport(ks, o.coverKey);
+    if (report?.result !== 1)
+        throw new SpecificAIError('UPSTREAM', '封面上报没有通过，已停止提交', { detail: { result: report?.result, message: report?.message } });
+    return ks.cpPost('/rest/cp/works/v2/video/pc/submit', videoSubmitBody(o));
+}
+export function atlasRealizeEntrance(ks) {
+    return ks.cpPost('/rest/cp/works/v2/video/pc/realize/entrance', { movieId: '' }, { upload: 'atlas' });
+}
+/** creator_activity_list 的两套字段顺序（initial / post_resume）。 */
+export function activityList(ks, phase, upload) {
+    const body = phase === 'initial'
+        ? { page: 1, count: 20, category: 0, rewardType: 0, sortType: 0, pageSource: 2 }
+        : { page: 1, count: 20, category: 0, sortType: 0, rewardType: 0, pageSource: 2 };
+    return ks.cpPost('/rest/v2/creator/activity/pc/list', body, { upload });
+}
+export const activityTab = (ks, upload) => ks.cpPost('/rest/v2/creator/activity/pc/tab', {}, { upload });
+export const activityFilter = (ks, upload) => ks.cpPost('/rest/v2/creator/activity/pc/filter', {}, { upload });
+export const collectionCanAddAtlas = (ks) => ks.cpPost('/rest/cp/works/v2/collection/canAddAtlas');
+/** atlas_upload_pre：每张图各调一次；第一张不带 atlasId / fileId（JSON.stringify 丢掉 undefined）。 */
+export function atlasUploadPre(ks, mime, atlasId, fileId) {
+    const body = {};
+    if (atlasId != null)
+        body.atlasId = atlasId;
+    if (fileId != null)
+        body.fileId = fileId;
+    body.uploadType = UPLOAD_TYPE_ATLAS;
+    body.pictureCount = 1;
+    body.fileExtendNames = compactJson([{ fileExtendName: mime }]);
+    return ks.cpPost('/rest/cp/works/atlas/pc/upload/pre', body);
+}
+export function atlasUploadSingleFinish(ks, fileId, atlasId, blobKey) {
+    return ks.cpPost('/rest/cp/works/atlas/pc/upload/single/finish', { fileId, atlasId, blobKey });
+}
+export function atlasSnapshotSave(ks, fileId, atlasId, caption = '', photoStatus = 1, publishTime = 0) {
+    return ks.cpPost('/rest/cp/works/atlas/pc/publishInfo/snapshot/save', {
+        fileId,
+        atlasId,
+        caption: caption.replace(/(\S)#/g, '$1 #'),
+        photoStatus,
+        longitude: '',
+        latitude: '',
+        declareInfo: {},
+        activityIds: [],
+        publishTime,
+        coPublishUser: [],
+    });
+}
+export function atlasUploadFinish(ks, fileId, atlasId, blobKeys) {
+    return ks.cpPost('/rest/cp/works/atlas/pc/upload/finish', { fileId, atlasId, blobKey: blobKeys }, { upload: 'atlas' });
+}
+export function publishAtlas(ks, o) {
+    return ks.cpPost('/rest/cp/works/atlas/pc/publish/submit', {
+        fileId: o.fileId,
+        atlasId: o.atlasId,
+        caption: o.caption.replace(/(\S)#/g, '$1 #'),
+        photoStatus: o.photoStatus,
+        longitude: '',
+        latitude: '',
+        declareInfo: {},
+        activityIds: [],
+        publishTime: o.publishTime,
+        coPublishUser: [],
+        useAiCaption: false,
+        coverType: o.coverType ?? 1,
+    }, { upload: 'atlas' });
+}
+// ================================================================ 分片上传：ksuploader
+export const CHUNK_SIZE = 4 * 1024 * 1024;
+const UPLOAD_ACCEPT = ACCEPT_AXIOS;
+const CP_ROOT = `${CP}/`;
+function uploadHeaders(path, contentRange = '') {
+    if (path === '/api/upload/fragment') {
+        return [
+            ['referer', CP_ROOT],
+            ['user-agent', UA],
+            ['accept', UPLOAD_ACCEPT],
+            ['content-type', 'application/octet-stream'],
+            ['content-range', contentRange],
+            ['accept-encoding', ACCEPT_ENCODING],
+            ['accept-language', ACCEPT_LANGUAGE],
+            ['origin', CP],
+            ['sec-fetch-dest', 'empty'],
+            ['sec-fetch-mode', 'cors'],
+            ['sec-fetch-site', 'cross-site'],
+        ];
+    }
+    return [
+        ['user-agent', UA],
+        ['accept', UPLOAD_ACCEPT],
+        ['referer', CP_ROOT],
+        ['accept-encoding', ACCEPT_ENCODING],
+        ['accept-language', ACCEPT_LANGUAGE],
+        ['origin', CP],
+        ['sec-fetch-dest', 'empty'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-site', 'cross-site'],
+    ];
+}
+/** endPoints 可能是裸域名，统一成 https 前缀、无尾斜杠。 */
+export function uploadBase(endpoint) {
+    const e = endpoint.trim().replace(/\/+$/, '');
+    return /^https?:\/\//.test(e) ? e : `https://${e}`;
+}
+async function uploadCall(ks, method, base, path, query, body, contentRange) {
+    const res = await ks.http.request({ method, url: `${base}${path}`, query, headers: uploadHeaders(path, contentRange), body, cookies: false, timeout: 120 });
+    if (res.status >= 400)
+        throw new SpecificAIError('UPSTREAM', `上传失败：HTTP ${res.status}`, { detail: { status: res.status, path } });
+    const text = await res.text();
+    try {
+        return jsonLoads(text);
+    }
+    catch {
+        return { raw: text };
+    }
+}
+export const uploadResume = (ks, base, token) => uploadCall(ks, 'GET', base, '/api/upload/resume', [['upload_token', token]]);
+export function uploadFragment(ks, base, token, index, chunk, start, total) {
+    const range = `bytes ${start}-${start + chunk.length - 1}/${total}`;
+    return uploadCall(ks, 'POST', base, '/api/upload/fragment', [
+        ['upload_token', token],
+        ['fragment_id', String(index)],
+    ], chunk, range);
+}
+export const uploadComplete = (ks, base, token, count) => uploadCall(ks, 'POST', base, '/api/upload/complete', [
+    ['fragment_count', count],
+    ['upload_token', token],
+], '');