dsh-hackertube 0.1.5 → 0.1.6

package/README.en.md

@@ -112,13 +112,38 @@ Likes, watch later, and history live on the host side, so clearing browser data
 
 The plugin registers a tool named `hackertube_search`. Once installed, your agent can search this video library from any conversation, without opening the panel.
 
-Good requests for it:
+### One full exchange
+
+You ask:
+
+> Which video should I actually watch to understand backpropagation?
+
+The agent calls `hackertube_search({ query: "backpropagation", limit: 5, lang: "en" })`, and the tool returns (excerpt):
+
+```
+1. The spelled-out intro to neural networks and backpropagation: building micrograd — Andrej Karpathy · 146 min · 4.4M views · 17 recommenders
+   HN: HN treats it as the best starting point for really understanding backprop and neural nets…
+   https://www.youtube.com/watch?v=VMj-3S1tku0
+
+2. Backpropagation, intuitively | Deep Learning Chapter 3 — 3Blue1Brown · 13 min · 6.4M views · 4 recommenders
+   HN: Recommended as the most accessible introduction to backprop for people who struggle with the pure math.
+   https://www.youtube.com/watch?v=Ilg3gGewQ5U
+```
+
+The agent answers:
+
+> Start with Karpathy's "building micrograd", 146 min. It has 17 recommenders, the strongest signal HN gives, and it builds backpropagation from scratch in code instead of explaining it on paper. If you want the intuition first, watch the 3Blue1Brown chapter (13 min) before it.
+> https://www.youtube.com/watch?v=VMj-3S1tku0
+
+### Good requests for it
 
 - Any talk explaining Raft consensus
 - A few lectures on compiler optimization
 - Which Karpathy video covers backpropagation
 
-It searches titles, channels, tags and categories in English and Chinese, plus each video's summary and Hacker News recommendation note. Results carry title, channel, duration, view count, recommender count, the recommendation note and a link, ordered by how strongly Hacker News recommends them. Chinese queries work, and titles come back in Chinese when a translation exists.
+### What it does
+
+Searches titles, channels, tags and categories in English and Chinese, plus each video's summary and Hacker News recommendation note. Results carry title, channel, duration, view count, recommender count, the recommendation note and a link, ordered by how strongly Hacker News recommends them. Chinese queries work, and titles come back in Chinese when a translation exists.
 
 | Parameter | Meaning |
 |---|---|

package/README.md

@@ -112,13 +112,38 @@ DSH 从 profile 目录加载插件，在普通项目里安装不会生效。需
 
 插件注册了一个工具 `hackertube_search`。装了插件之后，不用打开面板，agent 在对话里就能检索这个视频库。
 
-适合这类请求：
+### 一次完整的对话
+
+你问：
+
+> 有没有讲 Raft 共识算法的视频？最好是作者本人讲的。
+
+agent 调用 `hackertube_search({ query: "Raft 共识算法", limit: 5 })`，工具返回（节选）：
+
+```
+1. Paxos 讲座（Raft 用户研究） — Diego Ongaro · 67 分钟 · 11.4 万次观看 · 6 人推荐
+   HN：Recommended as a clear, lucid way to learn Paxos and Multi-Paxos…
+   https://www.youtube.com/watch?v=JEpsBg0AO6o
+
+2. Raft 讲座（Raft 用户研究） — Diego Ongaro · 58 分钟 · 8.7 万次观看 · 4 人推荐
+   HN：HN commenters recommend it as a clearer introduction to Raft than the paper…
+   https://www.youtube.com/watch?v=YbZ3zDzDnrw
+```
+
+agent 据此回答：
+
+> 有，而且就是 Raft 作者 Diego Ongaro 本人讲的。先看第二个《Raft 讲座》，58 分钟，HN 上的评论说它比读论文好懂；它和第一个《Paxos 讲座》是同一套课程，通常一起看。
+> https://www.youtube.com/watch?v=YbZ3zDzDnrw
+
+### 适合这类请求
 
 - 有没有讲 Raft 共识算法的视频
 - 找几个讲编译器优化的演讲
 - Karpathy 讲反向传播的是哪一个
 
-它按中英文检索标题、频道、标签、分类，以及每个视频的简介和 HN 推荐理由，返回标题、频道、时长、观看量、HN 推荐人数、推荐理由与链接，并按 HN 推荐强度排序。中文查询也能命中，结果里的标题会显示中文译文。
+### 它做什么
+
+按中英文检索标题、频道、标签、分类，以及每个视频的简介和 HN 推荐理由，返回标题、频道、时长、观看量、HN 推荐人数、推荐理由与链接，并按 HN 推荐强度排序。中文查询也能命中，结果里的标题会显示中文译文。
 
 | 参数 | 说明 |
 |---|---|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-hackertube",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "DeepSeek Harness 插件：在面板里看 Hacker News 二十年推荐的 6454 个技术视频",
   "type": "module",
   "license": "MIT",