Verboo Code 的 /context：如何查看是什么占满了上下文

智能体开始忘记你们约定过的事，回复变慢，而你分不清原因是对话太长、某个 MCP 太重，还是 AGENTS.md 写得太长。Verboo Code 的 /context 用一条命令回答这个问题：它按类别显示上下文窗口用了多少、被什么占用。本指南说明如何阅读输出，以及每一行该怎么处理。

/context 在 Verboo Code 中显示什么？

一个彩色网格，显示当前上下文窗口的用量、以 token 和百分比表示的总量，以及占用这些空间的内容列表。源码中的命令描述原文是："Visualize current context usage as a colored grid"。

/context

第一行显示模型和总量，格式为 模型 · 已用/窗口 tokens (N%)。下面是 Estimated usage by category 区块，然后是每个来源的明细：MCP、智能体、指令文件和技能。

这个数字是模型实际收到的内容，而不是屏幕上的原始历史。计数之前，命令会执行 CLI 调用 API 前的同样处理：丢弃最后一次压缩之前的内容，并缩减旧的工具结果。所以总量可能比对话看起来要小。

每个类别是什么意思？

每一行都是一个 token 来源。有些你可以直接控制，有些不行。下表列出屏幕上显示的原始名称以及在哪里调整：

类别	含义	在哪里调整
System prompt	CLI 的基础指令	日常无法调整
System tools	内置工具的定义（读取、编辑、运行命令）	日常无法调整
MCP tools	已连接 MCP 服务器的工具	/mcp
Custom agents	可用的自定义智能体	/agents
Memory files	已加载的 AGENTS.md、CLAUDE.md 和规则	/memory
Skills	已安装技能的头部信息	/skills
Messages	对话本身：你的消息、回复和工具结果	/compact 或 /clear
Autocompact buffer	为自动压缩预留的余量	/config（Auto-compact）
Free space	剩余可用空间	无需处理

Skills 及以上都是固定开销：每次调用都会带上，哪怕你还没输入第一条消息。Messages 则会随会话增长。

为什么有些行显示 N/A？

这是 MCP tools (deferred) 和 System tools (deferred) 两个类别。启用工具搜索后，这些工具不会放进上下文，只有智能体需要时才加载。/context 会显示它们的大小供你参考，但不计入总量，所以百分比显示为 N/A。在 MCP 明细中，标题会变成 MCP tools · /mcp (loaded on-demand)，列表分为 Loaded 和 Available。

Autocompact buffer 是什么？

它是预留空间，不是已用空间。开启 Auto-compact 时，用量接近这段余量时 Verboo Code 会自动压缩对话，网格显示这段预留，让你看到离触发还有多远。关闭 Auto-compact 时，这一行变成 Compact buffer，是一段较小的预留，确保手动 /compact 有空间运行。

如何找出占用最多的内容？

先看最大的固定类别。它每次调用都会发送，所以在这里削减比压缩对话收益更大。在类别区块下方，/context 会列出每一项及其开销：

Memory files · /memory
└ AGENTS.md: 6.2k tokens
└ docs/architecture.md: 4.8k tokens

上面的数字仅作示例，但格式来自源码：每个区块的标题旁都写着管理该来源的命令。如果最大的数字来自 AGENTS.md 中用 @ 导入的文件，就去掉这个导入，只保留智能体不读就会出错的内容。如果是本项目用不到的 MCP 服务器，就在 /mcp 中关闭它。

/context 末尾的提示是什么意思？

命令最后会根据会话数据给出建议。只有超过源码中定义的阈值时才会出现：

提示	出现条件	怎么做
Context is N% full	用量达到 80% 或以上	立即运行 /compact，说明要保留什么
Bash results using ... tokens	命令输出超过窗口的 15% 且超过 1 万 token	让它用 head、tail 或 grep 过滤
Read results using ... tokens 或 File reads using ... tokens	文件读取超过窗口的 15%（或读取结果超过 5%），且都超过 1 万 token	只读需要的部分，不要重复读取整个文件
Memory files using ... tokens	指令文件超过窗口的 5% 且超过 5 千 token	用 /memory 精简
Autocompact is disabled	Auto-compact 关闭且用量在 50% 到 80% 之间	在 /config 中开启，或手动压缩

80% 的提示取决于你的设置。开启 Auto-compact 时，它提醒自动压缩即将触发并丢弃较早的消息，建议先运行 /compact，由你决定保留什么。关闭时，它建议运行 /compact 或在 /config 中重新开启。

读完 /context 后如何释放上下文？

按流程图的顺序：先处理固定开销，再处理对话。

1. 削减固定开销。用 /memory 精简指令，用 /mcp 关闭不用的服务器，用 /skills 检查技能。
2. 当 Messages 占大头时，总结对话，并说明哪些不能丢：

   /compact 保留已修改的文件列表，以及继续使用 API v1 的决定

3. 如果下一个任务和之前无关，用 /clear 重新开始。指令文件仍在磁盘上，会被重新读取。

最后再运行一次 /context，确认释放了多少。压缩的完整步骤和 Auto-compact 的环境变量，见 Verboo Code 中的 /compact 指南。

不打开会话也能查看上下文用量吗？

可以。在非交互模式下，/context 会以 Markdown 表格的文本形式返回同样的统计，而不是彩色网格：

verboo -p "/context"

要查看当前目录最近一次对话的用量，加上 -c，它会继续上一次会话：

verboo -c -p "/context"

输出以 ## Context Usage 开头，包含 **Model:** 和 **Tokens:** 两行，然后是按类别、MCP、智能体、指令文件和技能分列的表格。这是纯文本，可以保存到文件中，对比修改 AGENTS.md 前后的固定开销。

它和其他命令如何配合？

• /memory 用来编辑 Memory files 中列出的文件。
• MCP 指南 介绍如何添加和移除 MCP tools 中列出的服务器。
• /plan 让你少走弯路地进入编码，避免 Messages 迅速膨胀。