# Flow

**Repository Path**: muqyun/Flow

## Basic Information

- **Project Name**: Flow
- **Description**: No description available
- **Primary Language**: Swift
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-22
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flow - Master Your Focus

<div align="center">

[**中文**](README_CN.md) | [**English**](README.md)

<img src="figures/example.jpeg" alt="Flow App Preview" width="600">

</div>

Flow 是一个极简主义的番茄钟应用，旨在帮助你进入心流状态，实现深度工作。

## ✨ 功能特性

*   **专注计时**: 经典的 25 分钟专注模式，支持自定义时长。
*   **沉浸动效**: 呼吸般的背景与流光文字，助你平复心境。
*   **数据统计**: 详细的热力图记录你的每一次专注，见证点滴进步。
*   **标签系统**: 为任务分类（Reading, Coding, Meeting 等），清晰管理时间。
*   **极简界面**: 无干扰的暗色模式设计，完美适配 macOS。

## 📥 安装指南

1.  从 [Releases](https://github.com/MuQY1818/Flow/releases) 页面下载最新的 `.dmg` 文件。
2.  打开 `Flow.dmg`。
3.  将 `Flow.app` 拖入 `Applications` 文件夹。
4.  开启你的心流之旅！

### ⚠️ 提示：“文件已损坏，无法打开”
由于我是个人开发者，未购买 Apple 的 $99/年 开发者证书，因此应用未进行签名，macOS 安全机制可能会拦截它。

**解决方法：**
1.  打开终端 (`Terminal`)。
2.  输入以下命令并回车（需要输入密码）：
    ```bash
    sudo xattr -rd com.apple.quarantine /Applications/Flow.app
    ```
3.  或者：在 Finder 中 **右键点击** 应用 -> 选择 **打开** -> 在弹窗中点击 **打开**。

## 🚀 使用方法

1.  **开始专注**: 点击 "Start Focus" 按钮，界面将泛起微光，提示你已进入心流模式。
2.  **切换模式**: 使用顶部标签栏在 "Controls"（计时）和 "Stats"（统计）之间切换。
3.  **选择标签**: 点击计时器上方的标签菜单，选择当前活动的类型。
4.  **设置**: 点击右下角的滑块图标，调整计时时长和声音设置。

## 🛠 开发指南

```bash
# 克隆仓库
git clone https://github.com/MuQY1818/Flow.git

# 构建项目
swift build -c release

# 打包应用
./package_app.sh
```

---
Designed with ❤️ for deep workers.