infometa PDF 工具箱
PDF 工具箱提供 PDF 文档的全面操作能力。
本技能依赖
kdocs技能的基础文档操作能力（认证、文件管理等），请确保已安装该技能。详见references/core/目录。
能力范围
通用工具总览
文档创建与上传
| 工具 | 用途 |
|---|---|
create_file |
在云盘下新建文件 |
scrape_url |
网页剪藏，抓取网页内容并自动保存为智能文档 |
scrape_progress |
查询网页剪藏任务进度 |
upload_file |
全量上传写入文件（更新已有 docx/pdf 或新建并上传本地文件） |
文档读取与下载
| 工具 | 用途 |
|---|---|
list_files |
获取指定文件夹下的子文件列表 |
download_file |
获取文件下载信息 |
read_file |
读取文档内容为 Markdown/结构化数据 |
文件组织
| 工具 | 用途 |
|---|---|
move_file |
批量移动文件(夹) |
rename_file |
重命名文件（夹） |
分享与访问
| 工具 | 用途 |
|---|---|
share_file |
开启文件分享 |
set_share_permission |
修改分享链接属性 |
cancel_share |
取消文件分享 |
get_share_info |
获取分享链接信息 |
get_file_link |
获取文件的云文档在线访问链接 |
搜索
| 工具 | 用途 |
|---|---|
search_files |
文件（夹）搜索 |
页面查询
| 工具 | 用途 |
|---|---|
pdf.get_pdf_page_count |
查询 PDF 总页数 |
拆分与合并
| 工具 | 用途 |
|---|---|
pdf.extract_pdf_pages |
提取指定页并生成新 PDF |
pdf.split |
将 PDF 按固定页数间隔拆分为多个文件 |
pdf.split_query |
查询 PDF 拆分任务进度 |
pdf.merge |
将多个 PDF 文件合并为一个 |
pdf.merge_query |
查询 PDF 合并任务进度 |
格式转换
| 工具 | 用途 |
|---|---|
pdf.convert |
发起 PDF 转 Office 转换任务 |
pdf.convert_query |
查询 PDF 转换任务进度与结果 |
全文翻译
| 工具 | 用途 |
|---|---|
pdf.translate_full_file |
提交 PDF 全文翻译导出任务 |
pdf.get_translate_progress |
查询全文翻译任务进度 |
pdf.cancel_translate |
取消全文翻译任务 |
详细参考
| 文档类型 | 参考文件 | 说明 |
|---|---|---|
| PDF 文档（pdf） | references/pdf_references.md |
PDF 创建与内容读取 |
操作指南
通用操作路由
| 意图 | 路由 |
|---|---|
| 读取文档内容 | read_file（统一入口，按后缀自动返回 Markdown 或结构化数据） |
| 创建/写入 | create_file_with_content（统一入口，新建文档并写入内容，返回 link_url） |
| 局部更新 | 改块/改段/改单元格，已有目标文档上的修改 → 按「支持的文档类型」→ 对应 reference |
| 类型专属能力 | 条件格式、导出转换、翻译、PDF 拆分、幻灯片主题、数据校验 |
| 获取文件标识指南 | 必读 references/file-locating-guide.md |
高频流程指引
PDF 文档操作
按用户需求选择对应操作：
读取 PDF 内容：
search_files或get_share_info定位文档 → 获取file_id、drive_idread_file(file_id=...)→ 返回 Markdown 文本适合摘要、信息提取等场景；复杂排版可能有精度损失
查询 PDF 页数：
search_files定位 PDF → 获取file_idpdf.get_pdf_page_count(file_id=...)→ 返回总页数
提取指定页面：
search_files定位 PDF → 获取file_idpdf.get_pdf_page_count确认总页数，校验用户请求的页码是否越界pdf.extract_pdf_pages(file_id=..., ranges=[{from:1,to:1},{from:5,to:8}])→ 生成新 PDF页码 1-based；
ranges为{from, to}对象数组，多段按顺序合并；提取结果为临时下载链接
按固定页数拆分：
search_files定位 PDF → 获取file_idpdf.get_pdf_page_count确认总页数pdf.split(file_id=..., dc_interval=N, file_name="章节")发起拆分，返回jobidpdf.split_query(jobid=...)轮询进度，直到progress=100- 从
result_files读取各子文件（file_id、name、download_url）dc_interval为每 N 页拆分一次；结果存入金山文档我的云文档/应用/PDF拆分
合并多个 PDF：
search_files定位所有待合并 PDF → 获取各file_idpdf.merge(files=[{file_id:"..."}, {file_id:"..."}], file_name="完整报告")发起合并，返回jobidpdf.merge_query(jobid=...)轮询进度，直到progress=100- 从
result_files读取合并结果（file_id、name、download_url）files数组按顺序合并，至少 2 个；结果存入金山文档我的云文档/应用/PDF合并
转换为可编辑文档（Word/Excel/PPT）：
search_files定位 PDF → 获取file_idpdf.convert(file_id=..., to_format="docx|xlsx|pptx", ...)发起转换任务（默认is_free_convert=false）- 若步骤 2 返回
code=400100或含VipLevelNotEnough等会员不足提示，使用相同参数、仅将is_free_convert=true重新调用pdf.convert（免费额度最多处理前 5 页） pdf.convert_query(jobid=..., file_id=..., fname=...)轮询进度，直到progress=100- 从
result_files读取转换结果（类型、大小、下载 URL）
全文翻译导出（双语/指定语言）：
search_files定位 PDF → 获取file_idpdf.translate_full_file(file_id=..., from_lang=..., to_lang=..., output_file_mode=..., output_file_two_lang=...)- 若
pdf.translate_full_file返回任务态，再用pdf.get_translate_progress(file_id=..., task_id=...)轮询 - 任务需中止时调用
pdf.cancel_translate(file_id=...)
创建/上传 PDF：
upload_file(drive_id=..., parent_id=..., name="xxx.pdf", content_base64=...)直接上传- 更新已有 PDF：
upload_file(file_id=..., content_base64=...)全量覆盖
风险控制
以下工具不可逆，调用前必须向用户确认（详细约束见各工具参考文档的「操作约束」区）：
cancel_share
工具组合速查
| 用户需求 | 推荐工具组合 |
|---|---|
| 用户需要读取 PDF 内容、查询页数、提取指定页面、拆分合并、转换可编辑格式或做整文翻译导出 | search_files → read_file / pdf.get_pdf_page_count / pdf.extract_pdf_pages / pdf.split + pdf.split_query / pdf.merge + pdf.merge_query / pdf.convert + pdf.convert_query / pdf.translate_full_file |