智能 PDF 文档阅读器

解决什么问题

把 PDF 丢给大模型时，常见尴尬是：模型只能看文件名，没法稳定提取正文；自己写脚本又要分别处理下载、解析、分页、元数据和搜索。这个 Skill 把 PDF 阅读变成可路由的工具调用：模型负责理解用户意图和补齐参数，底层代码负责调用 PDF 读取服务。

核心能力与工作方式

• 密钥检查：启动相关任务前检查 scripts.config.settings.api_key；如果为空，先用 AskUserQuestion 询问用户，拿到后调用 scripts.config.set_api_key(api_key) 保存。
• 意图路由：根据用户要整篇阅读、指定页码、只看元数据或搜索关键词，选择 scripts.tools.read_pdf、scripts.tools.read_pdf_page、scripts.tools.get_pdf_metadata 或 scripts.tools.search_pdf。
• 参数提取：path 支持本地绝对/相对路径或 http://、https:// URL；按页阅读可用 page、startPage、endPage；关键词搜索需要 query，可选 caseSensitive。
• 调用与返回：用关键字参数调用工具，例如 scripts.tools.search_pdf(path='...', query='年度报告')；返回 dict 中的 result["raw"] 是 API 原始 JSON，整理后展示，同时参考 result["success"] 与 result["message"] 判断调用状态。

适用边界与注意点

它解决的是 PDF 文本读取、元数据获取和关键词检索，不负责写回批注、格式转换或在线协作。缺少 API 密钥时必须向用户索取，不能用搜索结果或模型猜测替代。参数不全时也应继续追问；拿到返回后若 success 为 False 或内容不可读，不要编造正文。