ziguishian/MxPage

MxPage – 面向电商产品图片的 AI 驱动桌面工作台

它是什么 – 一款开源的基于 Electron 的桌面应用，让商家（或任何创建商品列表的人）能够使用大型语言和图像模型生成主图、多页详情页图形和社交媒体视觉素材。该工具在 Windows 或 macOS 上本地运行，通过兼容 OpenAI 的 API 进行文生图，并将所有数据存储在用户机器上。

主要功能

领域	你能做什么
商品页面创建	上传参考照片，填写已知商品信息，选择目标平台（淘宝、拼多多、抖音、小红书等）和语言，应用会自动生成主图、完整详情页（3-10 张主图、4-20 个详情屏）和移动端预览样机。
内容规划	内置 LLM 规划器提取卖点、使用场景、证据和任何缺失信息，在生成前提示用户确认未知值。
多平台风格	针对特定平台的提示预设，为每个中国电商渠道调整措辞和视觉风格。
批量处理	将整个商品文件夹排队，顺序运行，查看每个项目的失败情况，并从上次中断处继续。
图片翻译	使用固定翻译提示将现有商品图片翻译成其他语言（单张、批量或文件夹）——无需商品规划代理。
编辑与交付	生成后，你可以编辑每张图片，比较原始版本与翻译版本，保留编辑历史，并导出所有资产的 ZIP 包或单张长滚动详情图。
监控	实时查看当前工作流阶段、每张图片的延迟、API 成本估算（以人民币显示）以及 12 个月的使用热力图。
用户中心	头像、最近使用统计、模型配置界面和“关于”页面。

工作原理（V4 工作流）

PREPARE → PLAN → WAITING_INPUT → ART_DIRECTION →
GENERATE → IMAGE_REVIEW → SET_REVIEW →
COMPLETED / PARTIAL / FAILED

• LLM 返回 JSON 计划和故事板。首张主图生成后，其余图片并行获取（最多 2 个并发调用）。所有布局均在本地完成：文本块放置、保留换行、表格保持完整，最终长滚动图片无需额外 LLM 调用即可组装。
• 检查点会被持久化，因此你可以停止运行、修复问题并恢复，而无需为已生成的资产重复付费。
• 错误（超时、错误响应）不会自动重试——界面会在花费更多额度前询问你。

快速开始

1. 从 Releases 页面下载相应的 ZIP（Windows x64、macOS ARM64 或 Intel）。压缩包包含 Electron 和一个轻量级 Node.js 后端；无需单独安装 Node。
2. 运行可执行文件（MxPage.exe 或 MxPage.app）。
3. 打开 API 配置 面板（左下角头像），输入支持结构化 JSON 响应和图像生成的兼容 OpenAI 服务的 URL 和 API 密钥（例如官方 OpenAI API、Azure OpenAI 或自托管模型网关）。
4. 点击 上传 添加参考商品照片，回答提示的问题（尺寸、材质等），选择目标平台和语言，然后点击 开始。
5. 观察进度条，如有需要编辑任何生成的图片，最后导出资产。

技术栈

• 前端 – React + Next.js（本地服务）在 Electron 壳内。
• 后端 – Node.js 24，Prisma ORM 搭配 SQLite 数据库（prisma/dev.db）。
• AI 集成 – lib/ai 包含提供商适配器；默认工作流期望一个名为 GPT‑6 Luna 的模型用于文本规划，以及 GPT‑Image 2.5 Flare 用于图像生成，但任何返回所需 JSON 架构的模型都可以。
• 图像处理 – 使用 sharp 进行最终长滚动页面的调整大小/合成。
• 测试 – Jest 单元测试、工作流重点测试（npm run test:detail）以及桌面构建的冒烟测试。

许可证与社区

• 源代码在宽松的 MIT 许可证下发布。生成的图像和任何第三方资产仍受底层模型提供商和任何版权所有者的条款约束。
• 该项目由 灵矩绘境 (MatrixInspire) 维护。欢迎通过 GitHub Issues 跟踪器提交问题、功能请求和错误报告；README 中提供了社区聊天二维码。

谁应该考虑使用它

• 中小型电商卖家，需要为多个中国市场的商品快速生成一致的商品视觉素材。
• 希望在不雇佣设计师处理每个 SKU 的情况下原型化商品页面的营销团队。
• 对构建或扩展本地运行的生成式 AI 工作流感兴趣的开发者（代码库完全开放，包含 V4 状态机实现）。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。