ccstatusline-zh 2.2.7
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/LICENSE +22 -0
- package/README.md +358 -0
- package/dist/ccstatusline.js +68806 -0
- package/package.json +78 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Matthew Breedlove (https://github.com/sirmalloc)
|
|
4
|
+
Copyright (c) 2026 huangguang1999 (https://github.com/huangguang1999) - Chinese localization
|
|
5
|
+
|
|
6
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
7
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
8
|
+
in the Software without restriction, including without limitation the rights
|
|
9
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
10
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
11
|
+
furnished to do so, subject to the following conditions:
|
|
12
|
+
|
|
13
|
+
The above copyright notice and this permission notice shall be included in all
|
|
14
|
+
copies or substantial portions of the Software.
|
|
15
|
+
|
|
16
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
17
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
18
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
19
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
20
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
21
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
22
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
# ccstatusline-zh
|
|
2
|
+
|
|
3
|
+
**🎨 Claude Code CLI 高度可定制状态栏格式化工具 — 中文汉化版**
|
|
4
|
+
|
|
5
|
+
_在终端中显示模型信息、Git 分支、Token 用量及其他实时指标_
|
|
6
|
+
|
|
7
|
+
> 本项目是 [ccstatusline](https://github.com/sirmalloc/ccstatusline) 的**中文汉化 Fork**,基于 v2.2.7 版本。所有用户可见的界面文本(组件名称、分类、描述、菜单标签、提示信息等)均已翻译为中文,方便中文用户使用。
|
|
8
|
+
|
|
9
|
+
[](https://github.com/huangguang1999/ccstatusline-zh/blob/main/LICENSE)
|
|
10
|
+
[](https://nodejs.org)
|
|
11
|
+
|
|
12
|
+

|
|
13
|
+
|
|
14
|
+
## 📚 目录
|
|
15
|
+
|
|
16
|
+
- [关于本项目](#-关于本项目)
|
|
17
|
+
- [功能特性](#-功能特性)
|
|
18
|
+
- [快速开始](#-快速开始)
|
|
19
|
+
- [Windows 支持](#-windows-支持)
|
|
20
|
+
- [使用方法](#-使用方法)
|
|
21
|
+
- [可用组件](#-可用组件)
|
|
22
|
+
- [配置界面(TUI)](#-配置界面tui)
|
|
23
|
+
- [API 文档](#-api-文档)
|
|
24
|
+
- [开发指南](#️-开发指南)
|
|
25
|
+
- [致谢](#-致谢)
|
|
26
|
+
- [许可证](#-许可证)
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 🌏 关于本项目
|
|
31
|
+
|
|
32
|
+
**ccstatusline-zh** 是 [ccstatusline](https://github.com/sirmalloc/ccstatusline) 的中文汉化版本。
|
|
33
|
+
|
|
34
|
+
ccstatusline 是一个优秀的 Claude Code CLI 状态栏格式化工具,支持 35+ 种可定制组件、Powerline 主题、交互式 TUI 配置界面等丰富功能。本项目在其基础上,将所有用户可见的英文文本直接替换为中文,包括:
|
|
35
|
+
|
|
36
|
+
- **38 个组件**的名称、描述、分类标签
|
|
37
|
+
- **TUI 配置界面**的全部菜单项、帮助文本、提示信息、对话框
|
|
38
|
+
- **布局组件**(分隔符、弹性分隔符)的名称和描述
|
|
39
|
+
- **确认对话框** "是 / 否"
|
|
40
|
+
- **分类筛选** "全部" 等界面元素
|
|
41
|
+
|
|
42
|
+
内部标识符(如 settings.json 中的 widget type ID `"model"`、`"git-branch"` 等)保持英文不变,确保与上游版本的配置文件完全兼容。
|
|
43
|
+
|
|
44
|
+
### 与上游的差异
|
|
45
|
+
|
|
46
|
+
| 项目 | ccstatusline | ccstatusline-zh |
|
|
47
|
+
| ---------- | ------------ | ------------------------- |
|
|
48
|
+
| 界面语言 | 英文 | 中文 |
|
|
49
|
+
| 配置兼容性 | — | ✅ 共用相同 settings.json |
|
|
50
|
+
| 功能差异 | — | 无,功能完全一致 |
|
|
51
|
+
| 基于版本 | 最新 | v2.2.7 |
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## ✨ 功能特性
|
|
56
|
+
|
|
57
|
+
- **35+ 种可定制组件** — 模型、Git、Token、上下文、会话、费用、速度等
|
|
58
|
+
- **交互式 TUI 配置** — 按 `ccstatusline-zh setup` 启动可视化配置界面
|
|
59
|
+
- **Powerline 风格** — 内置多款 Powerline 主题,支持自定义分隔符
|
|
60
|
+
- **多行布局** — 支持多行状态栏配置
|
|
61
|
+
- **实时预览** — 配置时即时预览效果
|
|
62
|
+
- **自定义颜色** — 每个组件支持独立的前景色和背景色设置
|
|
63
|
+
- **自定义命令 & 文本** — 可嵌入自定义 Shell 命令输出或静态文本
|
|
64
|
+
- **可点击链接** — 支持 OSC8 终端超链接
|
|
65
|
+
- **跨平台** — 支持 macOS、Linux、Windows
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 🚀 快速开始
|
|
70
|
+
|
|
71
|
+
### 安装
|
|
72
|
+
|
|
73
|
+
通过 npm 全局安装:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
npm install -g ccstatusline-zh
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
或者使用 Bun:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
bun install -g ccstatusline-zh
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### 配置 Claude Code
|
|
86
|
+
|
|
87
|
+
在 Claude Code 设置中添加状态栏 Hook。编辑 `~/.claude/settings.json`:
|
|
88
|
+
|
|
89
|
+
```json
|
|
90
|
+
{
|
|
91
|
+
"hooks": {
|
|
92
|
+
"StatusLine": [
|
|
93
|
+
{
|
|
94
|
+
"matcher": "",
|
|
95
|
+
"hooks": [
|
|
96
|
+
{
|
|
97
|
+
"type": "command",
|
|
98
|
+
"command": "ccstatusline-zh"
|
|
99
|
+
}
|
|
100
|
+
]
|
|
101
|
+
}
|
|
102
|
+
]
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### 启动配置界面
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
ccstatusline-zh setup
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
这将打开交互式 TUI 配置界面,你可以:
|
|
114
|
+
|
|
115
|
+
- 添加、删除、重新排列组件
|
|
116
|
+
- 设置颜色和样式
|
|
117
|
+
- 选择 Powerline 主题
|
|
118
|
+
- 实时预览状态栏效果
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 🪟 Windows 支持
|
|
123
|
+
|
|
124
|
+
ccstatusline-zh 完整支持 Windows 系统。安装方式相同:
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
npm install -g ccstatusline-zh
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Windows 下 Claude Code 的 Hook 配置路径为 `%USERPROFILE%\.claude\settings.json`。
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## 📖 使用方法
|
|
135
|
+
|
|
136
|
+
### 基本用法
|
|
137
|
+
|
|
138
|
+
安装并配置 Hook 后,ccstatusline-zh 会在每次 Claude Code 更新状态时自动运行。状态数据通过 stdin 以 JSON 格式传入。
|
|
139
|
+
|
|
140
|
+
### 手动测试
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
cat scripts/payload.example.json | ccstatusline-zh
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### 自定义配置文件路径
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
ccstatusline-zh --config /path/to/custom-settings.json
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
### 命令行参数
|
|
153
|
+
|
|
154
|
+
| 参数 | 说明 |
|
|
155
|
+
| ----------------- | ----------------------- |
|
|
156
|
+
| `setup` | 启动交互式 TUI 配置界面 |
|
|
157
|
+
| `--config <path>` | 指定自定义配置文件路径 |
|
|
158
|
+
| `--version` | 显示版本号 |
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## 🧩 可用组件
|
|
163
|
+
|
|
164
|
+
### 核心
|
|
165
|
+
|
|
166
|
+
| 组件 | 说明 |
|
|
167
|
+
| -------- | --------------------------- |
|
|
168
|
+
| 模型 | 显示当前 Claude 模型名称 |
|
|
169
|
+
| 风格 | 显示当前输出风格 |
|
|
170
|
+
| 版本 | 显示 ccstatusline-zh 版本号 |
|
|
171
|
+
| 思考力度 | 显示当前思考力度等级 |
|
|
172
|
+
| Vim 模式 | 显示当前 Vim 模式 |
|
|
173
|
+
|
|
174
|
+
### Git
|
|
175
|
+
|
|
176
|
+
| 组件 | 说明 |
|
|
177
|
+
| ---------- | ------------------------------------- |
|
|
178
|
+
| Git 分支 | 显示当前 Git 分支名,支持 GitHub 链接 |
|
|
179
|
+
| Git 变更 | 显示未提交的文件变更统计 |
|
|
180
|
+
| Git 新增 | 显示未提交的新增行数 |
|
|
181
|
+
| Git 删除 | 显示未提交的删除行数 |
|
|
182
|
+
| Git 根目录 | 显示 Git 仓库根目录名 |
|
|
183
|
+
| Git 工作树 | 显示 Git 工作树信息 |
|
|
184
|
+
|
|
185
|
+
### Token
|
|
186
|
+
|
|
187
|
+
| 组件 | 说明 |
|
|
188
|
+
| ---------- | ------------------- |
|
|
189
|
+
| 输入 Token | 显示输入 Token 数量 |
|
|
190
|
+
| 输出 Token | 显示输出 Token 数量 |
|
|
191
|
+
| 缓存 Token | 显示缓存 Token 数量 |
|
|
192
|
+
| 总 Token | 显示 Token 合计 |
|
|
193
|
+
|
|
194
|
+
### Token 速度
|
|
195
|
+
|
|
196
|
+
| 组件 | 说明 |
|
|
197
|
+
| -------- | --------------------------- |
|
|
198
|
+
| 输入速度 | 显示输入 Token 速度 (tok/s) |
|
|
199
|
+
| 输出速度 | 显示输出 Token 速度 (tok/s) |
|
|
200
|
+
| 总速度 | 显示总 Token 速度 (tok/s) |
|
|
201
|
+
|
|
202
|
+
### 上下文
|
|
203
|
+
|
|
204
|
+
| 组件 | 说明 |
|
|
205
|
+
| ---------------- | -------------------------- |
|
|
206
|
+
| 上下文长度 | 显示当前上下文 Token 数 |
|
|
207
|
+
| 上下文 % | 显示上下文使用百分比 |
|
|
208
|
+
| 上下文 %(可用) | 显示可用上下文百分比 |
|
|
209
|
+
| 上下文进度条 | 以进度条形式显示上下文用量 |
|
|
210
|
+
|
|
211
|
+
### 会话
|
|
212
|
+
|
|
213
|
+
| 组件 | 说明 |
|
|
214
|
+
| -------------- | ----------------------------- |
|
|
215
|
+
| 会话时钟 | 显示当前会话持续时间 |
|
|
216
|
+
| 会话费用 | 显示当前会话预估费用 |
|
|
217
|
+
| 会话名称 | 显示 Claude Code 会话名称 |
|
|
218
|
+
| 会话用量 | 显示会话 API 用量 |
|
|
219
|
+
| 周用量 | 显示本周 API 用量 |
|
|
220
|
+
| 时段计时器 | 显示当前 5 小时时段已用时间 |
|
|
221
|
+
| 时段重置计时 | 显示时段重置窗口剩余时间 |
|
|
222
|
+
| 周重置计时 | 显示周重置剩余时间 |
|
|
223
|
+
| Claude 会话 ID | 显示当前 Claude 会话 ID |
|
|
224
|
+
| 技能 | 显示 Claude Code 技能调用信息 |
|
|
225
|
+
|
|
226
|
+
### 环境
|
|
227
|
+
|
|
228
|
+
| 组件 | 说明 |
|
|
229
|
+
| -------- | -------------------- |
|
|
230
|
+
| 当前目录 | 显示当前工作目录 |
|
|
231
|
+
| 终端宽度 | 显示终端列数 |
|
|
232
|
+
| 内存用量 | 显示系统内存使用情况 |
|
|
233
|
+
|
|
234
|
+
### 自定义
|
|
235
|
+
|
|
236
|
+
| 组件 | 说明 |
|
|
237
|
+
| ---------- | ------------------------- |
|
|
238
|
+
| 自定义文本 | 显示用户自定义文本 |
|
|
239
|
+
| 自定义命令 | 执行 Shell 命令并显示输出 |
|
|
240
|
+
| 链接 | 显示可点击的终端超链接 |
|
|
241
|
+
|
|
242
|
+
### 布局
|
|
243
|
+
|
|
244
|
+
| 组件 | 说明 |
|
|
245
|
+
| ---------- | ---------------------------- |
|
|
246
|
+
| 分隔符 | 组件之间的固定分隔符 |
|
|
247
|
+
| 弹性分隔符 | 自动填充剩余空间的弹性分隔符 |
|
|
248
|
+
|
|
249
|
+
---
|
|
250
|
+
|
|
251
|
+
## 🖥️ 配置界面(TUI)
|
|
252
|
+
|
|
253
|
+
运行 `ccstatusline-zh setup` 打开交互式配置界面。
|
|
254
|
+
|
|
255
|
+
### 主菜单功能
|
|
256
|
+
|
|
257
|
+
- **编辑状态栏** — 添加、删除、移动、配置组件
|
|
258
|
+
- **Powerline 设置** — 选择主题和自定义分隔符
|
|
259
|
+
- **全局样式覆盖** — 设置全局颜色和样式
|
|
260
|
+
- **终端选项** — 配置终端宽度和颜色级别
|
|
261
|
+
- **安装/更新** — 选择包管理器进行安装
|
|
262
|
+
- **导出配置** — 导出当前配置
|
|
263
|
+
- **重置配置** — 恢复默认设置
|
|
264
|
+
|
|
265
|
+
### 快捷键
|
|
266
|
+
|
|
267
|
+
| 按键 | 功能 |
|
|
268
|
+
| ------- | --------- |
|
|
269
|
+
| `↑` `↓` | 导航 |
|
|
270
|
+
| `Enter` | 选择/确认 |
|
|
271
|
+
| `a` | 添加组件 |
|
|
272
|
+
| `d` | 删除组件 |
|
|
273
|
+
| `e` | 编辑组件 |
|
|
274
|
+
| `w` | 组件选项 |
|
|
275
|
+
| `/` | 搜索 |
|
|
276
|
+
| `q` | 退出 |
|
|
277
|
+
|
|
278
|
+
---
|
|
279
|
+
|
|
280
|
+
## 📡 API 文档
|
|
281
|
+
|
|
282
|
+
详细的 API 文档和 JSON Payload 格式说明请参考上游项目:
|
|
283
|
+
|
|
284
|
+
👉 [ccstatusline API Documentation](https://github.com/sirmalloc/ccstatusline#-api-documentation)
|
|
285
|
+
|
|
286
|
+
---
|
|
287
|
+
|
|
288
|
+
## 🛠️ 开发指南
|
|
289
|
+
|
|
290
|
+
### 环境要求
|
|
291
|
+
|
|
292
|
+
- [Bun](https://bun.sh/) >= 1.0
|
|
293
|
+
- Node.js >= 14.0.0
|
|
294
|
+
|
|
295
|
+
### 本地开发
|
|
296
|
+
|
|
297
|
+
```bash
|
|
298
|
+
# 克隆仓库
|
|
299
|
+
git clone https://github.com/huangguang1999/ccstatusline-zh.git
|
|
300
|
+
cd ccstatusline-zh
|
|
301
|
+
|
|
302
|
+
# 安装依赖
|
|
303
|
+
bun install
|
|
304
|
+
|
|
305
|
+
# 运行示例
|
|
306
|
+
bun run example
|
|
307
|
+
|
|
308
|
+
# 启动 TUI
|
|
309
|
+
bun run start setup
|
|
310
|
+
|
|
311
|
+
# 构建
|
|
312
|
+
bun run build
|
|
313
|
+
|
|
314
|
+
# 代码检查
|
|
315
|
+
bun run lint
|
|
316
|
+
```
|
|
317
|
+
|
|
318
|
+
### 项目结构
|
|
319
|
+
|
|
320
|
+
```
|
|
321
|
+
src/
|
|
322
|
+
├── ccstatusline.ts # 入口文件
|
|
323
|
+
├── widgets/ # 组件目录(38 个组件)
|
|
324
|
+
│ ├── Model.ts
|
|
325
|
+
│ ├── GitBranch.ts
|
|
326
|
+
│ ├── TokensInput.ts
|
|
327
|
+
│ ├── shared/ # 共享工具函数
|
|
328
|
+
│ └── ...
|
|
329
|
+
├── tui/ # TUI 配置界面
|
|
330
|
+
│ ├── App.tsx
|
|
331
|
+
│ └── components/ # 界面组件
|
|
332
|
+
├── utils/ # 工具函数
|
|
333
|
+
└── types/ # 类型定义
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
---
|
|
337
|
+
|
|
338
|
+
## 🙏 致谢
|
|
339
|
+
|
|
340
|
+
- [ccstatusline](https://github.com/sirmalloc/ccstatusline) — 原始项目,由 [sirmalloc](https://github.com/sirmalloc) 开发维护
|
|
341
|
+
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — Anthropic 的 CLI 编码助手
|
|
342
|
+
- [Ink](https://github.com/vadimdemedes/ink) — React 终端渲染框架
|
|
343
|
+
|
|
344
|
+
---
|
|
345
|
+
|
|
346
|
+
## 📄 许可证
|
|
347
|
+
|
|
348
|
+
本项目遵循 [MIT 许可证](LICENSE),与上游项目保持一致。
|
|
349
|
+
|
|
350
|
+
---
|
|
351
|
+
|
|
352
|
+
<div align="center">
|
|
353
|
+
|
|
354
|
+
**如果这个汉化版对你有帮助,欢迎 ⭐ Star!**
|
|
355
|
+
|
|
356
|
+
[上游项目](https://github.com/sirmalloc/ccstatusline) · [问题反馈](https://github.com/huangguang1999/ccstatusline-zh/issues)
|
|
357
|
+
|
|
358
|
+
</div>
|