gushi/README.md

# 古诗词智能查询与解析器

基于H5技术的古诗词智能查询与解析应用，集成AI能力提供深度诗词解析、作者背景分析、文学价值评估等功能。

## 功能特性

### 1. 智能查询模块
- **多维度检索**：支持按标题、作者、朝代、关键词、诗句片段进行模糊/精确查询
- **分类浏览**：按朝代（唐、宋、元、明、清等）、题材（山水、边塞、咏物、抒情等）、作者分类展示
- **高级筛选**：支持按字数（五言、七言等）、押韵、创作年代范围筛选

### 2. AI解析核心功能
- **诗词释义**：逐句/逐词现代汉语翻译
- **意境分析**：解析诗词营造的意境、情感基调
- **修辞手法识别**：识别比喻、拟人、对仗、用典等修辞技巧
- **格律分析**：平仄分析、押韵检测、格律合规性评估
- **创作背景**：结合历史背景解析创作动机和时代意义
- **文学价值评估**：从文学史角度评价诗词的地位和影响

### 3. 交互学习功能
- **对比分析**：支持两首诗词的对比解析
- **相似推荐**：基于当前诗词推荐主题、风格相似的诗词
- **知识问答**：AI问答功能，解答关于诗词的各类问题
- **背诵助手**：提供填空测试、顺序排序等背诵辅助功能

### 4. 个性化功能
- **收藏夹**：用户可收藏喜爱的诗词
- **学习记录**：记录用户的查询和学习历史
- **难度分级**：根据用户水平推荐相应难度的诗词
- **分享功能**：生成诗词卡片分享到社交媒体

## 技术架构

### 前端技术栈
- HTML5 + CSS3 + JavaScript (ES6+)
- 响应式设计，适配移动端、平板、PC端
- PWA支持，可添加到主屏幕，支持离线访问
- Service Worker实现离线缓存
- Font Awesome图标库
- Google Fonts中文字体

### 后端技术栈
- Python Flask框架
- RESTful API设计
- 集成DeepSeek AI API
- CORS跨域支持
- JSON数据格式

### AI集成
- 使用DeepSeek Chat模型进行诗词解析
- 可配置的提示词模板
- 支持多参数定制解析（目的、场景、读者、深度、重点）

## 项目结构

```
gushi/
├── index.html              # 主页面
├── manifest.json           # PWA配置文件
├── README.md              # 项目说明
├── requirements.txt       # Python依赖
├── static/               # 静态资源
│   ├── css/
│   │   └── style.css     # 样式文件
│   ├── js/
│   │   ├── main.js       # 主JavaScript逻辑
│   │   └── service-worker.js # Service Worker
│   └── images/           # 图片资源
├── api/                  # 后端API
│   └── app.py           # Flask应用
├── templates/           # 模板文件（预留）
└── data/               # 数据文件（预留）
```

## 快速开始

### 1. 环境要求
- Python 3.8+
- Node.js (可选，用于前端开发)
- 现代浏览器（Chrome 80+, Firefox 75+, Safari 13+）

### 2. 安装依赖
```bash
# 安装Python依赖
pip install -r requirements.txt

# 或使用虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
pip install -r requirements.txt
```

### 3. 配置AI API
在 `api/app.py` 中配置你的DeepSeek API密钥：
```python
SK_API_KEY = "your-deepseek-api-key-here"
```

### 4. 启动后端服务器
```bash
cd api
python app.py
```
服务器将在 http://localhost:5000 启动

### 5. 访问前端应用
1. 直接打开 `index.html` 文件
2. 或使用Python启动HTTP服务器：
```bash
python -m http.server 8000
```
然后在浏览器中访问 http://localhost:8000

## API接口

### 基础信息
- `GET /` - API基本信息

### 诗词查询
- `GET /api/poetry` - 获取诗词列表
- `GET /api/poetry/<id>` - 获取特定诗词详情
- `GET /api/search?q=<query>` - 搜索诗词

### AI解析
- `POST /api/ai/analyze` - AI解析诗词
  ```json
  {
    "poetry_title": "静夜思",
    "author": "李白",
    "dynasty": "唐",
    "purpose": "学习理解",
    "usage": "课堂教学",
    "target_audience": "中小学生",
    "depth": "基础",
    "focus": "意境分析"
  }
  ```

## 使用示例

### 1. 基本查询
在搜索框中输入"李白"或"明月"，系统将显示相关诗词。

### 2. AI解析
1. 点击任意诗词卡片查看详情
2. 在AI解析区域设置解析参数
3. 点击"生成AI解析"按钮
4. 查看AI生成的深度解析结果

### 3. 收藏功能
在诗词详情页面点击"收藏"按钮，将诗词添加到个人收藏夹。

### 4. 分享功能
点击"分享"按钮，可以将诗词内容复制到剪贴板或通过系统分享功能分享。

## PWA功能

### 添加到主屏幕
1. 在Chrome或Edge浏览器中访问应用
2. 点击地址栏右侧的"安装"图标
3. 或通过菜单选择"添加到主屏幕"

### 离线使用
应用支持离线访问已缓存的诗词和基本功能。

## 开发说明

### 添加新诗词
在 `api/app.py` 的 `SAMPLE_POETRY_DB` 数组中添加新的诗词数据：
```python
{
    "id": 4,
    "title": "登鹳雀楼",
    "author": "王之涣",
    "dynasty": "唐",
    "content": "白日依山尽，黄河入海流。\n欲穷千里目，更上一层楼。",
    "type": "哲理",
    "word_count": "五言",
    "tags": ["登高", "哲理", "壮丽"]
}
```

### 自定义样式
修改 `static/css/style.css` 文件中的CSS变量：
```css
:root {
    --primary-color: #8b4513;      /* 主色调 */
    --secondary-color: #d2691e;    /* 次要色调 */
    --light-color: #f5f5dc;        /* 浅色背景 */
    --dark-color: #2c1810;         /* 深色背景 */
}
```

### 扩展功能
1. 添加数据库支持（SQLite/MySQL/PostgreSQL）
2. 实现用户认证系统
3. 集成更多AI模型
4. 添加诗词创作功能
5. 实现社交分享功能

## 浏览器兼容性

- ✅ Chrome 80+
- ✅ Firefox 75+
- ✅ Safari 13+
- ✅ Edge 80+
- ✅ Opera 67+

## 许可证

本项目采用 MIT 许可证。

## 贡献指南

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 联系方式

如有问题或建议，请通过以下方式联系：
- 提交 GitHub Issue
- 发送邮件至 example@example.com

## 致谢

- 感谢所有古诗词作者和研究者
- 感谢DeepSeek提供AI能力支持
- 感谢开源社区提供的各种工具和库

---

**探索千年诗词之美，AI智能解析，深度理解古诗词的意境与内涵**