From 7b3cbb232450db5eebd75450f43579f25e81dc1b Mon Sep 17 00:00:00 2001
From: AI Developer <ai@example.com>
Date: Thu, 8 Jan 2026 20:47:37 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84DeepSeek=E5=A4=A7?=
 =?UTF-8?q?=E6=A8=A1=E5=9E=8B=E9=85=8D=E7=BD=AE=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加DeepSeek大模型配置指南
- 更新README.md中的AI服务说明
- 完善致谢部分，添加DeepSeek感谢
- 创建DEEPSEEK_SETUP.md详细配置文档
---
 DEEPSEEK_SETUP.md | 157 ++++++++++++++++++++++++++++++++++++++++++++++
 README.md         |  12 +++-
 2 files changed, 167 insertions(+), 2 deletions(-)
 create mode 100644 DEEPSEEK_SETUP.md

diff --git a/DEEPSEEK_SETUP.md b/DEEPSEEK_SETUP.md
new file mode 100644
index 0000000..da79600
--- /dev/null
+++ b/DEEPSEEK_SETUP.md
@@ -0,0 +1,157 @@
+# DeepSeek大模型配置指南
+
+## 概述
+
+DeepSeek大模型是本项目的主要AI文案生成引擎，提供先进的创意文案生成能力。本指南将帮助您配置和使用DeepSeek大模型服务。
+
+## 获取API密钥
+
+### 步骤1：访问DeepSeek平台
+
+1. 访问 [DeepSeek开放平台](https://platform.deepseek.com)
+2. 注册账号并完成实名认证
+3. 进入控制台，创建新的API密钥
+
+### 步骤2：创建应用
+
+1. 在控制台中点击"创建应用"
+2. 填写应用名称（如：数据提取转换器）
+3. 选择适用的模型（推荐：DeepSeek-V3）
+4. 设置使用权限和配额
+
+### 步骤3：获取API密钥
+
+1. 在应用详情页面找到"API密钥"部分
+2. 点击"生成新密钥"
+3. 复制生成的API密钥（格式：`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）
+
+## 配置环境变量
+
+### 编辑.env文件
+
+在项目根目录下的`.env`文件中添加DeepSeek配置：
+
+```env
+# DeepSeek大模型配置（主要AI文案生成）
+DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+DEEPSEEK_BASE_URL=https://api.deepseek.com
+```
+
+### 参数说明
+
+- **DEEPSEEK_API_KEY**: 您的DeepSeek API密钥
+- **DEEPSEEK_BASE_URL**: DeepSeek API服务地址（默认值已设置）
+
+## 功能特性
+
+### 主要功能
+
+- **创意文案生成**: 基于照片内容生成多种风格的文案
+- **智能内容分析**: 自动识别照片主题和关键元素
+- **多风格支持**: 支持商务、文艺、幽默等多种文案风格
+- **长度控制**: 可生成短、中、长三种长度的文案
+
+### 模型特点
+
+- **高准确性**: 基于先进的深度学习模型
+- **快速响应**: 优化的API响应速度
+- **中文优化**: 专门针对中文内容进行优化
+- **安全可靠**: 企业级的安全保障
+
+## 使用示例
+
+### 在应用中启用DeepSeek
+
+1. 确保`.env`文件中已配置正确的API密钥
+2. 启动应用：`uv run streamlit run app.py`
+3. 在"AI照片评分"功能中点击"AI写文案"
+4. 选择文案风格和长度
+5. 系统将使用DeepSeek大模型生成创意文案
+
+### 代码调用示例
+
+```python
+from utils.deepseek_copywriter import DeepSeekCopywriter
+
+# 初始化DeepSeek客户端
+copywriter = DeepSeekCopywriter()
+
+# 生成文案
+photo_description = "一张美丽的日落照片，有橙色的天空和剪影"
+result = copywriter.generate_copywriting(
+    description=photo_description,
+    style="文艺",
+    length="中等"
+)
+
+print(result)
+```
+
+## 故障排除
+
+### 常见问题
+
+#### 1. API密钥无效
+**症状**: 返回"Invalid API key"错误
+**解决方案**: 
+- 检查API密钥格式是否正确（以`sk-`开头）
+- 确认API密钥是否已激活
+- 检查账户余额是否充足
+
+#### 2. 请求频率限制
+**症状**: 返回"Rate limit exceeded"错误
+**解决方案**:
+- 降低请求频率
+- 检查API配额和使用限制
+- 联系DeepSeek客服调整配额
+
+#### 3. 网络连接问题
+**症状**: 连接超时或网络错误
+**解决方案**:
+- 检查网络连接
+- 确认防火墙设置
+- 尝试使用代理服务器
+
+### 调试方法
+
+1. **检查配置**: 运行配置检查脚本
+   ```bash
+   uv run python -c "from utils.deepseek_copywriter import check_deepseek_config; print(check_deepseek_config())"
+   ```
+
+2. **测试连接**: 运行简单的API测试
+   ```bash
+   uv run python -c "from utils.deepseek_copywriter import DeepSeekCopywriter; c = DeepSeekCopywriter(); print(c.test_connection())"
+   ```
+
+## 成本估算
+
+DeepSeek大模型的定价基于使用量：
+
+- **输入Token**: 约 ¥0.001/千Token
+- **输出Token**: 约 ¥0.002/千Token
+- **平均成本**: 每次文案生成约 ¥0.01-0.05
+
+**建议**: 新用户可以先申请免费试用额度进行测试。
+
+## 备用方案
+
+如果DeepSeek服务不可用，系统会自动切换到阿里云DashScope作为备用方案。确保同时配置好DashScope API密钥。
+
+## 技术支持
+
+- **官方文档**: [DeepSeek API文档](https://platform.deepseek.com/api-docs)
+- **社区支持**: DeepSeek开发者社区
+- **客服联系**: 平台内嵌的在线客服
+
+## 更新日志
+
+### v1.0.0 (2025-01-08)
+- 首次集成DeepSeek大模型
+- 实现创意文案生成功能
+- 添加故障转移机制
+- 完善配置文档
+
+---
+
+**注意**: 请妥善保管您的API密钥，不要将其提交到版本控制系统。
\ No newline at end of file
diff --git a/README.md b/README.md
index 2a620eb..8c8066a 100644
--- a/README.md
+++ b/README.md
@@ -58,7 +58,8 @@
 ### AI服务集成
 - **阿里云OCR** - 业界领先的中文OCR识别能力
 - **百度智能云** - 专业的图像分析和识别服务
-- **阿里云DashScope** - 强大的AI大模型文案生成
+- **DeepSeek大模型** - 先进的创意文案生成（主要）
+- **阿里云+DashScope** - 强大的AI大模型文案生成（备用）
 
 ## 🚀 快速开始
 
@@ -92,7 +93,10 @@ ALIYUN_OCR_ENDPOINT=ocr-api.cn-hangzhou.aliyuncs.com
 BAIDU_API_KEY=your-baidu-api-key
 BAIDU_SECRET_KEY=your-baidu-secret-key
 
-# DashScope配置（AI文案生成）
+# DeepSeek大模型配置（主要AI文案生成）
+DEEPSEEK_API_KEY=your-deepseek-api-key
+
+# DashScope配置（备用AI文案生成）
 DASHSCOPE_API_KEY=your-dashscope-api-key
 ```
 
@@ -134,6 +138,9 @@ data-extractor-converter/
 ### 阿里云OCR配置
 参考: [ALIYUN_OCR_SETUP.md](docs/ALIYUN_OCR_SETUP.md)
 
+### DeepSeek大模型配置
+参考: [DEEPSEEK_SETUP.md](docs/DEEPSEEK_SETUP.md)
+
 ### 百度智能云配置
 参考: [BAIDU_AI_SETUP.md](docs/BAIDU_AI_SETUP.md)
 
@@ -203,6 +210,7 @@ uv run isort .
 ## 🙏 致谢
 
 感谢以下服务提供的AI能力支持：
+- [DeepSeek](https://www.deepseek.com/) - 先进的AI大模型文案生成服务
 - [阿里云](https://www.aliyun.com/) - OCR和AI大模型服务
 - [百度智能云](https://cloud.baidu.com/) - 图像分析服务
 - [Streamlit](https://streamlit.io/) - Web应用框架