specific-ai-cli 0.0.0-stage → 0.1.1

package/dist/platforms/douyin/web/profile.js

@@ -0,0 +1,221 @@
+/**
+ * 设备画像、请求头与公共 query（上游 utils/fingerprint.py、builder/header.py、builder/params.py）。
+ * UA 是 Chrome 151（上游实录）；wreq-js 最新的 TLS 画像是 chrome_149，与上游 curl_cffi 用 chrome150 画像配 151 UA 的做法一致。
+ */
+const UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/151.0.0.0 Safari/537.36';
+export const PROFILE = {
+    ua: UA,
+    secChUa: '"Not=A?Brand";v="99", "Google Chrome";v="151", "Chromium";v="151"',
+    secChUaPlatform: '"Windows"',
+    browserName: 'Chrome',
+    browserVersion: '151.0.0.0',
+    engineVersion: '151.0.0.0',
+    platform: 'Win32',
+    osVersion: '10',
+    cpuCoreNum: '20',
+    deviceMemory: '32',
+    screenWidth: '2560',
+    screenHeight: '1440',
+    webglVendor: 'Google Inc. (NVIDIA)',
+    webglRenderer: 'ANGLE (NVIDIA, NVIDIA GeForce RTX 5060 Ti (0x00002D04) Direct3D11 vs_5_0 ps_5_0, D3D11)',
+    acceptLanguage: 'zh-CN,zh;q=0.9,en;q=0.8,zh-TW;q=0.7,ja;q=0.6',
+    /** inner w/h、outer w/h、avail w/h、screen w/h。 */
+    geo: [2560, 1215, 2560, 1392, 2560, 1392, 2560, 1440],
+    screenX: 0,
+    screenY: 0,
+};
+/** navigator.appVersion：UA 去掉 `Mozilla/` 前缀。 */
+export const APP_VERSION = UA.replace('Mozilla/', '');
+export const BROWSER = 'chrome_149';
+export const WWW = 'https://www.douyin.com';
+export const LIVE = 'https://live.douyin.com';
+export const CREATOR = 'https://creator.douyin.com';
+export const LOGIN = 'https://login.douyin.com';
+/** 只在 www.douyin.com 上的 host-only cookie（上游 builder/auth.py ensure_http_session 的 www_only）。 */
+export const WWW_ONLY = new Set([
+    's_v_web_id',
+    '__ac_nonce',
+    '__ac_signature',
+    'x-web-secsdk-uid',
+    'dy_swidth',
+    'dy_sheight',
+    'device_web_cpu_core',
+    'device_web_memory_size',
+    'architecture',
+    'fpk1',
+    'fpk2',
+]);
+// ---------------------------------------------------------------- 请求头
+/** 有序请求头，对应上游 Header：改值不影响位置，新键追加到末尾。 */
+export class Headers {
+    pairs = [];
+    set(key, value) {
+        const i = this.pairs.findIndex(([k]) => k === key);
+        if (i >= 0)
+            this.pairs[i] = [key, value];
+        else
+            this.pairs.push([key, value]);
+        return this;
+    }
+    get(key) {
+        return this.pairs.find(([k]) => k === key)?.[1];
+    }
+    referer(url) {
+        return this.set('referer', url);
+    }
+    remove(...keys) {
+        this.pairs = this.pairs.filter(([k]) => !keys.includes(k));
+        return this;
+    }
+    list() {
+        return this.pairs;
+    }
+}
+/** 上游 HeaderBuilder.build。 */
+export function headers(type = 'GET') {
+    const h = new Headers();
+    if (type === 'DOC') {
+        for (const [k, v] of [
+            ['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'],
+            ['accept-language', PROFILE.acceptLanguage],
+            ['cache-control', 'no-cache'],
+            ['cookie', ''],
+            ['pragma', 'no-cache'],
+            ['priority', 'u=0, i'],
+            ['sec-ch-ua', PROFILE.secChUa],
+            ['sec-ch-ua-mobile', '?0'],
+            ['sec-ch-ua-platform', PROFILE.secChUaPlatform],
+            ['sec-fetch-dest', 'document'],
+            ['sec-fetch-mode', 'navigate'],
+            ['sec-fetch-site', 'none'],
+            ['sec-fetch-user', '?1'],
+            ['upgrade-insecure-requests', '1'],
+            ['user-agent', PROFILE.ua],
+        ])
+            h.set(k, v);
+        return h;
+    }
+    h.set('user-agent', PROFILE.ua);
+    if (type === 'POST')
+        h.set('accept', '*/*').set('content-type', 'application/json; charset=UTF-8');
+    else if (type === 'FORM')
+        h.set('accept', 'application/json, text/plain, */*').set('content-type', 'application/x-www-form-urlencoded; charset=UTF-8');
+    else if (type === 'PROTOBUF')
+        h.set('accept', 'application/x-protobuf').set('content-type', 'application/x-protobuf');
+    else
+        h.set('accept', 'application/json, text/plain, */*');
+    h.set('sec-ch-ua', PROFILE.secChUa);
+    h.set('sec-ch-ua-mobile', '?0');
+    h.set('sec-ch-ua-platform', PROFILE.secChUaPlatform);
+    h.set('accept-language', PROFILE.acceptLanguage);
+    h.set('priority', 'u=1, i');
+    h.set('sec-fetch-dest', 'empty');
+    h.set('sec-fetch-mode', 'cors');
+    h.set('sec-fetch-site', 'same-origin');
+    return h;
+}
+// ---------------------------------------------------------------- query
+/** 有序参数，对应上游 Params（一个 dict）：已有的键原位改值，新键追加。 */
+export class Params {
+    map = new Map();
+    add(key, value) {
+        this.map.set(key, value == null ? '' : String(value));
+        return this;
+    }
+    update(pairs) {
+        for (const [k, v] of pairs)
+            this.add(k, v);
+        return this;
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    pairs() {
+        return [...this.map];
+    }
+    /** 上游 toString：`k=v` 原样拼接，不编码。 */
+    raw() {
+        return this.pairs()
+            .map(([k, v]) => `${k}=${v}`)
+            .join('&');
+    }
+}
+/** www.douyin.com 的公共 query 组（上游 with_platform，不带 auth 的部分）。 */
+export function platformParams(roundTripTime = '0', versionCode = '170400', versionName = '17.4.0') {
+    return [
+        ['device_platform', 'webapp'],
+        ['aid', '6383'],
+        ['channel', 'channel_pc_web'],
+        ['update_version_code', '170400'],
+        ['pc_client_type', '1'],
+        ['pc_libra_divert', 'Windows'],
+        ['support_h265', '1'],
+        ['support_dash', '1'],
+        ['cpu_core_num', PROFILE.cpuCoreNum],
+        ['version_code', versionCode],
+        ['version_name', versionName],
+        ['cookie_enabled', 'true'],
+        ['screen_width', PROFILE.screenWidth],
+        ['screen_height', PROFILE.screenHeight],
+        ['browser_language', 'zh-CN'],
+        ['browser_platform', 'Win32'],
+        ['browser_name', PROFILE.browserName],
+        ['browser_version', PROFILE.browserVersion],
+        ['browser_online', 'true'],
+        ['engine_name', 'Blink'],
+        ['engine_version', PROFILE.engineVersion],
+        ['os_name', 'Windows'],
+        ['os_version', '10'],
+        ['device_memory', PROFILE.deviceMemory],
+        ['platform', 'PC'],
+        ['downlink', '10'],
+        ['effective_type', '4g'],
+        ['round_trip_time', roundTripTime],
+    ];
+}
+/** live.douyin.com 电商接口的公共 query 组（上游 with_live_platform）。 */
+export function livePlatformParams(roundTripTime = '50') {
+    return [
+        ['update_version_code', '170400'],
+        ['pc_client_type', '1'],
+        ['pc_libra_divert', 'Windows'],
+        ['support_h265', '1'],
+        ['support_dash', '0'],
+        ['cpu_core_num', PROFILE.cpuCoreNum],
+        ['version_code', '320100'],
+        ['version_name', '32.1.0'],
+        ['cookie_enabled', 'true'],
+        ['screen_width', PROFILE.screenWidth],
+        ['screen_height', PROFILE.screenHeight],
+        ['browser_language', 'zh-CN'],
+        ['browser_platform', 'Win32'],
+        ['browser_name', PROFILE.browserName],
+        ['browser_version', PROFILE.browserVersion],
+        ['browser_online', 'true'],
+        ['engine_name', 'Blink'],
+        ['engine_version', PROFILE.engineVersion],
+        ['os_name', 'Windows'],
+        ['os_version', '10'],
+        ['device_memory', PROFILE.deviceMemory],
+        ['platform', 'PC'],
+        ['downlink', '10'],
+        ['effective_type', '4g'],
+        ['round_trip_time', roundTripTime],
+    ];
+}
+/** creator.douyin.com 的固定 query 组（上游 with_creator_platform）。 */
+export function creatorPlatformParams() {
+    return [
+        ['cookie_enabled', 'true'],
+        ['screen_width', PROFILE.screenWidth],
+        ['screen_height', PROFILE.screenHeight],
+        ['browser_language', 'zh-CN'],
+        ['browser_platform', 'Win32'],
+        ['browser_name', 'Mozilla'],
+        ['browser_version', APP_VERSION],
+        ['browser_online', 'true'],
+        ['timezone_name', 'Asia/Shanghai'],
+        ['aid', '1128'],
+        ['support_h265', '1'],
+    ];
+}

package/dist/platforms/douyin/web/proto.js

@@ -0,0 +1,26 @@
+import { readFileSync } from 'node:fs';
+import { gunzipSync } from 'node:zlib';
+import protobuf from 'protobufjs';
+import { staticFile } from '../../../core/paths.js';
+/** 上游 static/*.proto 原样复制在 static/douyin/ 下，用 protobufjs 按文本解析（字段名保持 snake_case）。 */
+const roots = new Map();
+export function type(file, name) {
+    let root = roots.get(file);
+    if (!root) {
+        root = protobuf.parse(readFileSync(staticFile('douyin', `${file}.proto`), 'utf8'), { keepCase: true }).root;
+        roots.set(file, root);
+    }
+    return root.lookupType(name);
+}
+export function encode(file, name, value) {
+    const t = type(file, name);
+    return t.encode(t.fromObject(value)).finish();
+}
+export function decode(file, name, data, options = {}) {
+    const t = type(file, name);
+    return t.toObject(t.decode(data), { longs: String, bytes: Buffer, defaults: false, ...options });
+}
+/** 直播推送帧的负载可能是 gzip。 */
+export function inflate(payload) {
+    return payload[0] === 0x1f && payload[1] === 0x8b ? gunzipSync(payload) : payload;
+}

package/dist/platforms/douyin/web/resolve.js

@@ -0,0 +1,88 @@
+import { SpecificAIError } from '../../../core/errors.js';
+import * as api from './api.js';
+import { LIVE } from './profile.js';
+/** 参数归一化（AGENTS 4.8）：ID、URL、分享短链、`me`。 */
+const SHORT_RE = /^https?:\/\/(v\.douyin\.com|www\.iesdouyin\.com\/share)\//i;
+/** 分享短链（v.douyin.com）跟一次跳转，取 Location。分享文案里夹着的链接也能认出来。 */
+async function expand(d, input) {
+    const s = input.trim();
+    const link = /https?:\/\/v\.douyin\.com\/[\w-]+\/?/i.exec(s)?.[0] ?? s;
+    if (!SHORT_RE.test(link))
+        return s;
+    const res = await d.http.request({ url: link, redirect: 'manual', cookies: false, headers: [['user-agent', 'Mozilla/5.0']] });
+    return res.headers.get('location') ?? link;
+}
+/** 已展开的字符串里的作品 ID：作品页路径、modal_id= 等参数，或纯数字 ID。 */
+function itemIdOf(s) {
+    return /\/(?:video|note|slides|share\/video|share\/note)\/(\d+)/.exec(s)?.[1] ?? /[?&](?:modal_id|aweme_id|item_id)=(\d+)/.exec(s)?.[1] ?? /^\d{8,}$/.exec(s)?.[0];
+}
+/** 已展开的字符串里的 sec_uid：主页路径、sec_uid= 参数，或 MS4w 开头的 sec_uid；/user/self 不算。 */
+function secUidOf(s) {
+    const m = /\/(?:user|share\/user)\/([\w-]+)/.exec(s)?.[1] ?? /[?&]sec_uid=([\w-]+)/.exec(s)?.[1] ?? /^MS4w[\w-]+$/.exec(s)?.[0];
+    return m && m !== 'self' ? m : undefined;
+}
+/** 作品：aweme_id、作品页 URL（/video/、/note/、/slides/、modal_id=）或分享短链。 */
+export async function resolveItem(d, input) {
+    const m = itemIdOf(await expand(d, input));
+    if (m)
+        return m;
+    throw new SpecificAIError('USAGE', `无法识别的作品：${input}`, { hint: '传作品 ID 或作品链接，例如 https://www.douyin.com/video/7433523124836060416' });
+}
+/** 用户：sec_uid、主页 URL、分享短链、`me`。 */
+export async function resolveUser(d, input) {
+    if (input.trim() === 'me') {
+        const saved = d.credential.user?.id;
+        if (saved)
+            return saved;
+        if (!d.isLogin)
+            throw new SpecificAIError('AUTH_REQUIRED', 'me 表示当前账号，需要先登录', { hint: 'specific-ai douyin auth login' });
+        return (await api.mySecUid(d)).secUid;
+    }
+    const m = secUidOf(await expand(d, input));
+    if (m)
+        return m;
+    throw new SpecificAIError('USAGE', `无法识别的用户：${input}`, { hint: '传用户 sec_uid（MS4wLjAB 开头）或主页链接 https://www.douyin.com/user/<sec_uid>' });
+}
+/**
+ * `msg send --share` 的目标：作品（ID / 链接）、用户（sec_uid / 主页 / me）、其余 http(s) 链接当网页卡片。
+ * 先认作品：主页上点开的作品是 `/user/<sec_uid>?modal_id=<作品>`，与 resolveItem 一样当作品。
+ */
+export async function resolveShare(d, input) {
+    if (input.trim() === 'me')
+        return { kind: 'user', secUid: await resolveUser(d, 'me') };
+    const s = await expand(d, input);
+    const item = itemIdOf(s);
+    if (item)
+        return { kind: 'item', id: item };
+    const user = secUidOf(s);
+    if (user)
+        return { kind: 'user', secUid: user };
+    if (/^https?:\/\//i.test(s))
+        return { kind: 'web', url: s };
+    throw new SpecificAIError('USAGE', `无法识别的分享目标：${input}`, { hint: '传作品 ID / 链接、用户 sec_uid / 主页链接，或一个网页链接' });
+}
+/** 直播间：直播间号（web_rid）或 live.douyin.com 链接。 */
+export async function resolveRoom(d, input) {
+    const s = await expand(d, input);
+    const m = /live\.douyin\.com\/(\d+)/.exec(s)?.[1] ?? /^\d+$/.exec(s)?.[0];
+    if (m)
+        return m;
+    throw new SpecificAIError('USAGE', `无法识别的直播间：${input}`, { hint: `传直播间号或直播间链接 ${LIVE}/<直播间号>` });
+}
+/** 商品：promotion_id，或带 id / promotion_id / shop_id 参数的商品链接（live products 输出的 url）。 */
+export function resolveProduct(input) {
+    const s = input.trim();
+    if (/^\d+$/.test(s))
+        return { promotionId: s, productId: null, shopId: null };
+    let q;
+    try {
+        q = new URL(s).searchParams;
+    }
+    catch {
+        throw new SpecificAIError('USAGE', `无法识别的商品：${input}`, { hint: '传商品 promotion_id，或 specific-ai douyin live products 输出的商品 url' });
+    }
+    const promotionId = q.get('promotion_id') ?? q.get('id');
+    if (!promotionId)
+        throw new SpecificAIError('USAGE', `商品链接里没有 id：${input}`);
+    return { promotionId, productId: q.get('product_id') ?? q.get('id'), shopId: q.get('shop_id') };
+}