Files

173 lines
6.0 KiB
Markdown
Raw Permalink Normal View History

# 常见问题
按场景归类的故障排查。每条 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 步"关键要点"里补充更具体的卖点和风格要求
**QAI 分析按钮一直转**
- 服务端在跑 LLM 调用,1~5 秒为正常;超过 30 秒未返回时刷新页面重试
- 反复失败时优先检查 AI 点数余额
## 四、媒体绑定与发布
**QWeb 端 `/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)+ 控制台事件流截图(如果是发布/采集类问题)
## 十、文档反馈
如果在使用本手册过程中发现:
- 描述与控制台实际行为不一致
- 漏掉了某个常见操作场景
- 截图/示意图不够清晰
请直接联系本租户的省心推管理员或对接运营。控制台代码会持续迭代,文档也会同步更新。