geo-icon

Geo Icon 是一个基于几何构造的图标设计工具，核心思路是“写构造，不画轮廓”。用户编写 JSON 规格文件，用圆、环、切线、两弧夹出的叶形、相切圆弧链、凸包和布尔运算等图元描述形状，脚本据此计算最终轮廓，并将同一批图元绘制在构图卡上作为构造线。因此，构造线是形状的来源，而非事后装饰。

主要能力包括：

• 生成单色、单条 evenodd 路径的方形 viewBox 图标（icon.svg），轮廓中圆弧部分为真正的 SVG 圆弧指令，直段为直线指令。
• 输出米白 4:5 画布上的海报图（poster.png/.svg）。
• 输出构图卡（construction.png/.svg），包含方格纸、浅灰填充形状、构造圆、切线、圆心十字、底部 CONCEPT 文案、右下角成品缩略图。
• 输出 128→16px 正反色小尺寸测试图（sizes.png/.svg）。
• 在规整现有图标时，可输出原图、规整后、叠加三联对比图（compare.png/.svg）。
• 输出体检报告（report.txt），包含 bbox 与重心、碎片数、半径种类、过细部位、窄缝警告等。

使用方式：

• 通过命令行运行：python3 <skill目录>/scripts/geoicon.py spec.json -o <输出目录>。
• 依赖 shapely>=2、numpy、Pillow，缺失时运行 python3 -m pip install -r <skill目录>/requirements.txt。PNG 渲染依次尝试 rsvg-convert、cairosvg、Chrome/Edge 无头模式、macOS qlmanage，均不可用时仅输出 SVG。一次渲染约 5–10 秒。
• 支持 --compare 参数对现有图标进行规整，并生成对比图。
• 支持 --svg 参数对外部生成的 SVG 进行海报、小尺寸测试和体检。

工作流分为三种情况：

1. 新做一个题材简单的图标（抽象图形、1–3 个字母、物件、10 个以内部件能概括的动物）：走构造模式，定概念、拆部件、定比例系统、写 spec、渲染、看图自检迭代 2–4 轮、交付。
2. 规整现有图标：使用 measure.py 测量，读出意图比例，写 spec 精确重构，渲染并对比，复测确认偏差归零，交付构图卡、对比图、成品和数值对比表。
3. 题材太复杂（龙、麒麟、凤凰等）：建议简化成几何剪影，用户坚持则走外部矢量接口 scripts/external.py（预留接口，未配置时如实告知），外部生成的 SVG 可用 --svg 进行后续处理，但没有构图卡。

适用场景：

• 设计极简几何风格的 logo、图标、徽章、家纹。
• 规整现有图标，统一比例系统，提升几何精度。
• 需要展示构造逻辑的“构图证明卡”场景。

限制：

• 题材过于复杂（鬃毛、鳞片、卷云繁多）时，本 skill 不内置第三方服务，外部接口需自行配置，且无构图卡。
• 规整会改变一些手绘的随意性，需在交付时说明并给出替代方案。
• 原图的渐变、描边、光泽等质感不在处理范围内，规整后为纯扁平图形。
• 追求可验证输出时应少用 blend/soften/round，否则轮廓中折线比例升高，几何 logo 目标为折线接近 0%。
• 图标中不应放文字。
• 原创性要求：不要模仿现有品牌 logo 或受版权保护的角色形象。