ccus-cli 0.2.8 → 0.2.10

package/README.md

@@ -178,7 +178,7 @@ ccus aggregate serve --input-dir ./team-exports
 
 - `ccus sessions` 默认打包本周；支持 `tw`、`lw`、`today`、`5h` 等与 `export` 相同的范围写法。
 - 只选择文件中至少一条记录落入时间窗的 session，但 zip 内保存完整原始文件，不裁剪内容。
-- Claude 文件保持 `<projectDir>/<sessionId>.jsonl` 路径；Codex rollout 保持 `codex/<CODEX_HOME 下 sessions 的相对路径>`。
+- Claude 文件保持 `<projectDir>/<sessionId>.jsonl` 路径；Codex rollout 合并 `<CODEX_HOME>/sessions` 与 `%APPDATA%/orca/codex-runtime-home/home/sessions`，按相对路径和 JSONL 事件去重后保持 `codex/<sessions 相对路径>`。
 - 默认写入 `<data-dir>/sessions/projects_<start>_<end>_<gitUserName>.zip`；`--out` 可指定路径。
 
 ## 多人汇总
@@ -311,7 +311,7 @@ ccus install --codex --uninstall          # 移除 ccus 的 Stop hook
 - **定时同步**：Stop hook 还兜底触发 `ccus sync`（与 Claude statusline 对称）——配过 `ccus sync config --target` 后，Codex 每 turn 结束都会检查 3h 周期，到期自动 export + 复制 bundle（含 Codex token/消息）到目标目录。只用 Codex、不开 Claude Code 时也能自动同步。
 - **缓存节流**：Stop 每 turn 触发，额度按 5 分钟 TTL 缓存（`codex-quota-cache.json`），命中秒回不 spawn；过期才拉一次（带 ~10s 超时），失败回退旧缓存。
 - **字段映射**：app-server 返回 `primary`（5h）/ `secondary`（weekly）两窗口，取各自的 `usedPercent`（驼峰，clamp 0–100）；ccus 填进 `rate_limits.five_hour` / `seven_day` 的 `used_percentage`，`computeStatuslineEvent` 读时自动算出 usage。
-- **token / 消息 / 额度都进 export / aggregate**：Codex 的 token、用户消息数、API 请求数从 `<CODEX_HOME>/sessions` 的 rollout 统计，进 `ccus export` 的 `weeklySummary.codex` / `dailySummaries[].codex` 段；Stop 落盘的额度快照（`source="codex"` 事件）也进 export/aggregate——export bundle 里 Codex 额度单列到 codex 段、与 Claude 分开看，aggregate daily/weekly CSV 则把 Codex **叠加进 Claude 主字段**合计（累加量相加、额度 peak 取两源 max、latest 两源相加、7d 累计含两源），不再单列 `codex*` 列；detail.csv 的 `source` 列区分来源。
+- **token / 消息 / 额度都进 export / aggregate**：Codex 的 token、用户消息数、API 请求数合并读取 `<CODEX_HOME>/sessions` 与 `%APPDATA%/orca/codex-runtime-home/home/sessions` 的 rollout；同一相对路径的副本按 JSONL 事件去重，并排除 `source.subagent.other="guardian"` 的 Codex Desktop 内部安全审查会话。统计进入 `ccus export` 的 `weeklySummary.codex` / `dailySummaries[].codex` 段；Stop 落盘的额度快照（`source="codex"` 事件）也进 export/aggregate——export bundle 里 Codex 额度单列到 codex 段、与 Claude 分开看，aggregate daily/weekly CSV 则把 Codex **叠加进 Claude 主字段**合计（累加量相加、额度 peak 取两源 max、latest 两源相加、7d 累计含两源读数），不再单列 `codex*` 列；detail.csv 的 `source` 列区分来源。
 - **Windows**：`install --codex` 在 Windows 写 `ccus.cmd __codex-hook`（npm 全局装会生成 `ccus.cmd`）；Windows 上 Stop hook 偶发收到非法 JSON（已知 bug #23784），ccus 容错按无 payload 处理、仍照常拉额度 + 落盘。
 
 > 该路径依赖 Codex 内部 app-server 协议（`account/rateLimits/read` 的返回结构）与 hooks payload schema，随版本变；解析层宽松，字段缺失返回 null、失败静默。

package/dist/cli.js

@@ -683,7 +683,7 @@ async function handleSessions(options) {
     }));
     const codexEntries = codexSessions.map(async (session) => ({
         name: `codex/${session.relativePath.replaceAll("\\", "/")}`,
-        data: await fsRead(session.filePath),
+        data: Buffer.from(session.content, "utf8"),
     }));
     const entries = await Promise.all([...claudeEntries, ...codexEntries]);
     const zipBuffer = await buildZipBuffer(entries);

package/dist/lib/codex-sessions.js

@@ -19,6 +19,29 @@ function getNumber(value) {
 function getString(value) {
     return typeof value === "string" && value.length > 0 ? value : null;
 }
+/** Guardian 是 Codex Desktop 的动作安全审查子代理，不代表用户请求或业务模型调用。 */
+function isGuardianRollout(content) {
+    let offset = 0;
+    while (offset < content.length) {
+        const newline = content.indexOf("\n", offset);
+        const line = content.slice(offset, newline === -1 ? content.length : newline).trim();
+        offset = newline === -1 ? content.length : newline + 1;
+        try {
+            const record = JSON.parse(line);
+            if (!isRecord(record) || record.type !== "session_meta" || !isRecord(record.payload)) {
+                continue;
+            }
+            const source = record.payload.source;
+            return isRecord(source)
+                && isRecord(source.subagent)
+                && source.subagent.other === "guardian";
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
 async function collectRolloutFiles(directoryPath) {
     try {
         const entries = await promises_1.default.readdir(directoryPath, { withFileTypes: true });
@@ -38,6 +61,74 @@ async function collectRolloutFiles(directoryPath) {
         throw error;
     }
 }
+function rolloutPathKey(relativePath) {
+    const normalized = relativePath.replaceAll("\\", "/");
+    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+/** 收集标准 Codex 与 Orca session，并按 sessions 下的相对路径归并同一 rollout。 */
+async function collectRolloutFileGroups() {
+    const sessionDirs = (0, paths_1.getCodexSessionHomes)().map((home) => node_path_1.default.join(home, "sessions"));
+    const filesByDir = await Promise.all(sessionDirs.map((directory) => collectRolloutFiles(directory)));
+    const groups = new Map();
+    for (let index = 0; index < sessionDirs.length; index += 1) {
+        const sessionsDir = sessionDirs[index];
+        for (const filePath of filesByDir[index]) {
+            const relativePath = node_path_1.default.relative(sessionsDir, filePath);
+            const key = rolloutPathKey(relativePath);
+            const group = groups.get(key);
+            if (group) {
+                group.filePaths.push(filePath);
+            }
+            else {
+                groups.set(key, { relativePath, filePaths: [filePath] });
+            }
+        }
+    }
+    return [...groups.values()];
+}
+function rolloutLineKey(line) {
+    try {
+        return JSON.stringify(JSON.parse(line));
+    }
+    catch {
+        return line;
+    }
+}
+/**
+ * 合并同一 rollout 在不同根目录下的副本。
+ *
+ * 对每种 JSONL 行保留各副本中的最大出现次数，既消除完整/部分镜像造成的重复，
+ * 又保留任一副本独有的新增事件以及单个源内真实存在的重复行。
+ */
+function mergeRolloutContents(contents) {
+    const mergedLines = [];
+    const mergedCounts = new Map();
+    for (const content of contents) {
+        const sourceCounts = new Map();
+        const lines = content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+        for (const line of lines) {
+            const key = rolloutLineKey(line);
+            const sourceCount = (sourceCounts.get(key) ?? 0) + 1;
+            sourceCounts.set(key, sourceCount);
+            if (sourceCount > (mergedCounts.get(key) ?? 0)) {
+                mergedCounts.set(key, sourceCount);
+                mergedLines.push(line);
+            }
+        }
+    }
+    return mergedLines.length > 0 ? `${mergedLines.join("\n")}\n` : "";
+}
+async function readMergedRollout(group) {
+    const reads = await Promise.all(group.filePaths.map(async (filePath) => {
+        try {
+            return await promises_1.default.readFile(filePath, "utf8");
+        }
+        catch {
+            return null;
+        }
+    }));
+    return mergeRolloutContents(reads.filter((content) => content !== null));
+}
 function timestampInRange(timestamp, start, end) {
     if (!timestamp) {
         return false;
@@ -46,17 +137,16 @@ function timestampInRange(timestamp, start, end) {
     return Number.isFinite(value) && value >= start.getTime() && value <= end.getTime();
 }
 /**
- * 找出 `<CODEX_HOME>/sessions` 中在指定时间范围内有活动的 rollout 文件。
+ * 找出标准 Codex 与 Orca sessions 中在指定时间范围内有活动的 rollout 文件。
  *
- * 只判断文件里是否存在范围内的记录，不过滤内容，导出时完整复制原始文件。
+ * 只判断合并后的文件里是否存在范围内的记录，不过滤内容，导出时写入完整合并结果。
  */
 async function findActiveCodexSessionFiles(start, end) {
-    const sessionsDir = node_path_1.default.join((0, paths_1.getCodexHome)(), "sessions");
-    const files = await collectRolloutFiles(sessionsDir);
+    const groups = await collectRolloutFileGroups();
     const result = [];
-    for (const filePath of files) {
+    for (const group of groups) {
         try {
-            const content = await promises_1.default.readFile(filePath, "utf8");
+            const content = await readMergedRollout(group);
             const lines = content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
             let hasInRange = false;
             for (const line of lines) {
@@ -73,8 +163,9 @@ async function findActiveCodexSessionFiles(start, end) {
             }
             if (hasInRange) {
                 result.push({
-                    filePath,
-                    relativePath: node_path_1.default.relative(sessionsDir, filePath),
+                    filePath: group.filePaths[0],
+                    relativePath: group.relativePath,
+                    content,
                 });
             }
         }
@@ -149,23 +240,26 @@ function summarizeRollout(content, start, end) {
     return result;
 }
 /**
- * 从 Codex 本地 session rollout（<CODEX_HOME>/sessions 下递归的 .jsonl）统计消息数、请求数和 token 用量。
+ * 从标准 Codex 与 Orca 本地 session rollout 统计消息数、请求数和 token 用量。
+ * Codex Desktop 的 guardian 安全审查 rollout 整体排除，避免把内部审批轮次计为用户使用量。
  *
  * 消息数 = 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 groups = await collectRolloutFileGroups();
     const turnMinMs = new Map();
     let apiRequestCount = 0;
     let inputTokens = 0;
     let outputTokens = 0;
     let cacheReadInputTokens = 0;
-    for (const filePath of files) {
+    for (const group of groups) {
         try {
-            const content = await promises_1.default.readFile(filePath, "utf8");
+            const content = await readMergedRollout(group);
+            if (isGuardianRollout(content)) {
+                continue;
+            }
             const parsed = summarizeRollout(content, start, end);
             for (const turn of parsed.turns) {
                 const prev = turnMinMs.get(turn.turnId);
@@ -188,20 +282,19 @@ async function summarizeCodexSessionUsage(start, end) {
         inputTokens,
         outputTokens,
         cacheReadInputTokens,
-        matchedFileCount: files.length,
+        matchedFileCount: groups.length,
         codexDataDir,
     };
 }
 /**
  * 按天汇总 Codex session rollout 中的消息数、请求数和 token 用量。
+ * 与周汇总一致，排除 Codex Desktop 的 guardian 安全审查 rollout。
  *
  * 消息数同 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 groups = await collectRolloutFileGroups();
     const turnMinMs = new Map();
     const daily = new Map();
     const ensureDay = (date) => {
@@ -219,12 +312,9 @@ async function summarizeCodexSessionUsageByDay(start, end) {
         }
         return current;
     };
-    for (const filePath of files) {
-        let content = "";
-        try {
-            content = await promises_1.default.readFile(filePath, "utf8");
-        }
-        catch {
+    for (const group of groups) {
+        const content = await readMergedRollout(group);
+        if (isGuardianRollout(content)) {
             continue;
         }
         const lines = content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);

package/dist/lib/paths.js

@@ -13,6 +13,8 @@ exports.getApiConfigPath = getApiConfigPath;
 exports.getApiQuotaCachePath = getApiQuotaCachePath;
 exports.getCodexQuotaCachePath = getCodexQuotaCachePath;
 exports.getCodexHome = getCodexHome;
+exports.getOrcaCodexHome = getOrcaCodexHome;
+exports.getCodexSessionHomes = getCodexSessionHomes;
 exports.getCodexConfigPath = getCodexConfigPath;
 exports.getCodexHooksPath = getCodexHooksPath;
 exports.getClaudeDataDir = getClaudeDataDir;
@@ -78,6 +80,41 @@ function getCodexQuotaCachePath(dataDir) {
 function getCodexHome() {
     return process.env.CODEX_HOME ?? node_path_1.default.join(node_os_1.default.homedir(), ".codex");
 }
+/** Orca 内置 Codex 的运行时数据目录；非 Orca 环境下返回 null。 */
+function getOrcaCodexHome() {
+    const appData = process.env.APPDATA;
+    return appData ? node_path_1.default.join(appData, "orca", "codex-runtime-home", "home") : null;
+}
+/**
+ * Codex session 的全部数据源。
+ *
+ * 默认合并 `~/.codex` 与 Orca runtime home；`CODEX_HOME` 指向 Orca 时仍保留
+ * `~/.codex`，其它显式覆盖则沿用原有覆盖语义。路径按平台规则去重。
+ */
+function getCodexSessionHomes() {
+    const configuredHome = node_path_1.default.resolve(getCodexHome());
+    const defaultHome = node_path_1.default.resolve(node_path_1.default.join(node_os_1.default.homedir(), ".codex"));
+    const orcaHome = getOrcaCodexHome();
+    const candidates = orcaHome && samePath(configuredHome, orcaHome)
+        ? [defaultHome, configuredHome]
+        : [configuredHome, ...(orcaHome ? [node_path_1.default.resolve(orcaHome)] : [])];
+    const seen = new Set();
+    return candidates.filter((candidate) => {
+        const key = pathKey(candidate);
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+function pathKey(value) {
+    const resolved = node_path_1.default.resolve(value);
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function samePath(left, right) {
+    return pathKey(left) === pathKey(right);
+}
 /** Codex CLI 用户级 config.toml 路径，`ccus install --codex` 往里写 notify。 */
 function getCodexConfigPath() {
     return node_path_1.default.join(getCodexHome(), "config.toml");

package/package.json

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