Claude 状态栏控制技能
通过对话式指令管理 cs 状态栏——切换主题样式、微调警告颜色、诊断故障、控制 5h/7d 用量、上下文窗口与提示缓存倒计时的显示。
技能本身为 cs 命令的薄封装:仅通过 Bash 调用本地 CLI,明示'不运行破坏性命令(config reset、daemon stop)前需用户确认',数据流披露充分(本地缓存、AgentParty 桥'不读令牌、不发网络请求'、per-model 限额的 OAuth 只读访问默认关闭并有说明),有 SECURITY.md 定义安全边界与报告流程。扣分项:默认开启每日自动升级(后台更新通道,虽有 CLAUDE_STATUSBAR_NO_UPDATE 和 config 开关)、curl|bash 安装模式、发布者身份未验证。
决策树覆盖安装/配置/诊断全路径,cs doctor 提供结构化自检(settings.、PATH、daemon、陈旧缓存),常见故障流程含具体解释;仓库有 CI(3.9–3.12 矩阵)与针对关键路径(账户切换、预测存储)的提交测试。静态审查不能执行,测试主要覆盖后端而非技能调用路径本身,异常输入下的失败反馈质量只能部分确认,按静态上限 10 记。
触发词极其详尽(中英双语、cs/状态栏/主题/阈值等同义词),有明确的 non-fit(no-quota 模式、Codex 桥的范围限制)、输入输出示例与 27 种组合预览;中文场景适配良好(中文触发词、中文 README)。扣分:部分功能依赖 Claude Code 特定版本行为(statusLine、transcript 启发式),边界声明散落在文档而非集中声明。
文档分层清晰(SKILL 决策树 → segments/styles/configuration/troubleshooting 专项文档),MIT 许可、pyproject 版本号 3.42.0、CHANGELOG 与 Releases 链接齐备,有 CONTRIBUTING 与维护者联系路径,升级路径唯一(cs upgrade)且解释原因。扣分:SKILL.md 本身未标注版本对应关系,大量默认值散在表格中存在隐性假设,技能与旧斜杠命令的双轨过渡未标废弃时间表。
价值主张明确且有对比表(vs ccusage、claude-monitor),输出为终端即时可见的一行状态,命令语义单一、可直接使用;官方 5h/7d 数据来源声明(非本地猜测)增强可信度。静态审查无法验证渲染输出正确性,comparative-benefit 依赖作者陈述,按上限内偏保守记 6。
有多类可审计材料:提交的测试(含真实事故复盘 test_account_switch)、CI 工作流(含发布冒烟测试与基准脚本)、SECURITY/CHANGELOG 治理文件。静态审查不能独立复现结论,且未审查全部 900+ 测试,按静态上限 5 记。
- 默认启用每日自动升级(auto_upgrade true),会在后台更新各安装渠道;不希望后台更新时请执行 cs config set auto_upgrade false 或设置 CLAUDE_STATUSBAR_NO_UPDATE=1。
- 一键 curl|bash 安装会写入 ~/.claude/settings. 并可能注册 macOS 登录项(HUD);安全敏感用户应先阅读 install.sh 再执行。
- 可选的 per-model 限额功能会读取 ~/.claude/.credentials. 或 macOS 钥匙串并请求 Anthropic 非公开接口;该功能默认关闭,如不需要请勿开启。
- 本评分仅为静态源码审查,未实际执行渲染或安装流程;发布者身份未经 FollowSkills 验证。
- fast 模式(daemon)会常驻后台并定时刷新,CPU 与缓存文件行为请参考 docs/daemon.md 自行评估。
这个 Skill 能做什么,适合哪些场景?
这个技能让 Claude 代替你操作 claude-statusbar(cs)的完整配置。你用自然语言说"换成 dracula 主题""警告色太淡""状态栏不显示了",Claude 会映射到正确的 cs 命令并执行。它取代了旧的 /statusbar 系列斜杠命令,且明确警告不要用 pip/uv 手动升级(cs upgrade 是唯一支持的升级路径)。适合已经或打算安装 claude-statusbar 的 Claude Code 用户。
把用户意图翻译成具体的 cs 子命令并经 Bash 执行:查看/切换主题、样式、密度;预览全部 27 种组合;独立覆盖 ok/warn/hot 三档严重度颜色;运行 cs doctor 自检(settings. statusLine 配置、二进制在 PATH、守护进程存活、缓存是否过期);用 cs upgrade 检测实际安装渠道升级;开关会话费用、缓存倒计时、待办进度、活动工具、子代理、会话时长、改动行数、git 领先落后、预测芯片等约 40 个配置项;自动识别第三方中转/Bedrock/Vertex 的无配额模式(上下文窗口独立电池条);管理 AgentParty/Codex 桥接行和 daemon 快速模式。
- 重度 Claude Code 用户想一眼看到 5h/7d 限额余量和重置倒计时,不想切窗口查用量。
- 使用第三方中转 API(ANTHROPIC_BASE_URL 非官方)的用户,官方配额不存在,需要上下文窗口电池条代替。
- 想按氛围换主题但记不住主题名的用户:说"想要柔和温暖的深色",Claude 建议 twilight 并确认后切换。
- 某个颜色不满意但不想换整个主题:直接覆盖 color_warn 等严重度颜色。
- 状态栏突然不显示或刷新太耗 CPU:cs doctor 自检,或在 refreshInterval ≤ 2s 时被建议开 daemon 快速模式(CPU 从约 6% 降到 2%)。
- 同时用 AgentParty/Codex 的用户,想在状态栏看到通道、未读数等本地工作区状态。
这个 Skill 有哪些优点和局限?
- 覆盖 cs 全部配置面的单一入口,替代 6 个旧斜杠命令,对话式意图即可操作。
- 明确的安全护栏:禁止手改配置文件、禁止猜测升级命令、破坏性操作需确认。
- 对无配额(中转/Bedrock/Vertex)场景有专门布局和自动检测逻辑。
- doctor 诊断流覆盖最常见的四类故障,且附带"主题改了没生效是会话缓存"这类真实坑的解答。
- 强依赖 cs 二进制已正确安装并配置 statusLine,技能本身不安装任何东西。
- 部分功能是实验性的(bar_shimmer 星空动画)或默认关闭(子代理显示、工具汇总)。
- macOS 旧 onefile 版本存在 _MEI* 临时目录泄漏问题,需升级到 v3.32.5+。
- per-model 周限额功能依赖 Anthropic 未公开的用量端点和 OAuth 凭据读取,默认关闭且有隐私敏感面。
如何安装这个 Skill?
先安装底层工具:一行安装脚本 curl -fsSL https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/install.sh | bash(预编译二进制,无需 Python),或 pip install claude-statusbar 后运行 cs --setup——它会写入 statusLine 钩子并自动安装本技能。重启 Claude Code 生效。技能文件位于仓库 skills/claude-statusbar/。仅手动安装技能本身(不含 cs 二进制)的具体步骤文档未详述,参考 docs/install.md 的 skill-only 路径。
如何使用这个 Skill?
安装后用自然语言触发,例如:"把主题换成 nord""缓存倒计时关掉""状态栏不显示了""余量颜色调亮一点""升级到最新版"。技能的决策树会匹配到对应 cs 命令执行并给一行确认。注意:升级只能用 cs upgrade,不要让 Claude 跑 pip install -U;重置配置、停止 daemon 等破坏性操作会先和你确认。
这个 Skill 与同类方案有什么区别?
README 将其定位为嵌入式状态栏,与独立 TUI 工具 ccusage(长期用量分析、费用分解)和 Claude Code Usage Monitor(燃耗率预测)互补:cs 追求一行内一秒一决策,后者适合想要图表和聚合面板、在侧边终端常驻运行的用户,两者可共存。