ytc/FocusBuddy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update md

Browse Source
This commit is contained in:
ytc1012
2025-11-27 14:00:13 +08:00
parent 5dccf27059
commit 15252dfd88
5 changed files with 612 additions and 723 deletions
Download Patch File Download Diff File Expand all files Collapse all files

485
product-design.md
View File

@@ -1,230 +1,255 @@
# ADHD 专注伴侣产品方案（个人开发者版）
> **产品名称**：FocusBuddy（暂定，备选：GentleFlow，MindAnchor，ComeBack Timer，SoftFocus）
> **定位**：一款为神经多样性人群设计的、无惩罚、情感支持型专注工具
> **目标**：帮助用户温柔地回到当下，而非追求“高效”
> **适用平台**：iOS + Android（Flutter 跨平台）
> **开发周期**：4–6 周 MVP
> **作者**：个人开发者
> **最后更新**：2025年11月22日
---
## 一、产品背景与市场机会
### 1.1 用户痛点
- ADHD 及注意力困难人群常因“无法专注”产生自我批评；
- 现有番茄钟工具强调“完成”，失败即惩罚（如 Forest 树枯死），加剧焦虑；
- 用户需要的是“允许分心 + 温柔回归”的支持机制，而非效率压榨。
### 1.2 市场验证
- 全球约 **4–5% 成年人**存在 ADHD 特征（CHADD 数据）；
- Reddit r/ADHD 拥有 **超 200 万订阅者**，TikTok #ADHDTips 话题播放量超 **10 亿**；
- 竞品如 Tiimo（估值 $1 亿）、Focus Keeper（长期付费榜前列）证明付费意愿强；
- **空白点**：缺乏轻量、离线、情绪友好的垂直工具。
### 1.3 为什么适合个人开发者？
- 功能聚焦，无需后端；
- 开发成本低（纯本地逻辑）；
- 广告变现路径清晰；
- 社区自传播潜力大。
---
## 二、产品定位与原则
### 2.1 核心理念
> “专注不是坚持不走神，而是每次走神后，都愿意轻轻回来。”
### 2.2 三大设计原则
| 原则 | 说明 |
|------|------|
| **无惩罚机制** | 分心不中断计时，不断连成就，不重置进度 |
| **本地优先** | 所有数据仅存于设备，不联网、不上传 |
| **情绪友好** | 用鼓励文案、柔和动效、低刺激视觉降低焦虑 |
### 2.3 避免踩坑
- ❌ 不使用 “ADHD”、“治疗”、“诊断” 等医疗词汇；
- ✅ 定位为 “focus support tool for neurodivergent minds”；
- ✅ 强调 “gentle”, “kind”, “no guilt”。
---
## 三、核心功能（MVP）
### 3.1 功能列表
| 模块 | 功能 | 说明 |
|------|------|------|
| **启动页** | 一键开始专注 | 默认 25 分钟，可滑动调整（5–60 分钟） |
| **专注中** | “I got distracted” 按钮 | 点击记录分心类型，不中断计时 |
| **分心分类** | 4 种常见场景 | • Scrolling social media<br>• Got interrupted<br>• Felt overwhelmed<br>• Just zoned out |
| **温柔回归** | 鼓励反馈 | 显示文案：“It happens. Let’s gently come back.” + 轻柔音效 |
| **专注报告** | 每日总结卡片 | 含总时长、分心趋势、随机鼓励语 |
| **成就系统** | 连续完成奖励 | 解锁主题皮肤（如 “Calm Cloud”） |
| **广告激励** | 可选看广告 | 解锁新主题或恢复断连（非强制） |
### 3.2 差异化亮点
- **Body Doubling Lite**：未来可扩展静默陪伴视频（当前 MVP 暂不实现）；
- **ASMR 音效**：集成免费 CC 协议白噪音（雨声、键盘声）；
- **Export Report**：生成 PDF 周报（用户主动触发，用于与治疗师分享）。
---
## 四、UI/UX 设计
### 4.1 视觉风格
- **色彩**：莫兰迪色系（主色 `#A7C4BC`，背景 `#F8F6F2`）
- **字体**：Nunito（圆润、易读）
- **图标**：手绘感、轻微不规则
- **动效**：缓慢粒子飘动、按钮呼吸动画
### 4.2 核心页面（Figma 原型）
#### 页面 1：启动页（Home）
```
[居中大按钮] Start Focusing (25 min)
[小字提示] Tap 'I got distracted' anytime — no guilt.
```
#### 页面 2：专注中（During Focus）
```
24:37
[按钮] I got distracted Pause
（点击后弹出分心类型选项）
```
#### 页面 3：专注报告（Summary）
```
✅ You focused for 24 minutes today.
📊 Distractions: 2 times
🌱 Achievement unlocked: "Calm Cloud"
[按钮] Watch ad to unlock next theme
```
### 4.3 鼓励文案库（随机展示）
- “Showing up is half the battle.”
- “Every minute counts.”
- “You’re learning, not failing.”
- “Gentleness is strength.”
---
## 五、技术实现
### 5.1 技术栈
| 组件 | 方案 |
|------|------|
| 跨平台框架 | Flutter |
| 本地存储 | Hive（加密支持） |
| 定时与通知 | flutter_local_notifications + workmanager |
| 动画 | Lottie / Rive |
| 音频 | just_audio |
| 广告 | Google AdMob + TopOn 聚合（可选） |
### 5.2 数据结构（Hive）
```dart
class FocusSession {
DateTime startTime;
int durationMinutes;
List<Distraction> distractions;
}
class Distraction {
String type; // e.g., "social", "interrupted"
DateTime time;
}
```
### 5.3 开发里程碑
| 周数 | 目标 |
|------|------|
| 第1周 | UI + 基础计时器 |
| 第2周 | 分心记录 + Hive 存储 |
| 第3周 | 报告生成 + 成就系统 |
| 第4周 | 广告接入 + 测试发布 |
### 5.4 多语言支持
#### 高优先级
日语 (Japanese) 🇯🇵
原因: 日本对生产力工具和专注应用有极高需求
特点: ADHD 和神经多样性支持在日本很受关注
市场: 日本的 App Store 付费意愿很高
韩语 (Korean) 🇰🇷
原因: 韩国学生和上班族对学习/工作效率工具需求很大
特点: "番茄工作法"和专注应用在韩国非常流行
市场: K-pop 文化影响，年轻用户群体活跃
西班牙语 (Spanish) 🇪🇸 🇲🇽
原因: 全球第二大母语人口（4.5亿+）
覆盖: 西班牙、墨西哥、阿根廷、哥伦比亚等20+国家
市场: 拉丁美洲移动应用市场快速增长
#### 中等优先级
德语 (German) 🇩🇪
德国、奥地利、瑞士
注重隐私和离线功能（你的卖点！）
付费意愿高
法语 (French) 🇫🇷
法国、加拿大（魁北克）、比利时、瑞士
约3亿使用者
葡萄牙语 (Portuguese) 🇧🇷
巴西（2.2亿人口）
快速增长的移动市场
俄语 (Russian) 🇷🇺
俄罗斯、独联体国家
约2.6亿使用者
#### 长期考虑
意大利语 (Italian) 🇮🇹
荷兰语 (Dutch) 🇳🇱
土耳其语 (Turkish) 🇹🇷
---
## 六、合规与隐私
### 6.1 隐私政策要点
- **无数据收集**：所有数据仅存于设备；
- **无分析 SDK**：不使用 Firebase、GA 等；
- **广告透明**：说明 AdMob 使用，提供个性化广告关闭指引；
- **非医疗工具**：明确声明不用于诊断或治疗。
### 6.2 隐私政策模板（摘要）
> “FocusBuddy is 100% offline. We do not collect your name, email, location, or usage data. All sessions stay on your device. We use Google AdMob for optional ads, which you can disable via device settings.”
（完整模板见附件）
---
## 七、变现模型
| 收入来源 | 实现方式 | 预期占比 |
|--------|--------|--------|
| 激励视频广告 | 完成专注后解锁主题 | 70% |
| 插屏广告 | 每3次专注展示1次（可跳过） | 20% |
| 去广告内购 | $2.99 一次性购买 | 10% |
| 主题包（未来） | $0.99 解锁新皮肤 | 增量 |
### 收益预估（1万下载，10% DAU = 1000人）：
- 日收入 ≈ $3–5
- 月收入 ≈ $90–150（初期），随留存提升可翻倍
---
## 八、推广策略（零预算冷启动）
1. **Reddit 渗透**
- 发帖 r/ADHD：“Made a focus app that doesn’t shame you—feedback welcome!”
2. **TikTok 短视频**
- 内容：“How I stopped hating myself for losing focus”
3. **Product Hunt 首发**
- 标题：“A focus timer for people who hate focus timers”
4. **ADHD 博主合作**
- 免费提供 Pro 版，换取真实测评
---
> **愿景**：
> 让每一个“不同大脑”的人，都能在专注的路上，被温柔以待。
---
> ✨ **备注**：本方案专为个人开发者设计，强调最小可行、快速验证、情感价值优先。
# FocusBuddy 产品设计文档
> **产品名称**：FocusBuddy
> **定位**：一款为神经多样性人群设计的、无惩罚、情感支持型专注工具
> **目标**：帮助用户温柔地回到当下，而非追求“高效”
> **适用平台**：iOS + Android（Flutter 跨平台）
> **开发状态**：已完成 MVP 版本
> **最后更新**：2025年11月27日
---
## 一、产品背景与市场机会
### 1.1 用户痛点
- ADHD 及注意力困难人群常因“无法专注”产生自我批评；
- 现有番茄钟工具强调“完成”，失败即惩罚（如 Forest 树枯死），加剧焦虑；
- 用户需要的是“允许分心 + 温柔回归”的支持机制，而非效率压榨。
### 1.2 市场验证
- 全球约 **4–5% 成年人**存在 ADHD 特征（CHADD 数据）；
- Reddit r/ADHD 拥有 **超 200 万订阅者**，TikTok #ADHDTips 话题播放量超 **10 亿**；
- 竞品如 Tiimo（估值 $1 亿）、Focus Keeper（长期付费榜前列）证明付费意愿强；
- **空白点**：缺乏轻量、离线、情绪友好的垂直工具。
### 1.3 产品优势
- 功能聚焦，无需后端；
- 开发成本低（纯本地逻辑）；
- 无广告干扰，用户体验良好；
- 社区自传播潜力大。
---
## 二、产品定位与原则
### 2.1 核心理念
> “专注不是坚持不走神，而是每次走神后，都愿意轻轻回来。”
### 2.2 三大设计原则
| 原则 | 说明 |
|------|------|
| **无惩罚机制** | 分心不中断计时，不断连成就，不重置进度 |
| **本地优先** | 所有数据仅存于设备，不联网、不上传 |
| **情绪友好** | 用鼓励文案、柔和动效、低刺激视觉降低焦虑 |
### 2.3 避免踩坑
- ❌ 不使用 “ADHD”、“治疗”、“诊断” 等医疗词汇；
- ✅ 定位为 “focus support tool for neurodivergent minds”；
- ✅ 强调 “gentle”, “kind”, “no guilt”。
---
## 三、已实现核心功能
### 3.1 页面功能
| 页面 | 功能 | 说明 |
|------|------|------|
| **Home** | 一键开始专注 | 显示积分卡片、应用标题、时长选择、开始专注按钮和底部导航 |
| **Focus** | 专注计时 | 显示计时器、分心按钮和暂停按钮 |
| **Complete** | 专注完成 | 显示专注结果、鼓励文案和"Start Another"按钮 |
| **History** | 历史记录 | 显示当天记录列表，支持查看详情 |
| **Settings** | 设置选项 | 包含默认时长选项、语言选择和隐私政策链接 |
| **Profile** | 个人资料 | 显示积分、等级和连续签到记录 |
| **Onboarding** | 引导页 | 解释"无惩罚"理念，降低用户困惑 |
| **Session Detail** | 会话详情 | 显示单个专注会话的详细信息 |
### 3.2 核心功能
| 功能 | 说明 |
|------|------|
| **无惩罚机制** | 分心不中断计时，不断连成就，不重置进度 |
| **分心记录** | "I got distracted"按钮 + 4种分心分类（社交媒体、被打断、感到压力、走神） |
| **温柔鼓励** | 随机显示15条鼓励文案，如"Showing up is half the battle" |
| **本地存储** | 使用Hive进行数据存储，所有数据仅存于设备 |
| **多语言支持** | 支持14种语言（英语、中文、日语、韩语、西班牙语、德语、法语、葡萄牙语、俄语、印地语、印度尼西亚语、意大利语、阿拉伯语） |
| **通知功能** | 后台计时通知，提醒用户正在计时中 |
| **积分系统** | 完成专注获得积分，提升等级 |
| **提前停止确认** | 点击Stop时友好提示，防止误操作 |
| **空状态提示** | History页无数据时引导用户 |
---
## 四、UI/UX 设计
### 4.1 视觉风格
- **色彩**：莫兰迪色系（主色 `#A7C4BC`，背景 `#F8F6F2`）
- **字体**：Nunito（圆润、易读）
- **图标**：简洁、清晰的 Material Design 图标
- **动效**：柔和的过渡动画，避免快速、刺激的动效
### 4.2 核心页面设计
#### 页面 1：Home Screen
- 顶部显示积分卡片，包含积分、等级和连续签到记录
- 中间显示应用标题和时长选择
- 底部显示开始专注按钮和导航栏（历史、设置）
#### 页面 2：Focus Screen
- 中央显示大字体计时器
- 下方显示"I got distracted"按钮和暂停按钮
- 支持后台计时和通知
#### 页面 3：Complete Screen
- 显示专注结果（时长、分心次数）
- 随机显示鼓励文案
- 提供"Start Another"按钮
### 4.3 鼓励文案库
存储在 `assets/encouragements.json` 中，包含15条鼓励文案：
```json
[
"Showing up is half the battle.",
"Every minute counts.",
"You're learning, not failing.",
"Gentleness is strength.",
"Progress over perfection.",
"Your effort matters.",
"Small steps, big journey.",
"Be kind to your brain.",
"You're doing your best.",
"One moment at a time.",
"Focus is a practice, not a trait.",
"It's okay to take breaks.",
"You came back — that's what matters.",
"Celebrate trying, not just succeeding.",
"Your attention is valid."
]
```
---
## 五、技术实现
### 5.1 技术栈
| 组件 | 方案 |
|------|------|
| 跨平台框架 | Flutter |
| 本地存储 | Hive（加密支持） |
| 定时与通知 | flutter_local_notifications |
| 权限管理 | permission_handler |
| 依赖注入 | get_it |
| 国际化 | flutter_localizations + intl |
| 字体 | Google Fonts (Nunito) |
### 5.2 数据结构
**FocusSession 模型：**
```dart
class FocusSession {
DateTime startTime;
DateTime? endTime;
int durationMinutes;
List<Distraction> distractions;
bool isCompleted;
}
```
**Distraction 模型：**
```dart
class Distraction {
String type; // e.g., "social", "interrupted", "overwhelmed", "zoned_out"
DateTime time;
}
```
**UserProgress 模型：**
```dart
class UserProgress {
int totalPoints;
int level;
int consecutiveCheckIns;
bool hasCheckedInToday;
List<String> achievements;
}
```
### 5.3 依赖包
**核心依赖：**
```yaml
dependencies:
flutter: ^3.10.0-290.4.beta
flutter_localizations: ^0.1.0
cupertino_icons: ^1.0.8
hive: ^2.2.3 # 本地存储
hive_flutter: ^1.1.0
flutter_local_notifications: ^17.0.0 # 通知
permission_handler: ^11.0.0 # 权限管理
path_provider: ^2.1.0 # 文件路径
shared_preferences: ^2.2.0 # 简单键值存储
intl: ^0.20.2 # 日期格式化和国际化
google_fonts: ^6.1.0 # Google Fonts (Nunito)
get_it: ^7.7.0 # 依赖注入框架
```
**开发工具：**
```yaml
dev_dependencies:
flutter_test: ^0.0.0
flutter_lints: ^6.0.0
hive_generator: ^2.0.0 # Hive代码生成
build_runner: ^2.4.0 # 构建工具
```
### 5.4 多语言支持
已实现14种语言支持：
- 英语 (English) 🇬🇧
- 中文 (Chinese) 🇨🇳
- 日语 (Japanese) 🇯🇵
- 韩语 (Korean) 🇰🇷
- 西班牙语 (Spanish) 🇪🇸
- 德语 (German) 🇩🇪
- 法语 (French) 🇫🇷
- 葡萄牙语 (Portuguese) 🇧🇷
- 俄语 (Russian) 🇷🇺
- 印地语 (Hindi) 🇮🇳
- 印度尼西亚语 (Indonesian) 🇮🇩
- 意大利语 (Italian) 🇮🇹
- 阿拉伯语 (Arabic) 🇸🇦
---
## 六、合规与隐私
### 6.1 隐私政策要点
- **无数据收集**：所有数据仅存于设备；
- **无分析 SDK**：不使用 Firebase、GA 等；
- **无广告**：当前版本不包含任何广告；
- **非医疗工具**：明确声明不用于诊断或治疗。
### 6.2 隐私政策摘要
> “FocusBuddy is 100% offline. We do not collect your name, email, location, or usage data. All sessions stay on your device. No account required. No tracking or analytics.”
---
## 七、推广策略（零预算冷启动）
1. **Reddit 渗透**
- 发帖 r/ADHD：“Made a focus app that doesn’t shame you—feedback welcome!”
2. **TikTok 短视频**
- 内容：“How I stopped hating myself for losing focus”
3. **Product Hunt 首发**
- 标题：“A focus timer for people who hate focus timers”
4. **ADHD 博主合作**
- 免费提供 Pro 版，换取真实测评
---
> **愿景**：
> 让每一个“不同大脑”的人，都能在专注的路上，被温柔以待。
---
> ✨ **备注**：本产品已完成 MVP 版本开发，可直接上架应用商店。