# HackerTube for DeepSeek Harness
**将 Hacker News 二十年精选的 6,454 支高分技术视频搬进 DeepSeek Harness**
[](https://www.npmjs.com/package/dsh-hackertube)
[](LICENSE)
[](https://nodejs.org)
[](https://github.com/deepseek-ai/deepseek-harness)
[](package.json)
[简体中文](README.md) | [English](README.en.md)
无需离开 DeepSeek Harness 切换到浏览器。
在 DeepSeek Harness 面板内畅享 Hacker News 社区精选的高质量技术演讲、AI 课程与系统架构视频。
开箱即用的全量中文、字幕级上下文 AI 深度解析、原生 Agent 检索工具,让高价值信源触手可及。

---
## ✨ 核心特性
- 📺 **沉浸式内嵌播放**:专为 DSH 面板打造的独立安全中转服务,直接在 DeepSeek Harness 内流畅播放,告别空白屏与第三方防盗链限制。
- 📡 **HackerTube TV 随机换台**:按 `T` 进入满铺播放的电视模式,在 6,454 支片子里随机换台——先按频道权重抽一个频道,再在频道里挑观看数多的那支,同一次会话不重样,放完自动接下一台。`↑` `↓` 换台、`←` `→` 调进度、空格暂停;标题、简介与站外入口收在右侧抽屉里,不看时完全不打扰画面。
- 🤖 **字幕级上下文 AI 问答**:问「这一段在讲什么」时,自动抓取播放点前后 3 分钟的精确字幕送入模型,直击技术细节,拒绝空洞概括。
- 🇨🇳 **开箱即用全量汉化**:随仓库内置全部 6,454 条标题与 166 个分类的中文对照,装完即用;详情摘要与 HN 讨论支持「模型精翻 + 本地机翻」双引擎按需解析。
- 🔍 **原生 Agent 检索工具**:注册 `hackertube_search` 原生 Tool,Agent 在对话交流中可直接检索 20 年精选视频信源并给出推荐。
- 🎯 **国内镜像无缝直达**:自动嗅探 B 站高质量搬运与中文字幕(基于物理时长指纹校验),命中即显直达入口,无则静默不打扰。
- ⚡ **零运行时依赖 & 毫秒级推荐**:纯原生 Node.js 实现(0 外部 npm 依赖),内置 384 维向量质心推荐算法;历史与喜好本地持久化。
---
## 🚀 快速开始
> **前提条件**:已安装并运行 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。
### 方式一:让 Agent 一句话自动安装(推荐)
直接在 DeepSeek Harness 对话框中把这句话发给 Agent:
```text
安装并启用 HackerTube 插件:plugin_manager install_bundle target=dsh-hackertube。
若 npm 访问受限则使用 target=github:chow651/dsh-hackertube。
装完确认插件列表中 dsh-hackertube 已启用,并提醒我刷新页面。
```
### 方式二:使用插件管理器安装
在 DSH 终端执行:
```bash
plugin_manager install_bundle target=dsh-hackertube
# 或直接从 GitHub 仓库安装:
# plugin_manager install_bundle target=github:chow651/dsh-hackertube
```
### 方式三:手动包管理安装
```bash
# 在 DSH profile 目录下执行
npm install dsh-hackertube
# 或
pnpm add dsh-hackertube
```
安装完成后在插件列表中启用 `dsh-hackertube` 并刷新页面即可。**无需任何 API Key,无需预配置,开箱即用。**
---
## 🤖 原生 Agent 工具集成
插件向 DeepSeek Harness 注册了 `hackertube_search` 原生工具。在日常与 Agent 对话时,Agent 可直接按语义检索视频库并给出带技术依据的参考:
### 对话示例
> **你**:有没有讲 Raft 共识算法的视频?最好是作者本人讲的。
**Agent** 自动调用 `hackertube_search({ query: "Raft 共识算法", limit: 5 })`,秒级分析后回答:
> 有,推荐看 Raft 作者 Diego Ongaro 本人在 Stanford 的公开演讲《Raft 讲座》(58 分钟,HN 4 人力荐)。社区评价它比论文更加通俗直观;若需了解前置知识,可以搭配同系列的《Paxos 讲座》(67 分钟)一起看。
> 🔗 https://www.youtube.com/watch?v=YbZ3zDzDnrw
### 工具参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `query` | string | 是 | 检索关键词,支持中英文混搜(如 `编译器优化`、`micrograd`) |
| `limit` | number | 否 | 返回条数,默认 `5`,最多 `15` |
| `lang` | string | 否 | 返回文本语言,`zh`(默认)或 `en` |
---
## 💡 与原始 HackerTube 站点的对比
本项目基于 Andrej Karpathy 开源的 [HackerTube 官方导出数据](https://karpathy.bearblog.dev/hacker-tube/),针对 DeepSeek Harness 面板环境进行了全面重构:
| 能力维度 | 原始站点 | 本插件 (DSH Plugin) |
|---|---|---|
| **交互场景** | 独立网页浏览 | **嵌入 DeepSeek Harness 面板**,即开即看 |
| **语言支持** | 纯英文 | **全量中英双语**,6,454 条中文标题装完即用 |
| **AI 问答** | 无 | **带播放点字幕上下文**的深度问答 |
| **Agent 调用** | 无 | **内置 Agent 原生检索工具** |
| **观看备用源** | 仅 YouTube | **智能嗅探国内高质量搬运/中字** |
| **进度与偏好** | 浏览器本地临时存储 | **宿主本地持久化**,清理浏览器缓存不丢失 |
| **个性化推荐** | 无 | **384 维向量质心 + HN 共推荐图谱** |
| **离线友好度** | 依赖全量实时请求 | **本地高速缓存 + 优雅降级策略** |
---
## 🖥️ 界面与交互

### 快捷键支持
| 按键 | 作用 | 按键 | 作用 |
|---|---|---|---|
| `/` | 聚焦搜索框 | `j` / `k` | 上下移动选中卡片 |
| `Enter` | 打开选中视频 | `l` | 喜欢 / 取消喜欢 |
| `w` | 加入稍后看 | `h` | 返回首页 |
| `?` | 显示快捷键指南 | `Esc` | 关闭详情或浮层 |
### 📡 电视模式
按 `T` 从正在看的这支片子进入电视:画面满铺,没有列表也没有侧栏,标题、简介和站外入口收在右边缘的抽屉里。
- `↑` `↓` 换台,按频道权重随机抽,同一次会话不重播
- `←` `→` 调进度,空格暂停 / 继续,`Esc` 退出
- 一支放完自动接下一台;作者禁止内嵌的片子会被跳过,不会停在错误页

### 🎯 国内备用源智能直达
为方便网络受限或偏好中文字幕的用户,插件在详情页提供智能国内平台(B站)备用入口:
- **严格指纹校验**:基于物理视频时长(±2s 容差)、发布时序及双向引用凭据进行刚性校验,杜绝同名搬运与二创误判。
- **版本质量优选**:自动在多个搬运中优先挑选 `官方` → `中字/熟肉` → `高清` 版本。
- **静默按需查询**:仅在打开详情页时按需毫秒级检索并缓存;若未检索到对应搬运则**完全静默不打扰**,不增加额外占位。