前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過標準化的接口擴展智能體的能力。在開發需要獲取外部技術資訊或監控社區熱點的智能體時，直接對接第三方 API 往往需要編寫額外的網絡請求邏輯。dsh-tool-hackernews 插件爲此提供了一個現成的解決方案，將 Hacker News 的核心數據檢索能力封裝爲 DSH 原生的工具。
插件概況¶
該插件由開發者 tanf1ng 維護，屬於聯網工具類插件。它提供了一套針對 Hacker News 的工具集，基於免費的 Algolia HN Search API 構建，無需申請 API Key。所有請求均爲只讀操作，且具備併發安全性，允許 DSH 在同一會話中並行調用多個工具。
核心功能¶
插件主要包含三個工具函數：
-
hn_top_stories(limit)
獲取當前 Hacker News 的首頁內容。- 參數：
limit爲可選參數，數值範圍 1-30。默認值通常爲 10。 - 返回：包含標題、鏈接、分數、評論數、作者及相對時間等信息。
- 參數：
-
hn_search(query, tag, since_hours, limit)
在 Hacker News 內進行關鍵詞搜索。- 參數：
query爲必填關鍵詞；tag用於限定類型（如 story, comment, ask_hn 等）；since_hours用於限制時間範圍（1-8760 小時）；limit控制返回結果數量。 - 返回：匹配的搜索結果列表。
- 參數：
-
hn_item(id, max_comments)
獲取單條特定內容的詳情及其評論。- 參數：
id爲必填，即文章在 HN 上的唯一 ID；max_comments用於限制抓取的評論數量（0-100）。 - 返回：文章詳情及評論樹，內容會去除 HTML 標籤並進行縮進處理，以確保上下文安全。
- 參數：
安裝與配置¶
安裝該插件需要使用 dsh plugin 命令。插件會安裝到指定的配置文件中。
dsh plugin --profile <name> add "github:tanf1ng/dsh-tool-hackernews"
安裝完成後，需要在配置文件的 cordis.patch.yml 中啓用插件定義：
- id: tool-hackernews
name: dsh-tool-hackernews
插件支持多種配置項，用於調整默認行爲：
| 配置項 | 默認值 | 說明 |
|---|---|---|
registerTopStories |
true |
是否註冊 hn_top_stories 工具。 |
registerSearch |
true |
是否註冊 hn_search 工具。 |
registerItem |
true |
是否註冊 hn_item 工具。 |
topStoriesLimit |
10 |
hn_top_stories 的默認返回數量。 |
searchLimit |
8 |
hn_search 的默認返回數量。 |
maxComments |
20 |
hn_item 的默認最大評論數。 |
fetchTimeoutMs |
15000 |
單次請求的超時時間（毫秒）。 |
典型用法¶
以下是在 DSH 智能體中調用該插件的示例：
# 獲取 Hacker News 首頁的前 5 條
hn_top_stories(5)
# 搜索過去 24 小時內關於 "AI" 的故事，限制結果爲 10 條
hn_search("AI", "story", 24, 10)
# 獲取 ID 爲 12345 的文章，最多展示 50 條評論
hn_item(12345, 50)
適用場景與注意事項¶
該插件適合需要主動獲取技術圈熱點、進行關鍵詞檢索或分析特定話題的 DSH 智能體開發場景。
由於插件在 DSH 進程的權限範圍內運行，使用前建議檢查源碼與許可證（MIT）。雖然基於公共 API，但需注意網絡請求的穩定性以及 Algolia API 的服務狀態。
