用 Python 写一个番茄钟命令行小工具:定时、提醒与当日专注统计
【摘要】 番茄工作法把时间切成 25 分钟专注加 5 分钟休息的“番茄”,简单却很有效。与其装一个臃肿的 App,不如用 Python 写一个几十行的命令行小工具:启动即计时,到点提醒,还能把每天的专注时长记下来。 一、功能设计这个小工具要做到四件事:自定义专注时长和休息时长,默认 25 分钟专注、5 分钟休息;计时过程中实时显示剩余时间;到点用声音和文字提醒;把每次完成的专注记录到本地 JSON 文...
番茄工作法把时间切成 25 分钟专注加 5 分钟休息的“番茄”,简单却很有效。与其装一个臃肿的 App,不如用 Python 写一个几十行的命令行小工具:启动即计时,到点提醒,还能把每天的专注时长记下来。
一、功能设计
这个小工具要做到四件事:
- 自定义专注时长和休息时长,默认 25 分钟专注、5 分钟休息;
- 计时过程中实时显示剩余时间;
- 到点用声音和文字提醒;
- 把每次完成的专注记录到本地 JSON 文件,支持查询当日累计专注时长。
二、完整代码
#!/usr/bin/env python3
"""番茄钟命令行小工具:定时、提醒、统计当日专注时长。
用法:
python tomato.py # 默认 25 分钟专注 + 5 分钟休息
python tomato.py -w 30 -b 5 # 30 分钟专注,5 分钟休息
python tomato.py --stats # 查看当日专注统计
"""
import argparse
import json
import os
import sys
import time
from datetime import date
DATA_FILE = os.path.join(os.path.expanduser("~"), ".tomato.json")
def load_data():
if not os.path.exists(DATA_FILE):
return {}
try:
with open(DATA_FILE, encoding="utf-8") as f:
return json.load(f)
except (json.JSONDecodeError, OSError):
return {}
def save_session(minutes):
data = load_data()
today = date.today().isoformat()
data.setdefault(today, []).append(minutes)
with open(DATA_FILE, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
def today_total():
data = load_data()
return sum(data.get(date.today().isoformat(), []))
def beep():
# 跨平台提醒:先响铃,再打印提示
print("\a", end="", flush=True)
if sys.platform == "win32":
try:
import winsound
winsound.Beep(880, 600)
except Exception:
pass
def countdown(minutes, label):
total = int(minutes * 60)
start = time.monotonic()
try:
while True:
elapsed = time.monotonic() - start
remain = total - int(elapsed)
if remain <= 0:
break
mm, ss = divmod(remain, 60)
print(f"\r{label} 剩余 {mm:02d}:{ss:02d}", end="", flush=True)
time.sleep(1)
except KeyboardInterrupt:
print("\n已中断。")
return False
print(f"\r{label} 完成!{' ' * 20}")
return True
def run(work=25, rest=5):
print(f"开始专注 {work} 分钟,输入 Ctrl+C 可随时退出。")
if countdown(work, "专注中"):
save_session(work)
beep()
print(f"专注完成!今日累计专注 {today_total()} 分钟。")
print(f"休息 {rest} 分钟,起来走走、喝口水。")
if countdown(rest, "休息中"):
beep()
print("休息结束,开始下一个番茄吧!")
def show_stats():
total = today_total()
count = len(load_data().get(date.today().isoformat(), []))
print(f"今日已完成 {count} 个番茄,累计专注 {total} 分钟。")
def main():
parser = argparse.ArgumentParser(description="番茄钟命令行小工具")
parser.add_argument("-w", "--work", type=int, default=25, help="专注时长(分钟)")
parser.add_argument("-b", "--break", dest="rest", type=int, default=5, help="休息时长(分钟)")
parser.add_argument("--stats", action="store_true", help="查看当日专注统计")
args = parser.parse_args()
if args.stats:
show_stats()
else:
run(args.work, args.rest)
if __name__ == "__main__":
main()
三、怎么运行
把上面的代码保存为 tomato.py,然后:
python tomato.py
python tomato.py -w 30 -b 5
python tomato.py --stats
上面三行命令分别是:默认 25 分钟专注加 5 分钟休息;30 分钟专注、5 分钟休息;查看当日专注统计。专注完成后,程序会把本次时长追加到主目录下的 .tomato.json 文件中,并打印当日累计专注分钟数。
四、几个关键点
- 用 time.monotonic() 而不是 time.time() 计时,避免系统时间被修改导致计时错乱;
- 捕获 KeyboardInterrupt,Ctrl+C 退出时提示“已中断”,不会把未完成的番茄计入统计;
- 提醒要跨平台:先用 print(“\a”) 响铃,Windows 下再用 winsound.Beep 补一声蜂鸣,macOS 也可以改成调用 say 命令;
- 数据文件用日期做 key,统计当日专注时长就是一次字典求和,简单可靠。
五、还能怎么扩展
- 长休息:每完成 4 个番茄,休息延长到 15 分钟;
- 加一个 --week 参数,打印本周每天的专注时长;
- 接入系统通知(Windows Toast 或 macOS 的 osascript),提醒更醒目。
短短一百行不到的代码,就能把“想专注”变成“可度量的专注”。先从一个番茄开始,今天的专注时长,就由它替你记下来。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)