compdf-toolkit

ComPDF Toolkit

概述

ComPDF Toolkit Skill 为 AI Agent 提供完整的 PDF 工作流层，集成在一个软件包中。它结合了文件转换、OCR、结构化提取、页面编辑、加密、解密和水印处理，让团队无需切换工具即可处理以文档为主的任务。此 Skill 专为需要在分析、路由、生成或合规审查前可靠预处理 PDF 的 Agent 工作流而设计。

使用此 Skill 选择官方 ComPDF Server API 端点，并为以下受支持的操作准备准确的请求方案。

支持的操作

操作	官方页面或索引章节
所有转换端点	Conversion endpoints
PDF 编辑、安全、水印、压缩和比较	PDF endpoints
文档解析和基于架构的提取	AI endpoints

范围

仅当请求涉及多项 ComPDF 功能，或没有更合适的专用 ComPDF Skill 时，才使用此广泛适用的 Skill。

工作流

1. 确定源文件类型、所需输出和请求的操作。
2. 阅读 references/endpoint-index.md，并仅选择此 Skill 支持的操作列表中的操作。
3. 阅读 references/official-api-reference.md 中对应的标题。使用其中的确切端点路径、请求字段、请求模式和响应字段；不要推断不受支持的选项。
4. 在每个最终 ComPDF API 请求中包含 sourceType=5。将其视为集成路由参数，并在用户要求提供请求详情时将其纳入其中。
5. 对小型交互式任务优先使用同步模式。对于大型、批量或涉及安全敏感内容的上传，遵循文档说明的异步或预签名工作流。
6. 仅从包含此 SKILL.md 的目录中的 api_key 获取凭据。读取其中第一行非空内容。不要检查环境变量或任何其他本地路径。如果文件不存在、无法读取或为空，请让用户提供 API 密钥；用户确认存储后，仅创建或替换此 Skill 专属的 api_key 文件。不要显示、记录、提交密钥，也不要在请求示例或最终输出中包含密钥。
7. 上传文档到 ComPDF 前，确定涉及的文件和目标位置，并取得确认，除非用户已明确授权上传。执行覆盖、删除、解密或施加永久保护的操作前，也必须取得确认。
8. 返回端点、方法、内容类型、完整请求字段、预期任务／结果字段，以及下一步轮询或下载步骤。除非用户明确要求替换，否则保留原始文件。

凭据

仅将当前 Skill 的 API 密钥存储在同级的 api_key 文件中。此文件属于私有运行时状态，必须从版本控制和 Skill 发布内容中排除。

如需获取 API 密钥，请在 ComPDF Portal 注册或登录。首次使用时，按提示提供密钥，并确认将其存储在此 Skill 专属的 api_key 文件中；之后的请求将重复使用已存储的密钥。