codex-notify v0.6.2

v0.6.2 更新公告

发布日期：2026-08-25

这次更新让三个平台的首次安装不再需要手动配置 PATH，安装结束后也能直接看到下一步该做什么。

体验优化

• Windows 安装器现在会自动把程序目录加入用户 PATH，并让当前 PowerShell 立即可以运行 codex-notify，全程不需要管理员权限。
• macOS 与 Linux 安装器现在会根据当前 shell 持久化 PATH；由于安装脚本无法反向修改当前终端，它还会显示一条可立即运行的完整路径命令。
• 首次安装完成后会提示运行 codex-notify init，已有安装升级后会提示运行 codex-notify status。

问题修复

• 重复运行安装器不会反复添加相同的 PATH 项；自动配置失败时会明确显示恢复方式。

安装与升级

已有用户可直接升级：

codex-notify update

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.6.1

v0.6.1 更新公告

发布日期：2026-08-13

本次更新让任务在达到用量上限等异常停止时也能可靠进入通知队列。

问题修复

• 即使任务已经产生过进度文本，Stop Hook 也会记录停止候选，不再漏掉“达到使用上限”等异常中断。
• 正常完成事件仍会在确认窗口内取消对应候选，避免把正常结束误报为异常。

安装与升级

已有用户可直接升级：

codex-notify update

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.6.0

v0.6.0 更新公告

发布日期：2026-08-13

现在可以精确区分 Codex 主会话与 subAgent/侧边会话，默认只把主会话结果推送到飞书。

新增功能

• 新增 codex-notify config 命令，可以查看或修改 subAgent/侧边会话通知范围。
• 新增 --subagent-notifications on|off 开关；需要时可以显式开启侧边会话通知。

体验优化

• status 和 status --json 现在会显示 subAgent 通知开关状态。
• 旧版配置缺少新字段时会自动使用关闭状态，不需要手动修改配置文件。

问题修复

• 修复 watcher 补获和 Codex notify 直达事件把 subAgent/侧边会话误发到飞书的问题。
• 修复侧边会话的异常中断候选可能进入飞书通知队列的问题。

安装与升级

已有用户可直接升级：

codex-notify update

升级后默认不推送 subAgent/侧边会话。如需开启：

codex-notify config --subagent-notifications on

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.5.1

v0.5.1 更新公告

发布日期：2026-08-13

任务在返回最终结果前中断时，现在也能更可靠地发送提醒；包含本地媒体的结果不再导致整条飞书通知失败。

问题修复

• Codex 只记录任务中止、没有写入标准错误消息时，watcher 现在会先等待任务是否恢复，再发送中断通知；用量限制等以中止形式结束的任务不再静默漏报。
• 结果包含本地图片、视频或音频时，飞书卡片现在保留附件名称并提示回到 Codex 查看，不再把本机路径误当作图片 key 而反复发送失败。

安装与升级

已有用户可直接升级：

codex-notify update

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.5.0

v0.5.0 更新公告

发布日期：2026-08-11

消息平台配置和凭据现在统一保存在一个本地文件中，安装与迁移更简单，也为后续扩展更多通知平台做好了准备。

新增功能

• 新安装会把飞书设置和 App Secret 统一写入 ~/.codex-notify/config.toml，不再读取或依赖系统凭据库。
• 配置采用版本化的命名平台实例结构，为后续增加其他消息平台和同一平台的多个账号预留了空间。

体验优化

• macOS、Windows 和 Linux 现在使用相同的 ~/.codex-notify 目录，配置更容易查找、备份和迁移。
• 从旧版本升级时会自动读取一次原有凭据、备份旧配置并转换为新版格式；迁移完成后不再访问系统凭据库。

重要变化

• App Secret 会明文保存在 config.toml 中，请不要提交、同步或分享这个文件。Unix 系统会将目录和配置文件权限分别限制为 700 和 600。
• macOS 用户从旧版本首次升级时，可能仍会看到一次钥匙串读取授权；这是旧凭据迁移所需，后续版本不会再次访问钥匙串。

安装与升级

已有用户可直接升级：

codex-notify update

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.4.6

v0.4.6 更新公告

发布日期：2026-08-10

Windows 升级现在会自动使用已启用的系统代理，连接失败时也能直接看到可操作的处理建议。

新增功能

• Windows 现在会自动读取“设置 → 网络和 Internet → 代理”中的手动系统代理，无需另外配置终端环境变量。
• codex-notify update 新增 --proxy <URL> 和 --no-proxy，可以为单次升级明确指定代理或强制直连。

体验优化

• GitHub 连接失败时会区分代理和直连，提示检查代理软件、地址端口或网络设置，不再只显示底层超时错误。
• Windows 安装脚本会把已启用的系统代理传给旧版升级器，受影响的现有安装可以直接过渡到新版本。

重要变化

• 如果 Windows 上的旧版 codex-notify update 仍然连接超时，请重新运行下方 Windows 安装命令完成这一次升级；升级后，后续更新会自动发现系统代理。

安装与升级

已有用户可先直接升级：

codex-notify update

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.4.5

v0.4.5 更新公告

发布日期：2026-08-10

macOS 升级后可以立即继续发送通知，不再因为新版本无法读取钥匙串而静默卡住。

体验优化

• 升级会在重启 watcher 前确认钥匙串权限；需要授权时会在终端明确说明，不会把系统弹窗留给后台进程。
• 完成一次迁移后，后续版本使用 macOS 自带的稳定凭据工具读取 App Secret，无需每次升级重新授权。

问题修复

• 修复 macOS 替换程序后，watcher 可能等待钥匙串授权并停止发送通知的问题。

重要变化

• 从旧版本首次升级时，macOS 可能弹出一次钥匙串窗口，请选择“始终允许”。无需重新运行 init，也无需重启 ChatGPT。

安装与升级

已有用户可直接升级：

codex-notify update

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.4.4

v0.4.4 更新公告

发布日期：2026-08-10

完成通知现在由后台可靠发送：新会话能等到真实标题，升级前已经打开的会话也无需重启 ChatGPT。

新增功能

• watcher 现在会从本地任务记录补获正常完成事件。即使任务在安装或升级前已经打开，后续完成时也能发送通知。

体验优化

• notify 收到完成事件后会快速写入本地队列，不再等待标题或飞书网络请求。
• watcher 会在后台等待新会话标题，最长 5 秒；发送暂时失败时会保留事件并稍后重试。

问题修复

• 修复新会话首条通知经常显示“Codex 会话”的问题。
• 修复旧会话没有加载最新 notify 配置时可能漏发完成通知的问题。
• 同一个任务从 notify、本地记录或 Stop Hook 到达时会按 turn ID 去重，不会重复发送。

安装与升级

已有用户可直接升级：

codex-notify update

升级会自动重启后台 watcher，无需重新运行 init，也无需重启 ChatGPT。

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.4.3

v0.4.3 更新公告

发布日期：2026-08-10

macOS 升级过程更干净，更新公告也更简洁。

体验优化

• 更新公告改用简洁的纯文本标题，阅读重点更清楚。

问题修复

• macOS 升级时，如果后台监听已经正常停止，不再显示误导性的 Boot-out failed 提示。

安装与升级

已有用户可直接升级：

codex-notify update

本次升级后无需重新运行 codex-notify init。

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后运行 codex-notify init 开始配置。

codex-notify v0.4.2

v0.4.2 更新公告

发布日期：2026-08-10

飞书配置入口更清晰，文档中的工作流程也能正常显示了。

💡 体验优化

• 运行 codex-notify init 配置飞书时，会直接显示飞书应用配置教程，第一次使用也更容易找到所需信息。

🛠️ 问题修复

• 修复“工作原理”文档显示 Mermaid 源代码的问题。流程图现在可以正常显示，并会自动适配深色或浅色主题。

📦 安装与升级

已有用户可直接升级：

codex-notify update

本次升级后无需重新运行 codex-notify init。

首次安装可使用以下命令。

macOS 与 Linux

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

Windows PowerShell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装完成后，运行 codex-notify init 开始配置。