【实践记录】GLM StatusLine 插件开发实战

CCStatusline/
├── .claude-plugin/
│   ├── plugin.json              ← 插件身份
│   └── marketplace.json         ← 本地 marketplace
│
├── bin/                         ← 可执行脚本（加入 PATH）
│   ├── glm-statusline.js        ← 状态栏入口（薄入口，4 行）
│   └── glm-statusline-install.js ← 安装/配置/卸载 CLI（约 440 行）
│
├── skills/                      ← Skill 定义
│   ├── install/SKILL.md         ← /glm-statusline:install
│   ├── configure/SKILL.md       ← /glm-statusline:configure
│   ├── plan-details/SKILL.md    ← /glm-statusline:plan-details
│   └── uninstall/SKILL.md       ← /glm-statusline:uninstall
│
├── glm-statusline.js            ← 核心脚本（单文件，约 1100 行）
├── scripts/
│   └── verify.js                ← 验证脚本
├── package.json
├── CHANGELOG.md
└── README.md

glm-statusline.js
│
├── 配置层
│   ├── mergeEnvFromSettings()     ← 合并三层 settings 的 env
│   └── readStatusConfig()         ← 读取显示配置
│
├── API 层
│   ├── fetchQuota()               ← 获取额度信息
│   ├── fetchModelUsage()          ← 获取 token 用量
│   └── 缓存系统                   ← loadCache / saveCache / isFresh
│
├── 数据处理层
│   ├── mapClaudeModelToGlm()      ← 模型名映射
│   ├── getContextInfo()           ← 上下文信息
│   ├── readJsonlTokenStats()      ← 会话 token 统计
│   └── classifyLimit()            ← 额度分类
│
├── 渲染层
│   ├── renderStatusLine()         ← 状态栏渲染
│   ├── renderPlanDetails()        ← 详细信息渲染
│   ├── renderBar()                ← 进度条渲染
│   ├── wrapSegments()             ← 终端宽度换行
│   └── displayLength()            ← 显示宽度计算
│
└── 容错层
    └── main() catch handler       ← 崩溃时输出安全兜底

Claude Code 每 5 秒调用 statusLine command
  ↓
stdin JSON（model、context_window、transcript_path、workspace）
  ↓
glm-statusline.js
  ├── 合并环境变量（settings env + process env）
  ├── 读取显示配置（~/.claude/glm-statusline-config.json）
  ├── 检查缓存是否新鲜（默认 60 秒）
  │     ├── 新鲜 → 用缓存
  │     └── 过期 → 请求 GLM API
  │           ├── /api/monitor/usage/quota/limit
  │           └── /api/monitor/usage/model-usage（仅 day/30d 字段需要）
  ├── 解析 transcript 文件获取 session token
  ├── 渲染状态栏文本
  └── stdout 输出

  ↓
Claude Code 底部显示
  5H ██░░░░░░ 22% @18:30 │ Context █████░░░ 68% │ Session 160K

用户级 ~/.claude/settings.json (env)
  ↓ 合并
项目级 .claude/settings.json (env)
  ↓ 合并
项目级 .claude/settings.local.json (env)
  ↓ 合并
当前进程环境变量

配置了 day 或 30d 字段？
  ├── 是 → 请求 model-usage API + quota API
  └── 否 → 只请求 quota API

COLUMNS=80
  5H ██░░░ 22% @18:30 │ Context █████░░░ 68% │ Session 160K
  ←────────── 一行放得下 ──────────→

COLUMNS=50
  5H ██░░░ 22% @18:30 │ Context █████░░░ 68%
  Session 160K
  ←── 第一行 ──→ ←──── 第二行 ────→

{
  "name": "glm-statusline",
  "displayName": "GLM StatusLine",
  "description": "Configurable GLM / Z.ai usage status line for Claude Code.",
  "version": "1.2.3",
  "author": {
    "name": "CCStatusline"
  },
  "license": "MIT",
  "keywords": ["claude-code", "statusline", "glm"]
}

{
  "name": "bingqiangzhou-tools",
  "owner": { "name": "CCStatusline" },
  "description": "Local marketplace for the GLM StatusLine Claude Code plugin.",
  "version": "1.2.3",
  "plugins": [{
    "name": "glm-statusline",
    "displayName": "GLM StatusLine",
    "source": "./",
    "description": "Configurable GLM / Z.ai usage status line...",
    "version": "1.2.3",
    "category": "interface",
    "tags": ["statusline", "glm"]
  }]
}

第一步：/plugin install glm-statusline@bingqiangzhou-tools
  → Claude Code 发现插件，加载 skill 和 bin

第二步：/glm-statusline:install
  → 安装脚本写入 settings.json 的 statusLine.command

~/.claude/plugins/cache/bingqiangzhou-tools/glm-statusline/
├── 1.2.2/
│   └── bin/glm-statusline.js    ← 旧版本
└── 1.2.3/
    └── bin/glm-statusline.js    ← 新版本

~/.claude/glm-statusline-launcher.js

// 简化版 launcher
const fs = require('fs');
const path = require('path');

// 查找最新版本的插件缓存
const cacheDir = path.join(
  process.env.HOME, '.claude', 'plugins', 'cache',
  'bingqiangzhou-tools', 'glm-statusline'
);

// 列出所有版本目录，按 semver 排序
const versions = fs.readdirSync(cacheDir)
  .filter(d => /^\d+\.\d+\.\d+$/.test(d))
  .sort((a, b) => compareSemver(b, a));  // 降序

// 使用最新版本
const latest = versions[0];
const scriptPath = path.join(cacheDir, latest, 'bin', 'glm-statusline.js');

require(scriptPath);

settings.json 中的 statusLine.command：
  'node ~/.claude/glm-statusline-launcher.js'
    ↓
launcher 自动找到最新版本
    ↓
插件更新后状态栏继续工作，不需要重新安装

description: Enable the GLM status line in Claude Code user settings after
             the plugin is installed.
disable-model-invocation: true

description: Open an interactive selector for choosing GLM StatusLine fields.
disable-model-invocation: true

description: Show detailed GLM Coding Plan quota and usage information.
disable-model-invocation: true

description: Remove the GLM status line from Claude Code user settings.
disable-model-invocation: true

1. 读取 ~/.claude/settings.json
2. 检查是否已有 statusLine 配置
   ├── 有 → 提醒用户当前配置
   └── 无 → 继续
3. 写入稳定 launcher（~/.claude/glm-statusline-launcher.js）
4. 写入 statusLine.command 指向 launcher
5. 输出安装结果和预览

1. 显示当前配置
2. 逐个字段让用户选择
3. 每次选择后保存配置
4. 运行 --preview 显示预览
5. 输入 q 结束

1. 读取 ~/.claude/settings.json
2. 检查 statusLine 是否是本插件管理的
   ├── 是 → 移除
   └── 否 → 提示"非本插件配置，不删除"
3. 输出卸载结果

验证内容：
  ├── 插件文件结构
  │     ├── plugin.json 合法
  │     ├── marketplace.json 正确
  │     └── 版本号一致
  │
  ├── 状态栏脚本
  │     ├── 默认输出包含 5H、Context、Session
  │     ├── 配置字段切换正确
  │     ├── 终端宽度换行正确
  │     ├── --preview 输出预览
  │     └── --plan-details 输出详情
  │
  ├── 安装脚本
  │     ├── install 写入 settings.json
  │     ├── configure 交互选择
  │     ├── uninstall 正确移除
  │     └── 不误删非本插件配置
  │
  └── 稳定 launcher
        └── 自动找到最新版本

npm test

{
  "hooks": {
    "SessionStart": [{
      "matcher": "startup",
      "hooks": [{
        "type": "command",
        "command": "${CLAUDE_PLUGIN_ROOT}/bin/glm-statusline-install.js check"
      }]
    }]
  }
}

[
  {
    "name": "quota-watch",
    "command": "${CLAUDE_PLUGIN_ROOT}/scripts/quota-watch.sh",
    "when": "always",
    "description": "Warns when GLM/Z.ai quota is running low"
  }
]

agents/
└── api-diagnostic.md

---
name: usage-aware
description: When discussing GLM/Z.ai usage, suggest optimizations.
---