dsh-shlr-bilitoolkit 0.1.14 → 0.1.15

package/dist/dsh.js

@@ -141,31 +141,38 @@ export const TOOLS = [
     },
     {
         id: "bili_video_subtitle",
-        description: "获取视频字幕纯文本（优先 AI 字幕 / 中文），用于「读取视频内容」。无字幕返回空串。",
+        description: "视频字幕：默认返回字幕纯文本（优先中文）；list=true 时返回可用字幕轨列表。",
         parameters: {
             type: "object",
             properties: {
                 bvid: { type: "string" },
                 lang: { type: "string", default: "zh" },
+                list: { type: "boolean", default: false, description: "true 则只列字幕轨，不取正文" },
             },
             required: ["bvid"],
         },
         handler: async (a) => {
             const c = await getClient();
+            if (Boolean(a.list ?? false)) {
+                const subs = await c.video.subtitles(a.bvid);
+                return subs.map((s) => s.toDict());
+            }
             return { text: await c.video.subtitleText(a.bvid, a.lang ?? "zh") };
         },
     },
     {
-        id: "bili_search_video",
-        description: "搜索 B 站视频。",
+        id: "bili_search",
+        description: "搜索 B 站视频或用户。",
         parameters: {
             type: "object",
             properties: {
                 keyword: { type: "string" },
+                type: { type: "string", enum: ["video", "user"], default: "video" },
                 order: {
                     type: "string",
                     enum: ["totalrank", "click", "pubdate", "dm", "stow", "scores"],
                     default: "totalrank",
+                    description: "排序（仅视频）",
                 },
                 pageSize: { type: "integer", default: 20 },
             },
@@ -173,27 +180,15 @@ export const TOOLS = [
         },
         handler: async (a) => {
             const c = await getClient();
-            const [videos, total] = await c.search.videos(a.keyword, 1, Number(a.pageSize ?? 20), a.order ?? "totalrank");
+            const ps = Number(a.pageSize ?? 20);
+            if (String(a.type ?? "video") === "user") {
+                const [users, total] = await c.search.users(a.keyword, 1, ps);
+                return { total, users: users.map((u) => u.toDict()) };
+            }
+            const [videos, total] = await c.search.videos(a.keyword, 1, ps, a.order ?? "totalrank");
             return { total, videos: videos.map((v) => v.toDict()) };
         },
     },
-    {
-        id: "bili_search_user",
-        description: "搜索 B 站用户。",
-        parameters: {
-            type: "object",
-            properties: {
-                keyword: { type: "string" },
-                pageSize: { type: "integer", default: 20 },
-            },
-            required: ["keyword"],
-        },
-        handler: async (a) => {
-            const c = await getClient();
-            const [users, total] = await c.search.users(a.keyword, 1, Number(a.pageSize ?? 20));
-            return { total, users: users.map((u) => u.toDict()) };
-        },
-    },
     {
         id: "bili_space_info",
         description: "获取 B 站用户空间基本信息（昵称、等级、签名）。",
@@ -291,54 +286,50 @@ export const TOOLS = [
     // ---- 评论 ----
     {
         id: "bili_comment_list",
-        description: "获取视频评论（bvid），返回评论列表与总数。",
+        description: "获取评论列表（视频 / 动态 / 专栏），返回评论列表。",
         parameters: {
             type: "object",
             properties: {
-                bvid: { type: "string" },
+                target: { type: "string", enum: ["video", "dynamic", "article"], default: "video" },
+                id: { type: "string", description: "视频 bvid / 动态 id / 专栏 cv 号" },
                 sort: { type: "string", enum: ["time", "like", "reply"], default: "time" },
                 pageSize: { type: "integer", default: 20 },
             },
-            required: ["bvid"],
+            required: ["id"],
         },
         handler: async (a) => {
             const c = await getClient();
-            const [comments, total] = await c.comment.listVideo(a.bvid, 1, Number(a.pageSize ?? 20), a.sort ?? "time");
-            return { total, comments: comments.map((x) => x.toDict()) };
+            const target = String(a.target ?? "video");
+            const ps = Number(a.pageSize ?? 20);
+            const sort = a.sort ?? "time";
+            let items;
+            if (target === "dynamic")
+                [items] = await c.comment.listDynamic(a.id, 1, ps, sort);
+            else if (target === "article")
+                [items] = await c.comment.listArticle(a.id, 1, ps, sort);
+            else
+                [items] = await c.comment.listVideo(a.id, 1, ps, sort);
+            return { comments: items.map((x) => x.toDict()) };
         },
     },
     // ---- 关注关系 ----
     {
-        id: "bili_relation_followings",
-        description: "获取某用户的关注列表。",
-        parameters: {
-            type: "object",
-            properties: {
-                uid: { type: "integer" },
-                pageSize: { type: "integer", default: 20 },
-            },
-            required: ["uid"],
-        },
-        handler: async (a) => {
-            const c = await getClient();
-            const [users, total] = await c.relation.followings(Number(a.uid), 1, Number(a.pageSize ?? 20));
-            return { total, users: users.map((x) => x.toDict()) };
-        },
-    },
-    {
-        id: "bili_relation_followers",
-        description: "获取某用户的粉丝列表。",
+        id: "bili_relation_list",
+        description: "获取某用户的关注列表或粉丝列表。",
         parameters: {
             type: "object",
             properties: {
                 uid: { type: "integer" },
+                type: { type: "string", enum: ["followings", "followers"], default: "followings" },
                 pageSize: { type: "integer", default: 20 },
             },
             required: ["uid"],
         },
         handler: async (a) => {
             const c = await getClient();
-            const [users, total] = await c.relation.followers(Number(a.uid), 1, Number(a.pageSize ?? 20));
+            const [users, total] = String(a.type ?? "followings") === "followers"
+                ? await c.relation.followers(Number(a.uid), 1, Number(a.pageSize ?? 20))
+                : await c.relation.followings(Number(a.uid), 1, Number(a.pageSize ?? 20));
             return { total, users: users.map((x) => x.toDict()) };
         },
     },
@@ -349,16 +340,6 @@ export const TOOLS = [
         parameters: { type: "object", properties: {} },
         handler: async () => (await getClient()).notify.unread(),
     },
-    {
-        id: "bili_notify_replies",
-        description: "获取「回复我的」消息列表（需登录）。",
-        parameters: { type: "object", properties: {} },
-        handler: async () => {
-            const c = await getClient();
-            const [items, cursor, isEnd] = await c.notify.replies();
-            return { isEnd, cursor, notices: items.map((x) => x.toDict()) };
-        },
-    },
     // ---- 收藏夹（读取） ----
     {
         id: "bili_fav_folders",
@@ -401,35 +382,24 @@ export const TOOLS = [
     },
     {
         id: "bili_favorite",
-        description: "收藏视频到收藏夹（写操作，需登录）。",
+        description: "收藏或取消收藏视频到收藏夹（写操作，需登录）。",
         parameters: {
             type: "object",
             properties: {
                 bvid: { type: "string" },
+                action: { type: "string", enum: ["add", "remove"], default: "add" },
                 folderName: { type: "string" },
             },
             required: ["bvid"],
         },
-        handler: async (a) => {
-            const fid = await (await getClient()).interact.favorite(a.bvid, undefined, a.folderName);
-            return { folderId: fid };
-        },
-    },
-    {
-        id: "bili_send_comment",
-        description: "发表视频评论（写操作，需登录）。",
-        parameters: {
-            type: "object",
-            properties: {
-                bvid: { type: "string" },
-                message: { type: "string" },
-            },
-            required: ["bvid", "message"],
-        },
         handler: async (a) => {
             const c = await getClient();
-            const comment = await c.comment.sendVideo(a.bvid, a.message);
-            return comment.toDict();
+            if (String(a.action ?? "add") === "remove") {
+                const fid = await c.interact.unfavorite(a.bvid, undefined, a.folderName);
+                return { ok: true, folderId: fid };
+            }
+            const fid = await c.interact.favorite(a.bvid, undefined, a.folderName);
+            return { ok: true, folderId: fid };
         },
     },
     {
@@ -522,19 +492,6 @@ export const TOOLS = [
             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 直链）。高清晰度可能需登录 / 大会员。",
@@ -668,22 +625,6 @@ export const TOOLS = [
             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: "查询我是否已关注某用户。",
@@ -885,21 +826,25 @@ export const TOOLS = [
     },
     // ---- 消息中心补充 ----
     {
-        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_list",
+        description: "消息中心列表：回复我的 / @我的 / 收到的赞（需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                type: { type: "string", enum: ["replies", "ats", "likes"], default: "replies" },
+            },
         },
-    },
-    {
-        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()) };
+        handler: async (a) => {
+            const c = await getClient();
+            const t = String(a.type ?? "replies");
+            let items;
+            if (t === "ats")
+                [items] = await c.notify.ats();
+            else if (t === "likes")
+                [items] = await c.notify.likes();
+            else
+                [items] = await c.notify.replies();
+            return { notices: items.map((x) => x.toDict()) };
         },
     },
     // ---- 私信补充 ----
@@ -959,39 +904,36 @@ export const TOOLS = [
         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: "修改我的昵称 / 性别 / 生日（写操作，需登录，至少改一项）。",
+        description: "修改我的昵称 / 性别 / 生日 / 签名（写操作，需登录，至少改一项）。",
         parameters: {
             type: "object",
             properties: {
                 uname: { type: "string", description: "新昵称（1~20 字符）" },
                 sex: { type: "string", enum: ["男", "女", "保密"] },
                 birthday: { type: "string", description: "YYYY-MM-DD" },
+                sign: { type: "string", description: "个性签名（≤70 字）" },
             },
         },
         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);
+            const c = await getClient();
+            const hasProfile = a.uname != null || a.sex != null || a.birthday != null;
+            if (a.sign == null && !hasProfile) {
+                throw new Error("至少修改一项：uname / sex / birthday / sign");
+            }
+            if (a.sign != null)
+                await c.profile.updateSign(String(a.sign));
+            if (hasProfile) {
+                await c.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",
-        description: "查询当前是否已登录 B 站（返回用户名）。【用户想登录、或任何需登录操作报未登录（-101/CookieError）时，先调用本工具】；若返回未登录，必须立即调用 bili_gen_qr 向用户展示登录二维码图片。若此前调用过 bili_gen_qr，本工具会顺带轮询扫码状态：用户扫码并在手机确认后，返回登录成功并自动保存 Cookie。",
+        description: "查登录态（返回用户名）。想登录或报未登录（-101）时先调本工具；未登录则必须立即调 bili_gen_qr 展示二维码图片。刚调过 bili_gen_qr 时本工具会顺带轮询，用户确认后自动保存 Cookie。",
         parameters: { type: "object", properties: {} },
         handler: async () => {
             const c = await getClient();
@@ -1040,7 +982,7 @@ export const TOOLS = [
     },
     {
         id: "bili_gen_qr",
-        description: "【B 站登录唯一入口】生成 B 站扫码登录二维码图片。调用后必须把返回的二维码图片展示给用户扫码（用 qrDataUrl / qrImageUrl / qrImagePath 渲染成图片），不要只给链接、不要让用户手动跑命令。返回：url（二维码内容链接）、qrcodeKey（轮询用）、qrDataUrl（base64 data URL）、qrImageUrl（file:// 链接）、qrImagePath（本地 PNG 绝对路径）。用户扫码确认后，调用 bili_login_status 完成登录并保存 Cookie。",
+        description: "【登录唯一入口】生成扫码登录二维码。必须把返回的二维码图片展示给用户扫（用 qrDataUrl / qrImageUrl / qrImagePath 渲染成图片），不要只给链接。返回 url / qrcodeKey / qrDataUrl / qrImageUrl / qrImagePath。用户确认后调 bili_login_status 完成登录。",
         parameters: { type: "object", properties: {} },
         handler: async () => {
             const c = await getClient();

package/package.json

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