把 Excel 商品数据，一键变成批量 PSD 成品。
Turns Excel product data into batch PSD deliverables through a local Photoshop automation workbench.
闪图 Fdesign 是面向电商设计师、运营和自动化开发者的开源 PSD 图像生产工作台。你可以导入 PSD 模板，绑定 Excel 字段、商品图和规则链，再通过本机 Photoshop 批量导出 PSD、PSB、PNG 与 JPEG 成品。
如果 Fdesign 帮你少做重复图，欢迎给仓库点一个 Star，也欢迎把真实模板场景、问题和改进建议发到 Issues / Discussions。
项目页：https://kriswd.github.io/Fdesign/
上图展示 PSD 画布预览、商品位绑定、Excel 数据控制台与导出入口的主工作流。
- 导入 PSD 模板
- 绑定 Excel 字段与商品图
- 批量导出 PSD / PSB / PNG / JPEG
- 电商设计师：减少重复替换商品图、文案和规格字段的机械工作。
- 电商运营：把 Excel 商品数据变成可复用的图像生产任务。
- 自动化开发者：参考 React + Node.js + Photoshop JSX/VBS 的本地自动化链路。
- 小团队与工作室：在本机保留 PSD、素材和导出结果，不依赖云端图片生产服务。
- 在浏览器中解析 PSD 模板并管理可替换变量。
- 结合 Excel、图片变量和规则链生成批量任务。
- 通过 Node.js 调度 Photoshop 完成 PSD、PSB、PNG 与 JPEG 导出。
- 提供模板配置、任务模板和运行数据的本地管理能力。
- 支持公开店铺服务入口，但开源功能可直接本地运行。
- Node.js 18+
- Windows 10/11 x64
- 本机已安装且可被脚本调用的 Adobe Photoshop
仓库只包含应用代码，不分发 Photoshop、字体、模板素材或运行产物。
npm install
npm run server
npm run dev开发访问地址：
- 前端界面：
http://127.0.0.1:3010/ - 后端健康检查：
http://127.0.0.1:3001/health
后端读取当前 shell 中的环境变量；前端本地变量可参考 .env.example。生产模式启用后台会话前，请先设置足够长的 ADMIN_AUTH_SECRET 并收紧允许访问的来源。
欢迎提交这些类型的贡献：
- 复现清楚的 bug report，尤其是 PSD 模板解析、Excel 字段绑定、Photoshop 导出失败。
- 真实模板/工作流案例，帮助项目沉淀更多电商图像生产场景。
- 文档、截图、快速开始和故障排查改进。
- 面向新手的 issue、示例数据和模板说明。
开始前建议先阅读 CONTRIBUTING.md。如果不确定该提 Issue 还是 Discussion，可以先在 Discussions 里描述你的工作流。
首页顶部默认展示“选购服务”入口，指向公开店铺：
VITE_SHOP_URL=https://pay.ldxp.cn/shop/FTIWLFHQ
VITE_SHOP_LINK_LABEL=选购服务开源功能可直接本地运行；需要模板定制、部署协助或成品服务时，再使用店铺入口。
如需替换入口地址，可在部署环境中覆盖 VITE_SHOP_URL；设置为非 http(s) 地址时，顶部店铺入口会自动隐藏。
src/：React 前端server/：后端 API、模板存储与 Photoshop 调度server/photoshop/：Photoshop JSX/VBS 脚本tests/：Node 测试和浏览器烟测docs/：架构、API、使用说明与公开发布资料
npm run lint
npm run build
npm test涉及 Photoshop 宿主进程、导出结果或真实页面交互时，还需要启动前后端做端到端回归。
本项目基于 MIT License 发布。