照片变 LOGO · 二合一生成器

强制条款：先开首页（展示页），没有任何例外动作排在它前面

每次本技能被调用（无论自动触发、按名调用、用户贴回指令，还是只输入"首页""打开首页""指南页"这类词），
先自检一件事：本会话里首页是否已经打开过？没有 → 现在立刻打开，然后才允许输出任何其他内容。

• 即使用户已经发了照片、说了要求，也一样先开页、再接活 —— 首页是玩法指南与案例对照，用户看一遍就知道怎么提需求。
• 启动命令（run_in_background=true 承载，已在跑则跳过）：

python "C:/Users/Administrator/.workbuddy/skills/photo-to-logo/scripts/serve.py"

• 地址固定 http://127.0.0.1:8774/（根路径自动跳 homepage/index.html，即展示页），启动后立即用 present_files 打开。
• 用户也可双击 打开照片转LOGO.cmd 自行打开（已在跑则直接开浏览器）。
• 唯一例外：用户问的是一个可当场一句话回答的具体问题（如"通用提示词是什么"），此时先回答，回答末尾附上首页地址。
• 禁止动作：跳过页面直接开始改图、直接抛 Step 0 三问、长篇解释方法论。这些全部排在开页之后。

首页（波普拼贴风单页）板块：怎么玩（四种输入玩法）→ 五步流程 → 风格八方向 → 案例对照（原图 / 参考 → 成品）→ 避坑 → 快速上手。
可复制指令卡点击即复制，用户粘贴回来即可开工；案例图点击可放大。只有这一个页面，不要再打开第二个页面。

Overview

把一张照片，按「主体照片 + 风格参考 + 通用提示词」三段式喂给图像生成模型，得到概括后的图形，再经人工修形、矢量描摹、配色排版，交付 Logo 或 Icon。方法论源自胡晓波工作室《用AI，把照片秒变LOGO！》，通用提示词为原文摘录。

同一套图形可同时产出两种交付物：Icon（纯图形，需缩到 32px 可辨）与 Logo（图形 + 品牌名 + Slogan）。先按 Icon 标准做极简图形，再外加文字排版成 Logo；先简后繁，不要反过来。

Step 0 · 四种情况，先分清（决定用哪套基础提示词）

情况 A / C 的共同铁律 —— 先抓精髓再生成：按 02-prompts.md 第 2.5 节公式写出"参考图精髓（必须遵循）：……"追加进提示词。不做这一步，模型只学到画法皮相，丢掉构图与图底关系（实测已验证三次）。

情况 B：风格必须展开成具象描述（画法 + 用色逻辑 + 色块分割），只给一个"某某风格"名词不够。

情况 C：拼写两次写进提示词 + 出图逐字母核对，错一个字母整张作废重跑。

情况 D：[主体描述] 必须写死，这是该模式唯一的命题位置；参考图可按需增到 n 张（如 图5道具、图6场景），编号依次顺延，"请从图前 N 张分别提炼，按照第 N+1 张的视觉规则"。

Step 0.5 · 交付形态：默认 Logo，Icon 需用户点名

• 默认输出 Logo —— 有细节、有设计感，允许比 Icon 多留装饰与层次。
• 只有用户明确说"生成 Icon / 图标"时才出 Icon —— Icon 更简单，甚至可以只是一个轮廓；判据：去掉所有内部细节后，32px 下仍靠外轮廓认得出。
• 两者格式都是 PNG + SVG：Logo 出精细版；Icon 必须以 SVG 为主交付，并要求结构极简。
• 审批式判断：拿不准时按 Logo 出，交付里附一句"要更极简的 Icon 版我可以直接改"。

Step 0.6 · 颜色规则

• 配色来源：参考图的配色，或用户提示词里点名 / 用户当场指定的色值。
• 用户没给配色要求 → 默认黑色 #1A1A1A（避免纯黑 #000000）。
• 无论什么颜色，SVG 都必须按部件分层 —— 这是硬要求，它决定了用户在 PPT 里能不能自由换色（见 Step 4）。颜色靠一道在位图上刷着不够，必须落在可编辑的路径上。

Step 1 · 选主体照片

• 好图标准：轮廓清楚与背景分离、有 2–3 个强识别特征、姿态有特点、光线均匀。
• 原文列出四类不建议直接用的图：① 遮挡严重，关键特征不清晰；② 主体太多，画面过于复杂；③ 主要靠纹理、花纹；④ 别人的原创 IP 或实物。
• 第 ④ 类的处理口径（严格按原文）：不阻止生成，照常跑完流程，但交付时必须提示该主体涉及他人原创 IP 或实物，商用会带来版权与法律纠纷。提示一次即可，不反复劝阻。
• 推荐先抠图去底，主体提炼干净度显著提升。

Step 2 · 找风格参考

风格参考决定画法。八个方向见首页「风格八方向」板块或 references/02-prompts.md 第 4 节（极简线构、单色块面、圆形徽章、粗描边卡通、几何构成、负形反转、手绘木刻、单线连续）。

• 一次只给一张参考；参考的概括程度 = 成品的概括程度。
• 参考主体不能与本次主体同类，只借鉴造型规则。
• 找不到参考时，从上述八个方向中选一个向用户复述确认。

Step 3 · 生成图形

1. 按「图1 主体、图2 参考」的顺序把两张图连同通用提示词一起发给图像生成模型，顺序错则结果错。
2. 使用 ImageGen 工具出图（必要时先用 ToolSearch 加载 ImageGen 的 schema 确认参数）。提示词取 references/02-prompts.md 第 1 节通用提示词原文，不要追加"高清照片""真实质感""光影渲染"等会把结果拽回写实的表述。
3. 按模式在提示词末尾追加一句定向指令（人物 / 动物 / 植物 / 建筑 / 实物，五类见该文档第 3 节）。多图融合改用第 2 节的四图版提示词原文 —— 需把 [主体描述] 替换成具体角色（原文案例填"猫咪宇航员"），这是该模式唯一的命题位置，写得越具体越可控。
4. 生成前先用一句话说破图2精髓（必做）：按 references/02-prompts.md 第 2.5 节公式 —— 构图形式 + 图底关系 + 画法 + 底色块处理 + 用色数量 —— 概括成一句"参考图精髓（必须遵循）：……"，原句追加进提示词末尾。不点破精髓，模型只学到画法皮相、丢掉构图骨架（两次实测踩过：星巴克参考不点正负形 → 出反掉的线条稿；不点构图 → 出孤立头像）。
5. 构图与正负形必须显式点名：参考是圆形徽章、横椭圆、盾形等构图形式时，末尾必须追加构图定向句；参考是实心底类（块面徽章、负形反转）时必须追加正负形定向句（均见该文档第 3 节）。
6. 出图后必须回顾：识别特征是否保留、背景是否残留、画法是否跟上参考、构图与图底关系是否进参考的形式（圆形参考出孤立头像 = 不合格，实心底参考出线条稿 = 不合格，加定向句重跑）。不合格就调参考或调阈值重跑，一次只改一个变量。

Step 4 · 矢量优化

出图不要直接交付，原文每个案例都做了人工修形：

1. 去无意义背景色块 → 顺轮廓（平行 / 对齐 / 对称）→ 简化过度复杂部件 → 统线宽与端点 → 查留白与重心 → 清 stray 路径。
2. 矢量化两条路：
   - 模型直出：追加「请输出该图形的 SVG 源文件，路径精简、不含 base64 位图，并按部件分层 —— 每个独立部件一个 path，孔洞作为子路径挖空」。
   - 本地描摹：python scripts/trace_png_to_svg.py input.png out.svg（零第三方依赖，离线可跑；白底图加 --mode luma --threshold 128；锯齿多调大 --simplify，细节被吃调小；--palette "#111,#0F5132,#E8A33D" 按顶层部件顺序分配颜色）。

SVG 交付结构（三轮实测的能力边界，2026-10-22 定案）：

1. 默认主交付 = 挖空版（每个实心区域独立 <path>，负形 / 孔洞用 evenodd 挖空透底）：网页、设计软件、直接插入 Office 都正常，孔洞保留。禁止把所有轮廓挤进单一 path。
2. PPT「转换为形状」后填色会糊片 —— 这是 PPT 的限制，挖空版与层叠版都躲不掉（用户实测：挖空版孔洞被填满、层叠版整组填色变整片）。不要承诺「转形状后点哪换哪」，也不要为此反复返工换结构。
3. PPT 里要换色，走这三条路（按推荐度排序）：
   - 不转形状：直接插入 SVG →「图片格式 → 图形填充」重着色，优先用单色版（#1A1A1A 挖空），Office 365 对单色矢量重着色支持最好，孔洞保持透底。
   - 派生配色文件：用户明确要别的颜色时，才用 recolor_svg.py 生成那一版 —— 默认只交付一份 SVG（主色版），不要一次生成多个色版（用户明确要求）。
   - 层叠正形版（备选）：scripts/stacked_svg.py 把负形输出为实心负形色的独立形状层叠，需取消组合后逐个形状填色，适合改局部颜色；不作主交付。

4. 挖空版与层叠版同时给时，文件名注明用途（-挖空 / -层叠版-备选）。

5. 换色用 python scripts/recolor_svg.py logo.svg --map 旧色:新色 --out 新文件.svg（或 --mono 压单色）。用户指定色值后按其执行。

Step 5 · 配色 & 排版

• 配色默认 = 参考图配色（情况 A / C / D）或用户在提示词 / 配色工作台指定的色值；用户没提配色 → 默认黑色 #1A1A1A，并在交付里说明"未指定配色，已按默认黑出图，SVG 可逐部件换色"。备选②③④条用于既定配色之后的优化。
• 沿用风格参考的配色最稳；换色从主体固有色出发。主色不超过 3 个；避免纯黑 #000000，用 #1A1A1A。默认只出主色一版 SVG —— 单色黑版 / 反白版 / 品牌色版等变体，等用户开口要再派生，不要主动批量出。
• 字重匹配图形视觉重量：粗描边配 Bold，细线配 Regular / Light。
• 排版三型：横版（图形左 + 文字右）、竖版（图形上 + 文字下）、徽章型（图形居中 + 环形文字）。横竖各出一版再挑。
• 间距取图形最小部件宽度的 3–5 倍，四周安全边距 ≥ 画板 5%。

交付前自检

• [ ] 缩到 32×32 仍可辨
• [ ] 转纯黑一版，剪影依然成立（靠形不靠色）
• [ ] 无水印、无背景色块、无 stray 路径
• [ ] 线宽一致、块面边缘干净
• [ ] 有 SVG 矢量版
• [ ] 如主体涉及他人原创 IP 或实物，已在交付说明中提示商用法律风险

交付包（默认就这些，不要加料）：SVG 一份（主色）+ PNG 一份（透明底）+ 一句话说明（主体来源、参考来源、色值）。额外变体（其他颜色、其他尺寸档位、横竖排版）等用户要求再出。产物默认写到当前工作区的 outputs/。

Resources

references/

• 01-workflow.md —— 四步路径详解、Logo/Icon 差异与尺寸规格表、选图标准、交付自检
• 02-prompts.md —— 通用提示词原文、多图融合版、六类模式追加指令、风格参考选型词、负向约束
• 03-vector-and-polish.md —— 矢量化两条路的参数经验、修形清单、配色原则与色板、排版规范

scripts/

• serve.py —— 首页静音服务，端口 8774，根路径跳转 homepage/index.html
• trace_png_to_svg.py —— 位图转 SVG 描摹（marching squares + RDP 简化 + Catmull-Rom 平滑，零第三方依赖）
• trace_multicolor.py —— 多色 logo 分层描摹（调色板最近邻分层，每层一个 evenodd path；厚描边多色 logo 必用这个，不要临时拼脚本）
• render_svg_preview.py —— SVG 自检渲染器（零依赖光栅化成 PNG）。交付任何 SVG 前必跑一遍并与原始出图对比，防止方向规则/孔洞结构崩坏
• recolor_svg.py —— SVG 批量换色，支持 --mono 与 --map 旧色:新色
• stacked_svg.py —— 层叠正形 SVG（PPT 主交付结构）：负形区域输出为实心负形色独立形状层叠，PPT 转形状后每个区域可单独填色（evenodd 挖空在 PPT 不生效，见 Step 4）

homepage/

• index.html —— 唯一的页面：波普拼贴风展示页（指南），零依赖单文件。内容：怎么玩（四种输入玩法）→ 五步流程 → 风格八方向 → 案例对照（原图 / 参考 → 成品）→ 避坑 → 快速上手（可复制指令卡）
• cases/ —— 页面画廊素材，4 组案例的原图 / 参考图 / 成品（含 SVG 与透明 PNG）

assets/

• size-check.html —— 交付自检工具：拖入图形，并排预览 160 / 64 / 32 px 与反白版，验证"缩到 32px 仍可辨"