- Início
- Plugins
- Ferramentas e funções
- dsh-BiliBridge
dsh-BiliBridge
si-xiyu/dsh-bilibridge
Bilibili tools for DeepSeek Harness: 27 tools for account reads, preview-gated writes, and two-stage video evidence (subtitles, danmaku, frames, ASR). Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Instalar
dsh plugin --profile web add github:si-xiyu/dsh-bilibridgeREADME
dsh-BiliBridge
DSH 插件:把 B站读取、受审批的账号写入和两阶段视频证据提取,暴露给主 Agent(DeepSeek)。
本项目采用 MIT 许可证,Copyright (c) 2026 Si-xiyu。第三方依赖遵循各自的许可证。
Quickstart
需要 DSH 桌面版(engines.dsh 在 >=0.1.0-rc.6 <0.3.0 内)。ffmpeg、Python + faster-whisper、OCR 都是可选依赖,缺了会明确降级,不影响插件启动。
安装(这条命令要求 dsh 可调用——它不一定在普通 shell 的 PATH 里):
# 已发布到 npm(0.1.2 起):按包名安装
dsh plugin --profile desktop add dsh-bilibili-bridge
# 或从 GitHub Release 的 tarball 安装
dsh plugin --profile desktop add https://github.com/Si-xiyu/dsh-BiliBridge/releases/download/v0.1.2/dsh-bilibili-bridge-0.1.2.tgz
若提示找不到 dsh:Windows 用桌面版自带 shim(<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd,
把它放在 PATH 里,或替换上面命令里的 dsh);仍不行就按 INSTALL.md 的手工链接安装(不需要 dsh)。
也可以直接从仓库装(开发态,同样需要 shim/PATH)。注意这种装法是拷贝, 改仓库后需要重新安装才能生效:
dsh plugin --profile desktop add github:Si-xiyu/dsh-BiliBridge
重启 DSH(bundle 层需要重启一次),然后跑自检:
# macOS / Linux
node ~/.dsh/profiles/desktop/node_modules/dsh-bilibili-bridge/bin/bili.mjs doctor
# Windows(PowerShell)
node "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-bilibili-bridge\bin\bili.mjs" doctor
登录:在 DSH 里说「登录 B站」扫码,或打开 设置 → BiliBridge → 扫码登录。
如果用的是非默认 profile 或自定义 DSH_HOME,把命令里的 desktop / ~/.dsh 换成实际值。
没有 dsh 命令、想用链接安装,或需要完整的依赖矩阵与排障:见 INSTALL.md。
如果你是 AI agent,按 AGENT-INSTALL.md 执行:分步命令、验收标准、失败对照表与红线。
当前状态
完整状态见 docs/state.md(2026-11-10/11 的历史快照;当前版本以 CHANGELOG 与 Releases 为准),工具的真实 endpoint 与验证等级见 docs/capability-matrix.md。
- 认证、HTTP/WBI、凭据持久化:已在旧 macOS 环境用真实账号验证(扫码登录、投稿、稍后观看、收藏夹、评论、字幕、弹幕、故事板)。
- 工具层 27 个:原有 25 个入口保持兼容,新增私信读取和内容管理(删除自己的评论/动态、定时草稿);动态工具增加按
dynamicId读详情和可选图片附件。节能模式与统一风控保护已集成;底部图片条已按用户要求回滚(原因:效果不好)。27 工具与设置页已在 macOS 与 Windows 宿主验收(2026-11-18);写操作审批路径目前只做过 preview,未执行 apply。以下联合验收报告是 2026-11-10 的历史记录,不代表当前宿主状态:联合验收报告。 - 视频理解:Stage 1(文本 + 封面 + Uniform/Adaptive 双九宫格)可用;Stage 2 支持定向及全片/区间自适应选帧、ffmpeg 抽帧(误差约一帧,不声明毫秒上界)、窗口化 ASR(常驻 worker)、可选 OCR;没有 ffmpeg 时降级故事板,
maxErrorMs用每帧实测偏差。inspect 多帧按**每张最多 6 格(2×3)**拆图(7→4+3、9→5+4),避免细长拼图被宿主整体降采样。 - 平台:Windows 与 macOS 走同一套代码,差异只在外部依赖(ffmpeg / OCR 引擎 / ASR 运行时)。
macOS 上 OCR 用系统自带的 Apple Vision,但首次需要 Xcode Command Line Tools(用
swiftc编译一个 Vision 助手,之后按源码 hash 复用);ffmpeg 用 Homebrew 版,CA 自动取系统证书包。见 macOS 安装与验证。 - 写操作:点赞有历史真实验证;收藏与稍后观看已完成真实加入/移除往返并恢复。2026-11-10 又用真实账号完成评论、图文动态、私信的库层 E2E:评论/动态已回读并清理,私信成功发送并读回(留下一条测试消息);21047 未在该会话触发(对方曾回复),错误透传由模拟与历史真实报错覆盖。宿主工具层已在 macOS 与 Windows 验收;审批路径的 apply 未执行。
- P0/P1 的接口、预算与验证边界见 基础读写交付记录。不包含视频投稿或 Opus。
外部依赖:ffmpeg(可选,但决定画面质量)
bilibili_inspect 优先用 ffmpeg 从播放流精确抽帧;没有它,画面自动降级为 B站故事板(约 6–8 秒一格,读小字不行)。
# macOS
brew install ffmpeg # 插件会自动在 /opt/homebrew/bin 找到它,CA 自动用 /etc/ssl/cert.pem
# Windows:放二进制(示例:gyan essentials 静态包)
# D:\tools\ffmpeg\ffmpeg-9.0.2-essentials_build\bin\ffmpeg.exe
#
# 让插件找到它(二选一)
# a. 写配置文件 %USERPROFILE%\.dsh\bilibili\config.json
# { "ffmpegPath": "D:/tools/ffmpeg/.../bin/ffmpeg.exe", "ffmpegCaFile": "C:/Users/<你>/.dsh/bilibili/cacert.pem" }
# b. 设环境变量 FFMPEG_PATH / FFMPEG_CA_FILE
#
# Windows 必须给 CA:该构建用 gnutls,不读系统证书库
# 把 Mozilla 根证书存成 %USERPROFILE%\.dsh\bilibili\cacert.pem
查找顺序:FFMPEG_PATH → config.json#ffmpegPath → 平台常见位置(macOS 是 /opt/homebrew/bin、/usr/local/bin)
→ PATH。macOS 的 GUI 进程 PATH 不含 Homebrew 目录,所以才需要那一步内置候选。
验证:node tests/manual-frames.mjs BV1GJ411x7h7 auto 10000 60000。
视频取数(节能模式)
入口:DSH 账户菜单 → 设置 →「BiliBridge」→「视频取数(节能模式)」。总结视频推荐选「节能(仅字幕)」:仅开启平台字幕,关闭评论、弹幕、画面与 Adaptive 自动补充九宫格;需要完整证据时选「标准(全量)」(五项全开,也是默认配置)。没有平台字幕时不会自动运行 ASR,可按需显式调用 bilibili_transcribe。
extract.{subtitles,comments,danmaku,frames} 是 bilibili_extract / bilibili_collect 的默认取数上限:设置与调用参数 include 是 AND 关系,include=true 不能重新开启设置关闭的来源。adaptive.adaptiveEnabled 只影响 Stage 1 自动补充九宫格。显式 bilibili_comments、bilibili_inspect、bilibili_transcribe 仍可使用,不受这五项限制,原有预算及 ASR/OCR 设置仍适用。
设置保存后下一次调用生效;代码更新需重启 DSH。 字段与预设见 设置面板第 13 节。
工具
| 工具 | 性质 |
|---|---|
bilibili_auth_status / bilibili_auth_begin / bilibili_auth_poll / bilibili_auth_logout | 登录 |
bilibili_me | 当前账号 |
bilibili_video | 视频元数据 + 统计 |
bilibili_user_videos | 投稿列表(mid 省略=自己) |
bilibili_watch_later_list / bilibili_watch_later_set | 稍后观看 |
bilibili_favorites_list / bilibili_favorite_set | 收藏夹 |
bilibili_video_like_set | 点赞 |
bilibili_extract | Stage 1 证据包(文本 + 封面/Uniform/Adaptive,最多 3 张图) |
bilibili_inspect | Stage 2 定向补帧或全片/区间自适应选帧,数量 1–9,每图最多 2×3 |
bilibili_transcribe | Stage 2 按窗口 ASR |
bilibili_search | 视频 / 用户搜索(WBI) |
bilibili_comments | 热门 / 最新评论与最多 3 条楼中楼 |
bilibili_user_profile | 用户主页、粉丝 / 关注数、可取得时的投稿数 |
bilibili_dynamics | 用户/关注流动态;dynamicId 读详情,转发保留原动态索引与原图,可选图片附件 |
bilibili_discover | 热门 / 热搜 / 每周必看 / 排行榜 |
bilibili_notifications | 未读 / 回复 / @ / 点赞 / 私信会话摘要 |
bilibili_messages | 私信会话列表与正文读取(只读、不标记已读,正文截断) |
bilibili_comment_send | 发表评论或回复 |
bilibili_message_send | 文字私信 |
bilibili_dynamic_publish | 文字 / 图文 / 话题 / 定时草稿(定时创建未验收,当前返回 4120015) |
bilibili_content_manage | 删除自己的评论/动态、列出/删除/立即发布定时草稿 |
bilibili_collect | 有上限的搜索后批量评论、字幕采集 |
七个写工具(含 bilibili_content_manage)仅 intent=apply 在代码层走 tools/pre-execute 的 ask。发送类先 preview 获取绑定正文、目标和素材的 previewToken;结果不明返回 PENDING_CONFIRM,用同一工具的 check 核对,禁止盲目重发。删除/草稿操作同样先 preview 绑定目标,但使用独立的结果语义,不套发送账本。所有账号写请求共用最小间隔、失败退避与风控暂停;平台原话(如 21047)会原样返回。
统一请求保护覆盖 API 读取与写入:跨进程间隔、账号小时/日额度、平台暂停与人工恢复;批量采集遇到风控立即停止。node bin/bili.mjs traffic status 离线查看预算与暂停状态。默认参数、review 修正、验证及媒体覆盖限制见 风控保护交付总结。本地策略不能保证账号不被平台限制。
安装(开发版)
面向用户的三步安装见 INSTALL.md;下面是开发态细节。
开发态必须用链接安装,不要用 file::pnpm 的 file: 依赖会按 files 字段把仓库拷贝进 node_modules,改仓库不会生效,必须重新 install;链接安装改完只需重启宿主。
Windows:
# 二选一:
# a) 目录联接(推荐,改代码后重启宿主即可)
cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-bilibili-bridge" "E:\Code\dsh-BiliBridge"
# b) profile 里用 pnpm 的 link: 依赖(pnpm install 后生成符号链接)
在 %USERPROFILE%\.dsh\profiles\desktop\package.json 里:
"dependencies": { "dsh-bilibili-bridge": "link:E:/Code/dsh-BiliBridge" },
"dsh": { "profile": { "bundles": [..., "dsh-bilibili-bridge"] } }
macOS/Linux:ln -sfn <仓库> ~/.dsh/profiles/desktop/node_modules/dsh-bilibili-bridge,
依赖写成 "link:/Users/<你>/Code/dsh-BiliBridge"。
手工 junction 建好后不要再对该 profile 跑
pnpm install/dsh plugin add:pnpm 可能把 junction 换成拷贝,仓库改动从此不生效;要装依赖就在仓库里npm install。 验证:/bilibili-bridge/api/status的identity.modulePath必须等于仓库绝对路径。
已经用
file:装的:改仓库后必须重新pnpm install(或换成link:),否则宿主加载的是旧拷贝。 重启宿主只对链接安装有效。
重启 DSH 后,新会话应能看到 27 个 bilibili_* 工具(macOS 与 Windows 均已完成重启验收)。插件没有 HMR,改 lib/ 必须重启宿主。
安装自检(doctor)
装好依赖后先跑一次离线自检:
node bin/bili.mjs doctor # 人读表格
node bin/bili.mjs doctor --json # 机器可读(CI / 脚本)
检查 7 项:runtime(Node / 平台 / 插件版本 / 模块路径 / 工具数)、ffmpeg、ASR、sharp、OCR、
storage(数据目录可写、凭据 0600、config 可解析)、login(离线读凭据,不联网)。
必需项是 runtime 与 storage:失败时退出码为 1;ffmpeg / ASR / OCR / sharp 缺失只标注,
不阻断插件启动(会按既有语义明确降级)。设置页状态接口同时返回 identity(版本、模块路径、工具数),
可用来确认宿主加载的是哪一份代码。存储检查会按需创建数据目录并写一个临时文件(随即删除),其余检查只读、不联网。
运行时路径(ffmpeg、CA 证书、ASR Python、模型目录)可直接在 设置 →「BiliBridge」→「运行时路径」里编辑:
留空表示自动探测,保存后下一次调用生效;等价于 config.json 的 runtime 段(旧版顶层键仍兼容)。
开发 CLI
$env:BILI_DATA_DIR=".\.bili-data"
node bin/bili.mjs status
node bin/bili.mjs qr # 生成二维码 PNG
node bin/bili.mjs poll 30 # 轮询
node bin/bili.mjs latest # 我最新投稿 + 播放量
npm run test:single # 单进程跑单测(受限沙箱里 npm test 的子进程会 EPERM)
node tests/manual-op-e2e.mjs # 写操作 dry-run(只读 + preview)
node tests/manual-op-e2e.mjs --apply # 真实写入,逐项回读并清理;私信需再传 --dm-mid=<测试账号>
node tests/manual-evidence.mjs BV1YLHu6zEDp
node tests/manual-read.mjs search "编程" --type video
node tests/manual-read.mjs comments BV1VZWc6dECG --sort hot
macOS/Linux 用 BILI_DATA_DIR=./.bili-data node ... 的写法。
只读工具的 endpoint、真实验收摘要与限制见 能力矩阵。手工脚本只输出分页信息和前两条样本;--page / --page-size 控制列表分页,动态用 --offset 续取,--no-replies 关闭楼中楼,--anonymous 验证无凭据状态。
抓包探针需要 playwright-core(未列入依赖):npm i -D playwright-core,或用 PLAYWRIGHT_CORE 指向它的入口文件。
约束
- 唯一推理模型是 DSH 主 Agent;插件不调用任何 LLM/VLM。OCR 只做文字识别、ASR 只做语音转写,两者都只是证据来源,输出必须标
origin。 - 凭据只允许当前用户访问(POSIX 0600;Windows 用 icacls 关继承、只授权当前用户);工具返回值、日志、报告不出现 Cookie / CSRF / 刷新凭据。
- 所有 B站请求(含图片/字幕/弹幕/DASH 流)走
lib/bili/http.mjs:一套 UA/Referer,域名白名单,禁止内网地址。 - 不实现自动刷视频、人格、主动分享。
- 故事板精度以返回的
maxErrorMs为准(通常数秒);读小字需要 ffmpeg。
已知限制
-
自适应选帧默认启用,采用传统视觉特征、Haar 与 Facility Location;扫描和截图有耗时预算,失败降级。用法、配置及实测见 自适应代表帧。视觉代表性不等于语义重要性。
-
字幕必须走 WBI 签名的
/x/player/wbi/v2;不带签名的/x/player/v2会返回别的视频的 AI 字幕,不能使用。 -
长字幕每页最多 800 条;将
subtitles.nextCursor传回extract.subtitleCursor续取。轨道变化需从头读取;完整轨道覆盖率与本页范围分开返回。 -
评论常规分页使用
/x/v2/reply。每次最多补取前 5 个预览不足的楼中楼,其余保留已有预览。只有 -400 或明确要求 WBI 时才降级;WBI 降级仅支持第一页,不把风控错误当作降级理由。 -
动态 pageSize 是单次上限(1–50);nextOffset 有下一页时始终为绑定 scope 的
dsh:游标,裸 offset 会返回 INVALID_ARGUMENT,旧的裸游标需重新从第一页获取。较小分页保留同一上游批次的尾部。不是快照,源列表变化时可能重复或漂移,调用方宜按 dynamicId 去重。纯图片动态没有文本时返回空 text,不做 OCR。 -
故事板九宫格是“概览”,不是精确抽帧;
bilibili_inspect会返回req/got与accuracy。 -
空间接口目前 8/8 成功,但 B站风控随时可能变化;412 会作为
RATE_LIMITED返回。 -
未登录时
nav返回-101,HTTP 层用acceptCodes处理。
Plugins relacionados
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora