Context Inspector：找出 Claude Code 上下文浪费

Context Inspector 是一款查找 Claude Code 上下文浪费的社区插件，作者是 YeonwooSung（my-claude-code-mods）。它会为进入对话的所有内容（提示、回复、工具结果、附件）建立一本账，并回答三个问题：现在窗口里装着什么，为什么同样的信息一再回来，以及一次压缩保留或丢失了什么。

它会添加一个状态栏，形如 ctx 62% · waste≈8.1k，其中百分比是实测值，浪费量是估算值。它还添加三个命令。/context-inspect 打印文字报告，包含概览、占用者、重复读取、相似输出、压缩、效率和建议几个部分。/context-pane 打开实时面板。/context-export 把账本保存为 JSONL，只含元数据。

它的分析很具体。对文件的重复读取会被分类，例如较早的副本仍在窗口中而没有变化（纯粹的浪费）、编辑之后、压缩之后。近似重复的工具输出按词面 SimHash 分组，而不是按语义。压缩之后，它会检查已编辑和已读取的文件、错误和用户标识是否仍出现在摘要中。作者的 README 要求 Claude Code 2.1.287 或更高版本。

录屏中，我们在小型演示项目里启动加载了该插件的 Claude Code，并让 Claude 读取 README.md，用一句话说明这个项目是什么。这一轮结束后，页脚显示 context-inspector: ctx 4% · waste≈0。随后我们运行 /context-inspect。报告列出了当前的存活 token（17 个条目中约 6.2k）、按类别排列的主要占用者（技能列表、MCP 说明和延迟加载工具这几类附件）、重复读取、相似输出、压缩、效率和建议。在这段很短的会话里没有任何文件被读两次，所以浪费为零，建议一栏写着没有突出的问题。

使用安装区块中的任意一种方式；它们都直接从作者自己的插件市场安装。状态栏会在下一次会话开始后、第一轮对话完成时出现。

模块是 hooks/register.tsx 中的一个 register 函数，它包装各个事件并原样往下传。每一步记账都经过一个会吞掉自身错误的辅助函数，因此检查器不会破坏会话。工具调用在执行前后各记录一次，返回的结果保持原样：

on('tool.call', async ($, e, next) => {
  const id = e.tool_use_id
  if (id !== undefined) safe(() => ingestToolCall(ledger, id, String(e.tool), e.agentId, e as unknown as Record<string, unknown>))
  const answer = await next(e)
  if (id !== undefined) safe(() => ingestToolResult(ledger, id, answer))
  return answer
}).catch(($, e, next) => next(e))

这段摘录来自 hooks/register.tsx。消息行通过 session.append 到达，实测的请求大小通过 turn.step 到达，压缩通过 session.compact 到达。每一轮之后，turn.complete 会排队一次重绘，读取 $.session.usage() 并写入状态栏。hooks/core/ 中的分析代码是纯 TypeScript，只有本地导入，账本上限为 20,000 个条目。

/config 中有两个选项。outputDir 设置 /context-export 的写入位置，留空表示 ~/.claude/context-inspector。toastAdvice（默认开启）会在每个会话中首次出现高严重度建议时弹出一次提示。两个命令都接受参数：/context-inspect advice 只显示一个部分，--agents 会包含子代理。

在运行之前，我们读过了插件可以执行的每一个文件：清单、hooks/hooks.json、hooks/register.tsx 以及 hooks/core/ 下的全部文件，包括脱敏规则。没有 package.json、安装脚本、二进制文件或打包后的代码，导入的都是本地文件。

• 网络、进程、守护进程、遥测： 都没有。没有 fetch，没有 shell 命令，也没有在 Claude Code 退出后继续运行的东西。
• 修改界面： 状态栏、提示通知和面板。添加命令： 上面三个。
• 观察每一次工具调用和消息行，通过 tool.call、session.append、turn.step 和 session.compact。这些是可以拦截的钩子，但每个都原样返回下一个处理器的结果并带有 .catch 兜底；不会阻止或改写任何内容。validate 还提示，在由组织管理 Claude Code 的环境中，个人安装的插件不会运行 session.compact 钩子，除非组织把它列入托管设置。
• 文件写入： 只发生在 /context-export 时，通过 $.fs.write 写到 <outputDir>/<会话 id>/context-<load>-<n>.jsonl。默认位置在 ~/.claude 内插件自己的子文件夹中。它读取 HOME 来展开 ~。文件路径原样导出，其他目标尽力脱敏；作者建议分享导出文件前先检查。
• 对提示的影响： 没有发现。它不向提示或工具结果注入文字；建议只显示给你。
• 外部依赖： 无。许可证： Apache-2.0，仓库根目录有 LICENSE 文件。

claude plugin validate 没有报告错误或警告，只有上面提到的提示。作者的 102 个测试在 Claude Code 2.1.303 上全部通过。

已在 macOS 上使用 Claude Code 2.1.303 检查（validate 和测试）。如果状态栏没有出现：

• claude --version 为 2.1.287 或更高版本。
• 已经完成过一轮对话；状态栏在 turn.complete 之后绘制。
• 即使没有状态栏，/context-inspect 也会打印报告，可用它确认插件已加载。
• 在 VS Code 聊天面板中只有钩子和命令文字可用，请使用 /context-inspect。

README 中列出的已知限制：重新加载、恢复或 /clear 之后账本会重新开始；压缩后的留存按子串匹配判断，所以被改写过的内容会算作丢失。