Pulse Line

一个高度可定制的 Claude Code 状态栏插件

支持多主题、国际化和实时监控

中文 | English

---

特性

• 17 个模块 — 当前模型、Git 分支、上下文使用率、缓存、MCP 状态、账户用量、轮次、思考模式、规则统计、工具分析等
• 5 个内置主题 — Dark、Light、Cyberpunk、Forest、Ocean
• 国际化支持 — 中/英文切换
• 第三方 API 监控 — 智谱 (GLM)、DeepSeek、MiniMax 账户余额和配额
• 自适应布局 — 自定义模块顺序，按终端宽度自动换行，可配置每行模块数上限和分隔符
• 13 个斜杠命令 — 在 Claude Code 中直接管理

快速开始

方式一：Plugin Marketplace（推荐）

在 Claude Code 中执行：

/plugin marketplace add knqiufan/pulse-line
/plugin install pulse-line

安装完成后，重启 Claude Code，插件会在下次会话启动时自动配置状态栏。

方式二：一键命令安装

npx -y pulse-line@latest install

这条命令会自动完成所有配置，执行后重启 Claude Code 即可。

注意：此方式会自动尝试注册插件。如果你还需要 /pulse-line:* 斜杠命令，请在 Claude Code 中额外执行：

/plugin marketplace add knqiufan/pulse-line
/plugin install pulse-line

方式三：全局安装

npm install -g pulse-line
pulse-line install

提示：也可以直接让 Claude Code 帮你安装——在对话中告诉它"帮我安装 pulse-line 状态栏"，它会自动完成配置。

命令一览

斜杠命令（Claude Code 内使用）

命令	说明
/pulse-line:install	初始化配置
/pulse-line:theme <name>	切换主题
/pulse-line:themes	列出可用主题
/pulse-line:enable <module>	启用模块
/pulse-line:disable <module>	禁用模块
/pulse-line:language <zh|en>	切换显示语言
/pulse-line:config	在编辑器中打开配置
/pulse-line:reload	重新加载配置
/pulse-line:clear-cache	清除缓存
/pulse-line:timeline	调试/导出已采集的工具分析数据
/pulse-line:rules	查看/管理项目规则文件
/pulse-line:debug	切换调试模式
/pulse-line:uninstall	卸载配置

CLI 命令（终端中使用）

pulse-line theme cyberpunk     # 切换主题
pulse-line language zh         # 切换为中文
pulse-line enable thinking     # 启用模块
pulse-line disable cost        # 禁用模块
pulse-line clear-cache         # 清除缓存
pulse-line timeline --last 20  # 查看最近工具调用
pulse-line rules list          # 列出项目规则文件
pulse-line rules pattern add "docs/**/*.md"  # 添加包含模式

模块列表

模块	ID	默认状态	说明
当前模型	model	✅ 开启	当前 AI 模型名称
Git 分支	git	✅ 开启	分支名及领先/落后数
工作区	workspace	✅ 开启	当前项目名
上下文使用率	context	✅ 开启	上下文窗口使用率（含进度条）
缓存	cacheRatio	✅ 开启	缓存 token 数量（K/M 格式）
MCP	mcpStatus	✅ 开启	活跃 MCP 服务器数量
账户用量	accountUsage	✅ 开启	第三方 API 配额和余额
轮次	turns	✅ 开启	对话轮次
思考模式	thinking	✅ 开启	扩展思考状态
费用	cost	❌ 关闭	会话费用（美元）
时长	duration	❌ 关闭	会话持续时间
限速	rateLimits	❌ 关闭	Anthropic API 限速（5h 窗口）
配额	weeklyQuota	❌ 关闭	Anthropic API 周配额
输出风格	outputStyle	❌ 关闭	当前输出风格
第三方 API	thirdPartyApi	❌ 关闭	异步 API 供应商查询
规则	rules	✅ 开启	项目规则/Skill 文件数量统计，显示规则与 Skill 明细
工具分析	toolTimeline	❌ 关闭	独立工具调用统计分析面板，包含最近调用

配置

配置文件位于 ~/.claude/pulse/config.json，可通过 pulse-line config 打开编辑。

{
  "theme": "dark",
  "language": "zh",
  "iconSet": "text",
  "separator": " │ ",
  "padding": 1,
  "maxPerLine": 5,
  "modules": {
    "model": { "enabled": true, "order": 1, "icon": "[当前模型]" },
    "git": { "enabled": true, "order": 2, "icon": "[Git 分支]" },
    "workspace": { "enabled": true, "order": 3, "icon": "[工作区]" },
    "context": { "enabled": true, "order": 4, "showBar": true, "barWidth": 12 },
    "rules": {
      "enabled": true,
      "order": 16,
      "icon": "[规则]",
      "includePatterns": [],
      "excludePatterns": []
    },
    "toolTimeline": {
      "enabled": false,
      "order": 17,
      "icon": "[工具]",
      "displayMode": "analytics-panel",
      "maxEvents": 100,
      "maxDisplayEvents": 5,
      "panelWidth": 59
    }
  },
  "advanced": {
    "debugMode": false,
    "cacheEnabled": true,
    "cacheTTL": 300
  }
}

配置说明

字段	类型	说明
theme	string	主题名称
language	"zh" | "en"	显示语言
separator	string	模块间的分隔符
padding	number (0-10)	分隔符两侧的空格数
maxPerLine	number (1-20)	每行模块数上限，实际显示数量会按终端宽度自动调整
iconSet	"text" | "nerd"	图标模式，text 为 ASCII 安全字符

自适应布局

Pulse Line 会在 Windows、macOS 和 Linux 上探测终端宽度，并在 Claude Code 截断状态栏之前自动把指标项换到下一行。maxPerLine 仍然作为每行模块数上限，实际每行显示几个模块会根据当前终端宽度动态调整。工具分析面板也会跟随终端宽度收窄显示。

工具分析

安装插件后，Pulse Line 会通过 Claude Code 的 PostToolUse / PostToolUseFailure / SubagentStop hook 记录工具调用摘要和子 agent 元数据到本地缓存，不上传任何遥测数据。启用 toolTimeline 后，主视图会在普通状态栏下方显示独立的工具分析面板，展示总工具调用数、当前 context token、主 agent / 子 agent 工具数、子 agent 名称、最耗时工具和最近 5 条调用。

timeline 命令保留为调试和导出入口，不再作为主要查看方式：

pulse-line enable toolTimeline
pulse-line timeline
pulse-line timeline --last 10
pulse-line timeline --json
pulse-line timeline clear

第三方 API 监控

Pulse Line 支持监控第三方 API 供应商的账户余额和配额：

供应商	环境变量	显示内容
智谱 (GLM)	ZHIPU_API_KEY、ZHIPU_BASE_URL	使用率 % 及倒计时
DeepSeek	DEEPSEEK_API_KEY	余额（CNY）
MiniMax	MINIMAX_API_KEY、MINIMAX_GROUP_ID	使用率 % 及倒计时

供应商会从 Claude Code 设置中自动检测，也可手动配置 accountUsage.providers 数组。

注意：账户用量数据来源于第三方供应商 API，若官方未提供相关接口则无法显示。显示数据仅供参考，请以供应商官方后台为准。

主题预览

主题	风格描述
dark	蓝绿色系，专业沉稳
light	明亮清爽，适合浅色终端
cyberpunk	霓虹高对比，赛博朋克风
forest	自然绿色系，大地色调
ocean	深蓝色系，海洋质感

本地开发

git clone https://github.com/knqiufan/pulse-line.git
cd pulse-line
npm install
npm run build
npm link

# 在 Claude Code 中作为本地插件加载
claude --plugin-dir /path/to/pulse-line

系统要求

• Node.js >= 18.0.0
• Claude Code CLI

常见问题

安装后状态栏不显示？

1. 确认 ~/.claude/settings.json 中包含 statusLine 字段
2. 执行 npx -y pulse-line@latest install 重新配置
3. 重启 Claude Code

图标显示为方块或乱码？

1. 确保 config.json 中 iconSet 为 "text"（默认值）
2. 如果使用了 Nerd Font，可设为 "nerd"
3. 执行 pulse-line reload 应用变更

修改配置后没有生效？

1. 执行 pulse-line reload
2. 或重启 Claude Code

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT