xby-hackernews-search: HackerNews 內容檢索與分析服務

DeepSeek Harness (DSH) 的插件生態採用“一切皆插件”的理念，通過擴展 MCP（Model Context Protocol）服務來增強 AI 代理獲取外部數據的能力。xby-hackernews-search 是一個針對 HackerNews 的數據檢索與分析插件，由 xby-skill 維護，開源協議爲 MIT。它主要解決 AI 代理或開發者需要實時訪問 HackerNews 數據、進行關鍵詞搜索以及分析熱門內容的需求。

核心功能¶

該插件提供以下主要能力：

set_xby_apikey：在聊天會話中設置 API 密鑰。該密鑰會自動持久化，重啓後依然有效。
search_posts：根據關鍵詞檢索 HackerNews 內容。支持標題、文本和作者的搜索，並提供標籤過濾、數值過濾（如點贊數、評論數）、分頁以及 OR 邏輯的高級篩選功能。
get_front_page：獲取當前 HackerNews 首頁的帖子列表。返回的數據包含排序後的熱門內容，並支持分頁。
get_latest_posts：獲取按時間排序的最新 HackerNews 帖子。
get_item：獲取特定 HackerNews 條目（ID）的詳細信息，包括完整的嵌套評論樹和元數據。
get_user：獲取 HackerNews 用戶的公開檔案信息，包括 Karma 值、簡介和註冊時間。

安裝與啓用¶

安裝該插件需要 DeepSeek Harness 的 CLI 工具。在安裝前，請確保已配置好 web profile。

dsh plugin --profile web add github:xby_skill/xby-hackernews-search

安裝完成後，在 DSH 的會話中即可調用上述功能。

使用示例¶

設置 API 密鑰¶

使用該服務前，需要在聊天中設置 API 密鑰。

set_xby_apikey
// 接下來會提示輸入密鑰

搜索帖子¶

支持通過關鍵詞、標籤和數值過濾器組合使用。

基礎搜索：搜索 AI 相關的故事。

    search_posts
    {
      "query": "AI",
      "tags": ["story"]
    }

數值過濾：查找點贊數超過 100 的 Python 帖子。

    search_posts
    {
      "query": "Python",
      "numericFilters": ["points>=100"]
    }

OR 邏輯與標籤：獲取 Web 類別下包含故事或投票的內容。

    search_posts
    {
      "query": "web",
      "tags": ["(story,poll)"]
    }

獲取首頁與最新內容¶

獲取首頁：獲取首頁帖子，可自定義每頁數量。

    get_front_page
    {
      "hitsPerPage": 50
    }

獲取最新帖子：獲取最新的評論內容。

    get_latest_posts
    {
      "tags": ["comment"]
    }

獲取用戶與條目詳情¶

獲取用戶信息：查詢特定用戶的檔案。

    get_user
    {
      "username": "pg"
    }

獲取條目詳情：獲取特定 ID 的故事及其所有評論。

    get_item
    {
      "itemId": "38456789"
    }

注意事項¶

API 密鑰來源：該插件需要外部 API 密鑰，請前往小笨羊官網註冊獲取。
性能與錯誤處理：
- get_item：對於包含超過 500 條評論的大型線程，加載可能需要 2-3 秒。如果條目不存在或已被刪除，將返回錯誤。
- get_user：如果用戶不存在或用戶名格式無效（僅允許字母數字和下劃線，且區分大小寫），將返回錯誤。
運行環境：插件以當前 DSH 進程的權限運行。在安裝前，建議檢查源碼及許可證（MIT）以確認符合項目需求。