dsh-shlr-bilitoolkit 0.1.17 → 0.1.19

package/AGENTS.md

@@ -1,11 +1,10 @@
-（Agent 必读）
+# AGENTS.md — dsh-shlr-bilitoolkit（Agent 必读）
 
 ## 登录（务必遵守）
-用户要登录 B 站，或任何操作返回未登录（`-101` / `未登录` / `CookieError`）时：
-**必须调用 `bili_gen_qr`，并把返回的二维码图片展示给用户扫码**——用 `qrDataUrl` 以 Markdown 图片 `![qr](<qrDataUrl>)` 渲染（或引用 `qrImageUrl` / `qrImagePath`）。
-
-禁止：只给链接、用 ASCII/文本二维码、让用户自己跑命令。用户扫码确认后调用 `bili_login_status` 完成登录并保存 Cookie。
+用户要登录 B 站，或任何操作返回未登录（-101 / 未登录 / CookieError）时：
+**必须调用 bili_gen_qr，并把返回的二维码图片展示给用户扫码**——用 qrDataUrl 以 Markdown 图片 `![qr](<qrDataUrl>)` 渲染（或引用 qrImageUrl / qrImagePath）。
+禁止只给链接、用 ASCII、让用户自己跑命令。用户确认后调 bili_login_status 完成登录。
 
 ## 其它
-- 除常驻工具外，其它 B 站能力默认懒加载：先 `bili_catalog` 看分组，再 `bili_open(group)` 打开（下一轮生效），用完可 `bili_close` 释放。
+- 非常驻的 B 站能力懒加载：`bili_open()` 看分组，`bili_open({ group })` 打开（下一轮生效）。
 - 写操作会真实修改账号状态，执行前先与用户确认。

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)) };
         },
     },
     {
@@ -1074,7 +1123,6 @@ const MAX_OPEN_GROUPS = 3;
 export const CORE_IDS = [
     "bili_gen_qr",
     "bili_login_status",
-    "bili_cache_clear",
     "bili_recommend",
     "bili_video_detail",
     "bili_search",
@@ -1097,6 +1145,7 @@ export const GROUPS = {
     message: { hint: "私信：发送 / 未读 / 聊天记录 / 撤回", ids: ["bili_send_message", "bili_message_unread", "bili_message_history", "bili_message_recall"] },
     notify: { hint: "消息中心：未读 / 回复·@·赞 列表", ids: ["bili_notify_unread", "bili_notify_list"] },
     profile: { hint: "个人资料：查看 / 修改", ids: ["bili_profile_info", "bili_profile_update"] },
+    misc: { hint: "维护：清空本地缓存", ids: ["bili_cache_clear"] },
 };
 const TOOL_BY_ID = new Map(TOOLS.map((t) => [t.id, t]));
 function groupOfTool(id) {
@@ -1143,31 +1192,29 @@ function buildDef(tool) {
     return defineTool(options);
 }
 const lazyTools = [
-    {
-        id: "bili_catalog",
-        description: "列出 B 站能力分组与每组包含的工具。要用某个 B 站能力但不确定工具名时，先调本工具，再调 bili_open 打开对应分组（打开后下一轮起该组工具可调用）。",
-        parameters: { type: "object", properties: {} },
-        handler: async () => ({
-            groups: Object.entries(GROUPS).map(([name, g]) => ({
-                group: name,
-                hint: g.hint,
-                tools: g.ids,
-                open: openGroups.has(name),
-            })),
-            how: "bili_open({ group }) 或 bili_open({ tool }) 打开；bili_close({ group }) 关闭以节省上下文。",
-        }),
-    },
     {
         id: "bili_open",
-        description: "打开一组 B 站工具（group），或直接给工具名（tool）自动打开其所在组。打开后该组工具在下一轮即可调用。同时最多保留 3 组，超出会关闭最久未用的组。",
+        description: "B 站能力开关。不带参数调用=列出所有能力分组；带 group（分组名）或 tool（工具名）调用=打开该组，打开后下一轮起可调用。同时最多保留 3 组，超出自动关闭最久未用的。",
         parameters: {
             type: "object",
             properties: {
-                group: { type: "string", description: "分组名（见 bili_catalog）" },
+                group: { type: "string", description: "分组名（不带参调用可列出）" },
                 tool: { type: "string", description: "或直接给工具名，自动打开其所在组" },
             },
         },
         handler: async (a) => {
+            // 不带参数：列出能力目录
+            if (a.group == null && a.tool == null) {
+                return {
+                    groups: Object.entries(GROUPS).map(([name, g]) => ({
+                        group: name,
+                        hint: g.hint,
+                        tools: g.ids,
+                        open: openGroups.has(name),
+                    })),
+                    how: "带 group 或 tool 再次调用本工具即可打开；同时最多保留 3 组。",
+                };
+            }
             if (!toolsRegistry) {
                 return { ok: false, message: "当前运行时不支持动态注册，懒加载不可用" };
             }
@@ -1212,22 +1259,6 @@ const lazyTools = [
             return { ok: true, group, tools: loaded, note: "该组工具已打开，下一轮起可调用。" };
         },
     },
-    {
-        id: "bili_close",
-        description: "关闭一组已打开的 B 站工具，释放上下文。不确定分组名先用 bili_catalog。",
-        parameters: {
-            type: "object",
-            properties: { group: { type: "string" } },
-            required: ["group"],
-        },
-        handler: async (a) => {
-            const group = String(a.group ?? "").trim();
-            if (!openGroups.has(group))
-                return { ok: false, message: "该组未打开" };
-            closeGroup(group);
-            return { ok: true, closed: group };
-        },
-    },
 ];
 /** 用最可用的注册入口注册一个内部工具。 */
 function registerOne(ctx, tool) {

package/package.json

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