前言¶
在 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从原流取帧。
安装与启用¶
环境要求¶
- Python 3.10+（或
uv）和ffmpeg：Python 供 B 站半边使用；无ffmpeg时「看视频」半边不可用，B 站半边仍可用。 - DSH 版本：
dsh >= 0.1.7-rc.1（package.json的engines.dsh）；版本过旧时设置里可能看不到「看视频」，内核会静默跳过插件。 - Node：
>=22（同上engines）。 - 可选：
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 。
