常见排查
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。
只要筛选后没有可用内容，或者当前没有可用的 Chat 模型，就会导致这次分析不能正常开始。
最常见的原因
- 时间范围太窄。
- 当前没有勾选需要的可见性（公开 / 私密 / 受保护）。
- 笔记正文为空，空内容会被跳过。
- 数据尚未同步到本地库。
- AI 设置里没有可用的
Chat模型。 - 你在用“自定义模板”卡，但标题 / 简介 / 提示词还没配完整。
逐步排查
- 把时间范围从最近 3 天 / 7 天扩大到 30 天或自定义更长范围。
- 勾选需要的可见性范围，而不只是检查私密开关。
- 下拉刷新 / 手动同步后再生成。
- 随机打开几条 Memo，确认正文不是空白。
- 打开 AI 设置，确认至少有一个可用的
Chat模型。 - 如果已经能运行但质量偏弱，再补
Embedding模型。 - 如果使用自定义模板，确认标题、简介和提示词都已保存。
如果是超时、网络错误或连接失败
优先检查：
Base URL是否可访问；API Key是否正确；- 模型名是否匹配；
- 是否缺少网关要求的
Extra Headers； - 是否存在证书 / 代理 / 本地网络访问问题。
3. 问题收集表（持续更新）
建议每条问题至少记录：
- 触发步骤
- 当前版本（App + Memos 服务端）
- 报错原文
- 是否可稳定复现