dsh-shlr-bilitoolkit 0.0.0-stage → 0.1.0

package/dist/apis/dynamic.js

@@ -0,0 +1,154 @@
+/** 动态：关注动态流、用户空间动态，以及发布 / 转发 / 点赞 / 删除。
+
+读取走网页版 polymer 接口，需要登录态。写操作（publish / repost / thumb /
+delete）都是公开行为，受风控和人机验证限制，使用前请自行确认。
+*/
+import * as endpoints from "../endpoints";
+import { BiliApiError } from "../errors";
+import { Dynamic } from "../models";
+const FEATURES = "itemOpusStyle";
+const REFERER = "https://t.bilibili.com/";
+export class DynamicAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+        this._detailCache = {};
+    }
+    _detailCache;
+    async detail(dynamicId) {
+        const id = String(Math.floor(Number(dynamicId)));
+        const cached = this._detailCache[id];
+        if (cached)
+            return cached;
+        const payload = await this.client.get(endpoints.DYNAMIC_DETAIL, { id, features: FEATURES }, { Referer: `https://t.bilibili.com/${id}` });
+        const dynamic = Dynamic.fromApi((payload?.data ?? {}).item);
+        if (!dynamic)
+            throw new BiliApiError("未找到该动态");
+        this._detailCache[id] = dynamic;
+        return dynamic;
+    }
+    async feed(page = 1, offset, type = "all") {
+        const params = {
+            type,
+            page,
+            timezone_offset: -480,
+            features: FEATURES,
+        };
+        if (offset)
+            params["offset"] = offset;
+        const payload = await this.client.get(endpoints.DYNAMIC_FEED_ALL, params, { Referer: "https://t.bilibili.com/" });
+        const data = payload?.data ?? {};
+        return [
+            DynamicAPI.parseItems(data),
+            String(data.offset ?? ""),
+            Boolean(data.has_more),
+        ];
+    }
+    async space(uid, offset = "") {
+        const payload = await this.client.get(endpoints.DYNAMIC_FEED_SPACE, { host_mid: Number(uid), offset: offset || "", features: FEATURES }, { Referer: `https://space.bilibili.com/${uid}/dynamic` });
+        const data = payload?.data ?? {};
+        return [
+            DynamicAPI.parseItems(data),
+            String(data.offset ?? ""),
+            Boolean(data.has_more),
+            Number(data.total ?? 0),
+        ];
+    }
+    async *iterFeed(maxPages, type = "all") {
+        let page = 1;
+        let offset;
+        while (maxPages == null || page <= maxPages) {
+            const [items, next, hasMore] = await this.feed(page, offset, type);
+            if (!items.length)
+                return;
+            for (const item of items)
+                yield item;
+            if (!hasMore)
+                return;
+            offset = next;
+            page += 1;
+        }
+    }
+    async *iterSpace(uid, maxPages) {
+        let page = 1;
+        let offset = "";
+        while (maxPages == null || page <= maxPages) {
+            const [items, next, hasMore] = await this.space(uid, offset);
+            if (!items.length)
+                return;
+            for (const item of items)
+                yield item;
+            if (!hasMore)
+                return;
+            offset = next;
+            page += 1;
+        }
+    }
+    // ------------------------------------------------------------------ 写操作
+    async publish(text, atUids, ctrl, closeComment = false) {
+        text = (text || "").trim();
+        if (!text)
+            throw new Error("动态内容不能为空");
+        const extension = { emoji_type: 1, from: { emoji_type: 1 }, flag_cfg: {} };
+        const form = {
+            dynamic_id: 0,
+            type: 4,
+            rid: 0,
+            content: text,
+            up_choose_comment: 0,
+            up_close_comment: closeComment ? 1 : 0,
+            extension: JSON.stringify(extension),
+            at_uids: (atUids ?? []).map(String).join(","),
+            ctrl: JSON.stringify(ctrl ?? []),
+            csrf: this.client.csrf,
+            csrf_token: this.client.csrf,
+        };
+        const payload = await this.client.post(endpoints.DYNAMIC_CREATE, form, { Referer: REFERER });
+        return DynamicAPI.dynamicId(payload);
+    }
+    async repost(dynamicId, text = "") {
+        const form = {
+            dynamic_id: String(Math.floor(Number(dynamicId))),
+            content: text || "",
+            csrf: this.client.csrf,
+            csrf_token: this.client.csrf,
+        };
+        const payload = await this.client.post(endpoints.DYNAMIC_REPUBLISH, form, { Referer: REFERER });
+        return DynamicAPI.dynamicId(payload);
+    }
+    async thumb(dynamicId, liked = true) {
+        const body = JSON.stringify({
+            dyn_id_str: String(Math.floor(Number(dynamicId))),
+            up: liked ? 1 : 2,
+        });
+        await this.client.post(endpoints.DYNAMIC_THUMB, body, {
+            "Content-Type": "application/json",
+            Referer: REFERER,
+        }, false, { csrf: this.client.csrf }, true);
+    }
+    async delete(dynamicId) {
+        const form = {
+            dynamic_id: String(Math.floor(Number(dynamicId))),
+            csrf: this.client.csrf,
+            csrf_token: this.client.csrf,
+        };
+        await this.client.post(endpoints.DYNAMIC_DELETE, form, { Referer: REFERER });
+    }
+    static dynamicId(payload) {
+        const data = payload?.data ?? {};
+        const value = data.dynamic_id_str ?? data.dynamic_id;
+        if (!value) {
+            throw new BiliApiError("动态接口未返回 dynamic_id，可能被风控拦截");
+        }
+        return String(value);
+    }
+    static parseItems(data) {
+        const items = [];
+        for (const item of data?.items ?? []) {
+            const dynamic = Dynamic.fromApi(item);
+            if (dynamic)
+                items.push(dynamic);
+        }
+        return items;
+    }
+}

package/dist/apis/interact.d.ts

@@ -0,0 +1,29 @@
+/** 互动接口：点赞、收藏、关注（真实写操作，需要登录并依赖 bili_jct）。 */
+import type { BiliClient } from "../client";
+import { Video } from "../models";
+export declare class InteractAPI {
+    private client;
+    constructor(client: BiliClient);
+    private static videoHeaders;
+    like(bvid?: string, aid?: number, liked?: boolean): Promise<void>;
+    hasLike(bvid?: string, aid?: number): Promise<boolean>;
+    folders(): Promise<Array<{
+        id: number;
+        name: string;
+        count: number;
+    }>>;
+    folderVideos(folderId: number, page?: number, pageSize?: number, order?: string): Promise<[Video[], number]>;
+    iterFolderVideos(folderId: number, pageSize?: number, order?: string, maxPages?: number): AsyncGenerator<Video, any, any>;
+    createFolder(title: string, privacy?: number): Promise<number>;
+    deleteFolder(folderId: number): Promise<void>;
+    favorite(bvid: string, folderId?: number, folderName?: string): Promise<number>;
+    unfavorite(bvid: string, folderId?: number, folderName?: string): Promise<number>;
+    coin(bvid?: string, aid?: number, count?: number, alsoLike?: boolean): Promise<void>;
+    coinsGiven(bvid?: string, aid?: number): Promise<number>;
+    triple(bvid: string, coinCount?: number, folderName?: string): Promise<Record<string, any>>;
+    follow(uid: number, follow?: boolean): Promise<void>;
+    isFollowing(uid: number): Promise<boolean>;
+    private mid;
+    private resolveAid;
+    private pickFolder;
+}

package/dist/apis/interact.js

@@ -0,0 +1,224 @@
+/** 互动接口：点赞、收藏、关注（真实写操作，需要登录并依赖 bili_jct）。 */
+import * as endpoints from "../endpoints";
+import { BiliApiError, CookieError } from "../errors";
+import { Video } from "../models";
+import { iterPages } from "../pagination";
+export class InteractAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    static videoHeaders(bvid) {
+        if (!bvid)
+            return undefined;
+        return { Referer: `https://www.bilibili.com/video/${bvid}/` };
+    }
+    // ------------------------------------------------------------------ 点赞
+    async like(bvid, aid, liked = true) {
+        const target = await this.resolveAid(bvid, aid);
+        await this.client.post(endpoints.VIDEO_LIKE, { aid: target, like: liked ? 1 : 2, csrf: this.client.csrf }, InteractAPI.videoHeaders(bvid));
+    }
+    async hasLike(bvid, aid) {
+        const target = await this.resolveAid(bvid, aid);
+        const payload = await this.client.get(endpoints.VIDEO_HAS_LIKE, { aid: target }, InteractAPI.videoHeaders(bvid));
+        const data = payload?.data;
+        if (data && typeof data === "object") {
+            return Boolean(data.like ?? data.has_like);
+        }
+        return Boolean(data);
+    }
+    // ------------------------------------------------------------------ 收藏
+    async folders() {
+        const payload = await this.client.get(endpoints.FAV_FOLDERS, {
+            up_mid: await this.mid(),
+            type: 2,
+        });
+        const items = ((payload?.data ?? {}).list ?? []);
+        return items
+            .filter((i) => i && i.id)
+            .map((i) => ({
+            id: Number(i.id),
+            name: i.title ?? i.name ?? "",
+            count: i.media_count ?? 0,
+        }));
+    }
+    async folderVideos(folderId, page = 1, pageSize = 20, order = "mtime") {
+        if (!["mtime", "view", "pubtime"].includes(order)) {
+            throw new Error("order 只支持 mtime / view / pubtime");
+        }
+        const payload = await this.client.get(endpoints.FAV_RESOURCE_LIST, {
+            media_id: Number(folderId),
+            pn: page,
+            ps: pageSize,
+            order,
+            type: 0,
+            tid: 0,
+            platform: "web",
+        }, {
+            Referer: `https://space.bilibili.com/${await this.mid()}/favlist?fid=${folderId}`,
+        });
+        const data = payload?.data ?? {};
+        const videos = [];
+        for (const item of data.medias ?? []) {
+            const v = Video.fromFavoriteItem(item);
+            if (v)
+                videos.push(v);
+        }
+        const total = (data.info ?? {}).media_count ?? videos.length;
+        return [videos, total];
+    }
+    iterFolderVideos(folderId, pageSize = 20, order = "mtime", maxPages) {
+        const fetch = (page) => this.folderVideos(folderId, page, pageSize, order);
+        return iterPages(fetch, maxPages);
+    }
+    async createFolder(title, privacy = 0) {
+        title = (title || "").trim();
+        if (!title)
+            throw new Error("收藏夹名称不能为空");
+        const payload = await this.client.post(endpoints.FAV_FOLDER_ADD, {
+            title,
+            privacy,
+            csrf: this.client.csrf,
+        });
+        const folderId = (payload?.data ?? {}).id;
+        if (!folderId)
+            throw new BiliApiError("创建收藏夹失败：接口未返回 id");
+        return Number(folderId);
+    }
+    async deleteFolder(folderId) {
+        await this.client.post(endpoints.FAV_FOLDER_DEL, {
+            media_ids: Number(folderId),
+            csrf: this.client.csrf,
+        });
+    }
+    async favorite(bvid, folderId, folderName) {
+        const aid = await this.resolveAid(bvid, null);
+        const fid = folderId ?? (await this.pickFolder(folderName));
+        await this.client.post(endpoints.FAV_DEAL, {
+            rid: aid,
+            type: 2, // 2 = 视频
+            add_media_ids: fid,
+            del_media_ids: "",
+            csrf: this.client.csrf,
+        }, InteractAPI.videoHeaders(bvid));
+        return Number(fid);
+    }
+    async unfavorite(bvid, folderId, folderName) {
+        const aid = await this.resolveAid(bvid, null);
+        const fid = folderId ?? (await this.pickFolder(folderName));
+        await this.client.post(endpoints.FAV_DEAL, {
+            rid: aid,
+            type: 2,
+            add_media_ids: "",
+            del_media_ids: fid,
+            csrf: this.client.csrf,
+        }, InteractAPI.videoHeaders(bvid));
+        return Number(fid);
+    }
+    // ------------------------------------------------------------------ 投币
+    async coin(bvid, aid, count = 1, alsoLike = false) {
+        if (![1, 2].includes(count))
+            throw new Error("投币数只能是 1 或 2");
+        const target = await this.resolveAid(bvid, aid);
+        await this.client.post(endpoints.COIN_ADD, {
+            aid: target,
+            multiply: count,
+            select_like: alsoLike ? 1 : 0,
+            csrf: this.client.csrf,
+        }, InteractAPI.videoHeaders(bvid));
+    }
+    async coinsGiven(bvid, aid) {
+        const target = await this.resolveAid(bvid, aid);
+        const payload = await this.client.get(endpoints.COIN_QUERY, { aid: target }, InteractAPI.videoHeaders(bvid));
+        return Number((payload?.data ?? {}).multiply ?? 0);
+    }
+    async triple(bvid, coinCount = 2, folderName) {
+        const result = {};
+        try {
+            if (await this.hasLike(bvid)) {
+                result["like"] = { ok: true, status: "skipped", message: "已点赞" };
+            }
+            else {
+                await this.like(bvid, undefined, true);
+                result["like"] = { ok: true, status: "done", message: "已点赞" };
+            }
+        }
+        catch (exc) {
+            result["like"] = excInfo(exc);
+        }
+        try {
+            const given = await this.coinsGiven(bvid);
+            const missing = coinCount - given;
+            if (missing <= 0) {
+                result["coin"] = { ok: true, status: "skipped", message: `已投 ${given} 币` };
+            }
+            else {
+                await this.coin(bvid, undefined, missing);
+                result["coin"] = { ok: true, status: "done", message: `投币 ${missing}` };
+            }
+        }
+        catch (exc) {
+            result["coin"] = excInfo(exc);
+        }
+        try {
+            const fid = await this.pickFolder(folderName);
+            await this.favorite(bvid, fid);
+            result["favorite"] = { ok: true, status: "done", message: `收藏到 ${fid}` };
+        }
+        catch (exc) {
+            result["favorite"] = excInfo(exc);
+        }
+        return result;
+    }
+    // ------------------------------------------------------------------ 关注
+    async follow(uid, follow = true) {
+        await this.client.post(endpoints.RELATION_MODIFY, {
+            fid: Number(uid),
+            act: follow ? 1 : 2,
+            re_src: 11,
+            csrf: this.client.csrf,
+        }, { Referer: `https://space.bilibili.com/${Number(uid)}/` });
+    }
+    async isFollowing(uid) {
+        const payload = await this.client.get(endpoints.RELATION, { fid: Number(uid) }, { Referer: `https://space.bilibili.com/${Number(uid)}/` });
+        // attribute: 0 未关注 / 2 已关注 / 6 互关 / 128 拉黑
+        return [2, 6].includes((payload?.data ?? {}).attribute);
+    }
+    // ------------------------------------------------------------------ 内部
+    async mid() {
+        const account = await this.client.getAccount();
+        const m = account?.mid;
+        if (!m) {
+            throw new CookieError("未登录，无法操作收藏夹，请先登录");
+        }
+        return Number(m);
+    }
+    async resolveAid(bvid, aid) {
+        if (aid)
+            return Number(aid);
+        if (!bvid)
+            throw new Error("bvid 和 aid 至少提供一个");
+        return this.client.video.resolveAid(bvid);
+    }
+    async pickFolder(folderName) {
+        const folders = await this.folders();
+        if (!folders.length)
+            throw new BiliApiError("账号下没有可用的收藏夹");
+        if (folderName) {
+            for (const f of folders)
+                if (f.name === folderName)
+                    return f.id;
+            throw new BiliApiError(`未找到收藏夹: ${folderName}`);
+        }
+        for (const f of folders)
+            if (f.name === "默认收藏夹")
+                return f.id;
+        return folders[0].id;
+    }
+}
+function excInfo(exc) {
+    if (exc instanceof BiliApiError) {
+        return { ok: false, status: "error", message: exc.message, code: exc.code };
+    }
+    return { ok: false, status: "error", message: String(exc) };
+}

package/dist/apis/message.d.ts

@@ -0,0 +1,18 @@
+/** 私信接口：发送、撤回、聊天记录、未读数。
+
+web 端私信要求带一个 UUID 形式的 msg[dev_id]；同一 client 实例内复用，
+避免每次都被当成新设备。dev_id 生成本次会话内稳定即可（不落盘）。
+*/
+import type { BiliClient } from "../client";
+import { PrivateMessage } from "../models";
+export declare function generateDevId(): string;
+export declare class MessageAPI {
+    private client;
+    constructor(client: BiliClient, devId?: string);
+    readonly devId: string;
+    private senderUid;
+    send(receiverUid: number, content: string, msgType?: number, newFaceVersion?: number): Promise<number>;
+    recall(receiverUid: number, msgKey: number): Promise<void>;
+    history(talkerUid: number, size?: number, sessionType?: number): Promise<PrivateMessage[]>;
+    unread(): Promise<Record<string, unknown>>;
+}

package/dist/apis/message.js

@@ -0,0 +1,109 @@
+/** 私信接口：发送、撤回、聊天记录、未读数。
+
+web 端私信要求带一个 UUID 形式的 msg[dev_id]；同一 client 实例内复用，
+避免每次都被当成新设备。dev_id 生成本次会话内稳定即可（不落盘）。
+*/
+import { randomInt } from "node:crypto";
+import * as endpoints from "../endpoints";
+import { BiliApiError, CookieError } from "../errors";
+import { PrivateMessage } from "../models";
+const DEV_ID_TEMPLATE = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx";
+const IM_HEADERS = {
+    Referer: "https://message.bilibili.com/",
+    Origin: "https://message.bilibili.com",
+};
+export function generateDevId() {
+    let out = "";
+    for (const ch of DEV_ID_TEMPLATE) {
+        if (ch === "-")
+            out += ch;
+        else if (ch === "x")
+            out += randomInt(0, 16).toString(16).toUpperCase();
+        else if (ch === "y") {
+            // UUID v4 变体位，取 8~B
+            out += ((randomInt(0, 16) & 3) | 8).toString(16).toUpperCase();
+        }
+        else
+            out += ch; // 固定的版本号 "4"
+    }
+    return out;
+}
+export class MessageAPI {
+    client;
+    constructor(client, devId) {
+        this.client = client;
+        this.devId = devId ?? generateDevId();
+    }
+    devId;
+    async senderUid() {
+        const account = await this.client.getAccount();
+        const mid = account?.mid;
+        if (!mid) {
+            throw new CookieError("未登录，无法使用私信功能，请先登录");
+        }
+        return Number(mid);
+    }
+    async send(receiverUid, content, msgType = 1, newFaceVersion = 1) {
+        content = (content || "").trim();
+        if (!content)
+            throw new Error("私信内容不能为空");
+        const sender = await this.senderUid();
+        const form = {
+            "msg[sender_uid]": sender,
+            "msg[receiver_id]": Number(receiverUid),
+            "msg[receiver_type]": 1,
+            "msg[msg_type]": msgType,
+            "msg[msg_status]": 0,
+            "msg[new_face_version]": newFaceVersion,
+            "msg[dev_id]": this.devId,
+            "msg[timestamp]": Math.floor(Date.now() / 1000),
+            "msg[content]": JSON.stringify({ content }),
+            csrf: this.client.csrf,
+        };
+        const payload = await this.client.post(endpoints.IM_SEND, form, IM_HEADERS);
+        const data = payload?.data ?? {};
+        const msgKey = data.msg_key;
+        if (!msgKey) {
+            throw new BiliApiError("私信接口未返回 msg_key，可能被风控拦截");
+        }
+        return Number(msgKey);
+    }
+    async recall(receiverUid, msgKey) {
+        const sender = await this.senderUid();
+        const form = {
+            "msg[sender_uid]": sender,
+            "msg[receiver_id]": Number(receiverUid),
+            "msg[receiver_type]": 1,
+            "msg[msg_type]": 5,
+            "msg[msg_status]": 0,
+            "msg[dev_id]": this.devId,
+            "msg[timestamp]": Math.floor(Date.now() / 1000),
+            "msg[content]": String(msgKey),
+            csrf: this.client.csrf,
+        };
+        await this.client.post(endpoints.IM_SEND, form, IM_HEADERS);
+    }
+    async history(talkerUid, size = 20, sessionType = 1) {
+        const payload = await this.client.get(endpoints.IM_FETCH, {
+            sender_device_id: 1,
+            talker_id: Number(talkerUid),
+            session_type: sessionType,
+            size,
+            build: 0,
+            mobi_app: "web",
+        }, IM_HEADERS);
+        const data = payload?.data;
+        const messages = data && typeof data === "object" ? data.messages : [];
+        const result = (messages ?? [])
+            .filter((i) => i && typeof i === "object")
+            .map((i) => PrivateMessage.fromApi(i));
+        result.sort((a, b) => {
+            return (a.seqno || 0) - (b.seqno || 0) || (a.timestamp || 0) - (b.timestamp || 0);
+        });
+        return result;
+    }
+    async unread() {
+        const payload = await this.client.get(endpoints.IM_UNREAD, undefined, IM_HEADERS);
+        return payload?.data ?? {};
+    }
+}

package/dist/apis/notify.d.ts

@@ -0,0 +1,17 @@
+/** 消息中心：未读数、回复我的、@我的、收到的赞。
+
+注意：这类列表接口的分页游标（cursor.id）实测传回去仍返回同一页，
+所以这里只保证「最近一页」；更早的消息请到网页端查看。
+*/
+import type { BiliClient } from "../client";
+import { Notice } from "../models";
+export declare class NotifyAPI {
+    private client;
+    constructor(client: BiliClient);
+    unread(): Promise<Record<string, unknown>>;
+    replies(cursor?: number, replyType?: number): Promise<[Notice[], Record<string, unknown>, boolean]>;
+    ats(cursor?: number): Promise<[Notice[], Record<string, unknown>, boolean]>;
+    likes(cursor?: number, likeType?: number): Promise<[Notice[], Record<string, unknown>, boolean]>;
+    private fetch;
+    private static parse;
+}

package/dist/apis/notify.js

@@ -0,0 +1,54 @@
+/** 消息中心：未读数、回复我的、@我的、收到的赞。
+
+注意：这类列表接口的分页游标（cursor.id）实测传回去仍返回同一页，
+所以这里只保证「最近一页」；更早的消息请到网页端查看。
+*/
+import * as endpoints from "../endpoints";
+import { Notice } from "../models";
+const COMMON_PARAMS = { platform: "web", build: 0, mobi_app: "web" };
+function cursorId(cursor) {
+    if (cursor && typeof cursor === "object")
+        return Number(cursor.id ?? 0);
+    return Number(cursor ?? 0);
+}
+export class NotifyAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async unread() {
+        const payload = await this.client.get(endpoints.MSGFEED_UNREAD);
+        return payload?.data ?? {};
+    }
+    async replies(cursor = 0, replyType = 0) {
+        const data = this.fetch(endpoints.MSGFEED_REPLY, { id: cursorId(cursor), reply_type: replyType });
+        return NotifyAPI.parse(await data, Notice.fromReply);
+    }
+    async ats(cursor = 0) {
+        const data = this.fetch(endpoints.MSGFEED_AT, { id: cursorId(cursor) });
+        return NotifyAPI.parse(await data, Notice.fromAt);
+    }
+    async likes(cursor = 0, likeType = 0) {
+        const data = await this.fetch(endpoints.MSGFEED_LIKE, {
+            id: cursorId(cursor),
+            like_type: likeType,
+        });
+        const block = (await data).total ?? {};
+        const items = (block.items ?? [])
+            .filter((i) => i && typeof i === "object")
+            .map((i) => Notice.fromLike(i));
+        const cursorData = block.cursor ?? {};
+        return [items, cursorData, Boolean(cursorData.is_end)];
+    }
+    async fetch(url, params) {
+        const payload = await this.client.get(url, { ...COMMON_PARAMS, ...params });
+        return payload?.data ?? {};
+    }
+    static parse(data, parser) {
+        const items = (data.items ?? [])
+            .filter((i) => i && typeof i === "object")
+            .map((i) => parser(i));
+        const cursor = data.cursor ?? {};
+        return [items, cursor, Boolean(cursor.is_end)];
+    }
+}

package/dist/apis/profile.d.ts

@@ -0,0 +1,15 @@
+/** 个人资料：读取、修改签名、修改昵称 / 性别 / 生日。
+
+写接口都没有在真实账号上执行过：
+- updateSign 用的是 x/member/web/sign/update，改完进入审核队列。
+- updateProfile 用的是 x/member/web/update，只支持昵称、性别、生日。
+*/
+import type { BiliClient } from "../client";
+export declare class ProfileAPI {
+    private client;
+    constructor(client: BiliClient);
+    info(): Promise<Record<string, unknown>>;
+    avatarUrl(): Promise<string>;
+    updateSign(sign: string): Promise<void>;
+    updateProfile(uname?: string, sex?: string, birthday?: string): Promise<void>;
+}

package/dist/apis/profile.js

@@ -0,0 +1,59 @@
+/** 个人资料：读取、修改签名、修改昵称 / 性别 / 生日。
+
+写接口都没有在真实账号上执行过：
+- updateSign 用的是 x/member/web/sign/update，改完进入审核队列。
+- updateProfile 用的是 x/member/web/update，只支持昵称、性别、生日。
+*/
+import * as endpoints from "../endpoints";
+const SEX_VALUES = ["男", "女", "保密"];
+const MAX_SIGN_LENGTH = 70;
+export class ProfileAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async info() {
+        const payload = await this.client.get(endpoints.MEMBER_ACCOUNT);
+        return payload?.data ?? {};
+    }
+    async avatarUrl() {
+        const payload = await this.client.get(endpoints.MEMBER_MYINFO);
+        return String((payload?.data ?? {}).face ?? "");
+    }
+    async updateSign(sign) {
+        sign = (sign || "").trim();
+        if (sign.length > MAX_SIGN_LENGTH) {
+            throw new Error(`签名最多 ${MAX_SIGN_LENGTH} 个字符`);
+        }
+        await this.client.post(endpoints.MEMBER_SIGN_UPDATE, {
+            user_sign: sign,
+            csrf: this.client.csrf,
+        });
+    }
+    async updateProfile(uname, sex, birthday) {
+        const form = { csrf: this.client.csrf };
+        if (uname != null) {
+            const name = uname.trim();
+            if (!(1 <= name.length && name.length <= 20)) {
+                throw new Error("昵称长度需要在 1~20 个字符之间");
+            }
+            form["uname"] = name;
+        }
+        if (sex != null) {
+            if (!SEX_VALUES.includes(sex)) {
+                throw new Error(`sex 只支持 ${SEX_VALUES}`);
+            }
+            form["sex"] = sex;
+        }
+        if (birthday != null) {
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(birthday)) {
+                throw new Error("birthday 需要 YYYY-MM-DD 格式");
+            }
+            form["birthday"] = birthday;
+        }
+        if (Object.keys(form).length === 1) {
+            throw new Error("至少要修改一项：uname / sex / birthday");
+        }
+        await this.client.post(endpoints.MEMBER_PROFILE_UPDATE, form);
+    }
+}