温和的觉知，善待身心。
一个用微小停顿重建健康节律与专注力的桌面提醒应用。
现代办公与学习让我们长时间陷在屏幕前——久坐、缺水、用眼过度、注意力涣散。Aware 不用压迫式的「别偷懒」「别分心」来督促你，而是用温和、正向、指向行动的话语，在恰当的时刻轻轻拍拍你的肩膀：
- 「起身活动」而不是「不要久坐」
- 「喝口水」而不是「你该喝水了」
- 「一次只做一件事」而不是「别分心」
它把「觉察」变成习惯——每一次微小的停顿，都是对身心的善待。
Aware 是一款 Tauri 2 + React 19 构建的轻量桌面应用，所有数据本地存储，零云端、零上传。
| 我的提醒 | 新建提醒 |
|---|---|
 |
 |
| 专注空间 | 觉察报告 |
|---|---|
 |
 |
| 设置 | 深色模式 |
|---|---|
 |
 |
- ⏰ 定时触发 —— 固定时刻（如每天 09:30 提醒要事优先）或时间间隔（如每 30 分钟望向远方）
- 🎲 随机触发 —— 在指定时段内随机出现（如工作时段 09:00–18:00 内随机 3 次深呼吸）
- ⚡ 事件触发 —— 捕捉系统行为：连续工作 50 分钟提醒起身、5 分钟内频繁切窗 6 次提醒专注当下
- 💊 灵动胶囊 —— 顶部居中的毛玻璃悬浮卡片，可拖拽、可带「正/负反馈」按钮，温和打断并承接你的回应
- ✨ 呼吸光效 —— 屏幕四边的柔和呼吸光晕，最弱打扰，12 秒后自动消失
- 轻专注 —— 自定义专注周期、休息间隔、微休息，在持续节奏中插入小憩
- 深度专注（番茄钟） —— 专注 / 短休 / 长休 多轮循环，沉浸背景音助你进入心流
- 沉浸背景音 —— 白噪音 / 粉噪音 / 褐噪音 / 40Hz 双耳节拍，纯代码合成、无音频文件
- 专注期间可静默「我的提醒」、一键引导开启系统勿扰
- 近 30 天专注节律趋势曲线 + 习惯连击热力图
- 本周洞察引文 + 健康守护 / 习惯养成成就统计
- 真实数据驱动，帮你看见自己的节律、沉淀为习惯
- 透明无边框窗口 + 毛玻璃亚克力质感
- 浅色 / 深色 / 跟随系统
- 可调背景透明度，让桌面壁纸透出
- 全部数据本地 SQLite 存储，零云端、零上传
- 支持导出 / 导入合并、每日 02:00 自动备份
- 开机自启、关闭到托盘、勿扰时段、系统通知等贴心设置
前往 Releases 下载对应平台的安装包：
- Windows：
.msi/.exe安装包
macOS / Linux 暂未提供预编译包，可参考下方从源码构建。
参考下方「🛠️ 开发指南」运行 npm run tauri build。
- Node.js ≥ 20
- Rust（stable 工具链）
- Tauri 2 前置依赖（Windows 需 Microsoft C++ Build Tools 与 WebView2）
# 安装前端依赖
npm install
# 桌面端开发（完整功能：透明窗口、毛玻璃、托盘、系统监听）
npm run tauri dev
# 仅前端开发（浏览器，端口 1420）
# 注意：浏览器无 Tauri 运行时，窗口按钮 / 拖拽 / 系统事件不工作——这并非 bug
npm run devnpm run tauri build产物位于 src-tauri/target/release/bundle/。
| 命令 | 说明 |
|---|---|
npm run tauri dev |
桌面端开发（改 Rust / Cargo / capabilities 后需重启此命令） |
npm run dev |
仅前端（浏览器，端口 1420） |
npm run build |
tsc 类型检查 + Vite 构建 |
npm run tauri build |
打包发布版桌面应用 |
npx tsc --noEmit |
单独跑 TypeScript 类型检查 |
| 层 | 技术 |
|---|---|
| 前端 | React 19 · TypeScript · Tailwind CSS v4（CSS-first）· Vite 7 · lucide-react |
| 后端 | Rust · Tauri 2（托盘 / 自启 / SQL / 通知 / 对话框）· windows-sys 0.59（Win32 系统监听） |
| 数据 | 本地 SQLite（@tauri-apps/plugin-sql） |
| 音频 | Web Audio API 纯代码合成（白/粉/褐噪音、40Hz 双耳节拍，零音频文件） |
- 透明无边框窗口 —— 自实现窗口控制与拖拽；沉浸式通顶侧边栏 + 顶部拖拽条，桌面壁纸透出
- 多窗口架构 —— 主窗口 / 灵动胶囊 / 呼吸光效 为三个独立 OS 窗口，触发时悬浮展示、互不干扰
- 提醒触发引擎 —— 基于绝对时间戳的抗睡眠 / 防连弹调度，息屏与睡眠期间零打扰；支持定时 / 随机 / 事件三类 + 每天 / 每周重复
- 专注计时引擎 —— 轻专注 / 深专注状态机；绝对时间戳 tick，睡眠唤醒自动校正
- 毛玻璃视觉系统 —— Tailwind v4
@theme设计 token + 动态透明度 + 浅 / 深双主题 - 系统行为感知（Windows） —— 后台线程轮询前台窗口切换 / 闲置 / 专注时长；监听显示器电源事件实现「息屏零打扰」
完整的架构说明、关键约定与已知陷阱见 CLAUDE.md。
首次启动自带 9 条范例提醒（默认全部关闭，按需开启），覆盖办公与学习场景：
| 类别 | 提醒 |
|---|---|
| 🍃 健康守护 | 喝口水 · 望向远方 · 起身活动 · 深呼吸 · 舒展肩颈 |
| 🎯 习惯养成 | 要事优先 · 一次只做一件事 · 把焦虑写下来 · 今日复盘 |
aware/
├── src/ # 前端源码
│ ├── components/ # UI 组件（页面、modal、胶囊、光效等）
│ ├── services/ # 引擎（TriggerEngine 触发 / FocusEngine 专注）
│ ├── lib/ # 数据层 db.ts / 音频合成 / 工具
│ ├── hooks/ # 自定义 Hook（报告统计等）
│ └── data.ts # 类型与常量
├── src-tauri/ # Rust 后端
│ ├── src/ # lib.rs / system_events.rs / backup.rs
│ ├── capabilities/ # Tauri 权限配置（default / capsule / glow）
│ ├── icons/ # 应用图标
│ └── Cargo.toml
├── pen/ # Pencil 设计稿（UI 真相来源）
├── public/ # 静态资源（提示音 mp3）
└── CLAUDE.md # 架构文档（强烈建议阅读）
- macOS / Linux 暂未提供预编译包（系统行为监听目前仅实现 Windows）
- 「系统通知」形式在 Windows dev 模式下 toast 可能不显示，打包后正常
- 专注配置暂不持久化（每次进入页面回到默认）
- 首次启动若系统为深色模式可能有短暂闪烁（SQLite 非 localStorage，首屏前读不到主题）
欢迎提 Issue 反馈问题或建议；提 PR 前请先开 Issue 讨论改动方向，避免重复劳动。
本项目基于 MIT License 开源。
用微小的停顿，重新建立健康节律。🌿