# 今析GEO品牌诊断系统使用手册 ## 1. 系统简介 今析GEO品牌诊断系统面向品牌方、市场团队、内容团队与咨询交付团队，帮助用户围绕生成式引擎优化（GEO）和 AI 搜索可见性进行诊断、复盘、对比与客户汇报输出。 当前系统已覆盖： - 品牌诊断输入 - AI 搜索诊断报告生成 - 历史记录归档与对比 - 后台模型配置与管理 - 客户汇报版导出 --- ## 2. 访问地址 - 前台诊断地址：`http://8.146.235.52/geo/` - 后台管理地址：`http://8.146.235.52/geo/admin.html` --- ## 3. 系统结构 - `index.html` - 前台品牌诊断首页 - 诊断结果页 - 分享、导出、历史记录查看 - `admin.html` - 后台管理 - 模型配置 - 历史复盘 - 客户汇报导出 - `geo-proxy.py.server` - 服务端代理 - 模型调用 - 后台接口 - 历史记录与配置存储 --- ## 4. 前台使用说明 ### 4.1 品牌诊断 进入前台后，依次填写： - 行业模板 - 品牌名称 - 产品 / 服务线 - 竞品品牌（可留空自动识别） 点击 `开始诊断` 后，系统将基于当前配置的模型进行分析。 ### 4.2 结果页说明 诊断完成后，结果页支持以下两种查看方式： - `客户简版` - 更适合快速汇报 - 内容更聚焦核心结论、关键风险和优先动作 - `专业版` - 更适合内部分析与完整交付 - 展示完整图表、评分、趋势、平台表现、建议和信源策略 ### 4.3 前台支持功能 - 分享报告 - 生成二维码 - 导出图片 - 导出 PDF - 查看历史记录 --- ## 5. 后台使用说明 ### 5.1 后台主要模块 后台当前包含以下模块： - 模型配置 - 题库模板 - 评分权重 - 历史记录 - 错误日志 - 安全设置 ### 5.2 模型配置 可在后台进行： - 模型启停 - API Key 配置 - Provider 切换管理 当前重点接入模型包括： - DeepSeek - 豆包 - 其他兼容模型 ### 5.3 历史记录与复盘 后台支持： - 查看历史诊断记录 - 按品牌筛选 - 图表化对比 - 查看详情 - 生成阶段性复盘报告 ### 5.4 客户汇报版导出 后台支持导出客户汇报材料，并可配置： - 客户名称 - 封面副标题 - 汇报主题 - 客户 Logo 当前可导出内容包括： - 预览 PNG - 客户汇报 PDF - 一键导出汇报包 --- ## 6. 客户汇报版当前页面结构 客户汇报版已支持以下内容页： - 封面页 - 诊断趋势总览 - 季度 / 年度 KPI 总结页 - 下阶段投放与内容排期页 - 品牌问题 - 原因 - 动作页 - 竞品对比结论页 - 管理层摘要 - 月度复盘摘要 - 季度复盘摘要 --- ## 7. 推荐使用方式 ### 7.1 面向客户演示 推荐使用： - 前台 `客户简版` - 后台 `导出客户汇报版` ### 7.2 面向内部分析 推荐使用： - 前台 `专业版` - 后台历史对比与复盘模块 ### 7.3 面向正式交付 推荐使用： - 后台 `一键导出汇报包` 导出包当前包含： - 客户汇报版 PNG - 客户汇报版 PDF - 导出清单 JSON --- ## 8. 部署说明 当前线上部署目录为 `/geo`，不会影响服务器根站点 `/`。 ### 8.1 前后台页面部署 ```bash scp "/Users/zhaoxiaobo/geo-brand-diagnosis/index.html" "root@8.146.235.52:/var/www/geo/index.html" scp "/Users/zhaoxiaobo/geo-brand-diagnosis/admin.html" "root@8.146.235.52:/var/www/geo/admin.html" ``` ### 8.2 服务端部署 如需更新服务端逻辑，应单独部署： - `geo-proxy.py.server` 并仅重启 GEO 相关服务，避免影响其他站点。 --- ## 9. 常见问题 ### 9.1 点击开始诊断没反应 优先检查： - 服务端接口是否正常 - 模型是否启用 - API Key 是否已配置 ### 9.2 分享链接打开后是否需要重新输入 Key 不需要。 当前系统采用服务端存储模型 Key，分享给其他人后可直接使用。 ### 9.3 服务器出现 `setlocale` 警告是否影响使用 不影响。 该提示仅为服务器环境警告，不影响系统发布和页面运行。 ### 9.4 为什么同一品牌多次诊断结果可能不同 可能原因包括： - 不同时间的模型返回存在波动 - 平台采样内容变化 - 诊断上下文和竞品识别结果变化 当前系统已通过固定评分公式、历史记录与趋势页，尽量提高结果稳定性与可解释性。 --- ## 10. 交付建议 如果系统用于客户正式项目，建议配套交付以下内容： - 本使用手册 - 后台账号与密码 - 演示品牌样例 - 一份客户汇报版样稿 - 一份上线与回滚说明 --- ## 11. 当前本地项目目录 项目目录： - `/Users/zhaoxiaobo/geo-brand-diagnosis` 核心文件： - `/Users/zhaoxiaobo/geo-brand-diagnosis/index.html` - `/Users/zhaoxiaobo/geo-brand-diagnosis/admin.html` - `/Users/zhaoxiaobo/geo-brand-diagnosis/geo-proxy.py.server` - `/Users/zhaoxiaobo/geo-brand-diagnosis/DELIVERY_GUIDE.md`