ccus-cli 0.1.5 → 0.1.6

package/README.md

@@ -5,8 +5,8 @@
 - `ccus install`：自动把 statusLine 命令写进 Claude Code 的 `settings.json`，省去手动改配置。
 - `ccus statusline emit`：读取 Claude Code statusline 通过 `stdin` 传入的 JSON，输出 statusline 文本，并写入本地日志（加 `--no-store` / `--no-log` 则只输出、不落盘）。
 - `ccus dashboard serve`：直接启动本地 Web 页面，不用先手动生成 HTML 文件。
-- `ccus export`：默认导出当前周数据包，里面同时包含原始事件和按天维度的周汇总。
-- `ccus aggregate`：读取一个目录里的多人 export bundle json，输出明细、按天、按周三个 CSV。
+- `ccus export`：默认导出当前周数据包（gzip 压缩的 `.json.gz`），里面同时包含原始事件和按天维度的周汇总。
+- `ccus aggregate`：读取一个目录里的多人 export bundle（`.json.gz` 或 `.json`），输出明细、按天、按周三个 CSV。
 - `ccus aggregate serve`：同样以 bundle 目录为输入，启动本地多人 dashboard 页面，不落地任何文件。
 - `ccus update`：主动检查 npm 上是否有新版本，有则提示手动升级命令；`ccus --version` 查看当前版本。
 
@@ -113,7 +113,7 @@ ccus export --range today
 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
+ccus export --out ./alice_export_2026-05-26_to_2026-06-01.json   # --out 指定非 .gz 路径时写明文 JSON
 ccus aggregate --input-dir ./team-exports --out-dir ./team-report
 ccus aggregate serve --input-dir ./team-exports
 ```
@@ -135,8 +135,10 @@ ccus aggregate serve --input-dir ./team-exports
 - 默认导出 `this-week`；如需导出上一个完整周（周一到周日），用 `--range last-week`，或位置参数简写 `ccus export lw`（`tw` = 本周）
 - 周度导出固定覆盖**完整一周（周一到周日）**：`this-week` 即使本周还没过完、后面几天还没有任何数据，文件名的起止日期也会补齐到本周日，`dailySummaries` 同样按整周 7 天逐日输出
 - 默认输出一个 `json` 数据包，里面同时包含 `rawEvents`、`weeklySummary`、`dailySummaries`
+- 导出文件内容为**紧凑 JSON**（无缩进），并默认 **gzip 压缩**后写成 `.json.gz`；gzip 与紧凑化都只是存储/展示层变化，解压后的字段集合与 `schemaVersion` 不变
+- 默认写 `.json.gz`；若用 `--out` 指定一个非 `.gz` 结尾的路径，则按明文 JSON 写出（不压缩）
 - 当前导出 bundle / weeklySummary 的 `schemaVersion` 为 `6`，用于标识已使用 `fiveHourLatestUsagePct`、`fiveHourPeakUsagePct`、`sevenDayLatestUsagePct`、`sevenDayPeakUsagePct` 字段的新导出契约
-- 默认文件名会带 git email 的帐号名前缀和起止日期，例如：`alice_export_2026-05-26_to_2026-06-01.json`
+- 默认文件名会带 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` 事件
 - `dailySummaries` 会按每天输出消息数、请求数、token 和当天 statusline usage 摘要
@@ -144,7 +146,7 @@ ccus aggregate serve --input-dir ./team-exports
 
 ## 多人汇总
 
-- 输入目录放很多通过 `ccus export` 导出的 bundle `.json` 文件
+- 输入目录放很多通过 `ccus export` 导出的 bundle 文件，`.json.gz`（gzip 压缩）与明文 `.json` 都能识别，gzip 文件读取时自动解压
 - `aggregate` 目前只接受 `schemaVersion: 6` 的 bundle；旧导出请先用当前版本重新 `ccus export`
 - `ccus aggregate --input-dir DIR --out-dir DIR`
 - 输出三个文件：

package/dist/cli.js

@@ -406,10 +406,17 @@ async function handleExport(options) {
     const content = (0, export_1.buildWeeklyExportBundleJson)(bundle);
     const fileLabel = (0, time_1.formatRangeFileLabel)(window.start, window.end);
     const gitEmailPrefix = (0, time_1.formatGitEmailFilePrefix)(exportUserEmail);
-    const defaultFileName = gitEmailPrefix ? `${gitEmailPrefix}_export_${fileLabel}.json` : `export_${fileLabel}.json`;
+    // 默认导出 gzip 压缩的 bundle（.json.gz）以缩减体积；用户用 --out 指定非 .gz 路径时仍写明文 JSON。
+    const defaultFileName = gitEmailPrefix ? `${gitEmailPrefix}_export_${fileLabel}.json.gz` : `export_${fileLabel}.json.gz`;
     const outputPath = node_path_1.default.resolve(output ?? node_path_1.default.join(dataDir, "exports", defaultFileName));
-    await (0, export_1.writeTextFile)(outputPath, content);
-    (0, debug_1.debugLog)("export", "bundle written", { outputPath, bytes: content.length });
+    const compressed = outputPath.endsWith(".gz");
+    if (compressed) {
+        await (0, export_1.writeGzipFile)(outputPath, content);
+    }
+    else {
+        await (0, export_1.writeTextFile)(outputPath, content);
+    }
+    (0, debug_1.debugLog)("export", "bundle written", { outputPath, rawBytes: content.length, compressed });
     process.stdout.write(`${outputPath}\n`);
 }
 /**

package/dist/lib/aggregate.js

@@ -9,8 +9,11 @@ exports.buildAggregatedDailyRows = buildAggregatedDailyRows;
 exports.buildAggregatedWeeklyRows = buildAggregatedWeeklyRows;
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const node_zlib_1 = require("node:zlib");
 const payload_1 = require("./payload");
 const time_1 = require("./time");
+const gunzipAsync = (0, node_util_1.promisify)(node_zlib_1.gunzip);
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -59,6 +62,10 @@ function weekKey(date) {
 function toPersonKey(gitUserEmail, gitUserName) {
     return (0, time_1.extractGitEmailAccount)(gitUserEmail) ?? gitUserName ?? "unknown";
 }
+/** bundle 文件可以是明文 `.json`，也可以是 `ccus export` 默认输出的 gzip 压缩 `.json.gz`。 */
+function isBundleFileName(name) {
+    return name.endsWith(".json") || name.endsWith(".json.gz");
+}
 async function collectBundleJsonFiles(directoryPath) {
     const entries = await promises_1.default.readdir(directoryPath, { withFileTypes: true });
     const nested = await Promise.all(entries.map(async (entry) => {
@@ -66,10 +73,19 @@ async function collectBundleJsonFiles(directoryPath) {
         if (entry.isDirectory()) {
             return collectBundleJsonFiles(fullPath);
         }
-        return entry.isFile() && entry.name.endsWith(".json") ? [fullPath] : [];
+        return entry.isFile() && isBundleFileName(entry.name) ? [fullPath] : [];
     }));
     return nested.flat();
 }
+/** 读取 bundle 文件内容：`.gz` 结尾的先 gunzip 再按 UTF-8 解码，其它按明文读取。 */
+async function readBundleFileContent(filePath) {
+    if (filePath.endsWith(".gz")) {
+        const compressed = await promises_1.default.readFile(filePath);
+        const decompressed = await gunzipAsync(compressed);
+        return decompressed.toString("utf8");
+    }
+    return promises_1.default.readFile(filePath, "utf8");
+}
 /** 读取目录里的 export bundle json 文件。 */
 async function loadWeeklyExportBundles(inputDir) {
     const files = await collectBundleJsonFiles(inputDir);
@@ -77,7 +93,7 @@ async function loadWeeklyExportBundles(inputDir) {
     const invalidFiles = [];
     for (const filePath of files) {
         try {
-            const content = await promises_1.default.readFile(filePath, "utf8");
+            const content = await readBundleFileContent(filePath);
             const parsed = JSON.parse(content);
             if (isWeeklyExportBundle(parsed)) {
                 bundles.push({ filePath, bundle: parsed });

package/dist/lib/export.js

@@ -13,9 +13,13 @@ exports.buildSummaryCsv = buildSummaryCsv;
 exports.buildAggregatedDailyCsv = buildAggregatedDailyCsv;
 exports.buildAggregatedWeeklyCsv = buildAggregatedWeeklyCsv;
 exports.writeTextFile = writeTextFile;
+exports.writeGzipFile = writeGzipFile;
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const node_zlib_1 = require("node:zlib");
 const time_1 = require("./time");
+const gzipAsync = (0, node_util_1.promisify)(node_zlib_1.gzip);
 /** CSV 字符串字段统一做转义，避免逗号和引号破坏列结构。 */
 function quoteCsv(value) {
     return `"${value.replaceAll("\"", "\"\"")}"`;
@@ -128,9 +132,9 @@ function buildRawJsonl(events) {
 function buildWeeklySummaryJson(summary) {
     return `${JSON.stringify(summary, null, 2)}\n`;
 }
-/** 默认导出把原始事件与周汇总一起打包成一个 JSON 文件。 */
+/** 默认导出把原始事件与周汇总一起打包成一个 JSON 文件，用紧凑序列化避免缩进空白撑大体积。 */
 function buildWeeklyExportBundleJson(bundle) {
-    return `${JSON.stringify(bundle, null, 2)}\n`;
+    return `${JSON.stringify(bundle)}\n`;
 }
 /** 按天汇总 usage 数据，生成 summary 模式的中间结果。 */
 function buildSummaryRows(events) {
@@ -272,4 +276,15 @@ async function writeTextFile(outputPath, content) {
     await promises_1.default.mkdir(node_path_1.default.dirname(outputPath), { recursive: true });
     await promises_1.default.writeFile(outputPath, content, "utf8");
 }
+/**
+ * 把内容 gzip 压缩后写文件，父目录不存在时自动创建。
+ *
+ * 仅压缩存储/传输层，写入的字节解压后与 `writeTextFile` 完全一致，
+ * 不改变 bundle 字段集合，也不影响 schemaVersion。
+ */
+async function writeGzipFile(outputPath, content) {
+    await promises_1.default.mkdir(node_path_1.default.dirname(outputPath), { recursive: true });
+    const compressed = await gzipAsync(content);
+    await promises_1.default.writeFile(outputPath, compressed);
+}
 //# sourceMappingURL=export.js.map

package/package.json

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