dsh-shlr-bilitoolkit 0.1.18 → 0.1.19

package/dist/dsh.d.ts

@@ -30,6 +30,8 @@ export interface DshTool {
  * 这里统一处理：丢 undefined、NaN/Infinity 转 null、bigint 转字符串。
  */
 export declare function toLosslessJson(value: unknown): unknown;
+/** 列表工具统一出口：full=true 返回完整 toDict，否则瘦身。 */
+export declare function listPayload(items: any[], full: boolean, keep?: string[]): any[];
 export declare const TOOLS: DshTool[];
 export declare const CORE_IDS: string[];
 export declare const GROUPS: Record<string, {

package/dist/dsh.js

@@ -109,21 +109,51 @@ export function toLosslessJson(value) {
     }
     return value; // string / boolean / null / undefined
 }
+// ---- 列表返回瘦身 ----
+// 工具结果会进历史、之后每轮重发，所以列表默认只返回关键字段 + 更少条数；
+// full=true 时返回完整 toDict。HEAVY_KEYS 是各类模型里普遍偏长 / 噪音的字段。
+const HEAVY_KEYS = [
+    "cover", "cover_url", "description", "desc", "avatar", "avatar_url",
+    "face", "pic", "first_frame", "badge", "badge_url", "jump_url",
+];
+const VIDEO_KEEP = [
+    "bvid", "title", "author", "view", "danmaku", "duration", "pubdate", "link",
+];
+function slimDict(d, keep) {
+    if (keep) {
+        const out = {};
+        for (const k of keep)
+            if (k in d)
+                out[k] = d[k];
+        return out;
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(d))
+        if (!HEAVY_KEYS.includes(k))
+            out[k] = v;
+    return out;
+}
+/** 列表工具统一出口：full=true 返回完整 toDict，否则瘦身。 */
+export function listPayload(items, full, keep) {
+    const dicts = items.map((x) => (x && typeof x.toDict === "function" ? x.toDict() : x));
+    return full ? dicts : dicts.map((d) => slimDict(d, keep));
+}
 export const TOOLS = [
     {
         id: "bili_recommend",
-        description: "获取 B 站首页推荐视频流，返回视频列表（标题 / UP主 / 播放量 / 链接）。",
+        description: "获取 B 站首页推荐视频流，返回视频列表（标题 / UP主 / 播放量 / 链接）。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 pages: { type: "integer", description: "抓取页数", default: 1 },
                 pageSize: { type: "integer", description: "每页条数", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
         },
         handler: async (a) => {
             const c = await getClient();
             const videos = await c.video.recommend(Number(a.pages ?? 1), Number(a.pageSize ?? 10));
-            return videos.map((v) => v.toDict());
+            return listPayload(videos, Boolean(a.full ?? false), VIDEO_KEEP);
         },
     },
     {
@@ -162,7 +192,7 @@ export const TOOLS = [
     },
     {
         id: "bili_search",
-        description: "搜索 B 站视频或用户。",
+        description: "搜索 B 站视频或用户。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
@@ -174,19 +204,21 @@ export const TOOLS = [
                     default: "totalrank",
                     description: "排序（仅视频）",
                 },
-                pageSize: { type: "integer", default: 20 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             required: ["keyword"],
         },
         handler: async (a) => {
             const c = await getClient();
-            const ps = Number(a.pageSize ?? 20);
+            const full = Boolean(a.full ?? false);
+            const ps = Number(a.pageSize ?? 10);
             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()) };
+                return { total, users: listPayload(users, full) };
             }
             const [videos, total] = await c.search.videos(a.keyword, 1, ps, a.order ?? "totalrank");
-            return { total, videos: videos.map((v) => v.toDict()) };
+            return { total, videos: listPayload(videos, full, VIDEO_KEEP) };
         },
     },
     {
@@ -204,7 +236,7 @@ export const TOOLS = [
     },
     {
         id: "bili_space_videos",
-        description: "获取某 UP 主的投稿视频列表。",
+        description: "获取某 UP 主的投稿视频列表。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
@@ -214,14 +246,15 @@ export const TOOLS = [
                     enum: ["pubdate", "click", "stow"],
                     default: "pubdate",
                 },
-                pageSize: { type: "integer", default: 20 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             required: ["uid"],
         },
         handler: async (a) => {
             const c = await getClient();
-            const [videos, total] = await c.space.videos(Number(a.uid), 1, Number(a.pageSize ?? 20), a.order ?? "pubdate");
-            return { total, videos: videos.map((v) => v.toDict()) };
+            const [videos, total] = await c.space.videos(Number(a.uid), 1, Number(a.pageSize ?? 10), a.order ?? "pubdate");
+            return { total, videos: listPayload(videos, Boolean(a.full ?? false), VIDEO_KEEP) };
         },
     },
     // ---- 专栏 ----
@@ -237,70 +270,76 @@ export const TOOLS = [
     },
     {
         id: "bili_article_list",
-        description: "获取某 UP 主的专栏列表。",
+        description: "获取某 UP 主的专栏列表。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 mid: { type: "integer" },
-                pageSize: { type: "integer", default: 30 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             required: ["mid"],
         },
         handler: async (a) => {
             const c = await getClient();
-            const [articles, total] = await c.article.listByUser(Number(a.mid), 1, Number(a.pageSize ?? 30));
-            return { total, articles: articles.map((x) => x.toDict()) };
+            const [articles, total] = await c.article.listByUser(Number(a.mid), 1, Number(a.pageSize ?? 10));
+            return { total, articles: listPayload(articles, Boolean(a.full ?? false)) };
         },
     },
     // ---- 动态 ----
     {
         id: "bili_dynamic_feed",
-        description: "获取「关注」动态流（需登录），返回动态列表。",
+        description: "获取「关注」动态流（需登录），返回动态列表。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 page: { type: "integer", default: 1 },
                 type: { type: "string", default: "all" },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
         },
         handler: async (a) => {
             const c = await getClient();
             const [items, offset, hasMore] = await c.dynamic.feed(Number(a.page ?? 1), undefined, a.type ?? "all");
-            return { offset, hasMore, dynamics: items.map((x) => x.toDict()) };
+            return { offset, hasMore, dynamics: listPayload(items, Boolean(a.full ?? false)) };
         },
     },
     {
         id: "bili_dynamic_space",
-        description: "获取某用户的动态列表。",
+        description: "获取某用户的动态列表。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
-            properties: { uid: { type: "integer" } },
+            properties: {
+                uid: { type: "integer" },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
+            },
             required: ["uid"],
         },
         handler: async (a) => {
             const c = await getClient();
             const [items, offset, hasMore, total] = await c.dynamic.space(Number(a.uid));
-            return { total, offset, hasMore, dynamics: items.map((x) => x.toDict()) };
+            return { total, offset, hasMore, dynamics: listPayload(items, Boolean(a.full ?? false)) };
         },
     },
     // ---- 评论 ----
     {
         id: "bili_comment_list",
-        description: "获取评论列表（视频 / 动态 / 专栏），返回评论列表。",
+        description: "获取评论列表（视频 / 动态 / 专栏）。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 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 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             required: ["id"],
         },
         handler: async (a) => {
             const c = await getClient();
             const target = String(a.target ?? "video");
-            const ps = Number(a.pageSize ?? 20);
+            const ps = Number(a.pageSize ?? 10);
             const sort = a.sort ?? "time";
             let items;
             if (target === "dynamic")
@@ -309,28 +348,29 @@ export const TOOLS = [
                 [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()) };
+            return { comments: listPayload(items, Boolean(a.full ?? false)) };
         },
     },
     // ---- 关注关系 ----
     {
         id: "bili_relation_list",
-        description: "获取某用户的关注列表或粉丝列表。",
+        description: "获取某用户的关注列表或粉丝列表。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 uid: { type: "integer" },
                 type: { type: "string", enum: ["followings", "followers"], default: "followings" },
-                pageSize: { type: "integer", default: 20 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             required: ["uid"],
         },
         handler: async (a) => {
             const c = await getClient();
             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()) };
+                ? await c.relation.followers(Number(a.uid), 1, Number(a.pageSize ?? 10))
+                : await c.relation.followings(Number(a.uid), 1, Number(a.pageSize ?? 10));
+            return { total, users: listPayload(users, Boolean(a.full ?? false)) };
         },
     },
     // ---- 消息中心 ----
@@ -545,37 +585,43 @@ export const TOOLS = [
     },
     {
         id: "bili_space_collection",
-        description: "获取某个合集内的视频列表。",
+        description: "获取某个合集内的视频列表。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 seasonId: { type: "integer" },
                 mid: { type: "integer", description: "UP 主 uid（可选，用于正确 Referer）" },
-                pageSize: { type: "integer", default: 30 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             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()) };
+            const [col, videos, total] = await (await getClient()).space.collection(Number(a.seasonId), 1, Number(a.pageSize ?? 10), a.mid != null ? Number(a.mid) : undefined);
+            return {
+                collection: col.toDict(),
+                total,
+                videos: listPayload(videos, Boolean(a.full ?? false), VIDEO_KEEP),
+            };
         },
     },
     // ---- 收藏夹 ----
     {
         id: "bili_fav_folder_videos",
-        description: "获取某个收藏夹内的视频列表（需登录）。",
+        description: "获取某个收藏夹内的视频列表（需登录）。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 folderId: { type: "integer" },
                 order: { type: "string", enum: ["mtime", "view", "pubtime"], default: "mtime" },
-                pageSize: { type: "integer", default: 20 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             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()) };
+            const [videos, total] = await (await getClient()).interact.folderVideos(Number(a.folderId), 1, Number(a.pageSize ?? 10), a.order ?? "mtime");
+            return { total, videos: listPayload(videos, Boolean(a.full ?? false), VIDEO_KEEP) };
         },
     },
     {
@@ -708,14 +754,15 @@ export const TOOLS = [
     },
     {
         id: "bili_comment_replies",
-        description: "获取某条评论下的楼中楼回复列表。",
+        description: "获取某条评论下的楼中楼回复列表。默认精简字段，full=true 返回完整字段。",
         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 },
+                pageSize: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             required: ["id", "rootRpid"],
         },
@@ -723,7 +770,7 @@ export const TOOLS = [
             const c = await getClient();
             const target = String(a.target ?? "video");
             const root = Number(a.rootRpid);
-            const ps = Number(a.pageSize ?? 20);
+            const ps = Number(a.pageSize ?? 10);
             let items;
             if (target === "video")
                 [items] = await c.comment.repliesVideo(a.id, root, 1, ps);
@@ -733,7 +780,7 @@ export const TOOLS = [
                 [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()) };
+            return { replies: listPayload(items, Boolean(a.full ?? false)) };
         },
     },
     {
@@ -827,11 +874,12 @@ export const TOOLS = [
     // ---- 消息中心补充 ----
     {
         id: "bili_notify_list",
-        description: "消息中心列表：回复我的 / @我的 / 收到的赞（需登录）。",
+        description: "消息中心列表：回复我的 / @我的 / 收到的赞（需登录）。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 type: { type: "string", enum: ["replies", "ats", "likes"], default: "replies" },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
         },
         handler: async (a) => {
@@ -844,7 +892,7 @@ export const TOOLS = [
                 [items] = await c.notify.likes();
             else
                 [items] = await c.notify.replies();
-            return { notices: items.map((x) => x.toDict()) };
+            return { notices: listPayload(items, Boolean(a.full ?? false)) };
         },
     },
     // ---- 私信补充 ----
@@ -856,18 +904,19 @@ export const TOOLS = [
     },
     {
         id: "bili_message_history",
-        description: "获取与某用户的私信聊天记录（需登录）。",
+        description: "获取与某用户的私信聊天记录（需登录）。默认精简字段，full=true 返回完整字段。",
         parameters: {
             type: "object",
             properties: {
                 talkerUid: { type: "integer" },
-                size: { type: "integer", default: 20 },
+                size: { type: "integer", default: 10 },
+                full: { type: "boolean", default: false, description: "true 返回完整字段" },
             },
             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()) };
+            const msgs = await (await getClient()).message.history(Number(a.talkerUid), Number(a.size ?? 10));
+            return { messages: listPayload(msgs, Boolean(a.full ?? false)) };
         },
     },
     {

package/package.json

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