prompt-to-asset

prompt‑to‑asset

面向开发者的免费图像生成工具，可通过命令行或 AI 助手使用。
只需一段简短描述，即可生成应用图标、favicons、OG 图片、徽标、启动屏幕、SVG 和平台套件，并优先采用最佳零成本方案。
专为 Cloudflare Workers AI、NVIDIA NIM、HF Inference、Stable Horde、Pollinations、免费试用和离线 SVG 打造。

_{快速入门 · 免费方案 · 用法 · 模式 · 免费 API · MCP 工具 · 完整指南 · 更新日志}

30 秒快速开始

任选一种，运行即可。推荐方案排在最前。 运行环境：Node ≥ 20.11（推荐 24）。macOS、Linux、Windows（使用 --fix 原生依赖时需用 WSL2）。

• Make a transparent logo for Forge, a dev-tools brand. Flat vector, warm orange.
• Make a favicon for my app, dark-mode aware.
• Fan this master.png out to iOS + Android + PWA.
• Ingest this screenshot as a mark, vectorize, export everything.

curl -o logo.png \
  "https://image.pollinations.ai/prompt/\
minimal+flat+vector+logo\
?model=flux&width=1024&nologo=true"

npx prompt-to-asset export logo.png \
  --platforms ios,android,pwa,favicon

npm i -g prompt-to-asset
p2a doctor          # check env
p2a doctor --fix    # auto-install deps
p2a pick            # interactive

免费方案一览

你不需要付费 API 密钥。以下按推荐程度从高到低排列：

详情和配额：Pollinations 之外的免费方案。运行 p2a doctor，或让助手调用 asset_doctor()，查看当前可用的服务。

提示

遇到问题？点击上方的 Install in Cursor 或 Install in VS Code，重启编辑器，然后说：“为我的应用制作一个支持深色模式的 favicon。”

亮点

• 免费优先的 CLI 生成 — p2a doctor、p2a pick 和 MCP 工具会优先选择免费的 API 方案和模型，让开发者无需启用计费，就能在 CLI 中生成内容。
• 三种执行模式 — inline_svg（由宿主大模型编写 SVG）、external_prompt_only（粘贴到任意网页 UI）、api（服务调用免费或付费提供商）。选择适合你的模式。三种模式都可以零成本完成。
• 60+ 个模型，免费优先路由 — Cloudflare Workers AI、NVIDIA NIM、HF、Horde、Pollinations、免费试用，以及可选的 OpenAI / Ideogram / Recraft / BFL / Gemini 付费服务。每条规则都注明了研究来源。
• 拒绝错误操作 — 查看 Never 列。超过 3 个词的字标不通过扩散采样器生成。Imagen 不生成透明 PNG。Flux 不使用 negative_prompt。
• 离线分发到各个平台 — 一个 1024² 母版 → iOS AppIconSet、Android 自适应 + 单色图标、PWA 192/512/512-maskable、favicon 套件、visionOS 视差效果、Flutter 启动图标。无需联网。
• 发布前验证 — 对每项输出进行 tier-0 检查：尺寸、Alpha 通道是否存在、棋盘格 FFT、安全区 bbox、ΔE2000 调色板偏差、WCAG 对比度、字标 OCR Levenshtein 距离。
• 精灵图集 + 9-slice — 将 PNG 帧打包成兼容 TexturePacker 的图集（Phaser、PixiJS、Godot、Unity）；输出 9-slice 数值 + CSS border-image + Android .9.png。

目录

用法

只需和助手对话。以下是新聊天中的示例：

为一家名为 Forge 的开发者工具公司制作一个透明 Logo。扁平矢量风格，采用暖橙色与中性色的双色搭配。

幕后流程：

1. asset_doctor() — 检查哪些模式和提供方可用。
2. 如果不存在 brand.json，则调用 asset_init_brand({ app_name: "Forge", palette: ["#EA580C", "#F5F5F4"] })。
3. asset_enhance_prompt({ brief }) 返回一个 AssetSpec：包含分类、改写后的提示词、modes_available[]、可选的 svg_brief、可选的 paste_targets，以及指向支持该决策的研究文件的 routing_trace（另含 never_models — 说明为何拒绝 Imagen 或 DALL·E）。
4. 助手会向你提供 inline_svg / external_prompt_only / api 选项。
5. 如果选择 inline_svg：它会直接编写 <svg>，并调用 asset_save_inline_svg → 将 master.svg、favicon.ico、apple-touch、AppIconSet、PWA 包写入磁盘。
6. 如果选择 external_prompt_only：助手会显示优化后的提示词和最佳粘贴目标（优先免费）。生成并保存后，再说 “导入此文件” → asset_ingest_external。
7. 如果选择 api：助手会调用路由选定的提供方。服务端会处理背景去色、矢量化、导出和验证。
8. 后续操作：“也为 iOS 和 Android 各生成一套” → 使用已保存的 master 调用 asset_export_bundle。

无需输入任何 CLI 命令。CLI 仍是 CI、Shell 脚本和非 MCP 环境的一等选择 — 两种入口都使用同一核心。

为何要做这个项目

有两个事实决定了这里的一切。

制作可用于生产环境的软件素材，关键在于路由和后处理，而不是提示词工程。

Imagen 3/4 和 Gemini Flash Image 无法生成真正的 RGBA PNG — 它们的 VAE 仅支持 RGB，因此要求透明背景时，灰白棋盘格会被渲染成像素。SDXL 拼写超过约 8 个字符就会出错。只有 Recraft 能输出原生 SVG。Flux 遇到 negative_prompt 会报错。这些问题在模型界面中都看不出来，却都会悄无声息地破坏“一次提示词生成素材”的工具。

你可能没有图像模型 API 密钥。这个插件照样能用。

三种模式都可以零成本完成。

三种模式

flowchart LR
    A["one-line brief"] --> B["asset_enhance_prompt"]
    B --> C{"mode"}
    C -->|inline_svg| D["Host LLM emits SVG inline<br/>→ asset_save_inline_svg"]
    C -->|external_prompt_only| E["Paste into web UI<br/>→ asset_ingest_external"]
    C -->|api| F["Server calls routed provider"]
    D --> G["matte · vectorize · validate"]
    E --> G
    F --> G
    G --> H["AssetBundle<br/>ios · android · pwa · favicon · visionos · flutter"]

宿主大模型会选择模式，也可以由你来选择。服务端会提供 modes_available，以便助手向你展示可选模式。始终优先选择免费方式。

路由器

路由决策位于 data/routing-table.json 中。能力矩阵位于 data/model-registry.json 中。每条规则都注明了研究来源。

禁用一栏非常重要。这就是为什么 prompt-to-asset 会拒绝使用任何扩散采样器渲染超过 3 个词的文字标志，也解释了为什么请求透明 PNG 时不会使用 Imagen。

Pollinations 之外的免费途径

运行 p2a doctor（或让你的助手调用 asset_doctor()），即可查看当前环境中哪些服务可用。

安装

所有命令都可通过 npx 运行——无需安装。

# Zero install
npx prompt-to-asset doctor           # what's live in this shell right now
npx prompt-to-asset doctor --fix     # auto-install native deps (brew / cargo / scoop; never sudo)
npx prompt-to-asset pick             # interactive route picker
npx prompt-to-asset init --register  # scaffold brand.json + register in .cursor / .vscode / .windsurf

# Or global for daily use
npm i -g prompt-to-asset
p2a doctor

# Or per-project for CI
npm i -D prompt-to-asset

注册到 AI 助手

claude mcp add prompt-to-asset -- p2a

npx -y @smithery/cli install prompt-to-asset --client claude

注册后，你的助手即可使用完整的 24 个 asset_* 工具。

覆盖的模型

付费直连 API： gpt-image-1、gpt-image-1.5、dall-e-3（已弃用，2026-05-12）、imagen-3、imagen-4、gemini-3-flash-image（Nano Banana）、gemini-3-pro-image、sd-1.5、sdxl、sd3-large、playground-v3、flux-schnell、flux-dev、flux-pro、flux-2、flux-kontext-pro、ideogram-3、ideogram-3-turbo、recraft-v3、leonardo-phoenix、leonardo-diffusion-xl、fal-flux-pro、fal-flux-2、fal-sdxl。

免费套餐／无需密钥： pollinations-flux、pollinations-turbo、pollinations-kontext、pollinations-sd、horde-sdxl、horde-flux、hf-sdxl、hf-sd3、hf-flux-schnell、hf-flux-dev。

仅支持粘贴的平台： midjourney-v6、midjourney-v7、firefly-3、krea-image-1。如果将 asset_generate_* 与 mode: "api" 搭配用于仅支持粘贴的主模型，它会自动回退到链中第一个可通过 API 访问的模型，并显示警告。如果整个链中的模型都仅支持粘贴，则会返回 ExternalPromptPlan，而不是报错。

p2a                          # default — MCP stdio server
p2a mcp                      # same, explicit
p2a export <master.png>      # offline platform fan-out
p2a export <master.png> --json
p2a init                     # interactive brand.json + IDE registration hints
p2a init --register          # + auto-write .cursor/mcp.json / .vscode/mcp.json / .windsurf/mcp.json
p2a pick                     # interactive model picker
p2a doctor                   # environment inventory
p2a doctor --json            # structured output
p2a doctor --data            # check data/model-registry.json ↔ data/routing-table.json consistency
p2a doctor --fix             # auto-install missing native deps (brew / cargo / scoop; never sudo)
p2a models list              # --free | --paid | --paste-only | --rgba | --svg
p2a models inspect <id>      # full capability dump
p2a sprite-sheet <dir>       # pack frames → PNG + atlas
p2a nine-slice <image>       # 9-slice JSON + CSS + engine numbers + .9.png
p2a --help

{
  "name": "Halcyon",
  "palette": ["#2563eb", "#ffffff"],
  "fonts": { "display": { "family": "Inter", "weights": [700, 800] } },
  "style_refs": ["https://…/sample1.png", "./refs/style2.png"],
  "do_not": ["drop shadows", "heavy gradients"],
  "lora": "halcyon-flux-v2",
  "sref_code": "--sref 1234567890",
  "style_id": "rc_halcyon_01"
}

  brief (text)
    ↓  asset_capabilities         → modes available + free/paid/paste-only bucketing
    ↓  asset_enhance_prompt       → AssetSpec {
    ↓                                  routing_trace: { rule_id, reason, research_sources, never_models, fallback_chain },
    ↓                                  modes_available,
    ↓                                  svg_brief?,         (inline_svg)
    ↓                                  paste_targets?,     (external_prompt_only)
    ↓                                  rewritten_prompt, …
    ↓                                }
    ↓
    ├─ mode: inline_svg                → host LLM emits <svg>; asset_save_inline_svg writes bundle
    ├─ mode: external_prompt_only      → user pastes into web UI; asset_ingest_external runs matte → vectorize → validate
    └─ mode: api                       → provider(model, prompt, params) → matte → vectorize → upscale → export → validate

API 密钥由你掌控。其他一切都交给大模型。

终端中唯一要做的事，就是安装软件包并将密钥写入 .env。密钥不应通过聊天传递。其他所有操作——诊断检查、模型检查、多平台分发、品牌素材搭建、精灵图集、九宫格配置——都是你用自然语言提出请求后，由助手调用的 MCP 工具。

对比

安全性

此工具最多可处理 15 家服务商的 API 密钥。以下要求不可妥协：

• **密钥只能存放在环境变量中。**绝不写入磁盘、绝不记录日志，也绝不回显到 MCP 响应中。服务商的错误正文在传递给宿主大模型前，会先经过 redact()（packages/mcp-server/src/security/redact.ts）处理。
• 路径访问采用允许列表。image_path / output_dir / existing_mark_svg 会解析符号链接，并拒绝任何超出项目当前工作目录、已配置输出目录、缓存目录和操作系统临时目录的路径。可通过 P2A_ALLOWED_PATHS=/path1:/path2 扩大范围。
• SVG 在写入前会进行 XSS 清理。<script>、<foreignObject>、on*= 处理程序、javascript: URI、外部 <image href> / <use href>、通过网络加载的 CSS @import——均会被拒绝。此检查始终运行；无需安装 SVGO。
• **成本保护机制。**设置 P2A_MAX_SPEND_USD_PER_RUN=5.00，即可为单次工具调用设置费用上限。若预估费用超出上限，调用前检查会拒绝执行。免费层级路由的费用始终为 $0。
• **启动时确保数据完整性。**启动时会运行 assertDataIntegrityAtBoot()。如果某条路由规则指向注册表中不存在的模型 ID，服务将拒绝启动并给出明确错误。可在 CI 中通过 p2a doctor --data 进行检查。
• 无遥测。除非路由到的服务商明确要求，否则不会进行远程调用。

完整政策：SECURITY.md。

基于研究的决策

每条已实现的路由规则、方言切换、安全区域尺寸和文本上限，都有 docs/research/ 下的文件作为依据。每次调用 asset_enhance_prompt 都会返回一个 routing_trace.research_sources 数组。角度与代码位置的对应关系，以及如实记录已接入和已推迟事项的清单，见 docs/RESEARCH_MAP.md。

开发

git clone https://github.com/MohamedAbdallah-14/prompt-to-asset.git
cd prompt-to-asset
npm install
npm run build
npm run typecheck
npm run lint
npm test               # vitest watch
npm run test:run       # vitest run (CI)
npm run smoke          # list tools via MCP stdio + correctness assertions
npm run sync           # regenerate IDE mirrors from SSOTs
npm run verify         # byte-verify mirrors match SSOTs

单一事实来源位于 skills/*/SKILL.md、rules/*.md、.claude-plugin/ 和 data/*.json。不要直接编辑 .cursor/、.claude/、.windsurf/——它们会由 scripts/sync-mirrors.sh 重新生成，且 CI 会逐字节验证。

• 贡献流程：CONTRIBUTING.md
• 用户入门指南：GETTING_STARTED.md
• 常见问题：TROUBLESHOOTING.md
• 发行说明：CHANGELOG.md

社区

• 问题和功能请求：GitHub Issues
• 安全问题披露：SECURITY.md
• 行为准则：CODE_OF_CONDUCT.md
• Star 历史：

如果这个仓库帮你省去了手工制作另一个 AppIconSet 的麻烦，点个 Star 就能帮助它触达其他面临同样难题的开发者。

延伸阅读

深入了解设计背后的思考：

• 我为何不再挑选图像模型，而是改为构建路由器 — 介绍如何在 30 多种图像模型之间进行路由。
• MCP 服务架构：prompt-to-asset 的内部构造 — 深入解析架构。

文章也发布在 Medium 和 dev.to。

许可证

MIT © prompt-to-asset 贡献者。