用 Python 写一个番茄钟命令行小工具:定时、提醒与当日专注统计

举报
yd_252022162 发表于 2026/11/17 06:13:46 2026/11/17
【摘要】 番茄工作法把时间切成 25 分钟专注加 5 分钟休息的“番茄”,简单却很有效。与其装一个臃肿的 App,不如用 Python 写一个几十行的命令行小工具:启动即计时,到点提醒,还能把每天的专注时长记下来。 一、功能设计这个小工具要做到四件事:自定义专注时长和休息时长,默认 25 分钟专注、5 分钟休息;计时过程中实时显示剩余时间;到点用声音和文字提醒;把每次完成的专注记录到本地 JSON 文...

番茄工作法把时间切成 25 分钟专注加 5 分钟休息的“番茄”,简单却很有效。与其装一个臃肿的 App,不如用 Python 写一个几十行的命令行小工具:启动即计时,到点提醒,还能把每天的专注时长记下来。

一、功能设计

这个小工具要做到四件事:

  1. 自定义专注时长和休息时长,默认 25 分钟专注、5 分钟休息;
  2. 计时过程中实时显示剩余时间;
  3. 到点用声音和文字提醒;
  4. 把每次完成的专注记录到本地 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 文件中,并打印当日累计专注分钟数。

四、几个关键点

  1. 用 time.monotonic() 而不是 time.time() 计时,避免系统时间被修改导致计时错乱;
  2. 捕获 KeyboardInterrupt,Ctrl+C 退出时提示“已中断”,不会把未完成的番茄计入统计;
  3. 提醒要跨平台:先用 print(“\a”) 响铃,Windows 下再用 winsound.Beep 补一声蜂鸣,macOS 也可以改成调用 say 命令;
  4. 数据文件用日期做 key,统计当日专注时长就是一次字典求和,简单可靠。

五、还能怎么扩展

  • 长休息:每完成 4 个番茄,休息延长到 15 分钟;
  • 加一个 --week 参数,打印本周每天的专注时长;
  • 接入系统通知(Windows Toast 或 macOS 的 osascript),提醒更醒目。

短短一百行不到的代码,就能把“想专注”变成“可度量的专注”。先从一个番茄开始,今天的专注时长,就由它替你记下来。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。