千夜网 · 公网文档 · FAQ
智游讲解 · 常见问题
识别与讲解链路的常见问题与排错建议，包括识别、讲解生成、TTS、定位与打卡。
Q：拍照识别不出来怎么办？
- 检查网络与图片大小；尽量对焦清晰、避免强反光。
- 候选为空：记录识别日志并在后台标注为“待回流样本”。
- 候选不准：允许用户手动搜索/地图点选（后续功能）。
Q：讲解生成很慢/成本太高？
- 优先使用“基稿 + 风格化改写”，并强制缓存版本。
- 短文本先展示，TTS 异步生成；音频命中缓存优先。
- 监控：缓存命中率、单次成本、失败率。
Q：定位偏差导致打卡失败？
- POI 支持“范围”（面/圆），不要只用点。
- 弱网/室内可降级为“识别确认即打卡”。
Q：个性化讲解的风格有哪些？如何管理？
- 支持 12 种风格：专业学术、趣味科普、儿童、青少年、老年、艺术鉴赏、科技探索、考古探秘、亲子互动、故事叙述、东北文化、考试冲刺。
- 风格管理：通过总后台配置风格模板，支持版本管理和回滚。
- 版本号规则：使用语义化版本号，如 v1.0.0，便于追踪和回滚。
- 风格差异：每种风格有独特的 Prompt 模板，根据不同受众调整讲解内容和语气。
Q：用户画像如何影响讲解内容？
- 画像维度：年龄、兴趣、参观目的、地域。
- 权重设置：年龄（30%）、兴趣（25%）、目的（25%）、地域（20%）。
- 调参方法：在总后台的推荐配置中调整各维度权重。
- 规则版打分：根据用户输入的画像信息，计算每个风格的匹配分数，选择分数最高的风格。
Q：TTS 音频播放有问题怎么办？
- 音频无法播放：检查网络连接，尝试刷新页面。
- 音频卡顿：可能是网络问题，尝试切换到更稳定的网络。
- 音频质量差：检查音频缓存是否过期，尝试重新生成。
- 自动播放失败：需要用户交互后才能自动播放音频。
Q：如何确保游客端画像与日志的合规性？
- 数据收集：仅收集必要的用户画像信息，明确告知用户并获得同意。
- 存储边界：用户画像数据存储在租户隔离的数据库中，不与其他业务数据混存。
- 日志处理：识别日志和讲解日志仅用于系统优化，不包含个人身份信息。
- 数据保留：用户画像数据保留期限不超过 30 天，超过后自动匿名化处理。
- 合规检查：定期进行数据合规性检查，确保符合相关法律法规。