KevinNotification

把本机 Codex 任务的完成摘要和异常提醒发到飞书。

一个 Windows 托盘工具：读取本地 Codex 会话日志，通过你配置的飞书机器人发送通知；支持分别开关完成与失败提醒，并用默认快捷键 Alt+W 开关通知。

从源码运行 · 配置飞书与测试 · 实现说明

Windows · C# / .NET 8 / WinForms。目前提供源码，尚无预编译下载包。离开防护是默认关闭的可选功能。

A Windows tray tool that forwards local Codex task completion summaries and failure alerts to Feishu.

这是个人工具项目，与 OpenAI、Codex 或飞书没有官方关联。推荐使用原生 .NET 入口。

设置窗口由真实 WinForms 界面使用合成数据渲染，未截取个人桌面、真实通知或摄像头内容；窗口为展开后的示例尺寸。

从源码运行

环境

• Windows 桌面环境。
• .NET 8 SDK：从源码构建。单独运行框架依赖构建产物时，需要 .NET 8 Desktop Runtime。
• 本机 Codex 在 %USERPROFILE%\.codex\sessions 生成 rollout-*.jsonl 会话日志。
• 飞书自定义机器人：需要接收手机通知时配置；没有 Webhook 时会记录跳过发送，程序仍可启动。
• 可选：将自行安装的 ffmpeg.exe 加入 PATH，用于摄像头拍照。仓库不附带 FFmpeg。

构建与启动

在仓库根目录打开 PowerShell：

dotnet restore KevinNotificationBridgeNative/KevinNotificationBridgeNative.csproj
dotnet build KevinNotificationBridgeNative/KevinNotificationBridgeNative.csproj -c Release --no-restore
& ./KevinNotificationBridgeNative/bin/Release/net8.0-windows/KevinNotificationBridge.exe

配置飞书与测试

首次配置

首次启动会要求设置密码；取消则退出。已有本地设置和密码会继续使用。密码用于打开设置和退出程序，以明文保存在本地设置文件中，仅用于避免误操作，不构成 Windows 安全边界。

启用通知前，请确认目标群聊适合接收项目路径和任务摘要。当前会处理默认会话目录中所有项目的新事件，没有项目白名单；详细内容见数据流与隐私。

机器人的创建方式见飞书自定义机器人官方指南。当前实现只发送普通文本，不生成机器人签名；如果机器人启用了签名校验，需要相应扩展后才能使用。关键词校验也可能拒绝不匹配的通知。

右键系统托盘图标打开设置，确认总通知已开启，在 Webhook 输入框填入自己机器人的地址，点击“保存设置”。保存后窗口会关闭。

发送测试消息

重新打开设置并点击“发送测试”。成功提示表示飞书接口已接受请求，请再到群聊确认消息。若未成功，请检查通知开关、Webhook 和运行日志。

可选离开防护

离开防护、摄像头拍照和自动锁屏均默认关闭，可按需在设置中开启。

• 活动提醒：持续鼠标设备移动触发屏幕提醒；可另外开启本地拍照和连续三次告警自动锁屏。
• 输入来源过滤：结合 Raw Input 和低层鼠标注入标记，减少软件移动光标引起的误报。输入采样、过滤规则和可选实机验证见输入检测说明。

离开防护是输入活动提醒，不能识别人或证明有人操作；驱动级虚拟鼠标仍可能表现为设备输入。

以下警告窗口同样使用合成数据渲染，展示演示文案，不代表实际触发了通知、拍照或锁屏。

数据流与隐私

flowchart LR
    A[本地 Codex 会话日志] --> B[增量读取 / 事件解析 / 去重]
    B --> C[通知开关与类别设置]
    C --> D[用户配置的飞书机器人]
    E[鼠标设备输入] --> F[软件输入与抖动过滤]
    F --> G[可选离开防护]
    G --> H[屏幕警告]
    G --> I[可选本地拍照 / 锁屏]
    G --> C

Loading

• 通知包含标题、时间、最多 120 个字符的项目路径及最多 240 个字符的任务摘要或错误信息，超长部分附省略号。
• 当前没有按项目白名单。启用通知后，会处理默认会话目录中所有项目的新事件；摘要可能包含工作内容，请自行判断是否适合转发到目标群聊。
• Webhook 存在当前 Windows 用户的 CODEX_FEISHU_WEBHOOK 环境变量中，不写入项目示例配置。设置界面输入框留空会保持原配置；不要将真实地址放入截图或提交记录。
• 可选摄像头照片只保存在本地，不随通知上传；通知和防护默认都不会上传照片。
• 本仓库的运行配置、通知日志、摄像头照片、构建产物和临时验证文件均被 .gitignore 排除。

原生版运行数据位于 %LOCALAPPDATA%\KevinNotificationBridge\：

文件或目录	用途
settings.json	用户设置及本地设置密码
runtime-status.json	快捷键注册状态
notifications.log	发送和防护运行状态
captures/	用户主动开启后的摄像头照片

settings.example.json 是原生版字段示例，不会自动载入，无须复制。不要覆盖已有运行配置。

实现与边界

原生版在 KevinNotificationBridgeNative/，托盘、事件监视和飞书通知均在项目内实现，没有第三方 NuGet 包依赖。旧 PowerShell 版保留于 CodexFeishuBridge/，两个入口共用 AwayGuardInput.cs。

• 增量读取本地 Codex 会话事件，区分完成、异常和主动中断，过滤重复事件。
• 依赖 Codex 本地日志的现有结构，当前处理 event_msg 中的 task_complete、非主动中断的 turn_aborted 和部分容量异常。它不是稳定事件接口的兼容承诺；日志格式变化可能导致漏报。
• 只检查最近 24 小时内修改的会话文件，启动时跳过已有事件。没有持久发送队列、自动重试或暂停期间的补发；启动后新出现的文件也先建立读取位置。
• 当前使用默认会话目录，不自动读取自定义 CODEX_HOME 路径。
• 全局快捷键可能与其他程序冲突，注册状态可查看运行状态文件。

旧脚本的启动方式与仓库外依赖见Legacy 说明。

验证

以下默认检查只使用合成设置、合成会话和内存 HTTP 响应，不读取真实通知配置或用户 Webhook，不发送飞书消息，也不拍照或锁屏：

dotnet run --project tests/KevinNotificationBridge.Tests.csproj -c Release -- .tmp/native-tests
powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/Test-AwayGuardInput.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/Test-TrayGuard.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/Test-LegacyBridge.ps1

覆盖输入过滤与告警状态、首次使用默认值、已有设置往返、增量事件解析、去重、聊天文本误报过滤，以及未配置 Webhook、HTTP 错误和飞书业务错误。

文档图片可通过下面的命令重新渲染到 .tmp/native-tests/screenshots/。它会在屏幕外创建示例窗口，不启动正式托盘或防护：

dotnet run --project tests/KevinNotificationBridge.Tests.csproj -c Release -- .tmp/native-tests --render-docs

License

MIT。.NET 和可选 FFmpeg 遵循各自许可证；本仓库没有打包这些运行环境或二进制依赖。