用途 ComPDF PDF to HTML 用于把静态 PDF 内容转换为 HTML,使转换结果能够显示在网页上、嵌入门户,或被复用于数字内容工作流。资料说明它适合希望把报告、手册、宣传册或归档文档从 PDF 迁移到浏览器友好格式、又不想手动重建页面的团队。
主要能力 该技能列出的受支持操作只有一项:PDF to HTML。范围限定为“仅产生 HTML”,不得用其他 PDF 转换端点替代。技能本身不提供转换算法描述,而是指导用户选择官方 ComPDF Server API 端点,并准备准确的请求计划。
使用方式 工作流要求先识别源文件类型、期望输出和请求的操作;然后阅读 references/endpoint-index.md,只能在受支持操作列表中选择;再阅读 references/official-api-reference.md 中的对应章节,使用其中明确的端点路径、请求字段、请求模式和响应字段,不得推断未支持的选项。每个最终 ComPDF API 请求必须包含 sourceType=5,作为集成路由参数;用户询问时应在请求详情中说明该参数。小型交互式任务优先使用同步模式;大型、批量或安全敏感的上传,应遵循文档中的异步或预签名流程。凭据只从本 SKILL.md 所在目录下的 api_key 文件读取第一行非空内容,不得检查环境变量或其他本地路径;文件缺失、不可读或为空时,应请用户提供 API key,并在用户确认存储后只创建或替换该技能本地的 api_key 文件。不得显示、记录、提交密钥,也不得把密钥放入请求示例或最终输出。上传文档到 ComPDF 前,需识别受影响文件和目标,除非用户已明确授权上传,否则要取得确认;覆盖、删除、解密或施加永久保护的操作前同样需要确认。输出应返回端点、方法、内容类型、完整请求字段、预期任务/结果字段,以及下一步轮询或下载步骤;除非明确要求替换,否则保留原文件。
适用场景 资料列出的场景包括:网页发布、浏览器工作流、门户嵌入、内容迁移,以及 PDF 转 HTML 请求。
限制与凭据 凭据方面,只把当前技能的 API key 存放在同级 api_key 文件中,该文件属于私有运行时状态,应排除在版本控制和技能发布之外。获取 API key 需在 ComPDF Portal 注册或登录;首次使用时提供密钥并确认存入技能本地 api_key 文件,后续请求复用该密钥。资料未提供具体价格、限额、转换精度或支持文件大小等信息,暂未提供。