主题
常见问题 FAQ
这个页面能做什么：汇总日常运营中最常遇到的问题和排查方法。遇到问题先按主题在这里找，按步骤逐项排查；标注了"找技术"的条目属于服务器环境或代码问题，运营人员确认现象后转给技术人员即可。
地图与底图
打开 H5 地图一片空白，什么都看不到？
最常见的原因是天地图 Key 没填或填错。排查步骤：
- 进入「智慧导览 → 导览设置 → 地图设置」。
- 查看「基础信息」里的天地图 Key 是否为空。
- 为空则粘贴正确的 Key 后点「保存设置」，手机刷新 H5 验证。
- Key 已填但仍空白：Key 可能失效或当日配额用完，联系技术人员到天地图官网控制台检查。
自定义地图（手绘图）切图一直转圈？
手绘图上传后需要服务器进行瓦片切图计算，一直转圈通常是服务器切图环境异常，运营侧无法自行修复：
- 先在 自定义地图（手绘图切图） 页面刷新，确认状态是否真的卡住（大图片切图需要几分钟，属正常）。
- 超过 10 分钟仍无进展，把地图名称和上传时间报给技术人员，由其在服务器上检查切图服务（tilecutter / PHP GD 环境）和任务日志。
全景场景打不开、一直加载？
全景图同样需要服务器切片处理后才能浏览：
- 在 全景场景 确认该场景是否已上传全景原图、状态是否正常。
- 刚上传的场景切片需要等待，稍候再试。
- 长时间不可用：全景切片依赖服务器上的 Python 切片环境，属部署问题，找技术排查。
游客端（H5）整个打不开？
H5 是独立部署的网页，地址一般为 https://你的域名/guide-map/：
- 先确认访问地址正确（以技术人员部署后给你的地址为准）。
- 换一部手机或换网络（4G/5G 与 Wi-Fi 互换）再试，排除本机网络问题。
- 所有人都打不开：通常是服务器上缺少 H5 构建产物或 Web 服务异常。H5 需要先构建再部署到服务器的
server/public/guide-map/目录，联系技术人员检查部署是否完整。
标记点（POI）
新增的标记点在 H5 上看不到？
按顺序排查：
- 打开 标记点列表，找到该标记点，看「显示」列的开关是否打开（is_show）。误关的话打开即可。
- 检查它的类型、分组的「状态」是否为启用——标记点类型、标记点分组 被禁用后，其下的点也不会在 H5 展示。
- 检查坐标是否填对了：经度纬度填反、填成 0，点会"跑到"地图外。编辑该点重新拾取坐标。
- 都正常后让游客刷新 H5 再看。
分类「景区」是干什么用的？
「景区」是一个特殊用途的标记点类型，不是普通分类：
- 地图设置 里的「主景区」下拉框，选项只来自类型为「景区」的标记点；
- 选中的主景区标记点的内容（名称、简介等）会展示在 H5 导览首页。
所以每个景区只需建一个「景区」类型的标记点，并在地图设置里把它选为主景区。
分组和类型有什么区别？
两者都是对标记点的归类，但用途不同：
- 类型（标记点类型）：决定这个点"是什么"（景点/厕所/停车场/餐饮……），H5 按类型筛选、用不同类型图标展示。
- 分组（标记点分组）：决定这个点"归哪一组"展示，分组带颜色和图标，主要用于 H5 的分组筛选与聚合展示。
一个标记点同时属于一个类型和一个分组，两者互不影响。
删除的标记点去哪了？能找回吗？
标记点删除是软删除，不会真正消失：
- 打开 标记点列表，点击右上「回收站」按钮进入回收站视图。
- 找到误删的标记点，点「恢复」，确认后回到正常列表。
- 点「返回列表」回到正常视图。
注意
回收站里的恢复是找回误删标记点的唯一途径。若回收站中也找不到，说明数据已被彻底清除，只能重新录入。
默认分组、内置图层为什么不能删除？
这是系统的保护机制，防止误删导致 H5 异常：
- 默认分组：新建标记点未指定分组时的兜底归属，删除它会报"默认分组不可删除"。可以改名、改图标，但不能删。
- 内置图层（天地图矢量/影像/标注）：H5 底图的基础，删除会报"内置图层不可删除"。不想要某种底图效果，正确做法是在 系统地图 里关闭启用开关，而不是删除。
音频与翻译
点「生成音频」失败，怎么办？
语音合成依赖服务器上的阿里云配置，排查步骤：
- 进入「智慧导览 → 导览设置 → 语音合成（TTS）」，确认六种语言的音色都不为空（留空会保存失败，但不至于生成失败）。
- 确认该语言下讲解文字不为空——没有文字无法合成。
- 以上都正常仍失败：大概率是阿里云语音凭据未配置或失效，或服务器缺少 ffmpeg/ffprobe。这两样都在服务器
.env和系统环境里，找技术检查ALIYUN_ACCESS_KEY_ID等三项凭据和 ffmpeg 安装情况。
点「一键翻译全部 / 从中文翻译」报错？
机器翻译走的是百度翻译接口，凭据配置在服务器 .env：
- 先确认中文内容已填写——中文为空时系统会提示"中文内容为空，无法翻译"。
- 偶发失败可隔几秒重试（翻译接口有频率限制）。
- 每次都失败：找技术检查
.env里的BAIDU_TRANSLATE_APP_ID和BAIDU_TRANSLATE_KEY是否配置、百度翻译账号额度是否用完。
天气预报不显示？
按以下三步排查：
- 查入口：功能菜单设置 里「天气预报」菜单项是不是被隐藏了（眼睛图标为灰色）。
- 查坐标：「景区服务 → 天气预报」里的天气信息坐标是否已填（可拾取）。没坐标就不知道该报哪里的天气。
- 查凭据：天气数据来自和风天气，凭据在服务器
.env的[QWEATHER]段，未配置或失效时取不到数据，找技术处理。
界面与菜单
菜单/风格改了，H5 上怎么没变？
- 先确认点了页面底部的「保存」——所有设置页都是保存后才生效。
- 让游客彻底关掉 H5 页面重新打开（微信里可退出后重新扫码），排除页面缓存。
- 还不行：自己手机浏览器打开 H5 地址验证，若新打开的页面已是新效果，说明就是游客手机缓存问题，刷新即可。
底部菜单为什么不能少于 3 个？
这是产品设计约束：底部导航栏是游客使用导览的主通道，少于 3 个会导致布局失衡、核心功能（地图、景点、路线）放不下。系统会在隐藏到只剩 3 个可见项时阻止继续隐藏并提示"底部菜单至少保留3个可见项"。想精简时，优先隐藏"美食美宿、服务热线"这类使用频率低的项。
怎么改 H5 页面上显示的景区名字（浏览器标题）？
- 进入「智慧导览 → 导览设置 → 地图设置」。
- 修改「基础信息」中的「地图标题」，填入想要的名称。
- 点「保存设置」，游客刷新 H5 后，浏览器标签页标题（微信内顶部标题）即更新为新名称。
账号与其他
忘记管理员密码，登不上后台？
管理后台没有自助找回密码功能：
- 先问其他管理员账号能否登录——可以由其他管理员在系统用户管理中帮你重置密码。
- 没有其他管理员可用：只能找技术人员直接在服务器数据库中重置，无法自行解决。
AI 助手答非所问或干脆不回复？
- 进入「智慧导览 → 导览设置 → AI 配置」，确认有一条且只有一条配置处于启用状态。
- 确认该配置的 API Key 未过期、对应平台账户有余额——欠费时 AI 会完全不回复。
- 答非所问：编辑启用中的配置，把「系统提示词」改写得更具体（写明景区名称、景点范围、回答口径），并把「温度参数」调低到 0.5 左右再观察。