specific-ai-cli 0.0.0-stage → 0.1.1

package/dist/platforms/bilibili/web/normalize.js

@@ -0,0 +1,234 @@
+import * as n from '../../../core/normalize.js';
+/** B 站原始对象 → 归一化类型（AGENTS 6.2）。 */
+export const videoUrl = (bvid) => `https://www.bilibili.com/video/${bvid}`;
+export const spaceUrl = (mid) => `https://space.bilibili.com/${mid}`;
+export const liveUrl = (room) => `https://live.bilibili.com/${room}`;
+export const articleUrl = (cvid) => `https://www.bilibili.com/read/cv${cvid}`;
+export function ref(mid, name) {
+    return n.userRef({ id: mid, name, url: mid == null || mid === '' ? null : spaceUrl(mid) });
+}
+/** 稿件详情（x/web-interface/wbi/view 的 data）。 */
+export function video(v) {
+    return n.item({
+        id: v.bvid,
+        kind: 'video',
+        url: videoUrl(v.bvid),
+        title: n.str(v.title),
+        text: n.str(v.desc),
+        author: ref(v.owner?.mid, v.owner?.name),
+        created_at: n.time(v.pubdate),
+        cover: n.url(v.pic),
+        stats: {
+            views: n.count(v.stat?.view),
+            likes: n.count(v.stat?.like),
+            comments: n.count(v.stat?.reply),
+            collects: n.count(v.stat?.favorite),
+            shares: n.count(v.stat?.share),
+        },
+    }, v);
+}
+/** 搜索结果里的视频卡片。 */
+export function searchVideo(v) {
+    return n.item({
+        id: v.bvid,
+        kind: 'video',
+        url: videoUrl(v.bvid),
+        title: n.plainText(v.title),
+        text: n.str(v.description),
+        author: ref(v.mid, v.author),
+        created_at: n.time(v.pubdate),
+        cover: n.url(v.pic),
+        stats: { views: n.count(v.play), likes: n.count(v.like), comments: n.count(v.review), collects: n.count(v.favorites) },
+    }, v);
+}
+/** 专栏搜索结果（search_type=article）。id 用 `cv<id>`，可以直接传给 comment list。 */
+export function searchArticle(v) {
+    return n.item({
+        id: `cv${v.id}`,
+        kind: 'article',
+        url: articleUrl(v.id),
+        title: n.plainText(v.title),
+        text: n.plainText(v.desc),
+        author: ref(v.mid, null),
+        created_at: n.time(v.pub_time),
+        cover: n.url(v.image_urls?.[0]),
+        stats: { views: n.count(v.view), likes: n.count(v.like), comments: n.count(v.reply) },
+    }, v);
+}
+/** 专栏草稿（article/creative/draft/view 的 data）。 */
+export function articleDraft(v, id, mid) {
+    return n.item({
+        id: n.id(v.id ?? v.aid ?? id),
+        kind: 'article',
+        title: n.str(v.title),
+        text: n.str(v.content),
+        author: ref(v.author?.mid ?? mid, v.author?.name),
+        created_at: n.time(v.ctime ?? v.mtime),
+        cover: n.url(v.banner_url || v.image_urls?.[0]),
+        status: 'draft',
+    }, v);
+}
+/** 空间投稿列表（arc/search 的 vlist 项）。 */
+export function spaceVideo(v) {
+    return n.item({
+        id: v.bvid,
+        kind: 'video',
+        url: videoUrl(v.bvid),
+        title: n.str(v.title),
+        text: n.str(v.description),
+        author: ref(v.mid, v.author),
+        created_at: n.time(v.created),
+        cover: n.url(v.pic),
+        stats: { views: n.count(v.play), comments: n.count(v.comment) },
+    }, v);
+}
+/** 首页推荐流的卡片。 */
+export function feedVideo(v) {
+    return n.item({
+        id: v.bvid,
+        kind: 'video',
+        url: videoUrl(v.bvid),
+        title: n.str(v.title),
+        author: ref(v.owner?.mid, v.owner?.name),
+        created_at: n.time(v.pubdate),
+        cover: n.url(v.pic),
+        stats: { views: n.count(v.stat?.view), likes: n.count(v.stat?.like) },
+    }, v);
+}
+/** 收藏夹内容（fav/resource/list 的 medias 项）。 */
+export function favVideo(v) {
+    return n.item({
+        id: v.bvid ?? n.id(v.id),
+        kind: 'video',
+        url: v.bvid ? videoUrl(v.bvid) : null,
+        title: n.str(v.title),
+        text: n.str(v.intro),
+        author: ref(v.upper?.mid, v.upper?.name),
+        created_at: n.time(v.pubtime),
+        cover: n.url(v.cover),
+        stats: { views: n.count(v.cnt_info?.play), collects: n.count(v.cnt_info?.collect) },
+    }, v);
+}
+/** 稿件审核状态（创作中心 state）。 */
+function archiveStatus(state) {
+    const s = Number(state);
+    if (s >= 0)
+        return 'published';
+    if ([-2, -4, -16, -100].includes(s))
+        return 'rejected';
+    if ([-1, -6, -30, -40].includes(s))
+        return 'reviewing';
+    return null;
+}
+/** 我的稿件（x/web/archives 的 arc_audits 项）。 */
+export function archive(v) {
+    const a = v.Archive ?? {};
+    return n.item({
+        id: a.bvid,
+        kind: 'video',
+        url: videoUrl(a.bvid),
+        title: n.str(a.title),
+        text: n.str(a.desc),
+        author: ref(a.mid, a.author),
+        created_at: n.time(a.ptime || a.ctime),
+        cover: n.url(a.cover),
+        stats: {
+            views: n.count(v.stat?.view),
+            likes: n.count(v.stat?.like),
+            comments: n.count(v.stat?.reply),
+            collects: n.count(v.stat?.favorite),
+            shares: n.count(v.stat?.share),
+        },
+        status: archiveStatus(a.state),
+    }, v);
+}
+export function spaceUser(v) {
+    return n.user({ id: n.id(v.mid), name: n.str(v.name), avatar: n.url(v.face), url: spaceUrl(v.mid), bio: n.str(v.sign) }, v);
+}
+export function searchUser(v) {
+    return n.user({
+        id: n.id(v.mid),
+        name: n.str(v.uname),
+        avatar: n.url(v.upic),
+        url: spaceUrl(v.mid),
+        bio: n.str(v.usign),
+        stats: { followers: n.count(v.fans), following: null, items: n.count(v.videos), likes: null },
+    }, v);
+}
+export function navUser(v) {
+    return n.user({ id: n.id(v.mid), name: n.str(v.uname), avatar: n.url(v.face), url: spaceUrl(v.mid) }, v);
+}
+export function reply(v, itemId) {
+    return n.comment({
+        id: n.id(v.rpid),
+        item_id: itemId,
+        parent_id: v.parent ? n.id(v.parent) : null,
+        author: ref(v.member?.mid, v.member?.uname),
+        text: String(v.content?.message ?? ''),
+        created_at: n.time(v.ctime),
+        stats: { likes: n.count(v.like), replies: n.count(v.rcount) },
+    }, v);
+}
+export function searchLive(v) {
+    return n.live({
+        id: n.id(v.roomid),
+        url: liveUrl(v.roomid),
+        title: n.plainText(v.title),
+        status: v.live_status === 1 ? 'live' : 'offline',
+        host: ref(v.uid, v.uname),
+        cover: n.url(v.user_cover || v.cover),
+        stats: { viewers: n.count(v.online) },
+    }, v);
+}
+/** 没有专门映射的 cmd：能读出内容的给内容，其余给 cmd 名（上游 live/server.py 的 on('*') 兜底）。 */
+function otherText(cmd, d) {
+    switch (cmd) {
+        case 'WATCHED_CHANGE':
+            return n.str(d.text_large) ?? cmd;
+        case 'ROOM_CHANGE':
+            return d.title ? `直播间标题：${d.title}` : cmd;
+        case 'LIVE':
+            return '开播';
+        case 'PREPARING':
+            return '下播';
+        default:
+            return cmd || 'UNKNOWN';
+    }
+}
+/** 弹幕长连的心跳回复（op 3）：人气值（上游 live/server.py 的 popularity）。 */
+export function popularityEvent(value) {
+    return n.event({ type: 'other', text: `人气值 ${value}` }, { op: 3, popularity: value });
+}
+/** INTERACT_WORD 的 msg_type：1 进场，2 关注、4 特别关注、5 互相关注；3 分享没有对应的 Event 类型，和其余取值一样记为 other。 */
+const INTERACT_TYPE = { 1: 'enter', 2: 'follow', 4: 'follow', 5: 'follow' };
+/** 直播弹幕长连的业务消息 → Event：弹幕、礼物、进场、关注、点赞，其余 cmd 为 other。 */
+export function liveEvent(msg) {
+    const cmd = String(msg?.cmd ?? '').split(':')[0];
+    const d = msg?.data ?? {};
+    switch (cmd) {
+        case 'DANMU_MSG': {
+            const info = msg.info ?? [];
+            return n.event({ type: 'chat', time: n.time(info[0]?.[4]) ?? undefined, user: ref(info[2]?.[0], info[2]?.[1]), text: String(info[1] ?? '') }, msg);
+        }
+        case 'SUPER_CHAT_MESSAGE':
+            return n.event({ type: 'chat', time: n.time(d.start_time) ?? undefined, user: ref(d.uid, d.user_info?.uname), text: n.str(d.message) }, msg);
+        case 'SEND_GIFT':
+            return n.event({ type: 'gift', time: n.time(d.timestamp) ?? undefined, user: ref(d.uid, d.uname), gift: { name: String(d.giftName ?? ''), count: Number(d.num ?? 1) } }, msg);
+        case 'INTERACT_WORD': {
+            const type = INTERACT_TYPE[Number(d.msg_type)] ?? 'other';
+            const text = type !== 'other' ? undefined : Number(d.msg_type) === 3 ? '分享直播间' : cmd;
+            return n.event({ type, time: n.time(d.timestamp) ?? undefined, user: ref(d.uid, d.uname), text }, msg);
+        }
+        case 'LIKE_INFO_V3_CLICK':
+            return n.event({ type: 'like', user: ref(d.uid, d.uname) }, msg);
+        case 'GUARD_BUY':
+            return n.event({ type: 'gift', time: n.time(d.start_time) ?? undefined, user: ref(d.uid, d.username), gift: { name: String(d.gift_name ?? ''), count: Number(d.num ?? 1) } }, msg);
+        default:
+            return n.event({ type: 'other', time: n.time(d.timestamp) ?? undefined, user: d.uid ? ref(d.uid, d.uname) : null, text: otherText(cmd, d) }, msg);
+    }
+}
+/** gethistory 的弹幕，timeline 是北京时间。 */
+export function historyEvent(v) {
+    const t = typeof v.timeline === 'string' ? n.time(v.timeline.replace(' ', 'T') + '+08:00') : null;
+    return n.event({ type: 'chat', time: t ?? undefined, user: ref(v.uid, v.nickname), text: n.str(v.text) }, v);
+}

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

@@ -0,0 +1,135 @@
+/**
+ * 设备画像与请求头（上游 utils/fingerprint.py、builder/header.py）。
+ * UA 锁在 Chrome 146，与 TLS 指纹（wreq-js 的 chrome_146）一致。
+ */
+export const PROFILE = {
+    ua: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36',
+    secChUa: '"Chromium";v="146", "Not-A.Brand";v="24", "Google Chrome";v="146"',
+    secChUaPlatform: '"Windows"',
+    acceptLanguage: 'zh-CN,zh;q=0.9,en;q=0.8,zh-TW;q=0.7,ja;q=0.6',
+    screenWidth: 2560,
+    screenHeight: 1440,
+    browserResolution: '2560-1215',
+    colorDepth: 24,
+    deviceMemory: 8,
+    hardwareConcurrency: 20,
+    timezone: 'Asia/Shanghai',
+    webglVersion: 'WebGL 1.0 (OpenGL ES 2.0 Chromium)',
+    webglRenderer: 'ANGLE (NVIDIA, NVIDIA GeForce RTX 5060 Ti (0x00002D04) Direct3D11 vs_5_0 ps_5_0, D3D11)',
+    webglVendor: 'Google Inc. (NVIDIA)',
+};
+export const BROWSER = 'chrome_146';
+export const ORIGIN = {
+    main: 'https://www.bilibili.com',
+    live: 'https://live.bilibili.com',
+    passport: 'https://passport.bilibili.com',
+    member: 'https://member.bilibili.com',
+    dynamic: 'https://t.bilibili.com',
+    space: 'https://space.bilibili.com',
+    search: 'https://search.bilibili.com',
+};
+export const API = 'https://api.bilibili.com';
+export const LIVE_API = 'https://api.live.bilibili.com';
+export const PASSPORT = 'https://passport.bilibili.com';
+export const MEMBER = 'https://member.bilibili.com';
+const ACCEPT_ENCODING = 'gzip, deflate, br, zstd';
+const XHR_ACCEPT = 'application/json, text/plain, */*';
+const DOC_ACCEPT = 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8';
+/** 有序请求头，对应上游的 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;
+    }
+    referer(url) {
+        return this.set('referer', url);
+    }
+    remove(key) {
+        this.pairs = this.pairs.filter(([k]) => k !== key);
+        return this;
+    }
+    /** 在 anchor 之前插入；anchor 不存在时追加。 */
+    insertBefore(anchor, key, value) {
+        const i = this.pairs.findIndex(([k]) => k === anchor);
+        if (i < 0)
+            return this.set(key, value);
+        this.pairs = this.pairs.filter(([k]) => k !== key);
+        this.pairs.splice(this.pairs.findIndex(([k]) => k === anchor), 0, [key, value]);
+        return this;
+    }
+    get() {
+        return this.pairs;
+    }
+}
+/**
+ * 构造一组顺序与 Chrome 一致的请求头（上游 HeaderBuilder.build）。
+ * same_origin 时 `sec-fetch-site` 为 same-origin，且 GET 不带 origin。
+ */
+export function headers(type = 'GET', options = {}) {
+    const origin = options.origin ?? ORIGIN.main;
+    const h = new Headers();
+    h.set('sec-ch-ua', PROFILE.secChUa);
+    h.set('sec-ch-ua-mobile', '?0');
+    h.set('sec-ch-ua-platform', PROFILE.secChUaPlatform);
+    if (type === 'DOC') {
+        h.set('upgrade-insecure-requests', '1');
+        h.set('user-agent', PROFILE.ua);
+        h.set('accept', options.accept ?? DOC_ACCEPT);
+        h.set('sec-fetch-site', 'none');
+        h.set('sec-fetch-mode', 'navigate');
+        h.set('sec-fetch-user', '?1');
+        h.set('sec-fetch-dest', 'document');
+        h.set('accept-encoding', ACCEPT_ENCODING);
+        h.set('accept-language', PROFILE.acceptLanguage);
+        h.set('priority', 'u=0, i');
+        return h;
+    }
+    h.set('user-agent', PROFILE.ua);
+    if (type === 'POST')
+        h.set('content-type', 'application/json');
+    else if (type === 'FORM')
+        h.set('content-type', 'application/x-www-form-urlencoded');
+    h.set('accept', options.accept ?? XHR_ACCEPT);
+    if (!(options.sameOrigin && type === 'GET'))
+        h.set('origin', origin);
+    h.set('sec-fetch-site', options.sameOrigin ? 'same-origin' : 'same-site');
+    h.set('sec-fetch-mode', 'cors');
+    h.set('sec-fetch-dest', 'empty');
+    h.set('referer', origin + '/');
+    h.set('accept-encoding', ACCEPT_ENCODING);
+    h.set('accept-language', PROFILE.acceptLanguage);
+    h.set('priority', 'u=1, i');
+    return h;
+}
+/** 浏览器实抓的 Cookie 顺序（上游 utils/device.py COOKIE_ORDER）。 */
+export const COOKIE_ORDER = [
+    'buvid3',
+    'b_nut',
+    '_uuid',
+    'home_feed_column',
+    'buvid4',
+    'browser_resolution',
+    'buvid_fp',
+    'LIVE_BUVID',
+    'SESSDATA',
+    'bili_jct',
+    'DedeUserID',
+    'DedeUserID__ckMd5',
+    'theme-tip-show',
+    'CURRENT_FNVAL',
+    'sid',
+    'rpdid',
+    'PVID',
+    'CURRENT_QUALITY',
+    'bili_ticket',
+    'bili_ticket_expires',
+    'ogv_device_support_dolby',
+    'ogv_device_support_hdr',
+    'b_lsid',
+];
+export const COOKIE_DOMAIN = '.bilibili.com';

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

@@ -0,0 +1,112 @@
+import { SpecificAIError } from '../../../core/errors.js';
+import * as api from './api.js';
+import { av2bv, bv2av } from './sign.js';
+/** 参数归一化（AGENTS 4.8）：ID、URL、分享短链、BV 号、`me`。 */
+const BV_RE = /BV1[0-9A-Za-z]{9}/;
+const SHORT_RE = /^https?:\/\/(b23\.tv|bili2233\.cn)\//i;
+/** 分享短链跟一次跳转，取 Location。 */
+async function expand(b, url) {
+    if (!SHORT_RE.test(url))
+        return url;
+    const res = await b.http.request({ url, redirect: 'manual', cookies: false });
+    return res.headers.get('location') ?? url;
+}
+/** 稿件：BV 号、av 号、纯数字 aid、视频页 URL 或 b23.tv 短链。 */
+export async function resolveItem(b, input) {
+    const s = (await expand(b, input.trim())).trim();
+    const bv = BV_RE.exec(s)?.[0];
+    if (bv)
+        return { bvid: bv, aid: bv2av(bv) };
+    const av = /(?:^|\/|\b)av(\d+)/i.exec(s)?.[1] ?? (/^\d+$/.test(s) ? s : undefined);
+    if (av)
+        return { bvid: av2bv(av), aid: av };
+    throw new SpecificAIError('USAGE', `无法识别的稿件：${input}`, { hint: '传 BV 号、av 号或视频链接，例如 BV1GJ411x7h7' });
+}
+/**
+ * 动态的评论区只有纯文字和转发动态是 type 17 + 动态 ID；图文动态（带图）的评论区挂在相簿上（type 11 + 相簿 rid），
+ * 专栏动态挂在专栏上（type 12 + cv 号）。从动态 ID 查 rid / cv 号要动态详情接口，上游没有，specific-ai 也不自己加。
+ */
+export const DYNAMIC_REPLY_HINT = '动态只支持纯文字和转发：图文动态（带图）的评论区挂在相簿上，上游没有查相簿 ID 的接口；专栏请传 cv 号或专栏链接';
+const ARTICLE_RE = [/(?:^|\/read\/)cv(\d+)/i, /\/read\/mobile(?:\/|\?id=)(\d+)/i];
+const DYNAMIC_RE = [/t\.bilibili\.com\/(\d+)/i, /bilibili\.com\/opus\/(\d+)/i, /m\.bilibili\.com\/dynamic\/(\d+)/i, /^dyn(?:amic)?:(\d+)$/i];
+/** aid 最大 2^51，16 位以内；动态 ID 是 18、19 位。更长的纯数字按动态处理。 */
+const MIN_DYNAMIC_DIGITS = 17;
+function firstMatch(res, s) {
+    for (const re of res) {
+        const m = re.exec(s)?.[1];
+        if (m)
+            return m;
+    }
+}
+/**
+ * 评论区：稿件（BV 号、av 号、视频链接）→ 1；专栏（cv 号、专栏链接）→ 12；
+ * 动态（动态链接、17 位以上的动态 ID、`dyn:<id>`）→ 17，只对纯文字和转发动态成立（见 DYNAMIC_REPLY_HINT）。
+ * opus 链接既可能是动态也可能是专栏，不发请求分不出来，按动态处理。
+ */
+export async function resolveReplyTarget(b, input) {
+    const s = (await expand(b, input.trim())).trim();
+    const cv = firstMatch(ARTICLE_RE, s);
+    if (cv)
+        return { type: 12, oid: cv, itemId: `cv${cv}` };
+    const dyn = firstMatch(DYNAMIC_RE, s) ?? (/^\d+$/.test(s) && s.length >= MIN_DYNAMIC_DIGITS ? s : undefined);
+    if (dyn)
+        return { type: 17, oid: dyn, itemId: dyn };
+    try {
+        const { bvid, aid } = await resolveItem(b, s);
+        return { type: 1, oid: aid, itemId: bvid };
+    }
+    catch {
+        throw new SpecificAIError('USAGE', `无法识别的评论区：${input}`, {
+            hint: `传稿件（BV 号、av 号、视频链接）、专栏（cv 号或专栏链接）或动态（动态链接或动态 ID）；${DYNAMIC_REPLY_HINT}`,
+        });
+    }
+}
+/** 动态：动态链接（t.bilibili.com、opus、m.bilibili.com/dynamic）、`dyn:<id>` 或纯数字的动态 ID。dynamic publish 输出的 id、url 都能直接用。 */
+export async function resolveDynamic(b, input) {
+    const s = (await expand(b, input.trim())).trim();
+    const id = firstMatch(DYNAMIC_RE, s) ?? /^\d+$/.exec(s)?.[0];
+    if (id)
+        return id;
+    throw new SpecificAIError('USAGE', `无法识别的动态：${input}`, { hint: '传动态 ID 或动态链接 https://t.bilibili.com/<id>（dynamic publish 输出的 id、url 都可以）' });
+}
+/** 收藏夹：folder list 输出的 url（`…/favlist?fid=<id>`）、播放列表链接（`ml<id>`）或纯数字的收藏夹 ID。 */
+export async function resolveFolder(b, input) {
+    const s = (await expand(b, input.trim())).trim();
+    const id = /[?&]fid=(\d+)/.exec(s)?.[1] ?? /(?:^|\/)ml(\d+)/.exec(s)?.[1] ?? /^\d+$/.exec(s)?.[0];
+    if (id)
+        return id;
+    throw new SpecificAIError('USAGE', `无法识别的收藏夹：${input}`, { hint: '传收藏夹 ID 或 folder list 输出的 url（https://space.bilibili.com/<mid>/favlist?fid=<id>）' });
+}
+/** 用户：mid、空间 URL、`me`。 */
+export async function resolveUser(b, input) {
+    const s = (await expand(b, input.trim())).trim();
+    if (s === 'me') {
+        if (!b.mid)
+            throw new SpecificAIError('AUTH_REQUIRED', 'me 表示当前账号，需要先登录', { hint: 'specific-ai bilibili auth login' });
+        return b.mid;
+    }
+    const m = /space\.bilibili\.com\/(\d+)/.exec(s)?.[1] ?? /^(?:uid:?)?(\d+)$/i.exec(s)?.[1];
+    if (m)
+        return m;
+    throw new SpecificAIError('USAGE', `无法识别的用户：${input}`, { hint: '传用户 mid（数字）或空间链接 https://space.bilibili.com/<mid>' });
+}
+/**
+ * 直播间：房间号或直播间 URL（短号在调用 room_init 时换成真实房间号）；
+ * 也可以传主播（空间链接、`uid:<mid>`、`me`），按上游 get_room_by_mid 换成房间号。纯数字按房间号处理。
+ */
+export async function resolveRoom(b, input) {
+    const s = (await expand(b, input.trim())).trim();
+    const m = /live\.bilibili\.com\/(?:h5\/)?(\d+)/.exec(s)?.[1] ?? /^\d+$/.exec(s)?.[0];
+    if (m)
+        return m;
+    const mid = s === 'me' || /space\.bilibili\.com\/\d+/.test(s) || /^uid:?\d+$/i.test(s) ? await resolveUser(b, s) : null;
+    if (mid) {
+        const d = await api.roomByMid(b, mid);
+        if (!d?.roomid || d.roomStatus === 0)
+            throw new SpecificAIError('UPSTREAM', s === 'me' ? '这个账号还没有开通直播间' : `用户 ${mid} 没有开通直播间`, { detail: { mid } });
+        return String(d.roomid);
+    }
+    throw new SpecificAIError('USAGE', `无法识别的直播间：${input}`, {
+        hint: '传房间号、直播间链接 https://live.bilibili.com/<房间号>，或主播的空间链接 / uid:<mid>',
+    });
+}