千夜网

千夜网 · 公网文档 · 产品手册

智游讲解（H5/小程序）

面向游客的智能导览应用：在景区底图上录入点位（POI/展品），游客拍照识别后确认目标，系统自动生成个性化讲解（LLM + TTS），并通过任务与奖励提升完成率。

功能总览

首页

  • 地图导航（POI 点位）
  • 展品/景点列表
  • 快速入口：讲解 / 识别 / 任务

AI 拍摄识别

  • 拍照识别 → 候选列表
  • 用户确认后进入讲解页
  • 识别日志与纠错回流

个性化讲解（核心）

  • 12 种讲解风格（专业/趣味/儿童等）
  • 基于用户画像的推荐
  • LLM 动态生成 + TTS 音频

任务与奖励

  • 打卡任务、学习任务
  • 积分/徽章/优惠券（可选）
  • 运营可配置任务模板

数据模型（关键实体）

  • ScenicArea：景区（边界/中心点/缩放/底图配置）
  • POI：点位（经纬度/范围/类型/标签）
  • Exhibit：展品/内容实体（可挂在 POI 上，支持 1:N）
  • ExplainStyle：风格库（12 种，code 唯一）
  • ExplainContentVersion：讲解内容版本（可追溯/可缓存）
  • RecognitionLog：识别日志（候选/确认/provider/耗时）

POI/Exhibit 数据模型与录入规范

坐标系

  • 统一使用 WGS84 坐标系（GPS 标准）
  • 经纬度精度：小数点后 6 位（约 1 米精度）
  • 示例：123.431904, 41.805716（沈阳故宫）

POI 范围

  • 点 POI：适用于单个展品、标志性地点
  • 面 POI：适用于建筑物、景区区域
  • 圆 POI：适用于需要一定覆盖范围的区域，半径建议 10-50 米

命名规范

  • POI 名称：景区名 + 区域/建筑名（如：沈阳故宫 · 大政殿）
  • Exhibit 名称：展品类别 + 名称（如：瓷器 · 青花瓷瓶）
  • 避免使用生僻字、缩写，确保游客容易理解

图片素材规范

  • POI 主图：至少 1 张，建议 3-5 张不同角度
  • Exhibit 图片：至少 2 张（正面、细节）
  • 图片格式：JPG/PNG，建议分辨率 1920x1080
  • 文件大小：单张不超过 5MB
  • 图片内容：清晰、光线充足、无遮挡

标签体系

  • POI 类型：建筑、景点、服务设施、休息区
  • Exhibit 类型：文物、艺术品、历史遗迹、自然景观
  • 主题标签：历史、文化、艺术、科技、自然
  • 难度标签：适合儿童、适合青少年、适合成人

录入流程

  1. 在总后台（RuoYi）创建景区（ScenicArea）
  2. 批量导入或手动添加 POI 点位
  3. 为每个 POI 添加关联的 Exhibit（如果有）
  4. 上传图片素材并填写详细描述
  5. 配置 POI 的讲解风格默认值
  6. 测试识别与讲解生成效果

下一步