# 常见问题

按场景归类的故障排查。每条 FAQ 都包含「现象 → 排查 → 处理」三段。

## 一、登录与账号

**Q：登录页输入手机号/邮箱+密码后一直转圈**

- 检查浏览器控制台是否有跨域或 401 报错
- 确认账号未被禁用：联系运营/管理员核对状态
- 清除浏览器 Cookie 后重试

**Q：登录后没有 KOL 工作区**

- KOL 工作区只对"活跃 KOL"角色显示
- 联系运营开通 KOL 资质，重新登录即可

## 二、品牌、关键词、问题

**Q：新建品牌按钮置灰**

- 顶部"品牌公司"配额已到上限
- 免费版默认 1 个、付费版默认 2 个；联系运营升级或删掉旧品牌

**Q：模版向导里的"AI 分析"结果总是空**

- 确认品牌"公司官网"已填，或 [知识库](./06-知识库.md) 里已有该品牌资料
- 二者都没有时 AI 拿不到品牌上下文，是预期行为

**Q：新建关键词提示"已用完"**

- 总关键词数受套餐限制；删旧关键词或升级套餐

**Q：单关键词加问题到不了 N 个**

- 套餐对单关键词问题上限有约束；顶部进度条会显示「问题 X / Y」

## 三、模版与生成

**Q：提交生成后任务一直 generating**

- 前端每 10 秒自动轮询。等 1~2 分钟仍无变化时：
  - 看 [AI 点数](./11-AI点数与套餐.md) 是否余额足够
  - 看 [桌面客户端](./09-桌面客户端.md) 控制台是否有任务执行失败事件
- 仍未恢复请提工单

**Q：生成结果质量差**

- 检查模版向导第 1 步是否选了品牌；没选时 AI 拿不到上下文
- 在第 1 步点 **分析**，确认品牌摘要、关键词、竞品都补齐了
- 在第 3 步"关键要点"里补充更具体的卖点和风格要求

**Q：AI 分析按钮一直转**

- 服务端在跑 LLM 调用，1~5 秒为正常；超过 30 秒未返回时刷新页面重试
- 反复失败时优先检查 AI 点数余额

## 四、媒体绑定与发布

**Q：Web 端 `/media` 显示已绑定，但发布弹窗里平台不可选**

- 99% 是当前桌面客户端不在线
- 打开桌面客户端 → 控制台确认连接正常
- 控制台显示"令牌过期"时重新登录客户端

**Q：发布到某个平台一直失败**

- 在 [桌面客户端 → 发布管理](./09-桌面客户端.md#5-发布管理) 看具体错误信息
- 常见原因：
  - **触发风控**：到桌面客户端 → 媒体账号 → 重新授权
  - **内容合规拦截**：第三方平台拒收，调整正文后重发
  - **网络超时**：直接 **再次发送**

**Q：发布弹窗提示"已选择需要封面的发布平台，请先上传封面图"**

- 微信公众号、百家号、懂车帝等平台强制要求封面
- 点击 **上传封面图** → 从素材库选或本地上传

**Q：单平台支持绑定多个账号吗**

- 支持。发布弹窗会让你选具体哪个账号
- AI 平台不支持多账号，每个 AI 平台只能绑定一个账号

## 五、数据追踪

**Q：进入数据追踪页面常年空白**

按以下顺序排查：

1. 顶部筛选有没有选 **品牌**
2. 该品牌在 [品牌词库](./04-品牌词库.md) 是否建了关键词
3. 关键词下是否建了问题
4. [桌面客户端](./09-桌面客户端.md) 是否在线（看在线客户端数）
5. 桌面客户端 **AI 平台** 页是否绑定了至少一个平台且授权正常

**Q：某个 AI 平台始终没数据**

- 桌面客户端 **AI 平台** 页面看该平台状态
- 状态为"授权过期 / 触发风控 / 需人工验证"时，点 **重新授权** 处理

**Q：立即采集按钮置灰**

- 把鼠标悬停在按钮上看 Tooltip 提示，会指出具体阻塞原因（参见 [数据追踪 §立即采集](./08-数据追踪.md#4-立即采集) 的对照表）

## 六、知识库

**Q：网站类知识一直 pending**

- 部分网站防爬严格，抓取超时
- 改用 **文本** 类型，把页面正文复制后再粘贴

**Q：上传 PDF 后失败**

- 加密 PDF 不支持
- 文档过大会被截断；建议拆成多个小文件
- 失败的条目可点击 **重试** 按钮重新进队列

**Q：删除知识条目后 AI 还在引用**

- 检索结果有缓存，下次新建任务时才会生效

## 七、桌面客户端

**Q：桌面客户端启动后控制台一直红**

- 检查网络是否能访问省心推服务端（设置 → 登录设置 里的 API 地址）
- 检查系统时间是否准确（差 5 分钟以上可能导致 token 校验失败）
- 仍然不行：诊断页 → 复制运行快照 → 反馈

**Q：客户端登录提示"令牌过期"**

- 直接退出后重新登录即可
- 频繁出现时检查是否有多设备同账号互踢

**Q：客户端任务领取失败 / 兜底拉取失败**

- 通常是消息队列瞬时抖动；客户端会自动走兜底拉取，等 30 秒一般会恢复
- 持续 5 分钟以上未恢复时联系运营

## 八、AI 点数

**Q：任务失败后点数没退回**

- 流水里对应条目状态应该变为 **已退回**
- 如果 30 分钟内仍是 **处理中**，提工单
- 如果显示 **已扣除**（极少见），把流水 ID 截图反馈

**Q：点数怎么扣那么快**

- 模版向导每一步的 AI 操作（分析、标题、大纲）都会单独扣一次
- 开了 **AI 优化**、**AI 生成 prompt** 功能后会快速消耗
- 想节流时：跳过非必要的 AI 分析（手动填写关键词与竞品也可以）

## 九、报障流程

把以下信息收集好，能让运营定位问题快 10 倍：

1. **当前账号手机号或邮箱**
2. **报错时间**（精确到分钟）
3. **操作步骤**（到了哪个页面，点了什么按钮）
4. **报错截图**：含 URL 栏 + 错误提示 + 浏览器 DevTools Console（如果有红色报错）
5. **桌面客户端版本号**（设置 → 关于 GEO）+ 控制台事件流截图（如果是发布/采集类问题）

## 十、文档反馈

如果在使用本手册过程中发现：

- 描述与控制台实际行为不一致
- 漏掉了某个常见操作场景
- 截图/示意图不够清晰

请直接联系本租户的省心推管理员或对接运营。控制台代码会持续迭代，文档也会同步更新。