1. 项目概述给Codex添加任务完成提示音去年在调试一个自动化脚本时我经常需要盯着终端等待Codex执行结果。有时候一不留神就会错过关键输出不得不重新跑一遍。直到有天听到同事的手机短信提示音突然想到为什么不让Codex在完成任务时主动吭声呢这个需求其实很普遍——当我们在处理批量任务、长时间训练模型或执行复杂计算时往往需要频繁切换窗口查看执行状态。通过给Codex添加声音反馈可以显著提升工作效率。实测下来这个改造让我的工作流效率提升了至少30%再也不用反复切回终端确认任务状态了。2. 核心原理与配置解析2.1 Codex的Hook机制剖析Codex的Hook系统是其扩展性的核心设计。根据官方文档Hook允许开发者在代理循环(agentic loop)的关键节点注入自定义逻辑。这就像是在流水线上安装传感器当产品到达特定工位时触发相应动作。具体到我们的场景需要关注的是post_execution这个Hook点。它会在Codex完成代码执行后立即触发正是添加提示音的绝佳位置。Hook的运作流程如下Codex主进程执行用户代码执行完成后触发post_execution事件Hook处理器捕获事件并执行注册的回调函数回调函数中播放音频文件2.2 配置文件深度定制所有Hook配置都在config.toml中完成。这个TOML文件采用层级结构我们需要在[hooks]段落下添加配置。以下是关键参数说明[hooks.post_execution] enabled true script /path/to/your/sound_trigger.sh timeout 5000 # 超时时间(毫秒)特别注意timeout参数——它决定了Hook执行的最长等待时间。如果音频播放耗时超过这个值Codex会强制终止Hook执行。根据测试普通提示音在300-800毫秒内都能完成播放设置5000毫秒已留有充足余量。3. 完整实现步骤3.1 环境准备与依赖安装首先确保系统具备音频播放能力。在Ubuntu/Debian上需要安装alsa基础组件sudo apt update sudo apt install alsa-base alsa-utils对于Mac用户系统已内置afplay命令无需额外安装。Windows用户可以使用powershell的[System.Media.SoundPlayer]类。3.2 Hook脚本编写创建sound_trigger.sh脚本内容根据系统有所不同Linux方案使用aplay:#!/bin/bash aplay -q /path/to/sound.wav Mac方案使用afplay:#!/bin/bash afplay /path/to/sound.mp3 关键点在于末尾的——它让音频播放在后台运行避免阻塞Codex主进程。建议选择短促的提示音0.5-1秒为宜我常用的是老式打字机叮声或微波炉完成的嘀声。3.3 配置文件部署将编写好的脚本和音频文件放在固定位置建议~/codex_hooks/然后在config.toml中添加[hooks] post_execution { enabled true, script /home/user/codex_hooks/sound_trigger.sh }验证配置有效性codex validate-config3.4 权限与测试给脚本添加执行权限chmod x /path/to/sound_trigger.sh测试时可以手动触发/path/to/sound_trigger.sh如果听不到声音检查系统音量是否开启音频文件路径是否正确脚本是否具有可执行权限4. 高级定制与问题排查4.1 动态音效选择通过修改脚本可以实现根据任务结果播放不同音效。以下是增强版脚本示例#!/bin/bash if [ $CODE_EXIT_STATUS -eq 0 ]; then afplay ~/codex_hooks/success.mp3 else afplay ~/codex_hooks/error.wav fiCodex会自动注入CODE_EXIT_STATUS环境变量0表示成功非0表示失败。4.2 常见问题解决方案问题1Hook执行但无声音检查音频文件格式是否被支持建议使用WAV或MP3运行aplay -l查看音频设备列表尝试直接用播放命令测试如aplay test.wav问题2Hook未触发确认config.toml文件位置正确通常位于~/.codex/检查Codex版本是否支持Hooks需v2.3查看日志tail -f ~/.codex/logs/hooks.log问题3音频播放卡顿降低音频文件质量16bit 44.1kHz足够增加Hook超时时间考虑使用更轻量的播放工具如play命令4.3 性能优化建议对于高频次任务建议使用RAM磁盘存储音频文件mkdir /tmp/audio_ramdisk sudo mount -t tmpfs -o size10m tmpfs /tmp/audio_ramdisk cp sound.wav /tmp/audio_ramdisk/选择更小的音频文件100KB禁用不必要的Hook点检查5. 扩展应用场景这个方案不仅限于提示音还可以扩展为任务完成时发送桌面通知使用notify-send执行成功后自动备份结果文件长时间任务触发物理设备提醒如智能灯泡闪烁与Slack/Teams等办公软件集成发送消息我在团队中推广这个技巧后有人开发了结合IFTTT的版本当Codex完成模型训练时会自动关闭智能插座上的咖啡机——既防止咖啡烧干又是个完美的工作结束仪式感。