compdf-page-editor

ComPDF 页面编辑器

概述

ComPDF 页面编辑器为 AI Agent 提供专注于 PDF 页面管理的技能，可用于组装、清理和重构文档。它支持合并多个 PDF、拆分大型文件、旋转页面、插入新页面、删除页面，以及提取选定页面或范围。此技能适用于审核、归档、交付或自动化之前的文档准备工作流。

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

支持的操作

操作	官方页面或索引章节
合并 PDF	merge
拆分 PDF	split
旋转页面	rotate
插入页面	insert
删除页面	delete
提取页面	extract

范围

仅使用页面管理端点。验证从 1 开始的页面范围；除非已获得授权，否则对破坏性编辑请求确认。

工作流

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

凭据

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

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