# HackerTube for DeepSeek Harness
**Two Decades of Hacker News Top Technical Videos — Right Inside DeepSeek Harness**
[](https://www.npmjs.com/package/dsh-hackertube)
[](LICENSE)
[](https://nodejs.org)
[](https://github.com/deepseek-ai/deepseek-harness)
[](package.json)
[English](README.en.md) | [简体中文](README.md)
No need to switch away from DeepSeek Harness to an external browser.
Browse and watch 6,454 high-impact engineering talks, lectures, and documentaries
recommended over twenty years on Hacker News, directly in your DeepSeek Harness panel.
Featuring full bilingual support, subtitle-aware AI answers, and a native Agent search tool.

---
## ✨ Key Features
- 📺 **Seamless In-Panel Player**: Dedicated local relay avoids third-party embed and referrer restrictions. Watch high-value engineering talks directly inside DeepSeek Harness.
- 📡 **HackerTube TV**: Press `T` for a full-bleed TV mode that tunes randomly through all 6,454 videos — a channel is picked by weight, then the most-watched video inside it; nothing repeats within a session and it auto-advances when one ends. `↑` `↓` change channels, `←` `→` seek, space pauses; title, summary and outside links stay in a drawer on the right, out of the picture.
- 🤖 **Subtitle-Aware AI Q&A**: Asking "what is this part about?" extracts the exact subtitle window around your current playhead (±3 mins) for grounded, precise technical explanations.
- 🇨🇳 **Built-in Bilingual Localization**: Ships with 6,454 Chinese titles and 166 taxonomy categories ready on install. Summaries and discussions support both on-demand model translation and machine translation fallback.
- 🔍 **Native Agent Tool**: Registers `hackertube_search` so your AI agent can query 20 years of HN technical recommendations directly inside coding conversations.
- 🎯 **Smart Alternative Mirrors**: Automatically identifies quality mirrors and subtitled versions on Chinese platforms (Bilibili) using strict physical duration fingerprints. Shows a direct entry only when found; remains completely silent otherwise.
- ⚡ **Zero Runtime Dependencies & Vector Recommendations**: Pure native Node.js implementation with 384-dimensional vector centroid recommendations. Fast cold starts and host-side persistence.
---
## 🚀 Quick Start
> **Prerequisite**: A running installation of [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
### Option 1: Let Your Agent Install It (Recommended)
Simply send this prompt to your agent inside DeepSeek Harness:
```text
Install and enable the HackerTube plugin: plugin_manager install_bundle target=dsh-hackertube.
If npm fails, use target=github:chow651/dsh-hackertube instead.
Then confirm dsh-hackertube is enabled in the plugin list and remind me to refresh the page.
```
### Option 2: Install via Plugin Manager
Run directly in the DSH terminal:
```bash
plugin_manager install_bundle target=dsh-hackertube
# Or directly from the GitHub repository:
# plugin_manager install_bundle target=github:chow651/dsh-hackertube
```
### Option 3: Manual Package Install
```bash
# Inside your DSH profile directory
npm install dsh-hackertube
# or
pnpm add dsh-hackertube
```
Enable `dsh-hackertube` in your plugin list and refresh the workspace. **No API keys or manual database initialization required.**
---
## 🤖 Native Agent Tool Integration
The plugin registers `hackertube_search` with DeepSeek Harness. Your agent can search the library semantically during conversation workflows:
### Example Exchange
> **You**: Is there any video explaining the Raft consensus algorithm? Ideally by the author.
**Agent** calls `hackertube_search({ query: "Raft consensus", limit: 5 })` and replies:
> Yes, Raft's author Diego Ongaro delivered a comprehensive lecture at Stanford: *Raft User Study Lecture* (58 min, recommended by 4 HN members). HN comments highlight that it is much more approachable than reading the paper alone. You can also watch the accompanying *Paxos Lecture* (67 min) for foundational background.
> 🔗 https://www.youtube.com/watch?v=YbZ3zDzDnrw
### Tool Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | Yes | Search query in English or Chinese (e.g. `compiler optimization`, `micrograd`) |
| `limit` | number | No | Number of results to return (default `5`, max `15`) |
| `lang` | string | No | Language for returned text: `zh` (default) or `en` |
---
## 💡 Comparison with the Original Site
Built upon Andrej Karpathy's open [HackerTube data export](https://karpathy.bearblog.dev/hacker-tube/), tailored specifically for the DeepSeek Harness panel environment:
| Capability | Original Site | HackerTube DSH Plugin |
|---|---|---|
| **Context** | Standalone web browser | **Embedded inside DeepSeek Harness panel** |
| **Localization** | English only | **Full EN/ZH bilingual**, 6,454 translated titles ready |
| **AI Q&A** | None | **Subtitle-aware temporal Q&A** |
| **Agent Tool** | None | **Native `hackertube_search` tool** |
| **Mirror Sources** | YouTube only | **Smart physical fingerprint matching for mirrors** |
| **State Persistence** | Ephemeral browser storage | **Host-side local persistence** (safe across cache clears) |
| **Recommendations** | None | **384-d vector centroid + HN co-recommendation graph** |
| **Offline Resilience** | Full network dependent | **Local caching + graceful offline degradation** |
---
## 🖥️ Watch Page & Shortcuts

### Keyboard Shortcuts
| Key | Action | Key | Action |
|---|---|---|---|
| `/` | Focus search bar | `j` / `k` | Navigate cards up/down |
| `Enter` | Open selected video | `l` | Like / Unlike |
| `w` | Add to Watch Later | `h` | Return to Home |
| `?` | Show shortcut cheatsheet | `Esc` | Close details or overlay |
### 📡 TV Mode
Press `T` on whatever you are watching to turn it into a channel: the picture fills the panel, with no grid and no sidebar, and the title, summary and outbound links wait in the drawer on the right edge.
- `↑` `↓` change channel — a weighted random pick that never repeats within a session
- `←` `→` seek, `Space` pause / resume, `Esc` exit
- The next channel starts by itself when a video ends; videos whose owners disabled embedding are skipped instead of landing on an error page

### 🎯 Smart Alternative Mirrors
For users facing network restrictions or seeking localized subtitles, the watch view dynamically checks for verified Chinese platform (Bilibili) mirrors:
- **Strict Fingerprint Verification**: Compares exact duration (within ±2s tolerance), chronological release order, and bidirectional description references to rule out homonymous uploads or derivative commentary.
- **Tier Quality Ranking**: Prioritizes `Official Channel` → `Subtitled / Translated` → `High-definition Repost`.
- **Zero Noise & Silent Lookup**: Lookups are on-demand and cached locally. If no valid mirror exists, **no placeholder is rendered** — keeping the interface clean and distraction-free.