Skip to content

v1.12.0 — Conditional visibility, colors, themes and Powerline

Choose a tag to compare

View all tags
@fbincon fbincon released this 10 Oct 14:48
v1.12.0
ee28dec
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v1.12.0 — Conditional visibility, item colors, themes and Powerline

Choose when an item appears and how it is colored through either editor or the CLI. Defaults retain the existing statusline appearance. Both main and subagent rows support per-item foreground/background overrides and optional Powerline blocks.

Installation and compatibility

pipx install --force fbincon-claude-code-statusline==1.12.0
claude-statusline install
claude-statusline doctor

Linux/WSL, Windows 10/11 and macOS 14+ retain Python 3.10–3.14 support. Display schema 7 and editor protocol 9 require matching package/Mod resources. Portable format v1, interface preferences v1 and runtime protocol v2 remain independent. Reading, previewing and install --dry-run leave v1–v6 display files unchanged; actual configuration saves or installation back up the original bytes before migration. Installation rejects invalid/future display files even with --force; uninstall remains available for recovery. Existing languages, item selections and explicit editor/collector opt-outs remain supported.

Before a downgrade, use the newer package to remove its native editor when necessary, and restore a compatible pre-migration display backup. Changing only the schema number cannot preserve these new fields. See appearance and recovery.

Display changes

  • Hide confirmed clean Git, confirmed zero active agents or empty task lists. A completed nonempty checklist stays visible. Unknown, stale and partial observations retain existing behavior; conditions reuse shared collectors.
  • Show context and allowance items only when raw used percentage reaches an optional integer threshold. Visibility thresholds are separate from warning/critical color thresholds and do not depend on rounded or translated display text.
  • Choose classic, dark, light or terminal themes. Item colors accept inheritance, terminal defaults, ANSI 0–255 and RGB. Theme changes retain item overrides; enabled risk foregrounds take precedence while preserving backgrounds.
  • Enable Powerline separately, with ASCII > by default and an optional font-dependent arrow. Padding and boundaries participate in grapheme-safe fitting; hidden items leave no empty separators/rows and each row resets style.
  • Edit, preview, cancel, review imports, export and save the complete configuration in both editors. Claude host themes and native preview backgrounds remain separate choices.

The existing macOS Client focus/input limitation remains documented in the user guide. Physical fonts and terminal palettes can differ; no fonts are installed. Normal rendering remains local and model-free.

Validation

  • Local checks: 781 Python tests (773 passed, eight platform skips), 96 native and ten runtime Mod tests, both TypeScript checks, strict validators, generated resources, Ruff and bilingual documentation checks passed. GitHub CI covers Linux, Windows and macOS with Python 3.10–3.14 and fixed Claude hosts; all final head, merge and tag jobs are required before publication.
  • The immutable installed candidate d7d7c37d30ae0f2e158735806917cba261b41dda passed independent wheel rebuilding, isolated wheel/sdist installation and core/native/runtime smoke. Real v1.11.0 wheel upgrades passed with default-enabled and explicit-opt-out preferences, read-only access, backed-up migration, compatible backup restoration, a real downgrade and reupgrade.
  • Installed appearance workflows passed 20 external cases (five sizes × two languages × two backgrounds), eight native cases (two sizes × two languages × two backgrounds) and six rendering PTYs. Actual dark/light terminal reconstructions were inspected, including the independent light native preview background. These are automated and agent image checks; no new human Windows/macOS terminal acceptance or paid model calls are claimed.
  • Fixed-source performance used 39,000 primary samples, 6,900 selected controls and 8,000 appearance samples. A small repeatable default cost remains: roughly 0.12–0.18 ms for 32-agent warm refresh and about 6 ms for controlled cold import, including environmental variation. See the complete performance report for controls, limitations and opt-in costs. Raw receipts remain in ignored dist/validation/v1.12.
简体中文

条件显示、逐项颜色、主题与 Powerline

通过两个编辑器或 CLI 控制显示项何时出现以及如何配色，默认保留既有外观。主／子代理行都支持逐项前景／背景色和按需开启的 Powerline。

pipx install --force fbincon-claude-code-statusline==1.12.0
claude-statusline install
claude-statusline doctor

继续支持 Linux／WSL、Windows 10/11、macOS 14+ 与 Python 3.10–3.14。显示 schema 7、编辑器协议 9 要求软件包与 Mod 资源匹配；portable v1、界面偏好 v1、runtime v2 独立。读取 v1–v6、预览和 install --dry-run 不写入，实际配置保存或安装时先备份再迁移；未来或非法显示配置即使使用 --force 也会被安装器拒绝，仍可卸载以便恢复。保留语言、项目选择及显式编辑器／采集退出设置。降级时用新版软件先移除需要清理的原生编辑器，恢复迁移前的兼容显示备份；不要只修改 schema 数字。详见外观与恢复。

  • 仅依据完整有效观测隐藏干净 Git、零活动代理和空任务列表；非空但全部完成的列表仍显示，未知／过期／部分数据沿用原有表现。
  • 上下文与额度按原始已用比例判断显示阈值，独立于警告／危险颜色阈值，不受四舍五入或翻译影响。
  • 提供经典、深色、浅色、终端四类主题，支持继承／终端默认／ANSI／RGB 逐项颜色。切换主题保留逐项覆盖，启用的告警前景优先并保留背景。
  • Powerline 默认关闭，启用后默认 ASCII，可选需要字体支持的箭头；内边距、分隔符及完整字素计入宽度，每行复位，隐藏后不残留分隔符或空行。
  • 两端共用完整草稿、预览、取消、导入审阅、导出与保存。Claude 宿主主题和原生预览背景保持独立。

保留已有 macOS Client 焦点／输入限制，实际字体和终端调色板可能影响外观。不会安装字体，普通渲染保持本地执行且不消耗模型 token。

  • 本地 781 项 Python 测试中 773 项通过、8 项平台跳过；96 项原生与 10 项 runtime Mod 测试、两端 TypeScript、严格验证器、生成资源、Ruff 和双语文档检查通过。GitHub CI 覆盖 Linux／Windows／macOS、Python 3.10–3.14 与固定 Claude 宿主；正式发布前要求最终 head、合并与标签的完整检查通过。
  • 固定安装包候选 d7d7c37d30ae0f2e158735806917cba261b41dda 通过独立 wheel 重建、wheel／sdist 隔离安装和 core／native／runtime smoke。真实 v1.11.0 wheel 的默认启用及显式退出两种升级场景均通过，覆盖只读访问、备份迁移、兼容备份恢复、实际降级与再次升级。
  • 安装包通过 20 组外部编辑器（五尺寸 × 两语言 × 两背景）、8 组原生编辑器（两尺寸 × 两语言 × 两背景）和 6 组渲染 PTY。实际深浅终端图像已检查，原生浅色预览背景单独确认。这些属于自动检查与 agent 图像检查，不代表新增 Windows／macOS 真人终端验收；未进行付费模型调用。
  • 固定源码性能验证包含 39,000 个完整对照样本、6,900 个选中控制样本和 8,000 个外观样本。保留小幅可重复默认开销：32 代理热刷新约增加 0.12–0.18 ms，控制组冷导入约增加 6 ms，其中包含环境变化。控制方法、局限和按需功能开销见完整性能报告。原始凭据保存在忽略的 dist/validation/v1.12。

Fixed release provenance / 固定发布来源

Release commit / 发布提交: ee28dec10a07a1f175d11895f0afe7fb56e8752b. Feature PR #70, release PR #71. Final PR head passed 46 checks; the merge passed all 23 checks. / 最终 PR head 通过 46 项检查，合并提交通过全部 23 项检查。

The exact merge produced 202 wheel entries and 677 sdist entries. Independent rebuilding matches every wheel member; wheel/sdist isolation and final wheel CLI smoke pass. All wheel member bytes match the installed appearance/upgrade candidate. / 精确合并提交构建的 wheel 含 202 项、sdist 含 677 项；独立重建逐项内容一致，wheel／sdist 隔离安装及最终 wheel CLI smoke 通过，wheel 全部文件内容与已验收候选一致。

Publication gates / 发布验证

The tag passed all 23 jobs: Python/build CI and fixed-host Mods. TestPyPI passed all nine jobs, including six cross-platform index installs; both downloaded distributions match the original Release assets. / 标签全部 23 项检查通过；TestPyPI 全部九项任务通过，含六组跨平台索引安装，两个下载发行包与原始 Release 资产一致。

Formal PyPI publishing passed all nine jobs. Anonymous GitHub and PyPI package downloads match the original bytes/SHA256; independent pipx installs from PyPI and the fixed Git tag pass CLI smoke. / 正式 PyPI 发布全部九项任务通过；GitHub／PyPI 公开下载与原始字节和 SHA256 一致，从 PyPI 与固定 Git 标签的独立 pipx 安装通过 CLI smoke。

Assets 5
Loading