DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在构建 AI 智能体时，让模型直接读取本地 PDF 文件通常需要编写额外的解析脚本或调用外部服务。xby-read-pdf 作为一个 DSH 插件，旨在提供一套标准化的 PDF 处理接口，让模型能够直接在 DSH 环境中完成对 PDF 文件的解析、元数据获取和关键词检索。
插件定位¶
这是一个由 xby-skill 维护的 MCP 服务器插件，归类于模型推理。它是一个支持 AI 助手读取和分析 PDF 文件的工具，主要解决模型无法直接理解本地 PDF 格式文档的问题。
核心功能¶
该插件提供以下核心能力：
- set_xby_apikey：在对话中设置 API 密钥，该设置会自动持久化，重启进程后依然有效。
- read_pdf：读取并提取 PDF 文件的全文内容，同时返回元数据。
- read_pdf_page：读取 PDF 的特定页面或页码范围的内容。
- get_pdf_metadata：获取 PDF 文件的元数据信息，而不需要读取全部内容。
- search_pdf：在 PDF 文件中搜索特定的文本关键词。
安装与启用¶
安装时必须指定 --profile web 参数。使用官方提供的 GitHub 安装命令即可完成部署：
dsh plugin --profile web add github:xby_skill/xby-read-pdf
安装完成后，需在对话中调用 set_xby_apikey 设置 API 密钥才能使用相关功能。
典型用法¶
- 全文提取与分析：让模型读取并分析一份完整的 PDF 文档，提取摘要或关键信息。
- 局部阅读：仅提取 PDF 的第 3 页到第 5 页内容，用于快速浏览特定章节。
- 元数据获取：在不消耗大量 Token 的情况下获取 PDF 的作者、创建日期等元数据。
- 关键词检索：在文档中快速定位包含特定关键词的段落。
注意事项¶
- 前置条件：使用该插件前，必须通过
set_xby_apikey设置 API 密钥。 - 权限与安全：该插件以当前 DSH 进程的权限运行。安装前建议检查源码逻辑与许可证（MIT）。
- 生态说明：此插件来自社区目录，与 DeepSeek 或幻方没有官方从属关系。
通过集成 xby-read-pdf，可以在 DSH 生态中快速构建具备文档分析能力的智能体。更多细节可查阅项目主页：xby-skill/xby-read-pdf
