ccstatusline-zh 2.2.13 → 2.2.18

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.
Files changed (3) hide show
  1. package/README.md +35 -15
  2. package/dist/ccstatusline.js +4375 -999
  3. package/package.json +10 -2
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  _在终端中显示模型信息、Git 分支、Token 用量及其他实时指标_
6
6
 
7
- > 本项目是 [ccstatusline](https://github.com/sirmalloc/ccstatusline) 的**中文汉化 Fork**,当前同步至上游 v2.2.12 版本(含 Jujutsu VCS、CompactionCounter 等最新功能)。所有用户可见的界面文本(组件名称、分类、描述、菜单标签、提示信息等)均已翻译为中文,方便中文用户使用。
7
+ > 本项目是 [ccstatusline](https://github.com/sirmalloc/ccstatusline) 的**中文汉化 Fork**,当前同步至上游 v2.2.18 版本(含 Voice Status、版本固定全局安装、Jujutsu VCS、CompactionCounter、超额用量组件等最新功能)。所有用户可见的界面文本(组件名称、分类、描述、菜单标签、提示信息等)均已翻译为中文,方便中文用户使用。
8
8
 
9
9
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/huangguang1999/ccstatusline-zh/blob/main/LICENSE)
10
10
  [![Node.js Version](https://img.shields.io/node/v/ccstatusline.svg)](https://nodejs.org)
@@ -33,12 +33,15 @@ _在终端中显示模型信息、Git 分支、Token 用量及其他实时指标
33
33
 
34
34
  ccstatusline 是一个优秀的 Claude Code CLI 状态栏格式化工具,支持 50+ 种可定制组件、Powerline 主题、交互式 TUI 配置界面等丰富功能。本项目在其基础上,将所有用户可见的英文文本直接替换为中文,包括:
35
35
 
36
- - **73 个组件**的名称、描述、分类标签
36
+ - **72 个组件**的名称、描述、分类标签(含 v2.2.13 新增的 Voice Status / 周 Sonnet 用量 / 周 Opus 用量,v2.2.17 新增的超额用量占比 / 超额用量剩余)
37
37
  - **TUI 配置界面**的全部菜单项、帮助文本、提示信息、对话框
38
38
  - **布局组件**(分隔符、弹性分隔符)的名称和描述
39
39
  - **极简模式 / Minimalist Mode**、**模糊搜索组件选择器**、**Powerline 主题色延续**(v2.2.8)
40
40
  - **上下文窗口**、**Git 文件状态系列**(已暂存 / 未暂存 / 未跟踪 / 干净)、**短条形百分比模式**、**GitLab 支持**、**Reset Timer 时区/IANA 选择**、**TUI 环绕导航**、**`refreshInterval` 配置**(v2.2.10)
41
41
  - **Jujutsu VCS 系列**(书签 / 工作区 / 根目录 / 变更 / 增删 / 描述 / 修订)、**CompactionCounter 压缩计数**、**用量时间游标**、**Reset Timer 绝对时间戳**、**Powerline 端帽数量解锁**、**思考力度组件 xhigh 等级**(v2.2.12)
42
+ - **Voice Status 语音状态组件**、**周 Sonnet / 周 Opus 用量组件**、**Timer 短进度条**、**Hook 输出静默**(v2.2.13)
43
+ - **版本固定全局安装**(Pinned global install)、**管理安装 / 检查更新菜单**、**npm 仓库更新检测**、**固定安装版本不一致防错屏幕**(v2.2.14–v2.2.16)
44
+ - **超额用量占比 / 超额用量剩余组件**(按量付费月度超额额度,支持禁用时隐藏)、**用量 API 空值桶兼容**、**Git 命令旧版本兼容与 `--no-optional-locks` 锁规避**(v2.2.17–v2.2.18)
42
45
  - **确认对话框** "是 / 否"
43
46
  - **分类筛选** "全部" 等界面元素
44
47
 
@@ -51,7 +54,7 @@ ccstatusline 是一个优秀的 Claude Code CLI 状态栏格式化工具,支
51
54
  | 界面语言 | 英文 | 中文 |
52
55
  | 配置兼容性 | — | ✅ 共用相同 settings.json |
53
56
  | 功能差异 | — | 无,功能完全一致 |
54
- | 同步版本 | 最新 | v2.2.12(+ jj widgets / CompactionCounter / 中文化覆盖) |
57
+ | 同步版本 | 最新 | v2.2.18(+ jj widgets / CompactionCounter / Voice Status / 版本固定安装 / 超额用量组件 / 中文化覆盖) |
55
58
 
56
59
  ---
57
60
 
@@ -88,6 +91,8 @@ npm install -g ccstatusline-zh
88
91
  bun install -g ccstatusline-zh
89
92
  ```
90
93
 
94
+ > 💡 提示:v2.2.14 起 ccstatusline 增加了「固定版本全局安装」选项,TUI 中选择 **固定全局安装** 即可锁定当前版本,避免 `@latest` 跟随上游。详见 TUI 安装流程。
95
+
91
96
  ### 配置 Claude Code
92
97
 
93
98
  在 Claude Code 设置中添加状态栏配置。编辑 `~/.claude/settings.json`:
@@ -97,7 +102,8 @@ bun install -g ccstatusline-zh
97
102
  "statusLine": {
98
103
  "type": "command",
99
104
  "command": "ccstatusline-zh",
100
- "padding": 0
105
+ "padding": 0,
106
+ "refreshInterval": 10
101
107
  }
102
108
  }
103
109
  ```
@@ -114,6 +120,14 @@ bun install -g ccstatusline-zh
114
120
  }
115
121
  ```
116
122
 
123
+ > `refreshInterval` 仅在 Claude Code ≥ 2.1.97 时生效,TUI 中可设置为 `1-60` 秒,留空则不写入该字段。
124
+ >
125
+ > 其他支持的 `command` 取值:
126
+ > - `bunx -y ccstatusline-zh@latest`
127
+ > - `ccstatusline-zh`(用于自管理 / 全局安装)
128
+ >
129
+ > 如需固定版本,可在 TUI 安装时选择「固定全局安装」,TUI 会全局安装当前版本并将 `command` 写为 `ccstatusline-zh`。
130
+
117
131
  ### 启动配置界面
118
132
 
119
133
  ```bash
@@ -173,13 +187,14 @@ ccstatusline-zh --config /path/to/custom-settings.json
173
187
 
174
188
  ### 核心
175
189
 
176
- | 组件 | 说明 |
177
- | -------- | --------------------------- |
178
- | 模型 | 显示当前 Claude 模型名称 |
179
- | 风格 | 显示当前输出风格 |
180
- | 版本 | 显示 ccstatusline-zh 版本号 |
181
- | 思考力度 | 显示当前思考力度等级 |
182
- | Vim 模式 | 显示当前 Vim 模式 |
190
+ | 组件 | 说明 |
191
+ | -------- | ----------------------------------------------------- |
192
+ | 模型 | 显示当前 Claude 模型名称 |
193
+ | 风格 | 显示当前输出风格 |
194
+ | 版本 | 显示 ccstatusline-zh 版本号 |
195
+ | 思考力度 | 显示当前思考力度等级 |
196
+ | Vim 模式 | 显示当前 Vim 模式 |
197
+ | 语音状态 | 显示 Claude Code 语音输入是否启用(4 种格式 + Nerd 字体) |
183
198
 
184
199
  ### Git
185
200
 
@@ -239,6 +254,10 @@ ccstatusline-zh --config /path/to/custom-settings.json
239
254
  | 会话名称 | 显示 Claude Code 会话名称 |
240
255
  | 会话用量 | 显示会话 API 用量 |
241
256
  | 周用量 | 显示本周 API 用量 |
257
+ | 周 Sonnet 用量 | 显示本周 Sonnet 模型 API 用量 |
258
+ | 周 Opus 用量 | 显示本周 Opus 模型 API 用量 |
259
+ | 超额用量占比 | 显示超额用量(按量付费)占比 |
260
+ | 超额用量剩余 | 显示每月超额用量额度的剩余金额(美元) |
242
261
  | 时段计时器 | 显示当前 5 小时时段已用时间 |
243
262
  | 时段重置计时 | 显示时段重置窗口剩余时间 |
244
263
  | 周重置计时 | 显示周重置剩余时间 |
@@ -282,9 +301,10 @@ ccstatusline-zh --config /path/to/custom-settings.json
282
301
  - **Powerline 设置** — 选择主题和自定义分隔符
283
302
  - **全局样式覆盖** — 设置全局颜色和样式
284
303
  - **终端选项** — 配置终端宽度和颜色级别
285
- - **安装/更新** — 选择包管理器进行安装
286
- - **导出配置** — 导出当前配置
287
- - **重置配置** — 恢复默认设置
304
+ - **配置状态行** — 配置 Claude Code 状态行刷新间隔(Claude Code ≥ 2.1.97)
305
+ - **安装到 Claude Code** — 选择自动更新 / 固定全局安装两种方式
306
+ - **管理安装** — 已固定安装时可检查 npm 更新、运行全局更新命令、卸载
307
+ - **检查更新** — 查询 npm 仓库最新版本并对比当前版本
288
308
 
289
309
  ### 快捷键
290
310
 
@@ -344,7 +364,7 @@ bun run lint
344
364
  ```
345
365
  src/
346
366
  ├── ccstatusline.ts # 入口文件
347
- ├── widgets/ # 组件目录(38 个组件)
367
+ ├── widgets/ # 组件目录(72 个组件)
348
368
  │ ├── Model.ts
349
369
  │ ├── GitBranch.ts
350
370
  │ ├── TokensInput.ts