docs: make Chinese README the default

README.md

@@ -1,3 +1,9 @@
+<!-- WEHUB_ZH_README -->
+> [!NOTE]
+> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
+> [English](./README.en.md) · [原始项目](https://github.com/sirmalloc/ccstatusline) · [上游 README](https://github.com/sirmalloc/ccstatusline/blob/HEAD/README.md)  
+> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
+
 <div align="center">
 
 <pre>
@@ -11,8 +17,8 @@
 
 # ccstatusline
 
-**🎨 A highly customizable status line formatter for Claude Code CLI**
-*Display model info, git branch, token usage, and other metrics in your terminal*
+**🎨 面向 Claude Code CLI 的高度可定制状态栏格式化工具**
+*在终端中显示模型信息、Git 分支、Token 用量及其他指标*
 
 [![npm version](https://img.shields.io/npm/v/ccstatusline.svg)](https://www.npmjs.com/package/ccstatusline)
 [![npm downloads](https://img.shields.io/npm/dm/ccstatusline.svg)](https://www.npmjs.com/package/ccstatusline)
@@ -30,255 +36,257 @@
 </div>
 <br />
 
-## 📚 Table of Contents
+## 📚 目录
 
-- [Recent Updates](#-recent-updates)
-- [Features](#-features)
-- [Localizations](#-localizations)
-- [Quick Start](#-quick-start)
-- [Windows Support](docs/WINDOWS.md)
-- [Usage](docs/USAGE.md)
-- [Development](docs/DEVELOPMENT.md)
-- [Contributing](#-contributing)
-- [License](#-license)
-- [Related Projects](#-related-projects)
+- [最近更新](#-recent-updates)
+- [功能](#-features)
+- [本地化](#-localizations)
+- [快速开始](#-quick-start)
+- [Windows 支持](docs/WINDOWS.md)
+- [用法](docs/USAGE.md)
+- [开发](docs/DEVELOPMENT.md)
+- [贡献](#-contributing)
+- [许可证](#-license)
+- [相关项目](#-related-projects)
 
 <br />
 
-## 🆕 Recent Updates
+## 🆕 最近更新
 
-### v2.2.22 - v2.2.23 - Powerline flex mode, layout controls, composable metrics, and safer config
+### v2.2.22 - v2.2.23 - Powerline 弹性模式、布局控制、可组合指标与更安全的配置
 
 ![Powerline Flex Mode](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/powerline-flex.png)
 
-- **⚡ Powerline flex mode** - Flex separators now work in Powerline mode, letting Powerline status lines right-align content or absorb available width.
-- **🌗 Per-widget dim styling** - The color editor can dim an entire widget or only parenthesized text, with reset and clear-all actions covering dim state.
-- **🧯 Safer settings recovery** - Invalid `settings.json` files are left untouched, defaults render in memory, and the status line shows an invalid-config warning.
-- **🧭 Selective Powerline alignment** - Press `x` in the line editor to let a widget and the rest of its line keep their natural widths while earlier Powerline columns stay auto-aligned.
-- **📏 Git widget width limits** - `Git Branch` and `Git Root Dir` can cap their visible width with ellipsis-safe truncation while preserving hyperlink targets.
-- **🔣 Current directory glyphs** - `Current Working Dir` can prepend an optional custom glyph, including in raw-value mode.
-- **🧠 Configurable context fallback** - `CCSTATUSLINE_CONTEXT_SIZE_FALLBACK` overrides the default 200k last-resort context window when Claude Code and the model name do not report one.
-- **🧩 Composable compaction metrics** - `Compaction Counter` can render count, auto, manual, unknown, or reclaimed-token values independently for custom layouts.
-- **🏷️ CLI version flag** - `ccstatusline --version` now prints the installed package version and exits.
-- **🛡️ Guarded invalid-config saves** - The TUI warns when it loaded defaults for an invalid settings file and requires confirmation before replacing that file.
-- **🔄 Usage display and cache fixes** - Used/remaining direction now works in every percentage mode, account switches invalidate cached usage, and fetch locks no longer cause repeated requests or stale timeout output.
-- **⏱️ Calmer reset timer startup** - Reset timers show labeled loading placeholders instead of transient rate-limit errors while Claude Code's embedded usage-window data is still arriving.
-- **🔇 Quieter install detection** - Best-effort npm and Bun probes no longer leak expected package-manager errors into the TUI.
+- **⚡ Powerline 弹性模式** - 弹性分隔符现可在 Powerline 模式下工作，使 Powerline 状态栏能够右对齐内容或占用可用宽度。
+- **🌗 按组件调暗样式** - 颜色编辑器可让整个组件或仅括号内文本变暗，重置与全部清除操作也会覆盖调暗状态。
+- **🧯 更安全的设置恢复** - 无效的 `settings.json` 文件将保持原样不动，默认值在内存中渲染，状态栏会显示无效配置警告。
+- **🧭 选择性 Powerline 对齐** - 在线编辑器中按 `x`，可使某个组件及其所在行的其余部分保持自然宽度，而较早的 Powerline 列仍自动对齐。
+- **📏 Git 组件宽度限制** - `Git Branch` 与 `Git Root Dir` 可限制可见宽度，并以省略号安全截断，同时保留超链接目标。
+- **🔣 当前目录字形** - `Current Working Dir` 可前置可选的自定义字形，包括在原始值模式下。
+- **🧠 可配置的上下文回退** - 当 Claude Code 与模型名称未报告上下文窗口时，`CCSTATUSLINE_CONTEXT_SIZE_FALLBACK` 可覆盖默认的 200k 最后手段上下文窗口。
+- **🧩 可组合的压缩指标** - `Compaction Counter` 可独立渲染 count、auto、manual、unknown 或 reclaimed-token 值，用于自定义布局。
+- **🏷️ CLI 版本标志** - `ccstatusline --version` 现会打印已安装包版本并退出。
+- **🛡️ 受保护的无效配置保存** - 当 TUI 因无效设置文件而加载了默认值时，会发出警告，并在替换该文件前要求确认。
+- **🔄 用量显示与缓存修复** - 已用/剩余方向现可在所有百分比模式下正常工作，切换账户会失效缓存的用量数据，获取锁不再导致重复请求或陈旧的超时输出。
+- **⏱️ 更平稳的重置计时器启动** - 在 Claude Code 内嵌的用量窗口数据尚未到达时，重置计时器会显示带标签的加载占位符，而非短暂的速率限制错误。
+- **🔇 更安静的安装检测** - 尽力而为的 npm 与 Bun 探测不再将预期的包管理器错误泄漏到 TUI 中。
 
-### v2.2.21 - Cache widgets, compaction details, extra usage currency, and package fixes
+### v2.2.21 - 缓存组件、压缩详情、额外用量货币与包修复
 
-- **🔣 Custom widget glyphs** - Git and JJ symbol widgets can override or suppress their built-in glyphs from the TUI.
-- **🔁 Compaction counter details** - `Compaction Counter` now counts explicit `compact_boundary` markers and can optionally show trigger splits plus tokens reclaimed.
-- **💸 Extra usage improvements** - Added `Extra Usage Used` and formats extra usage amounts with the billing currency reported by the usage API.
-- **📏 Custom command width context** - `Custom Command` widgets receive `terminal_width` in stdin JSON when ccstatusline can detect the terminal width.
-- **🧠 Prompt cache widgets** - Added `Cache Hit Rate`, `Cache Read`, and `Cache Write` widgets with turn/session scopes and hide-when-empty behavior.
-- **🔢 Token rounding fix** - Token counts from `999950` through `999999` now render as `1.0M` instead of `1000.0k`.
+- **🔣 自定义组件字形** - Git 与 JJ 符号组件可从 TUI 覆盖或隐藏其内置字形。
+- **🔁 压缩计数器详情** - `Compaction Counter` 现会统计显式的 `compact_boundary` 标记，并可选择显示触发拆分及回收的 Token。
+- **💸 额外用量改进** - 新增 `Extra Usage Used`，并按用量 API 报告的计费货币格式化额外用量金额。
+- **📏 自定义命令宽度上下文** - 当 ccstatusline 能检测到终端宽度时，`Custom Command` 组件会在 stdin JSON 中接收 `terminal_width`。
+- **🧠 提示缓存组件** - 新增 `Cache Hit Rate`、`Cache Read` 与 `Cache Write` 组件，支持 turn/session 作用域及为空时隐藏行为。
+- **🔢 Token 舍入修复** - 来自 `999950` 至 `999999` 的 Token 计数现渲染为 `1.0M`，而非 `1000.0k`。
 
-### v2.2.20 - Gradients, token accuracy, usage reliability, and Git PR/MR fixes
+### v2.2.20 - 渐变、Token 精度、用量可靠性与 Git PR/MR 修复
 
-- **🌈 Gradient colors** - Added per-widget and whole-line foreground gradients with named presets, custom hex stops, TUI picker support, and Powerline-aware rendering. Press `g` on the Edit Colors screen for widget gradients, or press `g` for Override FG Color in Global Overrides for a line-wide gradient.
-- **🎯 More accurate token counts** - `Tokens Input` and `Tokens Output` now prefer cumulative transcript metrics before falling back to context-window totals.
-- **💸 Extra usage no-limit fix** - Extra usage widgets no longer get stuck on `[Timeout]` for accounts with overage enabled but no monthly limit configured.
-- **🔁 Compaction glitch filtering** - `Compaction Counter` ignores transient below-1% context readings so incomplete status frames do not create false compaction counts.
-- **🔀 SSH alias Git PR/MR detection** - Git PR/MR detection resolves SSH host aliases while preserving canonical GitHub and GitLab hosts for CLI selection and fallback repo links.
-- **🧪 Usage test cache isolation** - Usage-fetch test probes now isolate `HOME`, `USERPROFILE`, `CLAUDE_CONFIG_DIR`, and proxy variables so local tests cannot touch the real ccstatusline cache.
-- **📦 Dependency refresh** - Refreshed React/React DOM and Bun lockfile development-tooling resolutions for the release.
+- **🌈 渐变颜色** - 新增按组件与整行前景渐变，支持命名预设、自定义十六进制色标、TUI 选择器及 Powerline 感知渲染。在 Edit Colors 屏幕按 `g` 设置组件渐变，或在 Global Overrides 的 Override FG Color 中按 `g` 设置整行渐变。
+- **🎯 更准确的 Token 计数** - `Tokens Input` 与 `Tokens Output` 现优先使用累积转录指标，再回退到上下文窗口总量。
+- **💸 额外用量无限制修复** - 对于已启用超额但尚未配置月度限额的账户，额外用量组件不再卡在 `[Timeout]`。
+- **🔁 压缩毛刺过滤** - `Compaction Counter` 会忽略低于 1% 的短暂上下文读数，避免不完整的状态帧产生虚假压缩计数。
+- **🔀 SSH 别名 Git PR/MR 检测** - Git PR/MR 检测会解析 SSH 主机别名，同时为 CLI 选择与回退仓库链接保留规范的 GitHub 与 GitLab 主机。
+- **🧪 用量测试缓存隔离** - 用量获取测试探测现会隔离 `HOME`、`USERPROFILE`、`CLAUDE_CONFIG_DIR` 及代理变量，使本地测试无法触及真实的 ccstatusline 缓存。
+- **📦 依赖刷新** - 为本次发布刷新了 React/React DOM 与 Bun lockfile 开发工具解析。
 
-### v2.2.14 - v2.2.19 - Version pinning, npm provenance, usage overage widgets, and Git lock avoidance
+### v2.2.14 - v2.2.19 - 版本固定、npm 来源证明、用量超额组件与 Git 锁规避
 
-- **📌 Version pinning support** - Added support for pinned global installs so Claude Code can keep running a specific ccstatusline version.
-- **🔐 npm provenance attestations** - Published packages now use trusted publishing provenance so users can verify where releases were built while avoiding long-lived npm publish tokens.
-- **🔄 Moving from auto-update installs** - If you currently use an auto-updating install, use the TUI uninstall option first, then reinstall to go through the version pinning flow. Your ccstatusline settings are preserved when uninstalling.
-- **💸 Extra usage widgets** - Added Extra Usage Utilization and Extra Usage Remaining widgets for monthly pay-as-you-go overage limits, with null rate-limit buckets handled as zero usage.
-- **🔒 Git lock avoidance** - Git helpers now pass `--no-optional-locks` so background status checks avoid creating `index.lock` races.
-- **🧱 Older Git compatibility** - Git widgets avoid newer command forms so repository status works on older Git installations.
-- **⚡ Persistent Git cache** - Git command output is cached under `~/.cache/ccstatusline/git-cache` with configurable TTL and `.git/HEAD`/`.git/index` mtime checks to reduce repeated subprocess work.
-- **🧭 Install flow polish** - Pinned global install is now the default install option, with clearer wording for install and migration flows.
-- **🪟 Hidden helper processes** - Runtime child processes set `windowsHide` so helper commands do not open extra windows on Windows.
-- **📏 Terminal width override** - `CCSTATUSLINE_WIDTH` can provide an explicit terminal width when automatic probing is unavailable.
+- **📌 版本固定支持** - 新增对固定全局安装的支持，使 Claude Code 可持续运行特定 ccstatusline 版本。
+- **🔐 npm 来源证明（provenance）认证** - 已发布包现使用可信发布来源证明，用户可验证发布构建位置，同时避免长期有效的 npm 发布 Token。
+- **🔄 从自动更新安装迁移** - 若你当前使用自动更新安装，请先使用 TUI 卸载选项，再重新安装以走版本固定流程。卸载时你的 ccstatusline 设置会保留。
+- **💸 额外用量组件** - 新增 Extra Usage Utilization 与 Extra Usage Remaining 组件，用于月度按量付费超额限额，空速率限制桶按零用量处理。
+- **🔒 Git 锁规避** - Git 辅助工具现传递 `--no-optional-locks`，使后台状态检查避免产生 `index.lock` 竞争。
+- **🧱 旧版 Git 兼容** - Git 组件避免使用较新的命令形式，使仓库状态在较旧的 Git 安装上仍可工作。
+- **⚡ 持久化 Git 缓存** - Git 命令输出缓存在 `~/.cache/ccstatusline/git-cache` 下，可配置 TTL，并通过 `.git/HEAD`/`.git/index` mtime 检查减少重复的子进程工作。
+- **🧭 安装流程优化** - 固定全局安装现为默认安装选项，安装与迁移流程的措辞更清晰。
+- **🪟 隐藏辅助进程** - 运行时子进程设置 `windowsHide`，使辅助命令不会在 Windows 上打开额外窗口。
+- **📏 终端宽度覆盖** - 当自动探测不可用时，`CCSTATUSLINE_WIDTH` 可提供显式的终端宽度。
 
-### v2.2.13 - Weekly model usage, voice status, hooks, and docs
+### v2.2.13 - 每周模型用量、语音状态、钩子与文档
 
-- **📊 Weekly Sonnet/Opus usage widgets** - Added separate weekly usage widgets for Sonnet and Opus API buckets, matching Claude Code's `/usage` model split.
-- **🎤 Voice Status widget** - Added a widget that shows whether Claude Code voice input is enabled, with icon, text, word, and optional Nerd Font display modes.
-- **📉 Timer short bars** - Block Timer, Block Reset Timer, and Weekly Reset Timer now support compact short-bar progress displays.
-- **🔕 Quieter hook output** - Hook handling now suppresses no-op JSON output so non-status updates stay silent.
+- **📊 每周 Sonnet/Opus 用量小组件** - 为 Sonnet 和 Opus API 配额分别新增每周用量小组件，与 Claude Code 的 `/usage` 模型划分一致。
+- **🎤 语音状态小组件** - 新增显示 Claude Code 语音输入是否启用的小组件，支持图标、文本、单词以及可选的 Nerd Font 显示模式。
+- **📉 计时器短进度条** - Block Timer、Block Reset Timer 和 Weekly Reset Timer 现已支持紧凑的短进度条显示。
+- **🔕 更安静的钩子输出** - 钩子处理现在会抑制无操作的 JSON 输出，使非状态更新保持静默。
 
-### v2.2.9 - v2.2.12 - GitLab support, reset timers, context, compaction, and git widgets
+### v2.2.9 - v2.2.12 - GitLab 支持、重置计时器、上下文、压缩与 Git 小组件
 
-- **🦊 GitLab PR/MR support** - `Git Branch` and `Git PR/MR` now support GitHub, GitLab, and compatible self-hosted remotes, using `gh` or `glab` as appropriate.
-- **🔄 Status line refresh interval** - Installed configs can set Claude Code's `statusLine.refreshInterval` from the TUI when Claude Code >=2.1.97 supports it.
-- **🧭 Wrap-around TUI navigation** - Menu/list navigation and move/reorder modes now wrap at the first and last items.
-- **📋 Clone widget shortcut** - Press `k` in the item editor to duplicate the selected widget, with fresh Powerline background color for cloned Powerline items.
-- **📊 Short bar display modes** - Context percentage, Context Bar, Session Usage, Weekly Usage, Block Timer, and reset timer widgets can use compact bar variants.
-- **⏱️ Usage time cursor** - Session Usage and Weekly Usage progress bars can show the elapsed time position within the current usage window.
-- **🕒 Reset timer timestamps** - Block and Weekly Reset Timer widgets can show exact reset timestamps with compact formatting, 12/24-hour display, IANA time zones, and locale selection.
-- **🪟 Context Window widget** - Added a `Context Window` widget for total model window size, keeping `Context Length` focused on current context usage.
-- **🔁 Compaction Counter widget** - Added a `Compaction Counter` widget that tracks session context compactions, with icon/text/number formats, optional Nerd Font icon, and hide-when-zero behavior.
-- **🧮 Git file status widgets** - Added `Git Staged Files`, `Git Unstaged Files`, `Git Untracked Files`, and `Git Clean Status` for file counts and clean/dirty state.
-- **🏷️ Clear context percentage labels** - `Context %` and `Context % (usable)` now label rendered values as used or left when toggling used/remaining mode.
-- **⚡ More Powerline caps** - The Powerline separator editor now supports more than three start/end caps.
-- **🧠 Thinking Effort updates** - Added `xhigh`, show `default` when no effort is set, mark unknown future effort levels with `?`, and track live status JSON plus `/effort` command changes. Claude Code reports Ultracode as `xhigh` in status line data.
-- **🧮 More accurate token counts** - Streaming duplicate JSONL entries are deduped so token widgets do not overcount live Claude Code output.
-- **🏷️ Cleaner model display** - The Model widget strips trailing context suffixes like `(1M context)`; use `Context Window` when you want the total window size shown.
-- **🧹 Cleaner empty-widget separators** - Manual separators now collapse around widgets that render empty, avoiding dangling separators when hide-when-empty widgets disappear.
-- **🧱 More resilient Git helpers** - Git widgets handle missing or unusual git command output more defensively.
+- **🦊 GitLab PR/MR 支持** - `Git Branch` 和 `Git PR/MR` 现已支持 GitHub、GitLab 及兼容的自托管远程仓库，并视情况使用 `gh` 或 `glab`。
+- **🔄 状态行刷新间隔** - 已安装的配置可在 TUI 中设置 Claude Code 的 `statusLine.refreshInterval`（Claude Code >=2.1.97 时支持）。
+- **🧭 环绕式 TUI 导航** - 菜单/列表导航以及移动/重排模式现可在首尾项之间环绕切换。
+- **📋 克隆小组件快捷键** - 在条目编辑器中按 `k` 可复制所选小组件；克隆的 Powerline 条目会获得全新的 Powerline 背景色。
+- **📊 短进度条显示模式** - Context percentage、Context Bar、Session Usage、Weekly Usage、Block Timer 及重置计时器小组件可使用紧凑进度条变体。
+- **⏱️ 用量时间光标** - Session Usage 和 Weekly Usage 进度条可显示当前用量窗口内的已用时间位置。
+- **🕒 重置计时器时间戳** - Block 与 Weekly Reset Timer 小组件可显示精确的重置时间戳，支持紧凑格式、12/24 小时制、IANA 时区及区域设置选择。
+- **🪟 Context Window 小组件** - 新增用于总模型窗口大小的 `Context Window` 小组件，使 `Context Length` 专注于当前上下文用量。
+- **🔁 Compaction Counter 小组件** - 新增 `Compaction Counter` 小组件，用于跟踪会话上下文压缩次数，支持图标/文本/数字格式、可选 Nerd Font 图标，以及为零时隐藏。
+- **🧮 Git 文件状态小组件** - 新增 `Git Staged Files`、`Git Unstaged Files`、`Git Untracked Files` 和 `Git Clean Status`，用于文件数量及干净/脏状态。
+- **🏷️ 更清晰的上下文百分比标签** - `Context %` 和 `Context % (usable)` 在切换已用/剩余模式时，会将渲染值标注为已用或剩余。
+- **⚡ 更多 Powerline 端帽** - Powerline 分隔符编辑器现支持超过三个起始/结束端帽。
+- **🧠 Thinking Effort 更新** - 新增 `xhigh`；未设置 effort 时显示 `default`；未知未来 effort 级别以 `?` 标记；并跟踪实时状态 JSON 及 `/effort` 命令变更。Claude Code 在状态行数据中将 Ultracode 报告为 `xhigh`。
+- **🧮 更准确的 token 计数** - 对流式重复的 JSONL 条目去重，避免 token 小组件对 Claude Code 实时输出重复计数。
+- **🏷️ 更简洁的模型显示** - Model 小组件会去除 `(1M context)` 等尾部上下文后缀；若需显示总窗口大小，请使用 `Context Window`。
+- **🧹 更干净的空小组件分隔符** - 手动分隔符现会在渲染为空的小组件周围折叠，避免 hide-when-empty 小组件消失后出现悬空分隔符。
+- **🧱 更具韧性的 Git 辅助功能** - Git 小组件对缺失或异常的 git 命令输出采用更稳健的防御性处理。
 
-### v2.2.8 - Git widgets, smarter picker search, and minimalist mode
+### v2.2.8 - Git 小组件、更智能的选择器搜索与极简模式
 
-- **🔀 New Git PR widget** - Added a `Git PR` widget with clickable PR links plus optional status and title display for the current branch.
-- **🧰 Major Git widget expansion** - Added `Git Status`, `Git Staged`, `Git Unstaged`, `Git Untracked`, `Git Ahead/Behind`, `Git Conflicts`, `Git SHA`, `Git Origin Owner`, `Git Origin Repo`, `Git Origin Owner/Repo`, `Git Upstream Owner`, `Git Upstream Repo`, `Git Upstream Owner/Repo`, `Git Is Fork`, `Git Worktree Mode`, `Git Worktree Name`, `Git Worktree Branch`, `Git Worktree Original Branch`, and `Custom Symbol`.
-- **👤 Claude Account Email widget** - Added a session widget that reads the signed-in Claude account email from `~/.claude.json` while respecting `CLAUDE_CONFIG_DIR`.
-- **🧼 Global Minimalist Mode** - Added a global toggle in `Global Overrides` that forces widgets into raw-value mode for a cleaner, label-free status line.
-- **🔎 Smarter widget picker search** - The add/change widget picker now supports substring, initialism, and fuzzy matching, with ranked results and live match highlighting.
-- **📏 Better terminal width detection** - Flex separators and right-alignment now work more reliably when ccstatusline is launched through wrapper processes or nested PTYs.
-- **🎨 Powerline theme continuity** - Built-in Powerline themes can now continue colors cleanly across multiple status lines instead of restarting each line.
+- **🔀 全新 Git PR 小组件** - 新增 `Git PR` 小组件，提供可点击的 PR 链接，并可选择显示当前分支的状态与标题。
+- **🧰 Git 小组件大幅扩展** - 新增 `Git Status`、`Git Staged`、`Git Unstaged`、`Git Untracked`、`Git Ahead/Behind`、`Git Conflicts`、`Git SHA`、`Git Origin Owner`、`Git Origin Repo`、`Git Origin Owner/Repo`、`Git Upstream Owner`、`Git Upstream Repo`、`Git Upstream Owner/Repo`、`Git Is Fork`、`Git Worktree Mode`、`Git Worktree Name`、`Git Worktree Branch`、`Git Worktree Original Branch` 和 `Custom Symbol`。
+- **👤 Claude Account Email 小组件** - 新增会话小组件，从 `~/.claude.json` 读取已登录 Claude 账户邮箱，同时遵守 `CLAUDE_CONFIG_DIR`。
+- **🧼 全局极简模式（Minimalist Mode）** - 在 `Global Overrides` 中新增全局开关，强制小组件进入原始值模式，以获得更简洁、无标签的状态行。
+- **🔎 更智能的小组件选择器搜索** - 添加/更换小组件选择器现支持子串、首字母缩写和模糊匹配，并提供排序结果与实时匹配高亮。
+- **📏 更可靠的终端宽度检测** - 当 ccstatusline 通过包装进程或嵌套 PTY 启动时，Flex 分隔符与右对齐现可更可靠地工作。
+- **🎨 Powerline 主题连续性** - 内置 Powerline 主题现可在多条状态行之间连续延伸颜色，而无需每行重新起始。
 
 <br />
 <details>
-<summary><b>Older updates (v2.2.6 and earlier)</b></summary>
+<summary><b>更早的更新（v2.2.6 及更早版本）</b></summary>
 
-### v2.2.0 - v2.2.6 - Speed, widgets, links, and reliability updates
+### v2.2.0 - v2.2.6 - 速度、小组件、链接与可靠性更新
 
-- **🚀 New Token Speed widgets** - Added three widgets: **Input Speed**, **Output Speed**, and **Total Speed**.
-  - Each speed widget supports a configurable window of `0-120` seconds in the widget editor (`w` key).
-  - `0` disables window mode and uses a full-session average speed.
-  - `1-120` calculates recent speed over the selected rolling window.
-- **🧩 New Skills widget controls (v2.2.1)** - Added configurable Skills modes (last/count/list), optional hide-when-empty behavior, and list-size limiting with most-recent-first ordering.
-- **🌐 Usage API proxy support (v2.2.2)** - Usage widgets honor the uppercase `HTTPS_PROXY` environment variable for their direct API call to Anthropic.
-- **🧠 New Thinking Effort widget (v2.2.4)** - Added a widget that shows the current Claude Code thinking effort level.
-- **🍎 Better macOS usage lookup reliability (v2.2.5)** - Improved reliability when loading usage API tokens on macOS.
-- **⌨️ New Vim Mode widget (v2.2.5)** - Added a widget that shows the current vim mode, with ASCII and optional Nerd Font icon display.
-- **🔗 Git widget link modes (v2.2.6)** - `Git Branch` can render clickable GitHub branch links, and `Git Root Dir` can render clickable IDE links for VS Code and Cursor.
-- **🤝 Better subagent-aware speed reporting** - Token speed calculations continue to include referenced subagent activity so displayed speeds better reflect actual concurrent work.
+- **🚀 全新 Token Speed 小组件** - 新增三个小组件：**Input Speed**、**Output Speed** 和 **Total Speed**。
+  - 每个速度小组件可在小组件编辑器中配置 `0-120` 秒的时间窗口（`w` 键）。
+  - `0` 会禁用窗口模式，改用整个会话的平均速度。
+  - `1-120` 会在所选滚动窗口内计算近期速度。
+- **🧩 全新 Skills 小组件控件（v2.2.1）** - 新增可配置的 Skills 模式（last/count/list）、可选的 hide-when-empty 行为，以及按最近优先排序的列表大小限制。
+- **🌐 Usage API 代理支持（v2.2.2）** - Usage 小组件在直接调用 Anthropic API 时会遵循大写的 `HTTPS_PROXY` 环境变量。
+- **🧠 全新 Thinking Effort 小组件（v2.2.4）** - 新增显示当前 Claude Code thinking effort 级别的小组件。
+- **🍎 改进 macOS 用量查询可靠性（v2.2.5）** - 提升了在 macOS 上加载 usage API token 的可靠性。
+- **⌨️ 全新 Vim Mode 小组件（v2.2.5）** - 新增显示当前 vim 模式的小组件，支持 ASCII 及可选的 Nerd Font 图标显示。
+- **🔗 Git 小组件链接模式（v2.2.6）** - `Git Branch` 可渲染可点击的 GitHub 分支链接，`Git Root Dir` 可为 VS Code 和 Cursor 渲染可点击的 IDE 链接。
+- **🤝 更好的子代理感知速度报告** - Token 速度计算会继续纳入被引用的子代理活动，使显示速度更贴近实际并发工作。
 
-### v2.1.0 - v2.1.10 - Usage widgets, links, new git insertions / deletions widgets, and reliability fixes
+### v2.1.0 - v2.1.10 - Usage 小组件、链接、全新 git 插入/删除小组件与可靠性修复
 
-- **🧩 New Usage widgets (v2.1.0)** - Added **Session Usage**, **Weekly Usage**, **Block Reset Timer**, and **Context Bar** widgets.
-- **📊 More accurate counts (v2.1.0)** - Usage/context widgets now use new statusline JSON metrics when available for more accurate token and context counts.
-- **🪟 Windows empty file bug fix (v2.1.1)** - Fixed a Windows issue that could create an empty `c:\dev\null` file.
-- **🔗 New Link widget (v2.1.3)** - Added a new **Link** widget with clickable OSC8 rendering, preview parity, and raw mode support.
-- **➕ New Git Insertions widget (v2.1.4)** - Added a dedicated Git widget that shows only uncommitted insertions (e.g., `+42`).
-- **➖ New Git Deletions widget (v2.1.4)** - Added a dedicated Git widget that shows only uncommitted deletions (e.g., `-10`).
-- **🧠 Context format fallback fix (v2.1.6)** - When `context_window_size` is missing, context widgets now infer 1M models from long-context labels such as `[1m]` and `1M context` in model identifiers.
-- **⏳ Weekly reset timer split (v2.1.7)** - Added a separate `Weekly Reset Timer` widget.
-- **⚙️ Custom config file flag (v2.1.8)** - Added `--config <path>` support so ccstatusline can load/save settings from a custom file location.
-- **🔣 Unicode separator hex input upgrade (v2.1.9)** - Powerline separator hex input now supports 4-6 digits (full Unicode code points up to `U+10FFFF`).
-- **🌳 Bare repo worktree detection fix (v2.1.10)** - `Git Worktree` now correctly detects linked worktrees created from bare repositories.
+- **🧩 全新 Usage 小组件（v2.1.0）** - 新增 **Session Usage**、**Weekly Usage**、**Block Reset Timer** 和 **Context Bar** 小组件。
+- **📊 更准确的计数（v2.1.0）** - Usage/context 小组件在可用时会使用新的 statusline JSON 指标，以获得更准确的 token 与上下文计数。
+- **🪟 Windows 空文件问题修复（v2.1.1）** - 修复了 Windows 上可能创建空 `c:\dev\null` 文件的问题。
+- **🔗 全新 Link 小组件（v2.1.3）** - 新增支持可点击 OSC8 渲染、预览一致性与 raw 模式的 **Link** 小组件。
+- **➕ 全新 Git Insertions 小组件（v2.1.4）** - 新增专用 Git 小组件，仅显示未提交的插入行数（例如 `+42`）。
+- **➖ 全新 Git Deletions 小组件（v2.1.4）** - 新增专用 Git 小组件，仅显示未提交的删除行数（例如 `-10`）。
+- **🧠 上下文格式回退修复（v2.1.6）** - 当 `context_window_size` 缺失时，上下文小组件现可从模型标识符中的长上下文标签（如 `[1m]` 和 `1M context`）推断 1M 模型。
+- **⏳ 每周重置计时器拆分（v2.1.7）** - 新增独立的 `Weekly Reset Timer` 小组件。
+- **⚙️ 自定义配置文件标志（v2.1.8）** - 新增 `--config <path>` 支持，使 ccstatusline 可从自定义文件位置加载/保存设置。
+- **🔣 Unicode 分隔符十六进制输入升级（v2.1.9）** - Powerline 分隔符十六进制输入现支持 4-6 位数字（完整 Unicode 码点最高至 `U+10FFFF`）。
+- **🌳 裸仓库 worktree 检测修复（v2.1.10）** - `Git Worktree` 现可正确检测由裸仓库创建的关联 worktree。
 
-### v2.0.26 - v2.0.29 - Performance, git internals, and workflow improvements
+</details>
 
-- **🧠 Memory Usage widget (v2.0.29)** - Added a new widget that shows current system memory usage (`Mem: used/total`).
-- **⚡ Block timer cache (v2.0.28)** - Cache block timer metrics to reduce JSONL parsing on every render, with per-config hashed cache files and automatic 5-hour block invalidation.
-- **🧱 Git widget command refactor (v2.0.28)** - Refactored git widgets to use shared git command helpers and expanded coverage for failure and edge-case tests.
-- **🪟 Windows UTF-8 piped output fix (v2.0.28)** - Sets the Windows UTF-8 code page for piped status line rendering.
-- **📁 Git Root Dir widget (v2.0.27)** - Added a new Git widget that shows the repository root directory name.
-- **🏷️ Session Name widget (v2.0.26)** - Added a new widget that shows the current Claude Code session name from `/rename`.
-- **🏠 Current Working Directory home abbreviation (v2.0.26)** - Added a `~` abbreviation option for CWD display in both preview and live rendering.
-- **🧠 Context model suffix fix (v2.0.26)** - Context widgets now recognize the `[1m]` suffix across models, not just a single model path.
-- **🧭 Widget picker UX updates (v2.0.26)** - Improved widget discovery/navigation and added clearer, safer clear-line behavior.
-- **⌨️ TUI editor input fix (v2.0.26)** - Prevented shortcut/input leakage into widget editor flows.
-- **📄 Repo docs update (v2.0.26)** - Migrated guidance from `CLAUDE.md` to `AGENTS.md` (with symlink compatibility).
+### v2.0.26 - v2.0.29 - 性能、Git 内部机制与工作流程改进
 
-### v2.0.16 - Add fish style path abbreviation toggle to Current Working Directory widget
+- **🧠 内存使用（Memory Usage）组件 (v2.0.29)** - 新增组件，显示当前系统内存使用情况（`Mem: used/total`）。
+- **⚡ Block timer 缓存 (v2.0.28)** - 缓存 block timer 指标，减少每次渲染时的 JSONL 解析；按配置生成哈希缓存文件，并自动在 5 小时 block 后失效。
+- **🧱 Git 组件命令重构 (v2.0.28)** - 重构 Git 组件以使用共享的 Git 命令辅助函数，并扩大失败与边界情况的测试覆盖。
+- **🪟 Windows UTF-8 管道输出修复 (v2.0.28)** - 为管道传输的状态行渲染设置 Windows UTF-8 代码页。
+- **📁 Git 根目录（Git Root Dir）组件 (v2.0.27)** - 新增 Git 组件，显示仓库根目录名称。
+- **🏷️ 会话名称（Session Name）组件 (v2.0.26)** - 新增组件，从 `/rename` 显示当前 Claude Code 会话名称。
+- **🏠 当前工作目录（Current Working Directory）主目录缩写 (v2.0.26)** - 为预览与实时渲染中的 CWD 显示新增 `~` 缩写选项。
+- **🧠 Context 模型后缀修复 (v2.0.26)** - Context 组件现可跨模型识别 `[1m]` 后缀，而非仅支持单一模型路径。
+- **🧭 组件选择器 UX 更新 (v2.0.26)** - 改进组件发现与导航，并添加更清晰、更安全的清行行为。
+- **⌨️ TUI 编辑器输入修复 (v2.0.26)** - 防止快捷键/输入泄漏到组件编辑器流程中。
+- **📄 仓库文档更新 (v2.0.26)** - 将指引从 `CLAUDE.md` 迁移至 `AGENTS.md`（兼容符号链接）。
 
-### v2.0.15 - Block Timer calculation fixes
+### v2.0.16 - 为当前工作目录组件添加 fish 风格路径缩写开关
 
-- Fix miscalculation in the block timer
+### v2.0.15 - Block Timer 计算修复
 
-### v2.0.14 - Add remaining mode toggle to Context Percentage widgets
+- 修复 block timer 中的计算错误
 
-- **Remaining Mode** - You can now toggle the Context Percentage widgets between usage percentage and remaining percentage when configuring them in the TUI by pressing the 'u' key.
+### v2.0.14 - 为 Context Percentage 组件添加剩余模式开关
 
-### v2.0.12 - Custom Text widget now supports emojis
+- **剩余模式（Remaining Mode）** - 在 TUI 中配置时，可按 `u` 键在 Context Percentage 组件的使用百分比与剩余百分比之间切换。
 
-- **👾 Emoji Support** - You can now paste emoji into the custom text widget. You can also turn on the merge option to get emoji labels for your widgets like this:
+### v2.0.12 - 自定义文本（Custom Text）组件现支持 emoji
+
+- **👾 Emoji 支持** - 现可将 emoji 粘贴到自定义文本组件中。也可开启合并选项，为组件添加 emoji 标签，效果如下：
   
 ![Emoji Support](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/emojiSupport.png)
 
-### v2.0.11 - Unlimited Status Lines
+### v2.0.11 - 无限制状态行
 
-- **🚀 No Line Limit** - Configure as many status lines as you need - the 3-line limitation has been removed
+- **🚀 无行数限制** - 可按需配置任意数量的状态行，已移除 3 行限制
 
-### v2.0.10 - Git Updates
+### v2.0.10 - Git 更新
 
-- **🌳 Git Worktree widget** - Shows the active worktree name when working with git worktrees
-- **👻 Hide 'no git' message toggle** - Git widgets now support hiding the 'no git' message when not in a repository (toggle with 'h' key while editing the widget)
+- **🌳 Git Worktree 组件** - 使用 git worktree 时显示当前活跃的 worktree 名称
+- **👻 隐藏「no git」消息开关** - Git 组件现支持在非仓库环境中隐藏「no git」消息（编辑组件时按 `h` 键切换）
 
-### v2.0.8 - Powerline Auto-Alignment
+### v2.0.8 - Powerline 自动对齐
 
 ![Powerline Auto-Alignment](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/autoAlign.png)
 
-- **🎯 Widget Alignment** - Auto-align widgets across multiple status lines in Powerline mode for a clean, columnar layout (toggle with 'a' in Powerline Setup)
+- **🎯 组件对齐** - 在 Powerline 模式下跨多条状态行自动对齐组件，实现整洁的列式布局（在 Powerline 设置中按 `a` 切换）
 
-### v2.0.7 - Current Working Directory & Session Cost
+### v2.0.7 - 当前工作目录与会话费用
 
 ![Current Working Directory and Session Cost](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/cwdAndSessionCost.png)
 
-- **📁 Current Working Directory** - Display the current working directory with configurable segment display
-  - Set the number of path segments to show (e.g., show only last 2 segments: `.../Personal/ccstatusline`)
-  - Supports raw value mode for compact display
-  - Automatically truncates long paths with ellipsis
-- **💰 Session Cost Widget** - Track your Claude Code session costs (requires Claude Code 1.0.85+)
-  - Displays total session cost in USD
-  - Supports raw value mode (shows just `$X.YZ` vs `Cost: $X.YZ`)
-  - Real-time cost tracking from Claude Code session data
-  - Note: Cost may not update properly when using `/resume` (Claude Code limitation)
-- **🐛 Bug Fixes**
-  - Fixed Block Timer calculations for accurate time tracking across block boundaries
-  - Improved widget editor stability with proper Ctrl+S handling
-  - Enhanced cursor display in numeric input fields
+- **📁 当前工作目录（Current Working Directory）** - 显示当前工作目录，支持可配置的路径段显示
+  - 设置显示的路径段数量（例如仅显示最后 2 段：`.../Personal/ccstatusline`）
+  - 支持原始值模式以实现紧凑显示
+  - 自动用省略号截断过长路径
+- **💰 会话费用（Session Cost）组件** - 追踪 Claude Code 会话费用（需要 Claude Code 1.0.85+）
+  - 以 USD 显示会话总费用
+  - 支持原始值模式（仅显示 `$X.YZ` 与 `Cost: $X.YZ`）
+  - 基于 Claude Code 会话数据实时追踪费用
+  - 注意：使用 `/resume` 时费用可能无法正确更新（Claude Code 限制）
+- **🐛 错误修复**
+  - 修复 Block Timer 计算，确保跨 block 边界的时间追踪准确
+  - 改进组件编辑器稳定性，正确处理 Ctrl+S
+  - 增强数字输入字段中的光标显示
 
-### v2.0.2 - Block Timer Widget
+### v2.0.2 - Block Timer 组件
 
 ![Block Timer](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/blockTimerSmall.png)
 
-- **⏱️ Block Timer** - Track your progress through 5-hour Claude Code blocks
-  - Displays time elapsed in current block as hours/minutes (e.g., "3hr 45m")
-  - Progress bar mode shows visual completion percentage
-  - Two progress bar styles: full width (32 chars) or compact (16 chars)
-  - Automatically detects block boundaries from transcript timestamps
+- **⏱️ Block Timer** - 追踪你在 5 小时 Claude Code block 中的进度
+  - 以小时/分钟显示当前 block 已用时间（例如「3hr 45m」）
+  - 进度条模式显示可视化完成百分比
+  - 两种进度条样式：全宽（32 字符）或紧凑（16 字符）
+  - 根据转录时间戳自动检测 block 边界
 
-### v2.0.0 - Powerline Support & Enhanced Themes
-- **⚡ Powerline Mode** - Beautiful Powerline-style status lines with arrow separators and customizable caps
-- **🎨 Built-in Themes** - Multiple pre-configured themes that you can copy and customize
-- **🌈 Advanced Color Support** - Basic (16), 256-color (with custom ANSI codes), and truecolor (with hex codes) modes, plus multi-stop **gradients** (per-widget or spanning the whole line)
-- **🔗 Widget Merging** - Merge multiple widgets together with or without padding for seamless designs
-- **📦 Easy Installation** - Install directly with `npx` or `bunx` - no global package needed
-- **🔤 Custom Separators** - Add multiple Powerline separators with custom hex codes for font support
-- **🚀 Auto Font Install** - Automatic Powerline font installation with user consent
+### v2.0.0 - Powerline 支持与增强主题
+- **⚡ Powerline 模式** - 美观的 Powerline 风格状态行，带箭头分隔符与可自定义端帽
+- **🎨 内置主题** - 多个预配置主题，可复制并自定义
+- **🌈 高级颜色支持** - 基础（16 色）、256 色（支持自定义 ANSI 代码）与真彩色（支持十六进制代码）模式，以及多停靠点**渐变**（按组件或整行）
+- **🔗 组件合并** - 可将多个组件合并，支持有/无内边距，实现无缝设计
+- **📦 简易安装** - 可直接通过 `npx` 或 `bunx` 安装，无需全局包
+- **🔤 自定义分隔符** - 可添加多个 Powerline 分隔符，支持自定义十六进制代码以适配字体
+- **🚀 自动字体安装** - 经用户同意后自动安装 Powerline 字体
 
 </details>
 
 <br />
 
-## ✨ Features
+## ✨ 功能特性
 
-- **📊 Real-time Metrics** - Display model name, git branch, token usage, per-model weekly usage, extra usage limits, voice input state, session duration, compaction count, block timer, and more
-- **🎨 Fully Customizable** - Choose what to display and customize colors for each element
-- **⚡ Powerline Support** - Beautiful Powerline-style rendering with arrow separators, caps, and custom fonts
-- **📐 Multi-line Support** - Configure multiple independent status lines
-- **🖥️ Interactive TUI** - Built-in configuration interface using React/Ink
-- **🔎 Fast Widget Picker** - Add/change widgets by category with search and ranked matching
-- **⚙️ Global Options** - Apply consistent formatting across all widgets (padding, separators, bold, minimalist mode, and color overrides)
-- **🚀 Cross-platform** - Works seamlessly with both Bun and Node.js
-- **🔧 Flexible Configuration** - Supports custom Claude Code config directory via `CLAUDE_CONFIG_DIR` environment variable
-- **📏 Smart Width Detection** - Automatically adapts to terminal width with flex separators
-- **⚡ Zero Config** - Sensible defaults that work out of the box
+- **📊 实时指标** - 显示模型名称、git 分支、token 用量、各模型周用量、额外用量限制、语音输入状态、会话时长、压缩次数、block timer 等
+- **🎨 完全可定制** - 选择显示内容并为每个元素自定义颜色
+- **⚡ Powerline 支持** - 美观的 Powerline 风格渲染，带箭头分隔符、端帽与自定义字体
+- **📐 多行支持** - 可配置多条独立状态行
+- **🖥️ 交互式 TUI** - 基于 React/Ink 的内置配置界面
+- **🔎 快速组件选择器** - 按分类添加/更换组件，支持搜索与排序匹配
+- **⚙️ 全局选项** - 在所有组件间应用一致的格式（内边距、分隔符、粗体、极简模式与颜色覆盖）
+- **🚀 跨平台** - 与 Bun 和 Node.js 无缝配合
+- **🔧 灵活配置** - 通过 `CLAUDE_CONFIG_DIR` 环境变量支持自定义 Claude Code 配置目录
+- **📏 智能宽度检测** - 通过弹性分隔符自动适配终端宽度
+- **⚡ 零配置** - 合理的默认设置，开箱即用
 
 <br />
 
-## 🌐 Localizations
+## 🌐 本地化
 
-The localizations in this section are third-party forks maintained outside this repository. They are not maintained, reviewed, or endorsed by this repository, so review their code and releases before using them.
+本节中的本地化版本为在本仓库之外维护的第三方 fork，未经本仓库维护、审核或背书，使用前请自行审查其代码与发布版本。
 
 - 🌏 **中文版 (Chinese):** [ccstatusline-zh](https://github.com/huangguang1999/ccstatusline-zh)
 
 <br />
 
-## 🚀 Quick Start
+## 🚀 快速开始
 
-### No installation needed! Use directly with npx or bunx:
+### 无需安装！可直接通过 npx 或 bunx 使用：
 
 ```bash
 # Run the configuration TUI with npm
@@ -288,40 +296,40 @@ npx -y ccstatusline@latest
 bunx -y ccstatusline@latest
 ```
 
-Both commands launch the same TUI. During the initial setup flow, choose **Pinned global install** if you want Claude Code to stay on the ccstatusline version you are running instead of following `@latest`; the TUI will install that version globally with npm or Bun and write the pinned `ccstatusline` command to Claude Code settings. After a pinned install, you can run `ccstatusline` directly to launch the TUI in the future.
+两条命令启动相同的 TUI。在初始设置流程中，若希望 Claude Code 固定在你正在运行的 ccstatusline 版本而非跟随 `@latest`，请选择 **Pinned global install（固定全局安装）**；TUI 将通过 npm 或 Bun 全局安装该版本，并将固定的 `ccstatusline` 命令写入 Claude Code 设置。固定安装后，日后可直接运行 `ccstatusline` 启动 TUI。
 
 <br />
 <details>
-<summary><b>Configure ccstatusline</b></summary>
+<summary><b>配置 ccstatusline</b></summary>
 
-The interactive configuration tool provides a terminal UI where you can:
-- Configure multiple separate status lines
-- Add/remove/reorder status line widgets
-- Customize colors for each widget
-- Configure flex separator behavior
-- Configure Claude Code status line refresh interval when supported
-- Edit custom text widgets
-- Install/uninstall to Claude Code settings
-- Preview your status line in real-time
+交互式配置工具提供终端 UI，你可以：
+- 配置多条独立状态行
+- 添加/移除/重排状态行组件
+- 为每个组件自定义颜色
+- 配置弹性分隔符行为
+- 在支持时配置 Claude Code 状态行刷新间隔
+- 编辑自定义文本组件
+- 安装/卸载到 Claude Code 设置
+- 实时预览状态行
 
-> 💡 **Tip:** Your settings are automatically saved to `~/.config/ccstatusline/settings.json`
+> 💡 **提示：** 你的设置会自动保存到 `~/.config/ccstatusline/settings.json`
 
-> 🔧 **Custom Claude Config:** If your Claude Code configuration is in a non-standard location, set the `CLAUDE_CONFIG_DIR` environment variable:
+> 🔧 **自定义 Claude 配置：** 如果你的 Claude Code 配置位于非标准路径，请设置 `CLAUDE_CONFIG_DIR` 环境变量：
 > ```bash
 > # Linux/macOS
 > export CLAUDE_CONFIG_DIR=/custom/path/to/.claude
 > ```
 
-> 🌐 **Usage API proxy:** Usage widgets honor the uppercase `HTTPS_PROXY` environment variable for their direct API call to Anthropic.
+> 🌐 **Usage API 代理：** Usage 小组件在直接调用 Anthropic API 时会遵循大写的 `HTTPS_PROXY` 环境变量。
 
-> 🪟 **Windows Support:** PowerShell examples, installation notes, fonts, troubleshooting, WSL, and Windows Terminal configuration are in [docs/WINDOWS.md](docs/WINDOWS.md).
+> 🪟 **Windows 支持：** PowerShell 示例、安装说明、字体、故障排除、WSL 以及 Windows Terminal 配置请参见 [docs/WINDOWS.md](docs/WINDOWS.md)。
 
 </details>
 
 <details>
-<summary><b>Claude Code settings.json format</b></summary>
+<summary><b>Claude Code settings.json 格式</b></summary>
 
-When you install from the TUI, ccstatusline writes a `statusLine` command object to your Claude Code settings:
+从 TUI 安装时，ccstatusline 会向你的 Claude Code 设置写入一个 `statusLine` 命令对象：
 
 ```json
 {
@@ -334,60 +342,60 @@ When you install from the TUI, ccstatusline writes a `statusLine` command object
 }
 ```
 
-`refreshInterval` is written only when your Claude Code version supports it (>=2.1.97). The TUI can set it to `1-60` seconds, or remove it by leaving the input empty.
+仅当你的 Claude Code 版本支持时（>=2.1.97）才会写入 `refreshInterval`。TUI 可将其设置为 `1-60` 秒，或将输入留空以移除该项。
 
-Other supported command values are:
+其他支持的 command 值包括：
 - `bunx -y ccstatusline@latest`
-- `ccstatusline` (for self-managed/global installs)
+- `ccstatusline`（适用于自管/全局安装）
 
-For pinned installs, launch the TUI with `npx -y ccstatusline@latest` or `bunx -y ccstatusline@latest`, then choose **Pinned global install**. The TUI pins the active version by installing it globally and writing `"command": "ccstatusline"` to `settings.json`; afterward, you can run `ccstatusline` directly to open the TUI.
+对于固定版本安装，请使用 `npx -y ccstatusline@latest` 或 `bunx -y ccstatusline@latest` 启动 TUI，然后选择 **Pinned global install**。TUI 会通过全局安装当前活动版本，并将 `"command": "ccstatusline"` 写入 `settings.json` 来固定版本；之后，你可以直接运行 `ccstatusline` 直接打开 TUI。
 
 </details>
 
-## 🤝 Contributing
+## 🤝 参与贡献
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+欢迎贡献！请随时提交 Pull Request。
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+1. Fork 该仓库
+2. 创建你的功能分支（`git checkout -b feature/amazing-feature`）
+3. 提交你的更改（`git commit -m 'Add some amazing feature'`）
+4. 推送到该分支（`git push origin feature/amazing-feature`）
+5. 打开 Pull Request
 
 
-## Support
+## 支持
 
-If ccstatusline is useful to you, consider buying me a coffee:
+如果 ccstatusline 对你有帮助，欢迎请作者喝杯咖啡：
 
 <a href="https://www.buymeacoffee.com/sirmalloc" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
 
 
-## 📄 License
+## 📄 许可证
 
 [MIT](LICENSE) © Matthew Breedlove
 
 
-## 👤 Author
+## 👤 作者
 
 **Matthew Breedlove**
 
 - GitHub: [@sirmalloc](https://github.com/sirmalloc)
 
 
-## 🔗 Related Projects
+## 🔗 相关项目
 
-- [ccstatusline-editor](https://github.com/refinist/ccstatusline-editor) - A visual editor for building ccstatusline configurations — drag, drop, preview, ship.
-- [tweakcc](https://github.com/Piebald-AI/tweakcc) - Customize Claude Code themes, thinking verbs, and more.
-- [ccusage](https://github.com/ryoppippi/ccusage) - Track and display Claude Code usage metrics.
-- [codachi](https://github.com/vincent-k2026/codachi) - A tamagotchi-style statusline pet that grows with your context window.
-- [AIWatch](https://ai-watch.dev) - Live status monitor for 30+ AI APIs and apps; pairs with a Custom Command widget to surface provider outages in your status line.
-- [crispy-recall](https://github.com/TheSylvester/crispy-recall) - Searchable memory for your Claude Code and Codex sessions. Local, fast, no daemon.
+- [ccstatusline-editor](https://github.com/refinist/ccstatusline-editor) - 用于构建 ccstatusline 配置的可视化编辑器——拖拽、预览、发布。
+- [tweakcc](https://github.com/Piebald-AI/tweakcc) - 自定义 Claude Code 主题、thinking verbs 等。
+- [ccusage](https://github.com/ryoppippi/ccusage) - 跟踪并展示 Claude Code 使用指标。
+- [codachi](https://github.com/vincent-k2026/codachi) - 随上下文窗口增长而成长的电子宠物风格 statusline 伙伴。
+- [AIWatch](https://ai-watch.dev) - 30+ 个 AI API 与应用的实时状态监控；可与 Custom Command 小组件配合，在 status line 中展示提供商故障。
+- [crispy-recall](https://github.com/TheSylvester/crispy-recall) - 为 Claude Code 与 Codex 会话提供可搜索的记忆。本地、快速、无需守护进程。
 
-## 🙏 Acknowledgments
+## 🙏 致谢
 
-- Built for use with [Claude Code CLI](https://claude.ai/code) by Anthropic
-- Powered by [Ink](https://github.com/vadimdemedes/ink) for the terminal UI
-- Made with ❤️ for the Claude Code community
+- 为配合 [Claude Code CLI](https://claude.ai/code) by Anthropic 使用而构建
+- 终端 UI 由 [Ink](https://github.com/vadimdemedes/ink) 驱动
+- 为 Claude Code 社区倾心打造 ❤️
 
 <br />
 
@@ -403,9 +411,9 @@ If ccstatusline is useful to you, consider buying me a coffee:
 
 <div align="center">
 
-### 🌟 Show Your Support
+### 🌟 表达你的支持
 
-Give a ⭐ if this project helped you!
+如果这个项目对你有帮助，请给个 ⭐！
 
 [![GitHub stars](https://img.shields.io/github/stars/sirmalloc/ccstatusline?style=social)](https://github.com/sirmalloc/ccstatusline/stargazers)
 [![GitHub forks](https://img.shields.io/github/forks/sirmalloc/ccstatusline?style=social)](https://github.com/sirmalloc/ccstatusline/network/members)
@@ -420,7 +428,7 @@ Give a ⭐ if this project helped you!
 [![Pull Requests](https://img.shields.io/github/issues-pr/sirmalloc/ccstatusline)](https://github.com/sirmalloc/ccstatusline/pulls)
 [![Contributors](https://img.shields.io/github/contributors/sirmalloc/ccstatusline)](https://github.com/sirmalloc/ccstatusline/graphs/contributors)
 
-### 💬 Connect
+### 💬 联系
 
 [Report Bug](https://github.com/sirmalloc/ccstatusline/issues) · [Request Feature](https://github.com/sirmalloc/ccstatusline/issues) · [Discussions](https://github.com/sirmalloc/ccstatusline/discussions)