|
|
# Install XcodeGen
brew install xcodegen
# Install Ollama and pull a model
brew install ollama
ollama pull llama3.2
# Clone and setup
git clone https://github.com/yourusername/mind-keeper.git
cd mind-keeper
xcodegen generate
# Build and run
open MindKeeper.xcodeprojMind Keeper requires Full Disk Access to read the system notification database:
System Settings → Privacy & Security → Full Disk Access → Add Mind Keeper
┌─────────────────────────────────────────────────────────────┐
│ NotificationMonitor (Actor) │
│ └─→ Polls ~/Library/Group Containers/.../db2/db (SQLite3) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ LLMService (Actor) │
│ ├─→ OllamaProvider (Primary) │
│ └─→ CloudLLMProvider (Fallback: OpenAI/Claude) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ PriorityEngine (Actor) │
│ └─→ Multi-factor scoring (urgency 30%, importance 25%...) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ AppState (@Observable) │
│ └─→ SwiftData persistence + UI bindings │
└─────────────────────────────────────────────────────────────┘
| Layer | Technology |
|---|---|
| Language | Swift 6 |
| UI Framework | SwiftUI (Liquid Glass) |
| Persistence | SwiftData |
| Notifications | SQLite3 |
| Local AI | Ollama |
| Cloud AI | OpenAI / Claude API |
MindKeeper/
├── App/
│ ├── MindKeeperApp.swift # App entry point (MenuBarExtra)
│ ├── AppState.swift # Observable state container
│ └── AppCoordinator.swift # Service orchestration
├── Views/
│ ├── PopoverRoot.swift # Main popover container
│ ├── CardStackView.swift # Swipeable task cards
│ ├── AddTaskView.swift # Manual task entry
│ ├── SettingsView.swift # Preferences & API keys
│ └── CleanupView.swift # Expired task management
├── Models/
│ ├── TaskItem.swift # SwiftData @Model
│ ├── NotificationRecord.swift # Parsed notification
│ └── UserMemory.swift # Learning data
├── Services/
│ ├── NotificationMonitor.swift # SQLite polling
│ ├── LLMService.swift # AI classification
│ ├── PriorityEngine.swift # Scoring algorithm
│ ├── MemoryStore.swift # User behavior learning
│ └── ExpiryManager.swift # Task lifecycle
└── Resources/
├── Info.plist
├── MindKeeper.entitlements
└── Assets.xcassets
|
|
# 安装 XcodeGen
brew install xcodegen
# 安装 Ollama 并拉取模型
brew install ollama
ollama pull llama3.2
# 克隆并设置项目
git clone https://github.com/yourusername/mind-keeper.git
cd mind-keeper
xcodegen generate
# 构建并运行
open MindKeeper.xcodeprojMind Keeper 需要完全磁盘访问权限来读取系统通知数据库：
系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加 Mind Keeper
┌─────────────────────────────────────────────────────────────┐
│ NotificationMonitor (Actor) │
│ └─→ 轮询 ~/Library/Group Containers/.../db2/db (SQLite3) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ LLMService (Actor) │
│ ├─→ OllamaProvider (主引擎) │
│ └─→ CloudLLMProvider (备用: OpenAI/Claude) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ PriorityEngine (Actor) │
│ └─→ 多因子评分 (紧急度30%, 重要性25%...) │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ AppState (@Observable) │
│ └─→ SwiftData 持久化 + UI 绑定 │
└─────────────────────────────────────────────────────────────┘
| 层级 | 技术 |
|---|---|
| 编程语言 | Swift 6 |
| UI 框架 | SwiftUI (Liquid Glass) |
| 数据持久化 | SwiftData |
| 通知读取 | SQLite3 |
| 本地 AI | Ollama |
| 云端 AI | OpenAI / Claude API |
MIT © 2025 Mind Keeper Contributors
Made with ❤️ on macOS
