Vai al contenuto principale
S

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.

Installazione

dsh plugin --profile web add github:si-xiyu/dsh-bilibridge

README

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_extractStage 1 证据包(文本 + 封面/Uniform/Adaptive,最多 3 张图)
bilibili_inspectStage 2 定向补帧或全片/区间自适应选帧,数量 1–9,每图最多 2×3
bilibili_transcribeStage 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 处理。

Plugin correlati