admin/gushi

Fork 0

Files

波澜壮阔 d6e0f0b591 first commit

2025-12-21 00:30:48 +08:00

6.5 KiB

Raw Blame History

古诗词智能查询与解析器

基于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. 安装依赖

# 安装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密钥：

SK_API_KEY = "your-deepseek-api-key-here"

4. 启动后端服务器

cd api
python app.py

服务器将在 http://localhost:5000 启动

5. 访问前端应用

直接打开 index.html 文件
或使用Python启动HTTP服务器：

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解析诗词

{
  "poetry_title": "静夜思",
  "author": "李白",
  "dynasty": "唐",
  "purpose": "学习理解",
  "usage": "课堂教学",
  "target_audience": "中小学生",
  "depth": "基础",
  "focus": "意境分析"
}

使用示例

1. 基本查询

在搜索框中输入"李白"或"明月"，系统将显示相关诗词。

2. AI解析

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

3. 收藏功能

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

4. 分享功能

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

PWA功能

添加到主屏幕

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

离线使用

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

开发说明

添加新诗词

在 api/app.py 的 SAMPLE_POETRY_DB 数组中添加新的诗词数据：

{
    "id": 4,
    "title": "登鹳雀楼",
    "author": "王之涣",
    "dynasty": "唐",
    "content": "白日依山尽，黄河入海流。\n欲穷千里目，更上一层楼。",
    "type": "哲理",
    "word_count": "五言",
    "tags": ["登高", "哲理", "壮丽"]
}

自定义样式

修改 static/css/style.css 文件中的CSS变量：

:root {
    --primary-color: #8b4513;      /* 主色调 */
    --secondary-color: #d2691e;    /* 次要色调 */
    --light-color: #f5f5dc;        /* 浅色背景 */
    --dark-color: #2c1810;         /* 深色背景 */
}

扩展功能

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

浏览器兼容性

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

许可证

本项目采用 MIT 许可证。

贡献指南

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

联系方式

如有问题或建议，请通过以下方式联系：

提交 GitHub Issue
发送邮件至 example@example.com

致谢

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

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

6.5 KiB Raw Blame History Unescape Escape