# @fbincon/claude-code-statusline 中文文档 规范地址：https://npmcn.com/package/%40fbincon/claude-code-statusline/ 版本：3\.16\.3 npm 元数据更新时间：2026-11-05T05:35:01.828Z 中文译文更新时间：2026-11-14T12:14:11.488Z 软件包许可：MIT AND Unicode-3\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40fbincon/claude-code-statusline 原文对照：https://npmcn.com/package/%40fbincon/claude-code-statusline/?lang=original 项目主页：https://github.com/fbincon/claude-code-statusline 源码仓库：https://github.com/fbincon/claude-code-statusline ## 关键信息（来自 npm 元数据） - 包体积（解压后）：19.5 MB，1093 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：^22\.0\.0 \|\| ^24\.0\.0 - 运行依赖：10 个 - 首次发布：2026-10-18T03:32:38.331Z - 最新版本发布：2026-11-05T05:35:01.502Z - 近 30 天下载量：8196（2026-10-15 至 2026-11-13，npm 官方下载统计） - 已发布版本数：28（近 12 个月 28 个） ## 中文简介 可配置 Claude 代码状态线和终端编辑器 ## 安装 ```sh npm install @fbincon/claude-code-statusline ``` 也可以使用：`pnpm add @fbincon/claude-code-statusline`、`yarn add @fbincon/claude-code-statusline`、`bun add @fbincon/claude-code-statusline` ## README # Claude 代码状态 **联合国** | [简体中文](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/README.zh-CN.md) [![CI](https://github.com/fbincon/claude-code-statusline/actions/workflows/ci.yml/badge.svg)](https://github.com/fbincon/claude-code-statusline/actions/workflows/ci.yml) [无](https://www.npmjs.com/package/@fbincon/claude-code-statusline) • 妇女 [MIT 许可证](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/LICENSE) Linux,WSL,Windows和macOS的可配置克洛德代码状态行. 参见模型和推理努力,项目,Git,上下文,用法和任务时间安排一览. 在当前 Claude 会话中配置主行和单个子代理行,一个终端编辑器或CLI. [示威](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SHOWCASE.md) • 妇女 [快速安装](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/README.md#quick-installation) • 妇女 [通用配置](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/README.md#common-configuration) • 妇女 [用户指南](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md) • 妇女 [解决问题](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#troubleshooting) ## 特征 - **选择要看到的 :** 65个主要度量衡和15个亚剂度量衡,外加文本和灵活空间器. 十二种语言的搜索名称,身份和描述. [计量定义](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/DISPLAY_ITEMS.md)。 。 。 . - **绘制可读显示 :** 独立组件复制,链接组,正行,左/右布局,有条件的能见度,颜色,梯度和可适应的百分比指标. [组成](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/COMPOSITION.md) • 妇女 [外观](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/APPEARANCE.md)。 。 。 . - **从方案开始 :** 8个完整的显示方案和6个原始的预设仍然可以编辑. 保存命名方案, 绑定工程并重用所选样式或整组 . [计划](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SCHEMES.md) • 妇女 [项目约束](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/PROFILES.md)。 。 。 . - **保存前的审查 :** 样本方案、宽度预览、导入差异、共享撤销/重写和当前文件比较有助于检查草稿. [历史和再利用草案](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/DRAFT_HISTORY.md)。 。 。 . - **跟踪任务和代理人:** 通过代理工作和主要总结,以及可搜索的任务证据查看器. [任务细节](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/TASK_DETAILS.md)。 。 。 . - **添加明确的数据源 :** 本地 JSON, GitHub 检查和命令值, 单独审查激活, 刷新和可选链接 . [扩展](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/EXTENSIONS.md)。 。 。 . - **独立选择界面和输出语言 :** 英文、 . - **诊断和康复:** 检查所提供的输入,审查软件包的修改,并明确恢复相容的配置备份. [投入诊断](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/DIAGNOSTICS.md) • 妇女 [软件包管理](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/PACKAGE_MANAGEMENT.md)。 。 。 . 渲染读取克洛德代码输入和本地状态,没有网络请求或模型符号. 可选源刷新是独立的;问答向导使用克洛德模型转动. 缺失的观测数据仍然与零相区别. ## 截图 这个 [完全示威](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SHOWCASE.md) 配对场景配置,并带有可再生步骤,用于设置,编辑,任务,源和版本审查. 视觉基线采用经典分离器和没有Powerline的柔软而明亮的前缘梯度. 一个组件保持其颜色横跨主干线和子干线;而光线场景则使用同花色的更深的阴影. 每个资产的软件包、输入和捕获类型记录在 [显示图像索引](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/images/showcase/README.md);固定样本与记录的任务观测分开确定. ![Daily development statusline with classic separators and distinct foreground gradients](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.3/docs/images/showcase/en/daily.png) ![Configuration workflow with a colored statusline preview and reviewed changes](https://raw.githubusercontent.com/fbincon/claude-code-statusline/v3.16.3/docs/images/showcase/en/configure.gif) 剪辑复制了1个度量,然后显示Undo,Redo,Save并重新打开. 复制品只属于这项练习;之后原日取景恢复. ### 会期TUI 运行 `/statusline-configure-native` claude Code内部,在使用键盘前点击客户端区域一次. [编辑工作流程](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#native-configuration-editor)。 。 。 . ### 外部图伊 运行 `claude-statusline configure` 在终端,或 `/statusline-configure` 从克洛德代码打开一个支持的外部终端. [终端工作流程](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#standalone-interactive-tui)。 。 。 . [所有当前和历史图像](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/images/README.md) 保留原出处 历史跨平台截图不能确定接受较新的软件包;6个现有 [问题96](https://github.com/fbincon/claude-code-statusline/issues/96) 未经核实. ## 支持的平台 | 平台 | 支助环境 | | --- | --- | | Linux / WSL 系统 | 节点22.x或24.x,x64 | | 视窗 10/11 | 节点22.x或24.x,x64 | | 马可斯14+ | 节点 22.x 或 24.x, Intel / Apple硅 | Windows ARM设备在模拟下使用x64节点;本地Windows ARM64和32位运行时间在支持合同之外. Git 字段需要 Git. Claude 代码要求因特征而异:子剂行 2.1.205+,局部斜线参数/外部条目 2.1.258+,会中编辑 2.1.287+,本土计时/活度测量 2.1.289+. [要求和限制](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#requirements)。 。 。 . ## 快速安装 以 npm 和 Claude 代码 CLI 安装节点 22.x 或 24.x 。 软件包捆绑其支持的本土依赖,不需要Python或编译器. ### 安装软件包 在互动终端, `npx @fbincon/claude-code-statusline` 在打开设置前审查持续安装。 或者,明确安装软件包: ```text npm install --global --ignore-scripts @fbincon/claude-code-statusline ``` ### 与 Claude 代码合并 确保 npm 命令目录位于 PATH, 然后运行 : ```text claude-statusline --version claude-statusline setup --dry-run claude-statusline setup claude-statusline doctor ``` 在视窗上,使用 `claude-statusline.cmd`,或引用已安装的带有节点的JavaScript条目。 整合后在可信任的终端中重新启动克洛德代码. 软件包安装,显示Save和Claude集成是独立的阶段;如果后期失败,则设置报告部分完成. 两种编辑器都默认兼容主机,并保存所保存的选择. 本地计时和先进的活度测量需要明确的选择。 见 [第一用途设置](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SETUP.md), (中文(简体) ), [离线/固定版安装](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#installation-and-integration), (中文(简体) ), [冲突处理](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#handle-an-existing-status-line-or-skill-with-the-same-name) 财务报告和审定财务报表 [Python 迁移](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#migrate-from-python)。 。 。 . ## 通用配置 | 入境点 | 使用 | | --- | --- | | `/statusline-configure-native` | 在当前 Claude 会话中编辑 | | `/statusline-configure` | 在支持的外部终端中启动编辑器 | | `claude-statusline configure` | 在当前终端中编辑,包括SSH | | `/statusline-config` | 克劳德问答向导; 支持的参数命令运行于本地 | | `claude-statusline config ...` | 检查设置或设定脚本中的确切值 | 无论是编辑, **缩写+P** 打开快速设置来选择一个方案,检查要求并预览草稿。 保存应用到显示的用户/ profile/ project 目标; 在显示更改前取消丢弃 . [行走和可重复使用的场景](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SHOWCASE.md) • 妇女 [所有计划](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SCHEMES.md)。 。 。 . ### 界面语言 设定共享界面首选项, 或者将其覆盖, 用于一次引用 : ```text claude-statusline config language set zh-CN claude-statusline --language en configure ``` 界面语言的更改会立即保存并活下来取消显示编辑. [语言选择](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#interface-language)。 。 。 . ### 状态语言 独立设定输出语言 : ```text claude-statusline config set statusline-language zh-CN ``` 在编辑器中,这个选择修改了预览,只有在显示 Save 后才会在实际的主/增殖输出中生效. 技术ID,路径和自定义文本保留了它们的值. [输出语言](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#statusline-language)。 。 。 . ### 本地配置编辑器 点击客户区一次 。 标签更改页面, 空格切换, Ctrl+E 打开项目细节, `/` 搜索和 Ctrl+F 过滤类别. `S` 拯救并逗留, `F` 保存和关闭,以及 `Q` 放弃草稿。 Ctrl+G取消字段输入. [控制和回收](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#native-configuration-editor)。 。 。 . ### 外部和独立终端TUI 标签更改页面,空格切换,以及字段输入完成后 Ctrl+S 保存. Esc先取消一个字段,再取消编辑器;Ctrl+C中断而不保存. 最小尺寸为64×18. [控制和终端发射器](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#standalone-interactive-tui)。 。 。 . 从一个内置的、有经典分离器的计划中开始: ```text claude-statusline config preset daily-development --dry-run claude-statusline config preset daily-development claude-statusline config set separator-style classic ``` 应用前的审查:一个预设替换显示选择和布局. [食谱](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#configuration-recipes) • 妇女 [CLI 参考](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/reference/cli.md)。 。 。 . ## 升级和注销 审查和应用软件包更改,然后重新启动 Claude 代码 : ```text claude-statusline update --check claude-statusline update claude-statusline doctor ``` [软件包管理](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/PACKAGE_MANAGEMENT.md) 解释准确的版本,前缀,回滚和单独的配置还原. 在卸载软件包前删除 Claude 集成 : ```text claude-statusline uninstall --dry-run claude-statusline uninstall npm uninstall --global @fbincon/claude-code-statusline ``` 显示设置和备份 . [未加载](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#uninstalling)。 。 。 . ## 项目结构 TypeScript 工作空间分离出纯规则(`packages/core`),平台效应(`packages/platform`),应用服务(`packages/cli`)和终端编辑器(`packages/tui`) (中文(简体) ). `mods` 包含官方与东道方的融合; `tools` 包含生成、包装和接受工具. `archive/python` 保留被冻结的历史执行. [建筑](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/development/architecture.md) • 妇女 [开发设置](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/development/README.md)。 。 。 . ## 文件和帮助 | 目标 | 从这里开始 | | --- | --- | | 尝试完整的工作流程 | [示威](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SHOWCASE.md) • 妇女 [第一用途设置](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SETUP.md) | | 配置显示 | [用户指南](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md) • 妇女 [计划](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/SCHEMES.md) • 妇女 [外观](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/APPEARANCE.md) • 妇女 [组成](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/COMPOSITION.md) | | 重用设置 | [概况和项目](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/PROFILES.md) • 妇女 [历史和再利用草案](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/DRAFT_HISTORY.md) | | 了解数据 | [计量定义](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/DISPLAY_ITEMS.md) • 妇女 [任务细节](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/TASK_DETAILS.md) • 妇女 [扩展](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/EXTENSIONS.md) | | 诊断或自动化 | [解决问题](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/USER_GUIDE.md#troubleshooting) • 妇女 [投入诊断](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/DIAGNOSTICS.md) • 妇女 [CLI 参考](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/reference/cli.md) | | 制定或审查证据 | [发展指南](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/development/README.md) • 妇女 [图像来源](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/images/README.md) | | 后续计划或释放 | [路线图](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/development/roadmap.md) • 妇女 [发展计划](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/docs/development/development-plan.md) • 妇女 [更改日志](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/CHANGELOG.md) | [GitHub 问题](https://github.com/fbincon/claude-code-statusline/issues) 接受可复制的bugs,问题和特征想法. 包括版本,步骤和相关诊断;去掉私道和会话内容. ## 捐助和安全 见 [捐款](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/CONTRIBUTING.md) 为发展服务、翻译和反馈。 私下报告脆弱性 [安全政策](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/SECURITY.md)。 。 。 . ## 许可证 [MIT 许可证](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/LICENSE)版权(c) 2026 [鸡尾酒](https://github.com/fbincon)。 。 。 . Bundled Unicode 数据保留 [Unicode 许可证 v3](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/tools/unicode/UNICODE-LICENSE.txt) 编辑 [wcwidth 麻省理工学院通知](https://github.com/fbincon/claude-code-statusline/blob/v3.16.3/tools/unicode/WCWIDTH-LICENSE.txt)。 。 。 . ## 常见问题 ### @fbincon/claude-code-statusline 是什么？ 可配置 Claude 代码状态线和终端编辑器 ### 如何安装 @fbincon/claude-code-statusline？ 在项目目录运行 npm install @fbincon/claude-code-statusline，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 claude-statusline，可以用 npx claude-statusline 直接运行。 ### @fbincon/claude-code-statusline 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fbincon\_\_claude-code-statusline 是否存在。 ### @fbincon/claude-code-statusline 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @fbincon/claude-code-statusline 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js ^22\.0\.0 \|\| ^24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @fbincon/claude-code-statusline 可以商用吗？ @fbincon/claude-code-statusline 使用 MIT AND Unicode-3\.0 许可。声明的许可为 MIT AND Unicode-3\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @fbincon/claude-code-statusline 的下载量有多少？ 根据 npm 官方下载统计，@fbincon/claude-code-statusline 在 2026/10/15 – 2026/11/13 这 30 天内被下载 8,196 次，日均约 273 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @fbincon/claude-code-statusline 还在维护吗？ 最新版本 3\.16\.3 发布于 2026/11/05（9 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/10/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。