@cxmyu/ccglance 1.0.2 → 1.1.0

package/README.md

@@ -1,72 +1,23 @@
+<div align="center">
+
 # ccglance
 
-> A fast, zero-dependency, multi-line status line for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — model, effort, context, cache, git and session, all at a glance.
+**A fast, zero-dependency, multi-line status line for [Claude Code](https://docs.anthropic.com/en/docs/claude-code)**
+
+model · effort · context · cache · git · session — all at a glance
 
 [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-3c873a)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-English | [简体中文](./README.zh-CN.md)
-
-Repository: [github.com/CxMYu/CcGlanceLine](https://github.com/CxMYu/CcGlanceLine)
-
-`ccglance` uses the JSON that Claude Code pipes to its status-line command
-on stdin as its primary data source; the session `status` segment reads only
-the transcript tail when enabled. It's written in
-**TypeScript** and ships as compiled JavaScript with **zero runtime
-dependencies** (Node standard library only).
+[English](./README.md) · [简体中文](./README.zh-CN.md) · [GitHub](https://github.com/CxMYu/CcGlanceLine)
 
-## Documentation
-
-- [Segment & icon reference](./docs/segments.md) — every segment's data source, all icon meanings, rate-limit levels and color semantics
-- [Development](./docs/development.md) — build, test, source layout, contribution practices and git cache internals
+![ccglance preview](./docs/assets/preview.png)
 
-## Preview
+</div>
 
-![ccglance preview](./docs/assets/preview.png)
+> **stdin-first · zero runtime dependencies · fixed emoji style** — renders the JSON Claude Code pipes to its status-line command; only the `status` segment reads a bounded transcript tail. Written in TypeScript, shipped as compiled JavaScript; runs on Node.js ≥ 22 or Bun.
 
-Generated from `ccglance preview`.
-
-## Features
-
-- **Compact multi-line layout** — runtime, quota and project/session state are
-  separate logical rows; empty rows disappear.
-- **Zero runtime dependencies** — Node standard library only; TypeScript is a
-  build-time tool, never shipped in the published package.
-- **stdin-first** — core segments consume the JSON Claude Code provides; status
-  reads a bounded transcript tail only when used.
-- **Rich context block** — usage %, this-turn input/output tokens, tokens left.
-- **Prompt-cache block** — cache hit rate, read/write tokens.
-- **Git segment** — branch, clean/dirty/conflict glyph, ahead/behind counts,
-  using one bounded `git status` call plus a short local cache.
-- **Session segment** — elapsed time plus lines added/removed.
-- **Claude Code version + update hint** — shows the `version` field from
-  Claude Code stdin and appends `↑latest` when the 4h local cache reports a
-  newer Claude Code release. Refresh runs after stdout and never blocks.
-- **Additional session context** — 5h/7d rate-limit quota, USD cost and
-  worktree name next to the git branch when Claude Code provides it.
-- **Responsive multi-line layout** — probes the terminal width
-  (`CCGLANCE_WIDTH` → `COLUMNS` → TTY → `tput`/`stty`) and wraps each row into
-  as many lines as fit, down to a minimum of **one segment per line** so
-  nothing gets hidden; display-width aware (CJK/emoji safe).
-- **Fixed built-in style** — no user config file and no external style file;
-  the status line uses ccglance's own emoji-first style.
-
-## Requirements
-
-- Node.js **>= 22**
-- `git` on `PATH` (optional — only for the git segment)
-
-Claude Code compatibility:
-
-| Claude Code CLI | ccglance behavior |
-|---|---|
-| >= 1.0.71 | Basic status-line stdin support |
-| >= 2.1.80 | Subscription quota row when official `rate_limits.five_hour` / `rate_limits.seven_day` fields are present |
-| >= 2.1.153 | Preferred terminal-width sizing through `COLUMNS` / `LINES`; older versions fall back to TTY width or 80 columns |
-
-The quota row is subscription-only. Claude.ai Pro/Max-style sessions can expose
-`rate_limits`; API-key, Bedrock, Vertex, and other usage-based sessions usually
-do not, so ccglance hides the quota row instead of inferring one.
+**Docs:** [Overview](./docs/overview.md) · [Segments & icons](./docs/segments.md) · [Development](./docs/development.md)
 
 ## Install
 
@@ -76,6 +27,7 @@ do not, so ccglance hides the quota row instead of inferring one.
 npm install -g @cxmyu/ccglance          # npm
 yarn global add @cxmyu/ccglance         # or yarn
 pnpm add -g @cxmyu/ccglance             # or pnpm
+bun add -g @cxmyu/ccglance              # or bun
 ```
 
 Behind a slow registry? Use a mirror:
@@ -104,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
 ```
 
@@ -150,73 +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.
 
-## Status line at a glance
-
-Three logical rows; any row with no data disappears:
-
-1. **Runtime** — 🤖 model · 🧠 effort · status · 🚀 fast · ⚡️ context · 💾 cache · 🎯 style
-2. **Quota** *(subscription sessions only)* — 📊 Hour / Week rate-limit meters
-3. **Project / session** — 📁 dir · 🌿 git · 🏷️ session name · ⏱️ session · 💰 cost · 💩 version
-
-**Full reference** — every segment's stdin source, all icon meanings, rate-limit
-moon-phase levels, session-status icons and color semantics — lives in
-**[docs/segments.md](./docs/segments.md)**.
-
-## How it works
-
-On every redraw Claude Code runs your status-line `command` and pipes a JSON
-object to its **stdin** (model, effort, context window, cost, workspace,
-version, …). `ccglance` reads that once via `fs.readFileSync(0)`, formats its
-fixed rows, and **prints them first**. The `status` segment reads only a
-bounded transcript tail. The version segment synchronously
-reads only a tiny local cache; after stdout is written, ccglance refreshes the
-Claude Code latest-version cache in a detached background process when it is
-older than 4 hours. If the JSON can't be parsed it exits silently so it can never
-break the CLI. Text from stdin, transcript, and git is sanitized before being
-printed so terminal control sequences cannot escape the status line. The main
-external calls are local `git` (single bounded status call with a short cache),
-bounded transcript-tail reads, and the post-render detached npm registry check.
-
-## Development
-
-Source build, tests, benchmark, source layout, contribution practices and git
-cache internals live in **[docs/development.md](./docs/development.md)**. Quick start:
-
-```bash
-git clone https://github.com/CxMYu/CcGlanceLine.git
-cd CcGlanceLine
-npm install        # devDeps + prepare build
-npm test           # build + node:test
-```
-
-## Cache Files
-
-ccglance stores only disposable runtime caches: git status, transcript-derived
-status, and the Claude Code latest-version check. Files are grouped under
-`git/`, `transcript/`, and `version/`.
-
-Caches live under Claude Code's own config directory on every platform, so they
-travel with your Claude setup and are trivial to clear:
-
-```text
-~/.claude/ccglance/
-├── git/          # git status snapshots (one per repo)
-├── transcript/   # transcript-derived session status
-└── version/      # Claude Code latest-version check
-```
-
-If you set `CLAUDE_CONFIG_DIR` to relocate Claude Code's config, ccglance places
-its caches under that directory instead. Deleting the whole `ccglance/` folder is
-safe — every file is regenerated on the next render.
-
-Git cache behavior (cache key, `HEAD` fallback, 20-minute TTL, detached refresh,
-atomic writes) is documented in
-[docs/development.md](./docs/development.md#git-cache-internals).
+> **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

@@ -1,61 +1,23 @@
+<div align="center">
+
 # ccglance
 
-> 面向 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 的轻量多行状态栏 —— 模型、effort、上下文、缓存、git、会话,一眼尽览。TypeScript 编写、运行时零依赖。
+**面向 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 的快速、零依赖多行状态栏**
+
+模型 · effort · 上下文 · 缓存 · git · 会话 —— 一眼尽览
 
 [![Node.js >= 22](https://img.shields.io/badge/node-%3E%3D22-3c873a)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-[English](./README.md) | 简体中文
-
-仓库：[github.com/CxMYu/CcGlanceLine](https://github.com/CxMYu/CcGlanceLine)
-
-`ccglance` 以 Claude Code 通过 stdin 传入的 JSON 为主数据源；`status`
-段只在启用时读取 transcript(会话记录)尾部。它用 **TypeScript** 编写,以编译后的
-JavaScript 发布,**运行时零依赖**(仅用 Node 标准库)。
-
-## 文档
-
-- [字段与图标参考](./docs/segments.zh-CN.md) —— 每个段的数据来源、所有图标含义、配额档位与颜色语义
-- [开发](./docs/development.zh-CN.md) —— 构建、测试、代码结构、贡献范式与 git 缓存内部
-
-## 预览
+[English](./README.md) · [简体中文](./README.zh-CN.md) · [GitHub](https://github.com/CxMYu/CcGlanceLine)
 
 ![ccglance 预览](./docs/assets/preview.png)
 
-截图由 `ccglance preview` 生成。
-
-## 特性
+</div>
 
-- **紧凑多行布局** —— 运行时、订阅配额、项目/会话分成逻辑行；无数据的行自动消失。
-- **运行时零依赖** —— 仅用 Node 标准库;TypeScript 仅为构建期工具,不进发布包。
-- **stdin 优先** —— 核心段消费 Claude Code 提供的 JSON；status 只读 transcript 尾部固定字节。
-- **上下文块** —— 占用百分比、本轮输入/输出 token、剩余 token。
-- **缓存块** —— 缓存命中率、读取/写入 token。
-- **git 段** —— 分支、干净/脏/冲突标记、领先/落后计数；只跑一次有界 `git status`，并带短缓存。
-- **会话段** —— 耗时 + 新增/删除行数。
-- **Claude Code 版本 + 更新提示** —— 显示 stdin 里的 Claude Code `version`；
-  本地 4 小时缓存发现新版时追加 `↑latest`。刷新在 stdout 写出后异步进行，不阻塞状态栏。
-- **额外会话信息** —— 5小时/7天配额、美元成本，以及 Claude Code 提供时显示在 git 分支右侧的 worktree 名。
-- **响应式多行布局** —— 读终端宽度(`COLUMNS`),把每行按能容纳的宽度自动折成多行;
-  正确处理 CJK/emoji 显示宽度。
-- **固定内置风格** —— 不读取用户配置文件，也不读取外部样式文件；状态栏使用 ccglance 自己的 emoji 优先风格。
+> **stdin 优先 · 运行时零依赖 · 固定 emoji 风格** —— 渲染 Claude Code 经 stdin 传入的 JSON;仅 `status` 段读取 transcript 尾部固定字节。TypeScript 编写,以编译后的 JavaScript 发布,可在 Node.js ≥ 22 或 Bun 上运行。
 
-## 环境要求
-
-- Node.js **>= 22**
-- `git`(可选,仅 git 段需要)
-
-Claude Code 兼容性：
-
-| Claude Code CLI | ccglance 行为 |
-|---|---|
-| >= 1.0.71 | 支持基础 statusline stdin |
-| >= 2.1.80 | 官方 `rate_limits.five_hour` / `rate_limits.seven_day` 字段存在时显示订阅配额行 |
-| >= 2.1.153 | 优先使用 `COLUMNS` / `LINES` 做终端宽度适配；更旧版本回退到 TTY 宽度或 80 列 |
-
-配额行只面向订阅场景。Claude.ai Pro/Max 这类订阅会话可能提供 `rate_limits`；
-API key、Bedrock、Vertex 等按量/外部网关场景通常没有该字段，ccglance 会隐藏配额行，
-不会自行推断或伪造。
+**文档:** [概览](./docs/overview.zh-CN.md) · [字段与图标](./docs/segments.zh-CN.md) · [开发](./docs/development.zh-CN.md)
 
 ## 安装
 
@@ -65,6 +27,7 @@ API key、Bedrock、Vertex 等按量/外部网关场景通常没有该字段，c
 npm install -g @cxmyu/ccglance          # npm
 yarn global add @cxmyu/ccglance         # 或 yarn
 pnpm add -g @cxmyu/ccglance             # 或 pnpm
+bun add -g @cxmyu/ccglance              # 或 bun
 ```
 
 registry 慢?用国内镜像:
@@ -91,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
 ```
 
@@ -134,63 +97,14 @@ Windows 用完整路径,例如 `node D:\\path\\to\\ccglance\\dist\\cli.js`。
 > 全局的 `ccglance` 命令则完全不需要写路径。`"padding": 0` 去掉 Claude Code 默认的左侧缩进,
 > 让状态栏从最左开始。
 
-## 状态栏速览
-
-三个逻辑行,任意一行无数据时自动消失:
-
-1. **运行时** —— 🤖 模型 · 🧠 effort · 状态 · 🚀 fast · ⚡️ 上下文 · 💾 缓存 · 🎯 风格
-2. **配额**(仅订阅会话)—— 📊 Hour / Week 配额仪表
-3. **项目 / 会话** —— 📁 目录 · 🌿 git · 🏷️ 会话名 · ⏱️ 会话 · 💰 成本 · 💩 版本
-
-**完整参考** —— 每个段的 stdin 来源、所有图标含义、配额月相档位、会话状态图标与颜色语义 ——
-见 **[docs/segments.zh-CN.md](./docs/segments.zh-CN.md)**。
-
-## 原理
-
-每次刷新时,Claude Code 会运行你配置的 `command`,并把一段 JSON(模型、effort、
-上下文窗口、cost、workspace、版本……)从 **stdin** 传入。`ccglance` 用
-`fs.readFileSync(0)` 一次性读入、按固定行格式化并**先打印**；`status`
-只会读取 transcript 尾部固定字节。版本段同步阶段只读本地小缓存；stdout 写出之后，如果
-Claude Code 最新版缓存超过 4 小时，才 detached 后台刷新 npm registry。若 JSON 解析失败则
-静默退出,绝不影响 CLI。来自 stdin、transcript、git 的文本在输出前会清理终端控制序列，
-避免逃逸到状态栏之外。主要外部调用是本地 `git`(单次有界 status 调用并带短缓存)、按需
-transcript 尾部读取，以及渲染后的后台版本检查。
-
-## 开发
-
-源码构建、测试、基准、代码结构、贡献范式与 git 缓存内部细节见
-**[docs/development.zh-CN.md](./docs/development.zh-CN.md)**。快速开始:
-
-```bash
-git clone https://github.com/CxMYu/CcGlanceLine.git
-cd CcGlanceLine
-npm install        # devDeps + prepare 构建
-npm test           # 构建 + node:test
-```
-
-## 缓存文件
-
-`ccglance` 只落盘可丢弃的运行缓存：git 状态、transcript 派生状态、Claude Code 最新版本缓存。
-文件按 `git/`、`transcript/`、`version/` 分组。
-
-所有平台都统一落在 Claude Code 自己的配置目录下,随 Claude 配置一起走、清理也方便:
-
-```text
-~/.claude/ccglance/
-├── git/          # git 状态快照(每个仓库一个)
-├── transcript/   # transcript 派生的会话状态
-└── version/      # Claude Code 最新版本检查
-```
-
-若设置了 `CLAUDE_CONFIG_DIR` 改变 Claude Code 配置目录,ccglance 的缓存会跟着落到该目录下。
-整个 `ccglance/` 目录随时可安全删除 —— 下次渲染会自动重建。
-
-git 缓存逻辑(缓存 key、`HEAD` 兜底、20 分钟 TTL、detached 刷新、原子写)见
-[docs/development.zh-CN.md](./docs/development.zh-CN.md#git-缓存内部细节)。
+> **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.2",
+  "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",