🐧 天津美术学院

基于 Penguin Magic 的 AI 图像桌面管理工具

告别混乱，让创意井井有条

---

V0.2.4 增加导入创意库：【创意库】-【智能导入】-【输入编号】 增加红房子黄房子来判断后端服务是否正常运行。V0.2.3 最新分支支持多并发。

🌟 为什么选择本工具？

传统 AI 生图工具的痛点：

• ❌ 生成的图片散落各处，找不到
• ❌ 没有管理功能，越用越乱
• ❌ 无法快速对比和整理作品

本工具 重新定义 AI 创作体验：

🎯 生成即管理 — 不只是生图，更是一个可视化创意工作台

---

✨ 核心特性

🖥️ 桌面级管理体验

像整理桌面一样管理你的 AI 作品。拖拽、分组、叠放，一切尽在掌控。

📁 智能文件夹 & 叠放

• 文件夹 — 按项目归类，清晰有序
• 智能叠放 — 同系列作品自动聚合，节省空间

🖱️ 自然拖放交互

• 从电脑直接拖拽图片/文件夹到工作台
• 拖拽调整位置，所见即所得
• 多选批量操作，效率倍增

📚 创意库系统

内置多种创意模板，一键应用专业提示词，小白也能出大片。

🔄 完整创作闭环

生成 → 预览 → 再编辑 → 重新生成 → 管理保存，全流程无缝衔接。

---

🎨 设计理念

轻量 · 直觉 · 高效

• 轻设计 — 克制的视觉，让作品成为主角
• 零学习成本 — 熟悉的桌面交互，上手即用
• 本地优先 — 数据存在本地，快速又安全

---

🚀 快速开始

方式一：一键启动（推荐）

# 1. 首次使用，双击运行
Install.bat

# 2. 以后每次启动，双击运行
Start.bat

# 3. 自动打开浏览器
http://127.0.0.1:8765

每次更新代码后需重新执行 Install.bat（会重新 build 前端），再按 Start.bat 启动。

---

方式二：手动启动（生产模式，访问 8765）

后端会托管已构建的前端（dist），浏览器只访问 8765 一个端口。

# 1. 安装依赖（项目根目录）
npm install
cd backend-nodejs && npm install && cd ..

# 2. 构建前端（项目根目录）
npm run build

# 3. 启动后端（会托管 dist 并提供 API）
cd backend-nodejs
node src/server.js

# 4. 浏览器打开
http://127.0.0.1:8765

• 后端：http://127.0.0.1:8765（API + 静态前端）
• 关闭后端用 Ctrl+C；停止后需重新执行第 3 步再启动。

---

方式三：开发模式（前端热更新，访问 5176）

前端用 Vite 开发服务器（热更新），API 通过代理转发到后端 8765。

# 终端 1：启动后端
cd backend-nodejs
node src/server.js

# 终端 2：启动前端（项目根目录）
npm run dev

# 浏览器打开（注意是 5176）
http://localhost:5176

• 前端：http://localhost:5176（Vite，/api、/files 等会代理到 8765）
• 后端：http://127.0.0.1:8765（仅 API，不直接访问）
• 修改前端代码会自动刷新；修改后端需重启终端 1。

环境要求

• Node.js 18 或更高版本
• Windows 10/11（其他系统需手动启动）

---

🛠️ 技术栈

层级	技术
前端框架	React 19 + TypeScript
样式方案	Tailwind CSS
构建工具	Vite
后端服务	Node.js + Express
AI 能力	Gemini API / API

---

🙏 特别鸣谢

本项目为 天津美术学院AIGC Tools（魔改版 v0.2.0），基于 Penguin-Magic v1.6.0 魔改，感谢原版作者 PenguinTeo 的开源贡献。

---

天津美术学院 —

Made with ❤️ by TAFA