dsh-shlr-bilitoolkit 0.1.17 → 0.1.18

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.js

@@ -1074,7 +1074,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 +1096,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 +1143,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 +1210,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.18",
   "description": "深海猎人专用B站接口工具箱 dsh 插件。",
   "type": "module",
   "main": "dist/dsh.js",