DeepSeek Harness 插件介紹：dsh-grok-xsearch

前言¶

DeepSeek Harness (DSH) 的核心設計理念是插件化，旨在通過可組合的組件擴展智能體能力。在開發需要獲取 X (Twitter) 實時情報的 Agent 時，直接調用 API 往往面臨鑑權複雜或費用高昂的問題。dsh-grok-xsearch 插件通過 SuperGrok OAuth 鑑權，利用 xAI Responses API 爲 DSH Agent 提供了一套完整的 X 情報獲取與分析工具，替代了昂貴的 X API 高級版層級。

插件定位¶

該插件由 GooDAnDReaREADY 維護，是一個基於 Node.js 的工具套件。它爲 DeepSeek Harness 提供了 X (Twitter) 的實時搜索、趨勢發現、作者畫像及技術立場分析功能，同時集成了社區事實覈查與多模態內容理解能力。

核心功能¶

插件註冊了多個專用工具，覆蓋從搜索到深度分析的完整鏈路：

實時搜索與情報：支持自然語言搜索，可按日期範圍、語言、互動量（點贊/轉發）進行過濾，並支持圖片與視頻的模態理解。
作者分析：可查看特定專家或開發者的時間線，分析其近期討論的技術立場與觀點。
趨勢發現：在科技、AI、加密貨幣等特定領域挖掘實時熱點與病毒式傳播的討論。
事實覈查：集成社區筆記，用於驗證特定聲明或新聞，尋找專家反駁與更正。
線程閱讀：支持從 Tweet URL 或 ID 重建完整的討論線程，並提取表格數據。

使用示例¶

插件在 DSH Agent 的 ctx.tools 中註冊了以下工具：

x_search：使用自然語言搜索 X 帖子、線程和媒體。例如，搜索特定時間段的開發者討論，並過濾出包含鏈接的原始帖子。
x_author_profile：分析特定專家（如 @ylecun）在近期討論中的技術立場，或聚焦於某個具體主題的辯論歷史。
x_trending_topics：發現特定領域（如 ai 或 crypto）內的新興話題和熱門討論。
x_fact_check_notes：針對某個謠言或新聞聲明，查找 X 上的社區筆記和專家闢謠信息。
x_thread_reader：通過 URL 或 ID 重建長篇多推文討論，並包含關鍵的社區回覆。

安裝與依賴¶

該插件爲 npm 包。安裝前需確保環境滿足以下要求：

Node.js 版本：20 或更高版本。
Peer Dependencies：插件依賴以下 DSH 核心組件：

    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
    "@deepseek-ai/schemastery": "^3.18.1"

安裝方式：通過 npm 安裝包名 @goodandready/dsh-grok-xsearch。

注意事項¶

鑑權要求：必須配置 SuperGrok OAuth 認證才能使用，否則無法連接 xAI API。
API 限制與回退：插件使用 xAI Responses API。當遇到速率限制（429）時，內置了智能回退機制，可嘗試降級調用 Grok 4.5。
運行權限：插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
生態背景：該插件屬於社區開發的 DSH 插件，與 DeepSeek 或幻方官方無從屬關係。