前言¶
DeepSeek Harness（DSH）的日常使用常常需要跟踪某个频道或关键词的最新内容，但 YouTube 每天更新量很大，手动浏览效率有限。传统做法是定时打开网页或用脚本抓取，但容易受限流、改版影响，且难以直接给模型可读的上下文。dsh-youtube-scroll 插件为这类场景提供了一套标准化的“值班流程”：按频道 RSS 和关键词拉取候选，让模型逐条读取字幕、必要时调用本机 Whisper 转写、配合缩图判断，最终输出一份繁体中文日报。它复用了 dsh-bili-scroll 的架构，但针对 YouTube 的特性做了适配，适合需要在本地以 headless 模式持续刷内容的开发者。
是什么¶
dsh-youtube-scroll 是一个 DSH 插件，运行在本地、仅使用只读 YouTube 工具，输出繁体中文日报到 $DSH_HOME/yt-duty/out/<日期>.md，每条以 ### <videoId> 开头。它由 hstony7462 维护，采用 MIT 许可证，属于“联网工具”类别。插件通过 stdio MCP 暴露六只只读工具，支持频道 RSS、关键词搜索、视频详情、字幕、本机 Whisper 转写与缩图，不涉及评论、上传或 OAuth 等写操作。
核心功能¶
- 按频道与关键词筛选：支持按频道 RSS（免 key）和关键词搜索（有 API key 走官方 API，无 key 解析搜索页），默认取最近 7 天候选。
- 逐条读字幕判断：优先读取字幕原文再决定是否纳入日报；无字幕的影片默认跳过，并在报告末尾统计跳过条数。
- 繁体中文日报：输出到
$DSH_HOME/yt-duty/out/<日期>.md，每条以### <videoId>开头，用于后续统计与去重。 - 峰谷时段自动跑：提供两个每日窗口（中午 12:00–14:00、夜间 18:00–次日 09:00），可在设置页分别开启或关闭。
- 只读工具集合：通过 MCP 暴露 yt_channel、yt_search、yt_video、yt_transcript、yt_asr、yt_frames 六只只读工具，不注册写接口。
- 单条链接深入分析：在设置页贴入链接后，用 headless 模式调用 yt_transcript、yt_asr、yt_frames，生成
notes/<videoId>.md，包含时间轴、核心概念、关键数字、名词表、局限与原文引用。 - SRT 导出：同一链接可通过
/api/yt-duty/srt?videoId=…下载完整 SRT 字幕。 - 跨日去重：挑过的 videoId 写入
seen.json（保留 180 天），下一轮提示词会列出“最近 30 天已挑过、不要重复”。 - API 配额保护：每次搜索按约 100 units 估算，超过每日上限时自动裁剪关键词；设置页与提示词中会显示用量。
- 通知与清理：跑完或失败时发送 macOS 系统通知（默认开启）；设置页显示日报/笔记数量，可一键清理 90 天前的日报与 seen。
- API key 测试：设置页提供“测试 API key”按钮，直接调用
videos.list验证。
安装与启用¶
从 npm 安装（最简短）：
dsh plugin --profile web add dsh-youtube-scroll
桌面版可使用 --profile desktop。
从 GitHub 安装（可钉版本）：
dsh plugin --profile web add github:hstony7462/dsh-youtube-scroll#v1.0.2
安装完成后重启 DSH 并刷新页面，设置页会出现“设置 → YouTube 刷”。
典型用法¶
- 在设置页填写“关注频道”和“搜索关键词”，每行一项。
- 打开“峰谷时段自动刷”总开关，并决定是否开启“中午谷时”与“夜間谷時”。
- 设置“每天最多挑幾條”，0 表示不自动跑，但可手动触发。
- 填写可选的 YouTube API key 以获得更稳定的搜索结果；不填则使用免 key 搜索页。
- 选择日报细节级别：
full完整、brief薄版、off仅标题行。 - 如需本机转写，在设置页安装转写依赖；首次运行会下载 Whisper 模型。
- 在设置页“工作区”填入你常用的 AGENTS.md 路径，让 headless 一轮读取人设。
- 手动点击“現在跑一輪”或等待峰谷时段自动触发。
适用场景与注意¶
适合需要定期整理 YouTube 内容、以模型为判断主体的开发者与知识工作者。插件以当前 DSH 进程的权限运行，安装前建议阅读源码与许可证（MIT），并在本地验证 API key 与 Whisper 依赖是否正常。
短结尾¶
dsh-youtube-scroll 通过标准化的值班流程，让模型逐条读取字幕与缩图，输出可读的繁体中文日报，同时提供单条深入分析、SRT 导出、跨日去重与 API 配额保护。更多细节与源码可访问插件目录页与 GitHub 仓库。
