diff --git a/PSD_AUTO_PREVIEW_DEPLOYMENT.md b/PSD_AUTO_PREVIEW_DEPLOYMENT.md
new file mode 100644
index 0000000..e9dfe7c
--- /dev/null
+++ b/PSD_AUTO_PREVIEW_DEPLOYMENT.md
@@ -0,0 +1,246 @@
+# PSD自动预览图生成功能 - 部署完成报告
+
+## 📅 部署信息
+- **部署日期**: 2025-10-26
+- **功能版本**: v1.0.0
+- **部署状态**: ✅ 成功
+
+---
+
+## 🎯 功能概述
+
+实现了PSD文件自动生成预览图的功能，用户上传PSD文件时无需手动上传预览图，系统将自动从PSD文件中提取并生成预览图。
+
+---
+
+## ✨ 新增功能
+
+### 1️⃣ **PSD自动预览生成**
+- 用户上传`.psd`文件时，系统自动识别并生成预览图
+- 预览图自动压缩优化（300KB以内，WebP格式）
+- 无需手动上传预览图，提升用户体验
+
+### 2️⃣ **智能文件类型检测**
+- 自动检测上传的文件是否为PSD格式
+- 根据文件类型调整验证规则
+- 非PSD文件仍需手动上传预览图
+
+### 3️⃣ **前端智能提示**
+- PSD文件上传时，预览图字段显示为"(可选)"
+- 动态提示用户：💡 PSD文件可自动生成预览图，无需手动上传
+- 实时反馈，提升用户体验
+
+---
+
+## 🔧 技术实现
+
+### 后端实现 (`app/api/materials/upload/route.ts`)
+```typescript
+// 1. 检测PSD文件
+const isPsdFile = zipFile && hasPsdExtension(zipFile.name)
+
+// 2. 如果是PSD文件且没有预览图，自动生成
+if (isPsdFile && !previewImage) {
+  // 保存临时PSD文件
+  // 调用generatePsdPreview生成预览图
+  // 压缩优化并上传到S3
+  // 清理临时文件
+}
+```
+
+### PSD处理器 (`lib/psd-processor.ts`)
+```typescript
+// 核心功能
+- generatePsdPreview(): 从PSD文件生成预览图
+- isPsdFile(): 验证文件是否为PSD格式
+- hasPsdExtension(): 检查文件扩展名
+```
+
+### 前端更新 (`components/UploadModal.tsx`)
+```typescript
+// 1. 动态标签显示
+预览图片 {zipFile?.name.toLowerCase().endsWith('.psd') ? '(可选)' : '*'}
+
+// 2. 智能验证
+if (!isPsdFile && !previewImage) {
+  setError('请上传预览图，或者上传PSD文件以自动生成预览图')
+}
+
+// 3. 友好提示
+💡 PSD文件可自动生成预览图，无需手动上传
+```
+
+---
+
+## 📦 使用的技术栈
+
+| 技术 | 版本 | 用途 |
+|------|------|------|
+| `ag-psd` | v28.4.1 | PSD文件解析 |
+| `sharp` | v0.34.4 | 图像处理和优化 |
+| Next.js | v14.2.0 | 全栈框架 |
+| TypeScript | v5.5.0 | 类型安全 |
+
+---
+
+## 🚀 部署详情
+
+### 部署流程
+1. ✅ 安装`ag-psd`依赖包
+2. ✅ 创建`lib/psd-processor.ts`处理器
+3. ✅ 更新上传API支持PSD自动预览
+4. ✅ 更新前端UI和验证逻辑
+5. ✅ 修改Dockerfile包含必要文件
+6. ✅ 部署到NAS服务器
+7. ✅ 验证功能正常运行
+
+### Docker配置更新
+```dockerfile
+# 新增：复制ag-psd包和lib目录
+COPY --from=builder --chown=nextjs:nodejs /app/node_modules/ag-psd ./node_modules/ag-psd
+COPY --from=builder --chown=nextjs:nodejs /app/lib ./lib
+```
+
+### 验证结果
+- ✅ 容器正常运行
+- ✅ ag-psd包已安装
+- ✅ lib/psd-processor.ts文件存在
+- ✅ 健康检查通过
+- ✅ API可正常访问
+
+---
+
+## 📝 使用说明
+
+### 用户操作流程
+
+#### 方式一：上传PSD文件（推荐）
+1. 打开上传素材窗口
+2. 选择或拖拽`.psd`文件到"素材文件"区域
+3. 填写产品型号、店铺、场景等信息
+4. **无需上传预览图**（系统自动生成）
+5. 点击"上传"按钮
+
+#### 方式二：传统方式
+1. 手动上传预览图
+2. 上传素材文件（ZIP/RAR等）
+3. 填写其他信息
+4. 点击"上传"按钮
+
+### 支持的PSD功能
+- ✅ 自动提取PSD合成图像
+- ✅ 自动缩放到合适尺寸（最大800px）
+- ✅ 自动压缩到300KB以内
+- ✅ 自动转换为WebP格式
+- ✅ 保留原始PSD文件供下载
+
+---
+
+## 🔍 技术细节
+
+### PSD处理流程
+```
+1. 用户上传PSD文件
+   ↓
+2. 保存为临时文件
+   ↓
+3. 使用ag-psd解析PSD
+   ↓
+4. 提取图像数据
+   ↓
+5. 使用Sharp处理
+   - 调整尺寸（800x800 fit inside）
+   - 压缩质量（90%）
+   - 转换格式（JPEG → WebP）
+   ↓
+6. 上传到S3
+   ↓
+7. 清理临时文件
+   ↓
+8. 返回预览图URL
+```
+
+### 性能优化
+- 异步处理，不阻塞主线程
+- 临时文件自动清理
+- 错误处理完善
+- 支持大文件处理（3小时超时）
+
+### 错误处理
+- PSD解析失败 → 提示用户手动上传预览图
+- 图像处理失败 → 返回详细错误信息
+- 文件损坏 → 友好的错误提示
+- 自动清理临时文件，防止磁盘占用
+
+---
+
+## 📊 部署环境
+
+### 服务器信息
+- **服务器**: NAS TrueNAS
+- **内网地址**: http://192.168.58.20:4320
+- **公网地址**: http://180.97.221.140:2320
+- **容器**: Docker Compose
+- **数据库**: PostgreSQL 5432
+
+### 容器状态
+```
+NAME                    STATUS         PORTS
+youyidian-3d-material   Up 2 minutes   0.0.0.0:4320->3000/tcp
+```
+
+---
+
+## 🎉 功能优势
+
+### 对用户的好处
+1. **操作更简单** - 上传PSD文件即可，无需额外处理
+2. **时间更节省** - 不需要手动截图或导出预览图
+3. **流程更流畅** - 一步到位，减少操作步骤
+4. **体验更好** - 智能提示和自动处理
+
+### 对系统的好处
+1. **自动化程度高** - 减少人工操作
+2. **数据一致性好** - 预览图与源文件完全匹配
+3. **存储优化** - 自动压缩，节省空间
+4. **扩展性强** - 为后续支持AI、C4D等格式打下基础
+
+---
+
+## 🔮 未来计划
+
+### 可能的扩展功能
+- [ ] 支持AI格式自动预览
+- [ ] 支持多页PSD的页面选择
+- [ ] 支持3DMAX文件缩略图提取
+- [ ] 支持C4D文件预览
+- [ ] 批量上传PSD文件
+- [ ] PSD图层信息展示
+
+### 性能优化
+- [ ] 使用队列异步处理大文件
+- [ ] 添加处理进度显示
+- [ ] 缓存已处理的预览图
+- [ ] 支持增量更新
+
+---
+
+## 📞 联系支持
+
+如有任何问题或建议，请联系开发团队。
+
+---
+
+## 📄 相关文档
+
+- `lib/psd-processor.ts` - PSD处理器实现
+- `app/api/materials/upload/route.ts` - 上传API实现
+- `components/UploadModal.tsx` - 前端上传组件
+- `Dockerfile` - Docker配置
+
+---
+
+**部署完成时间**: 2025-10-26 16:07
+**部署人员**: AI Assistant
+**版本**: v1.0.0
+