claude-seo 图像生成品牌预设系统基于 presets.md 的品牌一致性规范与 CLI 管理实战【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 25 sub-skills 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, semantic clustering, e-commerce SEO, international SEO, Google APIs, and PDF/Excel reporting. Optional DataForSEO, Firecrawl, and Banana extensions.项目地址: https://gitcode.com/gh_mirrors/cl/claude-seo本文围绕 claude-seo 仓库中 presets.md 讲解的 Brand/Style Presets品牌/风格预设系统展开。该机制是seo-image-gen图像生成技能由 banana 扩展驱动 Gemini 模型实现多张图片风格统一、品牌资产可复用的核心手段。读完本文你将掌握预设的 JSON 数据规范、三类内置示例预设的结构拆解、预设如何合并进 Reasoning Brief推理简报六组件、以及通过presets.py命令行完成创建、查看、删除的完整管理流程并理解其与 SEO 场景预设seo-image-presets.md的叠加优先级。一、预设系统要解决什么问题在 SEO 内容生产中OG 社交分享图、博客 hero 图、商品图、信息图、favicon 需要保持品牌一致性相同的配色、字体气质、光照与情绪。如果每次生成都靠口头描述一遍品牌规范不仅低效而且容易漂移。预设系统把品牌 DNA沉淀为可复用的 JSON 文件让 Claude 在构图时自动代入默认值。从仓库结构看这套系统由三部分协作组成presets.md本文主题定义预设 Schema、示例预设、合并逻辑与 CLI 用法presets.py实际的命令行实现位于 banana 扩展脚本目录SKILL.mdseo-image-gen技能在生成流程中检查预设并应用默认值的入口说明。在 SKILL.md 的生成管线中第 3 步之后明确要求如果用户提到某个品牌或有已配置的 SEO 预设就执行python3 scripts/presets.py list并加载匹配预设作为默认值。这印证了预设系统在真实生成流程中的调用位置——它不是孤立的配置项而是管线的一个正式环节。二、预设数据规范Preset Schema每个预设以 JSON 文件形式存放在~/.banana/presets/NAME.json。仓库中给出的标准结构如下{ name: tech-saas, description: Clean tech SaaS brand, colors: [#2563EB, #1E40AF, #F8FAFC], style: clean minimal tech illustration, flat vectors, soft shadows, typography: bold geometric sans-serif, lighting: bright diffused studio, no harsh shadows, mood: professional, trustworthy, modern, default_ratio: 16:9, default_resolution: 2K }字段语义一览字段含义作用对象name预设唯一名称如tech-saas全局标识也是文件名description一句话品牌描述presets.py list时展示colors十六进制色板数组推理简报中的调色板描述style视觉风格描述矢量、插画、摄影等Style 组件基底typography字体气质描述任何需要渲染文字的图像lighting光照风格描述Lighting 组件基底mood品牌情绪基调Action / Context 组件default_ratio默认宽高比如16:9未指定比例时的兜底default_resolution默认分辨率如2K未指定分辨率时的兜底对照 presets.py 的cmd_create实现第 77-103 行可以确认该 Schema 的默认值行为default_ratio缺省为16:9default_resolution缺省为2Kdescription缺省为Custom preset: {name}其余文本字段style、typography、lighting、mood缺省为空字符串。也就是说即便你只传名称和 style脚本也会补全一份结构完整的预设文件。三、内置示例预设拆解仓库内置了三个可直接参考的品牌预设覆盖三种典型审美方向。tech-saas科技 SaaS 品牌配色#2563EB、#1E40AF、#F8FAFC蓝 白风格干净极简的科技插画、扁平矢量、柔和阴影字体粗体几何无衬线bold geometric sans-serif情绪专业、可信、现代适合SaaS 官网博客配图、产品功能说明图、技术白皮书封面。luxury-brand奢侈品牌配色#1A1A1A、#C9A96E、#FAFAF5黑 金 米白风格高级质感摄影、丰富纹理、强对比字体细体优雅衬线、宽字距情绪专属、精致、有追求适合高端消费品电商图、品牌故事页 hero、发布会视觉。editorial-magazine杂志编辑风格配色#000000、#FFFFFF、#FF3B30黑 白 点缀红风格大胆的编辑摄影、强几何构图字体紧缩全大写无衬线标题情绪大胆、挑衅、当代适合观点类文章配图、访谈内容、Newsletter 视觉。四、预设如何合并进 Reasoning Brief推理简报当预设处于激活状态时Claude 将预设值作为推理简报的默认值。仓库文档定义了 5 条映射规则Colors → Context 与 Style 组件色板被转写为调色板描述融入场景与风格段落Style → Style 组件基底风格描述直接成为 Style 组件的底稿Typography → 文字渲染任何需要出现文字的图像都依据字体气质描述Lighting → Lighting 组件基底光照描述直接成为 Lighting 组件的底稿Mood → Action 与 Context 组件情绪基调影响画面动作与场景设定。关于推理简报的六组件Subject / Action / Context / Composition / Lighting / Styleprompt-engineering.md 有完整说明每个组件都应写成自然语言叙事段落而非逗号分隔的关键词列表。例如 Subject 组件的示范写法是 A weathered Japanese ceramicist in his 70s, deep sun-etched wrinkles… 而非 old man, ceramic, bowl。预设合并正是发生在这些组件成形之前——预设提供品牌的底色推理简报负责画面的血肉。用户指令永远优先文档明确了一条硬性规则用户指令始终覆盖预设值。例如预设是明亮光照但用户明确说 make it dark则必须遵循用户的指令。这一原则保证了预设是默认值而非强制约束避免品牌规范压制创作自由度。五、预设管理presets.py 命令行实战预设的完整生命周期由 presets.py 管理支持list、show、create、delete四个子命令。列出预设presets.py list实现逻辑cmd_list第 53-68 行自动创建~/.banana/presets/目录扫描其中所有*.json逐文件读取并展示name文件名去后缀与description若 JSON 解析失败会标注 (invalid preset file) 而不中断整个列表。没有预设时输出创建提示。查看预设详情presets.py show tech-saas以格式化 JSON 完整输出指定预设cmd_show第 71-74 行预设不存在时向 stderr 报错并以非零码退出。创建预设presets.py create NAME --colors #hex,#hex --style ... --mood ...支持的完整参数对应cmd_create与 argparse 定义第 131-140 行参数说明默认值--colors逗号分隔的十六进制色值空数组--style视觉风格描述空字符串--typography字体气质描述空字符串--lighting光照描述空字符串--mood情绪基调描述空字符串--description一句话品牌描述Custom preset: {name}--ratio默认宽高比16:9--resolution默认分辨率2K值得注意的安全细节_sanitize_name第 27-34 行会用正则[^a-zA-Z0-9_\-]过滤掉预设名称中的路径分隔符等危险字符防止路径穿越同名预设已存在时拒绝覆盖并报错第 80-83 行。创建成功后脚本打印文件绝对路径并回显完整 JSON。删除预设presets.py delete NAME --confirm必须显式传入--confirm才会真正删除cmd_delete第 106-116 行防止误删目标不存在时同样报错退出。脚本说明该脚本仅使用 Python 标准库argparse / json / re / pathlib无第三方依赖可直接运行python3 extensions/banana/scripts/presets.py list六、预设与 SEO 场景预设的叠加规则除了品牌预设仓库还提供 SEO 场景预设模板seo-image-presets.md覆盖 og-default、blog-hero、product-white、social-square、infographic-vertical、favicon-mark 六类场景。两套预设的优先级逻辑如下用户指定使用场景命令og、hero、product 等→ 加载匹配的 SEO 场景预设用户提到品牌预设名 → 从~/.banana/presets/加载品牌预设覆盖 SEO 预设的 colors、mood、typographySEO 预设始终提供 aspect ratio 与 resolution 默认值。也就是说宽高比和分辨率这类技术性参数由 SEO 场景预设兜底而品牌视觉三要素配色、情绪、字体由品牌预设主导二者各司其职、按层叠加。这与 SKILL.md 中Use Case → Aspect Ratio / Resolution / Domain Mode映射表OG 用 16:9 1K、信息图用 2:3 4K 等完全一致。七、与生成管线、成本控制配套使用预设只是品牌一致性的输入端一次完整的生成还需要配合后续环节检查预设生成前执行presets.py list命中品牌预设则加载设置比例通过set_aspect_ratioMCP 工具详见 mcp-tools.md支持 1:1、16:9、9:16、4:3、3:4、2:3、3:2、4:5、5:4、1:4、4:1、1:8、8:1、21:9 共 14 种比例应用预设的default_ratio生成调用gemini_generate_image或以 generate.py 作为 MCP 不可用时的 REST API 兜底该脚本同样校验 512/1K/2K/4K 四档分辨率与合法比例与预设字段取值一致成本记录批量生成前用cost_tracker.py estimate --count N预估费用生成后cost_tracker.py log记账详见 cost-tracking.md。八、最佳实践小结为每个长期运营的品牌建一个预设把色板、风格、字体、光照、情绪一次性写入 JSON后续所有图像生成自动继承善用 CLI 缺省值创建时只传核心字段ratio/resolution 交给脚本默认值16:9 / 2K需要时再显式覆盖记住用户指令优先级预设是默认值不是枷锁用户的具体要求永远压过预设区分两类预设的职责品牌预设管视觉 DNAcolors/mood/typographySEO 场景预设管技术参数ratio/resolution配合后续 SEO 清单生成后按 SKILL.md 的清单补充 alt 文本、SEO 文件名keyword-description-widthxheight.webp、WebP 压缩与ImageObjectschema 标记让品牌一致的图片真正发挥 SEO 价值。【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 25 sub-skills 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, semantic clustering, e-commerce SEO, international SEO, Google APIs, and PDF/Excel reporting. Optional DataForSEO, Firecrawl, and Banana extensions.项目地址: https://gitcode.com/gh_mirrors/cl/claude-seo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考