前言¶

在 DeepSeek Harness（DSH）里做学习或复盘时，常见做法是手动打开视频、暂停抄要点，或把链接丢给模型让它「概括一下」。前者费时间且结构不统一；后者往往拿不到完整逐字稿，长课、会议录像也很难拆成可检索的章节。

下面介绍维护者 YLL-KB 发布的技能包 dsh-video-to-notes（分类：工作流）。它把「下载 / 本地视频 → 语音转写 → 按场景写笔记」收成一条可在 Harness 里触发的 Skill，适合课程、讲座、教程、纪录片、会议和演讲等素材。

这是什么¶

dsh-video-to-notes 是一个 Opt-in 的 DSH 技能包（Skill bundle）：不包含独立运行时插件逻辑，实质内容是一个名为 video-to-notes 的 Skill，以及配套的转写、下载脚本与笔记模板。

• 维护者：YLL-KB
• 仓库：github.com/YLL-KB/dsh-video-to-notes
• 社区目录：skillhub.cn/plugins/YLL-KB/dsh-video-to-notes（独立社区站点，与 DeepSeek / 幻方无官方从属关系）
• 许可证：MIT

安装后，cordis.patch.yml 会插入一行 @deepseek-ai/dsh-skill-filesystem 配置，把包内的 skills/ 挂载为隔离的 Skill 提供方（includeDefaultRoots: false），不改动项目或用户自带的 Skill 根目录。

包内结构¶

Skill 与脚本大致如下（摘自 README）：

skills/video-to-notes/
├── SKILL.md                  skill instructions and routing description
├── scripts/transcribe.py     ffmpeg + Whisper speech-to-text
├── scripts/download_video.py yt-dlp network download
└── references/               note templates and the detailed workflow

模型选型、设备（CUDA / Apple MPS / CPU）、转写速度与笔记版式由 Skill 说明决定；你主要提供视频路径或 URL，以及偏好说明。

核心能力¶

经过上面的挂载方式，Harness 中的智能体可以按 Skill 流程完成四步：

1. 检测依赖 — 列出缺失的本机工具，并在你明确同意之前不会代为安装。
2. 获取视频 — 支持本地路径；若为 URL，在你确认输出目录后使用 yt-dlp 下载。
3. 转写 — 使用 Whisper，按场景使用默认参数（例如普通视频用 base、长视频用 turbo、中文可加 --language zh，可选 --strip-silence 与 --speed 加速）。
4. 生成笔记 — 语义分块、章节目录；长内容可附 Mermaid 知识图；用 ⭐ / 🔧 / ⚠️ 等标记重点；文末附速查卡；风格随内容类型（技术教程、课堂、演讲、纪录片等）调整。

环境与依赖¶

Skill 会驱动本机命令行工具，DSH 不会自动安装这些依赖。README 中的要求如下：

先做依赖检查，再跑转写，可以避免半途失败。Linux 用户可将 README 中的 brew 示例替换为发行版对应的包管理器或官方安装方式。

安装与启用¶

在 DSH 中执行官方安装命令（勿自行拼接 github:owner/repo 形式）：

dsh plugin --profile web add dsh-video-to-notes

安装完成后 重启 DSH。该包只应用一条 patch 行，不修改其他配置。

package.json 声明 Node 引擎为 ^22.19.0 || >=24.0.0，请与当前 DSH 运行环境一并核对。

典型用法¶

README 未给出固定 CLI 子命令；用法是在 Harness 对话中通过已挂载的 video-to-notes Skill 发起任务，例如：

• 提供本地视频文件路径，要求生成结构化学习笔记；
• 提供课程或会议录像 URL，在确认下载目录后拉取并转写；
• 说明内容类型（教程 / 课堂 / 演讲等）或语言偏好，由 Skill 选择 Whisper 与笔记模板。

智能体会调用 scripts/transcribe.py 与（如需）scripts/download_video.py，并参照 references/ 中的工作流与模板输出 Markdown 笔记。

适用场景与注意¶

适合谁：需要在 DSH 工作流里把长视频变成可复习、可检索笔记的开发者或学习者；素材包括课程、讲座、教程、纪录片、会议、演讲等。

权限与安全：插件与 Skill 以 当前 dsh 进程的用户权限 运行，会读写你指定的目录并可能访问网络（URL 下载）。安装前建议阅读仓库源码与 MIT 许可证，确认行为符合预期。

隐私与版权：转写稿与笔记可能含敏感信息，用完后请审阅并按需删除。从第三方平台下载视频须遵守该平台条款，建议仅用于个人学习。

结尾¶

dsh-video-to-notes 把「Whisper 转写 + 分场景笔记模板」封装成 DSH 可选技能包，不污染默认 Skill 根目录，依赖缺失时会先询问再安装。若你已在用 Harness 处理学习类任务，可以用它把「看视频」变成「留下结构化笔记」这一步。

• 目录页：https://www.skillhub.cn/plugins/YLL-KB/dsh-video-to-notes
• GitHub：https://github.com/YLL-KB/dsh-video-to-notes