前言¶

做 DSH 插件开发时，一个常见需求是把外部内容沉淀成可用文本。比如想把 B 站的教学视频做成笔记，传统做法是：手动录屏或下载，再用 whisper 等工具转写，最后人工整理成 Markdown，还常常漏掉时间轴和术语对照。整个过程要同时维护下载器、语音模型和编辑器，还要填各种 API key。

下面介绍的 dsh-video-notes 把这件事收拢成插件里的一个工具。装上后，在 DSH 对话框里直接调用 video_to_notes，下载、转写、整理、落盘一次完成。

这是什么¶

dsh-video-notes 是一个 DeepSeek Harness 插件，维护者为 5530-ok，仓库地址 https://github.com/5530-ok/5530 。它把「B 站视频 → Markdown 笔记」封装为 video_to_notes 工具，供 DSH 对话框里的模型调用。

解决的问题是：免去用户手动拼接下载、转写、整理三个环节，全程不填 API key，笔记生成用的是 DSH 自带的 LLM。

核心功能¶

一次调用完成四步：

1. yt-dlp 下载 B 站视频（免登录最高 1080p，支持合集分 P）
2. ffmpeg 抽音轨（16 kHz 单声道）
3. whisper.cpp 本地转写（中文）
4. DSH 自带 LLM 把转写稿整理成结构化 Markdown 笔记

生成的笔记默认同时转成 PDF，用本机 Edge/Chrome 无头打印渲染，输出与 .md 同目录同名的 .pdf。笔记默认落盘到桌面 宋浩高数笔记 目录，可在插件设置里改。

插件提供两个工具：

• video_to_notes — 视频转笔记，返回笔记全文并落盘 .md + .pdf
• note_to_pdf — 只把已有笔记转成 PDF

安装与启用¶

从插件市场安装¶

插件 README 注明「上架后」可从插件市场安装，在 DSH 的插件市场里搜索 dsh-video-notes 一键安装。

从 GitHub 源码安装¶

安装脚本 install-dsh-plugin.mjs 位于 DSH 的 dsh 目录（app.asar\dsh\ 下），它会走 dsh plugin --profile desktop add <spec> 把插件装进 desktop profile。命令如下：

$env:ELECTRON_RUN_AS_NODE = "1"
& "C:\...\DeepSeek Harness.exe" install-dsh-plugin.mjs add "github:5530-ok/5530"

本地目录安装¶

把整个 dsh-video-notes 文件夹（含 lib/、package.json、cordis.patch.yml）放到目标电脑上：

$env:ELECTRON_RUN_AS_NODE = "1"
& "C:\...\DeepSeek Harness.exe" install-dsh-plugin.mjs add "file:///C:/path/to/dsh-video-notes"

装完后需要手动把 dsh-video-notes 加进 profile 的 dsh.profile.bundles，或在 DSH 界面里按一次刷新按钮，插件才会加载。

依赖首次自动下载¶

插件会自动检测四个工具，本机没有时下载到数据目录 ~/.dsh/video-notes/（可在设置里改）。首次使用要花几分钟下载模型和二进制，之后复用。

典型用法¶

把一个 B 站视频（含分 P）转成笔记：

video_to_notes(url="https://www.bilibili.com/video/BVxxxx/?p=3")

返回笔记全文，并落盘一份 .md 文件 + 一份同目录同名的 .pdf 文件。

只把已有笔记转 PDF：

note_to_pdf(mdPath="C:\\Users\\...\\笔记.md")

适用场景与注意¶

适合需要批量把 B 站教学视频转成结构化笔记、又希望在 DSH 里直接完成的人。笔记结构包含视频信息表、一句话总结、带时间戳分节、易错点、术语中英对照、自测题、时间轴和衔接，适合复习和检索。

使用前注意几点：

• 插件以当前 dsh 进程权限运行，能读写本机文件和网络，安装前应先检查源码与许可证（本项目为 MIT）。
• 依赖在首次使用时按需下载，whisper 模型约 547 MB，网络环境差时耗时较长。
• keepVideo 默认 false，转写完即删除下载的视频与音轨；需要留存时在设置里改。
• 笔记生成依赖 DSH 自带 LLM，默认 provider 为 deepseek-official、model 为 deepseek-flash、temperature 为 0.3，可按需调整。
• 插件需要 DSH >=0.2.0-rc.1，运行时 Node 版本要求 >=20。

结尾¶

dsh-video-notes 的价值在于把「下载、转写、整理、导出」四步压进一次工具调用，并复用 DSH 自带模型，省去 API key 和多个外部服务的拼接。如果你的场景正是 B 站视频做笔记，可以直接从 GitHub 源码安装试用。

• 目录页：https://www.skillhub.cn/plugins/5530-ok/5530
• GitHub：https://github.com/5530-ok/5530