AgentNotesMD3 是一款基于 Material Design 3 设计语言的 Android 笔记应用，融合了 AI 智能助手与长期记忆系统。它不仅帮助你记录灵感和待办事项，还能通过 AI 理解你的需求、自动识别待办任务，并将对话历史压缩为可持久化的记忆档案。

• 智能笔记：支持 Markdown 语法的富文本笔记
• 便签：快速记录灵感，支持多彩主题
• 待办事项：自动从笔记中提取待办，或手动创建
• 标签管理：灵活的标签分类系统
• 置顶功能：重要笔记一键置顶

• 对话交互：自然语言对话，理解上下文
• 意图识别：自动识别对话中的待办事项和情绪状态
• 笔记联动：将笔记内容作为上下文发送给 AI
• 记忆压缩：将近 7 天对话压缩为语义化记忆
• 记忆导出：导出 GZIP 格式的记忆档案

• 自动归档：定期压缩对话历史
• 语义提取：从对话中提取关键事实
• 上下文增强：AI 回复时自动引用历史记忆
• 数据导出：支持记忆档案导出备份

• 动态配色：基于系统主题的动态颜色方案
• 现代设计：遵循最新 MD3 设计规范
• 流畅动效：优雅的过渡动画和交互反馈

🚧 截图即将更新

app/src/main/java/com/miaolu/agentnotes/ ├── data/ # 数据层 │ ├── dao/ # Room DAO 接口 │ ├── entity/ # 数据实体类 │ ├── local/ # 本地数据库 │ ├── network/ # 网络请求 │ └── repository/ # 数据仓库 ├── ui/ # UI 层 │ ├── component/ # 可复用组件 │ ├── screen/ # 各功能页面 │ └── theme/ # 主题与样式 ├── MainActivity.kt # 主 Activity ├── MainViewModel.kt # 主 ViewModel └── AgentNotesApp.kt # Application 类 

• Kotlin 1.9.24 - 现代化 Android 开发语言
• Jetpack Compose - 声明式 UI 框架
• Material Design 3 - 最新的设计系统

• Room 2.6.1 - 本地数据库
• DataStore - 配置存储
• ViewModel - MVVM 架构
• Kotlin Flow - 响应式数据流

• OkHttp 4.12.0 - HTTP 客户端
• Kotlinx Serialization - JSON 序列化

• Coil 2.6.0 - 图像加载库

• Android Studio Hedgehog 或更高版本
• JDK 17+
• Android SDK 34
• Min SDK 26 (Android 8.0)

1. 克隆项目

   git clone https://github.com/your-username/AgentNotesMD3.git cd AgentNotesMD3

2. 用 Android Studio 打开

   • 打开 Android Studio
   • 选择 "Open an Existing Project"
   • 选择项目根目录

3. 等待 Gradle Sync

   • 首次编译需要下载依赖，请耐心等待

4. 运行应用

   • 连接 Android 设备或启动模拟器
   • 点击 "Run" 按钮 (绿色三角形)

在 设置 页面配置你的 AI 服务：

API 请求地址格式：{API Base URL}/v1/chat/completions

💡 提示：支持第三方 OpenAI 兼容 API（如各种中转站服务）

• OpenAI
• Azure OpenAI
• Claude (通过兼容 API)
• 国内各种中转站服务
• 任何 OpenAI 兼容的 API

1. 在笔记列表页点击 + 按钮
2. 输入标题和内容（支持 Markdown）
3. 使用底部工具栏快速插入格式
4. 点击保存按钮

AgentNotesMD3 会自动识别笔记中的待办事项：

• Checkbox 格式：- [ ] 待办事项 或 - [x] 已完成
• 自然语言：明天要完成报告（需要 AI 支持）
• 正则匹配：TODO: 某某任务

1. 切换到 Amica 标签页
2. 直接输入消息开始对话
3. 或者从笔记编辑页点击 发送给 Agent 按钮
4. 对话中提到的待办会自动识别并添加

• 压缩近 7 天记忆：将最近对话压缩为长期记忆
• 语义记忆压缩：使用 AI 提取对话中的关键事实
• 导出记忆档案：导出 .gz 文件备份

/data/data/com.miaolu.agentnotes/ ├── databases/ # Room 数据库 │ ├── app_database.db │ └── app_database.db-wal ├── datastore/ # 配置存储 └── files/ └── memory_exports/ # 记忆导出目录 └── agent_memory_yyyyMMdd_HHmmss.gz 

Android/data/com.miaolu.agentnotes/files/memory_exports/agent_memory_20240101_120000.gz 

项目包含单元测试，可在 Android Studio 中运行：

• MemoryCompressorTest - 测试压缩/解压一致性
• IntentRecognizerTest - 测试意图识别逻辑

• 多 AI 供应商管理
• 自定义主题与背景
• 笔记导出为 PDF/Markdown
• 云同步功能
• Widget 小组件
• 多语言支持

• Markdown 渲染在某些格式下显示异常
• 输入法弹出时界面布局优化
• 待办识别逻辑优化

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'feat: add some amazing feature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建 Pull Request

使用 Conventional Commits 格式：

• feat: 新功能
• fix: Bug 修复
• docs: 文档更新
• style: 代码格式调整
• refactor: 重构
• perf: 性能优化
• test: 测试相关
• chore: 构建/工具链

本项目基于 MIT License 开源。

感谢以下开源项目：

• Jetpack Compose
• Material Design 3
• Coil
• OkHttp

如有问题或建议，欢迎：

• 提交 Issue
• 发送邮件至 your-email@example.com