dsh-bili-video:在 DSH 里同时「读 B 站嘴」和「看视频眼」

前言

在 DeepSeek Harness(DSH)里做 B 站相关任务,常见做法是分别装搜索/评论类插件,再另找一套工具去拉流、切帧、看结构。对话里要在两套能力之间来回切换,配置也不在一个页面里。dsh-bili-video 把 B 站交互与视频分镜合并进同一个插件包,维护者 13520rygvv 标明是个人自用、顺手分享,基于两个 MIT 上游项目合并改造,不是产品路线,也不承诺在所有 DSH 版本上行为完全一致。

这是什么

dsh-bili-video 是 DSH 社区目录中的联网工具类插件(目录页:https://www.skillhub.cn/plugins/13520rygvv/dsh-bili-video)。当前发布版本为 0.9.0,许可证 MIT,仓库:https://github.com/13520rygvv/dsh-bili-video。

一句话定位:搜视频、读字幕与评论、发评论/三连/私信、扫码登录,以及把一条视频(链接或 BV 号)做成带编号的宫格分镜、时间码清单和音频波形条;需要细节时用放大工具在原流里重扫。

核心功能

下面按 README 中的工具表说明,只列资料里已写明的名称与用途。

B 站交互(「读嘴」)

工具 作用
bili_search 关键词搜索,可选排序与时间窗,返回 BV 号、播放量、简介等
bili_subtitle 读取字幕原文;无字幕时会说明
bili_comments 翻评论区(含楼中楼),按赞数排序
bili_reply 发评论,可 @ 用户
bili_triple 三连:点赞、投币、收藏
bili_send_message 发私信
bili_whoami 当前登录身份与凭证是否有效
bili_status 当日刷轮次、下次时间、环境是否就绪
bili_login_start / bili_login_poll 扫码登录:生成二维码后轮询结果
bili_setup 安装主依赖或修复环境
bili_config 读写配置(与设置页等价,可批量修改)

视频分镜(「看眼」)

工具 作用
video_probe 只读容器头:时长、分辨率、字幕轨、可用档位;不消耗图片 token
video_storyboard 切点检测 + 编号宫格 + 时间码清单 + 音频条(切点、静音、镜头数)
video_zoom 在指定时间窗内重扫,取更细帧
video_locate 用一句话描述找回片内大致时间码
video_watch 按「看点」模式跑组合流程

资料中强调的几点行为:

  • BV 号可直接作为输入,例如 video_storyboard({ input: "BV1TDC6YVEK7" }),插件会补全链接。
  • 默认用较低清晰度扫结构;登录 B 站后可拿更高档位流(大会员专属档位另算)。
  • 优先使用站点 CC 字幕;没有 CC 时才走 ASR,需单独配置 key。
  • 宫格来自低码率扫描副本;看细节应使用 video_zoom 从原流取帧。

安装与启用

环境要求

  1. Python 3.10+(或 uv)和 ffmpeg:Python 供 B 站半边使用;无 ffmpeg 时「看视频」半边不可用,B 站半边仍可用。
  2. DSH 版本:dsh >= 0.1.7-rc.1(package.json 的 engines.dsh);版本过旧时设置里可能看不到「看视频」,内核会静默跳过插件。
  3. Node:>=22(同上 engines)。
  4. 可选:yt-dlp(直接吃 B 站链接/BV 时需装);ASR 仅在无 CC 字幕时使用,配置见下文。

安装步骤

先在 DSH 中:设置 → 插件 → 安装,填写仓库标识;或使用命令行(资料原文):

github:13520rygvv/dsh-bili-video
dsh plugin --profile desktop add github:13520rygvv/dsh-bili-video

装完后重启一次 DSH(插件在 bundle 层组装,不重启不生效)。进入 设置 → 看视频,用 B 站账号扫码登录。

README 还提到:把仓库链接发给本机 DSH,说明「帮我装这个插件」,也可走同样安装路径。

设置页概览

设置 → 看视频 共 5 个页签:看视频、B 站、自动刷、提示词、环境与高级。其中「看视频」页的 7 个字段对下一次工具调用立即生效(无需重启):

配置 含义
videoCells 一张图几格(0 = 自动)
videoSheets 出几张图(0 = 自动)
videoDetail 每格文字量:low / med / high
videoScanHeight 扫描档:240 / 360 / 480 / 720
videoZoomHeight 放大档:720 / 1080 / 1440 / 2160
videoTranscript auto(无字幕才听写)/ off
videoAsrLang 空则跟 asr.json,或 auto / zh / en / ja

无 CC 字幕且启用听写时,在 ~/.dsh/asr.json 配置 ASR(改完即时生效):

{
  "baseUrl": "https://api.siliconflow.cn/v1",
  "key": "sk-...",
  "model": "FunAudioLLM/SenseVoiceSmall",
  "language": "auto"
}

资料建议 language 用 auto;SenseVoice 对动漫台词准确率一般,引用台词前宜与画面硬字幕核对。

更新

dsh plugin --profile desktop remove dsh-bili-video
dsh plugin --profile desktop add github:13520rygvv/dsh-bili-video

设置页「环境与高级 → 检查更新」也会提示是否有新提交。

典型用法

在智能体对话中直接调用上述工具名即可;分镜侧最简示例来自 README:

video_storyboard({ input: "BV1TDC6YVEK7" })

需要先了解片长与轨道而不出图时,可先 video_probe;定位某句描述再用 video_locate;对某一时间段要更密帧率时用 video_zoom。

B 站侧典型顺序:无登录态时用 bili_login_start + bili_login_poll;用 bili_whoami 确认凭证;搜片用 bili_search,读稿用 bili_subtitle,互动前看清 README 中的使用提醒(勿刷量、勿高频打扰)。

适用场景与注意

适合谁:已在用 DSH、需要在同一进程里完成 B 站信息获取/轻量互动,并对本地视频或 B 站链接做结构化解构(分镜、时间码)的开发者或个人用户。

来源与边界:仓库合并自 Yuuyuko-uu/dsh-bili-subagent(上游含 c1overzz/dsh-bili-scroll)与 SAOS-3624/dsh-video-storyboard,改动包括包名 dsh-bili-video、挂入 storyboard vendor、BV 直喂、登录态 cookies、ASR 兜底与设置页等;细节见仓库 NOTICE。

权限与安全:插件以当前 DSH 进程权限运行,会代你访问 B 站接口并可能写评论、私信、三连。安装前应自行阅读源码与 MIT 许可证;账号限流或封禁由使用者承担。社区目录 skillhub.cn 为独立站点,与 DeepSeek / 幻方无官方从属关系。

常见问题(摘自 README):重启后 web 启动失败且报 import failed 时,检查 client.js 里 load({ id: ... }) 是否与 package.json 的 name 一致;看视频提示无字幕且 transcript: no-key 表示 ASR 未配;B 站链接下载失败时安装 yt-dlp 并确认插件 venv 内可用。

结尾

dsh-bili-video 把 B 站「读嘴」与视频「看眼」收进一个 DSH 插件,适合不想维护两套工具链、又接受「个人维护、无 roadmap」前提的用户。目录页:https://www.skillhub.cn/plugins/13520rygvv/dsh-bili-video;源码与完整工具表:https://github.com/13520rygvv/dsh-bili-video 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜