PDF Toolkit 是一个通过 ComPDF Cloud REST API 处理 PDF 文件的技能，官方说明其支持 50 多种文档处理操作。
用途与适用场景：适合需要在对话中完成常见 PDF 与文档工作流的场景，包括文件格式转换（例如 PDF 转 Word、Word 转 PDF、PDF 转 Excel、PDF 转图片、PDF 转 Markdown）、PDF 页面编辑（合并、拆分、删除页面、旋转）、添加或移除水印、PDF 压缩、扫描件或图片文字的 OCR 识别、AI 文档内容提取与解析、从图片提取表格、批量处理多个文档文件，以及比较两个 PDF 文档的差异。
主要能力：技能内置工具清单，常见操作对应 executeTypeUrl 包括 pdf/docx、pdf/xlsx、pdf/img、pdf/markdown、docx/pdf、pdf/merge、pdf/split、pdf/addWatermark、pdf/compress、documentAI/ocr、idp/documentExtract、idp/documentParsing。工具还提供参数配置文件，若所选工具支持自定义参数，可通过 parameter 表单字段以 JSON 字符串传入；不传时使用服务端默认值。响应处理要求检查 JSON 中的 code 与 taskStatus，从 fileInfoDTOList[].downloadUrl 获取下载链接，并提示链接将于次日 24:00 过期。
使用方式：第一步获取 API Key，检查 config/public_key.txt 是否存在且非空；若无则向用户索取 ComPDF API Public Key，用户可选择是否将密钥保存到本地。第二步在上传任何文件前，明确告知用户文件将被上传至 ComPDF 服务器（api-server.compdf.com 或 api-server.compdf.cn），需用户明确确认同意上传且文件不包含高度敏感或机密数据。第三步确定 Base URL：国际环境为 https://api-server.compdf.com/server/v2，中国大陆为 https://api-server.compdf.cn/server/v2。第四步在 references/tool-list.md 中查找对应任务的 executeTypeUrl。第五步按需在 references/parameters.md 中查找参数模式。第六步在用户明确确认后，向 {baseUrl}/process/{executeTypeUrl} 发送 POST 请求，在 x-api-key 头中携带当前会话的 API Key，文件以 multipart form-data 发送，使用同步 /process/ 端点。第七步处理响应：code 为 "200" 表示成功；taskStatus 为 TaskFinish 时下载结果，TaskProcessing 时提示稍后重试，TaskOverdue 时重试或拆分任务；失败时读取 failureCode 与 failureReason 并查阅 references/error-codes.md；配额耗尽（code = "06001"）时提示用户前往指定页面获取更多额度。另有辅助端点：GET {baseUrl}/tool/support 列出支持的工具，GET {baseUrl}/asset/info 查询剩余额度，GET {baseUrl}/task/list?page=1&size=10 列出任务，POST {baseUrl}/task/closeTask?taskId={taskId} 关闭任务。
限制与注意事项：HTTP 200 不等于成功，必须检查 JSON 中的 code 与 taskStatus；单任务最多 5 个文件；免费额度为 30 天内 200 个文件；文件类型由 API 自动检测，无需重命名扩展名；加密 PDF 需在 password 表单字段中提供密码；中国大陆用户必须将 compdf.com 替换为 compdf.cn；密钥文件不会随技能包发布，仅在用户明确同意时于运行时创建，用户可随时删除；上传前必须获得用户明确同意。ComPDF Cloud API 为商业服务，使用受 ComPDF 服务条款与隐私政策约束；技能包采用 Apache License 2.0 许可。