FAQ 故障排除：登录、支付、编辑、权限、RAG 等常见问题

一句话价值：汇总用户最常遇到的问题及解决方案，覆盖登录注册、支付退费、编辑器使用、权限门禁、RAG 配置、阅读进度等场景，帮助你快速自助解决。

常见问题分类与解决方案

登录与注册

• 手机号注册失败 → 检查验证码
• 登录后跳转异常 → 清除浏览器缓存或使用无痕模式
• 第三方登录问题 → 确保授权范围包含手机号

支付与会员

• 支付成功但未到账 → 刷新页面或等待 5 分钟；联系客服提供订单号

编辑与发布

• 文档排序错乱 → 使用拖拽或「排序」按钮；刷新后检查
• 发布后不显示 → 确认审核状态（个人花园即时，精品需人工）

权限与访问

• 受限文档看到门禁页 → 登录或购买会员/单篇
• 个人花园文集不显示 → 检查可见性设置（公开/私密/个人）

RAG 与搜索

• RAG 答案不准确 → 增加选中文集数量或换模型；提供更清晰问题
• 搜索结果为空 → 尝试语义关键词而非精确标题；使用文档片段检索
• 搜索性能问题 → 平台已优化缓存与索引，通常 < 200ms 返回

阅读进度与更新

• 进度不保存 → 检查网络

更多详细 FAQ（结构化数据建议）

Q1: 登录后跳转到错误页面怎么办？
A1: 检查 SavedRequest 是否被污染，清除浏览器 LocalStorage 或使用无痕模式。

Q2: 支付成功但会员未生效？
A2: 等待支付宝回调（通常 1-5 分钟），或手动刷新。

Q3: 上传图片配额用尽？
A3: 个人花园有每日配额，超额需等待重置或升级。

Q4: RAG 检索不到文档？
A4: 确认文集已晋升精品且已入向量索引，个人花园文集不参与 RAG。

Q5: 文档排序在刷新后恢复？
A5: 使用「保存排序」按钮。

Q6: 受限文档落地页是门禁页正常吗？
A6: 平台已优化为门禁页展示摘要。

Q7: ht-skills 自动化失败？
A7: 检查核心配置模块与 API 权限，个人花园额度是否足够。

关键词：灏天文库常见问题、支付失败怎么办、RAG 配置问题