@cxmyu/ccglance 1.0.3 → 1.1.0

package/README.md

@@ -56,7 +56,7 @@ Update or remove later with `npm update -g @cxmyu/ccglance` / `npm uninstall -g
 ```bash
 git clone https://github.com/CxMYu/CcGlanceLine.git
 cd CcGlanceLine
-npm install             # installs devDeps; the `prepare` script then compiles src/ → dist/
+npm install             # installs devDeps; the `prepare` script then compiles src/ -> dist/
 npm link                # optional: expose `ccglance` on your PATH
 ```
 
@@ -102,10 +102,17 @@ 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`).
+
 ## Contributing
 
 Issues and pull requests are welcome. For code changes, run `npm run typecheck`,
-`npm run build`, and `ccglance preview` before opening a PR; keep the runtime at
+`npm run build`, and `npm run preview` before opening a PR; keep the runtime at
 **zero dependencies** and the style fixed (no config loader).
 
 ## Star History

package/README.zh-CN.md

@@ -54,7 +54,7 @@ npm 会下载**预编译好的 `dist/`**(本机不跑编译器),并把 `ccglance
 ```bash
 git clone https://github.com/CxMYu/CcGlanceLine.git
 cd CcGlanceLine
-npm install             # 安装 devDeps；随后 prepare 脚本自动编译 src/ → dist/
+npm install             # 安装 devDeps；随后 prepare 脚本自动编译 src/ -> dist/
 npm link                # 可选：把 ccglance 链到本机 PATH
 ```
 
@@ -97,9 +97,14 @@ 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`)。
+
 ## 贡献
 
-欢迎提 issue 和 PR。改代码前请先跑 `npm run typecheck`、`npm run build`、`ccglance preview`;
+欢迎提 issue 和 PR。改代码前请先跑 `npm run typecheck`、`npm run build`、`npm run preview`;
 请保持**运行时零依赖**和固定风格(不加配置加载器)。
 
 ## Star History

package/dist/cli.js

@@ -70,6 +70,7 @@ if (argv[0] === 'preview') {
         const { scheduleRefresh } = require('./runtime/version');
         scheduleRefresh();
     }
+    require('./runtime/refresh').flushRefreshTasks();
     process.exit(0);
 }
 // 在真实终端直接运行（stdin 是 TTY、没有管道喂 JSON）时，显示帮助而非阻塞等待 stdin。
@@ -89,3 +90,5 @@ if (data.version && hasEnabledSegment(DEFAULT_SPEC, 'version')) {
     const { scheduleRefresh } = require('./runtime/version');
     scheduleRefresh();
 }
+// 渲染期间入队的后台刷新（git / version）最后一次性 spawn，不阻塞状态栏输出。
+require('./runtime/refresh').flushRefreshTasks();

package/dist/runtime/bg.js

@@ -0,0 +1,208 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// 后台刷新 helper —— 由 refresh.ts 以 detached 进程启动，绝不被状态栏进程等待。
+// 任务列表从 argv[2] 指向的 task-*.json 读入，全部尽力而为、静默失败：
+//   git     —— 单次有界 `git status --porcelain=v2 --branch`，解析后原子写缓存
+//   version —— 拉 npm registry 的 Claude Code 最新版本，原子写缓存
+// 每个任务无论成败都要移除自己的 .refresh marker，否则只能等节流窗口过期。
+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 过期删除（活跃条目会被刷新持续续命）。
+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 = '';
+    let oid = '';
+    let ahead = 0;
+    let behind = 0;
+    let dirty = false;
+    let conflict = false;
+    for (const raw of out.split(/\r?\n/)) {
+        const line = raw.trimEnd();
+        if (!line)
+            continue;
+        if (line.startsWith('# branch.head ')) {
+            head = line.slice('# branch.head '.length).trim();
+            continue;
+        }
+        if (line.startsWith('# branch.oid ')) {
+            oid = line.slice('# branch.oid '.length).trim();
+            continue;
+        }
+        if (line.startsWith('# branch.ab ')) {
+            const m = /# branch\.ab \+(\d+) -(\d+)/.exec(line);
+            if (m) {
+                ahead = parseInt(m[1], 10) || 0;
+                behind = parseInt(m[2], 10) || 0;
+            }
+            continue;
+        }
+        if (line[0] === '#')
+            continue;
+        if (line.startsWith('u '))
+            conflict = true;
+        if (!line.startsWith('! '))
+            dirty = true;
+    }
+    const branch = head && head !== '(detached)' ? head : oid.slice(0, 8);
+    if (!branch)
+        return null;
+    return { branch, glyph: conflict ? '⚠' : dirty ? '●' : '✓', ahead, behind };
+}
+function atomicWrite(file, data) {
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs_1.default.mkdirSync(path_1.default.dirname(file), { recursive: true });
+    fs_1.default.writeFileSync(tmp, data);
+    fs_1.default.renameSync(tmp, file);
+}
+function rmMarker(marker) {
+    try {
+        fs_1.default.rmSync(marker, { force: true });
+    }
+    catch { /* ignore */ }
+}
+function runGitTask(root, cacheFile) {
+    const { execFileSync } = require('child_process');
+    const out = execFileSync('git', ['--no-optional-locks', '-C', root, 'status', '--porcelain=v2', '--branch'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+        timeout: GIT_TIMEOUT_MS,
+        windowsHide: true,
+    });
+    const info = parseStatus(out);
+    if (info)
+        atomicWrite(cacheFile, JSON.stringify({ ...info, checkedAt: Date.now() }));
+}
+function runVersionTask(cacheFile, done) {
+    let prev = '';
+    try {
+        prev = JSON.parse(fs_1.default.readFileSync(cacheFile, 'utf8')).latest || '';
+    }
+    catch { /* no previous cache */ }
+    let finished = false;
+    const finish = (latest) => {
+        if (finished)
+            return;
+        finished = true;
+        try {
+            atomicWrite(cacheFile, JSON.stringify({ latest: latest || prev, checkedAt: Date.now() }));
+        }
+        catch { /* ignore */ }
+        done();
+    };
+    try {
+        const https = require('https');
+        const req = https.get('https://registry.npmjs.org/@anthropic-ai/claude-code/latest', (r) => {
+            if (r.statusCode !== 200) {
+                r.resume();
+                return finish('');
+            }
+            let d = '';
+            r.on('data', (c) => { d += c; });
+            r.on('end', () => {
+                try {
+                    finish(JSON.parse(d).version || '');
+                }
+                catch {
+                    finish('');
+                }
+            });
+        });
+        req.on('error', () => finish(''));
+        req.setTimeout(5000, () => { req.destroy(); finish(''); });
+    }
+    catch {
+        finish('');
+    }
+}
+// 过期清理：正常缓存 json 超过 30 天未被刷新（mtime）视为死条目；
+// .refresh / .tmp / tasks 超过 1 小时视为进程夭折的残留。逐文件尽力而为。
+function pruneCaches(nowMs = Date.now()) {
+    const root = (0, paths_1.appCacheDir)();
+    const stamp = path_1.default.join(root, 'prune.stamp');
+    try {
+        if (nowMs - fs_1.default.statSync(stamp).mtimeMs < PRUNE_INTERVAL_MS)
+            return;
+    }
+    catch { /* 无 stamp → 首次清理 */ }
+    try {
+        fs_1.default.mkdirSync(root, { recursive: true });
+        fs_1.default.writeFileSync(stamp, String(nowMs));
+    }
+    catch {
+        return;
+    }
+    for (const sub of ['git', 'transcript', 'version', '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) {
+            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)) {
+                    fs_1.default.rmSync(file, { force: true });
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+function main() {
+    const taskFile = process.argv[2] || '';
+    try {
+        // 任务文件已由 refresh.ts 原子写入；读损坏时 markers 交给节流窗口 + prune 兜底。
+        const tasks = taskFile ? JSON.parse(fs_1.default.readFileSync(taskFile, 'utf8')) : [];
+        for (const task of tasks) {
+            if (task.kind === 'git') {
+                try {
+                    runGitTask(task.root, task.cacheFile);
+                }
+                catch { /* best effort */ }
+                rmMarker(task.marker);
+            }
+            else if (task.kind === 'version') {
+                try {
+                    runVersionTask(task.cacheFile, () => rmMarker(task.marker));
+                }
+                catch {
+                    rmMarker(task.marker);
+                }
+            }
+        }
+    }
+    catch {
+        // 任务文件缺失 / 损坏：静默退出，仍走 finally 清理。
+    }
+    finally {
+        if (taskFile) {
+            try {
+                fs_1.default.rmSync(taskFile, { force: true });
+            }
+            catch { /* ignore */ }
+        }
+        try {
+            pruneCaches();
+        }
+        catch { /* best effort */ }
+    }
+}
+if (require.main === module)
+    main();

package/dist/runtime/git.js

@@ -9,9 +9,9 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const colors_1 = require("../render/colors");
 const paths_1 = require("../utils/paths");
+const refresh_1 = require("./refresh");
 const CACHE_DIR = (0, paths_1.cacheDir)('git');
 const DEFAULT_TTL_MS = 20 * 60 * 1000;
-const GIT_TIMEOUT_MS = 700;
 const REFRESH_THROTTLE_MS = 5000;
 function resolveGitPaths(cwd) {
     const abs = path_1.default.resolve(cwd);
@@ -83,45 +83,6 @@ function shouldRefresh(paths) {
         return false;
     }
 }
-function parseStatus(out) {
-    let head = '';
-    let oid = '';
-    let ahead = 0;
-    let behind = 0;
-    let dirty = false;
-    let conflict = false;
-    for (const raw of out.split(/\r?\n/)) {
-        const line = raw.trimEnd();
-        if (!line)
-            continue;
-        if (line.startsWith('# branch.head ')) {
-            head = line.slice('# branch.head '.length).trim();
-            continue;
-        }
-        if (line.startsWith('# branch.oid ')) {
-            oid = line.slice('# branch.oid '.length).trim();
-            continue;
-        }
-        if (line.startsWith('# branch.ab ')) {
-            const m = /# branch\.ab \+(\d+) -(\d+)/.exec(line);
-            if (m) {
-                ahead = parseInt(m[1], 10) || 0;
-                behind = parseInt(m[2], 10) || 0;
-            }
-            continue;
-        }
-        if (line[0] === '#')
-            continue;
-        if (line.startsWith('u '))
-            conflict = true;
-        if (!line.startsWith('! '))
-            dirty = true;
-    }
-    const branch = head && head !== '(detached)' ? head : oid.slice(0, 8);
-    if (!branch)
-        return null;
-    return { branch, glyph: conflict ? '⚠' : dirty ? '●' : '✓', ahead, behind };
-}
 function readHeadFallback(root) {
     if (!root)
         return null;
@@ -149,29 +110,11 @@ function branchHintFallback(branchHint) {
     const branch = branchHint && branchHint.trim();
     return branch ? { branch, ahead: 0, behind: 0 } : null;
 }
+// 只入队不 spawn：gitSegment 在渲染期间被调用，spawn 留到 stdout 写出后统一 flush。
 function scheduleGitRefresh(paths) {
     if (!paths.root || !shouldRefresh(paths))
         return;
-    try {
-        const bg = "const fs=require('fs'),path=require('path'),{execFileSync}=require('child_process');" +
-            "const cwd=" + JSON.stringify(paths.root) + ";" +
-            "const cf=" + JSON.stringify(paths.cacheFile) + ";" +
-            "const marker=" + JSON.stringify(paths.refreshFile) + ";" +
-            "const parseStatus=" + parseStatus.toString() + ";" +
-            "const save=obj=>{const tmp=cf+'.'+process.pid+'.tmp';fs.mkdirSync(path.dirname(cf),{recursive:true});fs.writeFileSync(tmp,JSON.stringify(obj));fs.renameSync(tmp,cf)};" +
-            "try{" +
-            "const out=execFileSync('git',['--no-optional-locks','-C',cwd,'status','--porcelain=v2','--branch'],{encoding:'utf8',stdio:['ignore','pipe','ignore'],timeout:" + GIT_TIMEOUT_MS + ",windowsHide:true});" +
-            "const info=parseStatus(out);if(info)save({...info,checkedAt:Date.now()});" +
-            "}catch{}finally{try{fs.rmSync(marker,{force:true})}catch{}}";
-        const { spawn } = require('child_process');
-        spawn(process.execPath, ['-e', bg], { detached: true, stdio: 'ignore', windowsHide: true }).unref();
-    }
-    catch {
-        try {
-            fs_1.default.rmSync(paths.refreshFile, { force: true });
-        }
-        catch { /* ignore */ }
-    }
+    (0, refresh_1.queueRefreshTask)({ kind: 'git', root: paths.root, cacheFile: paths.cacheFile, marker: paths.refreshFile });
 }
 function formatGit(info, icon, worktreeName) {
     const status = [];

package/dist/runtime/refresh.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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 只接收任务文件路径。
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const paths_1 = require("../utils/paths");
+const queue = [];
+// 入队前调用方必须已独占抢到对应 marker（多进程节流语义保持不变）。
+function queueRefreshTask(task) {
+    queue.push(task);
+}
+function removeMarkers(tasks) {
+    for (const t of tasks) {
+        try {
+            fs_1.default.rmSync(t.marker, { force: true });
+        }
+        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 { 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);
+        });
+        child.unref();
+    }
+    catch {
+        if (taskFile) {
+            try {
+                fs_1.default.rmSync(taskFile, { force: true });
+            }
+            catch { /* ignore */ }
+        }
+        removeMarkers(tasks);
+    }
+}

package/dist/runtime/version.js

@@ -8,6 +8,7 @@ exports.scheduleRefresh = scheduleRefresh;
 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 REFRESH_THROTTLE_MS = 60 * 1000;
 const cacheFile = path_1.default.join((0, paths_1.cacheDir)('version'), 'claude-code.json');
@@ -48,6 +49,7 @@ function shouldRefresh() {
         return false;
     }
 }
+// 只入队不 spawn：实际后台进程由 cli 在 stdout 写出后统一 flush（见 runtime/refresh.ts）。
 function scheduleRefresh() {
     try {
         const age = Date.now() - (readCache().checkedAt || 0);
@@ -55,21 +57,7 @@ function scheduleRefresh() {
             return;
         if (!shouldRefresh())
             return;
-        const bg = "const https=require('https'),fs=require('fs'),path=require('path');" +
-            "const f=" + JSON.stringify(cacheFile) + ";" +
-            "const marker=" + JSON.stringify(refreshFile) + ";" +
-            "let prev='';try{prev=(JSON.parse(fs.readFileSync(f,'utf8')).latest)||''}catch{}" +
-            "let done=false;const finish=v=>{if(done)return;done=true;" +
-            "try{const tmp=f+'.'+process.pid+'.tmp';fs.mkdirSync(path.dirname(f),{recursive:true});fs.writeFileSync(tmp,JSON.stringify({latest:v||prev,checkedAt:Date.now()}));fs.renameSync(tmp,f)}catch{}" +
-            "try{fs.rmSync(marker,{force:true})}catch{}};" +
-            "try{" +
-            "const req=https.get('https://registry.npmjs.org/@anthropic-ai/claude-code/latest',r=>{" +
-            "if(r.statusCode!==200){r.resume();return finish('')}" +
-            "let d='';r.on('data',c=>d+=c);r.on('end',()=>{try{finish(JSON.parse(d).version)}catch{finish('')}})" +
-            "});req.on('error',()=>finish(''));req.setTimeout(5000,()=>{req.destroy();finish('')});" +
-            "}catch{finish('')}";
-        const { spawn } = require('child_process');
-        spawn(process.execPath, ['-e', bg], { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+        (0, refresh_1.queueRefreshTask)({ kind: 'version', cacheFile, marker: refreshFile });
     }
     catch {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxmyu/ccglance",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "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"
@@ -22,6 +22,7 @@
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "npm run clean && tsc",
     "typecheck": "tsc --noEmit",
+    "preview": "node dist/cli.js preview",
     "test": "npm run build && node --test test/*.test.js",
     "benchmark": "npm run build && node bench/latency.js",
     "prepare": "npm run build",