技能介绍

解决 PDF 解析的碎片化问题

在工程实践中，让 AI 助手直接处理 PDF 往往面临工具链断裂或解析精度不足的问题。开发者要么在本地搭建复杂的 PDF 解析库，要么在多个 API 之间来回切换以获取元数据、特定页码内容或全文检索能力。本技能将这套流程封装为统一的接口，使大模型能够像调用本地函数一样，完成 PDF 文件的读取与分析。

核心能力与路由机制

该技能的核心在于将大模型作为路由层（Router），由模型负责理解意图、提取参数，而底层代码只负责调用 API 并返回结果。

全文与元数据提取：通过 scripts.tools.read_pdf 获取文件全文及元数据，或使用 scripts.tools.get_pdf_metadata 仅读取头部信息，避免不必要的算力消耗。
精准页面控制：针对大体积文档，scripts.tools.read_pdf_page 支持基于 page、startPage 和 endPage 的页码范围读取。
关键词检索：scripts.tools.search_pdf 允许在 PDF 内部进行文本搜索，支持 caseSensitive 参数控制大小写敏感度。

鉴权与边界说明

强制 API 密钥：服务高度依赖外部 API，必须配置 XBY_APIKEY。若检测到密钥缺失，模型必须主动向用户询问，严禁在无密钥状态下编造数据。
参数完整性：在调用工具前，需确保必填参数（如 path 或 query）已就绪，缺失时应通过交互工具补齐。
返回值处理：工具返回标准的 dict 对象，需关注 success 状态，并将 result["raw"] 中的结构化数据整理后呈现。