TomatoTimer 使用手册

安装方法

网页版

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

浏览器扩展

已上架 Chrome 网上应用店、Firefox 附加组件商店与 Edge 外接程序，其余浏览器陆续跟进。扩展版功能与网页版完全一致，下文凡涉及两者差异之处都会分别说明。

开始一个番茄钟

首页正中是一个圆盘，圆盘内显示当前状态与剩余时间，下方是两个按钮。

点击开始，圆环从顶部开始顺时针填充主题色，状态显示为"进行中"
再点击变为暂停，已走过的部分转为深灰，剩余时间原地冻结
点击继续恢复计时；时钟走完后按钮回到开始
放弃按钮在时钟未开始时置灰，点击后本轮直接作废

时钟走完的那一刻会弹出提醒通知，圆环填满后立即恢复灰色，等待下一轮。

默认情况下 TomatoTimer 不安排休息，也不会自动接上下一个番茄钟，何时开始完全由你决定。

临时调整时长

圆盘左右两侧的 − 与 + 每次减少或增加 5 分钟，只作用于这一轮，不会改动功能配置：

未开始时调整，只改下一次开始的时长
进行中或暂停时调整，改的是当前这一段；开启连续番茄时，本轮剩下的番茄钟也沿用调整后的时长
本轮走完，下一轮重新按功能配置中的时长开始

时长不能超出功能配置允许的范围，调整后本段至少要剩 1 分钟，到了边界对应的按钮会置灰。

快捷键（浏览器扩展）

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

休息与连续番茄

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

休息时长 — 设为 1~30 分钟后，每个番茄钟走完都会自动进入休息，圆环换成绿色，状态显示为"休息中"；休息结束时会再提醒一次
连续番茄个数 — 设为 2~12 后，点一次开始即连续进行设定个数的番茄钟，下一个自动开始，表盘读数下方显示当前是第几个，点击这个序号可直接跳到该配置项；走完最后一个（及其后的休息）即回到未开始

休息期间同样可以暂停，放弃按钮变为跳过休息：点击后立即开始下一个番茄钟，序号接着往后；若是最后一个番茄钟之后的休息，跳过即整轮完成。专注中点放弃则整轮就此结束。

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

专注统计

只有完整走完的番茄钟才会入账，且按设定的完整时长计入；中途放弃的既不计个数也不计时长，暂停的那段时间同样不算专注时长。跨越零点的番茄钟，其个数与时长都算在开始的那一天。开启同步后，所有设备的记录合在一起统计。

今天

首页顶部一行显示今天完成的番茄数与专注时长，右侧显示已连续专注的天数。某天只要完成一个番茄钟就算连上；今天还没完成时从昨天往回数，当天过完之前不算中断。

统计卡片

首页底部的统计卡片可在右上角切换 7天、30天与全部（Pro）三个区间，卡片内的六项数字随之变化：

番茄数、专注时长 — 区间内的合计
专注天数 — 区间内有完成记录的天数
日均专注 — 专注时长按区间内的全部天数平均，没有专注的日子同样计入；全部从第一条记录那天算起
最长连续 — 区间内最长的连续专注天数
高峰日 — 区间内专注时长最多的星期几

下方的热力图展示近半年每天的专注情况，每列一周、从周一排到周日，专注时长越长颜色越深，今天的格子带有描边。鼠标指向或点按某一格，底部会显示那一天的番茄数与专注时长；平时这一行是一句趣味换算，比如区间内的专注时长相当于看完几部电影。

每日专注目标（Pro）

在功能配置中把每日专注目标设为 1~20 之间的数字，首页顶部的今天一行右侧会改为显示目标进度条与今日已完成个数对目标的比值，达成后读数转为主题色。超额完成的部分照实显示，不会被隐藏。

设为 0 即表示不设目标，这个位置恢复显示连续专注天数。

统计导出（Pro）

点击统计卡片标题旁的下载按钮，即可把每天的番茄数与专注分钟数导出为文件，只包含有完成记录的日子。导出格式在功能配置中选择：

CSV — 默认格式，可直接用 Excel、Numbers 等任意表格软件打开
JSON — 便于脚本或其他工具读取

提醒通知

番茄钟或休息结束时都会收到一条系统通知，即使面板已关闭也会准时抵达。新的提醒会替换上一条，系统通知中心里始终只保留最新的一条。

浏览器扩展 — 点击通知会直接打开侧边栏；Firefox 例外，该浏览器只允许通过工具栏图标打开侧边栏
网页版 — 首次点击开始时浏览器会询问通知权限，允许后才能收到提醒；若权限被拒绝，应用内会给出提示，可在浏览器的站点设置中重新放行

是否播放提示音可在功能配置中开关。Firefox 上该开关对扩展不起作用，提示音由系统通知设置决定。

扩展图标状态

番茄钟运行期间，扩展图标上会显示剩余的整分钟数（如剩余 43 分 30 秒显示 43），不足一分钟时显示"<1"，暂停时显示"⏸"。休息期间同样显示剩余分钟数，底色换成绿色以示区分。

多设备同步

TomatoTimer 支持把功能配置、语言主题偏好与专注统计同步到你自己的存储中，网页版与扩展、不同电脑之间由此共享同一份数据。

在设置 → 存储配置中按四个步骤填入你的 S3 兼容存储信息（存储桶、服务地址、访问凭证），并在供应端配置 CORS 规则，测试通过后开启同步即可。存储凭证只保存在本设备，不会上传到任何地方。

需要注意：同步的是配置与统计，运行中的番茄钟不同步——每台设备各跑各的时钟，互不打扰。

不配置存储时，所有数据仅保存在本设备，功能不受任何影响。

设置

通用配置

语言 — 跟随系统 / English / 简体中文 / 日本語
主题 — 跟随系统 / 浅色 / 深色

功能配置

番茄时钟时长 — 默认 45 分钟，可填 10 到 120 之间的任意整数，超出范围会在离开输入框时自动收敛到边界
休息时长 — 默认 0 分钟，即不休息，可填 0 到 30
连续番茄个数 — 默认 1，即不自动开始下一个，可填 1 到 12
播放通知声音 — 默认开启
每日专注目标（Pro） — 默认 0，即不设目标
开始/暂停快捷键（仅浏览器扩展） — 显示当前键位，点击可前往浏览器的快捷键页面修改
统计导出格式（Pro） — 默认 CSV，可选 JSON

存储配置

见上文"多设备同步"。

常见问题

时钟走完了却没收到通知

网页版请确认已允许该站点发送通知，并检查系统的专注模式或勿扰模式是否拦截了通知
扩展版请确认扩展处于启用状态

换了台设备，统计数据对不上

确认两台设备都已开启同步，且填的是同一个存储桶
同步按固定节奏拉取，刚记下的番茄可能需要稍等片刻才会出现在另一台设备上

按了快捷键没反应

确认功能配置中开始/暂停快捷键没有显示「未分配」：键位与其他扩展冲突时，浏览器不会分配给 TomatoTimer，到浏览器的快捷键页面换一个组合即可
快捷键只在浏览器窗口处于前台时生效

开启连续番茄后，时钟会一直跑下去吗

不会。走完设定的个数就会停下，回到未开始；中途想停，在专注中点放弃即可

关掉面板后时钟还在走吗

会。计时按绝对时刻推进，关闭侧边栏或切换标签页都不影响，重新打开时读数依然准确
扩展版在侧边栏关闭时仍会准时提醒；网页版需要保留标签页，标签页被关闭则收不到这一次提醒