Logo 提示词工程实战：用 ui-ux-pro-max-skill 结构化驱动 AI 生成专业 Logo

Logo 提示词工程实战：用 ui-ux-pro-max-skill 结构化驱动 AI 生成专业 Logo

【免费下载链接】ui-ux-pro-max-skillAn AI skill that provides design intelligence for building professional UI/UX across multiple platforms.项目地址: https://gitcode.com/gh_mirrors/ui/ui-ux-pro-max-skill

导读：本指南围绕 ui-ux-pro-max-skill 项目中design技能自带的 Logo 提示词工程参考文档展开，系统讲解如何用「核心结构 + 风格关键词 + 负面约束 + 行业模板 + 技术规格」五层架构撰写高质量 Logo 生成提示词，并深入项目源码揭示这些提示词如何被generate.py的提示词模板、风格修饰器与行业修饰器逐层拼装，最终落地为 Gemini Nano Banana 或 Atlas Cloud 的可执行图像生成请求。读完本文，你将掌握一套可复用、可量化的 Logo AI 提示词方法论，并能在 CLI 中直接运行完整生成流程。

一、Logo 提示词工程在项目中的定位

在 ui-ux-pro-max-skill 的design综合技能中，Logo 设计与 AI 生成是内置子技能之一。技能路由表（见 SKILL.md）将「Logo 创建与 AI 生成」明确指向内置 Logo 模块，并维护了一组互相配合的参考文档：

而本文主角 logo-prompt-engineering.md 是整个提示词体系的「最后一公里」——前面三份文档决定「设计什么」，这份文档决定「怎么用自然语言把设计意图准确传达给图像生成模型」。它与 cip-prompt-engineering.md 一起构成了项目中「提示词工程」方法论的双翼：前者服务 Logo 单图生成，后者服务企业 VI 全套物料。

二、核心提示词结构：五要素骨架

原文档给出了一条适用于绝大多数 Logo 生成场景的五段式提示词骨架：

Professional logo design for [brand/industry]: [Visual description] Style: [style keywords] Colors: [color palette] Requirements: [technical specs]

这条骨架的本质是「把一份设计师 brief 翻译成模型能稳定理解的字段化文本」：先声明任务类型（Professional logo design）、再交代品牌/行业归属、然后是画面描述、风格、颜色、技术规格。字段越清晰，模型越不容易在细节上自由发挥。

在项目源码中，这条骨架被进一步工程化为generate.py内部的内置提示词模板。见 generate.py：

Generate a professional logo image: {prompt} Style requirements: - Clean vector-style illustration suitable for a logo - Simple, scalable design that works at any size - Clear silhouette and recognizable shape - Professional quality suitable for business use - Centered composition on plain white or transparent background - No text unless specifically requested - High contrast and clear edges - Square format, perfectly centered - Output as a clean, high-quality logo image

可以看到，源码模板把原文档「Requirements: technical specs」字段固化成了 10 条硬性约束，无论用户提交什么提示词，这些约束都会追加到最终请求中，相当于在架构层面兜底执行了原文档强调的「可缩放、清晰轮廓、白色/透明背景、居中构图、无文字」等核心诉求。

实际生成时，用户输入会被enhance_prompt()函数按「品牌名 → 基础提示词 → 风格修饰器 → 行业修饰器」的顺序拼接（见 generate.py），最后再套进上面的模板。也就是说，你写的五要素提示词中的 Style 与 Industry 字段，在源码层都有对应的「修饰器词典」做语义增强。

三、六类风格关键词库（直接可复用）

原文档按风格维护了六组「开箱即用」的关键词集合，直接复制到提示词的Style:字段即可。以下完整收录并补充每类风格在源码STYLE_MODIFIERS词典中的对应实现（见 generate.py）。

3.1 Minimalist（极简）

minimalist, clean lines, simple geometric shapes, essential elements only, high white space, flat design, single color, modern, uncluttered, negative space, subtle, refined

源码映射：minimalist, simple geometric shapes, clean lines, lots of white space, single color or limited palette

3.2 Vintage/Retro（复古）

vintage, retro, heritage, established, classic, nostalgic, weathered, distressed texture, badge style, hand-lettered, craft, artisan, sepia tones, muted colors, aged paper effect

源码映射：vintage, retro, badge style, distressed texture, heritage feel, warm earth tones

3.3 Luxury/Premium（奢侈高端）

luxury, elegant, sophisticated, premium, refined, exclusive, high-end, gold accents, metallic, minimal, tasteful, upscale, prestige, thin lines, serif typography, foil effect

源码映射：luxury, elegant, gold accents, refined, premium feel, serif typography

3.4 Modern/Tech（现代科技）

modern, innovative, digital, tech-forward, sleek, futuristic, gradient colors, geometric, abstract, dynamic, cutting-edge, clean sans-serif, circuit-like, data visualization

源码映射：modern, sleek, gradient colors, tech-forward, innovative feel

3.5 Playful/Fun（活泼趣味）

playful, fun, colorful, friendly, approachable, cheerful, whimsical, bouncy, rounded shapes, bright colors, cartoon-like, energetic, bubbly, hand-drawn elements

源码映射：playful, fun, colorful, friendly, approachable, rounded shapes

3.6 Organic/Natural（有机自然）

organic, natural, flowing, botanical, eco-friendly, sustainable, earth tones, leaf elements, hand-drawn, imperfect lines, growth, green, nature-inspired, biophilic

源码映射：organic, natural, flowing lines, earth tones, sustainable feel

值得注意的实践细节：文档关键词用于「人工书写提示词」，而源码STYLE_MODIFIERS用于「脚本自动增强」，两者术语高度一致。当你在 CLI 中通过--style minimalist传参时，脚本会自行注入源码风格描述，因此命令行用法下无需重复书写风格关键词；而当你通过--prompt直接提交完整提示词时，建议手动使用文档中的完整关键词组。

四、负面提示词：告诉模型「不要什么」

原文档强调负面提示词必须始终包含，以阻止模型产出不想要的元素：

NOT: photorealistic, 3D render with realistic textures, photograph, stock image, clip art, multiple logos, busy background, text watermarks, low quality, blurry, distorted, complex detailed patterns

这条负面清单覆盖了 Logo 生成的四大高频翻车点：写实化（photorealistic / 3D render / photograph）、非原创素材感（stock image / clip art）、构图失控（multiple logos / busy background / text watermarks）、质量劣化（low quality / blurry / distorted / complex detailed patterns）。

从源码层看，项目对「不要什么」的约束是双保险的：一方面提示词模板中的No text unless specifically requested、Clean vector-style illustration、High contrast and clear edges等正向约束在反向压制写实化与粗糙感；另一方面，Gemini 请求在代码里显式配置了四级安全设置（HATE_SPEECH、DANGEROUS_CONTENT、SEXUALLY_EXPLICIT、HARASSMENT 均设为BLOCK_LOW_AND_ABOVE，见 generate.py），从内容安全层面再兜一层底。负面提示词 + 安全阈值，共同保证输出的可用性。

五、行业专属提示词模板

原文档给出了五个行业的完整提示词示例，它们把「风格 + 配色 + 符号 + 情绪 + 技术约束」一次性打包，适合直接复制替换品牌名使用。

5.1 科技创业公司（Tech Startup）

Modern tech company logo, abstract geometric mark, gradient blue to purple, clean minimal design, innovative feel, scalable vector style, professional quality, silicon valley aesthetic

5.2 医疗健康（Healthcare）

Healthcare medical logo, clean professional design, cross or heart symbol, calming blue and teal colors, trustworthy appearance, caring feel, simple scalable mark, HIPAA-appropriate conservative style

注意示例中HIPAA-appropriate conservative style体现了医疗行业的合规敏感性——在面向医疗客户时，提示词除了审美还要带上「保守、可信」的行业姿态。

5.3 餐饮食品（Restaurant/Food）

Restaurant logo, warm inviting colors, appetizing feel, vintage badge style, chef or utensil iconography, friendly welcoming design, rustic charm, established look, readable at small sizes

5.4 时尚品牌（Fashion Brand）

Fashion brand logo, elegant sophisticated wordmark, luxury aesthetic, black and gold color scheme, thin refined typography, haute couture feel, minimal exclusive design, high-end positioning

5.5 环保可持续（Eco/Sustainable）

Eco-friendly sustainable brand logo, organic natural elements, leaf motif, earth green and brown colors, growth symbolism, environmental awareness, clean modern yet natural feel, recyclable-look design

5.6 源码中的行业扩展

源码 generate.py 的INDUSTRY_PROMPTS词典将行业覆盖面扩展到 10 个，除上述 5 类外还包含 finance、fitness、education、real-estate、creative。每个行业都带有一组「符号 + 情绪」短语，例如：

CLI 用法示例（对应 logo-design.md）：

python3 cli/assets/skills/design/scripts/logo/generate.py --brand "TechFlow" --style minimalist --industry tech

--industry的可选值即上表 10 个行业键名，--style可选值对应STYLE_MODIFIERS的 18 个风格键名。

六、技术需求三要素：可缩放、多场景、高质量

原文档指出，提示词中应显式声明技术规格，否则模型只关心「好看」而忽略「能用」。三组关键词如下：

Scalability（可缩放）

vector-style, scalable at any size, clear silhouette, works as favicon, recognizable small scale, simple shapes

Versatility（多场景通用）

works on light and dark backgrounds, single color version possible, horizontal and stacked layouts, brand mark can stand alone

Quality（质量）

professional quality, print-ready, high resolution, crisp edges, balanced composition, centered design

这三组关键词与原文档「常见陷阱」第 1、4 条（过度复杂、宽高比错误）相互呼应。项目侧则给出了可落地的验收标准：logo-style-guide.md中的可扩展性检查清单（见 logo-style-guide.md）：

• 在 16×16 像素（favicon）下仍可辨识
• 名片尺寸下保持清晰
• 支持单色版本
• 黑白下依然清晰
• 无缩小时消失的微小细节

此外，源码将宽高比作为一等参数暴露：ASPECT_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4"]，默认1:1方形（官方注释为 "Square is ideal for logos"），可通过--aspect-ratio覆盖（见 generate.py）。这也印证了原文档陷阱第 4 条的建议——默认方形，确需横向时显式指定。

七、三种提示词模板：快、全、变

原文档按使用节奏给出三档模板，分别服务于「快速出图」「完整设计简报」「变体迭代」。

7.1 Quick Generation（快速生成）

Professional [industry] logo, [style] design, [color] colors, clean modern aesthetic, scalable vector style

7.2 Detailed Brief（完整简报）

Professional logo design for [brand name], a [industry] company. Visual style: [style keywords] Primary colors: [hex codes] Mood: [emotional keywords] Symbols: [iconography hints] Technical: Vector-style illustration, scalable, works in single color, centered on plain background, no text unless specified.

完整简报模板值得拆解：它把设计 brief 的四个维度（视觉风格、主色 HEX 值、情绪、符号提示）字段化，并在 Technical 段重申「无文字、单色可用、居中、纯色背景」——恰好对应本文第六节的技术三要素。颜色建议直接填 HEX，与项目数据文件 colors.csv 中每套色板的Primary Hex / Secondary Hex / Accent Hex字段格式一致，例如Tech Gradient色板主色#6366F1、辅色#8B5CF6、强调色#06B6D4。

7.3 Variation Request（变体迭代）

Alternative version of [brand] logo: Keep: [elements to preserve] Change: [elements to modify] Style direction: [new style keywords]

变体模板的关键是「显式声明保留项与修改项」。在 CLI 中，generate_batch()会自动帮你做变体实验：一次--batch N最多按固定顺序产出 9 个不同风格的变体（minimalist、modern、geometric、gradient、abstract、lettermark、negative-space、lineart、3d），每个变体之间内置 2 秒限速（见 generate.py），适合用「Keep/Change」思维挑选方向。

八、常见陷阱与规避方法

原文档总结了五条高频失败模式，每条都配有对策：

1. 提示词过细— AI 倾向于生成复杂内容；主动要求 "simple"
2. 背景不明确— 明确写 "plain white background"
3. 文字渲染问题— AI 不擅长渲染文字；文字标记单独生成（源码模板中No text unless specifically requested正是为此设计）
4. 宽高比错误— 明确写 "1:1 square" 或 "horizontal"（CLI 对应--aspect-ratio参数）
5. 写实化倾向— 追加 "illustration, vector-style, not photorealistic"

这些陷阱与 generate.py 的LOGO_PROMPT_TEMPLATE兜底约束一一对应：模板强制要求Simple, scalable design、plain white or transparent background、No text、Square format、vector-style illustration，等于把五条规避策略全部内置到每次请求中。即便你不手动写这些约束，脚本生成也会自动带上；而当你使用自定义--prompt时，则需自己落实上述五条。

九、从提示词到成图：CLI 完整实战链路

将本文的提示词工程方法落到项目 CLI 上，完整链路分三步：

第 1 步：生成设计简报（Design Brief）

用 search.py 的--design-brief模式，让 BM25 检索引擎基于查询词从三张数据表（styles.csv、colors.csv、industries.csv）中拉取行业建议、风格建议与色板选项，组装成一份结构化简报：

python3 cli/assets/skills/design/scripts/logo/search.py "tech startup modern" --design-brief -p "BrandName"

底层实现是 core.py 中的自研 BM25 排序（k1=1.5、b=0.75），检索列覆盖风格表的Style Name / Category / Keywords / Best For、色板表的Palette Name / Keywords / Psychology / Best For、行业表的Industry / Keywords / Recommended Styles / Mood。也可以直接检索单域：

python3 cli/assets/skills/design/scripts/logo/search.py "minimalist clean" --domain style python3 cli/assets/skills/design/scripts/logo/search.py "tech professional" --domain color python3 cli/assets/skills/design/scripts/logo/search.py "healthcare medical" --domain industry

第 2 步：生成 Logo 变体

把第 1 步简报中沉淀的风格关键词、配色与行业字段喂给生成脚本：

# 品牌 + 风格 + 行业（三个修饰器自动增强） python3 cli/assets/skills/design/scripts/logo/generate.py --brand "TechFlow" --style minimalist --industry tech # 直接提交完整提示词（可套用本文各节模板） python3 cli/assets/skills/design/scripts/logo/generate.py --prompt "coffee shop vintage badge" --style vintage # 批量变体（最多 9 个风格） python3 cli/assets/skills/design/scripts/logo/generate.py --brand "Unikorn" --batch 9 --output-dir ./logos --pro # 自定义宽高比与输出文件 python3 cli/assets/skills/design/scripts/logo/generate.py --prompt "..." --aspect-ratio 16:9 --output logo.png

第 3 步：选择生成模型与提供方

默认提供方为 Gemini「Nano Banana」系列，generate.py 中定义了两个模型档位：

• gemini-2.5-flash-image（Nano Banana，默认）：快、高吞吐、低延迟
• gemini-3-pro-image-preview（Nano Banana Pro，--pro）：专业质量、更强推理

同时支持 Atlas Cloud 异步图像生成 API 作为显式 opt-in（--provider atlas，默认模型google/nano-banana-2-lite/text-to-image），脚本内部实现了任务创建、轮询（2 秒间隔、最多 90 次）与安全下载（拒绝非 HTTPS、非公网、非图片响应，见 generate.py）。

前置环境要求（见 logo-design.md 与 SKILL.md）：

export GEMINI_API_KEY="your-key" # Gemini 提供方必填 pip install google-genai pillow # Gemini 提供方依赖 # Atlas Cloud 提供方无需额外 Python 包，只需： export ATLASCLOUD_API_KEY="your-key"

注意--pro仅适用于 Gemini 提供方，与--provider atlas互斥；Windows 环境用python替代python3。

十、提示词工程检查清单

综合原文档与项目源码，撰写或审查一条 Logo 提示词时，建议按下列清单逐项核对：

1. 结构完整：是否包含任务声明、视觉描述、风格、配色、技术规格五个要素？
2. 风格明确：Style:字段是否使用了本文第三节的可复用关键词，且没有混用互斥风格（如极简 vs 复古徽章）？
3. 负面约束：是否显式排除写实化、素材感、杂乱背景与低质量元素？
4. 技术规格：是否声明了可缩放、深浅背景可用、单色版本、居中构图？
5. 宽高比：是否需要 1:1 之外的尺寸，并在 CLI 中用--aspect-ratio指定？
6. 行业符号：是否根据行业注入了合适的符号与情绪短语（可用 search.py 的行业域检索辅助）？
7. 文字策略：品牌名是否作为独立文字元素处理，而不是期望模型直接渲染？
8. 兜底保障：脚本内置模板会自动追加矢量风格、白/透明背景、无文字等硬约束，检查自定义--prompt时是否自行覆盖了这些点。

对照 logo-prompt-engineering.md 原文档及本文展开的方法论，配合 generate.py、search.py、core.py 三份脚本与 styles.csv、colors.csv、industries.csv 三张数据表，即可在项目中跑通「设计简报 → 提示词组装 → AI 生成 → 多风格变体」的完整 Logo 设计流水线。

【免费下载链接】ui-ux-pro-max-skillAn AI skill that provides design intelligence for building professional UI/UX across multiple platforms.项目地址: https://gitcode.com/gh_mirrors/ui/ui-ux-pro-max-skill