DeepSeek Harness (DSH) 強調插件化架構。在學術研究場景中，開發者常面臨多源檢索困難、全文獲取繁瑣、期刊評估分散等問題。xby-article 插件基於 FastMCP 框架開發，旨在解決這些痛點，提供一站式的文獻處理能力。
插件定位¶
xby-article 是由 xby-skill 維護的聯網工具類插件。它不僅支持多源文獻搜索和元數據獲取，還能通過 PMCID 獲取全文、分析文獻關係，並集成 EasyScholar 與 OpenAlex 進行期刊質量評估。
核心功能¶
API 配置¶
使用 set_xby_apikey 在聊天中設置 API 密鑰。該配置會自動持久化，重啓後依然有效。
文獻搜索¶
使用 search_literature 進行多源文獻搜索。此工具只返回元數據（標題、作者、摘要、PMCID 等），不包含全文內容。如需獲取全文，請使用返回結果中的 PMCID 調用後續工具。
搜索策略支持以下模式：
* comprehensive: 全面搜索，使用所有可用數據源。
* fast: 快速搜索，僅使用主要數據源。
* precise: 精確搜索，僅使用權威數據源。
* preprint: 預印本搜索。
全文獲取¶
使用 get_article_details 通過 PMCID 獲取文獻全文。需要提供 PMCID 標識符。
* 批量模式最多支持 20 個 PMCID。
* 支持按章節提取（如方法、討論、結論）和指定格式（Markdown/Text/XML）。
參考文獻管理¶
使用 get_references 獲取文獻的引用列表。支持通過 DOI、PMID 或 PMCID 進行查詢。該工具內置智能去重機制，優先按 DOI 去重，其次按標題去重。
文獻關係分析¶
使用 get_literature_relations 分析文獻間的引用、相似和被引關係。支持傳入單個或多個文獻標識符進行分析。
期刊質量評估¶
使用 get_journal_quality 評估期刊的學術質量和影響力指標。該工具集成了 EasyScholar 與 OpenAlex 雙數據源。
安裝與啓用¶
在終端中執行以下命令進行安裝：
dsh plugin --profile web add github:xby_skill/xby-article
安裝完成後，插件即可在 DSH 的 Web Profile 中使用。
典型用法¶
- 設置密鑰：在聊天中輸入指令設置 API 密鑰，例如
set_xby_apikey <your_key>。 - 搜索文獻：使用
search_literature搜索關鍵詞。例如，搜索策略設爲precise以獲取更權威的結果。 - 獲取全文：利用搜索返回的 PMCID，調用
get_article_details獲取指定章節的全文內容。 - 分析關係：輸入一篇文獻的 DOI，調用
get_literature_relations查看其引用網絡。 - 評估期刊：輸入期刊名稱，調用
get_journal_quality獲取影響因子、SCI 分區等指標。
注意事項¶
- 數據源限制：
search_literature僅返回元數據，不含全文。獲取全文必須先通過搜索獲取 PMCID，再調用get_article_details。 - 參數要求：
get_article_details必須提供有效的 PMCID。get_references支持智能去重。 - 數據源：
get_journal_quality依賴 EasyScholar 和 OpenAlex 兩個外部數據源。
總結¶
xby-article 爲 DeepSeek Harness 提供了從檢索到評估的完整文獻處理鏈路。開發者可以利用其多源搜索、全文提取和關係分析能力，快速構建專業的學術助手應用。更多詳情請訪問 GitHub。
