@cxmyu/ccglance 1.1.0 → 1.1.2

package/README.md

@@ -19,6 +19,18 @@ model · effort · context · cache · git · session — all at a glance
 
 **Docs:** [Overview](./docs/overview.md) · [Segments & icons](./docs/segments.md) · [Development](./docs/development.md)
 
+## Terminal Font
+
+Use a Nerd Font in your terminal so emoji, Nerd Font icons, arrows, and box-like
+symbols keep consistent width. [Maple Mono NF](https://github.com/subframe7536/maple-font)
+is a good default; use `Maple Mono NF CN` if you want better CJK coverage.
+
+ccglance intentionally outputs standard Unicode emoji. A Nerd Font improves text
+metrics and symbol coverage, but color emoji are still rendered by the operating
+system's emoji font (for example Segoe UI Emoji on Windows, Apple Color Emoji on
+macOS, and Noto Color Emoji on many Linux desktops), so their artwork can differ
+across platforms.
+
 ## Install
 
 ### Option A — npm (global, recommended)
@@ -102,12 +114,9 @@ On Windows use a full path, e.g. `node D:\\path\\to\\ccglance\\dist\\cli.js`.
 > command needs no path at all. `"padding": 0` drops Claude Code's default leading
 > indent so the row starts at the left edge.
 
-> **Windows latency tip:** the global `ccglance` command is an npm `.cmd` shim,
-> which adds a cmd batch layer plus a PATH lookup on every redraw — tens to
-> hundreds of milliseconds depending on antivirus and system cache state. For
-> the lowest latency, point `command` directly at the compiled file:
-> `node D:\\absolute\\path\\to\\ccglance\\dist\\cli.js` (a global install lives
-> at `<npm global dir>\\node_modules\\@cxmyu\\ccglance\\dist\\cli.js`).
+> **Windows tip:** if status-line startup latency matters, point `command`
+> directly at the compiled file (`node D:\\absolute\\path\\to\\ccglance\\dist\\cli.js`)
+> instead of the global `ccglance` command — it usually starts a bit faster.
 
 ## Contributing
 

package/README.zh-CN.md

@@ -19,6 +19,16 @@
 
 **文档:** [概览](./docs/overview.zh-CN.md) · [字段与图标](./docs/segments.zh-CN.md) · [开发](./docs/development.zh-CN.md)
 
+## 终端字体
+
+终端建议使用 Nerd Font,避免 emoji、Nerd Font 图标、箭头和类进度符号宽度不一致。
+首选可以用 [Maple Mono NF](https://github.com/subframe7536/maple-font);
+需要更好的中文显示时用 `Maple Mono NF CN`。
+
+ccglance 会固定输出标准 Unicode emoji。Nerd Font 可以改善文本宽度和符号覆盖,
+但彩色 emoji 仍由系统 emoji 字体渲染(例如 Windows 的 Segoe UI Emoji、
+macOS 的 Apple Color Emoji、很多 Linux 桌面的 Noto Color Emoji),所以不同平台的图案可能不同。
+
 ## 安装
 
 ### 方式 A —— npm 全局安装(推荐)
@@ -97,10 +107,8 @@ Windows 用完整路径,例如 `node D:\\path\\to\\ccglance\\dist\\cli.js`。
 > 全局的 `ccglance` 命令则完全不需要写路径。`"padding": 0` 去掉 Claude Code 默认的左侧缩进,
 > 让状态栏从最左开始。
 
-> **Windows 延时提示**:全局命令 `ccglance` 实际是 npm 的 `.cmd` shim,每次重绘要多走一层
-> cmd 批处理 + PATH 查找,视杀软/系统缓存状态可能多几十到上百毫秒。追求最低延时时,
-> 建议 `command` 直接写 `node D:\\绝对路径\\ccglance\\dist\\cli.js`(全局安装的包在
-> `<npm 全局目录>\\node_modules\\@cxmyu\\ccglance\\dist\\cli.js`)。
+> **Windows 提速小贴士**:若在意状态栏启动延时,可把 `command` 直接指向编译产物
+> `node D:\\绝对路径\\ccglance\\dist\\cli.js`,通常比走全局 `ccglance` 命令更快一些。
 
 ## 贡献
 

package/dist/runtime/bg.js

@@ -4,19 +4,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // 后台刷新 helper —— 由 refresh.ts 以 detached 进程启动，绝不被状态栏进程等待。
-// 任务列表从 argv[2] 指向的 task-*.json 读入，全部尽力而为、静默失败：
+// 任务列表从 argv[2]（JSON）读入，全部尽力而为、静默失败：
 //   git     —— 单次有界 `git status --porcelain=v2 --branch`，解析后原子写缓存
 //   version —— 拉 npm registry 的 Claude Code 最新版本，原子写缓存
 // 每个任务无论成败都要移除自己的 .refresh marker，否则只能等节流窗口过期。
+// 每次运行还顺手清理孤儿产物：过期的 .refresh / .tmp（及历史遗留的 tasks/ 目录）。
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const paths_1 = require("../utils/paths");
 const GIT_TIMEOUT_MS = 700;
-// 缓存清理：每天最多一次（stamp 节流）。缓存 key 是仓库/transcript 路径的哈希，
-// 临时目录一去不返时对应 json 便成死条目，按 mtime 过期删除（活跃条目会被刷新持续续命）。
+// 孤儿瞬时产物阈值：.refresh/.tmp 本应几秒内被删（helper 最长约 5s）；超过此值即视为
+// 夭折进程的残留。每次运行开头 + 结尾各清一次，故取较短的 2 分钟让残留更快被接管清理。
+const STALE_TRANSIENT_MS = 2 * 60 * 1000;
+// 死缓存清理：缓存 key 是仓库/transcript 路径哈希，临时目录一去不返时对应 json 便成死条目。
+// 每天最多清一次（stamp 节流），删除长期未刷新的缓存 json（活跃条目会被刷新持续续命）。
 const PRUNE_INTERVAL_MS = 24 * 3600 * 1000;
 const PRUNE_MAX_AGE_MS = 30 * 24 * 3600 * 1000;
-const PRUNE_TRANSIENT_MAX_AGE_MS = 3600 * 1000; // 残留 .refresh 标记 / .tmp 半成品 / task 文件
 // git status --porcelain=v2 --branch 输出解析（与渲染端 GitCache 结构保持一致）。
 function parseStatus(out) {
     let head = '';
@@ -123,9 +126,40 @@ function runVersionTask(cacheFile, done) {
         finish('');
     }
 }
-// 过期清理：正常缓存 json 超过 30 天未被刷新（mtime）视为死条目；
-// .refresh / .tmp / tasks 超过 1 小时视为进程夭折的残留。逐文件尽力而为。
-function pruneCaches(nowMs = Date.now()) {
+// 每次运行都做的轻清理：删除过期的孤儿瞬时产物（.refresh / .tmp），以及历史遗留的
+// tasks/ 目录内容。成本很低（这些目录文件很少），能让残留不再累积。
+function pruneStaleTransient(nowMs = Date.now()) {
+    const root = (0, paths_1.appCacheDir)();
+    for (const sub of ['git', 'version', 'transcript', 'tasks']) {
+        const dir = path_1.default.join(root, sub);
+        let names;
+        try {
+            names = fs_1.default.readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            // tasks/ 已弃用：其中任何文件都算历史遗留；其他目录只清 .refresh / .tmp 瞬时产物。
+            if (sub !== 'tasks' && !name.endsWith('.refresh') && !name.endsWith('.tmp'))
+                continue;
+            const file = path_1.default.join(dir, name);
+            try {
+                if (nowMs - fs_1.default.statSync(file).mtimeMs > STALE_TRANSIENT_MS)
+                    fs_1.default.rmSync(file, { force: true });
+            }
+            catch { /* ignore */ }
+        }
+        if (sub === 'tasks') {
+            try {
+                fs_1.default.rmdirSync(dir);
+            }
+            catch { /* 非空/不存在都忽略 */ }
+        }
+    }
+}
+// 每天最多一次（stamp 节流）：删除长期未刷新的死缓存 json。
+function pruneDeadCaches(nowMs = Date.now()) {
     const root = (0, paths_1.appCacheDir)();
     const stamp = path_1.default.join(root, 'prune.stamp');
     try {
@@ -140,7 +174,7 @@ function pruneCaches(nowMs = Date.now()) {
     catch {
         return;
     }
-    for (const sub of ['git', 'transcript', 'version', 'tasks']) {
+    for (const sub of ['git', 'transcript', 'version']) {
         const dir = path_1.default.join(root, sub);
         let names;
         try {
@@ -150,26 +184,27 @@ function pruneCaches(nowMs = Date.now()) {
             continue;
         }
         for (const name of names) {
+            if (!name.endsWith('.json'))
+                continue;
             const file = path_1.default.join(dir, name);
             try {
-                const st = fs_1.default.statSync(file);
-                if (!st.isFile())
-                    continue;
-                const age = nowMs - st.mtimeMs;
-                const transient = sub === 'tasks' || name.endsWith('.refresh') || name.endsWith('.tmp');
-                if (age > (transient ? PRUNE_TRANSIENT_MAX_AGE_MS : PRUNE_MAX_AGE_MS)) {
+                if (nowMs - fs_1.default.statSync(file).mtimeMs > PRUNE_MAX_AGE_MS)
                     fs_1.default.rmSync(file, { force: true });
-                }
             }
             catch { /* ignore */ }
         }
     }
 }
 function main() {
-    const taskFile = process.argv[2] || '';
+    const payload = process.argv[2] || '';
+    // 开头先接管清理上一轮遗留的孤儿（含被强杀进程没来得及删的 marker）：即便本次任务中途
+    // 被杀、finally 没跑到，这些残留也会在下一次后台刷新一启动时被清掉，不会长期堆积。
     try {
-        // 任务文件已由 refresh.ts 原子写入；读损坏时 markers 交给节流窗口 + prune 兜底。
-        const tasks = taskFile ? JSON.parse(fs_1.default.readFileSync(taskFile, 'utf8')) : [];
+        pruneStaleTransient();
+    }
+    catch { /* best effort */ }
+    try {
+        const tasks = payload ? JSON.parse(payload) : [];
         for (const task of tasks) {
             if (task.kind === 'git') {
                 try {
@@ -189,17 +224,15 @@ function main() {
         }
     }
     catch {
-        // 任务文件缺失 / 损坏：静默退出，仍走 finally 清理。
+        // payload 缺失 / 损坏：静默退出，仍走 finally 清理。
     }
     finally {
-        if (taskFile) {
-            try {
-                fs_1.default.rmSync(taskFile, { force: true });
-            }
-            catch { /* ignore */ }
+        try {
+            pruneStaleTransient();
         }
+        catch { /* best effort */ }
         try {
-            pruneCaches();
+            pruneDeadCaches();
         }
         catch { /* best effort */ }
     }

package/dist/runtime/refresh.js

@@ -6,16 +6,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.queueRefreshTask = queueRefreshTask;
 exports.flushRefreshTasks = flushRefreshTasks;
 // 后台刷新调度 —— 渲染期间各段只「入队」（调用方先抢占各自的 .refresh marker），
-// stdout 写出后由 cli 调 flushRefreshTasks() 一次性 spawn 单个 detached helper（bg.js）。
-//
-// 为什么不各自直接 spawn：Windows 上发起一个 node.exe 子进程的同步成本很高
-// （CreateProcess + 杀软扫描，实测 ~80-110ms），冷缓存首帧会连发两个，直接拖慢状态栏。
-// 合并为一次，并在 Windows 上经 cmd `start /b` 蹦床发起（实测 ~17ms）：node 的真实
-// 启动成本由蹦床在本进程退出后承担，不再占用状态栏进程的生命周期。
-// 任务负载写入 ~/.claude/ccglance/tasks/task-*.json，helper 只接收任务文件路径。
+// stdout 写出后由 cli 调 flushRefreshTasks() 一次性 spawn 单个后台 helper（bg.js）。
+// 合并为一次 spawn，避免冷缓存首帧连发两个后台进程；缓存都新鲜时 queue 为空、直接返回，
+// 常规重绘不起任何后台进程。任务数据经 argv 直接传给 helper（不经 shell、无需临时文件）。
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const paths_1 = require("../utils/paths");
 const queue = [];
 // 入队前调用方必须已独占抢到对应 marker（多进程节流语义保持不变）。
 function queueRefreshTask(task) {
@@ -29,50 +24,29 @@ function removeMarkers(tasks) {
         catch { /* ignore */ }
     }
 }
-function writeTaskFile(tasks) {
-    const dir = (0, paths_1.cacheDir)('tasks');
-    fs_1.default.mkdirSync(dir, { recursive: true });
-    const file = path_1.default.join(dir, `task-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}.json`);
-    const tmp = `${file}.tmp`;
-    fs_1.default.writeFileSync(tmp, JSON.stringify(tasks));
-    fs_1.default.renameSync(tmp, file);
-    return file;
-}
-function quoteCmdArg(s) {
-    return `"${s}"`;
-}
 // 渲染输出完成后调用：把积累的刷新任务交给一个 detached 后台 helper 进程。
 function flushRefreshTasks() {
     if (!queue.length)
         return;
     const tasks = queue.splice(0);
-    let taskFile = '';
     try {
         const helper = path_1.default.join(__dirname, 'bg.js');
-        taskFile = writeTaskFile(tasks);
+        const payload = JSON.stringify(tasks);
         const { spawn } = require('child_process');
-        // Windows：node.exe 的 CreateProcess 同步成本很高（杀软扫描），改用 cmd `start /b`
-        // 蹦床（发起 ~17ms），真正的 node 启动开销由蹦床在本进程退出后承担。
-        // 任务本身在文件里；cmd 只需要转发 node/helper/taskFile 三个路径参数。
-        const child = process.platform === 'win32'
-            ? spawn('cmd.exe', ['/d', '/s', '/c', `start "" /b ${quoteCmdArg(process.execPath)} ${quoteCmdArg(helper)} ${quoteCmdArg(taskFile)}`], { detached: true, stdio: 'ignore', windowsHide: true, windowsVerbatimArguments: true })
-            : spawn(process.execPath, [helper, taskFile], { detached: true, stdio: 'ignore' });
-        child.on('error', () => {
-            try {
-                fs_1.default.rmSync(taskFile, { force: true });
-            }
-            catch { /* ignore */ }
-            removeMarkers(tasks);
+        // 直接 detached spawn node，不经 shell：
+        // - 任务数据用一个 argv 参数（JSON）传给 helper；spawn 不走 shell，无引号/转义问题，
+        //   因此不需要临时任务文件（历史上用过 task-*.json，是残留主因，已弃用）。
+        // - detached 让 helper 脱离父进程独立跑完，并在结束时清理自己的 marker，避免残留。
+        // - Windows 关键坑：绝不同时设 detached + windowsHide —— 两个 flag 冲突会意外弹出
+        //   控制台黑窗。detached 单独即 DETACHED_PROCESS，本就不分配控制台，因此静默。
+        const child = spawn(process.execPath, [helper, payload], {
+            detached: true,
+            stdio: 'ignore',
         });
+        child.on('error', () => removeMarkers(tasks));
         child.unref();
     }
     catch {
-        if (taskFile) {
-            try {
-                fs_1.default.rmSync(taskFile, { force: true });
-            }
-            catch { /* ignore */ }
-        }
         removeMarkers(tasks);
     }
 }

package/dist/runtime/version.js

@@ -9,7 +9,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const paths_1 = require("../utils/paths");
 const refresh_1 = require("./refresh");
-const CACHE_TTL_MS = 4 * 3600 * 1000;
+const CACHE_TTL_MS = 2 * 3600 * 1000;
 const REFRESH_THROTTLE_MS = 60 * 1000;
 const cacheFile = path_1.default.join((0, paths_1.cacheDir)('version'), 'claude-code.json');
 const refreshFile = path_1.default.join((0, paths_1.cacheDir)('version'), 'claude-code.refresh');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxmyu/ccglance",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A fast, zero-dependency, multi-line status line for Claude Code — model, effort, context, cache, git and session, all at a glance.",
   "bin": {
     "ccglance": "dist/cli.js"