截图转可编辑PPT

概述

截图转可编辑 PPT

通过发布者的 HTTPS 服务 https://api.arcdovion.com，把一张用户有权使用的截图转换成 PPTX。默认输出两页：第 1 页保留原图作为视觉参考，第 2 页提供可编辑文字、基础形状和连接线。

使用限制

仅接受一张清晰的 PNG 或 JPEG，内容应为单个、结构较规则的商务图。若图片不可读、包含多张幻灯片，或主体为照片、手绘插画、密集统计图、复杂渐变或艺术特效，应在免费预检阶段停止，不发起付款。

不要承诺像素级复刻。应说明特殊字体、图标、渐变及不规则几何可能被近似处理。用户必须拥有复制或改编源图片的权利。

调用前阅读 [references/hosted-api-contract.md](references/hosted-api-contract.md) 和 [references/input-output-contract.md](references/input-output-contract.md)。处理支付状态时阅读 [references/pay-skill-flow.md](references/pay-skill-flow.md)。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件并能调用 weixinpay_pay：

• 已安装：继续执行付费服务流程。
• 未安装：提示“当前 Agent 暂不支持微信支付付费能力”，终止流程，不上传图片、不创建订单。

工作流程

第一步：上传与免费预检

将图片作为 file 字段上传到 POST https://api.arcdovion.com/v1/uploads。使用返回的 upload_id 调用 POST https://api.arcdovion.com/v1/preflight：

{"uploadId":"上传接口返回的 upload_id"}

只有 supported 与 chargeable 均为 true 时才继续，否则告知用户拒绝原因，不发起支付。

第二步：请求付费重建资源

生成一个本次任务内保持不变的 requestId，调用 POST https://api.arcdovion.com/v1/reconstruct：

{"requestId":"稳定的请求ID","uploadId":"上传接口返回的 upload_id"}

第三步：处理 402 并发起支付

收到 HTTP 402 后，提取并原样保存响应 Header 中的 WeixinPay-Required（支付码）和 X-Out-Trade-No（订单号），两者都不能丢失或修改。

将 WeixinPay-Required 的完整值作为 paymentCode 调用 weixinpay_pay，向用户申请微信支付授权。不得自行解析、构造或替换支付码。

第四步：支付成功后必须重新请求

支付成功后，必须重新调用同一个 POST https://api.arcdovion.com/v1/reconstruct。Body 与第二步完全一致，并同时携带：

WeixinPay-Required: 第三步保存的支付码
X-Out-Trade-No: 第三步保存的订单号

仅允许一次支付授权和一次紧随其后的付后重试。不得改变 requestId，不得通过创建新订单规避错误。

第五步：下载结果

HTTP 200 时，将 download_url 拼接到 https://api.arcdovion.com 下载 PPTX，返回给用户并简要说明可编辑页及近似处理项。already_fulfilled: true 表示返回的是同一订单的缓存结果，不会重复扣费。

不得把 Agent 侧的支付成功提示自行推断为已完成交付；必须执行第四步，由服务端查单确认后获取结果。

隐私与安全

• 不索要密码、Cookie、访问令牌、API Key 或私钥。
• 不把上传截图用于模型训练，不在支付日志中记录截图内容或识别文字。
• 不向用户暴露服务器文件路径、存储凭据或内部错误详情。
• 上传原图与生成文件按服务披露的保留期自动删除。

成功标准

成功结果是一个可下载的 .pptx：参考页保留源图视觉，可编辑页的主要文字与规则图形可修改，连接线保持正确阅读关系，且不存在明显裁切、非预期重叠或断裂。