root
ab62d666b4
Cover onboarding, workspace, article creation, brand library, media publishing, knowledge base, image library, GEO tracking, desktop client, KOL marketplace, AI points, and FAQ — sourced from actual views and i18n rather than the v1 PRD. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
6.0 KiB
6.0 KiB
常见问题
按场景归类的故障排查。每条 FAQ 都包含「现象 → 排查 → 处理」三段。
一、登录与账号
Q：登录页输入手机号/邮箱+密码后一直转圈
- 检查浏览器控制台是否有跨域或 401 报错
- 确认账号未被禁用：联系运营/管理员核对状态
- 清除浏览器 Cookie 后重试
Q：登录后没有 KOL 工作区
- KOL 工作区只对"活跃 KOL"角色显示
- 联系运营开通 KOL 资质，重新登录即可
二、品牌、关键词、问题
Q：新建品牌按钮置灰
- 顶部"品牌公司"配额已到上限
- 免费版默认 1 个、付费版默认 2 个；联系运营升级或删掉旧品牌
Q：模版向导里的"AI 分析"结果总是空
- 确认品牌"公司官网"已填，或 知识库 里已有该品牌资料
- 二者都没有时 AI 拿不到品牌上下文，是预期行为
Q：新建关键词提示"已用完"
- 总关键词数受套餐限制；删旧关键词或升级套餐
Q：单关键词加问题到不了 N 个
- 套餐对单关键词问题上限有约束；顶部进度条会显示「问题 X / Y」
三、模版与生成
Q：提交生成后任务一直 generating
Q：生成结果质量差
- 检查模版向导第 1 步是否选了品牌；没选时 AI 拿不到上下文
- 在第 1 步点 分析，确认品牌摘要、关键词、竞品都补齐了
- 在第 3 步"关键要点"里补充更具体的卖点和风格要求
Q：AI 分析按钮一直转
- 服务端在跑 LLM 调用，1~5 秒为正常；超过 30 秒未返回时刷新页面重试
- 反复失败时优先检查 AI 点数余额
四、媒体绑定与发布
Q：Web 端 /media 显示已绑定，但发布弹窗里平台不可选
- 99% 是当前桌面客户端不在线
- 打开桌面客户端 → 控制台确认连接正常
- 控制台显示"令牌过期"时重新登录客户端
Q：发布到某个平台一直失败
- 在 桌面客户端 → 发布管理 看具体错误信息
- 常见原因：
- 触发风控：到桌面客户端 → 媒体账号 → 重新授权
- 内容合规拦截：第三方平台拒收，调整正文后重发
- 网络超时：直接 再次发送
Q：发布弹窗提示"已选择需要封面的发布平台，请先上传封面图"
- 微信公众号、百家号、懂车帝等平台强制要求封面
- 点击 上传封面图 → 从素材库选或本地上传
Q：单平台支持绑定多个账号吗
- 支持。发布弹窗会让你选具体哪个账号
- AI 平台不支持多账号，每个 AI 平台只能绑定一个账号
五、数据追踪
Q：进入数据追踪页面常年空白
按以下顺序排查：
Q：某个 AI 平台始终没数据
- 桌面客户端 AI 平台 页面看该平台状态
- 状态为"授权过期 / 触发风控 / 需人工验证"时，点 重新授权 处理
Q：立即采集按钮置灰
- 把鼠标悬停在按钮上看 Tooltip 提示，会指出具体阻塞原因（参见 数据追踪 §立即采集 的对照表）
六、知识库
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 倍：
- 当前账号手机号或邮箱
- 报错时间（精确到分钟）
- 操作步骤（到了哪个页面，点了什么按钮）
- 报错截图：含 URL 栏 + 错误提示 + 浏览器 DevTools Console（如果有红色报错）
- 桌面客户端版本号（设置 → 关于 GEO）+ 控制台事件流截图（如果是发布/采集类问题）
十、文档反馈
如果在使用本手册过程中发现：
- 描述与控制台实际行为不一致
- 漏掉了某个常见操作场景
- 截图/示意图不够清晰
请直接联系本租户的省心推管理员或对接运营。控制台代码会持续迭代，文档也会同步更新。