claude-statusbar

claude-statusbar 控制技能

只要用户想检查、更改、自定义或诊断 cs 状态栏，就使用此技能。它取代了旧的独立斜杠命令（/statusbar、/statusbar-theme、/statusbar-style、/statusbar-preview、/statusbar-doctor、/statusbar-reset）——这些命令仍然有效，但此技能可通过对话意图涵盖所有这些功能。

决策树

将用户的意图匹配到相应的 cs 命令。通过 Bash 运行该命令，然后给出简短确认（一行即可，无需长篇说明）。

用户意图	命令
查看当前配置	cs config show
列出主题	cs themes
列出样式	cs styles
将主题切换为 <name>	cs config set theme <name>
将样式切换为 <name>	cs config set style <name>
更改密度	cs config set density <compact|regular|cozy>
显示全部 27 种组合	cs preview
将预览筛选为一种样式或主题	cs preview --style <s> 或 cs preview --theme <t>
诊断问题	cs doctor
将某个键恢复为默认值	cs config unset <key>（配置中只存储你更改过的内容）
清除配置	cs config reset
安装／首次设置	cs --setup
升级／更新到最新版本	cs upgrade — 切勿猜测使用 uv tool install／pip install -U／pipx upgrade：它会检测当前运行 cs 的实际安装渠道，并选择正确的渠道（许多用户根本没有安装 uv）
关闭自动升级	cs config set auto_upgrade false（默认为 true — 每天一次的后台检查会升级所有安装渠道，包括二进制文件；CLAUDE_STATUSBAR_NO_UPDATE=1 也会生效）
启用快速模式（守护进程）	cs --setup --fast
禁用快速模式	cs daemon stop，然后重新运行 cs --setup
切换会话费用显示	cs config set show_cost true|false
切换提示词缓存倒计时	cs config set show_cache_age true|false
切换项目和分支第 2 行	cs config set show_project_branch true|false（默认为 true）
切换 ocs 行（ocs boss · claude-7d5a5d07 · ✉3 · lan win：地址、未读私信、局域网桥接；单独一行；没有 ocs ≥ 0.5.0 时会自动隐藏；✉ 需要其 inbox 接受 --session 的 ocs）	cs config set show_ocs true|false（默认为 true）
切换待办进度（▸ task 3/7，第 3 行）	cs config set show_todos true|false（默认为 true）
切换活动工具指示符 ◐（第 3 行）	cs config set show_tools true|false
切换已完成工具汇总 ✓ name×N（第 3 行）	cs config set show_tool_rollup true|false（默认关闭 — 数量统计）
切换运行中子 Agent 的底部行	cs config set show_agents true|false（默认关闭 — Claude Code 原生显示后台 Agent）
切换会话时长 ⏱（位于身份行）	cs config set show_duration true|false
切换新增／删除行数 +/-（位于身份行）	cs config set show_lines true|false
切换 git 领先／落后 ↑↓（位于身份行）	cs config set show_ahead_behind true|false
切换 bar_shimmer 闪烁星空效果（实验性，仅经典模式）	cs config set bar_shimmer true|false（默认关闭）
切换速率限制预测（→NN% 预计用量／⚠eta 警告）	cs config set show_forecast true|false（默认开启）
切换身份行末尾淡化显示的版本和更新提示（· vX.Y.Z ↑new）	cs config set show_version true|false（默认开启）
切换 ⚙ 会话模式行（effort／thinking／fast／output-style）	cs config set show_mode true|false（默认开启）
切换模式行上的按 effort 渐变着色	cs config set mode_gradient true|false（默认开启）
隐藏每周进度条	cs config set show_weekly false
设置警告阈值	cs config set warning_threshold <0-100>
设置严重警告阈值	cs config set critical_threshold <0-100>
在低于指定宽度时自动折叠为细线	cs config set auto_compact_width <px>
强制启用／禁用无配额（API）模式	cs config set api_mode <auto|on|off>
显示工作目录	cs config set show_cwd true|false + cs config set cwd_style <basename|full>
Relay 余额燃料表	cs config set show_balance true|false + cs config set balance_bar true|false（仅无配额模式；Relay 没有余额 API 时会自动隐藏）
出口 IP 纯净度区段（还会分别使用我们自己的主机检查 IPv4 和 IPv6 出口 — 在 IPv4／IPv6 分流、WARP、VPN／代理或不受支持的区域时发出警告；不会联系 Anthropic；按域名设置的代理规则仍可能将 claude.ai 路由到其他位置）	cs config set show_ip_risk true|false
Relay 指纹风险水印	cs config set show_fp_risk true|false
窗口结束预测 →NN%	cs config set show_projection true|false
Worktree 标记符号	cs config set worktree_glyph 🌲（默认为 ⑂；任意 1-2 个单元格宽的符号均可 — emoji 不受主题颜色影响，其显示效果由 emoji 字体决定）
Worktree 标记颜色	cs config set color_worktree "#bd93f9"（空字符串会恢复主题色调）

无配额模式（第三方中转 / Bedrock / Vertex）

当 Claude Code 指向第三方中转（ANTHROPIC_BASE_URL ≠ api.anthropic.com）或云后端（CLAUDE_CODE_USE_BEDROCK / CLAUDE_CODE_USE_VERTEX）时，官方的 5h/7d 配额就不存在了。cs 会检测到这种情况， 并切换到无配额布局：移除两个配额电量条，并将上下文窗口提升为独立的 ctx[…] 电量条 （使用量达到 70/85% 时依次变为绿色→黄色→红色），后面接模型名称和常规的实时活动尾部信息。这与 claude-hud 的行为一致；当用户说“用 API 就没状态了 / 连上下文都没了”时，就应该使用此模式。

• 自动检测（api_mode = auto，默认设置）。基于转录记录的启发式判断也能识别环境变量未传递到 statusLine 子进程的中转服务（已有助手轮次，但始终没有配额 → 无配额）。
• 如果自动检测未能识别，可在此设置下强制开启：cs config set api_mode on（也可在每个 shell 中设置 CS_API_MODE=on）。使用 api_mode off 可强制恢复官方布局。CS_API_MODE 环境变量优先于已保存的配置。
• 内联和快速模式（守护进程）渲染路径均可使用。

按严重程度覆盖颜色（v3.4.1+）

用户可以独立于主题覆盖三种严重程度颜色：

cs config set color_ok   "#4ec85b"   # calm / safe
cs config set color_warn "#e8b260"   # warning
cs config set color_hot  "#e87474"   # critical

cs config set color_ok ""            # clear back to theme default

接受 #rrggbb、#rgb 或不带井号的 rrggbb。覆盖色会叠加到当前主题上——无需为了调整一种颜色而切换主题。

当用户说“让余量颜色 / 安全色 / 绿色更鲜明”、“警告色太淡”或“严重色太红”时，使用颜色覆盖，而不是切换主题。

根据氛围推荐主题

如果用户描述的是氛围，而不是直接说出主题名称，请推荐一个主题，并在切换前询问：

氛围 / 场景	主题
柔和、专业、深色终端	graphite（默认）
柔和、温暖、深色	twilight
经典开发风格 / 受 Nord 启发	nord
高对比度、鲜艳	dracula
温暖、可爱、浅色背景	sakura
浅色终端	linen
纯灰度 / 无颜色	mono
流行的粉彩风格，适合长时间观看	catppuccin-mocha
更深邃的霓虹蓝氛围	tokyo-night

渲染结构（便于说明更改内容）

5h[██16% ░░░]⏰2h27m | 7d[██32%  ░░]⏰4d05h | Opus 4.7(280k/1M) | $ 1.42 | cache 4m23s
└─ 5h ─────┘└──5h──┘  └─ 7d ──┘ └─7d─┘   └────context───────┘  └cost┘  └─cache─┘

每个数值部分都根据自身严重程度着色（v3.4 起）：

• 5h → 根据 msgs_pct 选择 theme.s_*
• 7d → 根据 weekly_pct 选择 theme.s_*
• 模型+上下文 → 根据 ctx_used_pct 选择 theme.s_*（None → 中性色）
• 缓存 → 根据字符串年龄使用独立的严重程度颜色（COLD → 红色，<1m → 黄色，否则为绿色）
• [ ]、( )、| → 使用 theme.mute（淡化显示，突出数据）

常见诊断流程

“状态栏没有显示” → 运行 cs doctor。它会自动检查：

• Claude Code 的 ~/.claude/settings.json 是否包含 statusLine 区块
• cs 二进制文件是否在 PATH 中
• 守护进程是否运行（如果已配置快速模式）
• 缓存文件是否已过期

“refreshInterval 太高” → 如果内联命令的 refreshInterval ≤ 2s，cs doctor 会建议运行 cs --setup --fast。快速模式可将 1Hz 下的 CPU 占用从约 6% 降至约 2%。

“运行 cs config set theme X 后颜色没有变化” → 检查用户是否在启动时读取了 settings.json 的 Claude Code 会话中。让他们发送新的提示词；下一次渲染就会使用新主题。

不要

• 除非用户询问，否则不要讲解 ANSI 代码或终端兼容性。
• 不要建议手动编辑 ~/.claude/claude-statusbar.json。请使用 cs config set <key> <value>。
• 不要只为修复一种颜色而更改主题——请使用 color_ok / color_warn / color_hot 覆盖项。
• 未经用户确认，不要运行具有破坏性的命令（cs config reset、cs daemon stop）。

回复风格

简洁作答。运行命令，贴出一行确认信息，并在相关时指出下一步。状态栏就在屏幕上——用户能立即看到结果，无需描述。