TomatoTimer 使用手册

安装方法

网页版

访问 tomatotimer.sovkit.com
打开即用，无需注册
在浏览器菜单中选择安装应用（移动端为添加到主屏幕），即可像本地应用一样独立打开

浏览器扩展

访问 Chrome 网上应用店、Firefox 附加组件商店或Edge 外接程序
点击添加至浏览器并确认权限
将扩展图标固定到工具栏，方便随时使用

扩展版与网页版功能一致，差异处分别说明。

开始一个番茄钟

首页圆盘显示状态与剩余时间：

点击开始，圆环顺时针填充主题色；再点即暂停，点击继续恢复
放弃在未开始时置灰，点击后本轮作废

时钟走完即弹出提醒。默认不安排休息，也不自动开始下一个番茄钟。

临时调整时长

圆盘两侧的 −、+ 每次增减 5 分钟，只作用于本轮，不改功能配置：

未开始时，调整下一次开始的时长
进行中或暂停时，调整当前这一段；开启连续番茄时，本轮剩余的番茄钟沿用新时长

时长不能超出功能配置的范围，且本段至少剩 1 分钟，到边界时按钮置灰。

快捷键（浏览器扩展）

按快捷键即可开始、暂停或继续，无需打开侧边栏。键位显示在功能配置的开始/暂停快捷键一行，点击可前往浏览器的快捷键页面修改；Firefox 请在 about:addons 点击齿轮图标，选择管理扩展快捷键。

显示「未分配」表示与浏览器或其他扩展冲突，需换一个组合。快捷键仅在浏览器窗口处于前台时生效。

休息与连续番茄

两者默认关闭，在功能配置中开启：

休息时长（1~30 分钟） — 每个番茄钟走完自动进入休息，圆环变绿，结束时再提醒一次
连续番茄个数（2~12） — 点一次开始即连续进行设定个数，下一个自动开始；读数下方显示当前序号，点击可跳到该配置项。走完最后一个及其后的休息即停止

休息可暂停，放弃变为跳过休息，点击立即开始下一个番茄钟；跳过最后一个之后的休息即整轮完成。专注中点击放弃则整轮结束。

休息不计入专注时长。开始后修改这两项，下次点击开始才生效。

专注统计

只有完整走完的番茄钟才入账，按设定时长计入；中途放弃的不计。跨零点的番茄钟算在开始那天。开启同步后合并各设备记录。

今天

首页顶部显示今天的番茄数与专注时长，右侧为连续专注天数：当天完成一个番茄钟即算连上；今天尚未完成时从昨天往回数，当天结束前不算中断。

统计卡片

右上角可切换 7天、30天、全部（Pro）区间：

番茄数、专注时长 — 区间合计
专注天数 — 有完成记录的天数
日均专注 — 按区间全部天数平均，含未专注日；全部从首条记录那天算起
最长连续 — 最长连续专注天数
高峰日 — 专注时长最多的星期几

热力图展示近半年每天的专注，每列一周，时长越长颜色越深。指向或点按某格，底部显示当天的番茄数与专注时长，平时显示一句趣味换算，如相当于看完几部电影。

每日专注目标（Pro）

在功能配置中设为 1~20 后，今天一行右侧改为显示目标进度条与完成比，达成后转为主题色，超额照实显示。设为 0 则恢复显示连续专注天数。

统计导出（Pro）

点击统计卡片标题旁的下载按钮，导出有完成记录的每天番茄数与专注分钟数。格式在功能配置中选择：CSV（默认）或 JSON（便于脚本读取）。

提醒通知

番茄钟或休息结束时发送系统通知，新通知会替换旧的。关闭面板不影响计时：扩展版照常准时提醒，网页版需保留标签页，否则收不到提醒。

浏览器扩展 — 点击通知打开侧边栏；Firefox 只能通过工具栏图标打开
网页版 — 首次点击开始时浏览器会请求通知权限；被拒绝时应用内会提示，可在站点设置中重新放行

提示音默认开启，可在功能配置中关闭；Firefox 扩展的提示音由系统通知设置决定。

扩展图标状态

计时中图标显示剩余整分钟数（如剩 43 分 30 秒显示 43），不足一分钟显示"<1"，暂停显示"⏸"；休息时底色为绿色。

设置

功能配置

番茄时钟时长 — 默认 45 分钟，可填 10~120 的整数，超出范围时自动收敛到边界

其余各项见上文对应章节。

存储配置

配置好自带存储后，功能配置、语言主题偏好与专注统计会在网页版、扩展与不同电脑间同步。运行中的番茄钟不同步。

在设置 → 存储配置中按步骤填入 S3 兼容存储的存储桶、服务地址与访问凭证，点击测试并保存，测试通过后即可开启同步。

保存时浏览器会询问是否允许扩展访问该存储地址，允许后才能连接。

网页版还需在存储供应端配置 CORS 规则，配置参数可在该步骤中直接复制。

存储凭证只保存在本设备，不会上传到任何地方。不配置存储时，所有数据仅保存在本设备，功能不受影响。

常见问题

时钟走完却没收到通知

网页版确认已允许该站点通知
检查系统专注或勿扰模式是否拦截

换设备后统计对不上

确认两台设备都已开启同步，且填的是同一个存储桶
同步按固定节奏拉取，新记录可能稍后才出现