SuperAPI AI 工具集

portal-branding

设计与创作

查看项目

更新于 10-15 23:47

技能介绍

用途:在 Kong Konnect Dev Portal 的 MDC 页面中复现某个品牌或现有网站的视觉风格,包括颜色、字体、图像与间距,工作对象是 MDC 页面文件(本地或仓库中)。除非用户明确要求,否则不通过 Konnect API 向线上门户推送破坏性变更。

主要能力:先确认来源(URL 或品牌描述)、目标页面、必须精确与可近似的细节、浅色或深色基调;再提取品牌线索(主色与强调色的十六进制值、基调、标题/正文/等宽字体及字重、Logo 与图标等图像、间距与圆角风格),并用 Playwright 在桌面与移动宽度截图对照。应用品牌有两个层面:门户主题(品牌色、字体、布局、Logo、favicon,经 MCP 服务器的定制操作设置,主色令牌族由主题主色派生)与页面级样式(组件专用外观属性如 background-color、padding、border、border-radius,以及内联 span 样式)。随后进行一致性循环:格式化并校验 MDC,生成预览,在移动、平板、桌面宽度截图对比,按基调、品牌色、字体、间距形状、细节的顺序修复最大差异。

使用方式:需配合 portal-page-design 工具链与 Konnect MCP 服务器;未连接 MCP 时无预览与一致性循环,只能基于通用 MDC 知识工作并让用户在 Portal Editor 中预览,结果可靠性较低。截图与对比需要浏览器自动化(Playwright 或代理浏览器)。预览 URL 一次性且有时限,MDC 变更后才需重新生成,加载后可在原地调整浏览器尺寸测试各宽度。

限制与注意:预览使用目标门户主题,--kui-* 主色表面显示的是门户品牌色而非来源色,判断品牌一致性前需先设置门户主色,或在品牌关键表面使用显式十六进制值。--kui-* 值应从服务器设计令牌获取。Logo、favicon 与 API 图像有专用上传操作,任意内联内容图像无上传器,需 HTTPS 热链或内联 SVG。门户内部类名不是稳定契约,应使用组件属性与内联样式。对比度需满足 WCAG AA(正文 4.5:1,大文本 3:1)。无法在页面表达的元素应给出近似方案或明确说明,不得静默忽略。相关交接:portal-page-design、technical-writing、terraform-konnect 或 kongctl-declarative、konnect-api-publish 或 konnect-app-auth。