# history_map **Repository Path**: undoom/history_map ## Basic Information - **Project Name**: history_map - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-12-19 - **Last Updated**: 2025-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🕰️ 墨染山河 - 智能历史地图探索平台 > 一个基于高德地图和AI技术的历史文化探索平台，让用户通过现代地图坐标穿越时空，体验历史的魅力。 ## 🌟 项目亮点 **"此时此刻，脚下曾发生过什么？"** - 这是墨染山河想要回答的核心问题。 通过AI技术将冰冷的经纬度转化为有温度的史诗叙事，让每一个地理坐标都成为通往历史的时空之门。 ## 🎯 核心功能 ### 🗺️ 智能POI识别与历史探索 - **智能POI识别**：支持34个中国主要城市自动识别，精准定位具体地点 - **多策略搜索**：三阶搜索机制，搜索半径扩展至1000米，确保找到相关地标 - **具体历史内容**：根据点击的具体位置（如故宫、天安门、颐和园）生成准确的历史信息 - **四大历史主题**：大唐盛世、宋韵清雅、明清风华、民国风云 - **多维度感官体验**：视觉、听觉、嗅觉的全方位历史重现 ### 🤖 增强AI历史对话 - **专业历史学者AI助手**：基于Qwen3-VL-32B-Instruct模型，提供更精准的历史回答 - **地点感知对话**：根据用户当前位置提供相关的历史知识 - **智能识别**：自动识别历史事件、人物、朝代 - **地理位置关联**：自动定位相关地理位置，一键跳转到地图 - **渐进式加载**：800ms超时后备内容，确保响应速度 ### ⏰ 历史时间轴 - 七大历史时期滑动切换 - 从夏商周到明清民国的完整时间跨度 - 时间轴与地图探索主题联动 ### ⭐ 个人收藏夹 - 一键收藏感兴趣的历史地点 - 本地存储，快速访问收藏内容 - 记录探索足迹和历史发现 ### 📊 探索统计 - 探索次数、对话次数、收藏数量统计 - 访问城市记录，见证探索历程 - 数据可视化展示用户活跃度 ### 🎓 历史知识问答 - AI自动生成历史知识问答题 - 涵盖政治、文化、军事、科技等多个领域 - 寓教于乐，在游戏中学习历史 - 即时反馈和成绩评定系统 ### 🎪 交互体验优化 - **涟漪点击效果**：地图点击时的水波纹动画 - **打字机效果**：AI回复逐字显示，增强真实感 - **智能提示**：输入框抖动、成功提示等反馈 - **流畅切换**：面板滑入滑出动画 - **数字动画**：统计数据滚动显示 - **悬浮效果**：按钮3D悬浮和旋转动画 - **智能地标识别**：优先识别著名景点（故宫、天安门、颐和园等） - **缓存优化**：搜索结果智能缓存，提升响应速度 ## 🎨 界面特色 - **古典设计风格**：采用暖色调配色，营造历史韵味 - **中文字体优化**：使用思源宋体，增强文化气息 - **毛玻璃效果**：现代UI设计与古典元素完美融合 - **流畅动画**：丰富的交互动画，提升用户体验 - **新颖控件样式**： - 🎯 3D悬浮按钮，带涟漪点击效果 - 💬 打字机效果的AI回复 - 🌊 地图点击涟漪动画 - 📱 滑入式面板切换 - 🎨 渐变光泽按钮效果 - 📊 数字滚动动画 - 🎭 消息气泡尾巴效果 ## 🛠️ 技术架构 ### 前端技术 - **高德地图API**：地图服务和地理编码 - **原生JavaScript**：轻量高效，无框架依赖 - **CSS3动画**：丰富的视觉效果 - **LocalStorage**：本地数据持久化 ### 后端技术 - **Flask**：Python Web框架 - **Qwen3-VL-32B-Instruct**：先进AI语言模型 - **智能提示工程**：针对历史内容优化的AI提示 - **MySQL**：数据库存储 - **Nginx**：Web服务器和反向代理 ### AI能力 - **精准历史场景生成**：根据具体地理位置生成详细历史场景描述 - **地点感知对话**：理解用户问题并结合地理位置提供专业回答 - **智能POI识别**：识别历史事件相关的具体地理位置和地标 - **问答生成**：自动生成历史知识问答题 - **多语言处理**：支持古代地名、官职、历史术语的准确理解 ## 🚀 快速开始 ### 在线体验 - **主应用**：http://map.hyk52syx.club - **功能演示**：http://map.hyk52syx.club/demo - **历史问答**：http://map.hyk52syx.club/quiz ### 本地部署 1. **项目完整性检查** ```bash python3 check_project.py ``` 2. **一键部署** ```bash chmod +x deploy.sh sudo ./deploy.sh ``` 3. **访问应用** ``` http://map.hyk52syx.club ``` 详细部署说明请参考 [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) ## 📁 项目结构 ``` /home/ubuntu/history_map/ ├── index.html # 主应用页面（核心） ├── server.py # Flask后端服务器（AI集成） ├── poi_recognition_test.html # POI识别功能测试页面 ├── ai_history_test.html # AI历史内容生成测试 ├── verify_poi.html # POI功能验证页面 ├── requirements.txt # Python依赖包 ├── deploy.sh # 一键部署脚本 ├── nginx.conf # Nginx服务器配置 ├── README.md # 项目说明文档 ├── PROJECT_SUMMARY.md # 项目功能概览 ├── DEPLOYMENT_GUIDE.md # 详细部署指南 └── check_project.py # 项目完整性检查工具 ``` ### 核心文件说明 - **index.html**: 完整的墨染山河应用，包含智能POI识别、地图交互、AI历史内容生成 - **server.py**: 后端AI服务，集成Qwen3-VL-32B-Instruct模型，提供历史内容API - **测试页面**: 多个专门的测试页面用于验证各项功能的正确性 ## 🎮 使用示例 ### 智能历史地图探索 1. 打开主页面，加载智能地图 2. 点击任意位置，系统自动识别附近的POI和城市 3. AI根据具体位置生成精准的历史场景描述 4. 选择不同历史时期主题，体验时空变迁 5. 点击收藏按钮保存感兴趣的地点 ### POI识别功能 - **34个主要城市**：北京、上海、广州、深圳、成都、杭州等自动识别 - **著名地标优先**：故宫、天安门、颐和园等地标优先识别 - **智能地名生成**：超出城市范围时生成合理的区域名称 - **详细地址信息**：提供省份、城市、区县等完整行政区划 ### AI历史对话 1. 点击右上角💬按钮打开对话面板（带滑入动画） 2. 输入历史问题，如："告诉我关于玄奘西行的故事" 3. 观看AI打字机效果的回复过程 4. 点击位置建议自动跳转到地图对应位置（带涟漪效果） ### 历史知识问答 1. 访问 `/quiz` 页面 2. 点击"开始问答"按钮 3. AI自动生成10道历史题目 4. 选择答案，查看正确与否 5. 完成后查看最终得分和评价 ## 🔧 配置信息 ### API配置 - **高德地图API**: 集成地图服务、地理编码、POI搜索功能 - **AI模型**: Qwen3-VL-32B-Instruct (通过 /maas/qwen/Qwen3-VL-32B-Instruct 接入) - **AI参数优化**: 温度0.7，最大token 2000，针对历史内容生成优化 ### 数据库配置 - **Host**: 115.159.67.238 - **Port**: 3306 - **Database**: map - **User**: root - **Password**: huyunkai ### 服务器配置 - **域名**: map.hyk52syx.club - **服务器**: 122.152.231.209 ## 📚 文档说明 - [FEATURES.md](FEATURES.md) - 详细功能说明 - [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) - 部署指南 - [historical_events.json](historical_events.json) - 历史事件数据库 ## 🎯 使用场景 ### 教育学习 - 历史教师课堂演示工具 - 学生自主学习历史知识 - 历史爱好者深度探索研究 - 亲子历史文化教育 ### 旅游规划 - 了解旅游目的地历史文化 - 规划历史文化主题旅游路线 - 探索城市历史变迁轨迹 - 发现附近历史古迹景点 ### 文化传播 - 传播中华优秀历史文化 - 增强历史文化认同感 - 激发历史学习兴趣 - 保护传承历史文化遗产 ## ✅ 最近更新 (v2.0) ### 🎯 核心功能重构 - ✅ **智能POI识别系统**：支持34个中国主要城市自动识别 - ✅ **多策略搜索机制**：三阶搜索，半径1000米，确保找到相关地标 - ✅ **具体历史内容生成**：根据具体POI生成准确历史信息 - ✅ **AI模型升级**：更换为Qwen3-VL-32B-Instruct，提升响应质量 - ✅ **渐进式加载**：800ms超时后备内容，优化用户体验 ### 🛠️ 技术改进 - ✅ **智能地标优先级**：故宫、天安门、颐和园等地标优先识别 - ✅ **缓存优化**：搜索结果智能缓存，提升响应速度 - ✅ **错误处理**：完善的降级机制和错误恢复 - ✅ **测试页面**：添加多个功能验证和测试页面 ### 📚 文档完善 - ✅ **功能说明更新**：详细描述新增的POI识别功能 - ✅ **部署指南优化**：更新部署流程和配置说明 - ✅ **项目结构重组**：清晰的文件组织和说明 ## 🚀 未来规划 - [ ] 历史人物关系图谱 - [ ] 历史事件时间线可视化 - [ ] 3D历史场景重建 - [ ] 语音讲解功能 - [ ] 多语言国际化支持 - [ ] 社交分享功能 - [ ] 用户成就系统 - [ ] 历史知识竞赛 - [ ] AR实景历史叠加 - [ ] 历史路线规划导航 ## 🤝 贡献指南 欢迎提交Issue和Pull Request来改进项目！ 1. Fork 项目 2. 创建功能分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 打开 Pull Request ## 📄 许可证 本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情 ## 📞 联系我们 如果您有任何问题或建议，欢迎通过以下方式联系： - 项目地址：http://map.hyk52syx.club - 演示页面：http://map.hyk52syx.club/demo --- **让我们一起穿越时空，探索历史的魅力！** 🕰️✨ > "历史不是过去，而是现在。历史不是死的，而是活的。" - 墨染山河 ## 🧪 测试页面 为了方便开发和测试，项目包含以下测试页面： - **poi_recognition_test.html** - POI识别功能测试 - **ai_history_test.html** - AI历史内容生成测试 - **verify_poi.html** - POI功能验证 访问测试页面可以验证各项功能是否正常工作。