Token Weather：Claude Code 上下文窗口预报

Token Weather 是一款社区插件，作者是 Hamza Zafar（hamzafer），属于他的 claude-code-mods 合集。它在输入框上方用一行文字给出 Claude Code 上下文窗口预报：用一个天气词和图标表示窗口有多满，再加上百分比、相对窗口大小的 token 数、最近几轮的迷你柱状图，以及提示缓存还能保持多久的倒计时。

预报从 ☀ Clear（低于 25%）依次经过 ☁ Cloudy、☂ Showers 和 ☇ Storm，到 90% 及以上的 ↯ Compact soon。旁边的 last turns 用 ▁▂▃▄▅▆▇█ 画出最多 12 个读数，按其中最大值缩放，后面是上一轮增加或减少了多少，例如 ▲ +39.4k last turn。当这一行足够宽时，❄ cache 4:12 会倒数到提示缓存过期的时刻，最后一分钟变黄，之后显示 ❄ cache cold。

Token Weather 与我们的 Context Bar、上下文仪表 和 Cache Clock 有些重叠。Context Bar 按类别拆分窗口；上下文仪表 在状态栏显示百分比和套餐用量；Cache Clock 在状态栏下方显示缓存详情。Token Weather 则给出一行结论和变化趋势。作者的插件市场中列出的版本是 0.2.2。

录屏中，我们在小型演示项目里启动加载了该插件的 Claude Code。在发送任何提示之前，输入框上方的这一行显示 ☀ Clear 0% of context 0 / 1M。接着我们让 Claude 读取 README.md，用一句话说明这个项目。第一次请求运行时，会出现 ❄ cache 5:00 倒计时。这一轮结束后，这一行显示 ☀ Clear 4% of context 39.4k / 1M、迷你柱状图、▲ +39.4k last turn，以及 ❄ cache 60:00，因为这次响应写入的是 1 小时的缓存。

使用安装区块中的任意一种方式；它们都直接从作者自己的插件市场安装。这一行会在下一次会话开始时出现。插件只有一个选项，即提示缓存的有效期。

插件把读数保存在由宿主持有的 $.state 原子中，因此热重载后依然保留。读数在会话开始时和主代理每一轮结束后获取，数据来自 $.session.usage 的上下文信息。缓存时钟会在主线程每次模型请求结束后重新开始，包括一轮之内工具循环中的请求。以下是 turn.step 处理函数，来自 hooks/register.tsx：

on('turn.step', async function* ($, e, next) {
  const result = yield* next(e)
  if (!e.agentId && result.stopReason !== null) {
    const now = await $.clock.now()
    await update($, lastRequestAt, () => now)
    restart($, now, now, await ttlMsFor($, override))
  }
  return result
})

在 auto 模式下，每一轮结束后它会读取会话记录（<config dir>/projects/<project>/<session id>.jsonl）的最后 1 MB，并在最近一次主线程响应的 cache_creation 中查找 1 小时或 5 分钟的 token。结果会保存在插件的存储中，供下一次会话使用。倒计时文字变化时，一个定时器会重绘这一行：剩余超过十分钟时每 30 秒一次，之后每 15 秒一次，最后两分钟每秒一次。

唯一的选项是插件设置中的 cacheTtl：auto（默认）、5m 或 1h。固定值会覆盖自动检测。预报的档位、12 个读数的历史和 60 秒的警告都是 register.tsx 顶部的常量。插件还会读取一个可选的顺序文件 <config dir>/claude-code-mods/bands.json，当同一作者的多个横条插件同时显示在输入框上方时，用它决定顺序。

在运行之前，我们读过了插件可以执行的每一个文件：.claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx、hooks/bands.ts、类型声明和三个测试文件。没有 package.json、安装脚本、二进制文件或打包后的代码，它绘制的文字由数字拼成，不会向模型的提示中注入任何内容。仓库带有 MIT LICENSE。

它的全部行为如下：

• **网络：**无。
• **进程：**一个，tail -c 1048576 <会话记录路径>，仅在会话记录大于 1 MB 时使用，否则直接读取文件。
• **读取的文件：**你自己的会话记录（用于检测缓存有效期）、Claude 配置目录下可选的 bands.json，以及通过 $.settings.read 读取的 Claude Code 设置（用来判断是否配置了 Cache Clock 状态栏）。它读取环境变量 HOME 和 CLAUDE_CONFIG_DIR 来定位这些文件。
• **写入的文件：**没有直接写入。它通过 $.store（插件自己的存储）保存检测到的缓存有效期（5m 或 1h）。
• **后台运行：**Claude Code 内部的一个重绘定时器，会话结束时停止。没有守护进程。
• **拦截：**无。它不会阻止或改写工具调用或提示。

claude plugin validate 没有报告插件本身的错误或警告（目录检查器提示缺少图标）。作者的 24 个测试在 Claude Code 2.1.307 上全部通过。

已在 macOS 上使用 Claude Code 2.1.307 检查（validate、测试和录屏）。如果这一行没有出现：

• 安装之后你开启了新的会话；插件在会话开始时加载。
• 输入框上方没有打开问卷。问卷出现时这一行会让位，之后会回来。
• 窗口至少 60 列宽。更窄的终端只显示预报词、百分比和 token 数。
• 如果倒计时不对，把 cacheTtl 设为 5m 或 1h，而不是 auto。项目路径特别长，或项目在会话期间被移动，可能导致找不到会话记录，此时会保留最近一次检测到的值。
• /clear 或恢复会话之后，倒计时会隐藏，直到下一次请求。