dsh-video-coursemap
视频课程知识地图 Agent 2.0：定时观察浏览器前台窗口实时检测 B 站视频课程，按关键词自动分类学科并抓取视频简介/字幕/弹幕/评论做知识总结，输出 Word 知识地图与学习手册
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:linner1224/dsh-video-coursemap#9daf368cc945420835af1c8faca7cccd5f8736e3Video Coursemap 以 dsh-video-coursemap 发布，当前版本为 2.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个纯 DSH 插件：实时检测网页端 B 站视频课程 → 按关键词自动学科分类 → 抓取视频内容/弹幕/评论做知识总结 → 输出 Word 知识地图与学习手册。无需任何运行时依赖，无需修改 DSH 核心。
dsh plugin add "https://github.com/linner1224/dsh-video-coursemap/releases/download/v2.0.0/dsh-video-coursemap-2.0.0.tgz"
直接从 GitHub Release 下载打包好的产物，全程不调用 git，也不需要 npm 账号或构建工具。这是兼容性最好的方式，任何装了 DSH 的机器都能成功。
在市场里搜索 dsh-video-coursemap 一键安装。市场能否免 git 安装，取决于索引里这条记录是否已带上 tarball 映射 —— 详见下方《装不上怎么排查》。
dsh plugin add github:linner1224/dsh-video-coursemap
此方式要求本机已安装 git 且在 PATH 中，并且能访问 github.com。缺任意一项都会失败。
| 现象 | 原因 | 解决 |
|---|---|---|
ERR_PNPM_GIT_RESOLVE_FAILED、git ls-remote failed: 'git' 不是内部或外部命令 | 本机没装 git，或 git 不在 PATH | 安装 Git for Windows 并重启 DSH，或改用方式一 |
ETIMEDOUT、连接 github.com 超时 | 网络无法访问 GitHub | 给 git/pnpm 配代理，或改用方式一 |
市场里点安装失败，但手动 dsh plugin add 能装 | 市场索引尚未收录本插件的 tarball 映射，退化成了裸 github: 地址（必须走 git） | 改用方式一，或等索引刷新 |
装完 course_map_* 工具不出现 | 插件未被加载 | 重启 DSH（DSH 对插件模块做缓存，不会热重载） |
| 能装、能跑，但生成 Word 失败 | 缺少 Python 环境（scripts/md2docx.py 依赖本机 python） | 安装 Python，或先关闭 Word 输出 |
市场的安装目标由 installTargetFor 决定，优先级为：
npm 包（发布到 npm registry）.tgz 资产（tarball 映射）github:owner/repo ← 要求用户本机有 git本插件未发布到 npm，因此必须挂 Release 资产，市场才会生成免 git 的安装命令。发版步骤：
pnpm pack --pack-destination <输出目录>，得到 dsh-video-coursemap-<版本>.tgzpackage.json 的 version 保持一致（如 v2.0.0），把 .tgz 作为二进制资产上传awesome-dsh-plugin.com，其 build-site 工作流每天 10:23（北京时间） 运行）$j = Invoke-RestMethod "https://awesome-dsh-plugin.com/plugins.json"
($j.plugins | Where-Object { $_.name -eq "dsh-video-coursemap" }) |
Select-Object npm, version, tarball, install
tarball 字段返回 Release 的 .tgz 地址即表示成功，此时市场按钮会走免 git 路径。
注意：package.json 里的 files 字段决定打包内容，增删文件时需同步更新；private 字段会阻止发布到 npm（不影响 Release 资产）。
stablePolls 次（默认 2 次）稳定确认后自动生成知识地图；seen 去重表）；<输出目录>（默认 C:\Users\<你>\课程知识地图，可用 outputDir 配置）
├── 课程总览.docx # 全局知识地图（学科总览 + 学科列表）
├── <学科A>/
│ └── 学习手册.docx # 该学科所有视频的知识总结
├── <学科B>/
│ └── 学习手册.docx
└── .state/ # 内部状态（state.json、manuals/*.md 源、poll.log 调试日志）
| 配置 | 默认 | 说明 |
|---|---|---|
enabled | true | 总开关 |
pollIntervalMs | 15000 | 轮询间隔（毫秒） |
stablePolls | 2 | 连续 N 次观察到同一新标题才处理（防标签切换抖动） |
outputDir | null | 输出目录，null → <用户目录>/课程知识地图 |
provider / model | null | LLM 提供方/模型，null → 跟随 DSH 默认模型 |
maxTokens | 4096 | 生成知识地图的最大 token |
titleMinLen | 4 | 标题最小长度（过滤空/短标题） |
fetchContent | true | 是否抓取 B 站简介/字幕/弹幕/评论（失败自动降级为仅标题总结） |
| 工具 | 作用 |
|---|---|
course_map_status | 查看 Agent 状态：是否启用、输出目录、已分类学科与视频数、最近观察标题 |
course_map_scan | 立即执行一次前台窗口观察与知识地图生成（可传 title 直接指定视频标题，便于测试） |
-412）；通过 /x/frontend/finger/spi 取 buvid3 提升稳定性。sort=2 热评、ps 上限 20）；AI 总结接口 /x/web-interface/view/conclusion/get 返回 -403 需登录，不可用。subtitle 为空），字幕是尽力抓取、失败静默降级。dsh-video-coursemap/
├── package.json # dsh.bundle.patch → cordis.patch.yml
├── cordis.patch.yml # 把插件行 insert 进 profile 插件清单
├── lib/index.js # Agent 主逻辑（轮询/分类/抓取/生成/Word 转换/工具）
└── scripts/md2docx.py # Markdown → Word（含 mermaid mindmap → 原生分级大纲）