把日常的文字、图片等碎片记录交给 AI,实时理解、在每天零点自动生成「每日总结」,减少主动写作负担。近期已完成基础功能与部署链路,适合自部署与二次开发。
项目地址与协议
- GitHub:zhuchenyu2008/AI-Diary
- License:GPL-3.0
核心功能
- 多媒体记录:支持文字与图片,统一进入时间线。
- 实时 AI 分析:提交记录后,立即返回 AI 的理解结果,便于当场修正与追加。
- 每日总结:北京时间每天 0 点自动为前一天生成总结,可在时间线视图手动触发当日总结。
- 视图:时间线(即时记录)与历史(日记 + 每日总结,高亮展示)。
- MCP 长期记忆:内置 Model Context Protocol(MCP),自动提取/运用个人偏好、习惯、事实、情绪与经历等记忆。
- 多渠道查看:网页 UI、REST API、可选 Telegram 推送。
- 体验层:自研 Liquid Glass 设计,深浅色与跟随系统主题,移动端优先。
- 简化认证:默认 1–4 位数字密码,首次运行自动设置为
1234
(请及时修改)。
技术栈
- 前端:原生 JavaScript、HTML5、CSS3
- 后端:Flask + SQLAlchemy,调度使用 APScheduler
- 数据库:SQLite(默认本地文件)
- AI:基于 OpenAI 风格 API,可自定义模型与提示词;中文场景下已验证若干模型可用
- MCP:内置 usermcp 记忆服务,提供记忆读取/更新能力
- 部署:Docker / Docker Compose
快速开始
本地运行
# 克隆与安装
git clone https://github.com/zhuchenyu2008/AI-Diary
cd AI-Diary
python -m venv venv
source venv/bin/activate # Windows 用 venv\Scripts\activate
pip install -r requirements.txt
# 启动
python src/main.py
# 访问
# 浏览器打开 http://localhost:5000
# 默认登录密码:1234(首次登录后请在设置页修改)
Docker Compose(推荐)
# 位于项目根目录
docker-compose up -d
# 启动后服务位于 http://localhost:5000
# 数据库存放在 ./src/database
Docker 命令行
# 构建镜像
docker build -t ai-diary .
# 运行容器(持久化数据库)
docker run -d \
--name ai-diary \
-p 5000:5000 \
-v $(pwd)/src/database:/app/src/database \
ai-diary
首次配置要点
AI 设置
ai_api_url
:默认https://api.openai.com/v1
ai_api_key
:必填ai_model
:默认gpt-3.5-turbo
(可自行替换为更适合中文与多模态的可用模型)ai_prompt_template
、ai_summary_prompt
:已内置并集成 MCP 记忆,可按需调整
MCP(长期记忆)
- 默认自动配置本地 usermcp 服务器,无需额外安装。
- 分析时自动抽取可用的个人信息并分类记忆(偏好、习惯、事实、情感、经历)。
- 在设置页「MCP」标签可查看/管理这些记忆;所有数据保存在本地数据库。
Telegram(可选)
telegram_bot_token
:机器人 Tokentelegram_chat_id
:接收方 chat idtelegram_enabled
:启用与否(默认 false)
使用说明
- 登录:默认密码
1234
,建议立即修改。 - 记录:输入文字或上传图片,提交后会显示「AI 理解中…」,随后更新为分析结果。
- 查看:时间线用于当天即时记录;历史页面聚合并高亮每日总结。
- 总结:系统会在北京时间每天 0 点自动生成;也可在时间线手动触发。
API 概览
项目提供了完整的 REST API 文档,便于前后端分离或外部集成。以下为一个常用接口示例:
POST /api/diary/generate-daily-summary
# 说明:手动触发当天/前一天的每日总结,返回文本内容
# 更多接口与参数,请参考仓库中的 API_Documentation.md
FAQ(节选)
- 看不到每日总结:请切换到「历史日记」标签;每日总结仅在该视图展示且有高亮。
- 总结何时生成:默认在北京时间每天 0 点自动生成上一日的总结。
- 分析/总结失败:检查 AI 配置与 API Key 配额/余额。
- 记忆安全性:所有 MCP 记忆存储在本地数据库,可随时查看、编辑或删除。
版本更新
v4.0.1(2025-08-11):修复数据库导入问题;修正调度器状态获取;同步更新 API 文档(更正总结接口路径为 /api/diary/generate-daily-summary
等);完善认证说明(首次无密码时自动设为 1234
并使用安全哈希存储)。
适用场景
- 个人知识管理:把日常见闻、临时想法与拍照记录沉淀成可检索的结构化日记。
- 生活方式观察:让 AI 基于长期记忆给出更贴合个人偏好的总结。
- 轻量团队日志:本地部署、简易认证,满足内部「日报/周报」自动提炼需求。
二次开发建议
- 模型适配:根据成本/上下文长度/多模态能力替换模型与提示词。
- 数据层:如需并发与长期留存,替换为 MySQL/PostgreSQL 并引入迁移。
- 鉴权与审计:将数字密码替换为更完整的会话/令牌体系,补充操作审计。
- 生态集成:扩展飞书/企业微信/Obsidian/Notion 等同步或推送。
致谢
感谢开源社区与朋友们的帮助与支持;提示词工程、MCP 记忆实现与若干模型/路由服务均有参考与贡献,详见仓库「致谢名单」。
结语
AI-Diary 当前的功能已经可用于日常记录与自动化总结,后续会继续在「长期记忆」「多模态」「可自定义工作流」等方向迭代。如果你也对这类「把记录交给 AI」的应用形态感兴趣,欢迎试用、反馈与 PR。
发表回复