68fed087-9049-446f-bfc5-3f8.../docs/reviews/2026-05-19-product-review.md

# 摸鱼侠 — 产品 Review

**日期**: 2026-05-19
**审视版本**: v0.2.0 main HEAD `0cff83fc`（"sleep-aware timers + auto-loop pomodoro"）
**Tabs**: 番茄 / 久坐 / 喝水 / 下班 / 周末
**面板**: 380×620

---

## 一、核心价值主张

| 维度 | 评分 | 说明 |
|---|---|---|
| 差异化 | 9/10 | 聚合 5 个上班场景，刘海常驻，"周末倒数 + 打工语录" 玩具感 |
| 价值密度 | 8/10 | 单一 plugin 覆盖 4 个独立细分（番茄 / 久坐 / 喝水 / 倒计时）|
| 上手摩擦 | 9/10 | 0 登录 0 网络 0 配置就能用 |

### 强项

1. **聚合"上班一天会做的微动作"** — 番茄钟 + 久坐 + 喝水 + 下班倒计时已经覆盖职场版"健康助手"大头。市面上要么单功能 menubar (Be Focused / Drink Water Reminder)，要么大 app (Forest / Notion)。集中在刘海是新形态。
2. **"周末倒数 + 打工语录"是 personality 担当** — 这一 tab 跟其它四个分开看是娱乐性的，但它是产品个性的来源。没这个 tab 就是健康提醒 app，有了它就是"打工人玩具"。
3. **100% 本地** — 没网络、没账号、没 telemetry。比 Forest 联网+social pressure 更适合"我自己用"的人。

### 弱项

1. **"摸鱼侠"名字 vs 5 个 tab 全在认真工作 = 反差**
   名字暗示"摸鱼"，实际：番茄（专注）、久坐（健康）、喝水（健康）、下班（期待）、周末（期待）。**整个工具是"老老实实打工 toolkit"**。要么改名（"打工侠"更准），要么真加一个摸鱼 tab（藏老板模式 / 桌面伪装 / 假装写代码的 dummy editor）。
2. **5 tab 在 380pt 太挤** — `ExpandedView.swift:97` spacing 6 + 5 个 emoji tab，单 tab ~64pt。看是看见，但触摸/点击 hit zone 比看盘侠 3-tab 明显窄。
3. **README 与 footer/Info.plist 版本号不一致** — `ExpandedView.swift:151` footer 硬编码 "v0.1 · 本地运行"，但 Info.plist + WorkerPlugin.swift 是 v0.2.0。每次发版都得手改文案。

---

## 二、UX 流程完整度（按 tab 拆）

### 番茄 tab — 9/10 (最完善)

✅ 25/5 + 长休息 cycle 完整
✅ pause/resume 跨重启正确（`WorkerStore.swift:594-600` paused 持久化）
✅ **sleep-aware**：`WorkerStore.swift:198-200` 用 tick 间隔检测 wallclock gap，Mac 睡眠后倒计时不错乱
✅ 4-tomato dot 周期可视化（`PomodoroView.swift:64`）
✅ autoLoop toggle — 经典 Pomodoro 节奏，一启动跑一上午

**短板**：
- ⚠️ stepperPill 单位 +5/+1/+5 min，专注分钟想要 +1 step（27 分钟用例）
- ⚠️ 没"中断当前番茄"button — 重置可以替代但语义不同
- ⚠️ "专注时长 = todayCount × focusMin" 算法 simplistic — partial focus 丢失。无所谓，不算精确没事

### 久坐 tab — 9/10 (算法亮点)

✅ **input-idle 算法是核心亮点** — `SystemIdle.swift` 用 `CGEventSource.secondsSinceLastEventType` 判定真在打字 vs 离开。避免天真版"start timestamp - now"把午休/会议都算成坐着的 trap。
✅ 5min idle 阈值 reset；wallclock gap >30s 也 reset（sleep/wake）— 双保险
✅ threshold 之后 dock bounce + 红色 status pill + 通知（30s 持久化 cadence，崩溃最多丢 30s data）
✅ tip 文案诚实："只统计你真正在键盘前的时间。离开 5 分钟以上自动归零，午休/会议不会被算进去。"

**短板**：
- ⚠️ 没"今日累计坐了 X 小时"统计 — 只显示当前 streak，无历史 retention。"健康报告"路线钩子缺
- ⚠️ trigger 配置 +5 min step、下限 5 min — 想要 60min trigger 要点 3 次。可以加 +15 min step

### 喝水 tab — 7/10 (placeholder 级)

✅ Hero 大杯子 + 水位渐变填充动画细心（`WaterView.swift` CupOutline + LinearGradient mask）
✅ 进度 dot 可视化今日 x/N 杯
✅ 加 / 撤销 manual log，撤销 -∞ 守住（`WorkerStore.swift:455`）

**短板**：
- 🔴 **没提醒** — 跟番茄/久坐对比最大短板。设了"目标 8 杯"但不提醒。一整天忘了喝就没了。**P0**：加 X 小时一杯水的 cadence + 通知（autoLoop pomodoro-style）
- ⚠️ 历史不可见 — `waterHistory` dict 里其实存了过往天数据，没 UI
- ⚠️ 没编辑"今早 8 点喝了 1 杯但忘了点"功能 — 只能 + / 撤销 当前

### 下班 tab — 7/10 (倒计时到 0 没事件)

✅ "X 时 Y 分 Z 秒" + 渐变进度条（红→深红）— 视觉感染力强
✅ 9 小时 anchor 算 progress fraction —合理
✅ 时间 hh:mm 可调（5 min step）

**短板**：
- 🔴 **"下班到了"那一刻没事件** — `clockoutRemainingSec` 到 0 后 roll 到明天的同一时间（`WorkerStore.swift:491-495 if target <= now { target += 1 day }`）。所以下班到了下一秒变成"距明天下班 23:59:59"。**漏的体验**：应该有"已下班！" celebration overlay 或 panel 颜色变。**P0**
- ⚠️ tipText 说"下班时间到不会响铃" — 这是文案 disclaimer 但产品上反而是缺陷。**应该响**
- ⚠️ 没"周末忽略" — 周六也倒计时下班，应该周末显示"今天不上班"
- ⚠️ 默认 18:00；9-9-6 / 灵活 OT 党需改。OK 可调，但没"工时模式"预设

### 周末 tab — 8/10 (personality 担当)

✅ "天/时/分 + 下个周六 00:00" + 旋转打工语录 — 形态独特
✅ 周末打开倒计时 +7 天 — 决策合理（`WorkerStore.swift:518-519`）
✅ day-of-year mod 7 的 quote rotation 一天一条稳定

**短板**：
- ⚠️ **打工语录池只有 7 条** — 52 周看 52 次每条。重复感会重。**P1 扩到 30+**
- ⚠️ **没"假期校准"** — 国庆/春节怎么办？周末倒计时还在算下周六。逻辑对但用户期待"放长假倒计时"。**P1 接入国务院 ICS feed**

---

## 三、信息架构

| 强项 | 弱项 |
|---|---|
| 每个 tab 一致 layout：statusBadge + hero + controls + divider + settings + tipText | 没"全局 dashboard" — 5 tab 间不互通 |
| LiveDot 在 footer 闪 — plugin 在 active 计时 | 没"今日 X 番茄 + Y 杯水 + Z 分钟久坐" 一行 summary |
| notif status dot 在 top bar — 通知未授权时的隐性提醒 | tab 之间数据点孤岛 |

---

## 四、与竞品对比

| | 摸鱼侠 | Be Focused | Drink Water | Forest |
|---|---|---|---|---|
| 桌面常驻 | ✅ 刘海 | ✅ menubar | ✅ menubar | ❌ App |
| 番茄钟 | ✅ + auto-loop | ✅ | ❌ | ✅ |
| 久坐提醒 | ✅ input-idle | ❌ | ❌ | ❌ |
| 喝水追踪 | ✅（无提醒）| ❌ | ✅ | ❌ |
| 下班倒计时 | ✅ | ❌ | ❌ | ❌ |
| 周末倒数 | ✅ | ❌ | ❌ | ❌ |
| 通知 | UN + dock | ✅ | ✅ | ✅ |
| 价格 | 免费 | $1.99 | 免费 | $1.99 |
| Social pressure | ❌ | ❌ | ❌ | ✅（种树）|
| 中文体验 | ✅✅ | ❌ | ❌ | ⚠️ |

**差异化**：聚合 + 桌面常驻 + 中文文案 + 周末打工语录。"打工人玩具"比 Western productivity tool 中文用户更亲切。

---

## 五、上架前必修（P0）

| # | 项 | 文件 / 位置 |
|---|---|---|
| 1 | "下班到了"瞬间要有通知 + panel celebration overlay | `WorkerStore.swift:491-495` clockoutRemainingSec roll 逻辑 |
| 2 | 喝水加可选定时提醒（每 X 小时） | 新增 water reminder timer |
| 3 | footer 版本号去硬编码 | `ExpandedView.swift:151` 改读 `WorkerPlugin.version` |
| 4 | tipText "不会响铃" 删掉或改写 — 跟未来要加的通知冲突 | `ClockoutView.swift:239` |

---

## 六、建议加（P1）

1. **真的"摸鱼" tab** — 跟名字呼应：藏老板模式 / 桌面伪装 / dummy editor。是 product personality 的兑现
2. **打工语录池扩到 30+** — 现在 7 条一周一轮太短，季节性条目（春节前 / 国庆前 / 周一专属 / 周五专属）
3. **假期/节假日校准** — 国务院假期 ICS pull 一次，下班 + 周末倒计时知道明天是法定休
4. **今日历史 chart** — 7 天番茄 / 喝水 / 久坐 trend，鼓励 streak
5. **快捷键** — `cmd-shift-1/2/3/4/5` 切 tab，`space` 番茄 start/pause
6. **WaterView 历史可见** — `waterHistory` 数据已经在存，画个 7 天 bar chart

---

## 七、建议砍（P-1）

- README 提到 macOS 15.0+ / MioIsland v2.2.0+ 是 OK，但应在产品文案显式说"需要 Apple Silicon"（bundle arm64-only）— 这是 ecosystem 级问题，跟主程序 + 其它插件统一改

---

## 八、总评

| 问 | 答 |
|---|---|
| v0.2.0 上架免费版？ | **是** |
| 功能完成度？ | 番茄 9/10 + 久坐 9/10 是亮点；喝水 7/10 + 下班 7/10 是 placeholder 级；周末 8/10 是 personality 担当 |
| 上架前必修项数？ | 4 个（见上）|
| 最大产品风险 | "摸鱼侠"名字 vs 实际功能反差。要么改名要么真做摸鱼 tab |
| 最大产品亮点 | input-idle 久坐算法 + sleep-aware 番茄 wallclock — 工程支撑产品体验，比同类强一档 |

**优先级 sequence**：修 P0 四项 → 上架免费 → 做"真摸鱼 tab"兑现名字 → 加节假日校准 + 历史 chart 增 retention。