Awesome GPT-Image-2 部署与使用教程

Awesome GPT-Image-2 是一个工业级提示词（Prompt）引擎与模板库，它逆向工程了超过530个AI图像生成案例，并将其提炼为结构化的“提示词即代码”（Prompt as Code）资产。该项目旨在帮助开发者、设计师和AI爱好者稳定、可控地生成高质量的图像，非常适合需要批量生成、模板化工作流的场景。

本文将介绍四种部署和使用方式，从直接浏览到本地开发，你可以根据自己的需求选择最合适的一种。

准备工作

在开始之前，了解以下信息会有所帮助：

  1. 核心概念：项目将散乱的提示词转化为结构化的协议（如JSON），分解了主体、灯光、材质、布局等要素，便于复用和自动化。
  2. 环境（如需本地开发）：需要安装 Node.js (建议v18或更新版本) 和 npm 或 yarn 包管理器。
  3. API密钥（如需在线生成）：若想体验网站自带的图像生成功能，可能需要准备 APIMart 或 Supabase 等服务的API密钥。

方式一：直接浏览在线网站（零部署，最快捷）

这是体验项目最快速的方式，无需任何安装和配置。

  1. 访问官网：在浏览器中打开 https://gpt-image2.canghe.ai。
  2. 浏览案例：
    • 可以在“全案例画廊”中按分类（如UI界面、信息图表、海报等）浏览超过530个案例。
    • 点击任一案例，可以查看大图并一键复制完整的提示词。
  3. 在线生成（可选）：
    • 网站支持通过 Google 登录后，直接使用集成的 APIMart 服务生成图像，方便测试提示词效果。

方式二：安装Agent Skill（用于AI编程助手）

如果你使用 Claude Code、Codex、Cursor 等AI编程助手，可以安装项目的“技能包”（Skill），让AI助手能够智能地为你选择和组合提示词风格。

1. 快速安装（推荐）

在终端中运行以下命令，该命令会将技能安装到 Codex 和 Claude Code 的默认目录。

1
npx skills add freestylefly/awesome-gpt-image-2 --skill gpt-image-2-style-library --agent claude-code codex --global --yes --copy

2. 全局安装（为所有支持的Agent安装）

如果你想为所有本地AI助手安装此技能，可以运行：

1
npx skills add freestylefly/awesome-gpt-image-2 --global --all --copy

3. 在Claude Code中通过插件市场安装

在 Claude Code 会话中，依次执行以下命令：

1
2
/plugin marketplace add freestylefly/awesome-gpt-image-2
/plugin install gpt-image-2-style-library@awesome-gpt-image-2

4. 通过npm全局安装CLI工具

1
2
npm install -g gpt-image-2-style-library
gpt-image-2-style-library install all

安装完成后，重启你的AI助手会话，就可以通过自然语言使用此技能了，例如：“使用 gpt-image-2-style-library 为一张关于‘城市生活系统地图’的图表创建提示词”。

方式三：在本地运行项目网站（用于开发或自托管）

如果你想在本地运行完整的项目网站，进行二次开发或私人部署，可以按照以下步骤操作。

第一步：克隆项目

1
2
git clone https://github.com/freestylefly/awesome-gpt-image-2.git
cd awesome-gpt-image-2

第二步：安装依赖

1
npm install

第三步：配置环境变量

这是本地部署的关键步骤，项目需要连接 Supabase（用于用户认证和数据库）和 APIMart（用于图像生成）等服务。

  1. 在项目根目录下，复制 .env.example 文件并重命名为 .env.local。
  2. 编辑 .env.local 文件，填入必要的密钥：
    • VITE_SUPABASE_URL 和 VITE_SUPABASE_ANON_KEY：从你的 Supabase 项目设置中获取。
    • APIMART_API_KEY：从 APIMart 平台获取（用于图像生成功能）。
    • 其他变量如 Stripe 支付、Google Analytics 等可按需配置。
  3. （重要）数据库迁移：需要将 supabase/migrations/ 目录下的所有 SQL 文件应用到你的 Supabase 项目中，以创建用户积分、会员、订单等数据表。

第四步：启动开发服务器

1
npm run dev

应用将在 http://127.0.0.1:5173 (或类似端口) 启动，你可以进行本地访问和调试。

第五步：构建生产版本

1
npm run build

构建产物会生成在 dist 目录，可以部署到 Vercel、Netlify 或任何静态托管服务上。

方式四：本地开发与贡献（源码探索）

此方式适合希望研究项目结构或贡献代码的开发者。

  1. 本地生成技能数据：如果你修改了 data/style-library.json 风格库文件，可以重新生成技能数据。

    1
    npm run generate:style-skill

  2. 本地安装技能：将生成的技能安装到本地Agent目录进行测试。

    1
    npm run install:skill

  3. 项目结构概览：

    • data/：包含所有案例和风格库的JSON数据。
    • docs/：完整的提示词模板和详细指南。
    • agents/skills/：AI助手技能包的源码。
    • supabase/migrations/：数据库表结构定义。
    • src/：网站的前端源代码。

核心功能与使用建议

  1. 从案例开始：不要从零开始写提示词。先在案例画廊中找到风格或主题相近的图片，复制其提示词。
  2. 利用模板结构：将复制来的提示词与 工业级提示词模板 进行对照，学习如何将描述拆解为结构化的字段（如主体、光照、材质、布局）。
  3. 使用AI助手技能：如果你使用AI编程助手，通过方式二安装技能后，可以直接用中文描述需求（如“一张苹果风格的环保科学海报”），让AI帮你组合出结构化的提示词。
  4. 遵守使用规范：项目整理的内容来自社区公开资源，仅供学习与研究使用。在商业应用前，请务必确认原始内容的授权许可。

请始终确保在合法合规的场景下使用此工具，并尊重原始内容的版权。如果本项目对你有所帮助，可以考虑为它点一个Star。