Changelog & Features
Dump your mind. Start small. Track our iteration footprints and explore the complete feature map of CalmFlow v1.
This release introduces publish automation, dual-platform update detection, and critical runtime fixes.
- New Dual-Platform Auto-Updates: Windows supports silent update detection and restart-to-overwrite; macOS intelligently prompts to download the latest DMG from the browser.
- New Cloudflare R2 Publish Pipeline: integrated S3 protocol upload to Cloudflare R2 bucket, resolving Content-SHA256 signature verification errors for large files.
- New Smart Proxy & Fallback: build scripts automatically adapt to local proxy settings, seamlessly falling back to direct connection if the proxy is unavailable.
- Improve Dynamic Shortcut Modifiers: keyboard shortcut modifiers dynamically adapt to the user's OS (e.g. automatically replacing Command with Ctrl on Windows).
- Improve Settings Backup Button Alignment: fixed layout offsets between Import and Export buttons in Settings, completing localized status text.
- Fix Main Process ESM Crash Fix: resolved a fatal SyntaxError: Named export 'autoUpdater' not found on macOS DMG launch, ensuring app startup stability.
First beta release, focusing on polishing the local-first quiet workspace experience.
- New AI Engine Refactoring: integrated Vercel AI SDK supporting OpenAI, Claude, Gemini, DeepSeek, and local Ollama, featuring automatic fallback to text parsing and Mock degradation.
- New Intent Classification & Context Injection: built a 3-layer Prompt architecture to separate venting from goal decomposition, injecting real-time user metrics into the AI context.
- New Editable Proposal Dashboard: task titles, durations, priorities, and criteria are fully editable before import, protected against duplicate import race conditions.
- New Immersive FocusRoom: full-screen session UI featuring goal checklist, progress bar, audio pause synchronization, and quick capture entrance during focus.
- New 40Hz Sine Wave Synthesis: utilizes Web Audio API OscillatorNode to generate pure 40Hz audio on-the-fly with 0-byte memory caching.
- New Atmosphere Soundscapes: 5 ambient channels (Brown noise, Rain, Ocean waves, etc.) with high-frequency roll-off and flat loop fading, volume reduced by 40%.
- New Advanced Workflows: supports recurring tasks (daily/weekly/monthly), workflow template creation, duplicate detection, and visual status layer sorting.
- New AI Coach Cards & Checkout: 7 types of context-aware suggestions (capacity alert, review, etc.) and a checkout ritual after 20:00 to archive incomplete tasks.
- New macOS Native Integration: native hiddenInset title bar extension, 75% sidebar opacity vibrancy glassmorphism, menu bar dot tray icon, and global shortcut ⌘⇧Space window trigger.
- New Data Portability: integrated full local database backup export and JSON restore recovery via safe IPC handler.
- Improve Component Split: refactored Workspace.tsx (2,200+ lines) into modular views (TodayTab, WorkflowsTab, SettingsTab, etc.) to enhance UI responsiveness.
- Improve IPC Handlers Extension: restored 14 system handlers and registered 8 new controllers to prevent code truncation.
- Improve UX Polish: borderless paper-like textarea, 5s placeholder carousel, bouncing triple-dot dumper animation, and 2-second save feedback animations.
- Improve Smart Duration Recommendation: snaps timer presets to larger values on ties, and preserves user custom offset if within ±5min.
- Fix Global Error Capturing: added ErrorBoundary container with crash safety page and reload recovery triggers.
- Fix Database Safety: automatically backups .db.bak on schema migration, and runs wal_checkpoint(TRUNCATE) on exit to keep database clean.
- Fix Security Validation: applied parameter type checks for createWorkflow, createTask, and startFocus DB inputs.
- Fix Bugs & Residues: fixed · entity character display glitches and translated remaining residues to achieve 100% full Chinese/English coverage.
1. Capture & AI Decomposition
- Text input box for brain dumping (carousel placeholders, 3 guiding prompts)
- ⌘↵ hotkey for fast workflow generation
- Multi-AI Provider support (OpenAI/Claude/Gemini/DeepSeek/Tongyi/Kimi/Ollama/OpenRouter/Custom)
- Intent classification model separation (light model for intent, strong model for decomposition)
- AI decomposition to workflow + atomic tasks (with criteria, reasoning)
- Simple chatting input recognition (emotional listening → warm response + small tips)
- Editable decomposition results (title/duration/priority/criteria/reasoning, deletable tasks)
- Duplicate import prevention (already imported workflow check)
- Multiple workflow proposals imported one by one without loss
- Mock Provider fallback (experience without API Key)
- AI auto-inferred execution type (desk/learn/outdoor/quick)
- AI responses auto-matching user input language (Chinese input → Chinese output)
- AI call failure auto-fallback to Mock
- Structured Output fallback (auto-fallback to json_object for providers without json_schema support)
2. Today's Actions
- Dynamic greeting (Good morning / afternoon / evening)
- Date + consecutive focus days subtitle
- Today's todo stats (X actions · X estimated hours)
- Next Action recommendation (Priority P1 ≤ 10min first → active first → P1 → P2 → P3)
- Task list (priority, estimated duration, workflow tags)
- Cross-day task 'In Progress' flag (hover to show, reduces anxiety)
- Manual task creation (title, duration, priority, workflow, repetition, execution type)
- Task workflow association (dropdown switch)
- Task complete/incomplete toggle
- Task deletion
- AI Coach context panel (capacity alert, clarity tips, progress review, tonight's advice, start signal, workflow overflow warnings, all complete signals)
- Evening checkout ritual (after 20:00 → prompt to archive incomplete cross-day tasks)
- Inspiration cards (removed, simplified to a clean 'Dump your mind, let me organize')
- Custom focus session entrance
3. Focus Sessions
- Focus configuration panel (atmosphere, duration, pre-listen)
- 5 atmosphere scenes (Deep Work, Writing, Reading, Relax, Super Focus)
- 5 ambient sounds (Brown Noise, Rain, White Noise, Ocean Waves, 40Hz)
- Web Audio API synthesis + local MP3 loading (auto-fallback)
- 40Hz pure sine wave OscillatorNode synthesis
- Auto-recommended duration (keep original if offset ≤ 5min, prompt if exceeded)
- Full-screen FocusRoom (task name, complete criteria, timer, progress bar)
- Full-screen bottom 'Next' queue (next 3 tasks)
- Pause/Resume (synchronized audio)
- Complete flag + reflection panel (exit with esc)
- Skip current task to play next
- Fast capture in focus (quick thought capture without interrupting timer)
- Timer zero completion flash animation + success popup
- Rest mode recovery (auto-trigger when timer ends)
- Customizable short rest / long rest duration
- ESC to exit full screen
- macOS window traffic lights spacing padding
- Different behavior for 4 execution types (quick→direct complete / outdoor→direct start / desk→select atmosphere / learn→select duration)
4. Workflows
- Workflow list (title, priority, task progress, subtask preview)
- Visual status layers (active 100% → paused dashed border → completed 40% placed at bottom)
- Sorting: active → paused → completed
- Workflow detail (status switch, source thoughts, task list, add/delete tasks)
- Manual workflow creation
- Batch import from AI proposals
- Workflow templates (save/delete/one-click create)
- Duplicate workflow detection (name warning)
- Workflow deletion confirmation dialog
- Undo Toast after deleting task
5. AI Memory
- Notes CRUD (create, read, update, delete)
- Workflow association (dropdown selection)
- Save button feedback (green animation for 2s)
- Automated behavior logs (focus_end / task_skipped / task_completed)
- Behavior stats injected into UserContext (todo count, skip rate, completion rate)
- User preference KV store
6. Completion History
- Time filter (Today / This Week / This Month / All)
- Weekly review card (completed count, leftover count, one-click archive)
- Focus log timeline (intent, duration, reflection, timestamp)
- Completed workflows list
- Segment control (macOS dark theme white text style)
7. Settings
- AI Provider configuration (2-step wizard: select provider → API Key + model)
- API Key password toggle visibility
- Connection test (green/red/orange status indicators)
- One-click jump to API Key configuration if not connected
- Links to tutorials on getting API Keys for each provider
- Intent classification model separation selection
- Decomposition main model selection
- Dynamic model list update based on SDK types (including GPT-5.4 etc.)
- Save downgrade tips (failure popup + double-click lock)
- Appearance toggle (Dark / Light, follows system)
- Interface language selection (简体中文 / English)
- Custom short rest / long rest duration
- Data export backup (JSON download)
- Section headers (AI Config / Appearance & Language / Focus Timer / Data Management)
8. Sidebar
- LogoMark SVG (lowercase c + dot)
- 4 main navigations (Today / Workflows / Memory / History) + icons + badge counts
- Settings navigation (placed at bottom)
- Search box (⌘K hotkey, global search)
- Active state highlighting (left 2px green bar + light green background)
- First-use guide card
- macOS Vibrancy sidebar (frosted glass)
- hiddenInset draggable area (window dragging from brand header)
- Bottom 'Local-First' declaration
- Today stats (X done / Xm focused)
9. Global Interactions
- Keyboard shortcuts (⌘K search / ⌘N today / ⌘1-4 navigation / ↑↓ select / Esc clear)
- macOS .dmg build (Apple Silicon + Intel dual architecture)
- Windows .exe build
- Global shortcut ⌘⇧Space to show/focus window
- Tray icon + right-click context menu
- Auto dark mode sync
- ErrorBoundary global catch
- Confirmation dialog (for delete operations)
- Toast notifications + Undo
- Loading screen initial animation
- Bilingual full-page i18n
10. Architecture & Data
- SQLite local storage (local-first)
- FTS5 full-text search
- IPC security isolation (contextBridge)
- Input validation (title length, duration range)
- DB Schema versioned migrations (backward compatibility)
- Vercel AI SDK v6 integration (generateObject + generateText)
- AI call auto-downgrade (Structured Output → JSON → Mock)
- behavior_log user activity tracks
- user_preferences settings store
- 6 vitest test suites