ccus-cli 0.2.7 → 0.2.8

package/README.md

@@ -6,6 +6,7 @@
 - `ccus statusline emit`：读取 Claude Code statusline 通过 `stdin` 传入的 JSON，输出 statusline 文本，并写入本地日志（加 `--no-store` / `--no-log` 则只输出、不落盘）。
 - `ccus dashboard serve`：直接启动本地 Web 页面，不用先手动生成 HTML 文件。
 - `ccus export`：默认导出当前周数据包（gzip 压缩的 `.json.gz`），里面同时包含原始事件和按天维度的周汇总。
+- `ccus sessions`：把指定周内活跃的 Claude 与 Codex 原始 session 完整打包成 zip。
 - `ccus aggregate`：读取一个目录里的多人 export bundle（`.json.gz` 或 `.json`），输出明细、按天、按周三个 CSV。
 - `ccus aggregate serve`：同样以 bundle 目录为输入，启动本地多人 dashboard 页面，不落地任何文件。
 - `ccus sync`：定时把当前周数据包导出并复制到一个目标目录（如团队共享盘），目标目录下按周自动建子目录；日常由 statusline 兜底触发，也可挂系统计划任务做到严格每天定时。
@@ -81,6 +82,7 @@ ccus install
 ccus export                     # 导出当前周数据包（this-week）
 ccus export lw                  # 导出上一整周（last-week，周一到周日）
 ccus export tw                  # 导出本周（等价于默认 ccus export）
+ccus sessions                   # 打包本周活跃的 Claude 与 Codex 原始 session
 
 ccus dashboard serve            # 启动本地页面，默认看本周（this-week）的 5 小时使用率曲线与每日用户消息数
 
@@ -138,6 +140,9 @@ ccus export --range last-week
 ccus export lw                 # 位置参数简写，等价于 --range last-week
 ccus export tw                 # 等价于 --range this-week
 ccus export --out ./alice_export_2026-05-26_to_2026-06-01.json   # --out 指定非 .gz 路径时写明文 JSON
+ccus sessions                  # 默认导出本周
+ccus sessions lw               # 导出上一整周
+ccus sessions --out ./sessions.zip
 ccus aggregate --input-dir ./team-exports --out-dir ./team-report
 ccus aggregate serve --input-dir ./team-exports
 ```
@@ -169,6 +174,13 @@ ccus aggregate serve --input-dir ./team-exports
 - `dailySummaries` 会按每天输出消息数、请求数、token 和当天 statusline usage 摘要
 - 不再支持其它导出格式
 
+### 原始 session 打包
+
+- `ccus sessions` 默认打包本周；支持 `tw`、`lw`、`today`、`5h` 等与 `export` 相同的范围写法。
+- 只选择文件中至少一条记录落入时间窗的 session，但 zip 内保存完整原始文件，不裁剪内容。
+- Claude 文件保持 `<projectDir>/<sessionId>.jsonl` 路径；Codex rollout 保持 `codex/<CODEX_HOME 下 sessions 的相对路径>`。
+- 默认写入 `<data-dir>/sessions/projects_<start>_<end>_<gitUserName>.zip`；`--out` 可指定路径。
+
 ## 多人汇总
 
 - 输入目录放很多通过 `ccus export` 导出的 bundle 文件，`.json.gz`（gzip 压缩）与明文 `.json` 都能识别，gzip 文件读取时自动解压

package/dist/cli.js

@@ -67,7 +67,7 @@ const update_check_1 = require("./lib/update-check");
 const version_1 = require("./lib/version");
 /** CLI 帮助信息保持简洁，方便直接挂到 README 或终端里查看。 */
 function printHelp() {
-    process.stdout.write(`ccus\n\nCommands:\n  ccus install [--settings PATH] [--command CMD] [--data-dir PATH]   (默认装 Claude statusLine；--codex 改写 Codex 的 ~/.codex/config.toml notify，配 --uninstall 移除)\n  ccus statusline emit [--data-dir PATH] [--input FILE] [--no-store]\n  ccus dashboard build [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard open [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard serve [--range today|this-week|last-week|5h] [--port 0] [--host 127.0.0.1] [--open] [--data-dir PATH]\n  ccus export [RANGE] [--out FILE] [--data-dir PATH]   (RANGE: this-week|tw, last-week|lw, today, 5h; e.g. ccus export lw)\n  ccus sessions [RANGE] [--out FILE] [--data-dir PATH]   (把 ~/.claude/projects 本周活跃 session 打包成 zip，名如 projects_<dates>_<user>.zip)\n  ccus aggregate --input-dir DIR [--out-dir DIR]\n  ccus aggregate serve --input-dir DIR [--port 0] [--host 127.0.0.1]\n  ccus sync [--data-dir PATH]\n  ccus sync config [--target DIR] [--interval 3h|daily|<N>h|<N>m] [--range this-week] [--suffix NAME | --no-suffix] [--data-dir PATH]\n  ccus sync install [--print] [--data-dir PATH]   (注册每周五 18:00 的系统调度器)\n  ccus sync uninstall [--print]   (卸载系统调度器)\n  ccus sync status [--data-dir PATH]\n  ccus api config [--enable|--disable] [--provider zhipu|custom] [--token-env NAME] [--token VAL] [--url URL] [--project P] [--organization O] [--ttl 5m] [--extractor-file FILE] [--data-dir PATH]\n  ccus api test [--data-dir PATH]   (立即拉取第三方额度并打印，验证配置是否生效)\n  ccus api status [--data-dir PATH]\n  ccus open [--data-dir PATH] [--print]\n  ccus update [--data-dir PATH]\n  ccus --version\n\nGlobal flags:\n  --verbose | --debug | -v   输出详细调试日志到 stderr（等价于设置 CCUS_DEBUG=1），方便排查问题\n`);
+    process.stdout.write(`ccus\n\nCommands:\n  ccus install [--settings PATH] [--command CMD] [--data-dir PATH]   (默认装 Claude statusLine；--codex 改写 Codex 的 ~/.codex/config.toml notify，配 --uninstall 移除)\n  ccus statusline emit [--data-dir PATH] [--input FILE] [--no-store]\n  ccus dashboard build [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard open [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard serve [--range today|this-week|last-week|5h] [--port 0] [--host 127.0.0.1] [--open] [--data-dir PATH]\n  ccus export [RANGE] [--out FILE] [--data-dir PATH]   (RANGE: this-week|tw, last-week|lw, today, 5h; e.g. ccus export lw)\n  ccus sessions [RANGE] [--out FILE] [--data-dir PATH]   (把 Claude 与 Codex 的活跃 session 打包成 zip，默认本周)\n  ccus aggregate --input-dir DIR [--out-dir DIR]\n  ccus aggregate serve --input-dir DIR [--port 0] [--host 127.0.0.1]\n  ccus sync [--data-dir PATH]\n  ccus sync config [--target DIR] [--interval 3h|daily|<N>h|<N>m] [--range this-week] [--suffix NAME | --no-suffix] [--data-dir PATH]\n  ccus sync install [--print] [--data-dir PATH]   (注册每周五 18:00 的系统调度器)\n  ccus sync uninstall [--print]   (卸载系统调度器)\n  ccus sync status [--data-dir PATH]\n  ccus api config [--enable|--disable] [--provider zhipu|custom] [--token-env NAME] [--token VAL] [--url URL] [--project P] [--organization O] [--ttl 5m] [--extractor-file FILE] [--data-dir PATH]\n  ccus api test [--data-dir PATH]   (立即拉取第三方额度并打印，验证配置是否生效)\n  ccus api status [--data-dir PATH]\n  ccus open [--data-dir PATH] [--print]\n  ccus update [--data-dir PATH]\n  ccus --version\n\nGlobal flags:\n  --verbose | --debug | -v   输出详细调试日志到 stderr（等价于设置 CCUS_DEBUG=1），方便排查问题\n`);
 }
 /** 一个轻量的参数解析器，当前命令面不复杂，没必要引入额外依赖。 */
 function parseOptions(args) {
@@ -656,9 +656,9 @@ function resolveExportOptions(action, args, rest) {
     return options;
 }
 /**
- * `ccus sessions`：把 ~/.claude/projects 中在指定时间范围内有活动的 session 文件打包成 zip。
+ * `ccus sessions`：把 Claude 与 Codex 中在指定时间范围内有活动的 session 文件打包成 zip。
  *
- * zip 内部结构保持 <projectDir>/<sessionId>.jsonl 层级（路径分隔符统一用 /）。
+ * Claude 内部结构保持 <projectDir>/<sessionId>.jsonl，Codex 保持 codex/<sessions 相对路径>。
  * 文件名格式：projects_<start>_<end>_<gitUserName>.zip。
  * 默认输出到 <data-dir>/sessions/，加 --out 可指定完整路径。
  * 位置参数作为 range 简写，例如 `ccus sessions lw` 等价于 `--range last-week`。
@@ -670,14 +670,22 @@ async function handleSessions(options) {
     const now = new Date();
     const window = (0, time_1.expandToFullWeekWindow)((0, time_1.resolveRange)(range, now));
     (0, debug_1.debugLog)("sessions", "range resolved", { range, label: window.label, start: window.start.toISOString(), end: window.end.toISOString() });
-    const sessions = await (0, claude_1.findActiveSessionFiles)(window.start, window.end);
-    (0, debug_1.debugLog)("sessions", "active sessions found", { count: sessions.length });
+    const [claudeSessions, codexSessions] = await Promise.all([
+        (0, claude_1.findActiveSessionFiles)(window.start, window.end),
+        (0, codex_sessions_1.findActiveCodexSessionFiles)(window.start, window.end),
+    ]);
+    (0, debug_1.debugLog)("sessions", "active sessions found", { claude: claudeSessions.length, codex: codexSessions.length });
     const fsRead = (await Promise.resolve().then(() => __importStar(require("node:fs/promises")))).readFile;
     const { buildZipBuffer } = await Promise.resolve().then(() => __importStar(require("./lib/zip")));
-    const entries = await Promise.all(sessions.map(async (session) => ({
+    const claudeEntries = claudeSessions.map(async (session) => ({
         name: `${session.projectDir.replaceAll("\\", "/")}/${session.sessionId}.jsonl`,
         data: await fsRead(session.filePath),
-    })));
+    }));
+    const codexEntries = codexSessions.map(async (session) => ({
+        name: `codex/${session.relativePath.replaceAll("\\", "/")}`,
+        data: await fsRead(session.filePath),
+    }));
+    const entries = await Promise.all([...claudeEntries, ...codexEntries]);
     const zipBuffer = await buildZipBuffer(entries);
     const gitIdentity = await (0, git_1.readGitIdentity)();
     const userName = (0, time_1.formatGitEmailFilePrefix)(gitIdentity.userEmail) ?? "unknown";

package/dist/lib/codex-sessions.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.findActiveCodexSessionFiles = findActiveCodexSessionFiles;
 exports.summarizeCodexSessionUsage = summarizeCodexSessionUsage;
 exports.summarizeCodexSessionUsageByDay = summarizeCodexSessionUsageByDay;
 const promises_1 = __importDefault(require("node:fs/promises"));
@@ -44,6 +45,45 @@ function timestampInRange(timestamp, start, end) {
     const value = new Date(timestamp).getTime();
     return Number.isFinite(value) && value >= start.getTime() && value <= end.getTime();
 }
+/**
+ * 找出 `<CODEX_HOME>/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 result = [];
+    for (const filePath of files) {
+        try {
+            const content = await promises_1.default.readFile(filePath, "utf8");
+            const lines = content.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+            let hasInRange = false;
+            for (const line of lines) {
+                try {
+                    const record = JSON.parse(line);
+                    if (isRecord(record) && timestampInRange(getString(record.timestamp), start, end)) {
+                        hasInRange = true;
+                        break;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (hasInRange) {
+                result.push({
+                    filePath,
+                    relativePath: node_path_1.default.relative(sessionsDir, filePath),
+                });
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return result;
+}
 /**
  * 从 `token_count` 事件的 `info.last_token_usage` 取 token 用量对象（缺失返回 null）。
  * 必须用 last_token_usage（本次增量），不能用 total_token_usage（会话累计，会重复计）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccus-cli",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Claude Code statusline usage logger and dashboard CLI",
   "type": "commonjs",
   "bin": {
@@ -16,7 +16,7 @@
     "build": "tsc -p tsconfig.json && node scripts/copy-vendor.js",
     "prepublishOnly": "npm run build",
     "test": "node --test --test-concurrency 1 \"dist/test/**/*.test.js\"",
-    "test:src": "node --import tsx --test --test-concurrency 1 src/test/payload.test.ts src/test/dashboard.test.ts src/test/export.test.ts src/test/storage.test.ts src/test/claude.test.ts src/test/aggregate.test.ts src/test/aggregate-dashboard.test.ts src/test/install.test.ts src/test/debug.test.ts src/test/time.test.ts src/test/update-check.test.ts src/test/sync.test.ts src/test/scheduler.test.ts src/test/api-mode.test.ts src/test/codex-fetcher.test.ts src/test/codex-sessions.test.ts src/test/codex-install.test.ts src/test/cli-codex-notify.test.ts src/test/cli-codex-hook.test.ts src/test/cli-install-codex.test.ts",
+    "test:src": "node --import tsx --test --test-concurrency 1 src/test/payload.test.ts src/test/dashboard.test.ts src/test/export.test.ts src/test/storage.test.ts src/test/claude.test.ts src/test/aggregate.test.ts src/test/aggregate-dashboard.test.ts src/test/install.test.ts src/test/debug.test.ts src/test/time.test.ts src/test/update-check.test.ts src/test/sync.test.ts src/test/scheduler.test.ts src/test/api-mode.test.ts src/test/codex-fetcher.test.ts src/test/codex-sessions.test.ts src/test/sessions.test.ts src/test/codex-install.test.ts src/test/cli-codex-notify.test.ts src/test/cli-codex-hook.test.ts src/test/cli-install-codex.test.ts",
     "smoke:api": "node scripts/smoke-api.mjs"
   },
   "keywords": [