dsh-shlr-bilitoolkit 0.1.24 → 0.1.26

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

@@ -12,21 +12,30 @@ export class VideoAPI {
     }
     async *iterRecommend(pages = 1, pageSize = 10) {
         const seen = new Set();
+        // 推荐流里混有广告(goto=ad)、直播、OGV 等非普通视频项，会被过滤掉，
+        // 所以按上限多抓一些做补偿，尽量让「要几条给几条」。
+        // 注意：B 站对 ps 有上限（约 30），给大了会 -400。
+        const ps = 30;
         for (let page = 1; page <= pages; page++) {
             const payload = await this.client.get(endpoints.RCMD_FEED, {
                 fresh_idx: page,
                 fresh_idx_1h: page,
                 feed_version: 1,
-                ps: pageSize,
+                ps,
             });
             const items = payload?.data?.item ?? [];
             let added = 0;
             for (const item of items) {
+                // 只保留普通视频（goto=av）：排除广告 / 直播 / OGV / 推广等
+                if (item?.goto && item.goto !== "av")
+                    continue;
                 const video = Video.fromFeedItem(item);
                 if (video && !seen.has(video.bvid)) {
                     seen.add(video.bvid);
                     added += 1;
                     yield video;
+                    if (seen.size >= pageSize * pages)
+                        return;
                 }
             }
             if (!added)

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