@zhin.js/plugin-bilibili 0.0.0-stage → 0.1.1

package/lib/wbi.js

@@ -0,0 +1,50 @@
+/**
+ * WBI request signing used by Bilibili web APIs (e.g. the space dynamic feed).
+ *
+ * The permutation below is the published WBI mixin-key order: the browser
+ * concatenates the file names of `wbi_img.img_url` and `wbi_img.sub_url`
+ * from `/x/web-interface/nav`, reorders the 64 characters with this table and
+ * keeps the first 32 as the salt for an MD5 over the sorted query string.
+ */
+import { createHash } from 'node:crypto';
+const MIXIN_KEY_ORDER = [
+    46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35,
+    27, 43, 5, 49, 33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13,
+    37, 48, 7, 16, 24, 55, 40, 61, 26, 17, 0, 1, 60, 51, 30, 4,
+    22, 25, 54, 21, 56, 59, 6, 63, 57, 62, 11, 36, 20, 34, 44, 52,
+];
+/** `https://i0.hdslb.com/bfs/wbi/7cd0...077c.png` → `7cd0...077c`. */
+export function wbiKeyFromUrl(url) {
+    const file = url.slice(url.lastIndexOf('/') + 1);
+    const dot = file.indexOf('.');
+    return dot === -1 ? file : file.slice(0, dot);
+}
+export function mixinKey(imgKey, subKey) {
+    const raw = imgKey + subKey;
+    if (raw.length < 64)
+        throw new Error('WBI 密钥格式异常');
+    let key = '';
+    for (const index of MIXIN_KEY_ORDER)
+        key += raw[index] ?? '';
+    return key.slice(0, 32);
+}
+function stripReserved(value) {
+    let out = '';
+    for (const char of value)
+        if (!"!'()*".includes(char))
+            out += char;
+    return out;
+}
+/** Returns the signed query string (`a=1&wts=...&w_rid=...`). */
+export function signWbi(params, key, nowSeconds = Math.floor(Date.now() / 1000)) {
+    const all = { wts: String(nowSeconds) };
+    for (const [name, value] of Object.entries(params))
+        all[name] = stripReserved(String(value));
+    const query = Object.keys(all)
+        .sort()
+        .map((name) => `${encodeURIComponent(name)}=${encodeURIComponent(all[name])}`)
+        .join('&');
+    const wRid = createHash('md5').update(query + key).digest('hex');
+    return `${query}&w_rid=${wRid}`;
+}
+//# sourceMappingURL=wbi.js.map

package/lib/wbi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wbi.js","sourceRoot":"","sources":["../src/wbi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WBI request signing used by Bilibili web APIs (e.g. the space dynamic feed).\n *\n * The permutation below is the published WBI mixin-key order: the browser\n * concatenates the file names of `wbi_img.img_url` and `wbi_img.sub_url`\n * from `/x/web-interface/nav`, reorders the 64 characters with this table and\n * keeps the first 32 as the salt for an MD5 over the sorted query string.\n */\nimport { createHash } from 'node:crypto';\n\nconst MIXIN_KEY_ORDER: readonly number[] = [\n  46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35,\n  27, 43, 5, 49, 33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13,\n  37, 48, 7, 16, 24, 55, 40, 61, 26, 17, 0, 1, 60, 51, 30, 4,\n  22, 25, 54, 21, 56, 59, 6, 63, 57, 62, 11, 36, 20, 34, 44, 52,\n];\n\n/** `https://i0.hdslb.com/bfs/wbi/7cd0...077c.png` → `7cd0...077c`. */\nexport function wbiKeyFromUrl(url: string): string {\n  const file = url.slice(url.lastIndexOf('/') + 1);\n  const dot = file.indexOf('.');\n  return dot === -1 ? file : file.slice(0, dot);\n}\n\nexport function mixinKey(imgKey: string, subKey: string): string {\n  const raw = imgKey + subKey;\n  if (raw.length < 64) throw new Error('WBI 密钥格式异常');\n  let key = '';\n  for (const index of MIXIN_KEY_ORDER) key += raw[index] ?? '';\n  return key.slice(0, 32);\n}\n\nfunction stripReserved(value: string): string {\n  let out = '';\n  for (const char of value) if (!\"!'()*\".includes(char)) out += char;\n  return out;\n}\n\n/** Returns the signed query string (`a=1&wts=...&w_rid=...`). */\nexport function signWbi(\n  params: Readonly<Record<string, string | number>>,\n  key: string,\n  nowSeconds: number = Math.floor(Date.now() / 1000),\n): string {\n  const all: Record<string, string> = { wts: String(nowSeconds) };\n  for (const [name, value] of Object.entries(params)) all[name] = stripReserved(String(value));\n  const query = Object.keys(all)\n    .sort()\n    .map((name) => `${encodeURIComponent(name)}=${encodeURIComponent(all[name]!)}`)\n    .join('&');\n  const wRid = createHash('md5').update(query + key).digest('hex');\n  return `${query}&w_rid=${wRid}`;\n}\n"]}

package/package.json

@@ -1,6 +1,107 @@
 {
   "name": "@zhin.js/plugin-bilibili",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Bilibili live-start and UP dynamic subscriptions for Zhin.js (Plugin Runtime)",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "plugin.js",
+    "schema.json",
+    "commands",
+    "!commands/**/*.ts",
+    "skills",
+    "!skills/**/*.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "bot",
+    "plugin",
+    "bilibili",
+    "live",
+    "dynamic",
+    "subscription",
+    "push"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@zhin.js/skill": "1.1.8",
+    "@zhin.js/tool": "1.1.8"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "@zhin.js/command": "1.1.9",
+    "zhin.js": "1.1.13"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0",
+    "@zhin.js/command": "^1.1.9",
+    "zhin.js": "^1.1.13"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/utils/bilibili"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc -p tsconfig.check.json",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/bilibili/tests"
+  }
 }

package/plugin.js

@@ -0,0 +1,65 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin, databaseHostToken, outboundHostToken, scheduleHostToken, } from 'zhin.js';
+import { BiliClient } from "./lib/api.js";
+import { resolveBilibiliConfig } from "./lib/config.js";
+import { BilibiliWatcher } from "./lib/poll.js";
+import { bilibiliRuntimeToken } from "./lib/runtime.js";
+import { createInMemoryBiliDb, defineBiliTables } from "./lib/store.js";
+/**
+ * Plugin Runtime:
+ * - Commands: `bili sub|unsub|list|live`.
+ * - DB: `databaseHostToken` when configured, otherwise in-memory.
+ * - Outbound: `outboundHostToken` pushes live starts / new dynamics.
+ * - Schedule: `scheduleHostToken` drives the conservative watcher.
+ */
+export default definePlugin({
+    name: 'bilibili',
+    metadata: {
+        displayName: '哔哩哔哩订阅',
+    },
+    setup(context) {
+        const config = Object.freeze(resolveBilibiliConfig(context.config.get()));
+        const database = context.resources.has(databaseHostToken) ? context.resources.use(databaseHostToken) : undefined;
+        let db;
+        if (database) {
+            defineBiliTables(database);
+            db = database;
+        }
+        else {
+            db = createInMemoryBiliDb();
+        }
+        const outbound = context.resources.has(outboundHostToken) ? context.resources.use(outboundHostToken) : undefined;
+        const push = outbound
+            ? async (input) => {
+                await outbound.send({
+                    adapter: input.adapterName,
+                    endpointKey: input.endpointKey,
+                    conversation: { kind: input.channelType, id: input.channelId },
+                    content: input.content,
+                });
+            }
+            : null;
+        const client = new BiliClient({ timeout: config.timeout, cookie: config.cookie });
+        const watcher = new BilibiliWatcher({ db, config, client, outbound: push, signal: context.signal });
+        context.resources.provide(bilibiliRuntimeToken, Object.freeze({
+            db,
+            config,
+            client,
+            outbound: push,
+            watcher,
+            persistent: database !== undefined,
+        }));
+        if (!context.resources.has(scheduleHostToken) || (!config.live && !config.dynamic))
+            return;
+        const dispose = context.resources.use(scheduleHostToken).register({
+            id: 'bilibili/watch',
+            cron: config.pollCron,
+            description: 'Poll Bilibili live status and UP dynamics',
+            async execute() {
+                // The watcher records and backs off on its own; never fail the job.
+                await watcher.tick();
+            },
+        });
+        context.lifecycle.add(dispose);
+    },
+});

package/schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "pollCron": {
+      "type": "string",
+      "default": "0 * * * * *",
+      "description": "轮询频率（6 段 Cron，默认每 60 秒） / Poll schedule (6-field cron, default every 60s)"
+    },
+    "jitterMs": {
+      "type": "number",
+      "default": 15000,
+      "minimum": 0,
+      "maximum": 120000,
+      "description": "每轮轮询前的随机延迟上限（毫秒） / Max random delay before each poll (ms)"
+    },
+    "requestGapMs": {
+      "type": "number",
+      "default": 1500,
+      "minimum": 0,
+      "maximum": 30000,
+      "description": "同一轮内相邻动态请求的间隔（毫秒） / Gap between dynamic requests within one poll (ms)"
+    },
+    "maxBackoffMinutes": {
+      "type": "number",
+      "default": 30,
+      "minimum": 1,
+      "maximum": 720,
+      "description": "接口失败或风控时指数退避的上限（分钟） / Upper bound of exponential backoff (minutes)"
+    },
+    "maxPerChannel": {
+      "type": "number",
+      "default": 20,
+      "minimum": 1,
+      "maximum": 200,
+      "description": "每个会话最多订阅的 UP 主数量 / Max UP subscriptions per conversation"
+    },
+    "timeout": {
+      "type": "number",
+      "default": 10000,
+      "minimum": 1000,
+      "maximum": 60000,
+      "description": "单次 HTTP 请求超时（毫秒） / HTTP timeout (ms)"
+    },
+    "live": {
+      "type": "boolean",
+      "default": true,
+      "description": "是否轮询开播状态 / Poll live status"
+    },
+    "dynamic": {
+      "type": "boolean",
+      "default": true,
+      "description": "是否轮询 UP 主动态 / Poll UP dynamics"
+    },
+    "cookie": {
+      "type": "string",
+      "default": "",
+      "description": "可选的 B 站 Cookie（如 SESSDATA=...），风控严格时使用，请写成 ${BILIBILI_COOKIE} / Optional cookie, reference it as ${BILIBILI_COOKIE}"
+    }
+  }
+}

package/skills/bilibili/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: bilibili
+description: >-
+  B 站（哔哩哔哩）直播与 UP 主订阅查询能力。当用户想知道某个直播间是否在播、
+  某个 UP 主有没有开播，或想看看当前订阅了哪些 UP 主时使用。
+  订阅的增删由聊天命令 bili sub / bili unsub 管理，推送由后台定时任务完成。
+keywords:
+  - bilibili
+  - b站
+  - 哔哩哔哩
+  - 直播
+  - 开播
+  - up主
+  - 动态
+  - 订阅
+tags:
+  - bilibili
+  - live
+  - subscription
+tools:
+  - bili_live_status
+  - bili_list_subscriptions
+---
+
+# B 站订阅技能
+
+## 工具
+
+| 工具 | 用途 | 说明 |
+|------|------|------|
+| `bili_live_status` | 查询开播状态 | 传直播间号（`room`）或 UP 主 UID（`uid`），返回是否在播、标题、链接 |
+| `bili_list_subscriptions` | 查看订阅 | 列出本插件实例的全部 UP 主订阅，按会话分组 |
+
+**Example:**
+```
+用户: 嘉然现在在播吗？直播间 22637261
+→ bili_live_status(room="22637261")
+
+用户: 我们订阅了哪些 UP 主？
+→ bili_list_subscriptions()
+```
+
+## 注意
+
+- 订阅的增加 / 删除走聊天命令 `bili sub <uid> [all|live|dynamic]`、`bili unsub <uid>`，不是 AI 工具。
+- 推送有随机延迟和退避，B 站风控时会暂停一段时间，属于正常现象。

package/skills/bilibili/tools/bili_list_subscriptions/index.js

@@ -0,0 +1,34 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { bilibiliRuntimeToken } from "../../../../lib/runtime.js";
+import { getBiliSubs } from "../../../../lib/store.js";
+export default defineAgentTool({
+    description: '列出所有 B 站 UP 主订阅（按会话分组）',
+    requiresApproval: 'never',
+    tags: ['bilibili'],
+    keywords: ['b站订阅', 'up主', 'bilibili subscriptions'],
+    inputSchema: z.object({}),
+    async execute(_input, context) {
+        const Subs = getBiliSubs(context.use(bilibiliRuntimeToken).db);
+        if (!Subs)
+            return 'B 站订阅数据库尚未就绪';
+        const rows = await Subs.select();
+        if (rows.length === 0)
+            return '暂无任何 B 站订阅';
+        const grouped = new Map();
+        for (const row of rows) {
+            const key = `${String(row.channel_type)}:${String(row.channel_id)}`;
+            const list = grouped.get(key) ?? [];
+            list.push(`${String(row.uname || row.uid)}（UID ${String(row.uid)}，${String(row.kinds || 'all')}）`);
+            grouped.set(key, list);
+        }
+        const lines = [];
+        for (const [channel, subs] of grouped) {
+            lines.push(`[${channel}]`);
+            for (const sub of subs)
+                lines.push(`  - ${sub}`);
+        }
+        return `B 站订阅总览 (${rows.length} 条)：\n${lines.join('\n')}`;
+    },
+});

package/skills/bilibili/tools/bili_live_status/index.js

@@ -0,0 +1,39 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { parseRoomId, parseUid } from "../../../../lib/api.js";
+import { formatRoom, liveStatusText } from "../../../../lib/format.js";
+import { bilibiliRuntimeToken } from "../../../../lib/runtime.js";
+export default defineAgentTool({
+    description: '查询 B 站直播间或 UP 主当前是否在直播',
+    requiresApproval: 'never',
+    tags: ['bilibili'],
+    keywords: ['b站', '直播', '开播', 'bilibili live'],
+    inputSchema: z.object({
+        room: z.string().optional().describe('直播间号或直播间链接'),
+        uid: z.string().optional().describe('UP 主 UID 或空间链接'),
+    }),
+    async execute({ room, uid }, context) {
+        const { client } = context.use(bilibiliRuntimeToken);
+        try {
+            const roomId = room ? parseRoomId(room) : undefined;
+            if (roomId) {
+                const info = await client.getRoomInfo(roomId);
+                const live = info.uid ? (await client.getLiveStatus([info.uid])).get(info.uid) : undefined;
+                return formatRoom(info, live?.uname ?? '', live?.liveTime ?? 0);
+            }
+            const upUid = uid ? parseUid(uid) : undefined;
+            if (!upUid)
+                return '请提供直播间号（room）或 UP 主 UID（uid）';
+            const live = (await client.getLiveStatus([upUid])).get(upUid);
+            if (!live)
+                return `UID ${upUid} 没有开通直播间`;
+            return [`${live.uname || upUid}：${liveStatusText(live.liveStatus)}`, live.title && `标题：${live.title}`, live.url]
+                .filter(Boolean)
+                .join('\n');
+        }
+        catch (error) {
+            return `查询失败：${error.message}`;
+        }
+    },
+});