dsh-shlr-bilitoolkit 0.1.1 → 0.1.3

package/dist/apis/article.d.ts

@@ -1,6 +1,6 @@
 /** 专栏：详情、UP 主专栏列表。 */
-import type { BiliClient } from "../client";
-import { Article } from "../models";
+import type { BiliClient } from "../client.js";
+import { Article } from "../models.js";
 export declare function parseArticleId(value: unknown): number;
 export declare class ArticleAPI {
     private client;

package/dist/apis/article.js

@@ -1,8 +1,8 @@
 /** 专栏：详情、UP 主专栏列表。 */
-import * as endpoints from "../endpoints";
-import { BiliApiError } from "../errors";
-import { Article } from "../models";
-import { iterPages } from "../pagination";
+import * as endpoints from "../endpoints.js";
+import { BiliApiError } from "../errors.js";
+import { Article } from "../models.js";
+import { iterPages } from "../pagination.js";
 const _ARTICLE_ID = /cv(\d+)/i;
 const _NUMBER = /(\d+)/;
 export function parseArticleId(value) {

package/dist/apis/auth.d.ts

@@ -4,7 +4,7 @@
 generate / poll / wait / login 的核心流程；如需在终端展示二维码，可另行
 调用 qrcode 库对 generate 返回的 url 进行渲染。
 */
-import type { BiliClient } from "../client";
+import type { BiliClient } from "../client.js";
 export declare const QR_STATUS_SUCCESS = 0;
 export declare const QR_STATUS_EXPIRED = 86038;
 export declare const QR_STATUS_WAITING = 86101;

package/dist/apis/auth.js

@@ -4,9 +4,9 @@
 generate / poll / wait / login 的核心流程；如需在终端展示二维码，可另行
 调用 qrcode 库对 generate 返回的 url 进行渲染。
 */
-import * as endpoints from "../endpoints";
-import { BiliApiError } from "../errors";
-import { sleep } from "../util";
+import * as endpoints from "../endpoints.js";
+import { BiliApiError } from "../errors.js";
+import { sleep } from "../util.js";
 export const QR_STATUS_SUCCESS = 0;
 export const QR_STATUS_EXPIRED = 86038;
 export const QR_STATUS_WAITING = 86101;

package/dist/apis/comment.d.ts

@@ -5,8 +5,8 @@ B 站评论是「type + oid」的通用模型：
 - 动态：type 由动态的 comment_type 决定，oid 取 comment_id
 - 专栏：type=12，oid=cvid
 */
-import type { BiliClient } from "../client";
-import { Comment } from "../models";
+import type { BiliClient } from "../client.js";
+import { Comment } from "../models.js";
 export declare class CommentAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/comment.js

@@ -5,11 +5,11 @@ B 站评论是「type + oid」的通用模型：
 - 动态：type 由动态的 comment_type 决定，oid 取 comment_id
 - 专栏：type=12，oid=cvid
 */
-import * as endpoints from "../endpoints";
-import { BiliApiError } from "../errors";
-import { Comment } from "../models";
-import { iterPages } from "../pagination";
-import { parseArticleId } from "./article";
+import * as endpoints from "../endpoints.js";
+import { BiliApiError } from "../errors.js";
+import { Comment } from "../models.js";
+import { iterPages } from "../pagination.js";
+import { parseArticleId } from "./article.js";
 const SORT_BY_NAME = { time: 0, like: 1, reply: 2 };
 export class CommentAPI {
     client;

package/dist/apis/download.js

@@ -8,7 +8,7 @@ import { mkdir } from "node:fs/promises";
 import * as path from "node:path";
 import { spawn } from "node:child_process";
 import axios from "axios";
-import { BiliApiError } from "../errors";
+import { BiliApiError } from "../errors.js";
 const CHUNK_SIZE = 1 << 20;
 const UNSAFE_FILENAME = /[\\/:*?"<>|]/;
 export function safeFilename(text, fallback = "video") {

package/dist/apis/dynamic.d.ts

@@ -3,8 +3,8 @@
 读取走网页版 polymer 接口，需要登录态。写操作（publish / repost / thumb /
 delete）都是公开行为，受风控和人机验证限制，使用前请自行确认。
 */
-import type { BiliClient } from "../client";
-import { Dynamic } from "../models";
+import type { BiliClient } from "../client.js";
+import { Dynamic } from "../models.js";
 export declare class DynamicAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/dynamic.js

@@ -3,9 +3,9 @@
 读取走网页版 polymer 接口，需要登录态。写操作（publish / repost / thumb /
 delete）都是公开行为，受风控和人机验证限制，使用前请自行确认。
 */
-import * as endpoints from "../endpoints";
-import { BiliApiError } from "../errors";
-import { Dynamic } from "../models";
+import * as endpoints from "../endpoints.js";
+import { BiliApiError } from "../errors.js";
+import { Dynamic } from "../models.js";
 const FEATURES = "itemOpusStyle";
 const REFERER = "https://t.bilibili.com/";
 export class DynamicAPI {

package/dist/apis/interact.d.ts

@@ -1,6 +1,6 @@
 /** 互动接口：点赞、收藏、关注（真实写操作，需要登录并依赖 bili_jct）。 */
-import type { BiliClient } from "../client";
-import { Video } from "../models";
+import type { BiliClient } from "../client.js";
+import { Video } from "../models.js";
 export declare class InteractAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/interact.js

@@ -1,8 +1,8 @@
 /** 互动接口：点赞、收藏、关注（真实写操作，需要登录并依赖 bili_jct）。 */
-import * as endpoints from "../endpoints";
-import { BiliApiError, CookieError } from "../errors";
-import { Video } from "../models";
-import { iterPages } from "../pagination";
+import * as endpoints from "../endpoints.js";
+import { BiliApiError, CookieError } from "../errors.js";
+import { Video } from "../models.js";
+import { iterPages } from "../pagination.js";
 export class InteractAPI {
     client;
     constructor(client) {

package/dist/apis/message.d.ts

@@ -3,8 +3,8 @@
 web 端私信要求带一个 UUID 形式的 msg[dev_id]；同一 client 实例内复用，
 避免每次都被当成新设备。dev_id 生成本次会话内稳定即可（不落盘）。
 */
-import type { BiliClient } from "../client";
-import { PrivateMessage } from "../models";
+import type { BiliClient } from "../client.js";
+import { PrivateMessage } from "../models.js";
 export declare function generateDevId(): string;
 export declare class MessageAPI {
     private client;

package/dist/apis/message.js

@@ -4,9 +4,9 @@ web 端私信要求带一个 UUID 形式的 msg[dev_id]；同一 client 实例
 避免每次都被当成新设备。dev_id 生成本次会话内稳定即可（不落盘）。
 */
 import { randomInt } from "node:crypto";
-import * as endpoints from "../endpoints";
-import { BiliApiError, CookieError } from "../errors";
-import { PrivateMessage } from "../models";
+import * as endpoints from "../endpoints.js";
+import { BiliApiError, CookieError } from "../errors.js";
+import { PrivateMessage } from "../models.js";
 const DEV_ID_TEMPLATE = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx";
 const IM_HEADERS = {
     Referer: "https://message.bilibili.com/",

package/dist/apis/notify.d.ts

@@ -3,8 +3,8 @@
 注意：这类列表接口的分页游标（cursor.id）实测传回去仍返回同一页，
 所以这里只保证「最近一页」；更早的消息请到网页端查看。
 */
-import type { BiliClient } from "../client";
-import { Notice } from "../models";
+import type { BiliClient } from "../client.js";
+import { Notice } from "../models.js";
 export declare class NotifyAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/notify.js

@@ -3,8 +3,8 @@
 注意：这类列表接口的分页游标（cursor.id）实测传回去仍返回同一页，
 所以这里只保证「最近一页」；更早的消息请到网页端查看。
 */
-import * as endpoints from "../endpoints";
-import { Notice } from "../models";
+import * as endpoints from "../endpoints.js";
+import { Notice } from "../models.js";
 const COMMON_PARAMS = { platform: "web", build: 0, mobi_app: "web" };
 function cursorId(cursor) {
     if (cursor && typeof cursor === "object")

package/dist/apis/profile.d.ts

@@ -4,7 +4,7 @@
 - updateSign 用的是 x/member/web/sign/update，改完进入审核队列。
 - updateProfile 用的是 x/member/web/update，只支持昵称、性别、生日。
 */
-import type { BiliClient } from "../client";
+import type { BiliClient } from "../client.js";
 export declare class ProfileAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/profile.js

@@ -4,7 +4,7 @@
 - updateSign 用的是 x/member/web/sign/update，改完进入审核队列。
 - updateProfile 用的是 x/member/web/update，只支持昵称、性别、生日。
 */
-import * as endpoints from "../endpoints";
+import * as endpoints from "../endpoints.js";
 const SEX_VALUES = ["男", "女", "保密"];
 const MAX_SIGN_LENGTH = 70;
 export class ProfileAPI {

package/dist/apis/relation.d.ts

@@ -1,6 +1,6 @@
 /** 关注列表、粉丝列表与关系统计。 */
-import type { BiliClient } from "../client";
-import { RelationUser } from "../models";
+import type { BiliClient } from "../client.js";
+import { RelationUser } from "../models.js";
 export declare class RelationAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/relation.js

@@ -1,7 +1,7 @@
 /** 关注列表、粉丝列表与关系统计。 */
-import * as endpoints from "../endpoints";
-import { RelationUser } from "../models";
-import { iterPages } from "../pagination";
+import * as endpoints from "../endpoints.js";
+import { RelationUser } from "../models.js";
+import { iterPages } from "../pagination.js";
 export class RelationAPI {
     client;
     constructor(client) {

package/dist/apis/search.d.ts

@@ -3,8 +3,8 @@
 搜索走 WBI 签名接口，并带搜索页 Referer。B 站会对搜索做风控，
 这里把网页端常见的 dm_img_* 环境参数一并带上，降低被 -412 拦截的概率。
 */
-import type { BiliClient } from "../client";
-import { User, Video } from "../models";
+import type { BiliClient } from "../client.js";
+import { User, Video } from "../models.js";
 export declare const VIDEO_ORDERS: readonly ["totalrank", "click", "pubdate", "dm", "stow", "scores"];
 export declare class SearchAPI {
     private client;

package/dist/apis/search.js

@@ -3,9 +3,9 @@
 搜索走 WBI 签名接口，并带搜索页 Referer。B 站会对搜索做风控，
 这里把网页端常见的 dm_img_* 环境参数一并带上，降低被 -412 拦截的概率。
 */
-import * as endpoints from "../endpoints";
-import { User, Video } from "../models";
-import { iterPages } from "../pagination";
+import * as endpoints from "../endpoints.js";
+import { User, Video } from "../models.js";
+import { iterPages } from "../pagination.js";
 // 视频搜索支持的排序
 export const VIDEO_ORDERS = [
     "totalrank",

package/dist/apis/space.d.ts

@@ -2,8 +2,8 @@
 
 这些接口都要求 WBI 签名，统一走 client.getSigned()，并带上空间页 Referer。
 */
-import type { BiliClient } from "../client";
-import { Collection, Video } from "../models";
+import type { BiliClient } from "../client.js";
+import { Collection, Video } from "../models.js";
 export declare class SpaceAPI {
     private client;
     constructor(client: BiliClient);

package/dist/apis/space.js

@@ -2,9 +2,9 @@
 
 这些接口都要求 WBI 签名，统一走 client.getSigned()，并带上空间页 Referer。
 */
-import * as endpoints from "../endpoints";
-import { Collection, Video } from "../models";
-import { iterPages } from "../pagination";
+import * as endpoints from "../endpoints.js";
+import { Collection, Video } from "../models.js";
+import { iterPages } from "../pagination.js";
 export class SpaceAPI {
     client;
     constructor(client) {

package/dist/apis/video.d.ts

@@ -1,6 +1,6 @@
 /** 视频相关接口：首页推荐流、视频详情、分P、播放地址、字幕。 */
-import type { BiliClient } from "../client";
-import { Page, PlayInfo, Subtitle, Video } from "../models";
+import type { BiliClient } from "../client.js";
+import { Page, PlayInfo, Subtitle, Video } from "../models.js";
 export declare class VideoAPI {
     private client;
     private pageInterval;

package/dist/apis/video.js

@@ -1,8 +1,8 @@
 /** 视频相关接口：首页推荐流、视频详情、分P、播放地址、字幕。 */
-import { BiliApiError } from "../errors";
-import * as endpoints from "../endpoints";
-import { Page, PlayInfo, Subtitle, Video } from "../models";
-import { sleep } from "../util";
+import { BiliApiError } from "../errors.js";
+import * as endpoints from "../endpoints.js";
+import { Page, PlayInfo, Subtitle, Video } from "../models.js";
+import { sleep } from "../util.js";
 export class VideoAPI {
     client;
     pageInterval;

package/dist/client.d.ts

@@ -9,20 +9,20 @@
 - HTTP 412 与业务码 -412 视为风控信号，立即停止，不做重试
 */
 import { AxiosInstance } from "axios";
-import { VideoAPI } from "./apis/video";
-import { SearchAPI } from "./apis/search";
-import { SpaceAPI } from "./apis/space";
-import { CommentAPI } from "./apis/comment";
-import { MessageAPI } from "./apis/message";
-import { NotifyAPI } from "./apis/notify";
-import { InteractAPI } from "./apis/interact";
-import { RelationAPI } from "./apis/relation";
-import { DynamicAPI } from "./apis/dynamic";
-import { ArticleAPI } from "./apis/article";
-import { ProfileAPI } from "./apis/profile";
-import { QrCodeLogin } from "./apis/auth";
-import { WbiSigner } from "./wbi";
-import { JsonCache } from "./cache";
+import { VideoAPI } from "./apis/video.js";
+import { SearchAPI } from "./apis/search.js";
+import { SpaceAPI } from "./apis/space.js";
+import { CommentAPI } from "./apis/comment.js";
+import { MessageAPI } from "./apis/message.js";
+import { NotifyAPI } from "./apis/notify.js";
+import { InteractAPI } from "./apis/interact.js";
+import { RelationAPI } from "./apis/relation.js";
+import { DynamicAPI } from "./apis/dynamic.js";
+import { ArticleAPI } from "./apis/article.js";
+import { ProfileAPI } from "./apis/profile.js";
+import { QrCodeLogin } from "./apis/auth.js";
+import { WbiSigner } from "./wbi.js";
+import { JsonCache } from "./cache.js";
 export declare const USER_AGENT: string;
 export declare const DEFAULT_HEADERS: Record<string, string>;
 export interface BiliClientOptions {

package/dist/client.js

@@ -12,23 +12,23 @@ import axios from "axios";
 import { existsSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import * as path from "node:path";
-import * as endpoints from "./endpoints";
-import { BiliApiError, CaptchaRequired, CookieError } from "./errors";
-import { VideoAPI } from "./apis/video";
-import { SearchAPI } from "./apis/search";
-import { SpaceAPI } from "./apis/space";
-import { CommentAPI } from "./apis/comment";
-import { MessageAPI } from "./apis/message";
-import { NotifyAPI } from "./apis/notify";
-import { InteractAPI } from "./apis/interact";
-import { RelationAPI } from "./apis/relation";
-import { DynamicAPI } from "./apis/dynamic";
-import { ArticleAPI } from "./apis/article";
-import { ProfileAPI } from "./apis/profile";
-import { QrCodeLogin } from "./apis/auth";
-import { WbiSigner } from "./wbi";
-import { JsonCache } from "./cache";
-import { sleep } from "./util";
+import * as endpoints from "./endpoints.js";
+import { BiliApiError, CaptchaRequired, CookieError } from "./errors.js";
+import { VideoAPI } from "./apis/video.js";
+import { SearchAPI } from "./apis/search.js";
+import { SpaceAPI } from "./apis/space.js";
+import { CommentAPI } from "./apis/comment.js";
+import { MessageAPI } from "./apis/message.js";
+import { NotifyAPI } from "./apis/notify.js";
+import { InteractAPI } from "./apis/interact.js";
+import { RelationAPI } from "./apis/relation.js";
+import { DynamicAPI } from "./apis/dynamic.js";
+import { ArticleAPI } from "./apis/article.js";
+import { ProfileAPI } from "./apis/profile.js";
+import { QrCodeLogin } from "./apis/auth.js";
+import { WbiSigner } from "./wbi.js";
+import { JsonCache } from "./cache.js";
+import { sleep } from "./util.js";
 export const USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " +
     "(KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
 export const DEFAULT_HEADERS = {

package/dist/dsh.d.ts

@@ -9,8 +9,8 @@
 工具定义仍以 JSON-Schema 形式写在 `TOOLS` 里（便于阅读），`apply` 会转换成
 官方的 `defineTool({ name, description, parameters, output, execute })` 形式。
 */
-import { BiliClient } from "./client";
-import { Collection, Page, PlayInfo, Subtitle, User, Video } from "./models";
+import { BiliClient } from "./client.js";
+import { Collection, Page, PlayInfo, Subtitle, User, Video } from "./models.js";
 export declare const name = "bili-toolkit";
 export declare const inject: string[];
 export interface DshTool {
@@ -18,8 +18,11 @@ export interface DshTool {
     description: string;
     parameters: Record<string, unknown>;
     handler: (args: any) => Promise<unknown>;
+    render?: (args: any, value: any) => any[];
+    presentationMeta?: (args: any, value: any) => unknown;
+    presentResult?: (args: any, result: any) => any;
 }
 export declare const TOOLS: DshTool[];
 export declare function apply(ctx: any): void;
-export * from "./index";
+export * from "./index.js";
 export { BiliClient, Video, User, Page, PlayInfo, Subtitle, Collection };

package/dist/dsh.js

@@ -11,12 +11,18 @@
 */
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import QRCode from "qrcode";
-import { BiliClient } from "./client";
-import { Collection, Page, PlayInfo, Subtitle, User, Video } from "./models";
-// 插件入口必须导出的字段（Cordis 据此识别并注入 tools 服务）
+import { BiliClient } from "./client.js";
+import { Collection, Page, PlayInfo, Subtitle, User, Video } from "./models.js";
+import { QR_STATUS_EXPIRED, QR_STATUS_SCANNED, QR_STATUS_SUCCESS, } from "./apis/auth.js";
+// 插件入口必须导出的字段（Cordis 据此识别并注入相应服务）
 export const name = "bili-toolkit";
-export const inject = ["tools"];
+// tools：注册工具；attachments：把二维码等图片登记成可在 UI 渲染的持久附件
+export const inject = ["tools", "attachments"];
 let cached = null;
+// 附件服务（apply 时从 ctx 捕获）；缺失时二维码退化为文本
+let attachmentStore = null;
+// 最近一次生成、等待扫码确认的二维码 key（登录完成链路用）
+let pendingQrKey = null;
 async function getClient() {
     if (!cached) {
         cached = new BiliClient({
@@ -406,27 +412,127 @@ export const TOOLS = [
     // ---- 登录状态 ----
     {
         id: "bili_login_status",
-        description: "查询当前是否已登录 B 站（返回用户名）。未登录时先让用户执行 `npm run login` 扫码，或调用 bili_gen_qr。",
+        description: "查询当前是否已登录 B 站（返回用户名）。若此前调用过 bili_gen_qr，本工具会顺带轮询扫码状态：用户扫码并在手机确认后，这里返回登录成功并自动保存 Cookie。",
         parameters: { type: "object", properties: {} },
         handler: async () => {
             const c = await getClient();
             const account = await c.getAccount();
+            if (account) {
+                return { isLoggedIn: true, username: account.uname, mid: account.mid };
+            }
+            // 未登录：若有等待确认的扫码，轮询一次
+            if (pendingQrKey) {
+                const [code, message] = await c.auth.poll(pendingQrKey);
+                if (code === QR_STATUS_SUCCESS) {
+                    await c.saveCookies();
+                    pendingQrKey = null;
+                    const acc = await c.getAccount();
+                    return {
+                        isLoggedIn: true,
+                        justLoggedIn: true,
+                        username: acc?.uname ?? null,
+                        mid: acc?.mid ?? null,
+                    };
+                }
+                if (code === QR_STATUS_EXPIRED) {
+                    pendingQrKey = null;
+                    return {
+                        isLoggedIn: false,
+                        qrStatus: "expired",
+                        hint: "二维码已过期，请重新调用 bili_gen_qr 生成新的二维码。",
+                    };
+                }
+                return {
+                    isLoggedIn: false,
+                    qrStatus: code === QR_STATUS_SCANNED ? "scanned" : "waiting",
+                    hint: code === QR_STATUS_SCANNED
+                        ? "已扫码，请在手机上点击「确认登录」，然后再调用一次 bili_login_status。"
+                        : "请用「哔哩哔哩」App 扫描刚生成的二维码，确认后再调用 bili_login_status。",
+                    message,
+                };
+            }
             return {
-                isLoggedIn: !!account,
-                username: account?.uname ?? null,
-                mid: account?.mid ?? null,
+                isLoggedIn: false,
+                username: null,
+                mid: null,
+                hint: "未登录，请先调用 bili_gen_qr 生成登录二维码。",
             };
         },
     },
     {
         id: "bili_gen_qr",
-        description: "生成 B 站扫码登录二维码。返回二维码内容链接 url、轮询用的 qrcodeKey，以及可直接在终端 / 对话里展示的 ascii 二维码（用「哔哩哔哩」App 扫码确认后，再调用 bili_login_status 查看登录态）。",
+        description: "生成 B 站扫码登录二维码，并在对话中以「图片」形式展示（用「哔哩哔哩」App 扫码）。返回二维码内容链接 url 与轮询用的 qrcodeKey。用户扫码确认后，调用 bili_login_status 完成登录并保存 Cookie。",
         parameters: { type: "object", properties: {} },
         handler: async () => {
             const c = await getClient();
             const [url, key] = await c.auth.generate();
-            const ascii = await QRCode.toString(url, { type: "utf8" });
-            return { url, qrcodeKey: key, ascii };
+            pendingQrKey = key;
+            // 生成 PNG 二维码并登记为附件，供 UI 以图片渲染
+            let qrImage = null;
+            try {
+                const png = await QRCode.toBuffer(url, {
+                    type: "png",
+                    errorCorrectionLevel: "M",
+                    margin: 2,
+                    width: 320,
+                });
+                if (attachmentStore?.saveImage) {
+                    qrImage = await attachmentStore.saveImage({
+                        data: new Uint8Array(png),
+                        mediaType: "image/png",
+                        name: "bili-login-qr.png",
+                    });
+                }
+            }
+            catch {
+                qrImage = null; // 附件不可用时退化为下方 ascii
+            }
+            // ascii 仅作为附件不可用时的兜底
+            let ascii = null;
+            if (!qrImage) {
+                try {
+                    ascii = await QRCode.toString(url, { type: "utf8" });
+                }
+                catch {
+                    ascii = null;
+                }
+            }
+            return { url, qrcodeKey: key, qrImage, ascii };
+        },
+        // 面向模型的文本：不塞图片 / ascii，给指引即可
+        render: (_args, value) => [
+            {
+                type: "text",
+                text: "已生成 B 站登录二维码（已在界面上以图片展示）。请让用户用「哔哩哔哩」App 扫码，" +
+                    "并在手机上确认登录；用户确认后，调用 bili_login_status 查询登录态并保存 Cookie。" +
+                    `qrcodeKey=${value?.qrcodeKey ?? ""}`,
+            },
+        ],
+        // 把图片引用 / ascii / url 透传给 presentResult（仅 UI 用）
+        presentationMeta: (_args, value) => ({
+            qrImage: value?.qrImage ?? null,
+            ascii: value?.ascii ?? null,
+            url: value?.url ?? null,
+        }),
+        // UI 呈现：优先渲染图片二维码；无附件时退化为 ascii 代码块 + 链接
+        presentResult: (_args, result) => {
+            const meta = (result?.meta ?? {});
+            const content = [];
+            if (meta.qrImage) {
+                content.push({ type: "image", attachment: meta.qrImage });
+                content.push({
+                    type: "text",
+                    text: "请用「哔哩哔哩」App 扫描上方二维码，并在手机上确认登录。",
+                });
+            }
+            else if (meta.ascii) {
+                content.push({ type: "text", text: "```\n" + meta.ascii + "\n```" });
+                content.push({ type: "text", text: `二维码链接：${meta.url ?? ""}` });
+            }
+            else {
+                content.push({ type: "text", text: `二维码链接：${meta.url ?? ""}` });
+            }
+            return { card: "generic", title: "扫码登录 B 站", content };
         },
     },
     // ---- 缓存维护 ----
@@ -442,22 +548,31 @@ export const TOOLS = [
     },
 ];
 export function apply(ctx) {
+    // 捕获附件服务，供 bili_gen_qr 把二维码登记成可在 UI 渲染的图片
+    attachmentStore = ctx?.attachments ?? null;
     for (const tool of TOOLS) {
-        // 官方路径：ctx.tools.register(defineTool({...}))
-        const def = defineTool({
+        const output = {
+            schema: { type: "object", additionalProperties: true },
+            render: tool.render ??
+                ((_args, value) => [{ type: "text", text: textOf(value) }]),
+        };
+        if (tool.presentationMeta) {
+            output.presentationMeta = tool.presentationMeta;
+        }
+        const options = {
             name: tool.id,
             description: tool.description,
             parameters: toDshParameters(tool.parameters),
-            output: {
-                schema: { type: "object", additionalProperties: true },
-                render: (_args, value) => [
-                    { type: "text", text: textOf(value) },
-                ],
-            },
+            output,
             async execute(args) {
                 return await tool.handler(args);
             },
-        });
+        };
+        if (tool.presentResult) {
+            options.presentResult = tool.presentResult;
+        }
+        // 官方路径：ctx.tools.register(defineTool({...}))
+        const def = defineTool(options);
         if (ctx?.tools?.register) {
             ctx.tools.register(def);
         }
@@ -480,5 +595,5 @@ export function apply(ctx) {
 }
 // 同时导出库的全部公共 API（BiliClient / 各 API 类 / 模型等），
 // 让 `import "dsh-bili-toolkit"` 既可作为插件入口，也可当普通库使用。
-export * from "./index";
+export * from "./index.js";
 export { BiliClient, Video, User, Page, PlayInfo, Subtitle, Collection };

package/dist/index.d.ts

@@ -1,22 +1,22 @@
 /** dsh-bili-toolkit 对外导出入口。 */
-export { BiliClient, USER_AGENT, DEFAULT_HEADERS } from "./client";
-export type { BiliClientOptions } from "./client";
-export { BiliApiError, CaptchaRequired, CookieError, ERROR_HINTS, } from "./errors";
-export { WbiSigner, mixinKey } from "./wbi";
-export { VideoAPI } from "./apis/video";
-export { SearchAPI, VIDEO_ORDERS } from "./apis/search";
-export { SpaceAPI } from "./apis/space";
-export { CommentAPI } from "./apis/comment";
-export { MessageAPI, generateDevId } from "./apis/message";
-export { NotifyAPI } from "./apis/notify";
-export { InteractAPI } from "./apis/interact";
-export { RelationAPI } from "./apis/relation";
-export { DynamicAPI } from "./apis/dynamic";
-export { ArticleAPI, parseArticleId } from "./apis/article";
-export { ProfileAPI } from "./apis/profile";
-export { QrCodeLogin, QR_STATUS_SUCCESS, QR_STATUS_EXPIRED, QR_STATUS_WAITING, QR_STATUS_SCANNED } from "./apis/auth";
-export { safeFilename, downloadUrl, mergeWithFfmpeg } from "./apis/download";
-export { iterPages } from "./pagination";
-export * from "./models";
-export * from "./formatting";
-export * as endpoints from "./endpoints";
+export { BiliClient, USER_AGENT, DEFAULT_HEADERS } from "./client.js";
+export type { BiliClientOptions } from "./client.js";
+export { BiliApiError, CaptchaRequired, CookieError, ERROR_HINTS, } from "./errors.js";
+export { WbiSigner, mixinKey } from "./wbi.js";
+export { VideoAPI } from "./apis/video.js";
+export { SearchAPI, VIDEO_ORDERS } from "./apis/search.js";
+export { SpaceAPI } from "./apis/space.js";
+export { CommentAPI } from "./apis/comment.js";
+export { MessageAPI, generateDevId } from "./apis/message.js";
+export { NotifyAPI } from "./apis/notify.js";
+export { InteractAPI } from "./apis/interact.js";
+export { RelationAPI } from "./apis/relation.js";
+export { DynamicAPI } from "./apis/dynamic.js";
+export { ArticleAPI, parseArticleId } from "./apis/article.js";
+export { ProfileAPI } from "./apis/profile.js";
+export { QrCodeLogin, QR_STATUS_SUCCESS, QR_STATUS_EXPIRED, QR_STATUS_WAITING, QR_STATUS_SCANNED } from "./apis/auth.js";
+export { safeFilename, downloadUrl, mergeWithFfmpeg } from "./apis/download.js";
+export { iterPages } from "./pagination.js";
+export * from "./models.js";
+export * from "./formatting.js";
+export * as endpoints from "./endpoints.js";

package/dist/index.js

@@ -1,21 +1,21 @@
 /** dsh-bili-toolkit 对外导出入口。 */
-export { BiliClient, USER_AGENT, DEFAULT_HEADERS } from "./client";
-export { BiliApiError, CaptchaRequired, CookieError, ERROR_HINTS, } from "./errors";
-export { WbiSigner, mixinKey } from "./wbi";
-export { VideoAPI } from "./apis/video";
-export { SearchAPI, VIDEO_ORDERS } from "./apis/search";
-export { SpaceAPI } from "./apis/space";
-export { CommentAPI } from "./apis/comment";
-export { MessageAPI, generateDevId } from "./apis/message";
-export { NotifyAPI } from "./apis/notify";
-export { InteractAPI } from "./apis/interact";
-export { RelationAPI } from "./apis/relation";
-export { DynamicAPI } from "./apis/dynamic";
-export { ArticleAPI, parseArticleId } from "./apis/article";
-export { ProfileAPI } from "./apis/profile";
-export { QrCodeLogin, QR_STATUS_SUCCESS, QR_STATUS_EXPIRED, QR_STATUS_WAITING, QR_STATUS_SCANNED } from "./apis/auth";
-export { safeFilename, downloadUrl, mergeWithFfmpeg } from "./apis/download";
-export { iterPages } from "./pagination";
-export * from "./models";
-export * from "./formatting";
-export * as endpoints from "./endpoints";
+export { BiliClient, USER_AGENT, DEFAULT_HEADERS } from "./client.js";
+export { BiliApiError, CaptchaRequired, CookieError, ERROR_HINTS, } from "./errors.js";
+export { WbiSigner, mixinKey } from "./wbi.js";
+export { VideoAPI } from "./apis/video.js";
+export { SearchAPI, VIDEO_ORDERS } from "./apis/search.js";
+export { SpaceAPI } from "./apis/space.js";
+export { CommentAPI } from "./apis/comment.js";
+export { MessageAPI, generateDevId } from "./apis/message.js";
+export { NotifyAPI } from "./apis/notify.js";
+export { InteractAPI } from "./apis/interact.js";
+export { RelationAPI } from "./apis/relation.js";
+export { DynamicAPI } from "./apis/dynamic.js";
+export { ArticleAPI, parseArticleId } from "./apis/article.js";
+export { ProfileAPI } from "./apis/profile.js";
+export { QrCodeLogin, QR_STATUS_SUCCESS, QR_STATUS_EXPIRED, QR_STATUS_WAITING, QR_STATUS_SCANNED } from "./apis/auth.js";
+export { safeFilename, downloadUrl, mergeWithFfmpeg } from "./apis/download.js";
+export { iterPages } from "./pagination.js";
+export * from "./models.js";
+export * from "./formatting.js";
+export * as endpoints from "./endpoints.js";

package/dist/models.js

@@ -1,5 +1,5 @@
 /** 纯数据模型。接口返回的裸 JSON 在这里一次性转成对象，业务代码不碰 dict。 */
-import { formatDuration, htmlToText, parseDuration, stripHtml } from "./formatting";
+import { formatDuration, htmlToText, parseDuration, stripHtml } from "./formatting.js";
 export class Video {
     bvid;
     aid;

package/dist/wbi.d.ts

@@ -4,7 +4,7 @@ B 站从 2023 年起对空间、搜索、视频详情等接口启用 Wbi 鉴权
 在若干次之后会返回 -403「非法访问」。签名需要 nav 接口里的 img_key/sub_key，
 这两个 key 每天都会变，所以这里做了缓存，并在签名失效时刷新重试。
 */
-import type { BiliClient } from "./client";
+import type { BiliClient } from "./client.js";
 export declare function mixinKey(imgKey: string, subKey: string): string;
 export declare class WbiSigner {
     private client;

package/dist/wbi.js

@@ -5,8 +5,8 @@ B 站从 2023 年起对空间、搜索、视频详情等接口启用 Wbi 鉴权
 这两个 key 每天都会变，所以这里做了缓存，并在签名失效时刷新重试。
 */
 import { createHash } from "node:crypto";
-import { BiliApiError } from "./errors";
-import * as endpoints from "./endpoints";
+import { BiliApiError } from "./errors.js";
+import * as endpoints from "./endpoints.js";
 // 官方实现里的 64 位字符重排表
 const MIXIN_KEY_ENC_TAB = [
     46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35, 27, 43, 5, 49,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-shlr-bilitoolkit",
-  "version": "0.1.1",
-  "description": "B 站（哔哩哔哩）接口工具箱 dsh 插件：视频 / 搜索 / 空间 / 专栏 / 动态 / 评论 / 关注 / 消息中心读取，以及点赞、收藏、投币、关注、评论、私信等写操作。",
+  "version": "0.1.3",
+  "description": "深海猎人专用B站接口工具箱 dsh 插件。",
   "type": "module",
   "main": "dist/dsh.js",
   "types": "dist/dsh.d.ts",