dsh-course-subtitles
把视频课程的字幕抓下来 → 重排成完整句子 → 逐句中英对照翻译 → 自动分章节 → 一课一篇写进飞书文档。
一个 DeepSeek Harness（dsh）插件。装好以后，在 DSH 对话里说一句「帮我跑一下课程字幕」就行。
适合谁用：想把 DeepLearning.AI / YouTube / B 站上的课程变成可搜索、带中英对照的学习笔记的人。
它到底做了什么
最终你得到一篇飞书文档，长这样：
# 01 Welcome 欢迎 ← 课程标题（自动中文翻译）
第 1 周 · 视频时长 4:32 · 生成时间 2026-01-01 ← 元信息
## What is Generative AI? 什么是生成式AI？ ← 自动生成的章节标题（中英对照）
Generative AI is a general purpose technology. ← 英文原句
生成式 AI 是一种通用技术。 ← 中文翻译
...
另外还可以把课程首页的目录导出成一篇大纲文档 —— 不调用任何模型，零 token 花费。
支持哪些平台
| 平台 | 链接形式 | 需要什么 |
|---|---|---|
| DeepLearning.AI | learn.deeplearning.ai/courses/... |
无需登录，官方字幕 |
| YouTube | youtube.com/watch?v=...、youtu.be/...、播放列表 |
能访问 YouTube（国内需要本地代理，插件会自动识别） |
| Bilibili | bilibili.com/video/BV... |
UP 主上传过字幕轨（AI 字幕也算） |
| Coursera | coursera.org/learn/... |
需要登录 Cookie（实验性支持） |
快速开始
第 1 步：准备三样东西
- Node.js ≥ 18（
node -v检查） - 一个飞书自建应用（用来写文档）
- 去 飞书开放平台 创建「企业自建应用」
- 在「权限管理」里开通：
wiki:wiki、docx:document、drive:drive - 发布版本，拿到 App ID 和 App Secret
- ⚠️ 关键一步：打开你要写入的知识库 → 设置 → 成员管理 → 添加应用，把这个应用加进去，否则会报权限错误
- 一个 LLM API Key：DeepSeek 官方（
https://api.deepseek.com）或任何 OpenAI 兼容服务都行
第 2 步：安装插件
dsh plugin --profile web add github:fengchang618gmail/dsh-course-subtitles
装好后重启 DSH（退出后重新运行 dsh --profile web）。
第 3 步：配置密钥
在启动 DSH 的终端里设置环境变量，然后正常启动 DSH 即可：
# macOS / Linux
export FEISHU_APP_ID=cli_xxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxxxxx
export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxx
# Windows PowerShell
$env:FEISHU_APP_ID="cli_xxxxxxxxxxxx"
$env:FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"
$env:DEEPSEEK_API_KEY="sk-xxxxxxxxxxxx"
密钥只在运行时从环境里读取，不会写进任何代码或仓库。
第 4 步：在对话里使用
重启后直接对 agent 说，把课程链接和飞书目录放进对话里就行，不用改任何设置文件：
帮我跑一下课程字幕 https://learn.deeplearning.ai/courses/generative-ai-for-everyone，写到飞书 https://你的租户.feishu.cn/wiki/xxxxxxxxxxxxxxxxxxxx
agent 会调用这几个工具（通常你不用关心名字）：
| 工具 | 作用 |
|---|---|
course_subtitles_run |
抓字幕 → 翻译 → 分章节 → 写飞书，返回 run id |
course_outline_run |
只导出课程大纲（零 token） |
course_subtitles_status |
查看运行进度和产出文档链接 |
course_proxy_status |
网络自检：本机代理能不能出网、yt-dlp 在不在 |
course_llm_status |
列出会依次尝试的 LLM 凭据 |
关于密钥：仓库里没有任何密钥
这个项目不包含、不需要、也不接受硬编码的 API Key。
另外：如果首选的 LLM key 挂了（余额不足、被限流），插件会自动依次尝试本机已有的其它凭据，不用手动切换。
常见问题
Q：报飞书权限错误 / 403？
这个应用必须被加进目标知识库：知识库 → 设置 → 成员管理 → 添加应用。同时确认已开通 wiki:wiki、docx:document、drive:drive 权限并发布了版本。
Q：YouTube 一直失败？ 国内直连 YouTube 一定失败，需要本地代理（v2rayN / Clash 等，开着就行，插件会自动识别）。还是不行的话，对 agent 说「检查一下网络代理」，它会告诉你具体卡在哪。
Q：跑一遍要花多少钱？ 一个 32 课的课程大约 16 万 token，DeepSeek 上约 ¥1–2。重跑不会重复花钱 —— 字幕、断句、翻译、章节都做了磁盘缓存，只补缺失的部分。大纲导出完全不花钱。
Q：会不会把一句话从中间切断？ 不会。字幕片段会先合并成完整句子，段落始终由原始片段程序化拼接，不增字、不删字；章节标题也只允许落在句子边界上。
技术细节、已知限制、命令行用法和自测脚本，见 docs/REFERENCE.md。
No comments yet. Be the first to write one.