canva-brand-check

品牌检查器

将设计与用户的品牌套件进行对比，并逐项报告设计在哪些方面符合品牌规范、哪些方面有所偏离。这是一个专门针对品牌、具备品牌感知能力的 canva-design-feedback 版本：核心同样是只读的“读取设计，然后提出评价”，但评估标准是品牌套件。它绝不会修改设计。

品牌套件数据缺口——请先阅读

根据文档，Canva:list-brand-kits 会返回品牌套件的 ID、名称和缩略图。它可能不会返回机器可读的调色板（十六进制值）和字体系列。你的处理方式取决于实际获取的数据：

• 如果套件提供了颜色／字体 → 将这些确切的十六进制代码和字体名称作为评估标准（精确检查）。
• 如果套件只提供缩略图／名称 → 你无法精确匹配十六进制颜色／字体。请改为与套件缩略图进行视觉对比，并要求用户提供品牌颜色（十六进制值）和字体，以便精确检查。请明确说明，缺少这些信息时，颜色／字体检查结果只是近似判断。

切勿臆造品牌颜色或字体。如果没有真实值，请如实说明。

读取设计的实际颜色和字体

Canva:get-design-content 只返回文本，不包含颜色或字体。

• 只读编辑事务（Canva:start-editing-transaction → 检查 → Canva:cancel-editing-transaction，务必取消）可可靠地提供元素的文本、位置和尺寸。
• 事务无法可靠地提供颜色和字体——经测试，它通常只返回文本、位置和尺寸，不包含颜色／字体属性。因此，缩略图是颜色和排版的主要依据。如果载荷中包含样式数据，可以使用，但除非载荷中确实提供了设计的十六进制值或字体，否则切勿将其断言为事实。

由于品牌套件（见上文的数据缺口）和设计本身都经常缺少机器可读的颜色／字体，品牌检查通常需要进行视觉对比（设计缩略图与品牌套件缩略图），并结合用户提供的调色板／字体。使用 Canva:get-design-thumbnail 检查 Logo 的位置和整体视觉基调。

工作流

第 1 步：解析设计

短链接 → Canva:resolve-shortlink；完整 URL → 提取 ID；原始 D... ID → 直接使用；否则请询问用户。

第 2 步：获取品牌套件

• 调用 Canva:list-brand-kits。如果有多个，请询问用户要使用哪一个（或根据团队／上下文推断）。
• 记录套件提供的所有信息（名称、缩略图，以及存在的颜色／字体）。
• 按照上述数据缺口处理方式进行处理。如果缺少权限范围（例如“Missing scopes: [brandkit:read]”），请告知用户断开并重新连接 Canva 连接器，以刷新令牌。

第 3 步：读取设计

• 使用 Canva:get-design-thumbnail 查看视觉效果／Logo／基调。
• 使用只读事务（开始 → 检查 → 取消）检查实际使用的颜色和字体。

第 4 步：对照品牌进行比较

检查以下各项，并标记为符合品牌规范／不符合品牌规范／无法验证：

• 颜色 — 填充色／文字颜色／强调色是否属于品牌调色板？标出不在调色板中的十六进制值（并指出最接近的品牌颜色）。
• 排版 — 字体是否与品牌字体一致？标出非品牌字体系列，以及尺寸／字重使用不一致之处。
• Logo — 是否出现在预期位置、版本是否正确、是否存在拉伸／改色／拥挤情况（根据缩略图进行视觉检查）。
• 语气与文案 — 措辞是否符合用户描述的品牌语气？
• 一致性 — 品牌规范是否在所有页面中保持一致？

当品牌套件未提供所需数据且用户也未提供时，请如实标记为无法验证。

第 5 步：报告

## Brand check — "<design title>" vs "<brand kit name>"

Overall: ⚠️ Mostly on brand, 3 issues

### Off brand
- [Color] Page 2 heading is #1A73E8 — not in palette. Nearest brand color: #0B5CD7.
- [Font] Page 4 body uses Arial; brand body font is Inter.

### Can't verify (need input)
- Brand kit didn't expose hex values. Paste your palette + fonts for an exact check,
  or confirm the colors above against your guidelines.

### On brand
- Logo placement and cover treatment match the kit.

第 6 步：提出修复建议

提出通过 canva-edit-design 修正 API 可处理的问题——请注意，API 可以更改文字颜色和字体的大小／字重／样式，但无法更改字体系列或背景颜色（这些需要在 Canva 中手动调整；参见 canva-edit-design）。

规则

• 只读：检查后始终执行 cancel-editing-transaction。切勿提交。
• 切勿捏造品牌值——使用工具包中的真实数据或用户提供的信息，否则标记为 无法验证。
• 始终指出具体页面或元素，以及违规值和品牌值。
• 区分硬性违规（错误的徽标、非品牌色）和软性违规（间距略有不一致）。