xby-article：DeepSeek Harness 文献检索与管理插件

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 中使用。

典型用法¶

1. 设置密钥：在聊天中输入指令设置 API 密钥，例如 set_xby_apikey <your_key>。
2. 搜索文献：使用 search_literature 搜索关键词。例如，搜索策略设为 precise 以获取更权威的结果。
3. 获取全文：利用搜索返回的 PMCID，调用 get_article_details 获取指定章节的全文内容。
4. 分析关系：输入一篇文献的 DOI，调用 get_literature_relations 查看其引用网络。
5. 评估期刊：输入期刊名称，调用 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。