前言¶
在 DeepSeek Harness（DSH）里做中文技术问答时，模型往往只能拿到你粘贴的链接或标题。通用网页搜索对 B 站教程的召回也偏宽：命中的是标题和摘要片段，很难直接回答「这节课配套资料在哪」「第几分钟在讲什么」。维护者 2332239652 发布的 dsh-bilibili-retrieval（分类：联网工具）面向的就是从「找到候选视频」到「读懂这条视频」这一段：搜索、简介全文、UP 置顶评论、分片字幕带时间锚点、预览雪碧图抽帧，且 README 标明零运行时依赖（不需要 ffmpeg、Python、sharp）。下面按安装、工具与典型用法说明。
这是什么¶
一句话：给 DSH 加一层 B 站检索与「读视频」能力，让中文视频教程更接近一等检索源，而不是 opaque 链接。
- 仓库：2332239652/dsh-bilibili-retrieval
- 目录页：SkillHub 插件页
- 许可证：MIT（README / package.json）
- 版本：0.2.0（package.json）
- 运行要求：Node ≥ 20；runtime deps 为 0
插件通过 ctx.tools.register() 注册工具，parameters 与 output.schema 使用标准 JSON Schema，不 import @deepseek-ai/*，以便从任意目录用 link: 安装时仍能激活。
核心功能¶
控制面板¶
装好后在 设置 → B 站检索 可完成账号扫码、通道状态、预览图缓存与参数修改，无需手敲命令。面板经宿主侧 /api/bilibili-retrieval 工作；SESSDATA 留在宿主进程，路由只接受本机同源请求。
九个工具¶
| 工具 | 作用 | 需要登录 |
|---|---|---|
bili_search |
关键词搜视频，带噪音过滤 | — |
bili_video |
单视频元数据、简介全文（desc_v2）、分 P、统计、标签；相关视频默认不返回（related 默认 0） |
— |
bili_comments |
UP 主置顶评论 + 热评，含 has_pinned、linkComment |
— |
bili_frames |
预览帧雪碧图（默认 10×10），无需 ffmpeg | — |
bili_cache |
查看 / 清空预览图磁盘占用 | — |
bili_probe |
双通道状态 + 搜索连通性诊断 | — |
bili_transcript |
字幕全文分片读取，带 [mm:ss] 时间锚点 |
✅ |
bili_summary |
B 站 AI 摘要 + 大纲（另有权限门槛） | ✅ |
bili_login |
扫码登录：start / status / logout |
— |
匿名通道（约 2s/请求、桶深 5）承担搜索、元数据、评论、抽帧；登录通道（约 3s/请求、桶深 2、单会话硬上限 20 次）承担字幕、AI 摘要等。插件对 B 站账号只读，不点赞、不评论、不关注、不投币。
搜索噪音过滤¶
B 站召回较宽时，插件会做拉丁词边界匹配、纯拉丁查询全 token 命中、以及「≥3 条全命中时剔除部分命中」等处理，只过滤不重排；若结果为空则退回原始排序并标注 unfiltered。
上下文与磁盘¶
README 给出典型 token 开销（例如固定工具描述约 1300 tokens；bili_transcript 默认 4000 字约 1300 tokens）。字幕必须分片续读（startChar 等）。预览图写入工作区 bili-frames/，默认上限 12 张 / 24 MB，可在 cordis.patch.yml 调整 framesMaxFiles / framesMaxBytes。
安装与启用¶
官方 README 给出的开发/本地目录安装方式为（路径换成你的 clone 或解压目录；不要凭插件名拼接 github:owner/repo）：
dsh plugin --profile desktop add "link:C:/path/to/dsh-bilibili-retrieval"
注意：README 实测 dshd plugin add 会把参数按字符拆开导致失败，须用 dsh plugin --profile desktop add。
装完后 重启一次 DSH 客户端（bundle 层需重启才会组装）。
验证安装：
bili_probe
期望 search ok="true"。若 authenticated 为 not logged in，仅影响字幕与 AI 摘要；搜索、元数据、评论、抽帧仍可用。
可选：启用字幕
bili_login action=start
会出二维码（约 3 分钟过期；默认等待 45 秒）。凭据存 $DSH_HOME/bili/credential.json（权限 0600），不写 .env。
配置覆盖：在 ~/.dsh/profiles/desktop/cordis.patch.yml 中对 id: bilibili-retrieval 写 patch，例如 anonMinIntervalMs、anonBurst、authMinIntervalMs 等（完整默认值见仓库 cordis.patch.yml）。
典型用法¶
先做连通性检查，再按任务选工具。
- 找课 / 筛候选
调用 bili_search，利用噪音过滤减少无关命中。
- 读简介与分 P
bili_video 拿 desc_v2 全文与分 P 目录；需要相关推荐时再显式提高 related。
- 拿配套链接（置顶评论）
README 示例：bili_comments 可得到 UP 置顶中的 read 链接等，这是通用搜索难以直接给出的信息。
- 读字幕（需登录）
分片输出形如：
<cues>902</cues>
<range>0-4000 of 9473 chars (0:00-3:10 of 20:40); call again with startChar=4000 for the next slice</range>
<transcript>
[00:00] …
[00:22] …
</transcript>
- 看画面
bili_frames 生成雪碧图到 bili-frames/，可直接预览。
结构化错误会归一为 BiliError（如 BILIBILI_LOGIN_REQUIRED、BILIBILI_SUBTITLES_UNAVAILABLE 等），便于模型理解而非吞 HTML 风控页。
适用场景与注意¶
适合谁：在 DSH 里做中文教程检索、需要从视频内提取讲义链接、按时间轴读字幕、或快速扫预览帧的开发者与智能体编排场景。
权限与安全：
- 插件以当前 DSH 进程权限运行；安装前请自行审阅 GitHub 源码 与 MIT 许可证。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区维护的联网工具插件之一。
- 登录态有单会话配额；AI 摘要可能遇到
BILIBILI_SUMMARY_FORBIDDEN，README 建议可改用字幕。
已知限制（摘自 README）：无字幕轨的视频登录也无法拉字幕；匿名无法下载 CDN 字幕 JSON；二维码与端点域名等细节已在仓库「已知限制」「扫码登录的三个坑」中说明。
结尾¶
dsh-bilibili-retrieval 把 B 站从「一条链接」补成可检索、可分片阅读、可看帧的结构化来源，并在搜索过滤、上下文分片与双通道限速上做了硬约束。需要安装细节、面板截图级说明与设计要点时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/2332239652/dsh-bilibili-retrieval
- GitHub：https://github.com/2332239652/dsh-bilibili-retrieval
