@cxmyu/ccglance 1.0.3 → 1.1.1

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,14 @@ 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 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
 
 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,12 @@ Windows 用完整路径,例如 `node D:\\path\\to\\ccglance\\dist\\cli.js`。
 > 全局的 `ccglance` 命令则完全不需要写路径。`"padding": 0` 去掉 Claude Code 默认的左侧缩进,
 > 让状态栏从最左开始。
 
+> **Windows 提速小贴士**:若在意状态栏启动延时,可把 `command` 直接指向编译产物
+> `node D:\\绝对路径\\ccglance\\dist\\cli.js`,通常比走全局 `ccglance` 命令更快一些。
+
 ## 贡献
 
-欢迎提 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,241 @@
+"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]（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;
+// 孤儿瞬时产物阈值：.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;
+// 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('');
+    }
+}
+// 每次运行都做的轻清理：删除过期的孤儿瞬时产物（.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 {
+        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']) {
+        const dir = path_1.default.join(root, sub);
+        let names;
+        try {
+            names = fs_1.default.readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            if (!name.endsWith('.json'))
+                continue;
+            const file = path_1.default.join(dir, name);
+            try {
+                if (nowMs - fs_1.default.statSync(file).mtimeMs > PRUNE_MAX_AGE_MS)
+                    fs_1.default.rmSync(file, { force: true });
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+function main() {
+    const payload = process.argv[2] || '';
+    // 开头先接管清理上一轮遗留的孤儿（含被强杀进程没来得及删的 marker）：即便本次任务中途
+    // 被杀、finally 没跑到，这些残留也会在下一次后台刷新一启动时被清掉，不会长期堆积。
+    try {
+        pruneStaleTransient();
+    }
+    catch { /* best effort */ }
+    try {
+        const tasks = payload ? JSON.parse(payload) : [];
+        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 {
+        // payload 缺失 / 损坏：静默退出，仍走 finally 清理。
+    }
+    finally {
+        try {
+            pruneStaleTransient();
+        }
+        catch { /* best effort */ }
+        try {
+            pruneDeadCaches();
+        }
+        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,52 @@
+"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 单个后台 helper（bg.js）。
+// 合并为一次 spawn，避免冷缓存首帧连发两个后台进程；缓存都新鲜时 queue 为空、直接返回，
+// 常规重绘不起任何后台进程。任务数据经 argv 直接传给 helper（不经 shell、无需临时文件）。
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+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 */ }
+    }
+}
+// 渲染输出完成后调用：把积累的刷新任务交给一个 detached 后台 helper 进程。
+function flushRefreshTasks() {
+    if (!queue.length)
+        return;
+    const tasks = queue.splice(0);
+    try {
+        const helper = path_1.default.join(__dirname, 'bg.js');
+        const payload = JSON.stringify(tasks);
+        const { spawn } = require('child_process');
+        // 直接 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 {
+        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.1",
   "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",