常见排查
这页先覆盖当前最高频的三类问题。
后续你可以把更多案例持续追加到“问题收集表”。
1. 登录失败怎么办？
典型现象
- 点击“连接”后提示失败，或版本探测失败。
- 明明能打开服务端网页，但 App 仍无法登录。
先确认这 4 个关键项
- 服务器地址要填根地址：例如
https://your-memos.example.com，不要手动拼/api/...。 - 登录方式是否匹配：
密码模式用用户名+密码；Token模式用 PAT。 - API 版本是否正确：登录页需要选择服务端版本（
0.21.0~0.26.0）。 - 网络与证书：检查代理、防火墙、证书或系统时间异常。
按模式排查
Token 模式
- 支持粘贴
Bearer ...，应用会自动清理前缀和空白。 - 如果是
401，通常是 Token 无效或权限不足。 - 若出现“版本探测失败”，优先检查 API 版本选择是否正确。
密码模式
- 用户名、密码不能为空。
- 若账号密码正确但仍失败，优先检查服务端版本选择和网络连通性。
- 选
0.23.0时会跳过完整探测以减少登录等待时间，这是代码中的特殊策略。
建议处理顺序
- 先回到 安装与首次连接 对照字段重填一次。
- 把 API 版本改为你服务端实际版本再试。
- 切换一次网络（Wi-Fi / 蜂窝）再重试。
- 仍失败时，记录报错文案并加入下方“问题收集表”。
2. AI 总结提示“没有笔记可发送”怎么办？
这个提示的真实含义
AI 总结读取的是本地数据库里、在你所选时间范围内、且满足筛选条件的 Memo。
只要筛选后没有可用内容，就会出现这个提示。
最常见的 4 个原因
- 时间范围太窄（例如仅最近 7 天）。
- 关闭了“允许私人笔记”，导致
PRIVATE内容被过滤。 - 笔记正文为空（空内容会被跳过）。
- 数据尚未同步到本地库（服务端有，但本地还没有）。
逐步排查
- 把时间范围从 7 天扩大到 30 天或自定义更长范围。
- 打开“允许私人笔记”开关后重试。
- 下拉刷新/手动同步后再生成。
- 随机打开几条 Memo，确认正文不是空白。
- 再次生成前，确认 AI 设置里
API Key和API URL已填写。
3. 问题收集表（持续更新）
建议每条问题至少记录：
- 触发步骤
- 当前版本（App + Memos 服务端）
- 报错原文
- 是否可稳定复现