compdf-pdf-to-html

ComPDF PDF 转 HTML

概述

ComPDF PDF 转 HTML 可帮助用户和 AI Agent 将静态 PDF 内容转换为 HTML，以便在网页上显示、嵌入门户网站，或在数字内容工作流中重复使用。对于希望将报告、手册、宣传册或存档文档从 PDF 转换为适合浏览器的格式，而无需手动重建页面的团队来说，这项工具非常实用。

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

支持的操作

操作	官方页面或索引部分
PDF 转 HTML	pdf-to-html

范围

仅生成 HTML。不要替换为其他 PDF 转换端点。

工作流

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 文件里；之后的请求会重复使用已存储的密钥。