Canva

核心用法

Canva Skill 基于官方 Connect API 封装，实现设计资源的程序化调用。核心能力包括：

1. 模板化创作：通过 /autofills 端点调用品牌模板（Brand Templates），自动填充文本内容批量生成 Instagram 帖子、轮播图等社媒素材
2. 异步导出引擎：支持 PNG/JPG/PDF/MP4/GIF 多格式导出，导出任务异步执行需轮询状态
3. 资产管理：支持本地图片上传至 Canva 云资源库，便于跨设计复用
4. 批量工作流：支持设计列表获取、批量导出与本地缓存模板 ID 以优化性能

显著优点

• 官方 API 背书：直接调用 Canva 官方 Connect API，与网页端设计能力对齐
• 模板驱动效率：复用品牌预设模板，避免从零设计，保证视觉一致性
• 多格式输出：覆盖静态图、动图、视频、印刷 PDF 全场景
• 自动 Token 刷新：内置 OAuth 2.0 令牌管理，减少认证维护成本

潜在局限

• 异步流程复杂：导出任务需二次轮询，无法同步直链下载
• 速率限制严格：上传/导出仅 30 req/min，批量场景需主动节流
• 模板依赖：高质量输出依赖预置品牌模板，无 AI 生成能力
• 仅支持个人账户：需用户自行创建 Integration 并配置 Client ID/Secret

适合人群

社媒运营团队、内容自动化开发者、品牌设计师需批量产出标准化图文

常规风险

• OAuth 凭证（CANVA_CLIENT_ID/SECRET）需妥善保管，避免硬编码提交
• 令牌存储于本地 ~/.canva/tokens.json，多用户环境需权限隔离
• 高频调用易触发 429 限流，建议配合指数退避重试

概述

Canva Skill 是一款基于 Canva Connect API 的命令行工具，允许用户通过代码方式调用 Canva 的核心设计能力，实现从模板创建、内容自动填充到多格式导出的完整工作流自动化。

核心用法

该 Skill 主要支持以下操作：

• 设计管理：列出设计列表、获取设计详情、基于品牌模板创建新设计（Autofill）
• 内容生成：通过 JSON 数据填充模板字段，快速生成 Instagram 帖子、轮播图等社媒素材
• 资产操作：上传图片到 Canva 资产库，调用品牌模板
• 批量导出：支持 PNG、JPG、PDF、MP4、GIF 等格式，可自定义尺寸与质量参数

典型工作流为：获取品牌模板 → 自动填充内容 → 提交导出任务 → 轮询获取下载链接。

显著优点

• 功能边界清晰：专注 API 集成，无多余功能，220 行 bash 代码结构简洁
• 零第三方依赖：仅使用系统标准工具（curl、jq、openssl），降低供应链攻击面
• 官方 API 背书：直接调用 Canva Connect 官方接口，数据走 HTTPS/TLS 1.2+
• OAuth 自动刷新：内置令牌生命周期管理，减少人工干预

潜在缺点与局限性

• 异步导出需轮询：导出任务为异步执行，需自行实现状态检查逻辑
• 速率限制严格：普通端点 100 req/min，导出/上传仅 30 req/min，大规模批处理需限速策略
• 模板依赖前置：需先在 Canva 账户中配置好品牌模板（Brand Templates），无法从零创建设计
• 纯命令行交互：无 GUI 辅助，新手用户需熟悉 OAuth 流程与 API 参数

适合人群

• 内容运营团队：需批量生成社媒素材、保持品牌视觉一致性的营销人员
• 自动化工作流开发者：希望将设计环节集成到 CI/CD 或内容发布管道的工程师
• Canva Pro/Teams 用户：已使用品牌套件（Brand Kit）并具备 API 访问权限的企业账户

常规风险

• Token 本地存储：OAuth 令牌保存在 ~/.canva/tokens.json，虽设 600 权限但仍建议评估系统整体安全性
• 个人维护来源：T3 级别个人开发者项目，长期维护与代码审计频率存在不确定性
• API 依赖风险：功能完全依赖 Canva 服务可用性与 API 政策稳定性

安全建议

• 考虑使用系统密钥环替代明文存储 OAuth 令牌
• 定期轮换 Canva Client Secret
• 实现指数退避重试以优雅处理 429 限流