常见问题

安装与启动

双击 GEO Agent 没反应？

1. 查看任务栏是否有 GEO Agent 图标
2. 打开日志：%LOCALAPPDATA%\GEOAgent\data\logs\agent.log
3. 手动访问 http://127.0.0.1:8765
4. 检查 8765 端口是否被占用

开发者模式启动报错？

确认已 pip install -r requirements.txt，且 Python 3.10+。.env 中 GEO_PLATFORM_BASE_URL 指向正确的 Platform 地址。

连接与登录

连接 Platform 失败？

检查项	说明
地址格式	填写管理员提供的完整 Platform 地址（含 https:// 与正确域名）
网络	浏览器能否打开同一 Platform 地址
账号	是否已在 Platform 注册并开通

收不到短信验证码？

确认 11 位大陆手机号；验证码 5 分钟有效。仍无法接收请联系管理员。

品牌诊断无法启动？

在 模型 KEY 设置 → 诊断平台 中至少配置一个平台 Key，建议优先配置豆包。详见 模型 KEY 设置。

对话与专员

专员答非所问？

尽量说清具体任务，如「为当前品牌生成发文排期」；或点击右侧 GEO 流程 面板对应步骤。

说「新建品牌」没反应？

确认已连接 Platform 并登录；检查右上角是否显示用户名。

成文与图片

正文质量不好？

1. 先完善品牌资料（主营、介绍）
2. 配置命题策略
3. 小批量试跑，调整文风

封面图 / 配图 404？

控制台出现 brands/-17/images/... 一类地址时，多为品牌从 本地临时 ID 迁移到 云端正式 ID 后，历史计划仍引用旧链接。

处理：

1. 在文砚历史中打开对应成文计划，重新选择封面图
2. 或刷新 / 重新生成计划选项
3. 重启 GEO Agent 后再试

本地图片文件通常仍在，多为链接未更新。

成文提示需要 BYOK / Key 未配置？

见 模型 KEY 设置，在左下角 模型 KEY 设置 中启用并测试连接。

云桥发文

预检不通过？

按阻塞项提示逐项处理：补品牌资料、绑定发文账号、确认 Skill 已安装、检查文章与账号匹配。

点「暂停」后浏览器还在弹？

• 暂停 只影响守护进程 自动扫描
• 若手动点了「开始自动发文」，仍会执行一轮
• 修改配置后需 重启 Agent

发文失败？

常见原因：账号密码错误、平台页面改版、触发平台风控。查看 Agent 日志，降低每日上限后重试。

发文账号存在哪？安全吗？

见 发文账号管理：凭证仅存本机，不上传 Platform；换电脑需重新录入。

预检和发文的区别？

预检不打开浏览器；只有有待发任务且触发自动/手动发文时才启动 Chrome。

数据与同步

本机数据在哪？

• 安装包：%LOCALAPPDATA%\GEOAgent\data\
• 开发模式：GEOAgent/.data/

换电脑怎么办？

重新安装 Agent、登录 Platform、录入发文账号。本机品牌草稿需通过「备份品牌到云端」同步到 Platform。

Agent 和 Platform 后台是什么关系？

• Agent：本机执行、成文、排期、自有账号发文
• Platform：账号授权、权威资料、技能下发、后台质检与队列（若使用）

两者配合，但 操作入口不同。本手册只覆盖 Agent 侧。

手册与帮助

本手册需要登录吗？

不需要。/agent-guide 与 /system-guide/agent.html 均可公开访问。

Platform 后台手册在哪？

登录云擎星河后台后，左侧栏 使用手册 为 Platform 操作说明，与本文档分开。

技能市场装不上扩展包？

见 技能市场：确认已登录 Platform、License 有效，且 Platform 后台技能状态为「已发布」。

仍无法解决？

联系系统管理员或区域代理商，并提供：

• 操作步骤与时间点
• Agent 日志片段（agent.log）
• 截图或控制台报错信息