这是为您生成的定时提醒并检查待办事项脚本，它是一个 Python 工具，能在后台运行，定期检查您设定的任务列表,并在任务到期时弹出通知。
#!/usr/bin/env python3
"""
定时提醒并检查待办事项脚本
功能：
1. 从 JSON 文件中加载待办事项（可指定时间，"2025-12-31 23:59"）
2. 每 30 秒检查一次是否有到期的任务（基于本地时间）
3. 如果有任务到期，通过系统通知（notify-send）提醒用户
4. 支持标记任务为已完成（从列表中移除）
5. 支持交互式添加新任务
6. 提供简单的命令行菜单
依赖：
- Python 3.6+
- Linux/Unix 环境（使用 notify-send 发送通知）
- 若使用 Windows/macOS，可自行替换通知方式（如 win10toast、pyobjc）
用法：
python todo_reminder.py # 启动提醒与检查
python todo_reminder.py --add # 添加新任务后立即退出
python todo_reminder.py --list # 列出所有待办事项
python todo_reminder.py --done <id> # 将指定 ID 的任务标记为完成
"""
import json
import os
import sys
import time
import argparse
from datetime import datetime
from threading import Thread, Event
# ---------- 配置 ----------
TODO_FILE = os.path.expanduser("~/.todo_reminder.json")
CHECK_INTERVAL = 30 # 检查间隔（秒）
# --------------------------
# 全局退出事件
exit_event = Event()
def load_tasks() -> list:
"""从 JSON 文件加载待办事项列表"""
if not os.path.exists(TODO_FILE):
return []
with open(TODO_FILE, "r", encoding="utf-8") as f:
try:
return json.load(f)
except json.JSONDecodeError:
print("警告：任务文件损坏，已重置为空列表。")
return []
def save_tasks(tasks: list):
"""保存待办事项列表到 JSON 文件"""
with open(TODO_FILE, "w", encoding="utf-8") as f:
json.dump(tasks, f, ensure_ascii=False, indent=2)
def notify(title: str, message: str):
"""发送系统通知（跨平台兼容处理）"""
# Linux 下使用 notify-send
if sys.platform.startswith("linux"):
try:
os.system(f'notify-send "{title}" "{message}"')
except Exception:
pass
# macOS 下使用 osascript
elif sys.platform == "darwin":
try:
os.system(f'osascript -e \'display notification "{message}" with title "{title}"\'')
except Exception:
pass
# Windows 下使用 win10toast（需安装：pip install win10toast）
elif sys.platform == "win32":
try:
from win10toast import ToastNotifier
toaster = ToastNotifier()
toaster.show_toast(title, message, duration=5)
except ImportError:
print(f"[通知] {title}: {message}")
else:
print(f"[通知] {title}: {message}")
def check_due_tasks(tasks: list) -> list:
"""检查所有到期任务，返回已到期的任务列表（同时自动移除重复提醒）"""
now = datetime.now().strftime("%Y-%m-%d %H:%M")
due_tasks = []
remaining = []
for task in tasks:
task_time = task.get("time", "")
if task_time and task_time <= now:
due_tasks.append(task)
else:
remaining.append(task)
return due_tasks, remaining
def show_tasks(tasks: list):
"""以编号形式显示所有待办事项"""
if not tasks:
print("✅ 当前没有待办事项。")
return
print(f"\n📋 待办事项列表（共 {len(tasks)} 项）：")
print("-" * 50)
for idx, task in enumerate(tasks, 1):
time_str = task.get("time", "无时间")
desc = task.get("desc", "无描述")
print(f" {idx}. [{time_str}] {desc}")
print("-" * 50)
def add_task_interactive():
"""交互式添加新任务"""
desc = input("请输入待办事项描述：").strip()
if not desc:
print("描述不能为空，取消添加。")
return
time_str = input("请输入截止时间（格式：YYYY-MM-DD HH:MM，留空表示不指定时间）：").strip()
if time_str:
try:
datetime.strptime(time_str, "%Y-%m-%d %H:%M")
except ValueError:
print("时间格式错误，请使用 YYYY-MM-DD HH:MM 格式。")
return
else:
time_str = "" # 无截止时间
tasks = load_tasks()
tasks.append({"desc": desc, "time": time_str})
save_tasks(tasks)
print(f"✅ 已添加待办事项：{desc}" + (f" (截止 {time_str})" if time_str else ""))
def mark_done(task_id: int):
"""根据序号标记任务为已完成（从列表移除）"""
tasks = load_tasks()
if task_id < 1 or task_id > len(tasks):
print(f"❌ 无效的任务编号：{task_id}，当前共有 {len(tasks)} 项。")
return
removed = tasks.pop(task_id - 1)
save_tasks(tasks)
print(f"✅ 已完成：{removed['desc']}" + (f" (截止 {removed['time']})" if removed['time'] else ""))
def periodic_check():
"""定时检查循环，直到退出事件被设置"""
print(f"⏰ 提醒服务已启动，每 {CHECK_INTERVAL} 秒检查一次到期任务...")
while not exit_event.is_set():
tasks = load_tasks()
due_tasks, remaining = check_due_tasks(tasks)
if due_tasks:
for task in due_tasks:
msg = f"任务：{task['desc']}"
if task.get("time"):
msg += f"\n截止时间：{task['time']}"
notify("⏰ 待办事项提醒", msg)
print(f"\n🔔 到期提醒：{task['desc']}" + (f" (截止 {task['time']})" if task['time'] else ""))
# 保存剩余任务（已移除到期任务）
save_tasks(remaining)
# 等待指定间隔，期间可被退出事件中断
exit_event.wait(CHECK_INTERVAL)
def main_loop():
"""主交互循环：在后台运行检查线程，并提供控制台菜单"""
# 启动后台检查线程
checker = Thread(target=periodic_check, daemon=True)
checker.start()
print("\n====== 待办事项提醒工具 ======")
print("命令：")
print(" list - 列出所有待办事项")
print(" add - 添加新待办事项")
print(" done n - 标记编号 n 的任务为完成")
print(" quit - 退出程序")
print("==============================")
try:
while True:
cmd = input("\n请输入命令：").strip().lower()
if cmd == "quit":
print("正在退出...")
exit_event.set()
break
elif cmd == "list":
tasks = load_tasks()
show_tasks(tasks)
elif cmd == "add":
add_task_interactive()
elif cmd.startswith("done "):
try:
task_id = int(cmd.split()[1])
mark_done(task_id)
except (IndexError, ValueError):
print("用法：done <编号>，done 3")
else:
print("未知命令，可用命令：list, add, done n, quit")
except KeyboardInterrupt:
print("\n用户中断，正在退出...")
exit_event.set()
if __name__ == "__main__":
parser = argparse.ArgumentParser(description="定时提醒并检查待办事项")
parser.add_argument("--add", action="store_true", help="添加新任务后立即退出")
parser.add_argument("--list", action="store_true", help="列出所有待办事项")
parser.add_argument("--done", type=int, metavar="ID", help="标记指定编号的任务为完成")
args = parser.parse_args()
# 处理命令行快捷操作
if args.add:
add_task_interactive()
elif args.list:
tasks = load_tasks()
show_tasks(tasks)
elif args.done is not None:
mark_done(args.done)
else:
# 启动主交互循环
main_loop()
功能与操作说明
您可以通过命令行菜单或参数来管理任务，脚本会持续在后台检查,并在任务到期时通过系统通知提醒您。
- 任务管理：您可以通过
add、list、done <编号>命令来添加、查看和完成待办事项，所有任务会保存在~/.todo_reminder.json文件中。 - 自动提醒：脚本启动后，会每30秒检查一次任务列表，当系统时间等于或超过任务的“截止时间”时，会自动发送系统通知,并将该任务从列表中移除。
- 灵活使用：您可以直接运行脚本进入交互模式，也可以使用
--add、--list、--done <ID>参数快速执行单项操作,方便集成到其他工作流中。
