claude-seo Banana 扩展:品牌/风格 Presets 参考指南——用预设实现 SEO 图片生成的一致性
【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载导读本篇技术指南围绕 claude-seo 仓库中 Banana 图片生成扩展的Brand/Style Presets品牌/风格预设体系展开它定义了预设文件的 JSON 结构colors、style、typography、lighting、mood等字段规定了预设如何与 Creative Director 流水线中的 6 组件 Reasoning Brief 合并并提供了一套完整的presets.py命令行管理工具。读完本文你将掌握预设的 Schema 与存储位置、内置品牌预设示例、预设合并到提示词的工作机制、presets.py的全部子命令与参数、SEO 场景下的预置模板OG 图、博客 Hero、产品图等及其选择逻辑并能在批量生成batch与成本追踪流程中落地使用。一、Preset 是什么为品牌一致性而生的参数包在 Banana 扩展extensions/banana/README.md的图片生成流水线中Claude 扮演Creative Director创意总监它从不把用户的原话直接丢给 API而是分析意图、选择最优 domain mode并按照一套经过验证的6 组件 Reasoning Brief构造优化提示词见 references/prompt-engineering.md。问题在于如果每次生成都从头描述品牌视觉语言不仅低效而且极易产生风格漂移——同一站点不同文章的配图颜色、字体、氛围对不上号。Preset 正是解决这一问题的品牌参数包把一个品牌/风格的视觉决策集中封装成一份 JSON 文件在每次生成时作为 Reasoning Brief 的默认值加载从而保证跨批次、跨页面的一致性。它是 claude-seo 将 AI 图片生成从单张好看提升到整站视觉统一的关键机制。二、Preset Schema文件结构与字段语义每个 preset 以独立 JSON 文件的形式存储在用户主目录下~/.banana/presets/NAME.json该路径由 scripts/presets.py 中的PRESETS_DIR Path.home() / .banana / presets定义与成本台账~/.banana/costs.json见 references/cost-tracking.md同属于~/.banana管理目录。完整 Schema来自 references/presets.md{ 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 }各字段的语义与对 Reasoning Brief 的影响字段含义合并方向见下文第三节name预设唯一标识同时是文件名NAME.json引用入口description一句话描述品牌风格便于list时识别说明信息colors品牌色板hex 数组→ Context 与 Style 组件中的调色板描述style视觉风格描述→ Style 组件的基底typography文本渲染的字体描述→ 涉及文字渲染的组件lighting光照方案→ Lighting 组件的基底mood情绪基调→ Action 与 Context 组件default_ratio默认宽高比如16:9覆盖生成请求的宽高比默认值default_resolution默认分辨率如2K覆盖生成请求的分辨率默认值从 scripts/presets.py 的cmd_create可以看到create命令写入的正是上述完整 Schema其中default_ratio与default_resolution在命令行未显式给出时分别默认16:9与2Kdescription缺省时自动生成为Custom preset: NAME。安全细节_sanitize_namescripts/presets.py会对预设名做白名单清洗只保留字母、数字、连字符与下划线从实现层面防止通过预设名进行路径穿越。三、内置示例 Preset 剖析references/presets.md 给出了三个可直接参考的品牌级示例覆盖三种截然不同的视觉方向tech-saas科技 SaaSColors:#2563EB、#1E40AF、#F8FAFC蓝 白Style:干净极简的科技插画、扁平矢量、柔和阴影Typography:粗体几何无衬线Mood:专业、可信、现代适合软件类站点的 OG 图、产品页与博客 Hero蓝色系自带信任感与 SaaS 行业的普遍审美一致。luxury-brand奢侈品Colors:#1A1A1A、#C9A96E、#FAFAF5黑 金 米白Style:优雅高端摄影、丰富质感、高对比Typography:细长优雅衬线体、宽字距Mood:专属、精致、令人向往黑金配色加衬线字体是奢侈品视觉的经典组合适用于高端品牌、精品电商。editorial-magazine编辑杂志风Colors:#000000、#FFFFFF、#FF3B30黑 白 强调红Style:大胆的编辑摄影、强几何构图Typography:紧凑大写无衬线标题Mood:大胆、挑衅、当代黑白底加高饱和强调色适合媒体、评论、观点类内容。这三个示例印证了 preset 的设计哲学视觉决策被浓缩为颜色 风格 字体 光照 情绪五元组字段足够少、语义足够清晰既能被 Claude 稳定解读又能被人类快速维护。四、Preset 如何合并进 Reasoning Briefreferences/presets.md 明确规定当某个 preset 处于激活状态时Claude 会将其字段值作为 Reasoning Brief 各组件的默认值使用Colors→ 为 Context 与 Style 组件提供调色板描述Style→ 成为 Style 组件的基底Typography→ 用于任何需要文字渲染的部分Lighting→ 成为 Lighting 组件的基底Mood→ 影响 Action 与 Context 组件合并遵循一条硬性优先级规则用户的即时指令永远覆盖 preset 值。例如 preset 配置了明亮光照但用户说make it dark则以用户的指令为准。这意味着 preset 是默认值层而非强制约束层——它提供一致性基线但保留人工干预的弹性。这条机制与 references/prompt-engineering.md 的 6 组件系统Subject 30%、Style 25%、Context 15%、Action 10%、Composition 10%、Lighting 10%天然契合preset 恰好为其中 Style / Context / Action / Lighting 这四个权重合计 60% 的组件提供预制素材把每次生成中最容易漂移的部分锁定下来。五、Preset 管理命令presets.py 全参数手册预设的增删改查全部由 scripts/presets.py 承担。该脚本仅依赖 Python 标准库argparse、json、re、pathlib无需额外安装依赖。基础命令# 列出所有预设含描述目录不存在时会自动创建 presets.py list # 查看某个预设的完整 JSON 详情 presets.py show tech-saas # 交互式创建Claude 从对话中提取细节补全字段 presets.py create NAME --colors #hex,#hex --style ... --mood ... # 删除预设必须带 --confirm 确认 presets.py delete NAME --confirmcreate 的完整参数对应 Schema 各字段参数类型/默认值说明name位置参数必填预设名仅允许[a-zA-Z0-9_-]--colors逗号分隔 hex默认品牌色板内部会逐项strip()清洗--style字符串默认视觉风格描述--typography字符串默认字体描述--lighting字符串默认光照描述--mood字符串默认情绪基调--description字符串默认缺省时自动生成为Custom preset: NAME--ratio默认16:9默认宽高比--resolution默认2K默认分辨率行为要点与源码对应幂等保护create在目标文件已存在时会报错退出scripts/presets.py防止误覆盖。删除必须确认delete不带--confirm直接报错scripts/presets.py避免误删。容错列表list遇到损坏的 JSON 文件会标记为(invalid preset file)而非崩溃scripts/presets.py。show 的优雅报错预设不存在时输出Error: Preset NAME not found.并以非零码退出。SKILL 文档skills/seo-image-gen/SKILL.md建议当用户提到某个品牌或已配置 SEO 预设时先执行python3 scripts/presets.py list确认可用预设再加载匹配项作为生成默认值。六、SEO 场景预设模板seo-image-presets.mdreferences/seo-image-presets.md 将 preset 机制落地到六个典型 SEO 图片场景每个模板都同时给出aspect_ratio、resolution、domain_mode、style与可选的post_processingImageMagick 命令。模板场景比例分辨率Domain Mode关键后处理og-defaultOG/社交分享图16:91KProductmagick output.png -resize 1200x630^ -gravity center -extent 1200x630 output-og.webpblog-hero博客宽屏 Hero16:92KCinemamagick output.png -quality 85 output-hero.webpproduct-white电商白底产品图4:32KProductmagick output.png -fuzz 5% -transparent white output-transparent.pngsocial-square社交方形图1:11KUI/Web—字体限制加粗无衬线、≤25 字符infographic-vertical竖版数据信息图2:34KInfographic—建议thinking: high提升文字渲染精度favicon-markFavicon/App 图标1:1512Logomagick output.png -resize 32x32 favicon.ico magick output.png -resize 180x180 apple-touch-icon.png几个值得注意的细节og-default的后处理命令采用-resize 1200x630^ -gravity center -extent 1200x630的覆盖居中裁剪手法确保任意比例的输出都能精确产出 1200×630 的 OG 标准尺寸与 SKILL 中 OG 图1200x630 feel的要求一致。product-white用-fuzz 5% -transparent white做去底为后续透明 PNG 资产如电商场景图服务。blog-hero直接-quality 85转 WebP契合 references/post-processing.md 中PNG 转 WebP网页优化、更小体积的标准做法。infographic-vertical明确建议启用高思考等级信息图对文字渲染精度要求最高这与 references/prompt-engineering.md 中25 字符以内文字才能可靠渲染的经验一致——信息图需要把文字量控制在模型能力范围内。创建自定义预设的两种路径模板文档给出的创建命令python3 ~/.claude/skills/seo-image-gen/scripts/presets.py create my-brand安装后脚本同样存在于 scripts/presets.py。执行后生成~/.banana/presets/my-brand.json完整 Schema自定义品牌预设会覆盖 SEO 默认模板中的颜色、情绪与字体而宽高比与分辨率仍由 SEO 预设兜底。预设选择逻辑四步references/seo-image-presets.md 明确了加载顺序用户指定用途命令og/hero/product→ 加载对应 SEO 预设模板用户提到品牌预设名 → 从~/.banana/presets/加载品牌预设覆盖SEO 预设的colors、mood、typographySEO 预设始终提供aspect_ratio与resolution默认值这条逻辑与 SKILL 流水线skills/seo-image-gen/SKILL.md的Check for Presets步骤衔接生成前先presets.py list命中品牌预设则加载未命中则回落到 SEO 预设模板。七、完整落地链路从预设到批量生成与成本管控Preset 不是孤立机制它在 claude-seo 的图片生成全链路中处于风格层位置触发/seo image-gen og description等命令见 skills/seo-image-gen/SKILL.md 的 Quick Reference。预设加载检查品牌预设 SEO 预设模板按第四节的选择逻辑合并。提示词构造合并结果作为 6 组件 Reasoning Brief 的默认值Claude 以自然语言叙事段落而非关键词列表完成各组件描述并针对 domain mode 追加专业修饰库相机型号、胶片、镜头、布光术语。生成参数通过set_aspect_ratio设置比例、调用gemini_generate_image生成MCP 不可用时回退到 scripts/generate.py--aspect-ratio支持 13 种比例--resolution限512/1K/2K/4K--thinking可选minimal/low/medium/high。批量多张图片通过 scripts/batch.py 以 CSV 驱动——CSV 表头需含prompt必填ratio/resolution/model/preset均可选脚本校验每行并输出含estimated_cost的结构化 JSON 计划供 Claude 逐行执行。也就是说预设字段同样可以作为 CSV 的一列传入实现整批同品牌风格。成本追踪每张图生成后由 scripts/cost_tracker.py 记账log/summary/today/estimate/reset台账位于~/.banana/costs.json按 references/cost-tracking.md 的定价512/1K/2K/4K 分别约 $0.02/$0.039/$0.078/$0.156 每张。后处理按 references/post-processing.md 的 ImageMagick/FFmpeg 流水线执行预设内嵌的后处理命令尺寸适配、去底、WebP 转换、绿幕去背等。SEO 收尾SKILL 的 Post-Generation SEO Checklist 要求输出关键词丰富的 alt 文本、keyword-description-widthxheight.webp命名、WebP 转换建议Hero 目标 200KB、缩略图 100KB、ImageObjectschema 片段以及og:image系列 meta 标签。值得一提的是SEO 审计侧的 agents/seo-image-gen.md 会在/seo audit时评估站点现有图片OG 图存在性、1200×630 尺寸合规、ImageObject填充率、WebP/AVIF 采用率、文件大小产出带优先级的生成计划——而该计划中的prompt idea列恰好可以引用预设模板形成审计发现问题 → 预设化生成 → 合规性复检的闭环。八、最佳实践与注意事项品牌预设命名规范使用tech-saas、luxury-brand这类 kebab-case 名与 Schema 示例一致便于list时快速识别。颜色是锚点不是全部colors只影响调色板描述最终视觉效果还取决于style、lighting与 domain mode 的组合创建预设时应五元组齐备。遵循用户指令 预设的优先级preset 是默认值层遇到与用户即时需求冲突时一律以用户为准references/presets.md 的硬性规则。信息图谨慎用字文字 ≤25 字符、最多 2-3 个独立短语并优先使用thinking: high超过限制会显著降低渲染质量references/prompt-engineering.md。批量前先预估成本cost_tracker.py estimate --model ... --resolution ... --count N可在批量执行前给出预算免费层约为 10 RPM / 500 RPD按 Google Cloud 项目计、太平洋时间每日重置批量任务应预留重试窗口。预设文件可版本化~/.banana/presets/*.json是纯文本 JSON可纳入团队 Git 仓库管理实现品牌视觉资产的跨机器同步。参考文档索引references/presets.md本文核心preset Schema、内置示例、合并机制与命令速查scripts/presets.py预设管理的完整 CLI 实现references/seo-image-presets.md六个 SEO 场景预设模板与选择逻辑skills/seo-image-gen/SKILL.md/seo image-gen命令、生成流水线与 SEO 清单references/prompt-engineering.md6 组件 Reasoning Brief 与 domain mode 修饰库scripts/batch.pyCSV 批量生成与成本预估scripts/generate.pyMCP 不可用时的 REST API 直连回退references/cost-tracking.md 与 references/post-processing.md成本台账与后处理流水线agents/seo-image-gen.md审计侧图片分析 Agent 与生成计划输出赞分享【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载相关推荐claude-seo SEO 图片预设体系实战基于 seo-image-presets 模板与 Banana Creative Director 管线的图像生成指南claude seo SEO 图片预设体系实战基于 seo image presets 模板与 Banana Creative Director 管线的图像生claude-seo 图像生成品牌预设系统基于 presets.md 的品牌一致性规范与 CLI 管理实战claude seo 图像生成品牌预设系统基于 presets.md 的品牌一致性规范与 CLI 管理实战 本文围绕 claude seo 仓库中 preseclaude-seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南claude seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南 本指南以 claude seo 仓库中 ba上一篇Gauge插件系统深度解析如何扩展你的测试能力下一篇腾讯SRPO10分钟训练让AI生图真实感提升3倍告别塑料质感创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考