README_PDF_QA.md

# PDF文档问答助手

这是一个专为Hugging Face免费方案优化的PDF文档问答应用，允许用户上传PDF文档并提出问题，AI将基于文档内容提供答案。

## 🚀 功能特点

- **资源优化**：专为Hugging Face免费方案设计，适应16GB内存限制
- **智能问答**：基于上传的PDF文档内容回答用户问题
- **内容限制**：自动处理PDF前3页，每页限制600字符以节省资源
- **响应优化**：答案长度限制在150字以内，提高响应速度
- **并发支持**：启用排队机制，支持最多10人同时使用

## 🛠️ 技术实现

### 核心依赖
- `gradio`：用于构建Web界面
- `huggingface_hub`：访问Hugging Face模型推理API
- `PyPDF2`：处理PDF文档提取文本

### 模型优化策略
1. **模型选择**：优先使用适合中文的轻量级模型
   - THUDM/chatglm3-6b
   - google/gemma-2b-it
   - mistralai/Mistral-7B-Instruct-v0.2

2. **资源管理**：
   - 内容限制：仅处理PDF前3页
   - 字符限制：每页不超过600字符
   - 响应限制：回答长度不超过150字

## 📖 使用方法

1. 上传PDF文档（仅处理前3页以节省资源）
2. 在问题输入框中输入您想了解的内容
3. 点击"获取答案"按钮等待AI分析
4. 答案生成后可点击"下载答案"保存结果

## ⚠️ 注意事项

- 首次使用时模型加载可能需要几分钟时间
- 为保证响应速度，系统会自动限制处理内容的大小
- 回答长度限制在150字以内以节省计算资源
- 在Hugging Face Spaces环境中运行时，需要设置HF_TOKEN环境变量

## 🚀 部署到Hugging Face Spaces

1. 创建一个新的Gradio Space
2. 上传以下文件：
   - `pdf_qa_app.py`（主应用文件）
   - `requirements.txt`（依赖文件）
3. 在Space的Settings中添加环境变量：
   - `HF_TOKEN`：您的Hugging Face访问令牌
4. 应用会自动启动并运行

## 📄 示例使用场景

- 学术研究：快速提取论文要点
- 商业文档：分析报告关键信息
- 法律文件：查找合同条款
- 技术手册：获取操作指南

## 🔧 故障排除

如果遇到问题，请检查：
1. HF_TOKEN环境变量是否正确设置
2. 上传的PDF文件是否可读
3. 网络连接是否稳定
4. 是否超出了Hugging Face的使用限制