dsh-bili-search
Verifieddsh-bili-search · v0.5.3 · MIT · Web UI
DeepSeek Harness 插件:按关键词检索 B 站视频(wbi 签名优先、拿不到自动降级免签名,无登录凭证也能跑),过硬闸出候选清单,由对话模型看标题剔无关、问清意图后按播放量收口(可标强相关置顶);支持找 UP 主 / 找番剧;deep 模式读详情/字幕/热评并附总结骨架(九节 + 八类主题 profile + 评论区规则),结果落盘 md/csv/json,带图形设置页。
Install
dsh plugin add dsh-bili-search Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-bili-search
DeepSeek Harness(DSH)插件:按关键词检索 B 站视频 → 过硬闸出候选清单 → 由对话模型看标题剔掉无关 → 问清意图后按播放量收口;
deep模式读详情、字幕与热评,并附一份「总结骨架」让你写出来的总结有固定结构与硬约束。
包名 dsh-bili-search(原名 dsh-bili-filter)。为了不打断已有调用与历史数据,工具名仍是 bili_filter,自检路由仍是 /bili-filter-api,数据目录仍是 ~/.bili-filter,默认落盘目录仍是 ~/Documents/bili-filter。
为什么不是一个「搜一下」的封装
B 站搜索接口直接调用有三个坑,这个插件把三个都踩过了:
- search 端点的签名要求会变:
wbi签名(wts+w_rid,密钥取nav的wbi_img,缓存 1 小时)是首选通道,但 2026-11-04 实测发现 无 cookie、无签名同样能拿到code=0、page_size=50也生效。所以现在的策略是「签名优先、失败自动降级免签名」,并把结果状态暴露在/state的searchChannel里——早期把它当成硬依赖,遇到风控时误判成「签名坏了」。 - node 的 fetch / http2 会被 TLS 指纹拦(412 拦截页),实际传输走
curl子进程(cookie 写进--config临时文件,不进 argv)。 - 字幕接口有两类偶发故障:字幕条目在但
subtitle_url为空;同一 bvid 每次给的字幕文件可能不是同一条(串台)。所以字幕要重试 + 质量闸,且覆盖率达标也挡不住语义串台(实测遇到过 100% 覆盖但内容是另一条视频的)。
登录凭证只是加分项:没有 cookie 也能跑 overview(搜索端点免登录),差别在 deep 的评论与字幕,以及匿名/登录两种身份下排序会略有不同。
能力
- 两段式:
stage=list出候选(默认 200 条,不落盘)→ 模型按标题剔无关 →stage=final带keep+intent收口落盘。final 排序 = 强相关组(strong,无视播放量、组内按播放量降序)→ 其余按播放量降序,同 UP 上限默认 3。 - 硬闸:G2 排除词 / G3 时长档 / G4 标题重复与搬运 / G5 时间筛选 / G7 播放量下限(
minPlay,默认 1000,0=不限)。字段缺失不再淘汰(显示「—」)。 - 多检索词:最多 4 条,用换行 /
|/|/;分隔。每条必须是能独立表达同一意图的同义整句——把原词拆成碎片会被checkVariants直接拒绝。 - 候选池复用:同参数 5 分钟内 final 不再重搜(0 次取样调用,仅同进程有效)。
- deep 取证:只对收口后的前
deepTop条取view详情 + AI 字幕(最多试 3 次)+ 热评(20/50/100 条,内部翻页凑数)。 - 总结骨架:deep 收口后自动附一份可照着写的结构——L0 九条硬约束(证据成色先交代 / 正文与评论来源隔离 / 必须落名 / 数字带单位与成立条件 / 标准化换算 / 标证据强度 / 去重 / 术语归一 / 缺口必须声明)+ L1 固定九节 + L2 八类主题模板(price / howto / review / event / idea / product / ranking / generic,按关键词与标题自动判定)+ 评论区规则 + 自动填好的证据成色表。
- 落盘:md / csv / json 三份(可分别关掉)。
- 找 UP 主 / 找番剧:
scope=user、scope=bangumi走聚合搜索(search/all/v2,免签名)的分组结果,只列清单(每页固定 20 条),不走硬闸、不排序、不收口。 - 稳定输出契约:json 顶层另有
items,固定 10 个下划线字段(title/author/play_count/duration/publish_date/url/bvid/tag/description/typename),给下游脚本用,B 站改字段时这一层不跟着变。 - 平台命中字段:搜索接口自己会带
hit_columns(命中在 title / tag / description),命中率优先用它,比本地切片更准。 - 图形设置页:DSH「设置」→「B站搜索」,改哪一项就自动保存,下一次检索即生效。
安装
两种方式:npm 装(推荐,跟宿主一起升级)或 本地 link(改代码即生效)。
方式 A:npm
npm i dsh-bili-search
然后在 profiles/desktop/package.json 里把包名列进 bundles(依赖可以交给包管理器写,bundle 必须有):
{
"dependencies": { "dsh-bili-search": "^0.5.0" },
"dsh": { "profile": { "bundles": ["...", "dsh-bili-search"] } }
}
本机的 dsh-bili-scroll 2.3.0 就是 npm 装进 profile 的,宿主按「包名 + 版本」加载插件这条路是通的。
方式 B:本地 link
插件目录放任意位置,在 DSH desktop profile 里登记成 link: 型。
# 1) 把仓库放到任意目录,例如 D:/plugins/dsh-bili-search
# 2) 在 profile 的 package.json 里加依赖与 bundle(先备份!)
# DSH_PROFILE_DIR = %APPDATA%/dsh-desktop/harness/profiles/desktop
profiles/desktop/package.json 需要两处改动:
{
"dependencies": {
"dsh-bili-search": "link:D:/plugins/dsh-bili-search"
},
"dsh": {
"profile": {
"bundles": ["...", "dsh-bili-search"]
}
}
}
再在 profiles/desktop/node_modules 里做一条 Junction(Windows):
New-Item -ItemType Junction `
-Path "$env:APPDATA\dsh-desktop\harness\profiles\desktop\node_modules\dsh-bili-search" `
-Target "D:\plugins\dsh-bili-search"
改 JSON 请用 node 写、写完 JSON.parse 验一遍;不要用 PowerShell Set-Content -Encoding UTF8(5.1 会写 BOM,启动期读配置会直接挂)。
插件自己只有单元级依赖:@deepseek-ai/dsh-tools(peer,由宿主提供)。
使用
工具名 bili_filter,主要参数:
| 参数 | 说明 |
|---|---|
keyword |
检索词,按意图改写成同义整句,可多条(≤4) |
stage |
list(默认,出候选)/ final(收口落盘) |
scope |
video(默认,两段式)/ user(找 UP 主)/ bangumi(找番剧、影视;只列清单,不支持 final) |
keep |
final 用:候选里留下的 bvid,空格或逗号分隔 |
strong |
final 用:几乎与意图一致的 bvid,排最前且无视播放量(须同时在 keep 里) |
sort |
totalrank(B 站综合排序位次)/ play(播放量降序);list 默认前者、final 默认后者 |
days / duration |
时间筛选(0=不限)/ 时长档(any 1 2 3 4) |
minPlay |
播放量下限(硬闸 G7),0=不限 |
targetN / candidateLimit |
final 输出条数 / list 候选条数(5–500) |
upCap / exclude / typename |
同 UP 上限 / 排除词 / 限定分区 |
intent |
用户意图,写进落盘表头 |
mode / deepTop |
overview(默认,不取详情)/ deep(前 N 条取证) |
probe / outDir |
供给不足时的敏感性探测 / 落盘目录 |
典型一轮:
bili_filter(keyword="AI视频 生成 多少钱|即梦 Seedance 可灵 价格", days=90, minPlay=300, stage="list")
→ 看标题剔无关,挑出 keep 与 strong
bili_filter(keyword="<同一条串>", stage="final", keep="BV1xxx,BV1yyy", strong="BV1xxx",
intent="各平台单价与套餐性价比", mode="deep", deepTop=3)
状态与数据
| 位置 | 内容 |
|---|---|
~/.bili-filter/settings.json |
设置页存的值 |
~/.bili-filter/state.json |
风控冷却截止时间 |
~/.bili-filter/wbi.json |
wbi 签名密钥缓存(1 小时) |
~/.bili-filter/last-run.json |
最近一次运行摘要 |
~/Documents/bili-filter/ |
落盘结果(md / csv / json) |
~/.bilibili-cli/credential.json |
B 站 cookie(由 bilibili-cli 维护,插件只读) |
自检路由(宿主 Web 端口上):
GET /bili-filter-api/state 版本 / 传输方式 / 本轮调用数 / 冷却剩余 / 设置摘要
GET /bili-filter-api/settings 设置 + 默认值 + 上下限
POST /bili-filter-api/settings 改设置(逐项校验,越界 400)
POST /bili-filter-api/clear-cooldown 立即清除风控冷却
POST /bili-filter-api/refresh-wbi 刷新 wbi 签名
POST /bili-filter-api/probe-login 检测登录态
风控与节奏
- 请求间隔默认 340ms(下限 200ms),单轮调用上限硬顶 70。
- 命中风控(
-412/ 拦截页)→ 退避重试 6s、18s → 仍失败则落冷却 10 分钟,冷却期内直接拒绝并告知剩余时间。 - 只读:不点赞、不评论、不投币、不改任何账号状态。
- 账号只走本机 cookie,插件不保存 cookie 内容,只保存路径。
已知限制
- 字幕语义串台无法靠覆盖率拦截:会拿到时长/密度都达标但内容属于别的视频的字幕。
deep的证据成色表会如实标出字幕状态,写总结时请自行核对主题是否对得上。 - 候选池缓存只在同进程内有效(重启即失效)。
- B 站接口与风控策略随时会变;参数与端点是按 2026-11 的实测行为写的。
- 结果质量取决于检索词:别把一个词拆成碎片,也别指望一个词搜出所有侧面。
开发与验证
npm run check # node --check 全部源文件 + package.json 能 JSON.parse
npm run smoke # 插件层冒烟(56 项,不联网,会临时改设置并自动还原)
npm run test:requests # 请求次数离线断言(打桩 fetch:1 排序 1 页 = 1 次;final 复用 = 0 次)
node tools/test-risk.mjs # 风控退避与冷却(假 fetch,不联网)
node tools/test-variants.mjs # 多检索词变体与拆词拦截(不联网)
node tools/test-cache.mjs # 候选池复用(假 fetch,不联网)
node tools/run.mjs "关键词" --days 30 --stage list --limit 20 # 真跑原型 CLI
CI 在 push / PR 上跑这三条(Node 20 / 22 / 24 三档);打 v* tag 会触发 publish.yml:先跑同一套验收,校验 tag 与 package.json 版本一致,再 npm publish --provenance。发版前本机要 npm login,仓库 Secrets 里要有 NPM_TOKEN。
tools/ 下另有一次性探针(probe-once / probe-endpoints / probe-wbi / probe-deep / dump-transcript*),用于排查接口与字幕问题。
改了 lib/*.js 必须重启 DSH;client.js 走 HMR,刷新设置页即可。
免责
仅供个人检索与阅读使用。使用时请遵守 B 站的服务条款与 robots 约定,控制请求频率,不要用于批量抓取或再分发内容。本项目与 B 站官方无关。
License
MIT