ccus-cli 0.1.14 → 0.1.16

package/dist/cli.js

@@ -61,7 +61,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]\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 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 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]\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 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) {
@@ -563,6 +563,53 @@ function resolveExportOptions(action, args, rest) {
     }
     return options;
 }
+/**
+ * `ccus sessions`：把 ~/.claude/projects 中在指定时间范围内有活动的 session 文件打包成 zip。
+ *
+ * zip 内部结构保持 <projectDir>/<sessionId>.jsonl 层级（路径分隔符统一用 /）。
+ * 文件名格式：projects_<start>_<end>_<gitUserName>.zip。
+ * 默认输出到 <data-dir>/sessions/，加 --out 可指定完整路径。
+ * 位置参数作为 range 简写，例如 `ccus sessions lw` 等价于 `--range last-week`。
+ */
+async function handleSessions(options) {
+    const dataDir = getDataDir(options);
+    const range = getStringOption(options, "range") ?? "this-week";
+    const out = getStringOption(options, "out");
+    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 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) => ({
+        name: `${session.projectDir.replaceAll("\\", "/")}/${session.sessionId}.jsonl`,
+        data: await fsRead(session.filePath),
+    })));
+    const zipBuffer = await buildZipBuffer(entries);
+    const gitIdentity = await (0, git_1.readGitIdentity)();
+    const userName = (0, time_1.formatGitEmailFilePrefix)(gitIdentity.userEmail) ?? "unknown";
+    const fileLabel = (0, time_1.formatRangeFileLabel)(window.start, window.end);
+    const defaultFileName = `projects_${fileLabel}_${userName}.zip`;
+    const outputPath = node_path_1.default.resolve(out ?? node_path_1.default.join(dataDir, "sessions", defaultFileName));
+    const fsNode = await Promise.resolve().then(() => __importStar(require("node:fs/promises")));
+    await fsNode.mkdir(node_path_1.default.dirname(outputPath), { recursive: true });
+    await fsNode.writeFile(outputPath, zipBuffer);
+    process.stdout.write(`${outputPath}\n`);
+}
+/**
+ * 解析 sessions 命令的参数，支持 RANGE 作为位置参数简写。
+ */
+function resolveSessionsOptions(action, args, rest) {
+    if (!action || action.startsWith("--")) {
+        return parseOptions(args.slice(1));
+    }
+    const options = parseOptions(rest);
+    if (typeof options.range !== "string") {
+        options.range = action;
+    }
+    return options;
+}
 /** 用 readline 向用户提问，返回用户输入的一行文本。 */
 async function prompt(question) {
     const rl = (await Promise.resolve().then(() => __importStar(require("node:readline")))).createInterface({
@@ -851,6 +898,11 @@ async function main(args = process.argv.slice(2)) {
         await handleExport(exportOptions);
         return;
     }
+    if (group === "sessions") {
+        const sessionsOptions = resolveSessionsOptions(action, args, rest);
+        await handleSessions(sessionsOptions);
+        return;
+    }
     if (group === "aggregate") {
         if (action === "serve") {
             await handleAggregateServe(parseOptions(rest));

package/dist/lib/claude.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.summarizeClaudeProjectUsage = summarizeClaudeProjectUsage;
+exports.findActiveSessionFiles = findActiveSessionFiles;
 exports.summarizeClaudeProjectUsageByDay = summarizeClaudeProjectUsageByDay;
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -142,6 +143,49 @@ async function summarizeClaudeProjectUsage(start, end) {
     }
     return totals;
 }
+/**
+ * 找出 ~/.claude/projects 中在指定时间范围内有活动的 session 文件，返回文件路径及结构信息。
+ *
+ * 只判断文件里是否存在范围内的记录，不过滤内容，导出时完整复制原始文件。
+ */
+async function findActiveSessionFiles(start, end) {
+    const claudeDataDir = (0, paths_1.getClaudeDataDir)();
+    const projectsDir = node_path_1.default.join(claudeDataDir, "projects");
+    const files = await collectProjectJsonlFiles(projectsDir);
+    const result = [];
+    for (const filePath of files) {
+        try {
+            const content = await promises_1.default.readFile(filePath, "utf8");
+            const lines = content.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0);
+            let hasInRange = false;
+            for (const line of lines) {
+                try {
+                    const record = JSON.parse(line);
+                    if (!isRecord(record))
+                        continue;
+                    if (timestampInRange(getString(record.timestamp), start, end)) {
+                        hasInRange = true;
+                        break;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (hasInRange) {
+                result.push({
+                    filePath,
+                    projectDir: node_path_1.default.relative(projectsDir, node_path_1.default.dirname(filePath)),
+                    sessionId: node_path_1.default.basename(filePath, ".jsonl"),
+                });
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return result;
+}
 /**
  * 按天汇总 Claude project transcript 中的消息数、请求数和 token 用量。
  */

package/dist/lib/dashboard.js

@@ -100,7 +100,7 @@ function renderChart(buckets) {
         usage: entry.value,
         label: (0, time_1.formatLocalTimestamp)(new Date(entry.bucket.bucketStart)),
     }));
-    const fiveHourPoints = collectPoints((bucket) => bucket.avgUsagePct);
+    const fiveHourPoints = collectPoints((bucket) => bucket.maxUsagePct);
     const sevenDayPoints = collectPoints((bucket) => bucket.avgSevenDayUsagePct);
     const linePathOf = (points) => points.map((point, index) => `${index === 0 ? "M" : "L"}${point.x.toFixed(2)} ${point.y.toFixed(2)}`).join(" ");
     const fiveHourLine = linePathOf(fiveHourPoints);

package/dist/lib/zip.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildZipBuffer = buildZipBuffer;
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const node_util_1 = require("node:util");
+const deflateRawAsync = (0, node_util_1.promisify)(node_zlib_1.default.deflateRaw);
+function crc32(buf) {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let j = 0; j < 8; j++)
+            c = c & 1 ? (0xedb88320 ^ (c >>> 1)) : c >>> 1;
+        table[i] = c;
+    }
+    let crc = 0xffffffff;
+    for (let i = 0; i < buf.length; i++)
+        crc = (crc >>> 8) ^ table[(crc ^ buf[i]) & 0xff];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/**
+ * 把一组内存文件打包成合法的 ZIP 格式 Buffer。
+ *
+ * 使用 deflate 压缩，文件名按 UTF-8 编码（flags bit 11 置位），不写时间戳。
+ * 只依赖 Node.js 内置的 zlib，无外部依赖。
+ */
+async function buildZipBuffer(entries) {
+    const locals = [];
+    const centrals = [];
+    let offset = 0;
+    for (const entry of entries) {
+        const name = Buffer.from(entry.name, "utf8");
+        const crc = crc32(entry.data);
+        const uncompressedSize = entry.data.length;
+        const compressed = await deflateRawAsync(entry.data);
+        const compressedSize = compressed.length;
+        const local = Buffer.alloc(30 + name.length);
+        local.writeUInt32LE(0x04034b50, 0); // local file header signature
+        local.writeUInt16LE(20, 4); // version needed
+        local.writeUInt16LE(0x0800, 6); // general purpose bit flag: UTF-8
+        local.writeUInt16LE(8, 8); // compression method: deflate
+        local.writeUInt16LE(0, 10); // last mod time
+        local.writeUInt16LE(0, 12); // last mod date
+        local.writeUInt32LE(crc, 14);
+        local.writeUInt32LE(compressedSize, 18);
+        local.writeUInt32LE(uncompressedSize, 22);
+        local.writeUInt16LE(name.length, 26);
+        local.writeUInt16LE(0, 28); // extra field length
+        name.copy(local, 30);
+        const central = Buffer.alloc(46 + name.length);
+        central.writeUInt32LE(0x02014b50, 0); // central directory signature
+        central.writeUInt16LE(20, 4); // version made by
+        central.writeUInt16LE(20, 6); // version needed
+        central.writeUInt16LE(0x0800, 8); // general purpose bit flag: UTF-8
+        central.writeUInt16LE(8, 10); // compression method: deflate
+        central.writeUInt16LE(0, 12); // last mod time
+        central.writeUInt16LE(0, 14); // last mod date
+        central.writeUInt32LE(crc, 16);
+        central.writeUInt32LE(compressedSize, 20);
+        central.writeUInt32LE(uncompressedSize, 24);
+        central.writeUInt16LE(name.length, 28);
+        central.writeUInt16LE(0, 30); // extra field length
+        central.writeUInt16LE(0, 32); // file comment length
+        central.writeUInt16LE(0, 34); // disk number start
+        central.writeUInt16LE(0, 36); // internal file attributes
+        central.writeUInt32LE(0, 38); // external file attributes
+        central.writeUInt32LE(offset, 42); // relative offset of local header
+        name.copy(central, 46);
+        locals.push(local, compressed);
+        centrals.push(central);
+        offset += local.length + compressedSize;
+    }
+    const centralSize = centrals.reduce((sum, c) => sum + c.length, 0);
+    const eocd = Buffer.alloc(22);
+    eocd.writeUInt32LE(0x06054b50, 0); // end of central dir signature
+    eocd.writeUInt16LE(0, 4); // disk number
+    eocd.writeUInt16LE(0, 6); // disk with central dir
+    eocd.writeUInt16LE(entries.length, 8);
+    eocd.writeUInt16LE(entries.length, 10);
+    eocd.writeUInt32LE(centralSize, 12);
+    eocd.writeUInt32LE(offset, 16);
+    eocd.writeUInt16LE(0, 20); // zip file comment length
+    return Buffer.concat([...locals, ...centrals, eocd]);
+}
+//# sourceMappingURL=zip.js.map

package/package.json

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