前言¶
在 DeepSeek Harness（DSH）里做工作流时，常见需求是：用户一边在浏览器里看课程，一边希望 Agent 能持续感知「当前在看什么」，并把零散观看记录整理成可检索、可导出的学习材料。手工记标题、再自己去 B 站补简介和字幕，成本高，也很难按学科归档。
下面介绍的插件面向 Windows 桌面场景：定时读取前台浏览器或视频客户端窗口标题，用 LLM 判断是否有知识含量并按学科分类，再尽量从 B 站拉取简介、字幕、弹幕与评论做总结，最终生成分学科的 Word 学习手册和带 Mermaid 思维导图的总览文档。
这是什么¶
dsh-video-coursemap 是社区维护的 DSH 插件（维护者 linner1224），在 SkillHub 插件目录 中归类为「工作流」。一句话定位：视频课程知识地图 Agent——观察前台播放、识别课程、按学科归档并输出 Markdown + Mermaid 知识地图与 Word 学习手册。
源码与说明见 GitHub：linner1224/dsh-video-coursemap。插件以 MIT 许可证发布；安装前建议自行审阅源码与许可证。插件在 DSH 进程权限下运行，涉及窗口读取与网络抓取，部署环境需与此匹配。
核心功能¶
资料中明确的能力如下。
- 前台窗口轮询：默认每 15 秒轮询一次前台窗口（浏览器或视频客户端），识别视频标题并剥离平台后缀。
- 内容与学科判定：由 LLM 判断是否为「有知识含量」的内容（课程、教程、科普、纪录片、测评、知识分享等），并按学科分类。
- B 站内容补充：按标题反查 B 站视频，抓取简介、字幕、弹幕、评论用于总结；失败时自动降级为仅使用标题。
- 文档输出：每个学科生成
学习手册.docx；根目录生成课程总览.docx（含 Markdown 与 Mermaid 思维导图）；内部状态与 Markdown 源保存在.state/。 - Agent 工具：提供
course_map_status与course_map_scan两个工具，供 Harness 内查询状态或触发扫描类操作（具体参数以实现为准，见仓库文档）。
当前版本在 package.json 中为 0.2.0。
安装与启用¶
在已配置 DSH 桌面 profile 的环境中，使用 README 给出的安装命令（勿自行拼接其他形式的 dsh plugin add）：
dsh plugin --profile desktop add github:linner1224/dsh-video-coursemap
安装后可在插件配置中启用并调整轮询与输出目录。示例配置如下：
- id: dsh-video-coursemap
name: dsh-video-coursemap
config:
enabled: true
pollIntervalMs: 15000
stablePolls: 2
fetchContent: true
outputDir: null # null → <用户目录>/课程知识地图
说明各字段含义：
pollIntervalMs：轮询间隔，默认 15000 毫秒。stablePolls：标题稳定判定所需的连续轮询次数，默认 2。fetchContent：是否尝试抓取 B 站简介、字幕等；关闭则更多依赖标题。outputDir：输出根目录；为null时使用用户目录下的「课程知识地图」文件夹。
典型用法与输出结构¶
启用插件并保持目标浏览器或视频客户端处于前台后，插件会在后台按间隔识别当前视频并累积分类结果。经过上面的步骤，可在配置指定的输出目录（或默认 <用户目录>/课程知识地图）查看产物：
<outputDir>/<学科>/学习手册.docx：该学科下的分册手册。<outputDir>/课程总览.docx：全部学科的总览。<outputDir>/.state/：内部状态与 Markdown 源文件，便于排查或二次处理。
在 Agent 对话中，可调用 course_map_status 了解当前映射状态，或通过 course_map_scan 配合工作流做扫描（以仓库 README 与实现为准）。
适用场景与限制¶
适合谁
- 主要在 Windows 上通过浏览器或客户端前台看 B 站等平台课程，希望自动按学科沉淀 Word 手册与思维导图总览的 DSH 用户。
- 希望把「观看行为」接入 Harness 工作流，而不是每次手动复制标题的用户。
务必注意的限制（来自官方 README）
- 仅支持 Windows：前台窗口读取依赖 PowerShell 与
user32.dll，其他系统无法使用同一机制。 - 必须前台播放：只有当前前台窗口是浏览器或视频客户端时才会识别；后台或最小化播放无法检测。
- B 站相关：B 站 AI 总结接口需登录，文档标明暂不可用；评论匿名接口封顶 3 条，总结深度可能受限于抓取结果。
DSH 生态理念是「一切皆插件」；SkillHub 为社区目录站点，与 DeepSeek、幻方无官方从属关系，本文仅作插件能力说明，不构成官方背书。
结尾¶
dsh-video-coursemap 把「前台正在看的视频课」变成按学科归档的 Word 手册与 Mermaid 知识地图总览，并暴露 Agent 工具供工作流查询与扫描。若你的场景符合 Windows 前台观看与 B 站补充资料这两条前提，可按上文命令安装并在启用前核对源码与配置。
