docs(user-manual): add product user manual aligned to live code

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>

user-manual/12-常见问题.md

@@ -0,0 +1,172 @@
+# 常见问题
+
+按场景归类的故障排查。每条 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）+ 控制台事件流截图（如果是发布/采集类问题）
+
+## 十、文档反馈
+
+如果在使用本手册过程中发现：
+
+- 描述与控制台实际行为不一致
+- 漏掉了某个常见操作场景
+- 截图/示意图不够清晰
+
+请直接联系本租户的省心推管理员或对接运营。控制台代码会持续迭代，文档也会同步更新。