前言¶
用 Agent 处理长视频时，常见做法是手动复制链接、再单独跑字幕或转写脚本，最后自己排版成笔记。步骤分散，平台和登录方式也不统一。DeepSeek Harness（DSH）支持通过插件把 skill 注册进运行时；dsh-video-notes 把上游 skill bilibili-douyin-notes 打成 DSH 组合包，装好后在对话里给出视频链接即可走同一套流程：抓字幕或本地语音识别、截取重点画面、按模板输出 .md，且不依赖付费 API。
下面介绍插件定位、能力与安装用法；功能细节与各平台说明以上游仓库为准。
这是什么¶
dsh-video-notes 是维护者 lucky-Luor 发布的 DSH 插件（当前 package 版本 0.1.0，MIT 许可）。它解决的是：在已运行的 DSH 里，把 B 站、抖音、YouTube、小红书等链接转成结构化 Markdown 课堂笔记，免登录可用（部分平台可选配置凭据以提升成功率）。
插件本体是外壳：启动时读取包内 skill/bilibili-douyin-notes/SKILL.md，通过 DSH 官方的 ctx.skills.register() 注册 skill，并带上 skill 目录作为 resourceBase，供模型拼出 scripts/*.py 等真实路径。实现只使用 Node 内置模块，无 @deepseek-ai/* 依赖、无构建步骤，从 GitHub 安装时一般不需要给 allowBuilds 授权。
核心功能¶
依据 README 与 package 描述，已核实能力包括：
- 多平台：B 站、抖音、YouTube、小红书视频链接。
- 字幕与语音：字幕抓取；本地语音识别（ASR，requirements 中与 Whisper 等相关依赖见 skill 内注释）。
- 笔记产出：重点截图、笔记模板、质量门禁，输出课堂笔记 Markdown。
- 使用成本：README 写明免登录可用、不调任何付费 API。
- 上游关系：业务逻辑与模板在上游 bilibili-douyin-notes；本仓库含同步副本，
skill.lock.json记录对应上游 commit。请勿直接改skill/下文件，应改上游再同步。
YouTube 场景 README 建议另外安装 deno（yt-dlp 解 JS 挑战需要）。抖音签名脚本 scripts/abogus.py（GPLv3）不随包分发，由 ensure_abogus.py 在首次使用时按需下载。
安装与启用¶
前置条件：Node.js ≥ 20、Python ≥ 3.10、本机已能运行 DSH（npx @deepseek-ai/dsh）。
1、把插件装进 DSH 的 web profile（其他 profile 将 web 换成对应名称）：
npx -y @deepseek-ai/dsh plugin --profile web add github:lucky-Luor/dsh-video-notes
需要锁定版本时：
npx -y @deepseek-ai/dsh plugin --profile web add github:lucky-Luor/dsh-video-notes#<tag 或 commit>
2、安装 Python 依赖（各平台所需依赖见 requirements 文件内注释）：
pip install -r https://raw.githubusercontent.com/lucky-Luor/dsh-video-notes/main/skill/bilibili-douyin-notes/requirements.txt
3、重启 profile 使插件生效：
npx -y @deepseek-ai/dsh web
确认已加载：执行 npx -y @deepseek-ai/dsh --profile web --dump-config，输出中应能看到 dsh-video-notes 这一层。
卸载：
npx -y @deepseek-ai/dsh plugin --profile web remove dsh-video-notes
配置与凭据¶
skill 的配置文件 config.json（B 站 SESSDATA、小红书 cookie、ASR 参数等，字段见 config.example.json）位于 skill 目录，一般是 Agent 加载 skill 时给出的 Base directory，典型路径为：
$DSH_HOME/profiles/<profile>/node_modules/dsh-video-notes/skill/bilibili-douyin-notes/
（$DSH_HOME 默认为 ~/.dsh。）
B 站扫码登录写入同一目录：
python "<skill目录>/scripts/bili_fetch.py" --login
已知限制：该目录在 profile 的 node_modules 内，插件升级、重装或卸载后 config.json 会丢失。升级前请备份 config.json，升级后放回原处，或重新 --login 与填写配置。config.json 含登录凭据，请勿分享。
典型用法¶
装好后，在 DSH 里对 Agent 说明意图并附上链接即可，README 示例为：
帮我把这个视频做成课堂笔记：https://www.bilibili.com/video/BVxxxx
Agent 会按 skill 流程抓字幕或语音识别、截取重点画面并生成课堂笔记 .md。笔记样式与各平台差异见上游仓库文档。
适用场景与注意¶
适合谁：已在用 DSH、希望用自然语言驱动「视频 → Markdown 课堂笔记」的开发者或内容整理者；需要本地 Python 环境与可选平台凭据。
运行与信任：插件与 skill 脚本以当前 DSH 进程权限在本机执行，会访问网络抓取视频与字幕、读写配置与输出文件。安装前请阅读 GitHub 仓库 与上游 skill 源码及许可证（插件 MIT；部分组件另有许可说明）。
生态说明：DSH 社区插件目录托管于独立站点 skillhub.cn，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-video-notes 把多平台视频笔记 skill 接入 DSH：一句对话加链接，走字幕/ASR 与模板化输出，避免单独维护多套脚本。目录页：https://www.skillhub.cn/plugins/lucky-Luor/dsh-video-notes；源码与安装说明：https://github.com/lucky-Luor/dsh-video-notes。
