# 番茄钟 + 自定义倒计时卡片 — 需求契约

> 创建时间：2026-05-28
> 状态：需求已确认

## 目标

新增两种效率类卡片：番茄钟（25/5 循环倒计时）和自定义倒计时（用户设定目标日期）。

## 用户场景

### 番茄钟

1. 桌面显示番茄钟进度环，25 分钟工作倒计时
2. 倒计时结束，进度环变色提示休息（5 分钟）
3. 显示今日完成番茄数
4. 设置页可开关番茄钟卡片

### 自定义倒计时

1. 用户在设置页添加倒计时事件（名称 + 日期）
2. 桌面显示"距离 XX 还有 N 天"
3. 支持多个倒计时事件
4. 过期事件显示"已过去 N 天"或自动归档

## 验收标准

- [ ] 番茄钟：25 分钟工作 / 5 分钟休息自动循环
- [ ] 番茄钟：进度环可视化
- [ ] 番番钟：今日完成数显示
- [ ] 倒计时：支持添加/删除事件
- [ ] 倒计时：显示剩余天数
- [ ] 数据持久化，重启后恢复

## 本次范围

- 番茄钟卡片（基础 25/5 循环）
- 自定义倒计时卡片（多事件）

## 非目标

- 番茄钟声音提醒（仅视觉）
- 番茄钟统计报表（日/周/月）
- 倒计时精确到小时/分钟（只显示天数）

## 约束

- 复用现有卡片架构（Vue 组件 + Go 数据推送）
- 番茄钟状态前端本地管理（localStorage），不需要 Go 端计时
- 倒计时事件存储在 config JSON 中
- 布局：单栏模式追加在底部，多栏模式适配现有 grid