ccus-cli 0.2.3 → 0.2.5

package/README.md

@@ -162,7 +162,7 @@ ccus aggregate serve --input-dir ./team-exports
 - 默认输出一个 `json` 数据包，里面同时包含 `rawEvents`、`weeklySummary`、`dailySummaries`
 - 导出文件内容为**紧凑 JSON**（无缩进），并默认 **gzip 压缩**后写成 `.json.gz`；gzip 与紧凑化都只是存储/展示层变化，解压后的字段集合与 `schemaVersion` 不变
 - 默认写 `.json.gz`；若用 `--out` 指定一个非 `.gz` 结尾的路径，则按明文 JSON 写出（不压缩）
-- 当前导出 bundle / weeklySummary 的 `schemaVersion` 为 `8`：v7 起新增 `weeklySummary.codex` 与 `dailySummaries[].codex`（Codex CLI 的消息/请求/token 统计），v8 起该 codex 段再加 5h/7d 的 peak/latest 额度（从 `source="codex"` 事件重算、与 Claude 额度分开看）；aggregate daily/weekly CSV 的主字段（消息/请求/token/额度）已把 Codex **叠加进 Claude 合计**（累加量相加、额度 peak 取两源 max、latest 两源相加、7d 累计含两源读数），不再单列 `codex*` 列，detail.csv 加 `source` 列区分来源
+- 当前导出 bundle / weeklySummary 的 `schemaVersion` 为 `9`：v7 起新增 `weeklySummary.codex` 与 `dailySummaries[].codex`（Codex CLI 的消息/请求/token 统计），v8 起该 codex 段再加 5h/7d 的 peak/latest 额度（从 `source="codex"` 事件重算、与 Claude 额度分开看），v9 起 codex `inputTokens` 改为净输入（`input_tokens - cached_input_tokens`，不含缓存命中）以对齐 Claude 的 `input_tokens` 口径；aggregate daily/weekly CSV 的主字段（消息/请求/token/额度）已把 Codex **叠加进 Claude 合计**（累加量相加、额度 peak 取两源 max、latest 两源相加、7d 累计含两源读数），不再单列 `codex*` 列，detail.csv 加 `source` 列区分来源
 - 默认文件名会带 git email 的帐号名前缀和起止日期，例如：`alice_export_2026-05-26_to_2026-06-01.json.gz`
 - `userMessageCount` 来自 `~/.claude/projects/**/*.jsonl` 的非 meta `type:user` 事件
 - `apiRequestCount` 与 token 指标来自 `~/.claude/projects/**/*.jsonl` 中带 `message.usage` 的 `type:assistant` 事件
@@ -172,7 +172,7 @@ ccus aggregate serve --input-dir ./team-exports
 ## 多人汇总
 
 - 输入目录放很多通过 `ccus export` 导出的 bundle 文件，`.json.gz`（gzip 压缩）与明文 `.json` 都能识别，gzip 文件读取时自动解压
-- `aggregate` 接受 `schemaVersion: 6/7/8` 的 bundle（v8 含 codex 额度，v7/v6 容错回退 null/零值）；更旧的导出请先用当前版本重新 `ccus export`
+- `aggregate` 接受 `schemaVersion: 6/7/8/9` 的 bundle（v9 codex inputTokens 为净输入，v8 含 codex 额度，v7/v6 容错回退 null/零值）；更旧的导出请先用当前版本重新 `ccus export`
 - 同一个人在多台电脑上各自导出 bundle 时会自动合并去重：去重以**天**为粒度，对每个「同人同天」取 `generatedAt` 最新的那份导出，避免同一台机器重复导出或周与周重叠造成翻倍；**周汇总不取整周单份，而是把按天去重后的各天数据上卷累加**，所以多台电脑在不同天产生的用量会正确合进同一周。usage（5h / 7d）从选中事件按真实时间戳重算，Claude+Codex 合并：peak 取两源 max、latest 两源相加
 - `ccus aggregate --input-dir DIR --out-dir DIR`
 - 输出三个文件：

package/dist/cli.js

@@ -395,7 +395,7 @@ async function runExport(options) {
         exportUserName = gitIdentity.userName;
     }
     const weeklySummary = {
-        schemaVersion: 8,
+        schemaVersion: 9,
         generatedAt: new Date().toISOString(),
         range: {
             label: window.label,
@@ -479,7 +479,7 @@ async function runExport(options) {
         };
     });
     const bundle = {
-        schemaVersion: 8,
+        schemaVersion: 9,
         generatedAt: new Date().toISOString(),
         range: {
             label: window.label,

package/dist/lib/aggregate.js

@@ -50,7 +50,7 @@ function isWeeklyExportBundle(value) {
     if (!isRecord(value)) {
         return false;
     }
-    if (typeof value.schemaVersion !== "number" || ![6, 7, 8].includes(value.schemaVersion)) {
+    if (typeof value.schemaVersion !== "number" || ![6, 7, 8, 9].includes(value.schemaVersion)) {
         return false;
     }
     if (!Array.isArray(value.rawEvents) || !Array.isArray(value.dailySummaries) || !isRecord(value.weeklySummary) || !isRecord(value.identity) || !isRecord(value.range)) {
@@ -131,7 +131,7 @@ async function loadWeeklyExportBundles(inputDir) {
         }
     }
     if (invalidFiles.length > 0) {
-        throw new Error(`Unsupported export bundle schema in files: ${invalidFiles.join(", ")}. Re-export with current ccus so aggregate receives schemaVersion 6/7/8 bundles.`);
+        throw new Error(`Unsupported export bundle schema in files: ${invalidFiles.join(", ")}. Re-export with current ccus so aggregate receives schemaVersion 6/7/8/9 bundles.`);
     }
     return bundles;
 }

package/dist/lib/codex-sessions.js

@@ -47,6 +47,8 @@ function timestampInRange(timestamp, start, end) {
 /**
  * 从 `token_count` 事件的 `info.last_token_usage` 取 token 用量对象（缺失返回 null）。
  * 必须用 last_token_usage（本次增量），不能用 total_token_usage（会话累计，会重复计）。
+ * 注意：Codex 的 `input_tokens` 含缓存命中（`cached_input_tokens` 是其子集），
+ * 累加 inputTokens 时要减去 cached 得到净输入，对齐 Claude 的 `input_tokens` 口径。
  */
 function extractLastTokenUsage(payload) {
     if (!isRecord(payload.info)) {
@@ -55,16 +57,18 @@ function extractLastTokenUsage(payload) {
     return isRecord(payload.info.last_token_usage) ? payload.info.last_token_usage : null;
 }
 /**
- * 统计单个 Codex rollout 文件内的 token / 消息。
+ * 解析单个 Codex rollout 文件，收集范围内的 task_started turn 节点与 token_count 用量。
  *
  * Codex rollout 每行一个事件，timestamp 在 top-level：
- * - `event_msg` + `payload.type=="user_message"`：一次用户消息（工具结果是 `function_call_output`，不命中，无需过滤）。
+ * - `event_msg` + `payload.type=="task_started"`：一个用户 turn，带全局唯一 `turn_id`。
+ *   fork / spawn sub-agent / resume 会把历史 task_started 跨文件重放，故 turn 节点交上层按
+ *   turn_id 全局去重（取最早 timestamp），不能在单文件层计数。
  * - `event_msg` + `payload.type=="token_count"`：一次模型请求，token 取 `info.last_token_usage` 增量。
  */
 function summarizeRollout(content, start, end) {
     const lines = content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
-    const summary = {
-        userMessageCount: 0,
+    const result = {
+        turns: [],
         apiRequestCount: 0,
         inputTokens: 0,
         outputTokens: 0,
@@ -80,16 +84,21 @@ function summarizeRollout(content, start, end) {
                 continue;
             }
             const payload = record.payload;
-            if (payload.type === "user_message") {
-                summary.userMessageCount += 1;
+            if (payload.type === "task_started" && typeof payload.turn_id === "string") {
+                const ms = new Date(getString(record.timestamp) ?? "").getTime();
+                if (Number.isFinite(ms)) {
+                    result.turns.push({ turnId: payload.turn_id, ms });
+                }
             }
             if (payload.type === "token_count") {
                 const usage = extractLastTokenUsage(payload);
                 if (usage) {
-                    summary.apiRequestCount += 1;
-                    summary.inputTokens += getNumber(usage.input_tokens);
-                    summary.outputTokens += getNumber(usage.output_tokens);
-                    summary.cacheReadInputTokens += getNumber(usage.cached_input_tokens);
+                    // 净输入 = input_tokens - cached_input_tokens（input_tokens 含缓存命中，减去对齐 Claude 口径）。
+                    const netInputTokens = Math.max(0, getNumber(usage.input_tokens) - getNumber(usage.cached_input_tokens));
+                    result.apiRequestCount += 1;
+                    result.inputTokens += netInputTokens;
+                    result.outputTokens += getNumber(usage.output_tokens);
+                    result.cacheReadInputTokens += getNumber(usage.cached_input_tokens);
                 }
             }
         }
@@ -97,48 +106,79 @@ function summarizeRollout(content, start, end) {
             continue;
         }
     }
-    return summary;
+    return result;
 }
 /**
  * 从 Codex 本地 session rollout（<CODEX_HOME>/sessions 下递归的 .jsonl）统计消息数、请求数和 token 用量。
+ *
+ * 消息数 = task_started 的 distinct turn_id（跨文件去重）。重放副本会让同一 turn_id 出现在多个文件，
+ * 故用全局 Map<turn_id, minMs> 收集（取最早 timestamp = 真实发生时刻，早于任何重放副本），最后取 size。
  */
 async function summarizeCodexSessionUsage(start, end) {
     const codexDataDir = (0, paths_1.getCodexHome)();
     const sessionsDir = node_path_1.default.join(codexDataDir, "sessions");
     const files = await collectRolloutFiles(sessionsDir);
-    const totals = {
-        userMessageCount: 0,
-        apiRequestCount: 0,
-        inputTokens: 0,
-        outputTokens: 0,
-        cacheReadInputTokens: 0,
-        matchedFileCount: files.length,
-        codexDataDir,
-    };
+    const turnMinMs = new Map();
+    let apiRequestCount = 0;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let cacheReadInputTokens = 0;
     for (const filePath of files) {
         try {
             const content = await promises_1.default.readFile(filePath, "utf8");
-            const summary = summarizeRollout(content, start, end);
-            totals.userMessageCount += summary.userMessageCount;
-            totals.apiRequestCount += summary.apiRequestCount;
-            totals.inputTokens += summary.inputTokens;
-            totals.outputTokens += summary.outputTokens;
-            totals.cacheReadInputTokens += summary.cacheReadInputTokens;
+            const parsed = summarizeRollout(content, start, end);
+            for (const turn of parsed.turns) {
+                const prev = turnMinMs.get(turn.turnId);
+                if (prev === undefined || turn.ms < prev) {
+                    turnMinMs.set(turn.turnId, turn.ms);
+                }
+            }
+            apiRequestCount += parsed.apiRequestCount;
+            inputTokens += parsed.inputTokens;
+            outputTokens += parsed.outputTokens;
+            cacheReadInputTokens += parsed.cacheReadInputTokens;
         }
         catch {
             continue;
         }
     }
-    return totals;
+    return {
+        userMessageCount: turnMinMs.size,
+        apiRequestCount,
+        inputTokens,
+        outputTokens,
+        cacheReadInputTokens,
+        matchedFileCount: files.length,
+        codexDataDir,
+    };
 }
 /**
  * 按天汇总 Codex session rollout 中的消息数、请求数和 token 用量。
+ *
+ * 消息数同 weekly：先全局 Map<turn_id, minMs> 去重，再按 minMs 的本地日归桶（保证 weekly = Σ daily、
+ * 且重放副本跨天不重复）。token 维度按 token_count 事件 timestamp 的本地日累加。
  */
 async function summarizeCodexSessionUsageByDay(start, end) {
     const codexDataDir = (0, paths_1.getCodexHome)();
     const sessionsDir = node_path_1.default.join(codexDataDir, "sessions");
     const files = await collectRolloutFiles(sessionsDir);
+    const turnMinMs = new Map();
     const daily = new Map();
+    const ensureDay = (date) => {
+        let current = daily.get(date);
+        if (!current) {
+            current = {
+                date,
+                userMessageCount: 0,
+                apiRequestCount: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadInputTokens: 0,
+            };
+            daily.set(date, current);
+        }
+        return current;
+    };
     for (const filePath of files) {
         let content = "";
         try {
@@ -162,36 +202,36 @@ async function summarizeCodexSessionUsageByDay(start, end) {
                     continue;
                 }
                 const payload = record.payload;
-                const isUserMessage = payload.type === "user_message";
-                const usage = payload.type === "token_count" ? extractLastTokenUsage(payload) : null;
-                if (!isUserMessage && !usage) {
-                    continue;
+                const ms = new Date(timestamp).getTime();
+                if (payload.type === "task_started" && typeof payload.turn_id === "string") {
+                    if (Number.isFinite(ms)) {
+                        const prev = turnMinMs.get(payload.turn_id);
+                        if (prev === undefined || ms < prev) {
+                            turnMinMs.set(payload.turn_id, ms);
+                        }
+                    }
                 }
-                const date = (0, time_1.localDateKey)(new Date(timestamp));
-                const current = daily.get(date) ?? {
-                    date,
-                    userMessageCount: 0,
-                    apiRequestCount: 0,
-                    inputTokens: 0,
-                    outputTokens: 0,
-                    cacheReadInputTokens: 0,
-                };
-                if (isUserMessage) {
-                    current.userMessageCount += 1;
+                if (payload.type === "token_count") {
+                    const usage = extractLastTokenUsage(payload);
+                    if (usage) {
+                        const current = ensureDay((0, time_1.localDateKey)(new Date(ms)));
+                        // 同 summarizeRollout：累加净输入（input - cached），对齐 Claude 口径。
+                        const netInputTokens = Math.max(0, getNumber(usage.input_tokens) - getNumber(usage.cached_input_tokens));
+                        current.apiRequestCount += 1;
+                        current.inputTokens += netInputTokens;
+                        current.outputTokens += getNumber(usage.output_tokens);
+                        current.cacheReadInputTokens += getNumber(usage.cached_input_tokens);
+                    }
                 }
-                if (usage) {
-                    current.apiRequestCount += 1;
-                    current.inputTokens += getNumber(usage.input_tokens);
-                    current.outputTokens += getNumber(usage.output_tokens);
-                    current.cacheReadInputTokens += getNumber(usage.cached_input_tokens);
-                }
-                daily.set(date, current);
             }
             catch {
                 continue;
             }
         }
     }
+    for (const ms of turnMinMs.values()) {
+        ensureDay((0, time_1.localDateKey)(new Date(ms))).userMessageCount += 1;
+    }
     return daily;
 }
 //# sourceMappingURL=codex-sessions.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccus-cli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Claude Code statusline usage logger and dashboard CLI",
   "type": "commonjs",
   "bin": {