CalmFlow
macOS 安装与安全授权提示
CalmFlow 目前已为 Mac 平台发布了两个架构的安装包。为了获得最佳性能，请根据您的 Mac 处理器芯片选择对应的下载版本：
- Apple Silicon 版本：适用于搭载 M1 / M2 / M3 / M4 系列芯片的 Mac；
- Intel 版本：适用于搭载早期 Intel 处理器的 Mac。
⚠️ macOS “已损坏，无法打开” 的解决办法
由于作者目前暂未购买苹果开发者证书，当您首次双击运行 CalmFlow 时，macOS 系统可能会提示以下警告弹窗：
“CalmFlow”已损坏，打不开。你应该将它移到废纸篓。 或 无法打开“CalmFlow”，因为 Apple 无法检查其是否包含恶意软件。
请放心，这仅是因为证书签名缺失导致的系统误报。 该客户端完全开源（或绝不上云，仅运行在本地），您可以非常安全地使用以下命令绕过此安全校验：
- 使用快捷键 Command ⌘ + 空格 Space 打开 macOS 全局搜索；
- 输入
终端或Terminal，按回车键打开终端应用； - 复制下方框内的命令，粘贴到终端里，然后按回车键（运行此命令可能需要输入您 Mac 的开机密码并按回车确认）：
xattr -cr /Applications/CalmFlow.app 运行该命令后，关闭终端，返回您的“应用程序”文件夹重新双击 CalmFlow，即可顺利启动。如果后续有版本升级，只需在新版覆盖安装后，重复运行一次此命令即可。
Windows 安装指南
对于 Windows 用户，CalmFlow 提供了标准的 .exe 绿色安装程序，支持 Windows 10 及 Windows 11 64位操作系统。
⚠️ SmartScreen 拦截警告解决办法
在双击运行 CalmFlow-X.X.X-win-x64.exe 安装程序时，Windows Defender 防护可能会弹出蓝色的安全屏障：
Windows 已保护你的电脑 —— Microsoft Defender SmartScreen 阻止了无法识别的应用启动。
- 在蓝色提示窗口中，点击第一段下方的 “更多信息” (More Info) 细体字链接；
- 系统将露出应用的发布者和程序名，此时点击右下角新出现的 “仍要运行” (Run anyway) 按钮；
- 程序将自动完成安装并自动运行，并在桌面生成启动快捷方式。
核心功能：AI 任务分解教练
CalmFlow 的核心入口是首页的“想法倾倒箱”。这里不是一个普通的待办输入框，而是供您倾倒心智噪音的静心处：
- 意图识别与分离：我们采用了“小模型判断意图 + 强模型进行任务拆解”的分层架构。如果您只是进行单纯的情绪吐槽或闲聊倾诉，AI 不会强行给您列出任务，而是会给您一段温暖的安慰和轻量的建议；
- 自动化任务拆解：当您写下具体的复杂想法或杂乱的工作计划时（可以使用快捷键 Command ⌘ + Enter ↵ 快速提交），AI 任务分解教练会将其拆解成包含具体达成标准、推理理由、预估时长以及优先级的清晰任务流；
- 自定义可编辑：在将拆解出的任务导入到今日计划前，您可以自由修改每个任务的标题、调整顺序或删减不需要的临时任务。
核心功能：专注计时与环境声音合成
当任务理清后，下一步就是静心去执行。CalmFlow 内置了专属的专注空间：
- 40Hz 纯正弦波正疗效合成：不同于普通的有损 MP3 播放，CalmFlow 使用 Web Audio API 接口，通过您电脑的 CPU 物理正弦波生成器实时合成了纯净的 40Hz（伽马波）声音，有助于提高注意力和空间认知；
- 5 种氛围场景与灰噪音：内置了包括深度工作、写作、阅读等 5 种精选氛围环境，并且提供比白噪音更加柔和温热的环境褐噪音与过滤灰噪音，隔离周围的琐碎杂音；
- 沉浸式 FocusRoom 计时：进入全屏专注后，界面将隐藏一切会引起焦虑的干扰元素，只展示当前正在进行的任务、具体的目标达成标准和精美的倒计时进度条，帮助您保持心智专注。
核心功能：本地 SQLite 记忆搜索
为了让您放心地将想法倾倒在软件中，CalmFlow 建立了快速、安全的本地检索记忆：
- SQLite FTS5 全文检索：无需连网，所有保存在本地的想法、笔记和历史工作流都会被自动索引。您只需在左侧边栏点击搜索框或按下快捷键 Command ⌘ + K，便可瞬间检索出所有包含关键词的往期想法；
- 行为日志归档：您每一次的专注执行、反思记录以及完成的任务都会记录在时间线中，供您进行每周和每日的复盘。
本地优先（Local-First）与隐私保护
CalmFlow 采用本地优先的设计架构，我们深知您的思考和思绪是极度私密的个人资产：
数据安全性声明： 除非您自行在设置中添加第三方云同步 Provider 密钥，否则您所记录的所有任务、工作流、思绪笔记及行为日志都**仅存储在您本机物理硬盘的 SQLite 数据库文件中**，我们绝不会上传您的任何想法数据到我们的云端服务器。您的隐私 100% 归您自己所有。
如何更新版本与数据安全声明
由于目前内测版尚处于快速迭代期，暂时不支持直接在客户端内一键升级。当有新版发布时，您需要通过以下手动步骤进行更新：
- 访问官方下载页面 /download ➜，输入最新的今日邀请码进入下载区；
- 选择您操作系统对应的最新安装包（Mac 平台
.dmg或 Windows 平台.exe）进行下载； - 关闭当前正在运行的旧版 CalmFlow 客户端；
- 双击打开新版安装包，将新版应用程序拖入（macOS）或点击覆盖安装（Windows）到旧版的安装路径中。
🔒 数据安全声明（请放心覆盖安装）：
升级覆盖安装**绝不会丢失您的本地数据和配置**。CalmFlow 奉行本地优先原则，您输入的所有思考、待办、专注日志等，都存储在您本机系统用户数据专属的 SQLite 数据库文件中，而非应用软件安装包内部。覆盖升级只会替换软件本身，不会触及任何数据库，您可以放心安装。
🚀 后续自动更新规划
我们深知手动下载覆盖升级不够便捷。在后续的产品路线图规划中，**我们将在产品中加入自动更新（Auto-update）功能**。届时当有新版本发布时，客户端会自动检测并弹出升级提示，用户一键点击即可在软件内部快速无缝完成更新。
常见问题 (FAQ)
Q: 没有 API Key 还可以使用 AI 任务分解功能吗？
A: 可以。CalmFlow 内置了 Mock Provider 体验服务，即使在没有填写任何 API 密钥的情况下，也可以体验基础的任务生成流程。当您需要更高精准度的定制化分解时，建议在“设置”中配置您个人的 API Key（支持 DeepSeek、Gemini、OpenAI、Claude、Ollama 等平台）。
Q: 怎么备份我的数据？
A: 打开软件的“设置” (Settings) 页面，在“数据管理”分区中，点击“数据导出备份”按钮，系统将自动生成包含您全部本地数据库记录的 JSON 文件并保存到您的电脑中。如果更换设备，您可以通过该文件恢复数据。
Q: 如何调整番茄钟的专注时长和休息时间？
A: 您可以在设置中的“专注计时”板块自定义预设的短休息、长休息时长，或者在每次进入专注前，通过配置滑块灵活微调。