dsh-shlr-bilitoolkit 0.1.4 → 0.1.6

package/dist/dsh.d.ts

@@ -22,6 +22,13 @@ export interface DshTool {
     presentationMeta?: (args: any, value: any) => unknown;
     presentResult?: (args: any, result: any) => any;
 }
+/** 把任意返回值规整成「可无损序列化」的 JSON。
+ *
+ * dsh 要求工具的规范值必须能无损 JSON 序列化：对象里不能带 `undefined`
+ * （`JSON.stringify` 会静默丢键，导致 round-trip 丢失），也不能有 NaN/Infinity。
+ * 这里统一处理：丢 undefined、NaN/Infinity 转 null、bigint 转字符串。
+ */
+export declare function toLosslessJson(value: unknown): unknown;
 export declare const TOOLS: DshTool[];
 export declare function apply(ctx: any): void;
 export * from "./index.js";

package/dist/dsh.js

@@ -11,16 +11,16 @@
 */
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import QRCode from "qrcode";
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 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";
-// tools：注册工具；attachments：把二维码等图片登记成可在 UI 渲染的持久附件
-export const inject = ["tools", "attachments"];
+export const inject = ["tools"];
 let cached = null;
-// 附件服务（apply 时从 ctx 捕获）；缺失时二维码退化为文本
-let attachmentStore = null;
 // 最近一次生成、等待扫码确认的二维码 key（登录完成链路用）
 let pendingQrKey = null;
 async function getClient() {
@@ -64,6 +64,34 @@ function toDshParameters(schema) {
 function textOf(value) {
     return typeof value === "string" ? value : JSON.stringify(value, null, 2);
 }
+/** 把任意返回值规整成「可无损序列化」的 JSON。
+ *
+ * dsh 要求工具的规范值必须能无损 JSON 序列化：对象里不能带 `undefined`
+ * （`JSON.stringify` 会静默丢键，导致 round-trip 丢失），也不能有 NaN/Infinity。
+ * 这里统一处理：丢 undefined、NaN/Infinity 转 null、bigint 转字符串。
+ */
+export function toLosslessJson(value) {
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === "bigint")
+        return value.toString();
+    if (Array.isArray(value)) {
+        return value.map((v) => {
+            const sv = toLosslessJson(v);
+            return sv === undefined ? null : sv;
+        });
+    }
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            const sv = toLosslessJson(v);
+            if (sv !== undefined)
+                out[k] = sv;
+        }
+        return out;
+    }
+    return value; // string / boolean / null / undefined
+}
 export const TOOLS = [
     {
         id: "bili_recommend",
@@ -468,14 +496,15 @@ export const TOOLS = [
     },
     {
         id: "bili_gen_qr",
-        description: "生成 B 站扫码登录二维码，并在对话中以「图片」形式展示（用「哔哩哔哩」App 扫码）。返回二维码内容链接 url 与轮询用的 qrcodeKey。用户扫码确认后，调用 bili_login_status 完成登录并保存 Cookie。",
+        description: "生成 B 站扫码登录二维码图片。返回二维码内容链接 url、轮询用的 qrcodeKey，以及可供 dsh 自行获取/渲染的二维码图片：qrDataUrl（base64 data URL）、qrImageUrl（file:// 链接）、qrImagePath（本地 PNG 绝对路径）。用户扫码确认后，调用 bili_login_status 完成登录并保存 Cookie。",
         parameters: { type: "object", properties: {} },
         handler: async () => {
             const c = await getClient();
             const [url, key] = await c.auth.generate();
             pendingQrKey = key;
-            // 生成 PNG 二维码并登记为附件，供 UI 以图片渲染
-            let qrImage = null;
+            // 渲染成 PNG，并给出多种「dsh 可自行获取图片」的形式
+            let qrImagePath = null;
+            let qrDataUrl = null;
             try {
                 const png = await QRCode.toBuffer(url, {
                     type: "png",
@@ -483,62 +512,58 @@ export const TOOLS = [
                     margin: 2,
                     width: 320,
                 });
-                if (attachmentStore?.saveImage) {
-                    qrImage = await attachmentStore.saveImage({
-                        data: new Uint8Array(png),
-                        mediaType: "image/png",
-                        name: "bili-login-qr.png",
-                    });
-                }
+                qrDataUrl = `data:image/png;base64,${png.toString("base64")}`;
+                qrImagePath = resolve(process.cwd(), "bili_qrcode.png");
+                writeFileSync(qrImagePath, png);
             }
             catch {
-                qrImage = null; // 附件不可用时退化为下方 ascii
-            }
-            // ascii 仅作为附件不可用时的兜底
-            let ascii = null;
-            if (!qrImage) {
-                try {
-                    ascii = await QRCode.toString(url, { type: "utf8" });
-                }
-                catch {
-                    ascii = null;
-                }
+                qrImagePath = null;
+                qrDataUrl = null;
             }
-            return { url, qrcodeKey: key, qrImage, ascii };
+            return {
+                url,
+                qrcodeKey: key,
+                qrImagePath,
+                qrImageUrl: qrImagePath ? pathToFileURL(qrImagePath).href : null,
+                qrDataUrl,
+            };
         },
-        // 面向模型的文本：不塞图片 / ascii，给指引即可
-        render: (_args, value) => [
-            {
-                type: "text",
-                text: "已生成 B 站登录二维码（已在界面上以图片展示）。请让用户用「哔哩哔哩」App 扫码，" +
-                    "并在手机上确认登录；用户确认后，调用 bili_login_status 查询登录态并保存 Cookie。" +
-                    `qrcodeKey=${value?.qrcodeKey ?? ""}`,
-            },
-        ],
-        // 把图片引用 / ascii / url 透传给 presentResult（仅 UI 用）
+        // 面向模型：简洁文本 + 一个 file:// 图片引用（小，不塞 base64）
+        render: (_args, value) => {
+            const lines = ["已生成 B 站登录二维码，请展示给用户扫码："];
+            if (value?.qrImageUrl)
+                lines.push(`![B站登录二维码](${value.qrImageUrl})`);
+            else if (value?.qrDataUrl)
+                lines.push(`![B站登录二维码](${value.qrDataUrl})`);
+            lines.push(`二维码链接：${value?.url ?? ""}`);
+            lines.push(`qrcodeKey=${value?.qrcodeKey ?? ""}`);
+            lines.push("用户扫码并在手机确认后，调用 bili_login_status 完成登录。");
+            return [{ type: "text", text: lines.join("\n") }];
+        },
+        // 把图片引用透传给 presentResult（仅 UI 用）
         presentationMeta: (_args, value) => ({
-            qrImage: value?.qrImage ?? null,
-            ascii: value?.ascii ?? null,
+            qrDataUrl: value?.qrDataUrl ?? null,
+            qrImageUrl: value?.qrImageUrl ?? null,
+            qrImagePath: value?.qrImagePath ?? null,
             url: value?.url ?? null,
         }),
-        // UI 呈现：优先渲染图片二维码；无附件时退化为 ascii 代码块 + 链接
+        // UI 呈现：用自包含的 base64 data URL 以 markdown 图片渲染，dsh 自行获取
         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 扫描上方二维码，并在手机上确认登录。",
-                });
+            if (meta.qrDataUrl) {
+                content.push({ type: "text", text: `![B站登录二维码](${meta.qrDataUrl})` });
             }
-            else if (meta.ascii) {
-                content.push({ type: "text", text: "```\n" + meta.ascii + "\n```" });
-                content.push({ type: "text", text: `二维码链接：${meta.url ?? ""}` });
+            else if (meta.qrImageUrl) {
+                content.push({ type: "text", text: `![B站登录二维码](${meta.qrImageUrl})` });
             }
-            else {
-                content.push({ type: "text", text: `二维码链接：${meta.url ?? ""}` });
+            if (meta.qrImagePath) {
+                content.push({ type: "text", text: `二维码图片已保存到：${meta.qrImagePath}` });
             }
+            content.push({
+                type: "text",
+                text: "请用「哔哩哔哩」App 扫描上方二维码，并在手机上确认登录。",
+            });
             return { card: "generic", title: "扫码登录 B 站", content };
         },
     },
@@ -555,8 +580,6 @@ export const TOOLS = [
     },
 ];
 export function apply(ctx) {
-    // 捕获附件服务，供 bili_gen_qr 把二维码登记成可在 UI 渲染的图片
-    attachmentStore = ctx?.attachments ?? null;
     for (const tool of TOOLS) {
         const output = {
             schema: { type: "object", additionalProperties: true },
@@ -572,7 +595,8 @@ export function apply(ctx) {
             parameters: toDshParameters(tool.parameters),
             output,
             async execute(args) {
-                return await tool.handler(args);
+                // 统一规整为无损 JSON，避免 toDict 里的 undefined / NaN 触发序列化错误
+                return toLosslessJson(await tool.handler(args));
             },
         };
         if (tool.presentResult) {

package/package.json

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