ccus-cli 0.1.0 → 0.1.2

package/README.md

@@ -3,7 +3,7 @@
 一个本地优先的 Claude Code statusline 使用率采集 CLI：
 
 - `ccus install`：自动把 statusLine 命令写进 Claude Code 的 `settings.json`，省去手动改配置。
-- `ccus statusline emit`：读取 Claude Code statusline 通过 `stdin` 传入的 JSON，输出 statusline 文本，并写入本地日志。
+- `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。
@@ -21,12 +21,6 @@
 npm install -g ccus-cli
 ```
 
-安装后 PATH 上即可使用 `ccus` 命令。一次性命令（如 `dashboard` / `export`）也可以用 `npx`：
-
-```bash
-npx ccus-cli export
-```
-
 要求 Node.js >= 20。
 
 ## 快速开始
@@ -88,6 +82,7 @@ ccus install
 ccus install
 ccus install --settings ~/.claude/settings.json
 ccus statusline emit
+ccus statusline emit --no-store   # 只渲染并输出状态行，不写本地日志（别名 --no-log）
 ccus dashboard build --range today --out ./ccus-dashboard.html
 ccus dashboard open --range today
 ccus dashboard serve --range today --open

package/dist/cli.js

@@ -57,7 +57,7 @@ const storage_1 = require("./lib/storage");
 const time_1 = require("./lib/time");
 /** 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]\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\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 aggregate --input-dir DIR [--out-dir DIR]\n  ccus aggregate serve --input-dir DIR [--port 0] [--host 127.0.0.1]\n\nGlobal flags:\n  --verbose | --debug | -v   输出详细调试日志到 stderr（等价于设置 CCUS_DEBUG=1），方便排查问题\n`);
 }
 /** 一个轻量的参数解析器，当前命令面不复杂，没必要引入额外依赖。 */
 function parseOptions(args) {
@@ -139,10 +139,14 @@ async function handleInstall(options) {
  * statusline 主路径：读 payload、归一化、落盘、输出单行状态文本。
  *
  * 这里即使异常也要优雅降级，不能因为采样失败把 statusline 弄挂。
+ *
+ * `--no-store`（别名 `--no-log`）只渲染并输出状态行，不把事件落盘，
+ * 适合预览 statusline 输出或临时禁用采集，stdout 单行契约保持不变。
  */
 async function handleStatuslineEmit(options) {
     const dataDir = getDataDir(options);
-    (0, debug_1.debugLog)("statusline", "start", { dataDir });
+    const noStore = getBooleanOption(options, "no-store") || getBooleanOption(options, "no-log");
+    (0, debug_1.debugLog)("statusline", "start", { dataDir, noStore });
     try {
         const raw = await readInputPayload(options);
         (0, debug_1.debugLog)("statusline", "payload received", { length: raw.length });
@@ -152,7 +156,12 @@ async function handleStatuslineEmit(options) {
         record.gitUserName = gitIdentity.userName;
         record.gitUserEmail = gitIdentity.userEmail;
         record.gitUserAccount = (0, time_1.extractGitEmailAccount)(gitIdentity.userEmail);
-        await (0, storage_1.appendEvent)(dataDir, record);
+        if (noStore) {
+            (0, debug_1.debugLog)("statusline", "no-store enabled, skipping appendEvent");
+        }
+        else {
+            await (0, storage_1.appendEvent)(dataDir, record);
+        }
         const event = (0, payload_1.computeStatuslineEvent)(record);
         (0, debug_1.debugLog)("statusline", "event computed", {
             sessionId: event.sessionId,

package/dist/lib/aggregate-dashboard.js

@@ -199,7 +199,7 @@ function renderDailyUserRequestChart(people, dailyIndex, dateAxis) {
  * 用横向条形图对比每个人的「周使用量（7 天额度）峰值」。
  *
  * 7 天额度是 Claude 给出的滚动周额度使用率，峰值代表这段时间里每个人最接近用满周额度的程度。
- * 条长按当前样本里的最大峰值做归一，方便在数值都偏小时也能横向比较；右侧仍标注绝对百分比。
+ * 条长按固定的 100% 满刻度归一，直接反映绝对使用率水平；右侧仍标注绝对百分比。
  */
 function renderSevenDayPeakChart(people) {
     const ranked = people
@@ -227,7 +227,7 @@ function renderSevenDayPeakChart(people) {
     const height = paddingTop + paddingBottom + ranked.length * rowHeight;
     const trackX = labelWidth;
     const trackWidth = width - labelWidth - valueWidth - 16;
-    const maxValue = Math.max(...ranked.map((person) => person.sevenDayPeakUsagePct ?? 0), 1);
+    const maxValue = 100;
     const bars = ranked
         .map((person, index) => {
         const pct = person.sevenDayPeakUsagePct ?? 0;

package/package.json

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