dsh-shlr-bilitoolkit 0.1.25 → 0.1.27

package/AGENTS.md

@@ -5,5 +5,9 @@
 **必须调用 bili_gen_qr，并把返回的二维码图片展示给用户扫码**——用 qrDataUrl 以 Markdown 图片 `![qr](<qrDataUrl>)` 渲染（或引用 qrImageUrl / qrImagePath）。
 禁止只给链接、用 ASCII、让用户自己跑命令。用户确认后调 bili_login_status 完成登录。
 
+## 多步查询
+需要多个 B 站数据时（如「视频详情 + 热评 + UP主资料」），尽量在一段代码里完成，不要连续调用多个工具：
+- 独立的只读调用用 `Promise.all` 并发；写操作保持逐条 `await`。
+
 ## 其它
 写操作（点赞 / 收藏 / 投币 / 关注 / 评论 / 私信 / 三连 / 发动态 / 改资料）会真实修改账号状态，执行前先与用户确认。

package/README.md

@@ -1,6 +1,6 @@
 # dsh-shlr-bilitoolkit
 
-0.1.15-0.1.19为工具懒加载版，
+0.1.15-0.1.19为工具懒加载版
 
 B 站（哔哩哔哩）接口封装的 **TypeScript** 移植版，作为 [dsh](https://dshmp.com)（DeepSeek Harness）插件提供「视频 / 搜索 / 空间」等读取能力。
 
@@ -64,7 +64,7 @@ await client.loadCookies();
 const videos = await client.video.recommend(2, 10);
 const detail = await client.video.detail("BV1xx411c7mD");
 const text   = await client.video.subtitleText("BV1xx411c7mD"); // 字幕纯文本
-const [videos2, total] = await client.search.videos("孤独摇滚");
+const [videos2, total] = await client.search.videos("偶像大师");
 const info = await client.space.info(574115689);
 const [ups, _] = await client.space.videos(574115689, 1, 10);
 ```

package/dist/apis/dynamic.d.ts

@@ -8,7 +8,6 @@ import { Dynamic } from "../models.js";
 export declare class DynamicAPI {
     private client;
     constructor(client: BiliClient);
-    private _detailCache;
     detail(dynamicId: string | number): Promise<Dynamic>;
     feed(page?: number, offset?: string, type?: string): Promise<[Dynamic[], string, boolean]>;
     space(uid: number, offset?: string): Promise<[Dynamic[], string, boolean, number]>;

package/dist/apis/dynamic.js

@@ -26,19 +26,15 @@ export class DynamicAPI {
     client;
     constructor(client) {
         this.client = client;
-        this._detailCache = {};
     }
-    _detailCache;
     async detail(dynamicId) {
-        const id = String(Math.floor(Number(dynamicId)));
-        const cached = this._detailCache[id];
-        if (cached)
-            return cached;
+        // 动态 id 常超出 JS 安全整数范围（>2^53），绝不能过 Number，否则丢精度、接口报 4101105
+        // 不做内存缓存：动态可能被删/改，缓存会返回脏数据，而它只省 HTTP、不省 LLM token。
+        const id = String(dynamicId);
         const payload = await this.client.get(endpoints.DYNAMIC_DETAIL, { id, features: FEATURES }, { Referer: `https://t.bilibili.com/${id}` });
         const dynamic = Dynamic.fromApi((payload?.data ?? {}).item);
         if (!dynamic)
             throw new BiliApiError("未找到该动态");
-        this._detailCache[id] = dynamic;
         return dynamic;
     }
     async feed(page = 1, offset, type = "all") {
@@ -182,7 +178,7 @@ export class DynamicAPI {
     }
     async repost(dynamicId, text = "") {
         const form = {
-            dynamic_id: String(Math.floor(Number(dynamicId))),
+            dynamic_id: String(dynamicId),
             content: text || "",
             csrf: this.client.csrf,
             csrf_token: this.client.csrf,
@@ -192,7 +188,7 @@ export class DynamicAPI {
     }
     async thumb(dynamicId, liked = true) {
         const body = JSON.stringify({
-            dyn_id_str: String(Math.floor(Number(dynamicId))),
+            dyn_id_str: String(dynamicId),
             up: liked ? 1 : 2,
         });
         await this.client.post(endpoints.DYNAMIC_THUMB, body, {

package/dist/dsh.d.ts

@@ -38,6 +38,14 @@ export declare const GROUPS: Record<string, {
     hint: string;
     ids: string[];
 }>;
+/**
+ * 工具输出 schema。必须用 type:"json"（编译成无 type 的注解式 schema，任意 lossless
+ * JSON 都放行）：我们的工具有的返回数组（recommend / pagelist / subtitles）、有的返回
+ * 对象、有的返回标量；若声明 type:"object"，数组会被校验器拒（"value" must be an object）。
+ */
+export declare const OUTPUT_SCHEMA_SPEC: {
+    readonly type: "json";
+};
 export declare function apply(ctx: any): void;
 export * from "./index.js";
 export { BiliClient, Video, User, Page, PlayInfo, Subtitle, Collection };

package/dist/dsh.js

@@ -1190,10 +1190,16 @@ function closeGroup(group) {
     if (i >= 0)
         groupLru.splice(i, 1);
 }
+/**
+ * 工具输出 schema。必须用 type:"json"（编译成无 type 的注解式 schema，任意 lossless
+ * JSON 都放行）：我们的工具有的返回数组（recommend / pagelist / subtitles）、有的返回
+ * 对象、有的返回标量；若声明 type:"object"，数组会被校验器拒（"value" must be an object）。
+ */
+export const OUTPUT_SCHEMA_SPEC = { type: "json" };
 /** 把一个内部 DshTool 编译成官方 defineTool 定义。 */
 function buildDef(tool) {
     const output = {
-        schema: { type: "object", additionalProperties: true },
+        schema: OUTPUT_SCHEMA_SPEC,
         render: tool.render ??
             ((_args, value) => [{ type: "text", text: textOf(value) }]),
     };

package/package.json

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