快节奏的工作日程里“告别匆匆麻木的日常”并不是一句生活口号而是一个可以拆解的工程问题如何在忙碌的惯性中主动设置一些暂停点让自己回到对身体的感知和对当前任务的觉察。解决这个问题并不需要开发一个复杂 App只需要一套简单小方法定时触发的提醒、中英双语的语音朗读、可更换的文案以及一条能事后查看的日志。下面就把这一套方法落地成一个最小可运行的 Python 工具。整个项目不依赖大型框架核心代码控制在 100 行左右用 JSON 维护提醒内容通过系统 TTS文本转语音播报中文和英文最后接入 cron、launchd 或 Windows 任务计划程序。读者学完之后可以把工具部署到自己的电脑上也能根据实际需求扩展成手机通知、桌面弹窗或数据复盘。为了照顾不同水平的开发者会先解释原理再给完整代码最后列出常见坑和排查路径。1. 先理解这套方法在解决什么问题1.1 “麻木”是缺少觉察中断不是缺少提醒连续几个小时开会、写代码、刷消息之后注意力很容易进入“自动驾驶”状态。表面上还在处理任务实际上身体已经僵硬思维也停在同一条轨道上。这时候最需要的不是再多一条工作通知而是一个能打断行为循环的外部信号。手机通知可以打断但大多数通知内容是任务导向的“看一眼”“回一下”反而会加重惯性。真正有效的觉察中断应该满足三个条件在合适的时机出现、内容与当前任务无关、表达方式能让人慢下来。中英双语语音朗读就是为了满足第三点。语音比文字更容易穿透注意力而切换语言会稍微增加“信息加工负担”让大脑从自动处理模式切换回主动注意。1.2 为什么选择“中英配音”如果只做一次提醒中文或者英文都够用。但把中英双语放在一起有两个实际好处。第一中文是母语能快速触发意义英文用另一种语言重新表达同一句话会让大脑多一次解码过程相当于对提醒内容做了一次间隔强化。第二对于想保持英语语感的人这是一种低成本的环境输入。这里的“配音”不是人工录音而是通过 TTS 引擎把文本合成语音。实际项目中中文语音可以调用系统自带的中文语音包英文使用英文语音包也可以使用edge-tts这类在线服务。下文会给出方案对比。1.3 这套小方法最终落地成什么最终会得到一个目录包含一个提醒文案文件、一个 Python 播报脚本和一个日志文件。运行逻辑是系统定时任务每分钟调用一次脚本脚本检查当前时间是否命中 JSON 中配置的时间点如果命中就从候选文案中随机选一条先用中文朗读再用英文朗读并把触发时间和文案记录到日志。整个过程不依赖图形界面不常驻内存失败时可以通过日志回溯原因。后续扩展方向包括把日志汇总成每日复盘、把提醒内容推送到手机、根据星期几使用不同文案。但第一次落地时建议先用最简版本跑通再逐步加功能。2. 准备环境并确认本机 TTS 可用2.1 运行环境要求基础版本使用 Python 3.8 及以上不需要安装第三方库。不同操作系统的差异主要集中在 TTS 命令上下表可以直接作为选型速查操作系统默认 TTS 方式中文支持备注macOSsay取决于系统语音包需要先确认已安装中文语音WindowsPowerShellSystem.Speech部分系统有中文语音包通过Add-Type加载Linuxespeak/espeak-ng支持中文音质一般需要安装espeak跨平台edge-tts生成 MP3 后播放中文语音自然需要网络和额外播放器生产环境建议把“系统 TTS 播放”和“在线 TTS 合成”分开。系统 TTS 离线可用但音质和语言支持不稳定在线 TTS 音质好但需要网络且受服务可用性影响。脚本里可以保留一个开关按实际需求切换。2.2 快速验证系统 TTS 是否可用在写代码之前先手动执行系统命令确认当前电脑具备中英文朗读能力。如果命令能出声后续脚本大概率没问题如果听不到声音再考虑安装语音包或改用在线方案。# macOS 中文 / 英文 say -v Tingting 你好请停下来深呼吸 say -v Samantha Stop and take a breath# Ubuntu / Debian 安装 espeak sudo apt install espeak espeak -v zh 你好请停下来深呼吸# Windows PowerShell注意避免引号冲突 powershell -Command Add-Type -AssemblyName System.Speech; $s New-Object System.Speech.Synthesis.SpeechSynthesizer; $s.Speak(你好); $s.Speak(Hello)如果中文语音不可用macOS 可以到“系统设置 - 辅助功能 - 朗读内容 - 系统声音”里添加中文语音Windows 可以在“设置 - 时间和语言 - 语音”中安装中文语音包。具体入口随操作系统版本不同而变化以当前系统界面为准。2.3 初始化项目目录创建一个干净目录后续脚本和配置文件都放在这里避免定时任务因为路径不清晰而出错。mkdir -p ~/daily-mindfulness cd ~/daily-mindfulness python3 --version项目目录规划如下daily-mindfulness/ ├── reminders.json # 提醒时间表和文案 ├── reminder.py # 核心播报脚本 ├── reminder.log # 运行日志自动生成 └── install_cron.sh # Linux/macOS 定时任务安装脚本可选把文案和代码分离是为了不用改代码就能调整提醒时间和措辞。即使完全不懂 Python也能通过编辑 JSON 文件维护自己的提醒库。3. 用 Python 和 JSON 写中英文提醒脚本3.1 使用 JSON 管理提醒文案和播放时间创建reminders.json先写三条基础的提醒内容{ reminders: [ { time: 10:00, items: [ { zh: 停下来做三次深呼吸。, en: Stop and take three deep breaths. }, { zh: 看看窗外找一个让你放松的颜色。, en: Look outside and find a color that relaxes you. } ] }, { time: 14:30, items: [ { zh: 喝一口水活动一下肩膀。, en: Drink some water and roll your shoulders. } ] }, { time: 17:00, items: [ { zh: 记录一件今天值得感谢的小事。, en: Write down one small thing you appreciate today. } ] } ] }这个结构包含两级数组第一级是时间点第二级是同一时间点下可能出现的多条文案。脚本命中时间点后会随机选一条。这样每天同一时刻听到的提醒不完全一样避免文案本身也被“麻木”掉。如果某天不想要某个时间点直接移除 JSON 里对应项即可。3.2 编写核心播报脚本创建reminder.py下面是一个最小但可运行的版本#!/usr/bin/env python3 # -*- coding: utf-8 -*- daily-mindfulness reminder 用法: python3 reminder.py # 匹配当前时间命中则播报 python3 reminder.py --force # 忽略时间随机播报一条用于测试 import json import platform import random import subprocess import sys from datetime import datetime from pathlib import Path BASE_DIR Path(__file__).resolve().parent REMINDER_FILE BASE_DIR / reminders.json LOG_FILE BASE_DIR / reminder.log def speak(text, lang): 使用本机 TTS 播报lang 取值为 zh 或 en。 if not text: return system platform.system() if system Darwin: voice Tingting if lang zh else Samantha subprocess.run([say, -v, voice, text]) elif system Windows: safe_text text.replace(, ) ps_cmd ( Add-Type -AssemblyName System.Speech; $s New-Object System.Speech.Synthesis.SpeechSynthesizer; f$s.Speak({safe_text}) ) subprocess.run([powershell, -NoProfile, -Command, ps_cmd]) elif system Linux: voice zh if lang zh else en subprocess.run([espeak, -v, voice, text]) else: print(f[{lang}] {text}) def log_message(message): ts datetime.now().strftime(%Y-%m-%d %H:%M:%S) line f[{ts}] {message} print(line) with open(LOG_FILE, a, encodingutf-8) as f: f.write(line \n) def load_reminders(): with open(REMINDER_FILE, r, encodingutf-8) as f: return json.load(f)[reminders] def run(): reminders load_reminders() force --force in sys.argv if force: item random.choice(reminders) else: current datetime.now().strftime(%H:%M) matched [r for r in reminders if r[time] current] if not matched: log_message(fno reminder at {current}) return item random.choice(matched) items item.get(items, []) if not items: log_message(this reminder has no items, skip) return choice random.choice(items) log_message(ftrigger {item[time]} - {choice[zh]}) speak(choice[zh], zh) speak(choice[en], en) log_message(play done) if __name__ __main__: try: run() except Exception as e: log_message(freminder crashed: {e}) sys.exit(1)这段代码做了几件关键事情通过platform.system()判断操作系统分平台调用不同 TTS 命令。subprocess.run是同步阻塞的脚本会等语音播放完再退出避免多个定时任务同时播报。--force参数用来手动测试不依赖当前时间。日志写在项目目录下方便排查“提醒是否触发”“播放是否成功”。外层try/except捕获异常并写入日志脚本不会因为某一次 TTS 失败而完全无迹可查。注意Windows 下的 PowerShell 单引号转义只处理了英文单引号。如果文案中出现其他特殊字符需要结合实际文案补充处理。更稳妥的做法是避免在文案中使用单引号、反引号和$这类容易造成命令拼接问题的字符。3.3 优化中文语音可选接入 edge-tts如果本机中文语音效果不理想可以改用edge-tts。这个库调用在线语音合成接口生成的 MP3 音质比espeak好很多中文语音也更自然。安装命令pip install edge-tts在reminder.py中加入一个可选函数def speak_with_edge_tts(text, lang): import asyncio import edge_tts from pathlib import Path voice zh-CN-XiaoxiaoNeural if lang zh else en-US-JennyNeural out_file BASE_DIR / tmp_speech.mp3 async def generate_and_play(): communicate edge_tts.Communicate(text, voice) await communicate.save(str(out_file)) if platform.system() Darwin: subprocess.run([afplay, str(out_file)]) elif platform.system() Windows: subprocess.run([ffplay, -nodisp, -autoexit, str(out_file)]) else: subprocess.run([ffplay, -nodisp, -autoexit, str(out_file)]) try: asyncio.run(generate_and_play()) Path(out_file).unlink(missing_okTrue) return True except Exception as e: log_message(fedge-tts failed: {e}) return False使用在线 TTS 时要注意首次运行需要联网需要安装edge-tts并且 Linux 和 Windows 上需要有ffplay来自 ffmpeg或mpg123这类 MP3 播放器。如果只是为了本地快速体验可以先跳过这个函数等确认基础功能正常后再接入。3.4 手动运行并验证先做一次强制播报cd ~/daily-mindfulness python3 reminder.py --force预期输出日志里出现一条trigger ...和play done然后听到中文和英文两句话。如果没有任何声音先回到 2.2 节手动验证 TTS 命令是否可用。再验证时间匹配逻辑。可以临时把reminders.json里一个时间改成当前时间后 1 分钟然后手动执行date %H:%M python3 reminder.py如果当前时间没有配置提醒日志会输出no reminder at ...退出码为 0。这一点很重要因为定时任务每分钟都会运行没有命中时也必须正常退出而不是抛异常。4. 接入 cron、launchd 或任务计划程序4.1 Linux 与 macOS使用 cron 是最快的方案在 macOS 和 Linux 上cron 是最常见的定时方式。先确认当前用户可以操作 croncrontab -l然后创建一个安装脚本install_cron.sh#!/usr/bin/env bash PROJECT_DIR$HOME/daily-mindfulness CRON_LINE* * * * * cd $PROJECT_DIR /usr/bin/python3 reminder.py $PROJECT_DIR/cron.log 21 (crontab -l 2/dev/null | grep -v daily-mindfulness/reminder.py; echo $CRON_LINE) | crontab - echo crontab installed执行安装chmod x install_cron.sh ./install_cron.sh crontab -l这里让 cron 每分钟运行一次脚本。脚本内部会判断当前时间是否命中所以每分钟执行不会导致重复播报。 cron.log 21是为了在 cron 调用异常时保留错误输出。macOS 用户可以继续使用 cron。如果更倾向 launchd可以创建com.daily.mindfulness.plist放到~/Library/LaunchAgents并通过launchctl load加载。launchd 的优势是持久化和开机自启更彻底但对普通用户来说cron 已经足够。4.2 Windows使用任务计划程序Windows 下不需要写复杂脚本直接在“任务计划程序”中新建任务触发器设为“每天”开始时间设置为较早时间重复任务间隔设置为 1 分钟持续时间设置为 1 天。操作选择“启动程序”程序填python.exe的完整路径参数填reminder.py起始于填项目目录。条件中取消“只有在计算机使用交流电源时才启动此任务”的勾选避免笔记本断电时不提醒。命令行创建方式容易因为用户权限和路径问题失败新手建议先用图形界面。Python 解释器路径可以通过where python查看项目路径尽量使用英文避免中文路径导致编码问题。4.3 防止重复提醒和漏提醒脚本被定时任务每分钟执行一次理论上不会重复。但要注意cron 或任务计划程序启动脚本后reminder.py会阻塞到语音播放完成。如果播放时间较长下一次触发可能重叠。电脑休眠时定时任务可能被跳过。醒来后如果正好错过了时间点可以增加“补发”逻辑。长时间运行后可能会因为异常退出留下锁文件导致后续任务被跳过。一个简单的运行锁实现可以在run()调用前加import time LOCK_FILE BASE_DIR / reminder.lock if LOCK_FILE.exists(): age time.time() - LOCK_FILE.stat().st_mtime if age 600: LOCK_FILE.unlink() else: sys.exit(0) LOCK_FILE.touch() try: run() finally: LOCK_FILE.unlink(missing_okTrue)这个锁只在脚本运行期间存在。如果脚本被kill -9或断电锁文件会残留。因此启动时检查锁文件的修改时间超过 10 分钟就认为是残留并删除。这样既能防止重叠又能避免永久阻塞。5. 把定时任务异常一条条查清楚5.1 有日志说明已触发但听不到声音现象reminder.log中出现了trigger和play done但电脑没有出声。排查顺序手动执行 2.2 中的系统 TTS 命令确认系统音量、输出设备、语音包是否正常。检查脚本中使用的 TTS 命令是否在当前系统 PATH 中。例如 Linux 未安装espeaksubprocess.run会抛出FileNotFoundError外层异常处理会记录到日志不会出现play done。如果出现了play done说明命令执行成功需要检查音频输出。如果使用edge-tts方案确认播放器命令是否可用。常见原因和处理建议现象常见原因检查方式处理建议命令执行成功但无声系统音量静音或输出设备错误播放一首普通音乐测试调整系统音量或输出设备Linux 报espeak: command not foundespeak 未安装执行which espeaksudo apt install espeakWindows 中文发音奇怪默认 TTS 语音包只支持英文列出语音(New-Object System.Speech.Synthesis.SpeechSynthesizer).GetInstalledVoices()安装中文语音包或改用 edge-ttsmacOS 中文语音不可用未安装 Tingting 语音执行say -v ?查看可用语音在系统设置中下载中文语音5.2 定时任务没有执行现象手动运行python3 reminder.py有声音但到时间后没有提醒日志也没有新增。排查顺序先手动运行一次定时任务里的完整命令确认项目路径和 Python 路径都正确。查看 cron 日志或任务计划程序历史记录。确认脚本有执行权限chmod x reminder.py。确认 cron 环境中是否有 GUI 会话。macOS 的say需要用户登录后才能正常调用如果使用 launchd需要设置RunAtLoad和用户域。确认 cron 的 PATH 是否太窄。cron 默认 PATH 很短脚本里最好使用绝对路径或在 cron 行里显式设置 PATHPATH/usr/local/bin:/usr/bin:/bin * * * * * cd /home/你的用户名/daily-mindfulness python3 reminder.py cron.log 21如果是 Windows 任务计划程序还要检查“登录时是否运行”和程序路径是否为绝对路径。5.3 中文和英文文案顺序不对或语言识别错误现象播放时只有一种语言或者中文被读成英文。可能原因macOS 的say -v Tingting只适用于中文语音如果系统没有该语音say会报错或回退到默认语音。建议先用say -v ?确认可用 voice 名称。Linux 的espeak -v zh对中文支持有限某些发行版需要安装espeak-ng。Windows 的 PowerShell 脚本里SpeechSynthesizer 默认使用系统默认语音。如果默认语音是英文即使传入中文也可能按英文规则读取。推荐处理方式在脚本中显式选择语音或者统一改用edge-tts。edge-tts的语音名是确定的中文使用zh-CN-XiaoxiaoNeural英文使用en-US-JennyNeural语言识别更稳定。5.4 锁文件残留导致后续任务被跳过现象配置了运行锁后某个时间点之后所有任务都不再触发。原因脚本被kill -9或电脑断电临时锁文件没有被清理。处理方式启动时检查锁文件的修改时间超过 10 分钟视为残留并删除。在锁文件中写入进程 PID 和创建时间方便定位问题。尽量避免使用kill -9结束脚本正常结束会触发finally清理。这是定时任务类脚本最常见的隐性故障。第一次部署后建议连续观察两三天确保锁文件不会残留。6. 从“语音提醒”扩展到“行动日志”6.1 记录提醒后的状态形成每日复盘语音提醒只是第一步。要让提醒真正改变日常节奏可以在每次提醒后花 30 秒做一个小小的记录。比如在项目目录下增加一个mood.csv脚本每次播放完成后追加一行2025-04-01 10:00,深呼吸,平静 2025-04-01 14:30,喝水,有点疲惫这个 CSV 可以用 Excel 或 Python 汇总成每周趋势。如果不想写代码也可以让提醒只承担“打断”功能结束后自己动手写一句日记。工具的价值是降低启动成本而不是替代人的行为。6.2 把提醒接入手机通知如果人不在电脑前语音提醒就听不到。可以改用手机通知方案例如macOS 的osascript发送通知到 iPhone。使用 Webhook 服务在脚本触发时向手机推送文本。在手机上设置重复闹钟或快捷指令执行同一组中英文语音朗读。考虑到不同服务的使用条款和稳定性这里不展开具体服务配置只说明思路核心脚本的“匹配时间 选择文案 发送”逻辑可以复用只需把speak()替换为notify()。6.3 后续扩展方向这个最小工具可以扩展成按星期、日期使用不同文案。根据天气、日程、专注时长动态生成提醒。把提醒日志接入可视化面板统计“今天被打断了多少次”。用tkinter做一个桌面弹窗同时显示中英文文案。把文案库换成自己的学习内容做成中英文听力练习工具。扩展时保持“简单”原则。功能越多维护成本越高反而会失去提醒工具的本意。第一次落地可以直接用最简版本跑起来后再逐步加功能。7. 可落地的最佳实践和检查清单7.1 部署前检查清单在把脚本交给定时任务之前建议按下面的清单逐项确认[ ] Python 版本不低于 3.8python3 --version能输出版本号。[ ] 系统 TTS 命令手动执行有声音。[ ]reminders.json中所有文案都不包含单引号、双引号等容易引发命令拼接问题的字符。[ ]python3 /完整路径/reminder.py --force能听到中英文两段声音。[ ]reminder.log和cron.log所在目录可写。[ ] 定时任务使用绝对路径而不是相对路径。[ ] 第一次配置任务后手动把某个提醒时间改成下一分钟验证自动触发。[ ] 如果使用锁文件确认异常退出后能自动恢复。7.2 文案和播放策略建议文案不要写成“继续加油”“快完成今天的 KPI”这类内容会服务于工作惯性。建议写与当下身体感受、环境观察、情绪状态相关的句子例如“感受脚底和地面的接触”“看看天空现在是什么颜色”。同一时间点准备多条文案让脚本随机选择避免误以为“又是一个通知”。中英文句子不需要逐字对译只要表达同一个提醒意图即可。英文句子故意换一种说法可以提高听完后的注意力。提醒时间不要过于密集。建议上午、下午各 1 到 2 次频率太高会变成新的噪音。7.3 代码健壮性建议在实际项目中脚本还需要考虑使用try/except捕获 TTS 命令异常避免FileNotFoundError让整个脚本崩溃。不要使用裸except至少区分FileNotFoundError、TimeoutExpired等异常类型。日志中记录触发时间、所选的文案、播放耗时方便分析固定时间点是否有异常。如果播放文本包含用户输入不要直接拼接到subprocess.run的命令字符串中优先使用参数列表传递避免特殊字符导致命令注入。使用在线 TTS 时要处理网络超时、限流和临时文件清理。这套“简单小方法”并不是要把生活变成自动化流水线而是在自动化能力和人类觉察之间做一个平衡点。定时提醒、中英双语朗读、文案轮换和日志复盘四件事合在一起最终让每个普通工作日多出几次重新选择注意力的机会。对新手来说最佳练习方式不是直接做完整的多端同步系统而是先把这个 100 行脚本跑通连续使用一周观察哪些时间点最容易被自己接受再根据记录调整文案和频率。当提醒次数减少、觉察次数增加时工具就算真正到位了。
用Python打造中英双语语音提醒工具，定时唤醒正念觉察
快节奏的工作日程里“告别匆匆麻木的日常”并不是一句生活口号而是一个可以拆解的工程问题如何在忙碌的惯性中主动设置一些暂停点让自己回到对身体的感知和对当前任务的觉察。解决这个问题并不需要开发一个复杂 App只需要一套简单小方法定时触发的提醒、中英双语的语音朗读、可更换的文案以及一条能事后查看的日志。下面就把这一套方法落地成一个最小可运行的 Python 工具。整个项目不依赖大型框架核心代码控制在 100 行左右用 JSON 维护提醒内容通过系统 TTS文本转语音播报中文和英文最后接入 cron、launchd 或 Windows 任务计划程序。读者学完之后可以把工具部署到自己的电脑上也能根据实际需求扩展成手机通知、桌面弹窗或数据复盘。为了照顾不同水平的开发者会先解释原理再给完整代码最后列出常见坑和排查路径。1. 先理解这套方法在解决什么问题1.1 “麻木”是缺少觉察中断不是缺少提醒连续几个小时开会、写代码、刷消息之后注意力很容易进入“自动驾驶”状态。表面上还在处理任务实际上身体已经僵硬思维也停在同一条轨道上。这时候最需要的不是再多一条工作通知而是一个能打断行为循环的外部信号。手机通知可以打断但大多数通知内容是任务导向的“看一眼”“回一下”反而会加重惯性。真正有效的觉察中断应该满足三个条件在合适的时机出现、内容与当前任务无关、表达方式能让人慢下来。中英双语语音朗读就是为了满足第三点。语音比文字更容易穿透注意力而切换语言会稍微增加“信息加工负担”让大脑从自动处理模式切换回主动注意。1.2 为什么选择“中英配音”如果只做一次提醒中文或者英文都够用。但把中英双语放在一起有两个实际好处。第一中文是母语能快速触发意义英文用另一种语言重新表达同一句话会让大脑多一次解码过程相当于对提醒内容做了一次间隔强化。第二对于想保持英语语感的人这是一种低成本的环境输入。这里的“配音”不是人工录音而是通过 TTS 引擎把文本合成语音。实际项目中中文语音可以调用系统自带的中文语音包英文使用英文语音包也可以使用edge-tts这类在线服务。下文会给出方案对比。1.3 这套小方法最终落地成什么最终会得到一个目录包含一个提醒文案文件、一个 Python 播报脚本和一个日志文件。运行逻辑是系统定时任务每分钟调用一次脚本脚本检查当前时间是否命中 JSON 中配置的时间点如果命中就从候选文案中随机选一条先用中文朗读再用英文朗读并把触发时间和文案记录到日志。整个过程不依赖图形界面不常驻内存失败时可以通过日志回溯原因。后续扩展方向包括把日志汇总成每日复盘、把提醒内容推送到手机、根据星期几使用不同文案。但第一次落地时建议先用最简版本跑通再逐步加功能。2. 准备环境并确认本机 TTS 可用2.1 运行环境要求基础版本使用 Python 3.8 及以上不需要安装第三方库。不同操作系统的差异主要集中在 TTS 命令上下表可以直接作为选型速查操作系统默认 TTS 方式中文支持备注macOSsay取决于系统语音包需要先确认已安装中文语音WindowsPowerShellSystem.Speech部分系统有中文语音包通过Add-Type加载Linuxespeak/espeak-ng支持中文音质一般需要安装espeak跨平台edge-tts生成 MP3 后播放中文语音自然需要网络和额外播放器生产环境建议把“系统 TTS 播放”和“在线 TTS 合成”分开。系统 TTS 离线可用但音质和语言支持不稳定在线 TTS 音质好但需要网络且受服务可用性影响。脚本里可以保留一个开关按实际需求切换。2.2 快速验证系统 TTS 是否可用在写代码之前先手动执行系统命令确认当前电脑具备中英文朗读能力。如果命令能出声后续脚本大概率没问题如果听不到声音再考虑安装语音包或改用在线方案。# macOS 中文 / 英文 say -v Tingting 你好请停下来深呼吸 say -v Samantha Stop and take a breath# Ubuntu / Debian 安装 espeak sudo apt install espeak espeak -v zh 你好请停下来深呼吸# Windows PowerShell注意避免引号冲突 powershell -Command Add-Type -AssemblyName System.Speech; $s New-Object System.Speech.Synthesis.SpeechSynthesizer; $s.Speak(你好); $s.Speak(Hello)如果中文语音不可用macOS 可以到“系统设置 - 辅助功能 - 朗读内容 - 系统声音”里添加中文语音Windows 可以在“设置 - 时间和语言 - 语音”中安装中文语音包。具体入口随操作系统版本不同而变化以当前系统界面为准。2.3 初始化项目目录创建一个干净目录后续脚本和配置文件都放在这里避免定时任务因为路径不清晰而出错。mkdir -p ~/daily-mindfulness cd ~/daily-mindfulness python3 --version项目目录规划如下daily-mindfulness/ ├── reminders.json # 提醒时间表和文案 ├── reminder.py # 核心播报脚本 ├── reminder.log # 运行日志自动生成 └── install_cron.sh # Linux/macOS 定时任务安装脚本可选把文案和代码分离是为了不用改代码就能调整提醒时间和措辞。即使完全不懂 Python也能通过编辑 JSON 文件维护自己的提醒库。3. 用 Python 和 JSON 写中英文提醒脚本3.1 使用 JSON 管理提醒文案和播放时间创建reminders.json先写三条基础的提醒内容{ reminders: [ { time: 10:00, items: [ { zh: 停下来做三次深呼吸。, en: Stop and take three deep breaths. }, { zh: 看看窗外找一个让你放松的颜色。, en: Look outside and find a color that relaxes you. } ] }, { time: 14:30, items: [ { zh: 喝一口水活动一下肩膀。, en: Drink some water and roll your shoulders. } ] }, { time: 17:00, items: [ { zh: 记录一件今天值得感谢的小事。, en: Write down one small thing you appreciate today. } ] } ] }这个结构包含两级数组第一级是时间点第二级是同一时间点下可能出现的多条文案。脚本命中时间点后会随机选一条。这样每天同一时刻听到的提醒不完全一样避免文案本身也被“麻木”掉。如果某天不想要某个时间点直接移除 JSON 里对应项即可。3.2 编写核心播报脚本创建reminder.py下面是一个最小但可运行的版本#!/usr/bin/env python3 # -*- coding: utf-8 -*- daily-mindfulness reminder 用法: python3 reminder.py # 匹配当前时间命中则播报 python3 reminder.py --force # 忽略时间随机播报一条用于测试 import json import platform import random import subprocess import sys from datetime import datetime from pathlib import Path BASE_DIR Path(__file__).resolve().parent REMINDER_FILE BASE_DIR / reminders.json LOG_FILE BASE_DIR / reminder.log def speak(text, lang): 使用本机 TTS 播报lang 取值为 zh 或 en。 if not text: return system platform.system() if system Darwin: voice Tingting if lang zh else Samantha subprocess.run([say, -v, voice, text]) elif system Windows: safe_text text.replace(, ) ps_cmd ( Add-Type -AssemblyName System.Speech; $s New-Object System.Speech.Synthesis.SpeechSynthesizer; f$s.Speak({safe_text}) ) subprocess.run([powershell, -NoProfile, -Command, ps_cmd]) elif system Linux: voice zh if lang zh else en subprocess.run([espeak, -v, voice, text]) else: print(f[{lang}] {text}) def log_message(message): ts datetime.now().strftime(%Y-%m-%d %H:%M:%S) line f[{ts}] {message} print(line) with open(LOG_FILE, a, encodingutf-8) as f: f.write(line \n) def load_reminders(): with open(REMINDER_FILE, r, encodingutf-8) as f: return json.load(f)[reminders] def run(): reminders load_reminders() force --force in sys.argv if force: item random.choice(reminders) else: current datetime.now().strftime(%H:%M) matched [r for r in reminders if r[time] current] if not matched: log_message(fno reminder at {current}) return item random.choice(matched) items item.get(items, []) if not items: log_message(this reminder has no items, skip) return choice random.choice(items) log_message(ftrigger {item[time]} - {choice[zh]}) speak(choice[zh], zh) speak(choice[en], en) log_message(play done) if __name__ __main__: try: run() except Exception as e: log_message(freminder crashed: {e}) sys.exit(1)这段代码做了几件关键事情通过platform.system()判断操作系统分平台调用不同 TTS 命令。subprocess.run是同步阻塞的脚本会等语音播放完再退出避免多个定时任务同时播报。--force参数用来手动测试不依赖当前时间。日志写在项目目录下方便排查“提醒是否触发”“播放是否成功”。外层try/except捕获异常并写入日志脚本不会因为某一次 TTS 失败而完全无迹可查。注意Windows 下的 PowerShell 单引号转义只处理了英文单引号。如果文案中出现其他特殊字符需要结合实际文案补充处理。更稳妥的做法是避免在文案中使用单引号、反引号和$这类容易造成命令拼接问题的字符。3.3 优化中文语音可选接入 edge-tts如果本机中文语音效果不理想可以改用edge-tts。这个库调用在线语音合成接口生成的 MP3 音质比espeak好很多中文语音也更自然。安装命令pip install edge-tts在reminder.py中加入一个可选函数def speak_with_edge_tts(text, lang): import asyncio import edge_tts from pathlib import Path voice zh-CN-XiaoxiaoNeural if lang zh else en-US-JennyNeural out_file BASE_DIR / tmp_speech.mp3 async def generate_and_play(): communicate edge_tts.Communicate(text, voice) await communicate.save(str(out_file)) if platform.system() Darwin: subprocess.run([afplay, str(out_file)]) elif platform.system() Windows: subprocess.run([ffplay, -nodisp, -autoexit, str(out_file)]) else: subprocess.run([ffplay, -nodisp, -autoexit, str(out_file)]) try: asyncio.run(generate_and_play()) Path(out_file).unlink(missing_okTrue) return True except Exception as e: log_message(fedge-tts failed: {e}) return False使用在线 TTS 时要注意首次运行需要联网需要安装edge-tts并且 Linux 和 Windows 上需要有ffplay来自 ffmpeg或mpg123这类 MP3 播放器。如果只是为了本地快速体验可以先跳过这个函数等确认基础功能正常后再接入。3.4 手动运行并验证先做一次强制播报cd ~/daily-mindfulness python3 reminder.py --force预期输出日志里出现一条trigger ...和play done然后听到中文和英文两句话。如果没有任何声音先回到 2.2 节手动验证 TTS 命令是否可用。再验证时间匹配逻辑。可以临时把reminders.json里一个时间改成当前时间后 1 分钟然后手动执行date %H:%M python3 reminder.py如果当前时间没有配置提醒日志会输出no reminder at ...退出码为 0。这一点很重要因为定时任务每分钟都会运行没有命中时也必须正常退出而不是抛异常。4. 接入 cron、launchd 或任务计划程序4.1 Linux 与 macOS使用 cron 是最快的方案在 macOS 和 Linux 上cron 是最常见的定时方式。先确认当前用户可以操作 croncrontab -l然后创建一个安装脚本install_cron.sh#!/usr/bin/env bash PROJECT_DIR$HOME/daily-mindfulness CRON_LINE* * * * * cd $PROJECT_DIR /usr/bin/python3 reminder.py $PROJECT_DIR/cron.log 21 (crontab -l 2/dev/null | grep -v daily-mindfulness/reminder.py; echo $CRON_LINE) | crontab - echo crontab installed执行安装chmod x install_cron.sh ./install_cron.sh crontab -l这里让 cron 每分钟运行一次脚本。脚本内部会判断当前时间是否命中所以每分钟执行不会导致重复播报。 cron.log 21是为了在 cron 调用异常时保留错误输出。macOS 用户可以继续使用 cron。如果更倾向 launchd可以创建com.daily.mindfulness.plist放到~/Library/LaunchAgents并通过launchctl load加载。launchd 的优势是持久化和开机自启更彻底但对普通用户来说cron 已经足够。4.2 Windows使用任务计划程序Windows 下不需要写复杂脚本直接在“任务计划程序”中新建任务触发器设为“每天”开始时间设置为较早时间重复任务间隔设置为 1 分钟持续时间设置为 1 天。操作选择“启动程序”程序填python.exe的完整路径参数填reminder.py起始于填项目目录。条件中取消“只有在计算机使用交流电源时才启动此任务”的勾选避免笔记本断电时不提醒。命令行创建方式容易因为用户权限和路径问题失败新手建议先用图形界面。Python 解释器路径可以通过where python查看项目路径尽量使用英文避免中文路径导致编码问题。4.3 防止重复提醒和漏提醒脚本被定时任务每分钟执行一次理论上不会重复。但要注意cron 或任务计划程序启动脚本后reminder.py会阻塞到语音播放完成。如果播放时间较长下一次触发可能重叠。电脑休眠时定时任务可能被跳过。醒来后如果正好错过了时间点可以增加“补发”逻辑。长时间运行后可能会因为异常退出留下锁文件导致后续任务被跳过。一个简单的运行锁实现可以在run()调用前加import time LOCK_FILE BASE_DIR / reminder.lock if LOCK_FILE.exists(): age time.time() - LOCK_FILE.stat().st_mtime if age 600: LOCK_FILE.unlink() else: sys.exit(0) LOCK_FILE.touch() try: run() finally: LOCK_FILE.unlink(missing_okTrue)这个锁只在脚本运行期间存在。如果脚本被kill -9或断电锁文件会残留。因此启动时检查锁文件的修改时间超过 10 分钟就认为是残留并删除。这样既能防止重叠又能避免永久阻塞。5. 把定时任务异常一条条查清楚5.1 有日志说明已触发但听不到声音现象reminder.log中出现了trigger和play done但电脑没有出声。排查顺序手动执行 2.2 中的系统 TTS 命令确认系统音量、输出设备、语音包是否正常。检查脚本中使用的 TTS 命令是否在当前系统 PATH 中。例如 Linux 未安装espeaksubprocess.run会抛出FileNotFoundError外层异常处理会记录到日志不会出现play done。如果出现了play done说明命令执行成功需要检查音频输出。如果使用edge-tts方案确认播放器命令是否可用。常见原因和处理建议现象常见原因检查方式处理建议命令执行成功但无声系统音量静音或输出设备错误播放一首普通音乐测试调整系统音量或输出设备Linux 报espeak: command not foundespeak 未安装执行which espeaksudo apt install espeakWindows 中文发音奇怪默认 TTS 语音包只支持英文列出语音(New-Object System.Speech.Synthesis.SpeechSynthesizer).GetInstalledVoices()安装中文语音包或改用 edge-ttsmacOS 中文语音不可用未安装 Tingting 语音执行say -v ?查看可用语音在系统设置中下载中文语音5.2 定时任务没有执行现象手动运行python3 reminder.py有声音但到时间后没有提醒日志也没有新增。排查顺序先手动运行一次定时任务里的完整命令确认项目路径和 Python 路径都正确。查看 cron 日志或任务计划程序历史记录。确认脚本有执行权限chmod x reminder.py。确认 cron 环境中是否有 GUI 会话。macOS 的say需要用户登录后才能正常调用如果使用 launchd需要设置RunAtLoad和用户域。确认 cron 的 PATH 是否太窄。cron 默认 PATH 很短脚本里最好使用绝对路径或在 cron 行里显式设置 PATHPATH/usr/local/bin:/usr/bin:/bin * * * * * cd /home/你的用户名/daily-mindfulness python3 reminder.py cron.log 21如果是 Windows 任务计划程序还要检查“登录时是否运行”和程序路径是否为绝对路径。5.3 中文和英文文案顺序不对或语言识别错误现象播放时只有一种语言或者中文被读成英文。可能原因macOS 的say -v Tingting只适用于中文语音如果系统没有该语音say会报错或回退到默认语音。建议先用say -v ?确认可用 voice 名称。Linux 的espeak -v zh对中文支持有限某些发行版需要安装espeak-ng。Windows 的 PowerShell 脚本里SpeechSynthesizer 默认使用系统默认语音。如果默认语音是英文即使传入中文也可能按英文规则读取。推荐处理方式在脚本中显式选择语音或者统一改用edge-tts。edge-tts的语音名是确定的中文使用zh-CN-XiaoxiaoNeural英文使用en-US-JennyNeural语言识别更稳定。5.4 锁文件残留导致后续任务被跳过现象配置了运行锁后某个时间点之后所有任务都不再触发。原因脚本被kill -9或电脑断电临时锁文件没有被清理。处理方式启动时检查锁文件的修改时间超过 10 分钟视为残留并删除。在锁文件中写入进程 PID 和创建时间方便定位问题。尽量避免使用kill -9结束脚本正常结束会触发finally清理。这是定时任务类脚本最常见的隐性故障。第一次部署后建议连续观察两三天确保锁文件不会残留。6. 从“语音提醒”扩展到“行动日志”6.1 记录提醒后的状态形成每日复盘语音提醒只是第一步。要让提醒真正改变日常节奏可以在每次提醒后花 30 秒做一个小小的记录。比如在项目目录下增加一个mood.csv脚本每次播放完成后追加一行2025-04-01 10:00,深呼吸,平静 2025-04-01 14:30,喝水,有点疲惫这个 CSV 可以用 Excel 或 Python 汇总成每周趋势。如果不想写代码也可以让提醒只承担“打断”功能结束后自己动手写一句日记。工具的价值是降低启动成本而不是替代人的行为。6.2 把提醒接入手机通知如果人不在电脑前语音提醒就听不到。可以改用手机通知方案例如macOS 的osascript发送通知到 iPhone。使用 Webhook 服务在脚本触发时向手机推送文本。在手机上设置重复闹钟或快捷指令执行同一组中英文语音朗读。考虑到不同服务的使用条款和稳定性这里不展开具体服务配置只说明思路核心脚本的“匹配时间 选择文案 发送”逻辑可以复用只需把speak()替换为notify()。6.3 后续扩展方向这个最小工具可以扩展成按星期、日期使用不同文案。根据天气、日程、专注时长动态生成提醒。把提醒日志接入可视化面板统计“今天被打断了多少次”。用tkinter做一个桌面弹窗同时显示中英文文案。把文案库换成自己的学习内容做成中英文听力练习工具。扩展时保持“简单”原则。功能越多维护成本越高反而会失去提醒工具的本意。第一次落地可以直接用最简版本跑起来后再逐步加功能。7. 可落地的最佳实践和检查清单7.1 部署前检查清单在把脚本交给定时任务之前建议按下面的清单逐项确认[ ] Python 版本不低于 3.8python3 --version能输出版本号。[ ] 系统 TTS 命令手动执行有声音。[ ]reminders.json中所有文案都不包含单引号、双引号等容易引发命令拼接问题的字符。[ ]python3 /完整路径/reminder.py --force能听到中英文两段声音。[ ]reminder.log和cron.log所在目录可写。[ ] 定时任务使用绝对路径而不是相对路径。[ ] 第一次配置任务后手动把某个提醒时间改成下一分钟验证自动触发。[ ] 如果使用锁文件确认异常退出后能自动恢复。7.2 文案和播放策略建议文案不要写成“继续加油”“快完成今天的 KPI”这类内容会服务于工作惯性。建议写与当下身体感受、环境观察、情绪状态相关的句子例如“感受脚底和地面的接触”“看看天空现在是什么颜色”。同一时间点准备多条文案让脚本随机选择避免误以为“又是一个通知”。中英文句子不需要逐字对译只要表达同一个提醒意图即可。英文句子故意换一种说法可以提高听完后的注意力。提醒时间不要过于密集。建议上午、下午各 1 到 2 次频率太高会变成新的噪音。7.3 代码健壮性建议在实际项目中脚本还需要考虑使用try/except捕获 TTS 命令异常避免FileNotFoundError让整个脚本崩溃。不要使用裸except至少区分FileNotFoundError、TimeoutExpired等异常类型。日志中记录触发时间、所选的文案、播放耗时方便分析固定时间点是否有异常。如果播放文本包含用户输入不要直接拼接到subprocess.run的命令字符串中优先使用参数列表传递避免特殊字符导致命令注入。使用在线 TTS 时要处理网络超时、限流和临时文件清理。这套“简单小方法”并不是要把生活变成自动化流水线而是在自动化能力和人类觉察之间做一个平衡点。定时提醒、中英双语朗读、文案轮换和日志复盘四件事合在一起最终让每个普通工作日多出几次重新选择注意力的机会。对新手来说最佳练习方式不是直接做完整的多端同步系统而是先把这个 100 行脚本跑通连续使用一周观察哪些时间点最容易被自己接受再根据记录调整文案和频率。当提醒次数减少、觉察次数增加时工具就算真正到位了。
