MCPcopy Index your code
hub / github.com/PenguinTeo/Penguin-Magic

github.com/PenguinTeo/Penguin-Magic @1.1.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release 1.1.4 ↗ · + Follow
437 symbols 825 edges 78 files 37 documented · 8%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

image

🐧 企鹅工坊 Penguin Magic

全球首款 AI 图像桌面管理工具

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

Made with React TypeScript Tailwind CSS


之前的不记录了 V0.2.4 增加导入创意库:https://opennana.com/awesome-prompt-gallery/ 【创意库】-【智能导入】-【输入编号】 增加红房子黄房子来判断后端服务是否正常运行 最近遇到几次后端服务挂掉的情况,希望大家反馈,至今未排查出原因! V0.2.3 最新分支支持多并发

🌟 为什么选择企鹅工坊?

传统 AI 生图工具的痛点: - ❌ 生成的图片散落各处,找不到 - ❌ 没有管理功能,越用越乱 - ❌ 无法快速对比和整理作品

企鹅工坊 重新定义 AI 创作体验:

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


✨ 核心特性

🖥️ 桌面级管理体验

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

📁 智能文件夹 & 叠放

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

🖱️ 自然拖放交互

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

📚 创意库系统

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

🔄 完整创作闭环

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


🎨 设计理念

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

🚀 快速开始

方式一:一键启动(推荐)

# 1. 首次使用,双击运行
install.bat

# 2. 以后每次启动,双击运行
start.bat

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

每次更新后都要如上操作一遍!!!

方式二:手动启动

# 1. 安装前端依赖
npm install

# 2. 安装后端依赖
cd backend-nodejs
npm install
cd ..

# 3. 构建前端
npm run build

# 4. 启动 Node.js 后端服务
cd backend-nodejs
node src/server.js

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

环境要求

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

🛠️ 技术栈

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

📞 联系我们

  • Q群 — 854266067
  • 微信 — Lovexy_0222
  • 技术支持 — 企鹅 · 无我

🙏 特别鸣谢

T8 — 感谢提供视频宣传支持 大熊 — 感谢提供视频宣传支持


企鹅工坊 — 让 AI 创作不再凌乱

Made with ❤️ by Penguin Team

Extension points exported contracts — how you extend this code

CreativeRecord (Interface)
* 前端创意提取器 * 用于从前端获取并提取创意数据
services/creativeExtractor.ts
LeftPanelProps (Interface)
(no doc)
App.tsx
GeneratedContent (Interface)
(no doc)
types.ts
ContextMenuState (Interface)
(no doc)
types/desktopTypes.ts
ApiKeyManagerProps (Interface)
(no doc)
components/ApiKeyManager.tsx
EmptyStateProps (Interface)
(no doc)
components/EmptyState.tsx
HistoryDockProps (Interface)
(no doc)
components/HistoryDock.tsx
RunningHubGeneratorProps (Interface)
(no doc)
components/RunningHubGenerator.tsx

Core symbols most depended-on inside this repo

normalizeImageUrl
called by 25
utils/image.ts
post
called by 25
services/api/index.ts
useTheme
called by 22
contexts/ThemeContext.tsx
load
called by 14
backend-nodejs/src/utils/jsonStorage.js
save
called by 13
backend-nodejs/src/utils/jsonStorage.js
delete
called by 12
backend-nodejs/src/utils/thumbnail.js
openDB
called by 12
services/db/index.ts
get
called by 10
services/api/index.ts

Shape

Function 304
Interface 88
Method 30
Class 14
Enum 1

Languages

TypeScript100%

Modules by API surface

App.tsx40 symbols
components/Desktop.tsx36 symbols
services/geminiService.ts22 symbols
types.ts21 symbols
components/AddCreativeIdeaModal.tsx18 symbols
services/creativeExtractor.ts13 symbols
services/api/runninghub.ts13 symbols
components/CreativeLibrary.tsx12 symbols
services/api/index.ts11 symbols
services/api/files.ts11 symbols
components/ImagePreviewModal.tsx11 symbols
contexts/ThemeContext.tsx10 symbols

For agents

$ claude mcp add Penguin-Magic \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact