提取 PDF 指定页面的文本及物理坐标。

返回 JSON，每个文本行包含 text 和 rect [x0, y0, x1, y1]（Zotero PDF 坐标系）。 可以直接将 rect 传给 create_pdf_annotation 使用。

Args: item_id: Zotero PDF 附件的 itemID（数字），或 PDF 文件的绝对路径 page_number: 页码（从 0 开始）

在 Zotero PDF 上创建高亮/下划线批注。

坐标使用 get_pdf_layout_text 返回的 rect 值，无需手动转换。 写入后需重启 Zotero 或按 Ctrl+Shift+R 刷新才能看到批注。

注意：写操作需要关闭 Zotero 桌面应用，否则会因数据库锁而失败。

Args: item_id: Zotero PDF 附件的 itemID（数字），或 PDF 文件的绝对路径 page_index: 页码（从 0 开始） rects: 坐标数组，每项为 [x0, y0, x1, y1]（来自 get_pdf_layout_text） color: 十六进制颜色，如 "#ffd400"(黄), "#28CA42"(绿), "#2EA8E5"(蓝) comment: 附加在批注上的文字评论（可选） text: 被高亮的原始文本（可选，用于 Zotero 中显示） type: 批注类型: "highlight"(默认) 或 "underline"

为 Zotero 文献条目创建子笔记。

支持 HTML 和纯文本。写入后需重启 Zotero 或按 Ctrl+Shift+R 刷新。 注意：写操作需要关闭 Zotero 桌面应用。

Args: parent_item_id: 父文献条目的 itemID（数字字符串） note_content: 笔记内容（HTML 或纯文本，支持 Markdown 风格）

列出 Zotero 库中的文献条目。

返回每个条目的 itemID、key、标题，以及 PDF 附件 ID（如有）。 用于发现 item_id 以供其他工具使用。

Args: limit: 最多返回条目数（默认 50）

按标题、作者或 key 搜索 Zotero 条目。

比 list_zotero_items 更高效，可直接定位目标论文。

Args: query: 搜索关键词（标题/作者的部分文字，或 Zotero item key） limit: 最多返回条目数（默认 20）

批量提取多页 PDF 纯文本（无坐标），适合大 PDF 内容理解。

与 get_pdf_layout_text 的区别：不返回坐标，context 占用减少 ~80%。 推荐工作流：

1. 先用此工具理解全文 → 确定目标页和目标句子

2. 再用 get_pdf_layout_text 获取目标页的精确坐标

3. 最后用 create_pdf_annotation 写入标注

Args: item_id: Zotero PDF 附件的 itemID（数字），或 PDF 文件的绝对路径 pages: 要提取的页码列表（0-indexed），不传则提取全文 skip_refs: 是否自动跳过参考文献页（默认 True）

获取 Zotero 条目的完整元数据。

返回标题、作者列表、年份、期刊、DOI 等信息。 支持传入文献条目 ID 或 PDF 附件 ID（自动查找父条目）。

Args: item_id: Zotero 条目或 PDF 附件的 itemID（数字），或 PDF 文件路径

列出 PDF 附件上已有的所有标注。

用于检查已有标注，避免重复标注。返回每条标注的类型、颜色、文本和评论。

Args: item_id: Zotero PDF 附件的 itemID（数字），或 PDF 文件的绝对路径

一次性创建多条 PDF 标注（减少调用次数）。

每条标注需包含 page_index 和 rects，可选 color/text/comment/type。 写操作需要关闭 Zotero 桌面应用。

Args: item_id: Zotero PDF 附件的 itemID（数字），或 PDF 文件的绝对路径 annotations: 标注列表，每项为: {"page_index": int, "rects": [[x0,y0,x1,y1],...], "color": str, "text": str, "comment": str, "type": str}