SuperAPI AI 工具集

sp-brand-kit

设计与创作

查看项目

更新于 10-20 04:28

技能介绍

sp-brand-kit 是 super-prototyping 技能集合中的一个技能,用于为某个产品的原型画布补充品牌素材行。画布文件夹原本存放的是用户自己构建的 HTML 画板(boards),该技能在同一个文件夹中加入第二类行:公司公开发布的图片素材,以图片形状而非画板形式呈现,包括 logo、字体样张、商店截图、社交帖子、广告创意和新闻摄影。

用途与设计理念 该技能的核心目的是按列进行纵向对比。每一行代表一个“表面”(surface),而不是素材类型,因此 X 上的头像位于 Instagram 头像之上、再接 TikTok 头像,若某个平台上出现不一致,会直接以列中断点的方式显现,而无需额外查找。

产出结构 产出目录为 canvases/<slug>/,其中 assets/brand/ 下包含:

  • manifest.json:记录源,按规范顺序列出各行
  • identity/、social/、stores/、ads/、press/ 五个子目录
  • gen.py:读取 manifest 并将其行追加到 layout.json
  • layout.json:画布和品牌页实际渲染的内容 assets/brand/ 是 assets/ 中唯一被画布赋予 URL 的部分;生成器会把 assets/ 下的其他内容以内联 data: URI 方式嵌入画板,因此需要独立成形状的图片必须放在这里。

七个步骤

  1. 先查看一个已完成的示例:运行 sp fetch 获取示例项目路径,再从其中打印 manifest 的行。若未安装 sp,需运行对应安装脚本并遵循参考文档中的安装说明。
  2. 查找公司自己的品牌或新闻资料包,全分辨率 logo、字体和颜色值优先从此处获取。
  3. 商店列表:批量获取最可靠的来源,API 可一次性返回全部截图。
  4. 社交平台:头像、横幅以及每个平台 4–8 张已发布视觉素材。每个账号必须先验证。
  5. 营销网站与新闻室:主视觉、功能页插图、og:image 卡片、新闻摄影。
  6. 校验每个文件:字节、扩展名、尺寸、大小、重复项,校验脚本必须输出 NO PROBLEMS。
  7. 编写 manifest、接入 gen.py、重新生成并在浏览器中查看。

行标题规范 行标题来自固定词汇表,写入的行必须作为其子序列出现(保持顺序,可跳过不适用的项):Logo & wordmark、Typeface、Art direction、Applied identity、X、Instagram、TikTok、YouTube、LinkedIn、App Store、Google Play、Microsoft Store、Announcement cards、Paid advertising、Press photography。其中 Art direction 指公司自己发布的图像风格(插画系统、主视觉、摄影处理等),Applied identity 指身份在实物上的应用(产品 UI、海报、标识、活动舞台、周边等)。不得自创行标题;若某表面不存在则留空,空行是错误。

收录规模 12 个带品牌套件的社区项目素材量为 50 到 144 个,多数在 70 到 120 之间。广覆盖比单一来源的堆量更重要,每个社交平台 4–8 张已发布视觉素材优于某个商店的四十张截图;但商店行会收录该商店全部素材。

五条决定收录的规则

  1. 来源必须二元且不可猜测:"theirs" 表示公司自己发布;"archive" 表示可追溯原始出处和日期的品牌档案。两者都无法确立的素材不得收录。
  2. 验证账号而非句柄:不信任任何给定的句柄,需确认可解析、在存在验证机制时已通过验证、且属于正确公司。仿冒和休眠账号很常见。
  3. HTTP 200 不代表页面存在:营销网站和新闻室常为单页应用,对任意路径都返回 200,应检查渲染后的 <title>,并先用故意错误的 slug 对照通用标题。
  4. 相同字节即同一素材:每批下载后用 md5 检查重复,若有冲突删除新副本;裁剪和缩放副本不会被工具发现,需人工比对并保留较大者。
  5. 扩展名必须与字节一致:以 file 命令为准,PNG 存成 .jpg 等情况需重命名;HEIF 需转换而非重命名,因为浏览器无法绘制。

文件分组与命名 五个目录:identity(logo、字体样张、颜色、艺术指导、应用身份)、social(X、Instagram、TikTok、YouTube、LinkedIn)、stores(App Store、Google Play、Microsoft Store)、ads(付费广告创意、公告卡片)、press(新闻摄影)。文件名应说明其内容,如 x-avatar.jpg、appstore-iphone-03.jpg、wordmark-black.svg。若 assets/brand/ 下已有被生成器内联到画板的非品牌图片(如模型使用的头像),应保持原样并从 manifest 中排除,并将其路径加入校验脚本的 IGNORE 集合。

接入方式 在目录常量旁增加 BRAND_DIR = OUT / "assets" / "brand",并在行列表完成处加一行读取 manifest 的代码(根据生成器形态选择对应写法)。品牌行放在所有画板行之后,读取无条件执行,不加存在性判断;须在 manifest 存在后再添加该行。运行 python3 gen.py 后检查 layout.json 的差异是否为纯新增;若出现删除行,应停止并排查,否则重新生成会提交损坏。画布会自动识别该文件夹,行会渲染,工具栏出现“Brand kit”按钮,品牌页切换器也会加入该文件夹。

报告前在浏览器中验证 打开画布页和品牌页两个地址。在品牌页而非画布上运行图片加载脚本:强制所有图片 eager 加载并解码,统计 naturalWidth 为 0 的数量,必须为 0。画布以 tldraw 形状绘制品牌行并会裁剪屏幕外内容,因此该处计数无意义,应缩放至适应后目视检查。

报告内容 需包含:校验脚本完整输出(含行表格);公司是否发布正式品牌或新闻资料包及其 URL;使用并验证过的账号、句柄和商店 ID,以及被发现错误、休眠、仿冒或属于其他公司的情况;每个被拒绝候选及原因(404、被阻止、非第一方、过小、重复、错误公司);无法访问的内容需区分“不存在”与“从此处被阻止”。如实说明缺口优于填充材料。