ccstatusline-zh 2.2.29 → 2.2.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,9 @@
4
4
 
5
5
  _在终端中显示模型信息、Git 分支、Token 用量及其他实时指标_
6
6
 
7
- > 本项目是 [ccstatusline](https://github.com/sirmalloc/ccstatusline) 的**中文汉化 Fork**,当前同步至上游 v2.2.27 版本(含周 Fable 用量、迁移账号用量 API 兼容、压缩后上下文修正、隐藏组件分隔符修复及配置导入/导出等最新功能)。所有用户可见的界面文本(组件名称、分类、描述、菜单标签、提示信息等)均已翻译为中文,方便中文用户使用。
7
+ > 本项目是 [ccstatusline](https://github.com/sirmalloc/ccstatusline) 的**中文汉化 Fork**,当前中文包版本为 **2.2.31**,同步至上游 **v2.2.30 + main@35440e4**(2026-09-28 核对,包含自定义命令缓存、终端宽度探测优化、用量修复和配置界面按需加载)。所有用户可见的界面文本(组件名称、分类、描述、菜单标签、提示信息等)均已翻译为中文,方便中文用户使用。
8
+ >
9
+ > 上次同步的完整上游提交:[`35440e4a93ac8aba7e57973ac004a68adcc51089`](https://github.com/sirmalloc/ccstatusline/commit/35440e4a93ac8aba7e57973ac004a68adcc51089)。后续同步以此提交为基线,中文包与上游版本号独立递增。
8
10
 
9
11
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/huangguang1999/ccstatusline-zh/blob/main/LICENSE)
10
12
  [![Node.js Version](https://img.shields.io/node/v/ccstatusline.svg)](https://nodejs.org)
@@ -33,7 +35,7 @@ _在终端中显示模型信息、Git 分支、Token 用量及其他实时指标
33
35
 
34
36
  ccstatusline 是一个优秀的 Claude Code CLI 状态栏格式化工具,支持 80+ 种可定制组件、Powerline 主题、交互式 TUI 配置界面等丰富功能。本项目在其基础上,将所有用户可见的英文文本直接替换为中文,包括:
35
37
 
36
- - **87 个组件**的名称、描述、分类标签(含 v2.2.13 新增的 Voice Status / 周 Sonnet 用量 / 周 Opus 用量,v2.2.17 新增的超额用量占比 / 超额用量剩余,v2.2.20 新增的 Remote Control Status,v2.2.22 新增的缓存命中率 / 缓存读取 / 缓存写入 / 超额已用,v2.2.24 新增的缓存计时器 / Git CI 状态 / 沙箱状态,v2.2.26 新增的周 Fable 用量)
38
+ - **88 个组件**的名称、描述、分类标签(含 v2.2.13 新增的 Voice Status / 周 Sonnet 用量 / 周 Opus 用量,v2.2.17 新增的超额用量占比 / 超额用量剩余,v2.2.20 新增的 Remote Control Status,v2.2.22 新增的缓存命中率 / 缓存读取 / 缓存写入 / 超额已用,v2.2.24 新增的缓存计时器 / Git CI 状态 / 沙箱状态,v2.2.26 新增的周 Fable 用量)
37
39
  - **TUI 配置界面**的全部菜单项、帮助文本、提示信息、对话框
38
40
  - **布局组件**(分隔符、弹性分隔符)的名称和描述
39
41
  - **极简模式 / Minimalist Mode**、**模糊搜索组件选择器**、**Powerline 主题色延续**(v2.2.8)
@@ -47,6 +49,8 @@ ccstatusline 是一个优秀的 Claude Code CLI 状态栏格式化工具,支
47
49
  - **缓存命中率 / 缓存读取 / 缓存写入**(Cache Hit Rate / Cache Read / Cache Write)、**超额已用组件**(Extra Usage Used)、**压缩计数改用 compact_boundary 标记精准检测**(不再依赖上下文百分比推断)、**弹性分隔符 Powerline 路径修复**、**可覆盖字符字形(Glyph override)**、**每组件暗淡样式**(整体暗淡 / 括号暗淡)、**invalid settings.json 非破坏性恢复与警告**(v2.2.21–v2.2.22)
48
50
  - **缓存计时器 / Git CI 状态 / 沙箱状态组件**、**单侧默认内边距**、**选择性 Powerline 对齐**、**Git 分支与根目录宽度限制**、**当前目录字符**、**可配置上下文窗口兜底值**、**可组合压缩指标**、**`--version` 参数**、**用量缓存与加载态修复**、**异步 Git PR/CI 检查刷新**(v2.2.23–v2.2.25)
49
51
  - **周 Fable 用量组件**、**迁移账号的 `limits[]` 用量 API 兼容**、**压缩后上下文长度修正**、**隐藏组件分隔符保留**、**配置导入/导出及差异预览**(v2.2.26–v2.2.27)
52
+ - **Claude 服务状态及 48 小时故障历史**、**统一隐藏条件与旧配置自动迁移**、**按组件和数值类型设置显示精度**、**大转录文件流式读取与单次扫描**、**Git 冲突为零时的显示选项**、**用量锁与 Git 临时文件恢复修复**(上游 v2.2.28–v2.2.29)
53
+ - **自定义命令可选输出缓存与超时控制**、**终端宽度探测优化及失败结果缓存**、**更多 Git / Jujutsu 组件符号定制**、**重置计时器无数据时隐藏**、**macOS 按配置目录选取用量凭据**、**访问令牌刷新时保留用量缓存**、**模型周额度为零时正确显示**、**新配置默认使用完整终端宽度**、**Git 命令 5 秒超时**、**配置界面按需加载**(上游 v2.2.30 + main@35440e4)
50
54
  - **确认对话框** "是 / 否"
51
55
  - **分类筛选** "全部" 等界面元素
52
56
 
@@ -59,13 +63,13 @@ ccstatusline 是一个优秀的 Claude Code CLI 状态栏格式化工具,支
59
63
  | 界面语言 | 英文 | 中文 |
60
64
  | 配置兼容性 | — | ✅ 共用相同 settings.json |
61
65
  | 功能差异 | — | 无,功能完全一致 |
62
- | 同步版本 | 最新 | v2.2.27(+ 周 Fable 用量 / 用量 API 兼容 / 压缩后上下文修正 / 配置导入导出 / 中文化覆盖) |
66
+ | 同步版本 | 最新 | v2.2.30 + [main@35440e4](https://github.com/sirmalloc/ccstatusline/commit/35440e4a93ac8aba7e57973ac004a68adcc51089)(中文包 2.2.31) |
63
67
 
64
68
  ---
65
69
 
66
70
  ## ✨ 功能特性
67
71
 
68
- - **87 种可定制组件** — 模型、Git(含 PR / CI / 冲突 / 暂存 / Origin / Upstream / 工作树等细分组件)、Token、上下文、会话、费用、速度等
72
+ - **88 种可定制组件** — 模型、Git(含 PR / CI / 冲突 / 暂存 / Origin / Upstream / 工作树等细分组件)、Token、上下文、会话、费用、速度等
69
73
  - **交互式 TUI 配置** — 按 `ccstatusline-zh setup` 启动可视化配置界面
70
74
  - **Powerline 风格** — 内置多款 Powerline 主题,支持自定义分隔符,支持主题色跨行延续
71
75
  - **极简模式** — 一键让所有组件切换到"无标签"模式,状态栏更精简
@@ -98,6 +102,8 @@ bun install -g ccstatusline-zh
98
102
 
99
103
  > 💡 提示:v2.2.14 起 ccstatusline 增加了「固定版本全局安装」选项,TUI 中选择 **固定全局安装** 即可锁定当前版本,避免 `@latest` 跟随上游。详见 TUI 安装流程。
100
104
 
105
+ 固定全局安装可省去每次状态栏重绘时的包解析。上游在 Windows 的测量显示,`bunx ...@latest` 每次都会重新解析版本标签,耗时高于固定版本;如果重绘延迟明显,优先使用固定全局安装。
106
+
101
107
  ### 配置 Claude Code
102
108
 
103
109
  在 Claude Code 设置中添加状态栏配置。编辑 `~/.claude/settings.json`:
@@ -166,6 +172,14 @@ Windows 下 Claude Code 的配置路径为 `%USERPROFILE%\.claude\settings.json`
166
172
 
167
173
  安装并配置 statusLine 后,ccstatusline-zh 会在每次 Claude Code 更新状态时自动运行。状态数据通过 stdin 以 JSON 格式传入。
168
174
 
175
+ ### 隐藏条件与数值格式
176
+
177
+ 在组件编辑器中按 `h` 打开该组件支持的隐藏条件,使用空格切换并按 Enter 保存。例如,无 Git 仓库、无用量数据、数值为零时可以隐藏组件;已有隐藏选项会自动迁移。装饰文本和符号还可跟随合并目标隐藏。
178
+
179
+ 数值组件按 `.` 循环切换固定小数、紧凑和整数格式;全局覆盖菜单按 `n`,可分别设置令牌、速度、占比、内存和费用。全局设置优先于组件设置,`settings.json` 中还可通过 `decimals` 指定 0–6 位小数。
180
+
181
+ Claude 服务状态组件按 `h` 切换故障历史。中文状态用于界面显示,纯值模式保留 `ok`、`minor` 等上游状态值,兼容脚本读取。
182
+
169
183
  ### 手动测试
170
184
 
171
185
  ```bash
@@ -201,6 +215,7 @@ ccstatusline-zh --config /path/to/custom-settings.json
201
215
  | Vim 模式 | 显示当前 Vim 模式 |
202
216
  | 语音状态 | 显示 Claude Code 语音输入是否启用(4 种格式 + Nerd 字体) |
203
217
  | 沙箱状态 | 显示 Claude Code Bash 沙箱模式是否启用 |
218
+ | Claude 服务状态 | 显示官方服务状态,可附带最近 48 小时的彩色故障历史条 |
204
219
 
205
220
  ### Git
206
221
 
@@ -216,7 +231,7 @@ ccstatusline-zh --config /path/to/custom-settings.json
216
231
  | Git 已暂存 | 存在已暂存变更时显示 + |
217
232
  | Git 未暂存 | 存在未暂存变更时显示 * |
218
233
  | Git 未跟踪 | 存在未跟踪文件时显示 ? |
219
- | Git 冲突 | 显示合并冲突数量 |
234
+ | Git 冲突 | 显示合并冲突数量;为零时可隐藏或显示自定义干净标记 |
220
235
  | Git 超前/滞后 | 显示相对 upstream 的提交领先/落后数 |
221
236
  | Git SHA | 显示简短提交哈希 |
222
237
  | Git Origin 所有者/仓库 | 显示 origin 远程的 owner / repo |
@@ -265,7 +280,7 @@ ccstatusline-zh --config /path/to/custom-settings.json
265
280
  | 周 Opus 用量 | 显示本周 Opus 模型 API 用量 |
266
281
  | 周 Fable 用量 | 显示本周 Fable 模型 API 用量 |
267
282
  | 超额用量占比 | 显示超额用量(按量付费)占比 |
268
- | 超额用量剩余 | 显示每月超额用量额度的剩余金额(美元) |
283
+ | 超额用量剩余 | 显示每月超额用量额度的剩余金额 |
269
284
  | 时段计时器 | 显示当前 5 小时时段已用时间 |
270
285
  | 时段重置计时 | 显示时段重置窗口剩余时间 |
271
286
  | 周重置计时 | 显示周重置剩余时间 |
@@ -310,7 +325,7 @@ ccstatusline-zh --config /path/to/custom-settings.json
310
325
  - **Powerline 设置** — 选择主题和自定义分隔符
311
326
  - **全局样式覆盖** — 设置全局颜色、样式及默认内边距方向
312
327
  - **终端选项** — 配置终端宽度和颜色级别
313
- - **配置状态行** — 配置 Claude Code 状态行刷新间隔(Claude Code ≥ 2.1.97)
328
+ - **配置状态行** — 配置 Claude Code 状态行刷新间隔(Claude Code ≥ 2.1.97),以及 Git、自定义命令和终端宽度的缓存时长
314
329
  - **导出配置** — 将当前配置保存为 JSON 文件,用于备份或分享
315
330
  - **导入配置** — 从 JSON 文件加载配置并预览替换或合并后的差异
316
331
  - **安装到 Claude Code** — 选择自动更新 / 固定全局安装两种方式
@@ -330,6 +345,10 @@ ccstatusline-zh --config /path/to/custom-settings.json
330
345
  | `/` | 搜索 |
331
346
  | `q` | 退出 |
332
347
 
348
+ 重置计时器可按 `h` 设置无数据时隐藏;日期模式下按 `f` 切换 12/24 小时格式,周重置计时器在时间模式下按 `o` 切换仅显示小时。
349
+
350
+ 自定义命令缓存默认关闭,可设置为 0–60 秒;终端宽度探测失败结果默认缓存 5 秒,可设置为 0–300 秒,填 0 关闭缓存。已检测到的宽度会在下次渲染时重新检测。新配置默认使用完整终端宽度,已有 `flexMode` 设置保持不变。
351
+
333
352
  ---
334
353
 
335
354
  ## 📡 API 文档
@@ -0,0 +1,37 @@
1
+ import { createRequire } from "node:module";
2
+ var __create = Object.create;
3
+ var __getProtoOf = Object.getPrototypeOf;
4
+ var __defProp = Object.defineProperty;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
7
+ function __accessProp(key) {
8
+ return this[key];
9
+ }
10
+ var __toESMCache_node;
11
+ var __toESMCache_esm;
12
+ var __toESM = (mod, isNodeMode, target) => {
13
+ var canCache = mod != null && typeof mod === "object";
14
+ if (canCache) {
15
+ var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
16
+ var cached = cache.get(mod);
17
+ if (cached)
18
+ return cached;
19
+ }
20
+ target = mod != null ? __create(__getProtoOf(mod)) : {};
21
+ const to = isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
22
+ if (mod && typeof mod === "object" || typeof mod === "function") {
23
+ for (let key of __getOwnPropNames(mod))
24
+ if (!__hasOwnProp.call(to, key))
25
+ __defProp(to, key, {
26
+ get: __accessProp.bind(mod, key),
27
+ enumerable: true
28
+ });
29
+ }
30
+ if (canCache)
31
+ cache.set(mod, to);
32
+ return to;
33
+ };
34
+ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
35
+ var __require = /* @__PURE__ */ createRequire(import.meta.url);
36
+
37
+ export { __toESM, __commonJS, __require };