迭代印记与核心功能
倾听心声,始于微步。在这里,您可以直观查看 CalmFlow 的功能分布以及版本更新轨迹。
此版本实现了发布与双端更新自动化,并修复了多项系统兼容缺陷。
- 新增 双端自动更新就绪:Windows 平台支持全自动静默检测更新与重启覆盖;macOS 智能识别架构并引导至浏览器下载最新的 .dmg 安装包。
- 新增 Cloudflare R2 自动化发布:打通 S3 协议上传至 Cloudflare R2 存储桶的完整链路,解决大文件 Content-SHA256 签名校验报错。
- 新增 智能代理与直连降级:打包与发布脚本完美适配本地代理,并支持代理不可用时自动无缝降级至直连模式。
- 优化 快捷键面板动态适配:小助手快捷键修饰符根据用户操作系统动态变换(如 Windows 自动显示 Ctrl,Mac 显示 ⌘)。
- 优化 设置项备份按钮对齐:修复了设置页中“导入备份”与“导出备份”按钮的高低布局不一致问题,并补全了多语言状态文案。
- 修复 主进程 ESM 运行时崩溃修复:解决了打包后的 .dmg 运行时报 SyntaxError: Named export 'autoUpdater' not found 的致命错误,确保首发稳定性。
内测首发版本,专注打磨本地静心体验。
- 新增 AI 引擎重构:基于 Vercel AI SDK 适配 OpenAI, Claude, Gemini, DeepSeek, Ollama 等主流提供商,支持 Structured Output 自动降级与 Mock 兜底防报错。
- 新增 意图分类与行为注入:采用三层 Prompt 架构实现闲聊倾听与任务拆解的分类,并向 AI 注入真实统计的个人行为上下文。
- 新增 AI 提案可编辑面板:AI 拆解生成的标题、时长、优先级、标准和理由支持深度编辑与逐个导入,防止竞态重复导入。
- 新增 沉浸式全屏专注房 (FocusRoom):包含任务目标展示防闪烁、进度条、双声道环境音暂停同步,并支持在专注中快速 capture 灵感。
- 新增 物理正弦波 40Hz 脑波合成:通过 Web Audio API 接口实时生成纯净正弦波,0 字节缓存,比传统音频播放更轻量专注。
- 新增 环境白噪音与场景音:提供褐噪音、浪声、雨声等 5 种平滑循环声景,音量曲线高频滚降,平滑衰减 40%。
- 新增 工作流机制升级:支持重复任务(日/周/月周期)、同名工作流检测、模板一键创建,以及 active 置顶/paused 虚线/completed 置底的状态视觉分层。
- 新增 AI Coach 智能感知卡片:根据个人容量预警、清晰度、进度提供 7 种建议,并于 20:00 后触发晚间收盘归档仪式。
- 新增 macOS Native 深度适配:支持 hiddenInset 延伸标题栏、75% 毛玻璃侧栏、托盘绿色圆点指示器、全局快捷键 ⌘⇧Space 唤起窗口。
- 新增 数据可移植性:支持本地数据库的一键 JSON 备份导出与导入覆盖恢复。
- 优化 代码架构组件化重构:将 2200 余行的 Workspace.tsx 拆分为 TodayTab, WorkflowsTab, SettingsTab 等独立路由子模块,提升渲染性能。
- 优化 IPC 处理程序扩展:完整恢复被截断的 14 个 IPC handler,并新增 8 个系统控制 handler。
- 优化 UI 精打细磨:无边框纸张感 textarea 输入框,5s 轮播引导词占位符,拆解中 · · · 弹跳动画,保存笔记 2 秒绿色反馈动画。
- 优化 专注时长判定算法优化:支持 preset 时长平局选大,且偏离预设值 ±5min 内时自动保留原时长。
- 修复 全局异常捕获:引入 ErrorBoundary 机制,捕获全局 crash 并提供一键恢复重新载入按钮。
- 修复 数据库安全防护:在升级迁移前自动备份 .db.bak 文件,且程序退出时执行 PRAGMA wal_checkpoint(TRUNCATE) 自动清理 WAL 日志文件。
- 修复 API 参数校验:对 createWorkflow, createTask, startFocus 等关键接口添加字段安全校验。
- 修复 乱码与实体修复:解决 · 实体字符乱码,修复 10 处残留的英文界面提示,实现中文界面全覆盖。
一、思想捕获与任务拆解
- 文本输入框倾倒想法(占位符轮播,3 句引导语)
- ⌘↵ 快捷键提交
- AI 多 Provider 支持(OpenAI/Claude/Gemini/DeepSeek/通义/Kimi/Ollama/OpenRouter/自定义)
- 意图分类模型分离(廉价模型做分类,强模型做拆解)
- AI 拆解为工作流 + 原子任务(含达成标准、推理理由)
- 简易输入识别(单纯倾诉 → 温和回应 + 小建议)
- 拆解结果可编辑(标题/时长/优先级/标准/理由,任务可删除)
- 防重复导入(已导入工作流标记 + 双重检查)
- 提案多个工作流逐个导入不丢失
- Mock Provider 降级(无 API Key 也可体验)
- AI 自动推断任务执行类型(desk/learn/outdoor/quick)
- AI 回复自动匹配用户输入语言(中文输入 → 中文输出)
- AI 调用失败自动回退 Mock
- Structured Output 降级(不支持 json_schema 的 Provider 自动切换 json_object)
二、今日行动(Today)
- 动态问候(Good morning / afternoon / evening)
- 日期 + 连续专注天数副标题
- 今日待办统计(X 个行动 · 预计耗时 X)
- Next Action 推荐(P1 ≤ 10min 优先 → 已开始优先 → P1 → P2 → P3)
- 任务列表(优先级/预估时间/所属工作流标签)
- 跨天任务 "延续中" 标记(hover 显示,避免焦虑)
- 手动创建任务(标题/时长/优先级/所属工作流/重复/执行类型)
- 任务关联到工作流(下拉切换)
- 任务标记完成/未完成(切换)
- 任务删除
- AI Coach 上下文面板(容量预警/清晰度提示/进度回顾/今晚建议/开始信号/工作流过多/全部完成)
- 晚间收盘仪式(20:00 后 → 提示归档跨天未完成任务)
- 灵感引导卡片(已移除,改为一行淡文字"尽管写,我来理清楚")
- 自定义专注会话入口
三、专注执行(Focus)
- 专注前设置面板(氛围/时长/试听)
- 5 种空气氛场景(深度工作/写作/阅读/放松/超专注)
- 5 种环境音(褐噪音/雨声/白噪音/浪声/40Hz)
- Web Audio 合成 + 本地 MP3 加载(自动降级)
- 40Hz 纯正弦波 OscillatorNode 合成
- 时长自动推荐(±5min 内保持原值,超过才提示调整)
- 全屏 FocusRoom(任务名 + 完成标准 + 计时器 + 进度条)
- 全屏底部"接下来"队列(前 3 个任务)
- 暂停/继续(声音同步)
- 标记完成 + 反思面板(esc 退出)
- 跳过当前任务换下一个
- 专注中快速 capture("记下想法"入口不打断计时)
- 计时归零 🎉 完成闪屏动画 + 自动弹出完成面板
- 恢复休息模式(计时结束自动进入)
- 可自定义短休息/长休息时长
- ESC 退出全屏
- macOS traffic light 留白适配
- 4 种执行类型差异化行为(quick→直接完成 / outdoor→直接开始 / desk→弹窗选氛围 / learn→弹窗选时间)
四、我的计划(Workflows)
- 工作流列表(标题/优先级/任务进度/子任务预览)
- 状态视觉分层(进行中 100% → 搁置虚线边框 → 已完成 40% 置底)
- 排序:active → paused → completed
- 工作流详情(状态切换/源思路/任务列表/增删任务)
- 手动创建工作流
- 从 AI 提案批量导入
- 工作流模板(保存/删除/一键创建)
- 重复工作流检测(同名提示)
- 工作流删除确认对话框
- 任务删除后撤销 Toast
五、AI 记忆(Memory)
- 笔记 CRUD(新建/编辑/删除)
- 关联工作流(下拉选择)
- 保存按钮反馈(绿色动画 2s)
- 行为事件自动记录(focus_end / task_skipped / task_completed)
- 行为统计注入 UserContext(待做数/跳过率/完成率)
- 用户偏好 KV 存储
六、完成记录(History)
- 时段筛选(今天/本周/本月/全部)
- 本周回顾卡片(已完成数/遗留数/一键归档)
- 聚焦日志时间线(意图/时长/反思/时间戳)
- 已完成工作流列表
- 分段控制(macOS 深底白字风格)
七、设置(Settings)
- AI Provider 配置(两步向导:选 Provider → API Key + 模型)
- API Key 眼睛图标(密码显隐切换)
- 连接测试(绿色/红色/橙色状态)
- "未连接"时一键跳转到 API Key 输入
- 各 Provider 获取 API Key 教程链接
- 意图分类模型分离选择
- 拆解主模型选择
- 模型列表按实际 SDK 类型动态更新(含 GPT-5.4 等)
- 保存降级提示(失败弹窗 + 禁止双击)
- 外观切换(深色/浅色,自动跟随系统)
- 界面语言切换(简体中文/English)
- 短休息/长休息时长自定义
- 数据导出备份(JSON 下载)
- 分区标题(AI 配置 / 外观与语言 / 专注计时 / 数据管理)
八、侧边栏(Sidebar)
- LogoMark SVG(小写 c + 点)
- 4 个主导航(今日/计划/记忆/记录)+ 图标 + 数字徽章
- 设置导航(底部)
- 搜索框(⌘K 快捷键,支持全局搜索)
- 选中态(左侧 2px 绿色竖线 + 浅绿背景)
- 首次使用引导卡片
- macOS 毛玻璃(vibrancy sidebar)
- hiddenInset 拖拽区域(品牌头可拖拽窗口)
- 底部"本地优先"声明
- Today 计数(X done / Xm focused)
九、全局交互
- 键盘快捷键(⌘K 搜索 / ⌘N 今日 / ⌘1-4 导航 / ↑↓ 切换 / Esc 清空输入)
- macOS .dmg 打包(Apple Silicon + Intel 双架构)
- Windows .exe 打包
- 全局快捷键 ⌘⇧Space(唤起/聚焦窗口)
- 托盘图标 + 右键菜单
- 自动深色模式跟随
- ErrorBoundary 全局捕获
- 确认对话框(删除操作)
- Toast 通知 + 撤销
- Loading 初始加载动画
- 中英双语全页面 i18n
十、架构与数据
- SQLite 本地存储(local-first)
- FTS5 全文搜索
- IPC 安全隔离(contextBridge)
- 输入校验(标题长度/物理范围/分钟范围)
- DB Schema 版本化迁移(向后兼容)
- Vercel AI SDK v6 集成(generateObject + generateText)
- AI 调用自动降级(Structured Output → JSON → Mock)
- behavior_log 行为轨迹
- user_preferences 偏好存储
- 6 个 vitest 测试