dsh-shlr-bilitoolkit 0.0.0-stage → 0.1.0

package/dist/apis/relation.d.ts

@@ -0,0 +1,13 @@
+/** 关注列表、粉丝列表与关系统计。 */
+import type { BiliClient } from "../client";
+import { RelationUser } from "../models";
+export declare class RelationAPI {
+    private client;
+    constructor(client: BiliClient);
+    stat(uid: number): Promise<Record<string, unknown>>;
+    followings(uid: number, page?: number, pageSize?: number, order?: string, orderType?: string): Promise<[RelationUser[], number]>;
+    followers(uid: number, page?: number, pageSize?: number, order?: string): Promise<[RelationUser[], number]>;
+    iterFollowings(uid: number, pageSize?: number, order?: string, maxPages?: number): AsyncGenerator<RelationUser, any, any>;
+    iterFollowers(uid: number, pageSize?: number, order?: string, maxPages?: number): AsyncGenerator<RelationUser, any, any>;
+    private static parse;
+}

package/dist/apis/relation.js

@@ -0,0 +1,47 @@
+/** 关注列表、粉丝列表与关系统计。 */
+import * as endpoints from "../endpoints";
+import { RelationUser } from "../models";
+import { iterPages } from "../pagination";
+export class RelationAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async stat(uid) {
+        const payload = await this.client.get(endpoints.RELATION_STAT, {
+            vmid: Number(uid),
+        });
+        return payload?.data ?? {};
+    }
+    async followings(uid, page = 1, pageSize = 20, order = "desc", orderType = "attention") {
+        const payload = await this.client.get(endpoints.RELATION_FOLLOWINGS, {
+            vmid: Number(uid),
+            pn: page,
+            ps: pageSize,
+            order,
+            order_type: orderType,
+        }, { Referer: `https://space.bilibili.com/${Number(uid)}/relation/follow` });
+        return RelationAPI.parse(payload?.data ?? {});
+    }
+    async followers(uid, page = 1, pageSize = 20, order = "desc") {
+        const payload = await this.client.get(endpoints.RELATION_FOLLOWERS, { vmid: Number(uid), pn: page, ps: pageSize, order }, { Referer: `https://space.bilibili.com/${Number(uid)}/relation/fans` });
+        return RelationAPI.parse(payload?.data ?? {});
+    }
+    iterFollowings(uid, pageSize = 50, order = "desc", maxPages) {
+        const fetch = (page) => this.followings(uid, page, pageSize, order);
+        return iterPages(fetch, maxPages);
+    }
+    iterFollowers(uid, pageSize = 50, order = "desc", maxPages) {
+        const fetch = (page) => this.followers(uid, page, pageSize, order);
+        return iterPages(fetch, maxPages);
+    }
+    static parse(data) {
+        const users = [];
+        for (const item of data?.list ?? []) {
+            const u = RelationUser.fromApi(item);
+            if (u)
+                users.push(u);
+        }
+        return [users, Number(data.total ?? users.length)];
+    }
+}

package/dist/apis/search.d.ts

@@ -0,0 +1,17 @@
+/** 搜索接口：视频、用户。
+
+搜索走 WBI 签名接口，并带搜索页 Referer。B 站会对搜索做风控，
+这里把网页端常见的 dm_img_* 环境参数一并带上，降低被 -412 拦截的概率。
+*/
+import type { BiliClient } from "../client";
+import { User, Video } from "../models";
+export declare const VIDEO_ORDERS: readonly ["totalrank", "click", "pubdate", "dm", "stow", "scores"];
+export declare class SearchAPI {
+    private client;
+    constructor(client: BiliClient);
+    private _search;
+    videos(keyword: string, page?: number, pageSize?: number, order?: string): Promise<[Video[], number]>;
+    users(keyword: string, page?: number, pageSize?: number): Promise<[User[], number]>;
+    iterVideos(keyword: string, pageSize?: number, order?: string, maxPages?: number): AsyncGenerator<Video, any, any>;
+    iterUsers(keyword: string, pageSize?: number, maxPages?: number): AsyncGenerator<User, any, any>;
+}

package/dist/apis/search.js

@@ -0,0 +1,81 @@
+/** 搜索接口：视频、用户。
+
+搜索走 WBI 签名接口，并带搜索页 Referer。B 站会对搜索做风控，
+这里把网页端常见的 dm_img_* 环境参数一并带上，降低被 -412 拦截的概率。
+*/
+import * as endpoints from "../endpoints";
+import { User, Video } from "../models";
+import { iterPages } from "../pagination";
+// 视频搜索支持的排序
+export const VIDEO_ORDERS = [
+    "totalrank",
+    "click",
+    "pubdate",
+    "dm",
+    "stow",
+    "scores",
+];
+// 搜索接口会校验的浏览器环境参数，值为网页端常见形态
+const FINGERPRINT = {
+    dm_img_list: "[]",
+    dm_img_str: "V2ViR0wgMS4wIChPcGVuR0wgRVMgMi4wIENocm9taXVtKQ",
+    dm_cover_img_str: "QU5HTEUgKEludGVsLCBJbnRlbChSKSBVSEQgR3JhcGhpY3MgNjMwICgweDAwMDAzRTlCKSBEaXJlY3QzRDExIHZzXzVfMCBwc181XzApLCBvciBzaW1pbGFy",
+    dm_img_inter: '{"ds":[],"wh":[0,0,0],"of":[0,0,0]}',
+};
+function totalOf(data, fallback) {
+    const n = parseInt(data?.numResults ?? "", 10);
+    return Number.isNaN(n) ? fallback : n;
+}
+export class SearchAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async _search(keyword, searchType, page, pageSize, order) {
+        keyword = (keyword || "").trim();
+        if (!keyword)
+            throw new Error("搜索关键词不能为空");
+        const params = {
+            search_type: searchType,
+            keyword,
+            page,
+            page_size: pageSize,
+            web_location: 1430654,
+            ...FINGERPRINT,
+        };
+        if (order)
+            params["order"] = order;
+        const headers = {
+            Referer: `https://search.bilibili.com/all?keyword=${encodeURIComponent(keyword)}`,
+        };
+        const payload = await this.client.getSigned(endpoints.SEARCH_TYPE, params, headers);
+        return payload?.data ?? {};
+    }
+    async videos(keyword, page = 1, pageSize = 20, order = "totalrank") {
+        if (!VIDEO_ORDERS.includes(order)) {
+            throw new Error(`order 只支持 ${VIDEO_ORDERS.join(", ")}`);
+        }
+        const data = await this._search(keyword, "video", page, pageSize, order);
+        const items = data.result ?? [];
+        const videos = items
+            .map((i) => Video.fromSearchItem(i))
+            .filter((v) => v !== null);
+        return [videos, totalOf(data, videos.length)];
+    }
+    async users(keyword, page = 1, pageSize = 20) {
+        const data = await this._search(keyword, "bili_user", page, pageSize);
+        const items = data.result ?? [];
+        const users = items
+            .map((i) => User.fromSearchItem(i))
+            .filter((u) => u !== null);
+        return [users, totalOf(data, users.length)];
+    }
+    iterVideos(keyword, pageSize = 20, order = "totalrank", maxPages) {
+        const fetch = (page) => this.videos(keyword, page, pageSize, order);
+        return iterPages(fetch, maxPages);
+    }
+    iterUsers(keyword, pageSize = 20, maxPages) {
+        const fetch = (page) => this.users(keyword, page, pageSize);
+        return iterPages(fetch, maxPages);
+    }
+}

package/dist/apis/space.d.ts

@@ -0,0 +1,17 @@
+/** 用户空间接口：个人信息、投稿视频列表、合集。
+
+这些接口都要求 WBI 签名，统一走 client.getSigned()，并带上空间页 Referer。
+*/
+import type { BiliClient } from "../client";
+import { Collection, Video } from "../models";
+export declare class SpaceAPI {
+    private client;
+    constructor(client: BiliClient);
+    private static referer;
+    info(uid: number): Promise<any>;
+    videos(uid: number, page?: number, pageSize?: number, order?: string): Promise<[Video[], number]>;
+    iterVideos(uid: number, pageSize?: number, order?: string, maxPages?: number): AsyncGenerator<Video, any, any>;
+    collections(uid: number, page?: number, pageSize?: number): Promise<[Collection[], number]>;
+    collection(seasonId: number, page?: number, pageSize?: number, mid?: number, author?: string): Promise<[Collection, Video[], number]>;
+    iterCollection(seasonId: number, pageSize?: number, mid?: number, maxPages?: number, author?: string): AsyncGenerator<Video, any, any>;
+}

package/dist/apis/space.js

@@ -0,0 +1,89 @@
+/** 用户空间接口：个人信息、投稿视频列表、合集。
+
+这些接口都要求 WBI 签名，统一走 client.getSigned()，并带上空间页 Referer。
+*/
+import * as endpoints from "../endpoints";
+import { Collection, Video } from "../models";
+import { iterPages } from "../pagination";
+export class SpaceAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    static referer(uid) {
+        return { Referer: `https://space.bilibili.com/${uid}/` };
+    }
+    async info(uid) {
+        const payload = await this.client.getSigned(endpoints.SPACE_INFO, { mid: uid }, SpaceAPI.referer(uid));
+        return payload?.data ?? {};
+    }
+    async videos(uid, page = 1, pageSize = 20, order = "pubdate") {
+        if (!["pubdate", "click", "stow"].includes(order)) {
+            throw new Error("order 只支持 pubdate / click / stow");
+        }
+        const payload = await this.client.getSigned(endpoints.SPACE_ARC_SEARCH, {
+            mid: uid,
+            pn: page,
+            ps: pageSize,
+            order,
+            platform: "web",
+            web_location: 1550101,
+        }, SpaceAPI.referer(uid));
+        const data = payload?.data ?? {};
+        const videoList = data.list ?? {};
+        const vlist = videoList.vlist ?? [];
+        const author = videoList.name ?? (data.card ?? {}).name ?? "";
+        const videos = vlist
+            .map((i) => Video.fromSpaceItem(i, author, uid))
+            .filter((v) => v !== null);
+        const total = (data.page ?? {}).count ?? videos.length;
+        return [videos, total];
+    }
+    iterVideos(uid, pageSize = 20, order = "pubdate", maxPages) {
+        const fetch = (page) => this.videos(uid, page, pageSize, order);
+        return iterPages(fetch, maxPages);
+    }
+    async collections(uid, page = 1, pageSize = 20) {
+        const payload = await this.client.get(endpoints.SEASONS_SERIES_LIST, { mid: uid, page_num: page, page_size: pageSize }, SpaceAPI.referer(uid));
+        const data = payload?.data ?? {};
+        const seasons = (data.items_lists ?? {}).seasons_list ?? [];
+        const collections = seasons
+            .map((i) => Collection.fromApi(i))
+            .filter((c) => c.seasonId);
+        // 接口的 page.total 把「系列」也算进去了，这里只返回合集，所以用实际条数
+        return [collections, collections.length];
+    }
+    async collection(seasonId, page = 1, pageSize = 30, mid, author = "") {
+        const params = {
+            season_id: seasonId,
+            sort_reverse: "false",
+            page_num: page,
+            page_size: pageSize,
+        };
+        let headers;
+        if (mid) {
+            mid = Number(mid);
+            params["mid"] = mid;
+            headers = {
+                Referer: `https://space.bilibili.com/${mid}/channel/collectiondetail` +
+                    `?sid=${seasonId}`,
+            };
+        }
+        const payload = await this.client.get(endpoints.SEASONS_ARCHIVES, params, headers);
+        const data = payload?.data ?? {};
+        const meta = data.meta ?? {};
+        const collection = Collection.fromApi(meta);
+        const archives = data.archives ?? [];
+        const videos = archives
+            .map((i) => Video.fromArchiveItem(i, author, meta.mid))
+            .filter((v) => v !== null);
+        const total = (data.page ?? {}).total ?? videos.length;
+        return [collection, videos, total];
+    }
+    iterCollection(seasonId, pageSize = 30, mid, maxPages, author = "") {
+        const fetch = (page) => {
+            return this.collection(seasonId, page, pageSize, mid, author).then(([, videos, total]) => [videos, total]);
+        };
+        return iterPages(fetch, maxPages);
+    }
+}

package/dist/apis/video.d.ts

@@ -0,0 +1,18 @@
+/** 视频相关接口：首页推荐流、视频详情、分P、播放地址、字幕。 */
+import type { BiliClient } from "../client";
+import { Page, PlayInfo, Subtitle, Video } from "../models";
+export declare class VideoAPI {
+    private client;
+    private pageInterval;
+    constructor(client: BiliClient, pageInterval?: number);
+    iterRecommend(pages?: number, pageSize?: number): AsyncGenerator<Video>;
+    recommend(pages?: number, pageSize?: number): Promise<Video[]>;
+    detail(bvid: string): Promise<Video>;
+    resolveAid(bvid: string): Promise<number>;
+    private referer;
+    pagelist(bvid: string): Promise<Page[]>;
+    playurl(bvid: string, page?: number, cid?: number, qn?: number): Promise<PlayInfo>;
+    subtitles(bvid: string, cid?: number): Promise<Subtitle[]>;
+    static pickSubtitle(subtitles: Subtitle[], lang?: string): Subtitle | null;
+    subtitleText(bvid: string, lang?: string, subtitle?: Subtitle | null, cid?: number): Promise<string>;
+}

package/dist/apis/video.js

@@ -0,0 +1,153 @@
+/** 视频相关接口：首页推荐流、视频详情、分P、播放地址、字幕。 */
+import { BiliApiError } from "../errors";
+import * as endpoints from "../endpoints";
+import { Page, PlayInfo, Subtitle, Video } from "../models";
+import { sleep } from "../util";
+export class VideoAPI {
+    client;
+    pageInterval;
+    constructor(client, pageInterval = 0.6) {
+        this.client = client;
+        this.pageInterval = pageInterval;
+    }
+    async *iterRecommend(pages = 1, pageSize = 10) {
+        const seen = new Set();
+        for (let page = 1; page <= pages; page++) {
+            const payload = await this.client.get(endpoints.RCMD_FEED, {
+                fresh_idx: page,
+                fresh_idx_1h: page,
+                feed_version: 1,
+                ps: pageSize,
+            });
+            const items = payload?.data?.item ?? [];
+            let added = 0;
+            for (const item of items) {
+                const video = Video.fromFeedItem(item);
+                if (video && !seen.has(video.bvid)) {
+                    seen.add(video.bvid);
+                    added += 1;
+                    yield video;
+                }
+            }
+            if (!added)
+                break;
+            if (page < pages)
+                await sleep(this.pageInterval * 1000);
+        }
+    }
+    async recommend(pages = 1, pageSize = 10) {
+        const out = [];
+        for await (const video of this.iterRecommend(pages, pageSize))
+            out.push(video);
+        return out;
+    }
+    async detail(bvid) {
+        const payload = await this.client.get(endpoints.VIDEO_VIEW, { bvid });
+        const video = Video.fromView(payload?.data);
+        if (!video.bvid)
+            video.bvid = bvid;
+        return video;
+    }
+    async resolveAid(bvid) {
+        const cacheKey = `aid:${bvid}`;
+        const cached = this.client.cache?.get(cacheKey);
+        if (cached)
+            return cached;
+        const video = await this.detail(bvid);
+        if (!video.aid)
+            throw new BiliApiError(`无法解析 ${bvid} 对应的 aid`);
+        this.client.cache?.set(cacheKey, video.aid);
+        return video.aid;
+    }
+    referer(bvid) {
+        return { Referer: `https://www.bilibili.com/video/${bvid}/` };
+    }
+    async pagelist(bvid) {
+        const payload = await this.client.get(endpoints.PLAYER_PAGELIST, { bvid }, this.referer(bvid));
+        const data = payload?.data ?? [];
+        const pages = data
+            .filter((i) => typeof i === "object")
+            .map((i) => Page.fromApi(i))
+            .filter((pg) => pg.cid);
+        if (!pages.length)
+            throw new BiliApiError(`${bvid} 没有可用的分P信息`);
+        return pages;
+    }
+    async playurl(bvid, page = 1, cid, qn = 80) {
+        if (cid == null) {
+            const pages = await this.pagelist(bvid);
+            if (!(1 <= page && page <= pages.length)) {
+                throw new Error(`page 超出范围：${bvid} 只有 ${pages.length} 个分P`);
+            }
+            cid = pages[page - 1].cid;
+        }
+        const payload = await this.client.get(endpoints.PLAYURL, {
+            bvid,
+            cid,
+            qn,
+            fnver: 0,
+            fnval: 4048,
+            fourk: 1,
+            platform: "pc",
+            high_quality: 1,
+        }, this.referer(bvid));
+        return PlayInfo.fromApi(payload?.data);
+    }
+    async subtitles(bvid, cid) {
+        if (cid == null)
+            cid = (await this.pagelist(bvid))[0].cid;
+        const payload = await this.client.getSigned(endpoints.PLAYER_V2, { bvid, cid }, this.referer(bvid));
+        const items = payload?.data?.subtitle?.subtitles ?? [];
+        return items
+            .map((i) => Subtitle.fromApi(i))
+            .filter((s) => s !== null);
+    }
+    static pickSubtitle(subtitles, lang = "zh") {
+        if (!subtitles.length)
+            return null;
+        lang = (lang || "zh").toLowerCase();
+        for (const subtitle of subtitles) {
+            if (subtitle.lan.toLowerCase() === lang)
+                return subtitle;
+        }
+        if (["zh", "zh-cn", "zh-hans"].includes(lang)) {
+            for (const subtitle of subtitles) {
+                const code = subtitle.lan.toLowerCase();
+                if (code.startsWith("ai-zh") ||
+                    code.startsWith("zh") ||
+                    subtitle.lanDoc.includes("中文")) {
+                    return subtitle;
+                }
+            }
+        }
+        for (const subtitle of subtitles) {
+            if (subtitle.lan.toLowerCase().startsWith(lang))
+                return subtitle;
+        }
+        return subtitles[0];
+    }
+    async subtitleText(bvid, lang = "zh", subtitle, cid) {
+        if (!subtitle) {
+            subtitle = VideoAPI.pickSubtitle(await this.subtitles(bvid, cid), lang);
+        }
+        if (!subtitle || !subtitle.url)
+            return "";
+        let url = subtitle.url;
+        if (url.startsWith("//"))
+            url = "https:" + url;
+        try {
+            const response = await this.client.http.get(url, {
+                timeout: this.client.timeout,
+            });
+            const data = response.data;
+            const body = data?.body ?? [];
+            return body
+                .filter((i) => i && i.content)
+                .map((i) => String(i.content))
+                .join("\n");
+        }
+        catch (exc) {
+            throw new BiliApiError(`字幕下载失败: ${exc.message}`);
+        }
+    }
+}

package/dist/cache.d.ts

@@ -0,0 +1,18 @@
+/** 本地 JSON 缓存：跨进程复用 WBI 密钥、bvid→aid 这类稳定或带 TTL 的数据。
+ *
+ * 对齐 Python 版 bili.cache.JsonCache：写文件用临时文件 + 原子替换，
+ * 失败时静默降级（缓存不是关键路径）。读 / 写在构造与调用时同步完成，
+ * 避免每次请求都 IO，也避免「刚写入又被新实例读到旧内容」的竞态。
+ */
+export declare class JsonCache {
+    readonly path: string;
+    private defaultTtl?;
+    private data;
+    constructor(cachePath: string, ttl?: number);
+    private load;
+    get<T = unknown>(key: string, defaultValue?: T): T | undefined;
+    set(key: string, value: unknown, ttlSec?: number): void;
+    delete(key: string): void;
+    clear(): void;
+    private save;
+}

package/dist/cache.js

@@ -0,0 +1,75 @@
+/** 本地 JSON 缓存：跨进程复用 WBI 密钥、bvid→aid 这类稳定或带 TTL 的数据。
+ *
+ * 对齐 Python 版 bili.cache.JsonCache：写文件用临时文件 + 原子替换，
+ * 失败时静默降级（缓存不是关键路径）。读 / 写在构造与调用时同步完成，
+ * 避免每次请求都 IO，也避免「刚写入又被新实例读到旧内容」的竞态。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
+import * as path from "node:path";
+export class JsonCache {
+    path;
+    defaultTtl;
+    data;
+    constructor(cachePath, ttl) {
+        this.path = cachePath;
+        this.defaultTtl = ttl;
+        this.data = this.load();
+    }
+    load() {
+        try {
+            if (!existsSync(this.path))
+                return {};
+            const text = readFileSync(this.path, "utf-8");
+            const parsed = JSON.parse(text);
+            return parsed && typeof parsed === "object"
+                ? parsed
+                : {};
+        }
+        catch {
+            return {}; // 文件损坏 / 不存在 → 空缓存（自愈）
+        }
+    }
+    get(key, defaultValue) {
+        const entry = this.data[key];
+        if (!entry || typeof entry !== "object")
+            return defaultValue;
+        if (entry.expires !== undefined && Date.now() > entry.expires) {
+            delete this.data[key];
+            this.save();
+            return defaultValue;
+        }
+        if (entry.value === null || entry.value === undefined)
+            return defaultValue;
+        return entry.value;
+    }
+    set(key, value, ttlSec) {
+        const ttl = ttlSec ?? this.defaultTtl;
+        const entry = { value };
+        if (ttl !== undefined && ttl !== null) {
+            entry.expires = Date.now() + ttl * 1000;
+        }
+        this.data[key] = entry;
+        this.save();
+    }
+    delete(key) {
+        if (key in this.data) {
+            delete this.data[key];
+            this.save();
+        }
+    }
+    clear() {
+        this.data = {};
+        this.save();
+    }
+    save() {
+        try {
+            mkdirSync(path.dirname(this.path), { recursive: true });
+            const tmp = `${this.path}.${process.pid}.tmp`;
+            writeFileSync(tmp, JSON.stringify(this.data, null, 2), "utf-8");
+            renameSync(tmp, this.path);
+        }
+        catch {
+            // 只读 / 无权限环境下静默降级：缓存不是关键路径
+        }
+    }
+}

package/dist/client.d.ts

@@ -0,0 +1,85 @@
+/** BiliClient：统一维护 Session、Cookie、请求细节和账号状态。
+
+内置基础节流与退避，目标是让请求节奏接近正常浏览，降低触发 B 站风控的概率：
+
+- 请求之间保持最小间隔（默认 0.6 秒，带随机抖动）
+- 写操作之间额外保持间隔（默认 1 秒）
+- GET 遇到网络错误或 -799「请求过于频繁」时指数退避重试
+- 写操作绝不自动重试，避免重复评论 / 重复私信
+- HTTP 412 与业务码 -412 视为风控信号，立即停止，不做重试
+*/
+import { AxiosInstance } from "axios";
+import { VideoAPI } from "./apis/video";
+import { SearchAPI } from "./apis/search";
+import { SpaceAPI } from "./apis/space";
+import { CommentAPI } from "./apis/comment";
+import { MessageAPI } from "./apis/message";
+import { NotifyAPI } from "./apis/notify";
+import { InteractAPI } from "./apis/interact";
+import { RelationAPI } from "./apis/relation";
+import { DynamicAPI } from "./apis/dynamic";
+import { ArticleAPI } from "./apis/article";
+import { ProfileAPI } from "./apis/profile";
+import { QrCodeLogin } from "./apis/auth";
+import { WbiSigner } from "./wbi";
+import { JsonCache } from "./cache";
+export declare const USER_AGENT: string;
+export declare const DEFAULT_HEADERS: Record<string, string>;
+export interface BiliClientOptions {
+    cookieFile?: string;
+    cacheFile?: string;
+    timeout?: number;
+    minInterval?: number;
+    jitter?: number;
+    maxRetries?: number;
+    writeInterval?: number;
+}
+export declare class BiliClient {
+    readonly http: AxiosInstance;
+    readonly timeout: number;
+    cookieFile: string;
+    minInterval: number;
+    jitter: number;
+    maxRetries: number;
+    writeInterval: number;
+    readonly video: VideoAPI;
+    readonly search: SearchAPI;
+    readonly space: SpaceAPI;
+    readonly comment: CommentAPI;
+    readonly message: MessageAPI;
+    readonly notify: NotifyAPI;
+    readonly interact: InteractAPI;
+    readonly relation: RelationAPI;
+    readonly dynamic: DynamicAPI;
+    readonly article: ArticleAPI;
+    readonly profile: ProfileAPI;
+    readonly auth: QrCodeLogin;
+    readonly wbi: WbiSigner;
+    readonly cache: JsonCache;
+    private lastRequestAt;
+    private lastWriteAt;
+    private cookies;
+    private _account;
+    constructor(opts?: BiliClientOptions);
+    get(url: string, params?: Record<string, unknown>, headers?: Record<string, string>, wbi?: boolean): Promise<any>;
+    post(url: string, data?: Record<string, unknown> | string, headers?: Record<string, string>, wbi?: boolean, params?: Record<string, unknown>, jsonBody?: boolean): Promise<any>;
+    getSigned(url: string, params?: Record<string, unknown>, headers?: Record<string, string>): Promise<any>;
+    private request;
+    private throttle;
+    private rememberRequest;
+    private backoff;
+    private applyCookieHeader;
+    loadCookies(): Promise<string>;
+    saveCookies(): Promise<string>;
+    /** 清空本地缓存（WBI 密钥、bvid→aid 等），下次请求会自动重新拉取。 */
+    clearCache(): void;
+    /** 供登录流程（未来实现）把 Set-Cookie 写入本地状态。 */
+    updateCookiesFromHeader(setCookie: string[]): void;
+    get isLoggedIn(): boolean;
+    get csrf(): string;
+    fetchAccount(): Promise<any | null>;
+    getAccount(): Promise<any | null>;
+    get username(): string | null;
+    checkLogin(): Promise<boolean>;
+    requireLogin(): Promise<any>;
+}