yss-project/INSTALL-DOCX.md

安装docx库 - Word文档导出功能

📦 安装步骤

1. 安装docx依赖

npm install docx

2. 验证安装

npm list docx

应该看到类似输出：

yss-project@0.0.0
└── docx@8.5.0

3. 重新编译项目

npm run build:prod

4. 部署

.\deploy.ps1

---

📚 docx库说明

版本

• 推荐版本：^8.0.0
• 当前最新：8.5.0

功能

• 创建Word文档（.docx格式）
• 支持段落、标题、表格、图片等
• 支持样式和格式化
• 支持导出为Blob或Buffer

大小

• 压缩后约：~300KB
• 使用动态导入，不影响初始加载

---

🔍 验证功能

测试步骤

1. 进入确认需求阶段
2. 上传图片并分析
3. 生成客户报告
4. 点击"导出Word文档"按钮
5. 检查下载的Word文件

预期结果

✅ 浏览器自动下载.docx文件
✅ 文件名格式：{项目}-{空间}-AI设计分析报告-{日期}.docx
✅ 用Word打开可正常查看
✅ 内容包含标题、项目信息、分析结果

---

🐛 常见问题

Q: npm install失败？

解决方案：

# 清除缓存
npm cache clean --force

# 重新安装
npm install docx

# 或使用cnpm
cnpm install docx

Q: 导出时报错"Cannot find module 'docx'"？

解决方案：

1. 确认已安装：npm list docx
2. 重新编译：npm run build:prod
3. 清除浏览器缓存

Q: Word文档打不开？

解决方案：

1. 使用Microsoft Word 2016+或WPS Office
2. 确认文件下载完整（大小>0KB）
3. 重新导出

---

📖 参考文档

• docx官方文档
• GitHub仓库
• API文档

---

创建时间: 2024-12-01