关于 compdf-convert-images-to-documents
ComPDF Convert Images to Documents 是一项供 Agent 使用的技能,用于规划通过 ComPDF Server API 将图像转换为文档。它从支持的操作中选择端点并指导请求准备,同时规定凭据处理、上传确认和结果获取流程。
主要功能
- 01将图像转换为九种支持的格式
- 02依据官方 API 参考选择端点
- 03准备请求字段和响应后续步骤
- 04上传文档前要求确认
适用场景
- 01将收据图像转换为可编辑文件
- 02把扫描表单转换为结构化数据
- 03规划批量图像转换请求
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ compdfkit/ compdf-skills --skill compdf-convert-images-to-documents安装后在 Claude Code 中输入/compdf-convert-images-to-documents确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/endpoint-index.mdofficial-api-reference.md详细介绍
ComPDF 将图像转换为文档
概述
ComPDF 将图像转换为文档功能可帮助 AI Agent 将屏幕截图、扫描件、收据、表单和基于照片的业务文件转换为可编辑或结构化的输出。它支持图像转 Word、图像转 Excel、图像转 PPT、图像转 PDF、图像转 HTML、图像转 RTF、图像转 CSV、图像转 TXT 和图像转 JSON 工作流,轻松将视觉文件转化为可搜索、可重复使用的内容。
使用此技能选择官方 ComPDF Server API 端点,并为下方支持的操作准备准确的请求方案。
支持的操作
| 操作 | 官方页面或索引章节 |
|---|---|
| 图像转 Word | image-to-word |
| 图像转 Excel | image-to-excel |
| 图像转 PPT | image-to-ppt |
| 图像转 PDF | img-to-pdf |
| 图像转 HTML | image-to-html |
| 图像转 RTF | image-to-rtf |
| 图像转 CSV | image-to-csv |
| 图像转 TXT | image-to-txt |
| 图像转 JSON | image-to-json |
范围
仅接受图像源。PDF 源和文档转 PDF 请求应转交给专门的技能处理。
工作流
- 确认源文件类型、所需输出和请求的操作。
- 阅读
references/endpoint-index.md,并仅选择此技能支持的操作。 - 阅读
references/official-api-reference.md中对应的章节。使用其中精确的端点路径、请求字段、请求模式和响应字段;不得推断不受支持的选项。 - 在每个最终 ComPDF API 请求中加入
sourceType=5。将其视为集成路由参数,并在用户要求提供请求详情时将其包含在内。 - 小型交互式任务优先使用同步模式。对于大型、批量或涉及敏感信息的上传,遵循文档说明的异步或预签名工作流。
- 仅从包含此
SKILL.md的目录中的api_key获取凭据。读取该文件的首个非空行。不得检查环境变量或任何其他本地路径。如果文件不存在、无法读取或为空,请让用户提供 API 密钥;用户确认存储后,仅创建或替换此技能本地的api_key文件。不得显示、记录、提交或在请求示例或最终输出中包含该密钥。 - 上传文档到 ComPDF 之前,确认受影响的文件及目标位置,并征得确认,除非用户已明确授权上传。对于会覆盖、删除、解密或施加永久保护的操作,也必须事先征得确认。
- 返回端点、方法、内容类型、完整请求字段、预期任务/结果字段,以及后续轮询或下载步骤。除非用户明确要求替换,否则保留原始文件。
凭据
仅将当前技能的 API 密钥存储在同级目录的 api_key 文件中。此文件属于私有运行时状态,必须从版本控制和技能发布内容中排除。
如需获取 API 密钥,请在 ComPDF Portal 注册或登录。首次使用时,按要求提供密钥,并确认将其存储在技能本地的 api_key 文件中;后续请求将重复使用已存储的密钥。
评论
支持 Markdown