使用说明、部署信息、导出规范与交付建议

1. 系统简介

今析GEO品牌诊断系统用于品牌在生成式引擎优化（GEO）与 AI 搜索场景下的可见性诊断、历史复盘、竞品对比与客户汇报输出。

2. 访问地址

• 前台诊断地址：http://diagnosis.giomou.com/
• 后台管理地址：http://diagnosis.giomou.com/admin.html

3. 系统结构

• index.html：前台品牌诊断首页、结果页、分享、导出与历史记录。
• admin.html：后台模型配置、题库模板、评分权重、历史记录、客户经营看板、复盘与客户汇报导出。
• geo-proxy.py.server：模型代理、配置管理、历史记录接口与后台服务逻辑。

4. 前台使用说明

• 进入前台后，依次填写：行业模板、品牌名称、产品 / 服务线、竞品品牌。
• 竞品品牌可留空，由系统自动识别。
• 点击“开始诊断”后，系统会调用服务端已配置模型生成诊断报告。
• 结果页支持“客户简版 / 专业版”双视图切换。
• 支持分享二维码、导出图片、导出 PDF、分享海报与历史记录查看。

5. 后台使用说明

• 后台模块包括：模型配置、题库模板、评分权重、历史记录、错误日志、安全设置。
• 支持模型启停、API Key 配置、行业模板管理与评分公式权重调整。
• 支持查看品牌历史诊断、图表对比、智能结论卡与阶段性复盘报告。
• 支持客户级总览驾驶舱、经营健康度、异常预警、待复测任务与阶段目标完成度展示。
• 支持配置客户名称、封面副标题、汇报主题、Logo，并导出客户汇报材料、客户级总复盘与管理周报。

6. 客户汇报版页面结构

7. 推荐使用方式

• 客户演示：推荐使用前台“客户简版”与后台“导出客户汇报版”。
• 内部分析：推荐使用前台“专业版”与后台历史记录 / 图表对比能力。
• 正式交付：推荐后台“一键导出汇报包”与“导出管理周报”组合使用。

8. 部署说明

• 当前线上部署目录为 /geo，不会影响服务器根站点 /。
• 前后台页面更新时，仅覆盖 /var/www/geo/index.html 与 /var/www/geo/admin.html。
• 如需更新服务端逻辑，应单独部署 geo-proxy.py.server 并仅重启 GEO 服务。

9. 常见问题

• 点击开始诊断没反应：优先检查服务端接口、模型启用状态与 API Key 配置。
• 分享链接是否需要重新输入 Key：不需要，当前采用服务端存储 Key。
• 服务器出现 setlocale 警告是否影响使用：不影响，仅为环境提示。
• 同一品牌多次诊断结果可能存在波动：与模型输出、平台采样与竞品识别变化有关。

10. 交付建议

• 建议同时交付：本手册、后台账号、演示品牌样例、客户汇报版样稿与上线回滚说明。
• 建议内部保留：本地项目目录、服务端部署脚本与历史导出样本。

11. 上线检查清单

• 前台首页是否可正常输入品牌、产品与竞品，并成功发起诊断。
• 结果页是否可正常展示客户简版 / 专业版、分享弹层、分享海报、导出图片与导出 PDF。
• 后台模型配置是否正常读取，已启用模型是否能稳定返回结果。
• 后台客户管理页是否正常展示客户级总览驾驶舱、经营健康度、图表化看板与异常提醒。
• 历史记录页是否可正常筛选、对比、查看智能结论卡与阶段复盘。
• 客户周报、管理周报、客户汇报版、客户级总复盘等导出链路是否可正常生成。
• 移动端 / H5 下首页输入、结果页底部工具区、分享弹层是否换行正常且无遮挡。
• 如需发布线上文件，优先备份 /var/www/geo/index.html 与 /var/www/geo/admin.html，再覆盖更新。