AI 总结
AI 总结不是“把所有笔记一股脑丢给模型”，而是基于你选定范围，把本地 Memo 内容结构化提炼成可复盘结果。
1. 能力范围
- 支持时间范围：最近 7 天、最近 30 天、自定义区间。
- 支持可选附加提示词（Summary Prompt）。
- 支持快捷提示词（可新增、编辑、删除）。
- 支持“允许发送私有权限笔记”开关。
- 结果支持：
- 文本分享
- 海报分享
- 保存为 Memo（默认
PRIVATE）
2. 使用前准备
在开始生成前，先确认 AI 设置已经完成：
API URL已填写。API Key已填写。Model已选择（支持内置模型列表和自定义模型）。
4.（可选）Prompt与“我的画像（User Profile）”已配置。
入口建议：
- 提示词建议
- App 内
设置 -> AI 设置 -> AI Provider / 我的画像
3. 数据筛选规则（为什么有时会提示没笔记）
AI 总结读取的是本地数据库中的 Memo，并按以下条件筛选：
- 在你选择的日期区间内。
- 若关闭“允许私有笔记”，则
PRIVATE笔记会被过滤。 - 正文为空的 Memo 会跳过。
- 总输入文本有上限（约
12000字符），超出后截断。
所以“该时间范围内没有可总结的笔记”通常不是 AI 故障，而是筛选后无可发送内容。
4. 生成流程（按代码）
- 校验
API URL/API Key。 - 组装输入：
- 时间范围说明
- 统计信息（总条数/实际纳入条数）
- 用户画像（如果已填写）
- 自定义提示词（如果已填写）
- Memo 正文内容
- 调用模型接口生成结果。
- 解析返回 JSON，提取：
insightsmoodTrendkeywords
- 进入报告页，可继续分享或保存。
5. 兼容的模型接口形态
当前实现支持两类请求风格：
- OpenAI 兼容：
/v1/chat/completions - Anthropic 兼容：
/v1/messages
系统会根据 API URL 或 Model（包含 anthropic/claude）自动切换请求格式。
若你的网关是 OpenAI 兼容实现，通常只需正确配置 API URL、API Key、Model。
6. 输出后可以做什么
分享文本报告
适合发到 IM、周报、复盘文档。
生成并分享海报
适合可视化展示阶段总结结果。
保存为 Memo
会新建一条 PRIVATE Memo，并进入同步队列。
7. 常见失败与排查
提示未配置 API
- 检查
API URL和API Key是否为空。
提示没有可总结笔记
- 放大时间范围；
- 打开“允许私有笔记”；
- 先同步再试；
- 确认正文不是空白。
返回超时或网络错误
- 检查网络连通性；
- 检查 API URL 是否可访问；
- 检查模型名是否正确；
- 检查 Key 权限与余额/配额。