v3.1.2 — External terminal editor navigation and text repairs

v3.1.2 — External terminal editor navigation and text repairs

English | 简体中文

Repair six external /statusline-configure regressions found by an independent comparison with the fixed Python v2.0.0 source.

• Open sources/requirements for unconfigured picker types without crashing; resolve catalog titles correctly even when custom instance IDs collide with type IDs.
• Edit a new text component's body first, preserving its original Unicode through preview, save and reopen in both scopes.
• Restore Settings/Layout selection and scroll on return, and page grouped forms by visible fields rather than terminal rows.
• Honor monochrome TERM capabilities before truecolor hints and clear a resolved form error without dismissing unrelated notices.
• Add keyboard, style, persistence and installed-PTY regressions. Pure documentation changes receive necessary checks; product/version/approval/workflow changes and releases retain the complete matrix.

Node 22/24, public CLI, protocol 12, display schema 8 and independent preference/save behavior remain compatible. Upgrade with npm install --global --ignore-scripts @fbincon/claude-code-statusline, run claude-statusline install, and restart Claude Code. Exact version: @fbincon/claude-code-statusline@3.1.2. Installation and recovery.

Accepted known gaps: the v3.1.2-only maintainer decision accepts physical macOS sleep, macOS 14 Intel desktop/power, Windows 10 desktop, WSL desktop/popup, remaining target-specific human/power checks and Claude 2.1.296 exact declarations. They remain unverified/unavailable; new functional or automated failures are not waived. D06 stays FAIL; PERF-01 stays NOT_STARTED. Existing beta and Python rollback artifacts remain available.

Implementation and validation. Final public delivery receipts are recorded in the maintained evidence.

简体中文

通过独立对照固定 Python v2.0.0 源码，修复外部 /statusline-configure 的六项回归。

• 未配置类型可打开来源／要求说明，避免崩溃；自定义实例 ID 与类型 ID 重名时，目录标题仍正确。
• 新文字组件首先编辑正文，两个作用域均保留原始 Unicode，并正确进入预览、保存及重开。
• Settings／Layout 返回时恢复选中字段与滚动，分组表单按可见字段翻页。
• 单色 TERM 优先于真彩提示，修正值后清除对应表单错误，无关通知保持原有行为。
• 增加按键、样式、持久化和安装包 PTY 回归。纯文档变更运行必要检查；产品／版本／批准／工作流变更和发布保留完整矩阵。

Node 22／24、公共 CLI、协议 12、显示 schema 8 及独立偏好／保存行为保持兼容。升级执行 npm install --global --ignore-scripts @fbincon/claude-code-statusline，然后运行 claude-statusline install 并重启 Claude Code；固定版本为 @fbincon/claude-code-statusline@3.1.2。安装与恢复。

接受的已知缺口： v3.1.2 专属维护者决定接受 macOS 实机睡眠、macOS 14 Intel 桌面／电源、Windows 10 桌面、WSL 桌面／弹窗、其他目标人工／电源检查、Claude 2.1.296 精确声明。未验证／不可用状态保留，不豁免新增功能或自动化失败。D06 保持 FAIL，PERF-01 保持 NOT_STARTED，已有 beta 和 Python 回退产物保留。

实现与验收。最终公开交付回执记录在持续维护的证据。

v3.1.1 — External terminal editor rendering and contextual controls

v3.1.1 — External terminal editor rendering and contextual controls

English | 简体中文

The external /statusline-configure editor retains six languages, cyan headings and full-row selection while restoring clear field names, search details and state-specific controls.

• Complete group separators share one cyan/bold style. Terminal-default borders and backgrounds, highlighted keys and notices, and basic-color preview intensity remain readable in light and dark profiles.
• Fix double ellipses, duplicated Enter labels, inherited-value localization and English preview plurals. Literal labels, icons, text and Git references keep their spelling.
• Restore Enter/Ctrl+S saving hints, add/copy/remove discovery, category navigation, numeric editing hints, format scope/back controls and match snippets. Filtered lists omit ordering hints.
• Changed configuration text shows the pending-edit marker before confirmation; opening an edit or entering a portable-file path alone does not. Small windows retain the title, wrapped dimensions and exit controls.
• Drawing responsibilities and product regressions are separated. Public CLI, editor protocol 12, display schema 8 and persisted configuration formats remain compatible. Node 22/24 and the existing supported targets remain unchanged.

Upgrade with npm install --global --ignore-scripts @fbincon/claude-code-statusline, then run claude-statusline install and restart Claude Code so installed resources match. The fixed package is @fbincon/claude-code-statusline@3.1.1. Installation and recovery.

Accepted known gaps: this version has its own maintainer decision accepting and disclosing the same six existing gaps: physical macOS sleep, macOS 14 Intel desktop/power, Windows 10 desktop, WSL desktop/popup, remaining target-specific human/power checks and Claude 2.1.296 exact declarations. They remain unverified; new functional or automated failures are not waived. Version-specific approval · Validation and delivery.

D06 remains FAIL; PERF-01 remains separate and NOT_STARTED. This patch makes no performance claim. Existing beta and Python rollback artifacts are retained.

Published through npm latest, GitHub stable/Latest and Gitee stable; all six public installation jobs passed. Completed delivery evidence · Machine-readable receipts · Six-language installed gallery.

简体中文

外部 /statusline-configure 编辑器保留六语言、青色标题和整行选中，恢复清晰字段名称、搜索详情与按状态匹配的操作提示。

• 完整分组横线统一青色加粗；边框与背景保留终端默认值，快捷键和通知保持加粗，基础色阶的预览亮色保留强度，兼容明暗终端。
• 修复双省略号、重复 Enter、继承值本地化及英文预览复数；用户标签、图标、文字和 Git 引用保持原样。
• 恢复 Enter/Ctrl+S 保存提示、添加／复制／移除入口、分类导航、数字输入、格式作用域／返回提示与搜索匹配片段；筛选时隐藏排序提示。
• 配置文本实际改变后，在确认前即显示修改标记；仅打开编辑或填写导入／导出路径不标记配置改动。小窗口保留标题、换行尺寸信息和退出操作。
• 拆分绘制职责及产品回归测试。公共 CLI、编辑器协议 12、显示 schema 8 和持久配置格式保持兼容；Node 22／24 及现有支持目标保持不变。

升级使用 npm install --global --ignore-scripts @fbincon/claude-code-statusline，随后执行 claude-statusline install 并重启 Claude Code，确保安装资源配套；固定版本为 @fbincon/claude-code-statusline@3.1.1。安装与恢复。

接受的已知缺口： 本版单独记录维护者批准，接受并披露相同六项既有缺口：macOS 实机睡眠、macOS 14 Intel 桌面／电源、Windows 10 桌面、WSL 桌面／弹窗、其他目标人工／电源验收及 Claude 2.1.296 精确声明。未验证状态保留，不豁免新增功能或自动化失败。本版批准 · 验收与交付。

D06 保持 FAIL，PERF-01 独立且为 NOT_STARTED；本版不宣称性能提升，保留已有 beta 和 Python 回退产物。

已发布 npm latest、GitHub stable／Latest 和 Gitee stable，六项公开安装作业全部通过。完整交付证据 · 机器可读回执 · 六语言安装包图库。

v3.1.0 — Node LTS compatibility and regional Traditional Chinese

v3.1.0 — Node LTS compatibility and regional Traditional Chinese

English | 简体中文

The statusline supports stable Node 22 and 24 (^22.0.0 || ^24.0.0). Reproducible builds keep their fixed Node 24.21.0/npm 11.19.0 toolchain. One offline npm package includes the existing Linux/WSL x64, Windows x64 and macOS Intel/Apple Silicon native dependencies.

• Traditional Chinese now offers 繁體中文（台灣） (zh-TW) and 繁體中文（香港） (zh-HK) throughout CLI, both editors, search, previews and production output. Interface and output choices remain independent.
• Existing zh-Hant arguments and configuration resolve to Taiwan. Reads leave files untouched; explicit saves and exports use zh-TW, retaining backup and transaction protection.
• Editor protocol 12 requires matching resources. After upgrading, run claude-statusline install and restart Claude Code. Display schema 8, UI preferences 1, portable envelope 1 and runtime protocol 2 retain their formats. Before downgrading, reset both languages to English with the newer package or restore a compatible backup.
• Install with npm install --global --ignore-scripts @fbincon/claude-code-statusline, then run claude-statusline install --dry-run, claude-statusline install and claude-statusline doctor. A fixed install uses @3.1.0. Installation and recovery.
• Delivery includes the npm tgz, rebuildable source tar.gz, build-manifest.json and SHA256SUMS. CI requires the original eight targets/thirteen hosts plus 32 source/package-bound Node compatibility cases. Public-download checks cover latest 22.x and 24.x on Linux, Windows and macOS.

Accepted known gaps: the maintainer explicitly accepted the six existing gaps for this version: physical macOS sleep, macOS 14 Intel desktop/power, Windows 10 desktop, WSL desktop/popup, remaining target-specific human/power checks and Claude 2.1.296 exact declarations. They remain unverified; new functional or automated failures are not waived. Approval · Validation and delivery evidence.

D06 remains FAIL; PERF-01 remains separate. This release makes no performance-improvement claim. Existing beta and Python rollback artifacts are retained.

简体中文

状态栏支持稳定版 Node 22 和 24（^22.0.0 || ^24.0.0），可复现构建继续固定 Node 24.21.0/npm 11.19.0。通用离线 npm 包包含现有 Linux/WSL x64、Windows x64 和 macOS Intel／Apple Silicon 原生依赖。

• CLI、两个编辑器、搜索、预览和实际输出支持 繁體中文（台灣） zh-TW 与 繁體中文（香港） zh-HK，界面与输出选择独立。
• 旧 zh-Hant 参数及配置映射到台湾；读取不改写文件，显式保存和导出使用 zh-TW，保留备份及事务保护。
• 编辑器协议 12 需要配套资源。升级后执行 claude-statusline install 并重启 Claude Code。显示 schema 8、界面偏好 1、portable 1 和 runtime 协议 2 保留格式；降级前用新包将两种语言设为英文，或恢复兼容备份。
• 通过 npm install --global --ignore-scripts @fbincon/claude-code-statusline 安装，随后执行安装 dry-run、安装及 doctor；固定版本使用 @3.1.0。安装与恢复。
• 四附件为 npm tgz、可重建源码 tar.gz、构建清单及 SHA256SUMS。CI 要求原八目标／十三宿主及新增 32 项绑定源码与包的 Node 案例；公开下载安装覆盖 Linux、Windows、macOS 的最新 22.x 和 24.x。

接受的已知缺口： 维护者已明确接受本版本的六项既有缺口：macOS 实机睡眠、macOS 14 Intel 桌面／电源、Windows 10 桌面、WSL 桌面／弹窗、其他目标人工／电源覆盖及 Claude 2.1.296 精确声明。未验证状态保留，不豁免新增功能或自动化失败。批准记录 · 验证与交付证据。

D06 保持 FAIL，PERF-01 独立处理；本次不宣称性能提升，保留既有 beta 和 Python 回退发布物。

Verified delivery / 已核验交付

Delivery evidence · 中文交付证据 · Taiwan/Hong Kong gallery / 台湾及香港图库 · 中文图库

Release source / 发布源码: 10de45895d2734a8ab1eacec09b57bc89417be51; evidence merge / 证据合并: f4d3961da6bbf311a74caec1dbceadcf9ad76083 (PR #103). The annotated v3.1.0 tag and four published delivery files retain their original bytes. / 注释标签与四个发布附件保持原始字节。

Implementation PR CI, release merge CI, tag CI, evidence PR CI and evidence merge CI: 55/55 each. Each full matrix contains eight installations, thirteen hosts and 32 Node cases. / 上述五轮 CI 均 55/55 通过，每轮包含八目标安装、十三宿主及 32 项 Node 案例。

Fresh latest-Node public downloads: 6/6 passed, Node 22.23.3 and 24.22.0 on Linux, Windows and macOS; both exact-version and latest installations pass. Receipts bind the immutable release source/package and verifier 7f4768fcd3443514fb54adf24f75e11232e1ed28. / 强制解析最新 Node 后，三系统六项公开下载安装全部通过；回执绑定不可变发布源码、安装包及验证器提交。

All 654 remaining packaged files, including the program, resources and native dependencies, are identical between the refreshed 32-case CI package and the release; only candidate.json source/provenance metadata differs. The public-download checks use the original released tgz. / 新兼容矩阵包除 candidate.json 来源元数据外，其余 654 个已打包文件（含程序、资源及原生依赖）与发布包完全一致；公开下载检查使用原始发布 tgz。

npm latest=3.1.0, beta=3.0.0-beta.1; matching GitHub/Gitee four-file downloads and Gitee's ten isolated offline checks passed. The OIDC run retains the accepted first upload and the successful existing-version verification after npm processing completed. The six accepted historical gaps remain unverified. / 三渠道版本、摘要及离线检查已核验；npm 首次上传后的处理延迟及重跑分别保留证据，六项历史缺口继续标为未验证。

v3.0.0 — TypeScript stable release

v3.0.0 — TypeScript stable release

English | 简体中文

The statusline now ships as the stable TypeScript npm package, with the existing configuration, component composition, CLI and both editors. Normal installation and use require Node instead of Python.

• Requires Node 24.21.0; the verified toolchain uses npm 11.19.0. One offline npm package bundles Linux/WSL x64, Windows x64 and macOS Intel/Apple Silicon dependencies. Windows ARM uses x64 Node emulation; native Windows ARM64 and 32-bit runtimes are outside the support contract.
• Fresh installs default native timing and advanced live collection off. Saved preferences and explicit installation flags retain precedence. Use install --native-timing for timing sampling or install --live-metrics for complete observations. Basic hook/transcript task timing remains available; both compatible editors still default on.
• External TUI pages restore complete frames, grouped separators, aligned columns, full-width selections, terminal cyan headings and bold shortcut keys. Existing edit/save/cancel behavior, Unicode width handling and production preview colors are preserved.
• Install: npm install --global --ignore-scripts @fbincon/claude-code-statusline, then claude-statusline install --dry-run, claude-statusline install and claude-statusline doctor. Restart Claude Code. Use @3.0.0 for a fixed version; Windows uses .cmd/.ps1 wrappers or an explicit Node/JavaScript entry. Installation, Python transition and rollback.
• Four assets: fbincon-claude-code-statusline-3.0.0.tgz, claude-code-statusline-3.0.0-source.tar.gz, build-manifest.json, SHA256SUMS. Check hashes before installing the local tgz with --offline --ignore-scripts. Source and package manifests identify the immutable source; automatic repository ZIPs are not the rebuildable source attachment.

Display schema 8, editor protocol 11, runtime protocol 2 with v1 compatibility, task schema 4 and independent preferences remain compatible. Reads do not rewrite old configuration; real saves retain backups. Preserve the Python v2.0.0 environment and compatible pre-cutover backup when rollback is needed. No PyPI upload occurs; the published beta and its artifacts remain intact.

Accepted known gaps: on 2026-10-18 the maintainer approved v3.0.0 publication while retaining unverified physical macOS sleep/resume, macOS 14 Intel desktop/power, Windows 10 desktop, WSL desktop/popup and remaining target-specific human/power checks. Claude 2.1.296 exact declarations remain unavailable; official Mod tests and available exact-host checks are separate evidence. The macOS Client may require clicking its region before typing. This version-limited decision does not mark missing checks passed or waive failed functional/automated checks. Decision and approval record.

D06 remains FAIL: 104 pass / 60 fail / 28 inconclusive. PERF-01 is a separate follow-up; this release makes no performance improvement claim. Delivery evidence records actual CI, source/package identity and public-channel checks; tracker #96 retains the distinction between verified results and accepted gaps.

简体中文

状态栏现通过 TypeScript npm 包正式分发，保留已有配置、组件组合、CLI 和两种编辑器；正常安装及运行使用 Node，无需 Python。

• 需要 Node 24.21.0，验证工具链使用 npm 11.19.0。通用离线 npm 包包含 Linux/WSL x64、Windows x64 和 macOS Intel/Apple Silicon 原生依赖。Windows ARM 使用模拟 x64 Node；不提供原生 Windows ARM64 或 32 位运行时。
• 新安装默认关闭原生计时和高级实时采集，保留已保存偏好与显式安装参数优先级。install --native-timing 启用计时采样，install --live-metrics 启用完整观测。基础 hook/transcript 任务计时继续可用；兼容宿主的双编辑器仍默认启用。
• 外部 TUI 恢复完整边框、分组横线、列对齐、整行选中、终端青色标题及加粗快捷键；保留编辑、保存、取消、Unicode 宽度和生产预览配色。
• 安装：npm install --global --ignore-scripts @fbincon/claude-code-statusline，再执行 claude-statusline install --dry-run、claude-statusline install、claude-statusline doctor，随后重启 Claude Code。固定版本用 @3.0.0；Windows 使用 .cmd/.ps1 或明确的 Node/JavaScript 入口。安装、Python 迁移及回退。
• 四附件为 npm tgz、可重建源码 tar.gz、build-manifest.json、SHA256SUMS。先核对摘要，再以 --offline --ignore-scripts 安装本地 tgz。源码及包清单记录不可变源码身份；仓库自动 ZIP 不是可重建源码附件。

显示 schema 8、编辑器协议 11、runtime 协议 2/v1、任务 schema 4 及独立偏好保持兼容。读取不重写旧配置，真实保存保留备份。需要回退时保留 Python v2.0.0 环境及切换前兼容备份。不上传 PyPI，既有 beta 及其附件保留。

接受的已知缺项： 维护者于 2026-10-18 批准发布 v3.0.0，同时保留 macOS 实机休眠恢复、macOS 14 Intel 桌面/电源、Windows 10 桌面、WSL 桌面/弹窗及其他目标人工/电源覆盖的未验证状态。Claude 2.1.296 精确声明仍不可用，官方 Mod 测试与可用宿主类型检查分别记录。macOS Client 可能需先点击区域再输入。该批准仅适用于本版本，不把缺项标为通过，也不豁免功能或自动化失败。决定与批准记录。

D06 保持 FAIL：104 pass / 60 fail / 28 inconclusive，PERF-01 后续独立处理，本次不宣称性能提升。交付证据记录实际 CI、源码/包身份及公开渠道检查；跟踪 #96继续区分验证结果与接受的缺项。

v3.0.0-beta.1 — TypeScript preview

v3.0.0-beta.1 — TypeScript preview

English | 简体中文

The first public TypeScript preview moves normal runtime, installation, build and tests to Node. It is a new major distribution: npm replaces Python/pipx for the preview, while Python v2.0.0 remains the stable and rollback release.

• Requires Node 24.21.0; validated tooling uses npm 11.19.0. One offline package bundles Linux x64, Windows x64, macOS x64/ARM64 native dependencies. Windows ARM uses x64 Node emulation.
• Both compatible editors default on, respecting saved disablement; advanced live metrics stay opt-in. Configuration and protocol formats remain compatible.
• Isolated prefix/configuration installation, ownership-aware upgrades, explicit recovery and Python rollback are documented in the preview guide.
• npm: npm install --prefix <preview-prefix> --ignore-scripts @fbincon/claude-code-statusline@beta; use @3.0.0-beta.1 for a fixed version. Review the guide before switching an existing Claude configuration. No installation lifecycle script is needed. Always specify @beta or the fixed version: npm has no stable product release yet; latest resolves to the registry placeholder.
• Assets: fbincon-claude-code-statusline-3.0.0-beta.1.tgz, claude-code-statusline-3.0.0-beta.1-source.tar.gz, build-manifest.json, SHA256SUMS. Verify hashes before installing a local tgz with --offline --ignore-scripts.

Still unverified: physical macOS sleep/resume, macOS 14 Intel desktop/power, Windows 10 desktop, WSL desktop/popup and remaining target-specific human/power coverage. These remain stable-release gates. CI, PTY and screenshots do not satisfy those checks. The macOS Client may need a click to focus. Claude 2.1.296 declarations remain unavailable; official Mod tests and 2.1.294 type checks are separate evidence.

D06 remains FAIL: 104 pass / 60 fail / 28 inconclusive. PERF-01 follows migration; this release makes no performance improvement claim. Functional failures still block acceptance. The full source commit and package digests are in the delivered manifest; CI, TS-06 evidence and validation tracker #96 distinguish completed checks from gaps.

Use the feedback form with exact versions, environment, reproduction and sanitized evidence. This preview does not close TS-06 or replace the latest stable release.

简体中文

首个公开 TypeScript 预览版将正常运行、安装、构建和测试迁移至 Node。本次采用新的主版本分发：预览版使用 npm，Python v2.0.0 保持稳定版与回退版本。

• 需要 Node 24.21.0，验证工具链为 npm 11.19.0。一个离线包包含 Linux x64、Windows x64、macOS x64/ARM64 原生依赖；Windows ARM 使用模拟 x64 Node。
• 兼容宿主双编辑器默认开启，保留已保存的停用设置，高级 live metrics 仍显式启用。配置及协议格式保持兼容。
• 试用指南提供隔离安装、所有权检查、显式恢复和 Python 回退步骤。
• npm 使用 npm install --prefix <preview-prefix> --ignore-scripts @fbincon/claude-code-statusline@beta，固定复现用 @3.0.0-beta.1。切换已有 Claude 配置前先阅读指南。无需安装生命周期脚本。必须明确指定 @beta 或固定版本：npm 暂无稳定产品版本，latest 只指向 registry 占位包。
• 四项附件为安装 tgz、可重建源码 tar.gz、build-manifest.json 和 SHA256SUMS；校验后用 --offline --ignore-scripts 安装本地包。

仍未验证： macOS 实机休眠恢复、macOS 14 Intel 桌面/电源、Windows 10 桌面、WSL 桌面/弹窗及其他目标人工/电源覆盖。这些仍是正式版门槛，CI、PTY 和截图不能替代。macOS Client 可能需要点击聚焦；Claude 2.1.296 声明仍不可用，官方 Mod 测试与 2.1.294 类型检查分别记录。

D06 保持 FAIL：104 pass / 60 fail / 28 inconclusive，PERF-01 后续处理，本次不宣称性能提升。功能失败仍阻塞验收。完整源码 SHA 和包摘要见附件清单；CI、TS-06 证据及验收跟踪 #96区分已完成与待验证项。

请通过反馈表单提供版本、环境、复现与脱敏证据。本预览不关闭 TS-06，也不替代最新稳定版。

Release identity / 发布身份

• Source / 源码: a6cfb6aadf2fcacbd5bf8f027665528cf6b6f29f.
• npm tarball SHA-256: 3c2f350c976b669894b7a86aba2383c04489e5b1e2215631a5d74f23540aecb7.
• PR CI: 23 successful jobs.
• Merge CI: 23 successful jobs.
• Tag CI: 23 successful jobs.
• Eight installed targets and thirteen fixed hosts bind the same artifact. Physical/desktop gaps remain listed above. / 八安装目标与十三固定宿主绑定同一安装包，实体/桌面缺口仍如上所列。

Public acceptance / 公开验收

• Linux, Windows and macOS public npm installations: 3/3 passed; both fixed-version and beta selectors use the same verified tarball. / 三系统固定版本与 beta 安装均通过，绑定同一已验证安装包。
• All four public GitHub and Gitee delivery attachments match byte for byte; npm contains the identical tgz. / GitHub 与 Gitee 的四项公开交付附件逐字节一致，npm 分发同一 tgz。
• Publication receipts and remaining stable gates · 发布证据与剩余正式版门槛.
• Verification correction and evidence PR #98 records the separate verifier source; published package bytes and the version tag are unchanged. / 验证修正与证据 PR 单独记录验证代码来源，已发布包字节和版本标签不变。

v2.0.0 — Component composition

Component composition

Build a status line from independent component instances. Repeat a metric with different labels, icons, formats, colors, visibility, priority and width; add literal text and a flexible spacer to align an explicit main row or the subagent template. Existing default display content remains unchanged. The Left and right and Repeated metrics presets provide editable examples.

Both editors show configured instances, including disabled entries. Native A/D/X and external Ctrl+A/Ctrl+D/Ctrl+X add, copy and remove instances. The searchable type picker, instance forms, ordering, preview and import review share the same configuration model. The CLI provides scoped config instance operations and config layout --by-instance; legacy type commands reject ambiguous matches. See the composition guide and CLI reference.

pipx install --force fbincon-claude-code-statusline==2.0.0
claude-statusline install --dry-run
claude-statusline install
claude-statusline doctor

Restart Claude Code after updating its integration. Stable installation requests both supported editor entries by default and retains explicit disablement. Interface language, output language, collectors and Claude preferences remain independent. Upgrading the Python package alone does not update installed editor resources.

Compatibility and recovery

Display schema 8 and editor protocol 11 require matching Python and bundled resources. Display v1–v7 files migrate deterministically in memory, preserving enabled order, disabled overrides, layout and language. Reads, previews, import review and dry runs do not rewrite display files. Actual saves and installation back up before migration and retain revision checks and transaction rollback.

Portable envelopes remain v1, UI preferences v1 and runtime observations v2. Before downgrading, remove incompatible native integration with the current package and restore a compatible pre-migration backup before installing the older package. Repeated instances and flexible layouts cannot be converted losslessly by changing the schema number. See upgrade and recovery.

Linux/WSL, Windows 10/11, macOS 14+ and Python 3.10–3.14 remain supported. External entry needs Claude Code 2.1.258+ and Client needs 2.1.287+; incompatible entries suspend independently. Repeated metrics share raw observations within a frame and format each instance separately. Timer and observation-store semantics remain unchanged.

Validation

The composition candidate completed 815 Python tests (807 passed, eight platform skips), 112 native Mod tests and ten runtime Mod tests. Installed-wheel validation covered ten bilingual external PTY cases at five sizes, four bilingual native composition cases at two widths, native/external discovery and import review, six grapheme/style cases and released v1.13.0 migration, compatible-backup downgrade and re-upgrade. Independently rebuilt wheels retained 217 identical internal files. Capture provenance records the tested sources and terminal reconstruction limits.

Performance measurements retain 39,000 baseline comparison samples and 10,000 opt-in composition samples. Instance validation and retained disabled placements add work; measured costs and screening flags remain in the report. This release does not claim zero default-path overhead. Stable promotion changes release metadata, documentation and version-dependent installation defaults; the measured rendering and collection code is retained.

The release process requires all 13 Python/build and 13 Mod jobs on the reviewed PR, merge commit and tag, independent package rebuilding, installed smoke and preview-to-stable upgrade checks. The same fixed artifacts pass nine TestPyPI and nine PyPI publishing/installation jobs before synchronization to Gitee. The preview remains available with its original assets.

Ten fixed-host Mod jobs retain exact-build TypeScript checks. The three Claude Code 2.1.296 jobs cover runtime tests, strict validation and installation; the current host preparation flow does not emit its declarations, so these are not exact-build 2.1.296 type checks. Automated captures and agent inspection do not establish new human Windows/macOS acceptance. The historical macOS Client focus/input limitation remains. No paid model calls were needed for composition or stable promotion.

简体中文

组件组合

用独立组件实例组织状态栏：同一指标可重复显示，各自设置标签、图标、格式、颜色、显示条件、优先级和宽度；加入原样文字及弹性留白，实现显式主栏行或子代理模板的左右对齐。现有默认显示内容不变，新增“左右布局”和“重复指标”预设作为可编辑示例。

两种编辑器显示已配置实例（含禁用项）。原生 A/D/X、外部 Ctrl+A/Ctrl+D/Ctrl+X 分别新增、复制和移除；可搜索类型目录、实例表单、排序、预览和导入审阅使用同一配置模型。CLI 提供分作用域的 config instance 和 config layout --by-instance；旧类型命令遇到歧义时明确拒绝。详见组件指南及 CLI 文档。

pipx install --force fbincon-claude-code-statusline==2.0.0
claude-statusline install --dry-run
claude-statusline install
claude-statusline doctor

更新接入后重启 Claude Code。正式版默认请求两个受支持的编辑入口，保留明确关闭偏好；界面／输出语言、采集器和 Claude 偏好继续独立。仅升级 Python 软件包不会更新已安装的编辑器资源。

显示 schema 8／编辑器协议 11 要求匹配的 Python 包和资源。历史 v1–v7 确定性映射到内存，保留启用顺序、禁用项覆盖、布局及语言；读取、预览、导入审阅和 dry-run 不改写文件。真实保存或安装先备份再迁移，继续使用 revision 检查与事务回滚。

portable v1、界面偏好 v1、运行观测 v2 保持不变。降级前用当前包移除不兼容原生接入，恢复迁移前兼容备份，再安装旧版；不能通过修改 schema 数字无损回退重复实例和弹性布局。参见升级恢复。

继续支持 Linux/WSL、Windows 10/11、macOS 14+ 及 Python 3.10–3.14。外部入口需要 Claude Code 2.1.258+，Client 需要 2.1.287+，不兼容入口分别暂挂。重复指标共享当前帧原始观测，再分别格式化；计时及观测存储语义不变。

组件候选完成 815 项 Python 测试（807 通过、8 项平台跳过）、112 项原生 Mod 测试和十项 runtime Mod 测试。安装后验证包括十个中英文外部 PTY 案例（五尺寸）、四个中英文原生组合案例（两宽度）、两端发现与导入审阅、六个字素／样式案例，以及真实 v1.13.0 升级、恢复兼容备份后降级和再升级。独立重建 wheel 的 217 个内部文件内容一致。捕获来源记录源码和终端重建限制。

性能报告保留 39,000 个基线对比样本及 10,000 个可选组合样本，记录实例校验和禁用项位置保留带来的开销与复核标记，不宣称默认路径零开销。正式晋升调整发布元数据、文档和随版本变化的安装默认值，保留被测渲染及采集代码。

发布流程要求已审查 PR、合并提交及标签各自通过 13 项 Python／构建和 13 项 Mod 作业，完成独立重建、安装 smoke 及预览到正式版升级；同一批固定发行物通过 TestPyPI／PyPI 各九项发布及安装作业，再同步 Gitee。预览版及原始资产继续保留。

十个固定宿主作业保留精确版本 TypeScript 检查；2.1.296 的三个作业覆盖运行测试、严格校验及安装，当前声明生成流程未产生其类型，因此不宣称通过 2.1.296 精确类型检查。自动捕获和 agent 图像检查不代表新增 Windows／macOS 真人验收；历史 macOS Client 焦点／输入限制继续保留。本次组件开发与正式晋升未使用付费模型调用。

v2.0.0a1 — Component composition preview

Component composition preview

Create multiple instances of the same metric, each with its own label, icon, format, colors, visibility, priority and width. Add literal text and one flexible spacer per explicit main row or subagent template. The existing default display remains unchanged; the new Left and right and Repeated metrics presets provide editable starting points.

Both editors list configured instances, including disabled ones. Native A (external Ctrl+A) opens a searchable type picker, native D (external Ctrl+D) copies and native X (external Ctrl+X) removes. Existing enable, format and ordering controls operate on the selected instance. The CLI adds scoped config instance operations, and import review follows instance identity. Legacy type commands refuse ambiguous matches or compositions they cannot preserve. See the composition guide.

pipx install --force fbincon-claude-code-statusline==2.0.0a1
claude-statusline install --native-editor --experimental-slash-tui
claude-statusline doctor

Restart Claude Code after updating its integration. The preview retains the established explicit editor opt-in policy. Interface language, output language, collectors and Claude preferences remain independent.

Compatibility and recovery

Display schema 8 and editor protocol 11 require matching Python and bundled resources. Supported display v1–v7 files map deterministically in memory, preserving enabled order, disabled overrides, layouts and language. Reads, previews, import review and dry runs do not rewrite display files. Actual saves or installation back up before migration and retain revision checks and transaction rollback.

Portable envelopes remain v1, UI preferences v1 and runtime observations v2. Before downgrading, use the current package to remove incompatible native integration and restore a compatible pre-migration backup before installing the older package. Repeated instances and flexible layouts cannot be converted losslessly by changing the schema number. See upgrade and recovery.

Linux/WSL, Windows 10/11, macOS 14+ and Python 3.10–3.14 remain supported. Grapheme fitting, color fallback and Powerline boundaries use the existing production/sample pipeline. Copies share raw observations without additional transcript scans or Git collection; timing and observation stores keep their existing semantics.

Validation boundaries

Local validation completed 815 Python tests (807 passed, eight platform skips), 112 official native Mod tests and ten runtime Mod tests. Installed wheels passed ten bilingual external PTY cases at five sizes, four bilingual native cases at two widths, six grapheme/style PTY cases, CLI/install smoke and a released-wheel upgrade/downgrade/re-upgrade check. An independent wheel rebuild retained 217 identical internal files. Captured interfaces distinguish terminal reconstruction from human acceptance.

Performance measurements retain 39,000 comparison samples and 10,000 opt-in samples, including measured costs and screening flags. Instance option validation and retained disabled placements add work; the release does not claim zero default-path overhead.

Release gates include the Python suite, official Mod tests and exact-build TypeScript checks, generated-resource parity, wheel/sdist inventories, independent rebuilds, installed bilingual Linux PTYs, migration/recovery and fixed-source cold/warm performance measurements. Final PR, merge and tag must pass 13 Python/build and 13 Mod jobs, followed by nine TestPyPI and nine PyPI publication/installation jobs using the same artifacts.

The earlier ten fixed-host Mod jobs retain exact-build type checks. Claude Code 2.1.296 adds three-platform runtime, strict validation and installation coverage; the current host preparation flow does not emit its declarations, so these are not exact-build 2.1.296 type checks. Automated terminal captures and agent inspection do not establish new human Windows/macOS acceptance. The historical macOS Client focus/input limitation remains. No new paid model calls are required for composition.

简体中文

组件组合预览

同一指标可创建多份实例，分别设置标签、图标、格式、颜色、显示条件、优先级与宽度。支持原样文字和单一弹性留白：主栏需显式分行，子代理模板为单行。现有默认显示不变，新增“左右布局”和“重复指标”两种可编辑预设。

两种编辑器展示已配置实例（含禁用项）。原生 A／外部 Ctrl+A 打开可搜索的类型目录，原生 D／外部 Ctrl+D 复制，原生 X／外部 Ctrl+X 移除；原有启禁用、格式与排序操作作用于选中实例。新增 config instance，导入审阅按实例身份对比；旧类型命令遇到歧义或无法无损保留的组合时明确拒绝。详见组件指南。

pipx install --force fbincon-claude-code-statusline==2.0.0a1
claude-statusline install --native-editor --experimental-slash-tui
claude-statusline doctor

更新接入后重启 Claude Code。预览版沿用编辑器显式启用策略，界面／输出语言、采集器及 Claude 偏好继续独立。

显示 schema 8／编辑器协议 11 要求匹配的 Python 包及原生资源。历史 v1–v7 确定性映射到内存，保留顺序、禁用项覆盖、布局和语言；读取、预览、导入审阅及 dry-run 不改写显示文件。真实保存／安装先备份再迁移，保留 revision 检查与事务回滚。

可移植外层 v1、界面偏好 v1、运行观测 v2 不变。降级前用当前包移除不兼容原生接入，恢复迁移前兼容备份，再安装旧包。重复实例与弹性布局不能通过修改 schema 数字无损回退。参见升级恢复。

继续支持 Linux/WSL、Windows 10/11、macOS 14+ 及 Python 3.10–3.14。重复组件共享原始观测并分别格式化，不增加会话扫描或 Git 采集；计时及运行状态存储语义保持不变。

本地完成 815 项 Python 测试（807 通过、8 项平台跳过）、112 项官方原生 Mod 测试及十项运行 Mod 测试。已安装 wheel 通过十个中英文外部 PTY 案例（五种尺寸）、四个中英文原生案例（两种宽度）、六个字素／样式 PTY 案例、CLI／安装 smoke，以及真实已发布 wheel 的升级／降级／再升级。独立重建的 wheel 包含 217 个内容相同的内部文件。界面捕获区分终端重建与真人验收。

性能报告保留 39,000 个对比样本及 10,000 个可选功能样本，如实列出开销与复核标记。实例选项校验及禁用位置保留增加了工作量，不宣称默认路径零开销。

发布检查包含 Python／官方 Mod 测试、精确宿主类型检查、生成文件一致性、包清单、独立重建、安装后中英文 Linux PTY、迁移恢复和固定源码冷／热基准。最终 PR、合并提交及标签要求 13 个 Python/build、13 个 Mod 作业全通过，再以相同资产通过九个 TestPyPI 和九个 PyPI 发布／安装作业。

原有十个固定宿主保留精确版本类型检查；2.1.296 新增三平台运行、严格校验及安装验证，但当前生成流程不产生该宿主声明，不宣称已通过其精确类型检查。自动终端捕获与代理图像检查不代表新增 Windows／macOS 真人验收；历史 macOS Client 焦点／输入限制继续保留。本次组件功能不需要新增付费模型调用。

v1.13.0 — Five interface and statusline languages

Five interface and statusline languages

Traditional Chinese (zh-Hant), Japanese (ja) and Korean (ko) join English and Simplified Chinese across CLI help/errors, both editors, previews and main/subagent statuslines. General Traditional Chinese is a single shared variant. English remains the default, existing choices are preserved, and language selection is explicit.

pipx install --force fbincon-claude-code-statusline==1.13.0
claude-statusline install
claude-statusline config language set ja
claude-statusline config set statusline-language ja
claude-statusline doctor

Replace ja with en, zh-CN, zh-Hant or ko. Interface language saves immediately; output language belongs to the display draft and follows Save/Cancel. Use --language en for a single CLI invocation without changing the saved interface preference.

Changes

• All five packs contain 1,304 messages, including 220 statusline messages. A single ordered registry generates Python metadata, TypeScript language types, static native resources and individual statusline modules. Coverage, keys, placeholders, duplicates and terminal-safe text are release checks; runtime English fallback remains available.
• Both editors cycle in either direction and retain selection, search and unsaved changes. Failed preference writes retain the previous language. Search includes all five languages' names, descriptions and categories, stable IDs and custom labels, preserving ranking and original-text highlights.
• Python statusline refreshes import only the selected language module, plus English if fallback is needed. They do not scan locale directories or parse interface JSON. Both editors prepare multilingual search fields once and update changed custom labels independently. No new runtime dependency is introduced.
• Commands, configuration keys, paths, model names, units and user text remain unchanged. Complete documentation continues in English and Simplified Chinese; the translation contribution guide documents the source/generated layout and adding another language.

Compatibility

Display schema 7, interface preferences v1, portable v1 and runtime v2 remain unchanged. Editor protocol 10 requires the matching Python package and bundled native resources; old/new editor backends are rejected explicitly. Run claude-statusline install after upgrading to update installed resources. Existing backup and atomic-write behavior is retained.

Before downgrading to an older package, use the current version to run claude-statusline config language set en and claude-statusline config set statusline-language en, then follow the downgrade instructions and install matching native resources. Do not change schema numbers by hand.

Linux/WSL, Windows 10/11, macOS 14+ and Python 3.10–3.14 remain supported. Existing macOS Client focus/input limitations remain documented. Font and terminal-palette differences can affect appearance.

Validation

• 792 local Python tests completed: 784 passed and eight platform skips. The native Mod passed 102 tests and the runtime Mod passed ten; both TypeScript checks, Ruff, generated-resource and bilingual-document checks passed. CLI and both editors cover all 25 interface/output combinations, including editor save/cancel/reopen behavior. A temporary additional language verifies resource-only expansion.
• The installed candidate at 1134aee5425ed50fa0ca936321abb246e011b6b0 passed wheel inventory checks, an independent wheel rebuild with identical internal bytes, native/runtime install smoke and a real v1.12.0 wheel upgrade. Upgrade checks retained display/UI language, custom labels and explicit editor/collector opt-outs, and replaced protocol 9 resources with protocol 10.
• The three new languages passed 30 external Linux PTY cases (five sizes × two backgrounds × three languages) and 12 native cases (two sizes × two backgrounds × three languages). Common/minimum viewport images were inspected; official Client tests additionally cover the 32×12 native pane. Capture provenance distinguishes direct output, tmux color conversion, fixed sample data and image reconstruction. These are automated checks and agent inspection, with no new human Windows/macOS terminal acceptance, native-speaker review or paid model calls claimed.
• Fixed-source performance measurements compare v1.12.0 with the implementation and 2/5/10-language resource variants, recording P50/P95, memory, resource size and noise screening. Synthetic extra languages are test fixtures and are not shipped.
• Publication requires all 13 Python/build and ten Mod jobs on the final PR, merged commit and tag, followed by nine TestPyPI and nine formal PyPI jobs. Published packages and both mirrors use the same verified artifacts and SHA256 manifest.

简体中文

五种界面与状态栏语言

在英文、简体中文基础上，新增通用繁体中文（zh-Hant）、日语（ja）和韩语（ko），覆盖 CLI 帮助与错误、两个编辑器、预览以及主／子代理状态栏。默认仍为英文，保留已有选择，不自动识别系统语言。

pipx install --force fbincon-claude-code-statusline==1.13.0
claude-statusline install
claude-statusline config language set zh-Hant
claude-statusline config set statusline-language zh-Hant
claude-statusline doctor

可将 zh-Hant 替换为 en、zh-CN、ja 或 ko。界面语言立即保存；输出语言属于显示草稿，随保存／取消处理。--language en 仅覆盖本次 CLI 调用。

• 五套资源各包含 1,304 条消息，其中 220 条用于状态栏。统一有序注册表生成 Python 注册信息、TypeScript 类型、原生静态资源与独立状态栏模块；发布严格检查键、覆盖率、占位符、重复键和终端安全性，并保留运行时英文回退。
• 两端支持双向切换，保留选中项、搜索和草稿；写入失败保留原语言。搜索覆盖五语言名称、说明、分类、稳定 ID 与自定义标签，沿用排序与原文高亮规则。
• Python 状态栏仅按需导入当前语言及必要的英文回退模块，不扫描目录或解析界面 JSON。两端预建搜索字段，自定义标签只更新自身缓存；没有新增运行时依赖。
• 命令、配置键、路径、模型名、单位和用户文本保持原样。完整文档继续维护英／简中两套，扩展方法见翻译贡献指南。

显示 schema 7、界面偏好 v1、portable v1 和 runtime v2 不变；编辑器协议升为 10，要求软件包与原生资源匹配，明确拒绝新旧混用。升级后运行 claude-statusline install 更新资源，保留备份与原子写入行为。降级前先使用新版执行 claude-statusline config language set en 和 claude-statusline config set statusline-language en，再按降级说明安装旧软件及匹配资源，不要手改 schema 数字。

继续支持 Linux/WSL、Windows 10/11、macOS 14+ 与 Python 3.10–3.14；既有 macOS Client 焦点／输入限制仍见用户指南，字体和终端调色板可能影响外观。

• 本地 792 项 Python 测试中 784 项通过、8 项平台跳过；原生 Mod 102 项、runtime Mod 10 项、两端 TypeScript、Ruff、生成资源和双语文档检查通过。CLI 与两个编辑器覆盖全部 25 种界面／输出语言组合，编辑器还覆盖保存、取消和重新打开；临时语言验证无需修改业务代码即可扩展。
• 固定候选 1134aee5425ed50fa0ca936321abb246e011b6b0 通过包清单、内部文件逐字节一致的独立 wheel 重建、原生／runtime 安装检查及真实 v1.12.0 wheel 升级；显示／界面语言、自定义标签及编辑器／采集显式退出设置均保留，协议 9 资源正确更新为 10。
• 三种新语言通过 30 组外部 Linux PTY 与 12 组原生验收，常用／最小视口图像已检查，原生 32×12 面板由官方 Client 测试补充覆盖。图像来源记录区分真实输出、tmux 颜色转换、样本数据及图像重建。这些属于自动检查和 agent 图像检查，不代表新增 Windows/macOS 真人验收、母语者审校或付费模型调用。
• 固定源码性能报告记录相对 v1.12.0 及 2/5/10 语言规模的 P50/P95、内存、资源体积和噪声筛查；临时合成语言不进入发行物。
• 发布要求最终 PR、合并提交和标签的 13 项 Python／构建及 10 项 Mod 检查通过，再完成 TestPyPI 与正式 PyPI 各 9 项任务。软件包和两个仓库平台使用相同的校验后发行物及 SHA256 清单。

Publication verification / 发布核验

Fixed commit / 固定提交: 22be134e0aa18083c9320bbcc6caf01ee77c8682 (PR #72).

• Main: 13 Python/build jobs and 10 Mod jobs passed.
• Tag: 13 Python/build jobs and 10 Mod jobs passed.
• TestPyPI acceptance: all nine jobs passed, including six cross-platform index installations with identical distribution hashes.
• Final wheel/sdist installation, independent rebuilding and installed native/runtime smoke passed. Fixed-tag source installation matched all 205 runtime/resource files in the wheel. The final merged wheel also repeated two native and five external Japanese PTY cases, with terminal image inspection.

以上检查均已通过；正式 wheel、sdist、标签源码安装、独立重建及原生/runtime 接入均已验证，最终合并包补充通过 2 组原生、5 组外部日语 PTY 验收及图像检查。下载后使用随附 SHA256SUMS 核验发行文件。

Formal PyPI publishing and acceptance passed all nine jobs. Anonymous GitHub/PyPI downloads matched the original wheel and sdist byte-for-byte; isolated package-name installation with pipx reported v1.13.0 and passed CLI smoke. PyPI package.

正式 PyPI 的 9 项发布／验收任务全部通过；GitHub 与 PyPI 匿名下载文件与原始发行物逐字节一致，独立 pipx 包名安装确认 v1.13.0 并通过 CLI smoke。

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

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 全部文件内容与已验收候选一致。

• fbincon_claude_code_statusline-1.12.0-py3-none-any.whl
• fbincon_claude_code_statusline-1.12.0.tar.gz
• SHA256SUMS

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。

v1.11.0 — Grapheme-safe rendering and complete preview styles

v1.11.0 — Grapheme-safe rendering and complete preview styles

Main and subagent rows, both editors and their previews now share fixed Unicode character-cluster widths. Combined emoji remain intact, incremental style changes preserve foreground/background/bold state, and previews carry independent backgrounds.

Installation and compatibility

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

Linux/WSL, Windows 10/11 and macOS 14+ retain Python 3.10–3.14 support. Reinstall matching native resources for UI protocol v8. Display schema v6, portable format v1, interface preferences v1 and runtime protocol v2 remain unchanged; existing selections, languages and explicit collector/editor opt-outs are preserved.

Rendering changes

• Fixed Unicode 18.0 extended graphemes cover CJK, combining marks, skin tones, flags, keycaps, variation selectors and joined emoji. Splitting, clipping, padding, highlighted spans and backspace use whole clusters. Styles inside a cluster follow its first visible character while later changes apply to the next cluster.
• Foreground, background and bold accumulate independently. Standard/bright ANSI, 256-color and RGB forms support selective and full resets. Invalid color groups cannot accidentally become other style commands.
• Native previews apply explicit backgrounds within the existing light/dark surface. Curses uses bounded capability-aware colors and complete VT text runs; unsupported backends use width-preserving whole-cluster placeholders. Stored text is unchanged.
• Compact generated tables include reproducible provenance and licenses. The development reference is pinned wcwidth 0.9.1; normal rendering does not import it. ASCII avoids Unicode data loads and short-text caches are bounded.
• Representative local benchmarks distinguish process startup, bytecode and data caches, large transcripts, nested agents and Git cache states. Fixed before/after source trees use the same frozen harness and retain raw samples.

Per-item colors, new background controls, themes, Powerline and conditional visibility remain future work. Physical font/terminal glyph presentation can differ from the application's cell policy.

The existing macOS in-session Client focus/input limitation remains documented in the user guide. Main-line rendering and the standalone editor retain their existing support boundaries.

Validation and publication

Local validation passed 762 Python tests (754 passes, eight platform skips), 92 native and ten runtime official Mod tests, both TypeScript projects, all generated-file checks, Ruff and documentation checks. Both kernels pass 853 official Unicode boundary cases. The accepted source is 862d0d0; all 46 push/PR checks passed on that code.

Installed wheels passed core/native/runtime smoke and real 1.10.0 upgrades with both enabled resources and explicit opt-outs. Linux/CPython 3.14.4 PTYs cover six grapheme/style/color-capability cases, five external viewports, bilingual discovery, native advanced/language workflows at 120×30 and 80×48, and four direct native background/grapheme cases. An idle curses signal issue found in Linux/Python 3.10 CI was repaired; 60 extra local exit-signal checks passed without idle repainting.

The full benchmark retains 39,000 samples across 65 cases, two bytecode modes and three alternating rounds, plus targeted controlled repeats. For 32 agents at 40 columns, warm in-process P50 changed from 15.15 to 2.53 ms; fresh-process P50 changed from 66.83 to 62.66 ms. The complete performance report retains all scenario comparisons, seven screening flags, follow-up results and measurement limits.

Delivery PR #69 tracks final merge, package and publication gates. Automated PTYs and agent image inspection are distinct from human platform acceptance; no new human platform acceptance or paid model calls are claimed.

See rendering contracts, testing, shared protocol and the changelog.

简体中文

v1.11.0 — 完整字符簇与预览样式

主栏、子代理行及两个编辑器的预览共享固定 Unicode 字符簇列宽。组合 emoji 保持完整，增量样式正确保留前景／背景／粗体，预览增加独立背景通道。

安装与兼容性

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

保留 Linux／WSL、Windows 10／11、macOS 14+ 与 Python 3.10–3.14 支持。UI 协议升至 v8，需重装匹配的原生资源。显示 v6、便携格式 v1、界面偏好 v1、运行协议 v2 不变，保留既有选择、语言及明确关闭的采集／编辑器设置。

渲染改进

• 固定 Unicode 18.0 扩展字符簇，覆盖 CJK、组合字符、肤色、旗帜、键帽、变体选择符与 ZWJ。换行、裁切、补齐、高亮和退格均保留完整字符簇；簇内以首个可见字符的样式绘制，后续指令作用于下一簇。
• 独立累积前景／背景／粗体，支持标准／亮 ANSI、256 色、RGB 及独立／全部重置；非法颜色组不会变成其他样式指令。
• 原生预览在既有浅／深底色内应用显式背景；curses 使用有界颜色映射和完整 VT 文本绘制。不支持的后端使用等宽整簇占位符，保存文本保持原值。
• 精简生成数据保留来源与许可证。开发参考库固定 wcwidth 0.9.1，正常渲染不导入它；ASCII 不加载 Unicode 数据，短文本缓存有容量限制。
• 扩大本地性能样例，区分进程启动、字节码、数据缓存、大 transcript、嵌套代理与 Git 缓存；固定前后源码使用同一份冻结脚本，保留原始样本。

逐项配色、新背景控件、主题、Powerline 和条件显示仍属后续工作；物理终端／字体的字形表现可能与应用列宽策略不同。

既有 macOS 会话内 Client 焦点／输入限制仍保留，详见用户指南。主栏渲染和独立编辑器保持既有支持范围。

验收与发布

本地通过 762 项 Python 测试（754 通过、8 项平台跳过）、92 项原生与 10 项运行时 Mod 官方测试、两套 TypeScript、全部生成文件、Ruff 及文档检查。两端内核通过 853 条官方分簇标准用例。验收源码为 862d0d0，该代码的 push／PR 共 46 项检查全部通过。

已安装 wheel 通过基础／原生／运行时检查，以及保持启用和明确关闭两种状态的真实 1.10.0 升级。Linux／CPython 3.14.4 PTY 覆盖六组字符簇／样式／颜色能力场景、五个外部尺寸、双语查找、120×30／80×48 原生高级与语言流程，以及四组直接原生背景／字符簇场景。Linux／Python 3.10 CI 发现的空闲 curses 信号问题已修复，额外 60 次本地退出信号检查通过，空闲轮询不重复重绘。

完整基准保留 65 个场景、两种字节码状态、三轮交替的 39,000 个样本，另有定向受控复查。32 个代理、40 列时，热态进程内 P50 从 15.15 降到 2.53 ms，全新进程 P50 从 66.83 降到 62.66 ms。完整性能报告保留逐场景比较、七个筛选标记、复查结果及测量限制。

交付 PR #69记录最终合并、分发包和发布门槛。自动 PTY、代理图像检查与人类平台验收分别记录；不声称本次新增人工平台验收，未调用付费模型。

参见渲染契约、测试、共享协议和更新记录。

Release artifact verification / 发行包核验

Source / 源码：07263113529d86dc6feb54e1fb9c533fe69f4974 · annotated tag / 注释标签：752eb36ca2beffa74461884cabcb0eb8ed581115。

All 23 merge checks and 23 tag checks passed. / 合并及标签各 23 项检查通过。

Merge CI 1 · Merge CI 2 · Tag CI · Tag Mod CI

Independent sdist rebuilding matched all 196 wheel file contents. Wheel/sdist and fixed-tag installs, both 1.10.0 upgrade modes and final installed terminal flows passed. / 独立源码包重建的 196 个 wheel 文件内容一致；wheel／sdist／固定标签安装、两种 1.10.0 升级及最终安装包终端流程通过。

d9783c073298bc8121b98374460d8340ac4e9e155cca93e5bbfc010152302d2d  fbincon_claude_code_statusline-1.11.0-py3-none-any.whl
b5e36795c6305d3025561fb6f965cd14f7f4f34690f1a39a1f0d229dd68293dd  fbincon_claude_code_statusline-1.11.0.tar.gz

Package index verification / 包索引核验

TestPyPI: all 9 jobs passed / 全部 9 项通过. Both public package downloads match the sealed GitHub assets. / 两份公开下载均与封存的 GitHub 资产一致。

PyPI: all 9 jobs passed / 全部 9 项通过. Public GitHub/TestPyPI/PyPI package bytes and SHA256 agree; isolated PyPI pipx installation and installed-package smoke passed. / GitHub、TestPyPI、PyPI 公开包字节和 SHA256 一致，独立 PyPI pipx 安装及已安装包检查通过。