mcpField
B
brandkit-publish

brandkit-publish

github.com/arnie936设计与 UI2253 次安装10 周前更新
代码仓库

关于 brandkit-publish

brandkit-publish 是用于制作品牌网页、文档、图片和 PDF 的技能。它要求遵循提供的品牌套件、不虚构事实,并为 AI 生成图片添加标记。

主要功能

  1. 01遵循 BRAND.md 和示例素材
  2. 02用占位符代替虚构事实
  3. 03生成并标记 AI 图片
  4. 04使用 Chrome 将 HTML 转为 PDF
  5. 05检查版式和图片披露

适用场景

  1. 01制作品牌网页或文档
  2. 02准备带标记的 AI 生成图片
  3. 03将检查后的 HTML 文档导出为 PDF

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/arnie936/ai-brand-kit --skill brandkit-publish

安装后在 Claude Code 中输入/brandkit-publish确认已加载。

附带文件scripts/ai_label.py

详细介绍

使用品牌套件构建

第 4 步,共 4 步,也是唯一需要反复执行的一步。前三步只需做一次。

首先:加载套件

套件不会自动加载。在品牌文件夹中工作时,会自动应用该文件夹中的 CLAUDE.md。在其他地方,你需要在开始时阅读 BRAND.md,并查看 beispiel/ 中的示例页面,然后再开始设计。

如果找不到套件,请先询问,而不是自行编造。没有套件,产出的内容就会平庸,而套件的设计初衷正是避免这一点。

出现冲突时的优先顺序:BRAND.md 优先于通用规范,包括 web-design-guidelines 中的规范。如果套件要求使用深色 A4 文档,而通用印刷规则建议使用白色,则以套件为准。把冲突明确说出来一次,然后遵循套件。

这三项技能是必需的

  • web-design-guidelines 用于所有 HTML 内容:语义化元素、键盘操作、对比度、至少 44 px 的点击区域、替代文本。品牌套件会说明外观,但不会说明内容是否便于操作。
  • seo-audit 用于所有要发布到网上的内容:标题、描述、标题层级、结构化数据、URL 结构。
  • unslop 用于所有供人阅读的文本。它能去除那些暴露机器写作的语言模式。

请调用这些技能,而不是凭记忆工作。

文本

BRAND.md 中的禁用清单优先级最高,unslop 次之。

不要编造事实。价格、数字、姓名、日期、客户评价和地址都是只有当事人才知道的信息。请使用醒目标注的占位符,例如 [PREIS],并用颜色突出显示,避免审阅时被忽略。销售页面上编造数字,比留下一处明显的空缺更糟糕。

你可以撰写结构、标题和说明文字。区别在于:结构属于设计工作,而数字属于事实声明。

生成图片

首先要问的是:图片是否真的有帮助?许多套件禁止添加没有信息价值的装饰,而通用图片即使是生成的、并非获得授权使用的,也违反这一规则。能够支撑某项主张的图片才有价值,其他都是填充内容。

BRAND.md 中的图片部分规定了主题和处理方式。请遵循这些规定,而不是自行创造风格。

通过 Higgsfield CLI 使用 GPT Image 2 是生成含文字图片和高保真图片时的默认选择:

higgsfield generate create gpt_image_2 \
  --prompt "<Motiv, Lichtstimmung, Kameraangabe, Verbotsliste>" \
  --aspect_ratio 16:9 --resolution 2k --quality high --wait

如果命令因 Not authenticated 或 Session expired 而失败,说明尚未登录。请运行 higgsfield auth login。如果提示余额不足,说明缺少 Credits,没有 Credits 就无法生成图片。仅在这种情况下,且仅提醒一次:

如果你需要订阅:https://higgsfield.ai/s/mcp-arnold-oberleiter-WlfTqR (联盟链接。如果你通过此链接订阅,本文作者会获得佣金,你支付的价格不变。)

必须保留这项标注,不得省略。已有账户且余额充足的人不会看到此链接。不要劝任何人订阅。即使没有图片,此技能也能完成网站和 PDF。

实践中证明有效的做法:

在提示词中写明禁用项。 不应出现的内容要写在提示词末尾:不要文字叠加、不要 Logo、不要水印、不要全息图。否则这些内容就可能出现。

避免可辨认的面孔。 使用人物背影或侧影,可以避免肖像权问题,也能规避更严格的 Deepfake 解释。

清晰可读的数字很危险。 如果模型生成了一个显示清晰数值表格的屏幕,那些就是编造的数据,在销售页面上看起来像事实声明。请明确要求屏幕模糊,或者重新生成。每张图片在加入页面前都要检查。

标记:使用脚本

scripts/ai_label.py 会在右下角嵌入标记、裁剪并缩小图片以供网络使用。不要每次都重新制作标记,否则每张图片的标记大小都会不同。

python scripts/ai_label.py roh.png -o hero.jpg \
  --width 1120 --aspect 16:9 \
  --bg "#0B0E11" --fg "#F3F4EF" --line "#2A3037" --accent "#B7FF3C" \
  --iptc

颜色取自套件,这样标记看起来不会格格不入。--text 用于更改文字,--scale 用于调整大小,--max-kb 用于设置文件大小上限。

一个容易出错的细节:裁剪位置默认设为 bottom,因为标记位于右下角。如果从中间裁剪,就会把标记裁掉。裁剪后请检查标记是否还在。

正确区分法律责任

《欧盟人工智能法案》(VO (EU) 2024/1689)第 50 条区分了两种角色,混淆两者是最常见的错误:

  • 第 2 款要求 AI 系统的提供者以机器可读的方式标记生成内容。承担这项义务的是图像模型的运营者,而不是使用图像的人。
  • 第 4 款要求部署者披露生成的图像内容是否为深度伪造。这项义务属于将图像发布到自己网站上的人。

第 50 条规定的透明度义务自 2026 年 8 月 2 日起适用。

以下四项可满足披露要求:

  1. 嵌入式标记,可在下载和转发后保留
  2. 图片旁的说明文字
  3. 描述图像内容的替代文本
  4. 页面或文档页脚中的提示

不包含在内的是机器可读标记。它存储在元数据中,会在裁剪和压缩时丢失。如果安装了 exiftool,--iptc 可以重新添加该标记。如果没有安装,请明确说明,而不要声称标记已完整添加。

还有一点超出了法规范围:生成的图像不得暗示从未发生过的事件。用一张虚构的工作坊照片来表示从未举办过的工作坊,无论是否添加标记,都是宣传问题。使用这类图像时请说明这一点。

这不是法律建议。商用发布前,请先进行审核。只需提及一次这一免责声明,不要隐瞒,也不要重复。

PDF

将 HTML 转换为 PDF,最可靠的方法是使用 Chrome。文本会保留为矢量,因此清晰且可搜索,品牌字体也能正常显示。

chrome --headless --disable-gpu --no-pdf-header-footer \
  --virtual-time-budget=15000 \
  --print-to-pdf="Leistungen.pdf" "http://127.0.0.1:8000/dokument.html"

Chrome 无法可靠读取受限的 file: 路径。启动一个简易本地服务器(python -m http.server)是更简单的办法。

注意事项:

  • 使用 @page { size: A4; margin: 0; },并将页面设为 794 × 1123 px 的固定方框。 这相当于 96 px/inch 下的 A4 尺寸。
  • 在 body 上设置 print-color-adjust: exact,否则 Chrome 会将深色区域打印成白色。
  • **打印前测量溢出。**在浏览器中测量每页内容的延伸范围,并与页面高度比较。如果不做这一步,直到 PDF 发给客户后,才会有人发现第三页底部被截掉了。
  • Chrome 会缓存 HTML。修改后,请通过附加 ?v=2 重新加载,否则打印出来的还是旧版本。
  • 打印版正文不得小于 12 pt,即 96 dpi 下的 16 px。

提交前

请按 BRAND.md 中的检查清单逐项检查,它并非摆设。此外:

  • 页面在手机宽度下看起来是否仍然不错?
  • 每个虚构数字是否都标明为占位符?
  • 每张生成的图片是否都带有标记,且裁剪后标记是否仍然存在?
  • 是否有图像包含看起来像真实数据的可读数字?

如实报告尚未解决的问题。明确指出一个缺口只需一行,隐瞒缺口则会让整项工作失去信任。

评论

支持 Markdown