Skip to content

CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息

fix: 优先使用 Hook 官方事件名

Bob84d7162dd38b
diff --git a/CodexBar/Services/WorkflowStats/WorkflowHookEventRecorder.swift b/CodexBar/Services/WorkflowStats/WorkflowHookEventRecorder.swift
index e657f5d..d6b9f83 100644
--- a/CodexBar/Services/WorkflowStats/WorkflowHookEventRecorder.swift
+++ b/CodexBar/Services/WorkflowStats/WorkflowHookEventRecorder.swift
@@ -3,11 +3,11 @@ import Foundation
nonisolated enum WorkflowHookEventRecorder {
static func handleIfRequested(arguments: [String] = CommandLine.arguments) -> Bool {
- guard let eventName = hookEventName(from: arguments) else {
+ guard let fallbackEventName = hookEventName(from: arguments) else {
return false
}
- try? record(eventName: eventName)
+ try? record(fallbackEventName: fallbackEventName)
return true
}
@@ -31,8 +31,10 @@ nonisolated enum WorkflowHookEventRecorder {
return trimmedValue.isEmpty ? nil : trimmedValue
}
- private static func record(eventName: String) throws {
+ private static func record(fallbackEventName: String) throws {
let payload = stdinPayload()
+ let eventName = payload.string(for: "hook_event_name")
+ .flatMap(normalizedHookEventName) ?? fallbackEventName
let timestamp = payload.date(for: "timestamp") ?? Date()
let cwd = payload.string(for: "cwd") ?? FileManager.default.currentDirectoryPath
let tool = payload.string(for: "tool_name")
diff --git a/Docs/CodexHook.md b/Docs/CodexHook.md
index 9c0ef2f..54375bf 100644
--- a/Docs/CodexHook.md
+++ b/Docs/CodexHook.md
@@ -57,6 +57,7 @@ Hook stdin 会尝试解析为 Codex 官方 JSON 对象,只读取顶层字段
读取字段:
+- 事件: `hook_event_name`,缺失时回退 Hook 命令参数 `--hook-event`
- 目录: `cwd`
- 工具: `tool_name`
- 模型: `model`
@@ -64,7 +65,7 @@ Hook stdin 会尝试解析为 Codex 官方 JSON 对象,只读取顶层字段
- 会话: `session_id`
- 轮次: `turn_id`
-事件名来自 Hook 命令参数 `--hook-event`。事件时间优先读取 payload 顶层 `timestamp`,解析后按本机时区写成 `yyyy-MM-dd HH:mm:ss.SSS`;如果 payload 缺失或无法解析,记录当前时间作为兜底。同一个事件时间也会按本机时区格式化为 `yyyy-MM-dd` 的 date key,用于选择 `events/YYYY-MM-DD.jsonl` 文件。每行按固定顺序写入 `timestamp`、`event`、`model`、`permission`、`session`、`turn`、`tool`、`cwd`;缺失值写为 `null`。
+事件名优先来自 payload 顶层 `hook_event_name`;缺失时回退 Hook 命令参数 `--hook-event`。`--hook-event` 仍用于识别当前进程是否是 Hook 子进程,避免普通 App 启动时读取 stdin。事件时间优先读取 payload 顶层 `timestamp`,解析后按本机时区写成 `yyyy-MM-dd HH:mm:ss.SSS`;如果 payload 缺失或无法解析,记录当前时间作为兜底。同一个事件时间也会按本机时区格式化为 `yyyy-MM-dd` 的 date key,用于选择 `events/YYYY-MM-DD.jsonl` 文件。每行按固定顺序写入 `timestamp`、`event`、`model`、`permission`、`session`、`turn`、`tool`、`cwd`;缺失值写为 `null`。
事件名统计时会去掉 `_` 和 `-` 并转小写,因此 `PreToolUse`、`pre_tool_use`、`pre-tool-use` 会归为同一个事件。
diff --git a/Docs/DevelopmentGuide.md b/Docs/DevelopmentGuide.md
index c9fd3ab..595d531 100644
--- a/Docs/DevelopmentGuide.md
+++ b/Docs/DevelopmentGuide.md
@@ -680,16 +680,18 @@ sequenceDiagram
读取字段:
-| Hook payload 字段 | 写入字段 |
-| ----------------------- | ----------------------------------------------- |
-| `timestamp` | `timestamp`, 本机时间 `yyyy-MM-dd HH:mm:ss.SSS` |
-| `cwd` | `cwd` |
-| `tool_name` | `tool` |
-| `model` | `model` |
-| `permission_mode` | `permission` |
-| `session_id` | `session` |
-| `turn_id` | `turn` |
-| 命令参数 `--hook-event` | `event` |
+| Hook payload 字段 | 写入字段 |
+| ----------------- | ----------------------------------------------- |
+| `timestamp` | `timestamp`, 本机时间 `yyyy-MM-dd HH:mm:ss.SSS` |
+| `hook_event_name` | `event` |
+| `cwd` | `cwd` |
+| `tool_name` | `tool` |
+| `model` | `model` |
+| `permission_mode` | `permission` |
+| `session_id` | `session` |
+| `turn_id` | `turn` |
+
+`hook_event_name` 缺失时回退命令参数 `--hook-event`;`--hook-event` 仍用于识别当前进程是否是 Hook 子进程。
缺失字段不阻断写入:
diff --git a/README.md b/README.md
index 36d0df0..167dee6 100644
--- a/README.md
+++ b/README.md
@@ -92,4 +92,4 @@ CodexBar 只与本机 Codex app-server 进程通信。账号信息、额度数
## 许可证
-本项目采用 GNU General Public License v3.0 [LICENSE](LICENSE)
+本项目采用 [GNU General Public License v3.0](LICENSE)