前言¶
在 DeepSeek Harness（DSH）里处理 B 站视频时，常见做法是直接把链接交给模型。模型往往只能复述标题、简介，或凭空编造，因为拿不到画面和逐字稿。本插件由社区维护者 Aurum807 发布，归类为联网工具；它先把视频变成可总结的素材（时间轴转写 + 关键帧拼图），再按固定方法论产出中文总结，而不是让模型「猜」视频讲了什么。
这是什么¶
dsh-bilibili-video-summary 是面向 DeepSeek Harness 的 bundle 插件。对话里只发一条 B 站（或 yt-dlp 支持的站点）视频链接、不提任何要求时，会自动开始总结；若用户已明确意图（例如「总结这个」「讲了什么」），则按用户说法执行，插件不会强行注入自己的流程。
- 目录页：skillhub.cn 插件页
- 源码与文档：GitHub — Aurum807/dsh-bilibili-video-summary
- 当前 npm 包版本：0.2.1（见仓库
package.json） - 开源协议：MIT
核心能力¶
素材流水线¶
插件补两样模型原本拿不到的内容：
- 转写稿——优先 UP 主上传的字幕；没有则语音识别，带时间轴，便于回查原话。
- 画面——按固定间隔抽关键帧，拼成 4×4「接触印相纸」。README 举例：约 20 分钟视频，逐张读图需 190 次以上，读拼图约 12 次即可通览全片结构，具体参数再回读单帧核对。
转写引擎三级回退（默认无需配置）：
- 站方字幕（最快、最准）
- 本机
faster-whisper（pip install faster-whisper，默认small、CPU、int8；README 称 20 分钟视频约 2 分钟出稿） - 环境变量
VIDEOSUM_ASR_CMD指向自定义「音频 → 带时间戳文本」命令，{audio}、{out}为占位符
三者皆无时仍产出画面素材，总结依赖画面核对，细节会弱一些。
注册到 DSH 的入口¶
安装并重启 DSH 后，插件会注册：
- 工具：
video_material - Skill：
bilibili-video-summary
总结方法论（写在 skill 里）¶
与「让模型自己看着办」相比，插件固化了几条规则，例如：先给一句话结论再展开；两遍读画面（先拼图通读、再单帧核对参数）；型号、人名、数字不以 ASR 为准、需回画面核对；静止文档类以画面文字为准；不添加视频外信息。这些约束意在减少幻觉与主线被细节淹没。
安装与依赖¶
需要先安装 DSH。插件要求 Node >= 22，DSH 版本 >= 0.2.0-rc.2 且 < 0.3.0-0（见 package.json 的 engines 与 peerDependencies）。
官方安装方式：
# 从 npm 安装
dsh plugin --profile web add dsh-bilibili-video-summary
# 本地开发：直接指向本目录
dsh plugin --profile web add link:/绝对路径/dsh-bilibili-video-summary
装好后重启 DSH。
外部命令行依赖¶
| 依赖 | 用途 | 缺失时 |
|---|---|---|
| yt-dlp | 下载视频/音频、抓字幕 | 完全不可用 |
| ffmpeg（含 ffprobe） | 抽帧、分离音轨 | 仅有转写稿方向受限，无画面 |
| faster-whisper（可选） | 无站方字幕时 ASR | 退化为「只有画面素材」 |
插件会自行探测依赖，找不到时给出安装提示。可用下面命令查看实际命中的转写级别与工具版本：
node lib/video-material.mjs doctor
Windows 下若 DSH 进程拿不到交互式 shell 的 PATH，可通过环境变量指定可执行文件路径，例如 VIDEOSUM_YTDLP、VIDEOSUM_FFMPEG、VIDEOSUM_FFPROBE；仅存在 Python 模块形式的 yt-dlp 时，可设 VIDEOSUM_PYLIBS 指向含 yt_dlp 的目录（插件会对候选执行 --version 验证）。
典型用法¶
对话里（最常见）¶
只粘贴一条链接即可，例如：
https://www.bilibili.com/video/BV1xx411c7mD/
助手侧会按流程取素材、读拼图、回读关键帧，再给出结论先行的中文总结。若消息里有多条链接，只会处理第一条；需逐条处理时请用文字说明。
工具与命令行¶
模型可调用：
video_material({ action: "probe", url })— 探测是否为目标视频video_material({ action: "material", url, every: 3 })— 准备全部素材
不经过模型、手动跑流水线：
node lib/video-material.mjs doctor
node lib/video-material.mjs probe --url <URL>
node lib/video-material.mjs material --url <URL> --every 3
常用参数（节选）：--every 默认 3（抽帧间隔秒）；--width 默认 640；--max-frames 默认 192；--audio-only、--no-sheets、--no-asr 可跳过部分步骤。完整表格见仓库 README。
产物目录¶
默认输出到 ./vidsum_out/<视频标题>/，包含 meta.json、transcript.txt、transcript.srt、frames/、sheets/ 及对应 *_index.txt 索引。
适用场景与注意¶
适合谁：已在用 DSH、需要把 B 站（及 yt-dlp 支持站点）长视频变成可读总结的开发者或重度用户；愿意在本机安装 yt-dlp、ffmpeg，并按需配置 cookies 或 ASR。
权限与安全：插件以当前 DSH 进程权限运行，会下载媒体、读写工作区；安装前请阅读源码与 MIT 许可证，自行评估是否接入生产环境。社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，属社区生态分发，而非官方应用商店。
登录与 cookies：高画质与部分字幕需登录。插件会读工作区 cookies/bilibili.txt（Netscape 格式）或 --cookies 指定文件；Cookie 会过期需重新导出。常见错误如 HTTP 412（缺 cookies）、本机代理导致下载 HTTP 567（README 说明插件对 B 站域名追加 NO_PROXY）等，处理表见 GitHub README「常见故障」。
已知限制：抽帧为等间隔而非智能选帧；转写质量取决于引擎与音质，插件侧重用画面校正错误；索引文件表头为 ASCII，避免用 GBK 误读表头。
结尾¶
dsh-bilibili-video-summary 把「只有链接」变成「转写 + 关键帧拼图 + 固定总结流程」，解决模型拿不到视频内容的问题。若你已在用 DSH 处理 B 站资料，可按上文 npm 命令安装，用 doctor 确认依赖后，在对话里单发链接试用。
- 插件目录页：https://www.skillhub.cn/plugins/Aurum807/dsh-bilibili-video-summary
- GitHub：https://github.com/Aurum807/dsh-bilibili-video-summary
