用途
该技能用于在 Canva 中操作资产、品牌模板自动填充与文件夹，核心原则是将资产上传、数据集发现、自动填充和文件夹变更视为相互独立的授权域。它要求重新读取 schema 并对异步任务进行核对，而不是假设旧字段仍然有效或任务已经完成。
主要能力
- 资产上传与资产元数据变更
- 模板数据集读取
- 品牌模板自动填充
- 文件夹变更
使用方式
前置条件
- 已授权的所有者、租户、操作和目标
- 显式的资产、设计、品牌模板或文件夹作用域
- 已批准的文件权限、数据分类和清理策略
操作步骤
- 选择单一操作：识别是上传、资产元数据变更、模板数据集读取、自动填充还是文件夹变更。不要将不相关的写入捆绑到一次审批中。
- 验证权限与输入：确认资源所有权、文件类型/大小是否符合当前端点、恶意软件策略、模板可用性以及每个请求的显式作用域。
- 安全提交上传：对于二进制或 URL 上传，记录操作和任务 ID，避免记录源 URL 或内容，并轮询对应的现有任务。
- 刷新数据集：在自动填充前立即读取当前模板或设计数据集。拒绝未知的必填字段，并说明不存在的字段名可能被跳过。
- 谨慎执行自动填充：确认当前权益和预览状态，验证每个数据值，提交一次，并在暴露结果设计之前核对任务。
- 应用文件夹变更：验证源/目标授权和预期当前状态，进行一次有界变更，然后读回元数据并记录回滚。
认证
Canva Connect 调用使用 Bearer 访问令牌，该令牌由后端通过 OAuth 2.0 授权码加 SHA-256 PKCE 获取。请求显式的最小权限作用域，将客户端密钥和令牌保持在浏览器可见状态之外，并串行化刷新，以便原子地存储替换用的单次使用刷新令牌。
工具纪律
使用 Read 和 Grep 进行发现和取证。仅对已批准的工件、代码、配置、测试或本工作流描述的收据使用 Write 或 Edit；不要进行未经批准的 Canva 侧更改。
输出
- 有作用域的决策或实现工件
- 脱敏的操作和验证收据
- 失败、回滚和后续责任记录
示例
上传已批准的营销活动资产，获取当前品牌模板数据集，自动填充已授权字段，并且仅在每个任务和所有权检查成功后移动结果设计。
错误处理
- 数据集已更改：停止并重新验证输入映射
- 上传任务失败：在重新提交前纠正已记录的原因
- 自动填充不可用：不要建议升级计划；报告当前能力证据
- 文件夹状态偏离：停止进一步移动并核对所有权
适用场景
适用于需要严格授权控制、异步任务对账和显式作用域管理的 Canva 资产、模板自动填充与文件夹操作场景。
限制
- 需要已授权的所有者、租户、操作和目标
- 需要显式的资产、设计、品牌模板或文件夹作用域
- 需要已批准的文件权限、数据分类和清理策略
- 自动填充不可用时，不应建议升级计划，只能报告当前能力证据
- 不存在的字段名可能被跳过
- 其他具体限制暂未提供