compdf-word-to-pdf

ComPDF Word 转 PDF

概述

ComPDF Word 转 PDF 专注于最常见的文档工作流之一：将 Word 文件转换为稳定、便于分享的 PDF。它可帮助团队为合同、报告、提案、手册和内部审批生成整洁的 PDF 输出，并尽可能保留字体、布局、图像和页面结构。

使用此技能可选择 ComPDF 官方服务器 API 端点，并为以下支持的操作制定准确的请求方案。

支持的操作

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

范围

仅接收 Word 源文件并生成 PDF。请勿将此技能用于其他 Office 格式。

工作流

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