中文首次试跑反馈：Windows + Photoshop 启动卡点

[Kriswd]

中文快速试跑反馈集中帖

如果你是第一次在 Windows + Photoshop 环境里启动 Fdesign，请先按这条顺序试跑：

1. 看 国内访问与试跑减阻。
2. 看 中文上手入口。
3. 按 中文快速试跑 启动后端和前端。
4. 先用 公开演示包 或 最小 PSD 模板教程，不要一开始就上传复杂模板。

反馈时请带上

• 卡点位置：GitHub 页面访问、下载 ZIP、git clone、npm install、npm 镜像、npm run server、/health、npm run dev、前端页面、Photoshop 手动打开/授权弹窗、公开演示包理解、简化 PSD 试跑、Photoshop 导出。
• 环境版本：Windows、Node.js/npm、Photoshop、Fdesign /health 版本。
• 已执行的关键命令和脱敏后的关键输出。
• http://127.0.0.1:3001/health 是否能返回 JSON。
• Photoshop 是否能手动打开，是否卡在登录、授权、更新或弹窗。
• 哪一步会影响你继续试用、Star、分享或提交 PR。

请不要上传

请不要上传私有 PSD 模板、真实商品图、账号信息、token、后台截图、授权不清素材或未净化字段。截图和日志请先替换成假数据。

更完整的表单

如果你愿意按结构填写，可以直接使用中文试跑反馈模板：

https://github.com/Kriswd/Fdesign/issues/new?template=quickstart_feedback.yml

[Kriswd]

补充一个新的公开排障入口，方便第一次试跑时先自查：

• 中文排障清单：docs/TROUBLESHOOTING_CN.md
  https://github.com/Kriswd/Fdesign/blob/main/docs/TROUBLESHOOTING_CN.md

也新开了两个可参与任务：

• Good first issue: add minimal PSD template walkthrough #9 最小 PSD 模板制作教程
• 排障样例征集：Photoshop 导出失败的净化复现 #10 Photoshop 导出失败排障样例收集

反馈前仍然请先净化信息，不要上传私有 PSD、真实商品图、账号信息、token、后台截图、授权不清的素材或未净化字段。

[Kriswd]

更新：最小 PSD 模板教程第一版已加入公开 demo-kit，第一次试跑可以按它从零做一个本机测试模板，再接入真实模板：

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

教程覆盖 title / sku / color_no / subtitle / hero_image 的变量命名，以及 sample-products.csv / field-map.example.json 的绑定关系。

新拆了一个后续贡献任务：#11 给教程补截图或 GIF。继续请大家不要上传私有 PSD、真实商品图、账号信息、token、后台截图、授权不清的素材或未净化字段。

[Kriswd]

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

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

它把入口分成看演示、本地试跑、理解字段绑定、查看案例、排障反馈和参与改进几类，后续首批反馈可以优先从这里分流。

[Kriswd]

更新：现在中文首次试跑入口已经补上 30 秒净化反馈模板，适合从社区、文章或朋友转发进来的用户直接复制填写：

• 中文上手入口：https://github.com/Kriswd/Fdesign/blob/main/docs/START_HERE_CN.md
• 中文快速试跑：https://github.com/Kriswd/Fdesign/blob/main/docs/QUICKSTART_CN.md
• 国内访问与试跑减阻：https://github.com/Kriswd/Fdesign/blob/main/docs/CHINA_ACCESS_CN.md

最短反馈建议包含：来源、想跑的流程、卡住步骤、Windows/Node.js/Photoshop 版本、净化后的 PSD 结构、净化后的 Excel 字段、净化后的图片命名、5-20 行报错摘要、期望导出格式。

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

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