中文首批试跑反馈：Windows + Photoshop PSD 批量生成

[Kriswd]

这里收集第一批中文用户的真实试跑反馈，重点看 Windows + 本机 Photoshop + Excel 商品表 + PSD 模板这条链路是否顺畅。

建议先按这几个入口试：

• B 站演示视频：https://www.bilibili.com/video/BV1YDTA6nEeN/
• 项目首页：https://kriswd.github.io/Fdesign/
• 中文快速试跑：https://github.com/Kriswd/Fdesign/blob/main/docs/QUICKSTART_CN.md
• Demo Kit：https://github.com/Kriswd/Fdesign/tree/main/docs/demo-kit
• 净化案例提交指南：https://github.com/Kriswd/Fdesign/blob/main/docs/SHOWCASE_GUIDE.md
• V3.0 Release：https://github.com/Kriswd/Fdesign/releases/tag/v3.0.0
• 快速反馈 Issue：https://github.com/Kriswd/Fdesign/issues/new?template=quickstart_feedback.yml
• Template showcase Issue：https://github.com/Kriswd/Fdesign/issues/new?template=template_showcase.yml

最希望收到的反馈：

• 首次启动卡在哪一步：依赖安装、后端健康检查、前端页面、Photoshop 调度、模板解析、导出。
• 你的 PSD 模板大概是什么类型：主图、详情页、活动图、规格图，描述即可，不要上传私有素材。
• 哪些字段绑定最常用：货号、色号、品牌、品类、镜片参数、公开规格等。
• PSD 里大概有哪些文本变量和图片变量，可以按净化案例指南描述结构。
• 哪个 README、Quick Start 或 FAQ 位置看不懂，可以直接指出段落。

请不要贴私有 PSD、真实商品素材、账号信息、token、后台截图、授权不清素材或未净化字段。能脱敏复现的问题，可以开 issue；如果你已经跑通，点 Star 是对这个开源项目最直接的反馈，也能帮助更多电商设计和运营同学看到它。

[Kriswd]

更新：新增中文排障入口，适合第一次试跑时按顺序自查依赖、端口、后端健康检查、图片匹配和 Photoshop 导出失败。

• 中文排障清单：https://github.com/Kriswd/Fdesign/blob/main/docs/TROUBLESHOOTING_CN.md
• 最小 PSD 模板教程任务：Good first issue: add minimal PSD template walkthrough #9
• Photoshop 导出排障样例收集：排障样例征集：Photoshop 导出失败的净化复现 #10

继续提醒：反馈前请净化信息，不要公开私有 PSD、真实商品图、账号信息、token、后台截图、授权不清的素材或未净化字段。

[Kriswd]

更新：最小 PSD 模板教程已经加入公开演示包，适合第一次试跑时从零做一个本机测试 PSD：

https://github.com/Kriswd/Fdesign/blob/main/docs/demo-kit/MINIMAL_PSD_TEMPLATE_CN.md

它和 sample-products.csv、field-map.example.json 对齐，先验证 title / sku / color_no / subtitle / hero_image 这些变量，再迁移到真实模板。

后续截图/GIF 增强拆到 #11。反馈仍请保持脱敏，不要公开私有 PSD、真实商品图、账号信息、token、后台截图、授权不清的素材或未净化字段。

[Kriswd]

Update: the minimal PSD walkthrough now includes a public-safe binding diagram, showing how Photoshop layer names, Fdesign product slots, and CSV fields map together: https://github.com/Kriswd/Fdesign/blob/main/docs/demo-kit/assets/minimal-psd-binding-flow.svg

[Kriswd]

Update: the minimal PSD walkthrough now also includes the public workbench screenshot and a "what you should see after a successful run" section. This should make it easier to tell whether the first run is still stuck in an empty state or has reached the real binding workflow.

Guide: https://github.com/Kriswd/Fdesign/blob/main/docs/demo-kit/MINIMAL_PSD_TEMPLATE_CN.md

The screenshot task is closed in #11; export troubleshooting examples remain open in #10.

[Kriswd]

Update: the first public sanitized showcase is now available.

Showcase: https://github.com/Kriswd/Fdesign/blob/main/docs/showcases/EYEWEAR_DETAIL_WORKFLOW_CN.md

It uses the public workbench screenshot and demo-kit data to explain a complete ecommerce workflow: Excel fields, product images, PSD variables, product-slot binding, and PSD / PSB / PNG / JPEG export. It does not include private PSD files, real product images, private workflow material, or backend account screenshots.

The public project page also links this showcase from the "净化案例" section: https://kriswd.github.io/Fdesign/

[Kriswd]

Showcase index landed:

https://github.com/Kriswd/Fdesign/tree/main/docs/showcases

The index now links the first sanitized eyewear workflow and gives newcomers a clear reading order: showcase -> demo kit -> minimal PSD tutorial -> troubleshooting. It also lists the next case types worth collecting, so Chinese users can submit sanitized reproductions without exposing private PSD files, real product images, account pages, private workflow material, or unredacted fields.

[Kriswd]

新增几个适合直接参与的小任务：

• GIF 演示补充：Good first issue: add a public GIF demo to README and Pages #13
• 主图多色号案例：Showcase request: add multi-color main image export case #12
• 多画板详情页案例：Showcase request: add multi-artboard batch export case #14
• Photoshop 导出排障样例收集：排障样例征集：Photoshop 导出失败的净化复现 #10

如果你只是第一次试跑，建议先按这个顺序看：

1. 项目页：https://kriswd.github.io/Fdesign/
2. B 站演示：https://www.bilibili.com/video/BV1YDTA6nEeN/
3. 演示包：https://github.com/Kriswd/Fdesign/tree/main/docs/demo-kit
4. 案例库：https://github.com/Kriswd/Fdesign/tree/main/docs/showcases
5. 中文快速试跑：https://github.com/Kriswd/Fdesign/blob/main/docs/QUICKSTART_CN.md

反馈和案例请继续保持公开安全：不要上传私有 PSD、真实商品图、账号信息、token、后台截图、授权不清的素材或未净化字段。

[Kriswd]

更新一下公开试跑材料：

README 和 GitHub Pages 已补一个 5 步工作流 GIF，直接展示 PSD 模板预览、图片变量替换、Excel 字段绑定和批量导出：

https://github.com/Kriswd/Fdesign/blob/main/docs/assets/fdesign-workflow-demo.gif

现在公开材料已经有：GIF、B 站演示、demo-kit、最小 PSD 教程、主图多色号案例、多画板案例和详情页案例。下一步我会优先收 Photoshop 导出失败、图片匹配失败、模板变量看不懂这几类反馈，并整理到排障文档和 issue。

如果你愿意试跑，建议先走中文快速试跑：

https://github.com/Kriswd/Fdesign/blob/main/docs/QUICKSTART_CN.md

反馈时请继续不要上传私有 PSD、真实商品图、账号信息、token、后台截图或未净化字段。

[Kriswd]

继续补一条试跑反馈入口：

中文排障清单已经新增 Photoshop 导出失败净化样例，包含 IDAT: incorrect data check、Photoshop 静默吞任务、批量中途失败、PSD/PSB 保存失败和替换后偏移叠字：

https://github.com/Kriswd/Fdesign/blob/main/docs/TROUBLESHOOTING_CN.md#7-photoshop-%E5%AF%BC%E5%87%BA%E5%A4%B1%E8%B4%A5%E5%87%80%E5%8C%96%E6%A0%B7%E4%BE%8B

如果你试跑时卡在 Photoshop 导出，不用上传真实 PSD 或商品图。按样例整理：卡住步骤、环境、最短复现、错误摘要、已排查项，再发到这个 issue：

#10

[Kriswd]

补一个首批试跑最容易卡住的入口：图片匹配和图层命名净化样例已经进排障清单。

• 排障清单：https://github.com/Kriswd/Fdesign/blob/main/docs/TROUBLESHOOTING_CN.md
• 图片匹配/图层命名样例：https://github.com/Kriswd/Fdesign/blob/main/docs/TROUBLESHOOTING_CN.md#51-%E5%9B%BE%E7%89%87%E5%8C%B9%E9%85%8D%E5%92%8C%E5%9B%BE%E5%B1%82%E5%91%BD%E5%90%8D%E5%87%80%E5%8C%96%E6%A0%B7%E4%BE%8B
• 案例收集 issue：排障样例征集：图片匹配和图层命名问题 #15

遇到图片未绑定、正侧/45 度图匹配错、PSD 图层变量不识别、CSV 表头或字段映射错列，可以按文档里的格式提交净化信息。

[Kriswd]

补了一个更短的首次访问入口，适合从社区、文章或朋友转发第一次点进来的用户：

• 中文上手入口：https://github.com/Kriswd/Fdesign/blob/main/docs/START_HERE_CN.md

它把入口分成看演示、本地试跑、理解字段绑定、查看案例、排障反馈和参与改进几类。后续如果你不确定该看哪份文档，可以先从这里开始。

[Kriswd]

更新一条公开入口：已新增机器可读项目摘要 llms.txt，用于搜索、AI 摘要和社区转发时快速理解 Fdesign 是什么、适合谁、怎么试跑、哪里反馈。

• Pages 入口：https://kriswd.github.io/Fdesign/llms.txt
• GitHub 文件：https://github.com/Kriswd/Fdesign/blob/main/docs/llms.txt
• 对应提交：995c06e3

第一次看到项目的用户仍建议先走中文上手入口：https://github.com/Kriswd/Fdesign/blob/main/docs/START_HERE_CN.md

[Kriswd]

补了一页中文适用场景，用来回答“我的 PSD 批量作图流程是否适合 Fdesign”：

• GitHub 文档：https://github.com/Kriswd/Fdesign/blob/main/docs/USE_CASES_CN.md
• Pages 直达：https://kriswd.github.io/Fdesign/USE_CASES_CN.md
• 对应提交：f861b0d6

这页按主图多色号、多画板详情页、字段组合、本机 Photoshop 自动化链路，以及暂时不适合的场景做了拆分。后续外部帖子里如果有人不确定该不该试跑，可以优先回这页。

[Kriswd]

新增一个更适合首批试跑用户的反馈入口：PSD 工作流适配反馈。

适合这种情况：项目能看懂或已经能启动，但不确定自己的 PSD 结构、Excel 字段、图片命名和导出结果能不能迁移到 Fdesign。

入口：

• 适配反馈模板：https://github.com/Kriswd/Fdesign/issues/new?template=workflow_fit.yml
• 公开收集任务：PSD 工作流适配：收集净化后的 PSD + Excel 结构 #17
• 中文适用场景：https://github.com/Kriswd/Fdesign/blob/main/docs/USE_CASES_CN.md

提交时只写净化后的结构和假数据，不要上传私有 PSD、真实商品图、账号信息、token、后台截图或未净化字段。

[Kriswd]

更新：新增「国内访问与试跑减阻」入口，适合 GitHub 下载慢、npm install 慢、端口/Photoshop 准备度不确定时先看：

https://github.com/Kriswd/Fdesign/blob/main/docs/CHINA_ACCESS_CN.md

公开仓库现在只保留用户试跑、演示、案例和贡献入口；渠道投放、运营排期、指标复盘等执行资料不放公开树。

[Kriswd]

更新：中文首次试跑现在建议优先走这条最短路径：

1. 先看中文上手入口：
   https://github.com/Kriswd/Fdesign/blob/main/docs/START_HERE_CN.md
2. 第一次启动卡住，跟进 中文首次试跑反馈：Windows + Photoshop 启动卡点 #7：
   中文首次试跑反馈：Windows + Photoshop 启动卡点 #7
3. PSD 结构、字段绑定或图片命名不确定，跟进 PSD 工作流适配：收集净化后的 PSD + Excel 结构 #17：
   PSD 工作流适配：收集净化后的 PSD + Excel 结构 #17

30 秒反馈里请尽量写清：来源、想跑的流程、卡住步骤、Windows/Node.js/Photoshop 版本、净化后的 PSD 结构、净化后的 Excel 字段、净化后的图片命名、5-20 行报错摘要、期望导出格式。

本轮公开面校验已通过：
https://github.com/Kriswd/Fdesign/actions/runs/28712210390

请不要上传私有 PSD、真实商品图、账号信息、token、后台截图或未净化字段。能用假数据复现的，优先用假数据。