dsh-shlr-bilitoolkit 0.1.7 → 0.1.8

package/README.md

@@ -71,8 +71,8 @@ const [ups, _] = await client.space.videos(574115689, 1, 10);
 
 - 包名 `dsh-shlr-bilitoolkit`（符合 `dsh-` 前缀约定），`package.json` 里声明了 `dsh.bundle.patch: ./cordis.patch.yml`，因此会被 dsh 识别为插件而非普通库。
 - 入口 `src/dsh.ts` 导出 `apply(ctx)`，注册一组工具（读取为主，写操作明确标注「需登录 / 谨慎」）：
-  - 读取：`bili_recommend` / `bili_video_detail` / `bili_video_subtitle` / `bili_search_video` / `bili_search_user` / `bili_space_info` / `bili_space_videos` / `bili_article_view` / `bili_article_list` / `bili_dynamic_feed` / `bili_dynamic_space` / `bili_comment_list` / `bili_relation_followings` / `bili_relation_followers` / `bili_notify_unread` / `bili_notify_replies` / `bili_fav_folders`
-  - 写操作：`bili_like` / `bili_follow` / `bili_favorite` / `bili_send_comment` / `bili_send_message` / `bili_triple` / `bili_dynamic_publish` / `bili_dynamic_repost`（均会真实修改账号状态，需登录）
+  - 读取：`bili_recommend` / `bili_video_detail` / `bili_video_subtitle` / `bili_search_video` / `bili_search_user` / `bili_space_info` / `bili_space_videos` / `bili_article_view` / `bili_article_list` / `bili_dynamic_feed` / `bili_dynamic_space` / `bili_comment_list` / `bili_relation_followings` / `bili_relation_followers` / `bili_notify_unread` / `bili_notify_replies` / `bili_fav_folders` / `bili_video_pagelist` / `bili_video_subtitles` / `bili_video_playurl` / `bili_video_status` / `bili_space_collections` / `bili_space_collection` / `bili_fav_folder_videos` / `bili_dynamic_detail` / `bili_notify_ats` / `bili_notify_likes` / `bili_message_unread` / `bili_message_history` / `bili_relation_stat` / `bili_user_following` / `bili_profile_info` / `bili_comment_replies`
+  - 写操作：`bili_like` / `bili_follow` / `bili_favorite` / `bili_send_comment` / `bili_send_message` / `bili_triple` / `bili_dynamic_publish` / `bili_dynamic_repost` / `bili_coin` / `bili_unfavorite` / `bili_fav_folder_create` / `bili_fav_folder_delete` / `bili_dynamic_like` / `bili_dynamic_delete` / `bili_comment_send` / `bili_comment_reply` / `bili_comment_delete` / `bili_message_recall` / `bili_profile_update_sign` / `bili_profile_update`（均会真实修改账号状态，需登录）
   - 辅助：`bili_login_status`（查登录态）/ `bili_gen_qr`（生成扫码登录二维码）/ `bili_cache_clear`（清空本地缓存）
 - 工具读取 `BILI_COOKIE_FILE`（默认 `bili_cookies.json`）作为登录态。
 - **扫码登录（独立获取 Cookie）**：运行 `npm run login`，终端会打印 ASCII 二维码，用「哔哩哔哩」App 扫码并确认后，Cookie 自动写入 `bili_cookies.json`。也可在对话里先调 `bili_login_status` 查登录态、调 `bili_gen_qr` 拿二维码链接与可直接展示的 `ascii` 二维码。写操作（点赞 / 收藏 / 投币 / 关注 / 评论 / 私信 / 三连）都依赖该 Cookie 中的 `SESSDATA` / `bili_jct`。

package/dist/dsh.js

@@ -491,6 +491,457 @@ export const TOOLS = [
             return { ok: true, dynamicId: id, url: `https://t.bilibili.com/${id}` };
         },
     },
+    // ---- 视频补充 ----
+    {
+        id: "bili_video_pagelist",
+        description: "获取视频的分 P 列表（标题 + cid），用于定位具体某一 P。",
+        parameters: {
+            type: "object",
+            properties: { bvid: { type: "string" } },
+            required: ["bvid"],
+        },
+        handler: async (a) => {
+            const pages = await (await getClient()).video.pagelist(a.bvid);
+            return pages.map((p) => p.toDict());
+        },
+    },
+    {
+        id: "bili_video_subtitles",
+        description: "列出视频可用的字幕轨（语言 / 名称 / 链接），不含正文。",
+        parameters: {
+            type: "object",
+            properties: { bvid: { type: "string" } },
+            required: ["bvid"],
+        },
+        handler: async (a) => {
+            const subs = await (await getClient()).video.subtitles(a.bvid);
+            return subs.map((s) => s.toDict());
+        },
+    },
+    {
+        id: "bili_video_playurl",
+        description: "获取视频播放地址信息（清晰度、可用清晰度列表、durl 直链）。高清晰度可能需登录 / 大会员。",
+        parameters: {
+            type: "object",
+            properties: {
+                bvid: { type: "string" },
+                page: { type: "integer", default: 1 },
+                qn: { type: "integer", default: 80 },
+            },
+            required: ["bvid"],
+        },
+        handler: async (a) => {
+            const info = await (await getClient()).video.playurl(a.bvid, Number(a.page ?? 1), undefined, Number(a.qn ?? 80));
+            return info.toDict();
+        },
+    },
+    {
+        id: "bili_video_status",
+        description: "查询我对某视频的互动状态：是否已点赞、已投硬币数。",
+        parameters: {
+            type: "object",
+            properties: { bvid: { type: "string" } },
+            required: ["bvid"],
+        },
+        handler: async (a) => {
+            const c = await getClient();
+            const [liked, coins] = await Promise.all([
+                c.interact.hasLike(a.bvid),
+                c.interact.coinsGiven(a.bvid),
+            ]);
+            return { liked, coins };
+        },
+    },
+    // ---- 空间 / 合集 ----
+    {
+        id: "bili_space_collections",
+        description: "获取某 UP 主的合集 / 系列列表。",
+        parameters: {
+            type: "object",
+            properties: {
+                uid: { type: "integer" },
+                pageSize: { type: "integer", default: 20 },
+            },
+            required: ["uid"],
+        },
+        handler: async (a) => {
+            const [cols, total] = await (await getClient()).space.collections(Number(a.uid), 1, Number(a.pageSize ?? 20));
+            return { total, collections: cols.map((c) => c.toDict()) };
+        },
+    },
+    {
+        id: "bili_space_collection",
+        description: "获取某个合集内的视频列表。",
+        parameters: {
+            type: "object",
+            properties: {
+                seasonId: { type: "integer" },
+                mid: { type: "integer", description: "UP 主 uid（可选，用于正确 Referer）" },
+                pageSize: { type: "integer", default: 30 },
+            },
+            required: ["seasonId"],
+        },
+        handler: async (a) => {
+            const [col, videos, total] = await (await getClient()).space.collection(Number(a.seasonId), 1, Number(a.pageSize ?? 30), a.mid != null ? Number(a.mid) : undefined);
+            return { collection: col.toDict(), total, videos: videos.map((v) => v.toDict()) };
+        },
+    },
+    // ---- 收藏夹 ----
+    {
+        id: "bili_fav_folder_videos",
+        description: "获取某个收藏夹内的视频列表（需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                folderId: { type: "integer" },
+                order: { type: "string", enum: ["mtime", "view", "pubtime"], default: "mtime" },
+                pageSize: { type: "integer", default: 20 },
+            },
+            required: ["folderId"],
+        },
+        handler: async (a) => {
+            const [videos, total] = await (await getClient()).interact.folderVideos(Number(a.folderId), 1, Number(a.pageSize ?? 20), a.order ?? "mtime");
+            return { total, videos: videos.map((v) => v.toDict()) };
+        },
+    },
+    {
+        id: "bili_fav_folder_create",
+        description: "新建收藏夹（写操作，需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                title: { type: "string" },
+                privacy: { type: "integer", enum: [0, 1], default: 0, description: "0 公开 / 1 私密" },
+            },
+            required: ["title"],
+        },
+        handler: async (a) => {
+            const id = await (await getClient()).interact.createFolder(String(a.title ?? ""), Number(a.privacy ?? 0));
+            return { ok: true, folderId: id };
+        },
+    },
+    {
+        id: "bili_fav_folder_delete",
+        description: "删除收藏夹（写操作，需登录，谨慎）。",
+        parameters: {
+            type: "object",
+            properties: { folderId: { type: "integer" } },
+            required: ["folderId"],
+        },
+        handler: async (a) => {
+            await (await getClient()).interact.deleteFolder(Number(a.folderId));
+            return { ok: true };
+        },
+    },
+    // ---- 互动写操作补充 ----
+    {
+        id: "bili_coin",
+        description: "给视频投币（写操作，需登录，硬币每日有限且不可退回）。",
+        parameters: {
+            type: "object",
+            properties: {
+                bvid: { type: "string" },
+                count: { type: "integer", enum: [1, 2], default: 1 },
+                alsoLike: { type: "boolean", default: false },
+            },
+            required: ["bvid"],
+        },
+        handler: async (a) => {
+            await (await getClient()).interact.coin(a.bvid, undefined, Number(a.count ?? 1), Boolean(a.alsoLike ?? false));
+            return { ok: true };
+        },
+    },
+    {
+        id: "bili_unfavorite",
+        description: "把视频从收藏夹移除（写操作，需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                bvid: { type: "string" },
+                folderName: { type: "string", description: "收藏夹名（可选，默认取默认收藏夹）" },
+            },
+            required: ["bvid"],
+        },
+        handler: async (a) => {
+            const fid = await (await getClient()).interact.unfavorite(a.bvid, undefined, a.folderName);
+            return { ok: true, folderId: fid };
+        },
+    },
+    {
+        id: "bili_user_following",
+        description: "查询我是否已关注某用户。",
+        parameters: {
+            type: "object",
+            properties: { uid: { type: "integer" } },
+            required: ["uid"],
+        },
+        handler: async (a) => ({
+            following: await (await getClient()).interact.isFollowing(Number(a.uid)),
+        }),
+    },
+    // ---- 动态补充 ----
+    {
+        id: "bili_dynamic_detail",
+        description: "获取单条动态详情（正文、类型、统计数据等）。",
+        parameters: {
+            type: "object",
+            properties: { dynamicId: { type: "string" } },
+            required: ["dynamicId"],
+        },
+        handler: async (a) => (await (await getClient()).dynamic.detail(a.dynamicId)).toDict(),
+    },
+    {
+        id: "bili_dynamic_like",
+        description: "点赞或取消点赞一条动态（写操作，需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                dynamicId: { type: "string" },
+                liked: { type: "boolean", default: true },
+            },
+            required: ["dynamicId"],
+        },
+        handler: async (a) => {
+            await (await getClient()).dynamic.thumb(a.dynamicId, Boolean(a.liked ?? true));
+            return { ok: true };
+        },
+    },
+    {
+        id: "bili_dynamic_delete",
+        description: "删除自己发布的一条动态（写操作，需登录，谨慎）。",
+        parameters: {
+            type: "object",
+            properties: { dynamicId: { type: "string" } },
+            required: ["dynamicId"],
+        },
+        handler: async (a) => {
+            await (await getClient()).dynamic.delete(a.dynamicId);
+            return { ok: true };
+        },
+    },
+    // ---- 评论（动态 / 专栏 / 楼中楼 / 回复 / 删除） ----
+    {
+        id: "bili_comment_send",
+        description: "在视频 / 动态 / 专栏下发表评论（写操作，需登录）。视频用 bvid，动态用动态 id，专栏用 cv 号 / 链接。",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string", enum: ["video", "dynamic", "article"], default: "video" },
+                id: { type: "string", description: "视频 bvid / 动态 id / 专栏 cv 号或链接" },
+                message: { type: "string" },
+            },
+            required: ["id", "message"],
+        },
+        handler: async (a) => {
+            const c = await getClient();
+            const message = String(a.message ?? "");
+            const target = String(a.target ?? "video");
+            let comment;
+            if (target === "video")
+                comment = await c.comment.sendVideo(a.id, message);
+            else if (target === "dynamic")
+                comment = await c.comment.sendDynamic(a.id, message);
+            else if (target === "article")
+                comment = await c.comment.sendArticle(a.id, message);
+            else
+                throw new Error("target 只支持 video / dynamic / article");
+            return comment.toDict();
+        },
+    },
+    {
+        id: "bili_comment_replies",
+        description: "获取某条评论下的楼中楼回复列表。",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string", enum: ["video", "dynamic", "article"], default: "video" },
+                id: { type: "string" },
+                rootRpid: { type: "integer", description: "根评论 rpid" },
+                pageSize: { type: "integer", default: 20 },
+            },
+            required: ["id", "rootRpid"],
+        },
+        handler: async (a) => {
+            const c = await getClient();
+            const target = String(a.target ?? "video");
+            const root = Number(a.rootRpid);
+            const ps = Number(a.pageSize ?? 20);
+            let items;
+            if (target === "video")
+                [items] = await c.comment.repliesVideo(a.id, root, 1, ps);
+            else if (target === "dynamic")
+                [items] = await c.comment.repliesDynamic(a.id, root, 1, ps);
+            else if (target === "article")
+                [items] = await c.comment.repliesArticle(a.id, root, 1, ps);
+            else
+                throw new Error("target 只支持 video / dynamic / article");
+            return { replies: items.map((x) => x.toDict()) };
+        },
+    },
+    {
+        id: "bili_comment_reply",
+        description: "回复某条评论（楼中楼，写操作，需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string", enum: ["video", "dynamic", "article"], default: "video" },
+                id: { type: "string" },
+                rootRpid: { type: "integer" },
+                message: { type: "string" },
+                parentRpid: { type: "integer", description: "被回复的评论 rpid（可选，默认同 rootRpid）" },
+            },
+            required: ["id", "rootRpid", "message"],
+        },
+        handler: async (a) => {
+            const c = await getClient();
+            const target = String(a.target ?? "video");
+            const root = Number(a.rootRpid);
+            const parent = a.parentRpid != null ? Number(a.parentRpid) : root;
+            const message = String(a.message ?? "");
+            let comment;
+            if (target === "video")
+                comment = await c.comment.replyVideo(a.id, root, message, parent);
+            else if (target === "dynamic")
+                comment = await c.comment.sendDynamic(a.id, message, root, parent);
+            else if (target === "article")
+                comment = await c.comment.sendArticle(a.id, message, root, parent);
+            else
+                throw new Error("target 只支持 video / dynamic / article");
+            return comment.toDict();
+        },
+    },
+    {
+        id: "bili_comment_delete",
+        description: "删除自己发表的评论（写操作，需登录，谨慎）。",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string", enum: ["video", "dynamic", "article"], default: "video" },
+                id: { type: "string" },
+                rpid: { type: "integer" },
+            },
+            required: ["id", "rpid"],
+        },
+        handler: async (a) => {
+            const c = await getClient();
+            const target = String(a.target ?? "video");
+            const rpid = Number(a.rpid);
+            if (target === "video")
+                await c.comment.deleteVideo(a.id, rpid);
+            else if (target === "dynamic")
+                await c.comment.deleteDynamic(a.id, rpid);
+            else if (target === "article")
+                await c.comment.deleteArticle(a.id, rpid);
+            else
+                throw new Error("target 只支持 video / dynamic / article");
+            return { ok: true };
+        },
+    },
+    // ---- 消息中心补充 ----
+    {
+        id: "bili_notify_ats",
+        description: "获取「@我的」消息列表（需登录）。",
+        parameters: { type: "object", properties: {} },
+        handler: async () => {
+            const [items, , isEnd] = await (await getClient()).notify.ats();
+            return { isEnd, notices: items.map((x) => x.toDict()) };
+        },
+    },
+    {
+        id: "bili_notify_likes",
+        description: "获取「收到的赞」列表（需登录）。",
+        parameters: { type: "object", properties: {} },
+        handler: async () => {
+            const [items, , isEnd] = await (await getClient()).notify.likes();
+            return { isEnd, notices: items.map((x) => x.toDict()) };
+        },
+    },
+    // ---- 私信补充 ----
+    {
+        id: "bili_message_unread",
+        description: "获取私信未读数（需登录）。",
+        parameters: { type: "object", properties: {} },
+        handler: async () => (await getClient()).message.unread(),
+    },
+    {
+        id: "bili_message_history",
+        description: "获取与某用户的私信聊天记录（需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                talkerUid: { type: "integer" },
+                size: { type: "integer", default: 20 },
+            },
+            required: ["talkerUid"],
+        },
+        handler: async (a) => {
+            const msgs = await (await getClient()).message.history(Number(a.talkerUid), Number(a.size ?? 20));
+            return { messages: msgs.map((m) => m.toDict()) };
+        },
+    },
+    {
+        id: "bili_message_recall",
+        description: "撤回一条已发送的私信（写操作，需登录，通常有时限）。",
+        parameters: {
+            type: "object",
+            properties: {
+                receiverUid: { type: "integer" },
+                msgKey: { type: "integer" },
+            },
+            required: ["receiverUid", "msgKey"],
+        },
+        handler: async (a) => {
+            await (await getClient()).message.recall(Number(a.receiverUid), Number(a.msgKey));
+            return { ok: true };
+        },
+    },
+    // ---- 关注统计 ----
+    {
+        id: "bili_relation_stat",
+        description: "获取某用户的关注数 / 粉丝数统计。",
+        parameters: {
+            type: "object",
+            properties: { uid: { type: "integer" } },
+            required: ["uid"],
+        },
+        handler: async (a) => (await getClient()).relation.stat(Number(a.uid)),
+    },
+    // ---- 个人资料 ----
+    {
+        id: "bili_profile_info",
+        description: "获取我的个人资料（昵称、等级、硬币、签名等，需登录）。",
+        parameters: { type: "object", properties: {} },
+        handler: async () => (await getClient()).profile.info(),
+    },
+    {
+        id: "bili_profile_update_sign",
+        description: "修改我的个性签名（写操作，需登录，会进入审核）。",
+        parameters: {
+            type: "object",
+            properties: { sign: { type: "string" } },
+            required: ["sign"],
+        },
+        handler: async (a) => {
+            await (await getClient()).profile.updateSign(String(a.sign ?? ""));
+            return { ok: true };
+        },
+    },
+    {
+        id: "bili_profile_update",
+        description: "修改我的昵称 / 性别 / 生日（写操作，需登录，至少改一项）。",
+        parameters: {
+            type: "object",
+            properties: {
+                uname: { type: "string", description: "新昵称（1~20 字符）" },
+                sex: { type: "string", enum: ["男", "女", "保密"] },
+                birthday: { type: "string", description: "YYYY-MM-DD" },
+            },
+        },
+        handler: async (a) => {
+            await (await getClient()).profile.updateProfile(a.uname != null ? String(a.uname) : undefined, a.sex != null ? String(a.sex) : undefined, a.birthday != null ? String(a.birthday) : undefined);
+            return { ok: true };
+        },
+    },
     // ---- 登录状态 ----
     {
         id: "bili_login_status",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-shlr-bilitoolkit",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "深海猎人专用B站接口工具箱 dsh 插件。",
   "type": "module",
   "main": "dist/dsh.js",