前言¶
用 DeepSeek Harness(DSH)做技术调研的人大概有过这种体验:想找一段讲某个主题的高质量英文视频,得切到浏览器,在 Hacker News 里翻旧帖、点进 YouTube、再回头确认推荐理由。视频和讨论分开在两个站点,窗口切来切去。
chow651 维护的 DSH 插件 dsh-hackertube 就是想解决这件事:把 Hacker News 二十年间反复推荐的技术视频搬进 DSH 面板,播放器、HN 讨论、相关推荐都在同一个界面里,中文标题与摘要随装随有。对 agent 来说,插件还注册了一个检索工具,不打开面板也能查这个视频库。
这是什么¶
dsh-hackertube 是一个 DeepSeek Harness 插件,由 chow651 维护,分类属于联网工具。它把 Andrej Karpathy 的 HackerTube 数据导出(6454 个视频)接入面板,让用户在 DSH 界面内浏览、播放这些视频,并附带 HN 讨论与 AI 问答。插件是非官方项目,与 Andrej Karpathy、Hacker News、YouTube 均无隶属关系。
整个服务的底座是一份公开数据导出,不是插件实时抓取:
- 数据集来自 HackerTube 站点的官方导出,17.8 MB,导出于 2026 年 10 月 31 日。
- 插件用 Node 内置 zlib 解压这份数据,运行时不引入任何 npm 依赖。
- 原站本身可以直接访问,插件的差异在于免窗口切换,以及标题、分类、摘要、评论的完整中文支持。
分类与浏览¶
6454 个视频按主题归入 16 个大类,大类下细分为 150 个二级分类,按 HN 推荐力度排序。几个大类的量级:艺术、喜剧、音乐与电影 1344 个,计算机历史与文化 1026 个,政治、历史与社会 1018 个。一个视频可同时属于多个大类,所以各大类的视频数之和大于 6454。
首页首次加载 60 条,滚动时分批追加。详情页包含播放器、该视频在 HN 上的讨论,以及右侧相关推荐;右侧另有 AI 问答页,会把当前播放位置前后三分钟的字幕片段一并交给模型,因此可以问某一段的具体内容。喜欢、稍后看与播放历史记录在宿主侧,清除浏览器数据不会丢失。
列表上有一组快捷键:
| 按键 | 作用 |
|---|---|
/ |
聚焦搜索框 |
j k |
在卡片间上下移动 |
Enter |
打开当前卡片 |
l |
标记喜欢 |
w |
加入稍后看 |
h |
返回首页 |
? |
显示快捷键一览 |
Esc |
关闭浮层 |
安装与启用¶
需要先装好 DeepSeek Harness 本体。README 给了三种安装方式。最省事的是把下面这段直接发给 DSH 里的 agent,让它自己完成安装、启用和核对:
安装并启用 HackerTube 插件:plugin_manager install_bundle target=dsh-hackertube。
npm 上取不到就改用 target=github:chow651/dsh-hackertube。
装完确认插件列表里 dsh-hackertube 已启用,并提醒我刷新页面。
用插件管理器安装,包已发布到 npm:
plugin_manager install_bundle target=dsh-hackertube
npm 上没有时可以从 Git 仓库安装,宿主如何解析安装参数取决于版本:
plugin_manager install_bundle target=github:chow651/dsh-hackertube
也可以手动装包:
npm install dsh-hackertube
pnpm add dsh-hackertube
手动安装要注意一件事:DSH 从 profile 目录加载插件,在普通项目目录里安装不会生效。需要在 profile 目录下安装,把包名加入它的 dsh.profile.bundles 数组,然后重启 DSH。上面那条 plugin_manager 命令会自动完成这三步,只有写脚本或做批量部署时才需要手动走一遍。
安装后在插件列表中启用 dsh-hackertube 并刷新页面。无需额外配置,无需 API key,也不需要在安装前预取任何数据。
给 agent 用的工具¶
插件注册了一个工具 hackertube_search。装了插件后,不打开面板,agent 在对话里也能检索这个视频库。
调用方式:
hackertube_search({ query: "Raft 共识算法", limit: 5 })
参数有三个:query 是检索词,中英文均可;limit 是返回条数,默认 5,最多 15;lang 决定返回文案的语言,zh 或 en,默认 zh。工具按中英文检索标题、频道、标签、分类,以及每个视频的简介和 HN 推荐理由,返回标题、频道、时长、观看量、HN 推荐人数、推荐理由与链接,按 HN 推荐强度排序。中文查询也能命中,结果里的标题显示中文译文。
适合的请求例如:有没有讲 Raft 共识算法的视频;找几个讲编译器优化的演讲;Karpathy 讲反向传播的是哪一个。
首次启动与数据¶
插件加载时开始下载官方数据导出(17.8 MB,一次性),同时请求上游接口补齐 YouTube 的时长、播放量与发布时间。两者都完成后列表才是完整状态,期间界面显示骨架屏。导出数据有效期七天,YouTube 元信息缓存二十四小时。
README 给出的实测耗时:
| 项目 | 实测耗时 |
|---|---|
| 首次安装(空缓存) | 约 10 秒 |
| 后续启动,列表加载 | 45 毫秒 |
| 打开详情页 | 10 毫秒 |
| 相关推荐,有共推荐关系的 3778 个视频 | 2 毫秒 |
| 相关推荐,其余 2676 个视频(向量近邻) | 首次约 0.7 秒 |
| 摘要与推荐理由机翻 | 首次 0.4 至 1.8 秒 |
数据包里包含 videos.jsonl(6454 条视频)、mentions.jsonl(39834 条 HN 评论)、related.jsonl(3778 条共推荐关系)、embeddings.npy(6454 × 384 维 float16 向量,用于补齐无共推荐关系的视频)、taxonomy.json(150 个分类,16 个大类)。导出不包含时长、播放量、发布时间与封面,这些字段属于 YouTube 元数据,列表会并行请求 65 页上游接口补齐,结果缓存一天。
中文支持¶
界面文案统一通过 tx(lang, 中文, English) 输出,两种语言下都不会中英混排;数量单位随语言切换,中文用万与亿,英文用 K 与 M。
内容层面的中文来源分两类:
- 随仓库附带:6454 条视频标题、166 条分类名称,安装后立即生效。
- 打开时自动翻译:摘要、推荐理由、评论引用;优先使用模型,模型不可用时使用机翻。HN 评论正文默认保持英文原文,翻译是显式操作。
模型译文与机翻译文分别存放,配置模型后模型译文会覆盖机翻结果,不会因为机翻先行而无法更新。机翻调用 Google 网页翻译的公共端点。
依赖、缓存与已知限制¶
各项能力的依赖与降级行为:
| 能力 | 依赖 | 缺失时的表现 |
|---|---|---|
| 列表、分类、搜索、播放 | DSH 的 webServer 与外网 | 面板不可用或播放器无法加载 |
| 中文标题与分类名 | 无 | 已随仓库提供 |
| 摘要等三段文本的中文 | 模型或外网 | 显示英文原文 |
| AI 问答 | DSH 已配置模型 | 面板提示模型不可用,其余功能正常 |
| 评论翻译 | 外网 | 按钮无响应,文本保持原文 |
| 字幕与直链兜底播放 | PATH 中存在 yt-dlp 与 ffmpeg | 视频仍可播放,AI 缺少字幕上下文 |
yt-dlp 与 ffmpeg 都是可选依赖,只影响两件事:AI 问答能否携带字幕上下文,以及 YouTube 嵌入被拒绝时能否回退到直链播放。
缓存全部位于 $DSH_PROFILE_DIR/.dsh-hackertube/,默认路径 ~/.dsh/.dsh-hackertube/,删除整个目录可恢复到初始状态。里面有解包后的官方数据、标题与分类译文、模型翻译与机翻缓存、YouTube 元信息快照、用户偏好、字幕。
已知限制方面:标题译文由模型生成后按规则校对,多数通顺,仍有约一千条偏向直译;中文查询需要先机翻为英文才能命中英文标签,每次查询发起一次请求,含 300 毫秒防抖与内存缓存,断网时仅保留本地匹配;YouTube 嵌入受上游策略限制,年龄限制或地区限制的视频需前往 YouTube 观看;播放中转页监听 127.0.0.1:18090,端口被占用时依次尝试 18091 与 18092。
适用场景与注意¶
适合两类人:一是想在一个界面里完成「找视频、看视频、看讨论」的技术读者;二是想让 agent 直接检索这套视频库的 DSH 开发者,中间不用再开浏览器。
几点使用前要确认的:插件以当前 DSH 进程的权限运行,安装前应先看一遍源码与许可证,确认它符合自己的运行环境;许可证是 MIT,包版本 0.1.6,要求 Node 大于等于 20;插件是非官方项目,与 HackerTube、Hacker News、YouTube 无隶属关系,视频托管仍在 YouTube,部分视频可能因上游策略限制无法内嵌播放。
结尾¶
dsh-hackertube 的价值很集中:把一份整理好、还带中文的高质量视频数据集放进 DSH 面板,同时给 agent 留一个检索入口。不需要额外配置,也不需要 API key,首次启动下载一次数据即可离线浏览(缓存有效期内)。目录页见 https://www.skillhub.cn/plugins/chow651/dsh-hackertube,源码见 https://github.com/chow651/dsh-hackertube。