企业官网建设流程全解析

PI-Desktop上下文使用检查器：一眼看清当前上下文占了多少

【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop

PI-Desktop 是一款本地优先的 AI 编程智能体桌面应用，内置的上下文使用检查器（Context Usage Inspector）能让你一眼看清当前会话的上下文窗口被占用了多少。它就是一个小小的圆环指示器：剩余多少 token、占了多少百分比、这一轮消耗了多少、哪些工具最"吃"上下文——点开即见，无需翻日志。

为什么需要上下文使用检查器

大模型的上下文窗口（Context Window）是有上限的：你发的消息、工具读取的文件内容、历史对话都会消耗 token。一旦占满，模型就会"失忆"或触发压缩。

PI-Desktop 的上下文使用检查器解决了三个问题：

• 一眼看到剩余量：圆环上的百分比随时显示当前上下文窗口的占用情况；
• 定位消耗来源：哪次模型请求用了多少输入/输出/缓存/推理 token，哪些工具调用最占空间；
• 及时预警：颜色随剩余空间变化，快满时一目了然。

💡 上下文窗口大小自动从模型目录解析；若所选模型不在目录中，则回退到提供商元数据，默认 128K。相关实现见 context-usage.ts。

在哪里找到它：输入栏上的小圆环

打开任意已有使用记录的会话，在输入框（Composer）右下角工具栏、模型选择器的左侧，你会看到一个带百分比的小圆环，比如44%。

使用方式只有三步：

1. 点击圆环（或键盘激活它）——面板以浮层形式弹出；
2. 读完数据，点击面板外任意位置或按Esc关闭；
3. 滚动对话、缩放窗口时，面板会自动避让、始终完整可见。

面板特意做成点击切换而非悬停弹出——因为读完这些数据需要一点时间，鼠标离开不应让它消失。组件源码位于 ContextUsageInspector.tsx，面板定位逻辑在 context-inspector-position.ts。

面板里有哪些数据

点开面板，从上到下一口气能看清：

两个小细节值得注意：

• 工具调用的 token 是估算值（提供商不返回逐工具的精确分摊），UI 上会明确标注，且不会累加进提供商的精确总量；
• 数字描述的是最近一次模型请求的快照，流式进行中的轮次不会"偷走"上一轮的统计。

三色预警：绿、橙、红各代表什么

圆环颜色跟的是剩余空间，与显示模式无关：

• 🟢剩余 > 25%：舒适区，放心继续；
• 🟠剩余 ≤ 25%：警告，建议适时总结、开新任务或让应用自动压缩；
• 🔴剩余 ≤ 10%：临界，上下文即将溢出。

哪怕你把显示模式改成"已用"，看到"已用 90%"也会显示为警告色——因为只剩 10% 了。颜色语义永远锚定在剩余空间上，不会误导。

偏好设置：显示"剩余"还是"已用"

默认情况下，圆环和面板都以**剩余（Remaining）**数字开头。如果你更习惯"我已经花了多少"的心智模型，可以去切换：

设置 → AI → Defaults → 上下文使用显示，提供剩余 / 已用两个分段选项。

切换后，圆环弧线、触发器百分比、面板标题、提示文本会全部同步翻转——"已用"模式下圆环随消耗而填满。

设计演进与延伸阅读

这个检查器经历了三轮演进，每一步都回答了真实使用中的痛点：

1. ADR 0047：从单一圆环升级为 Codex 风格检查器面板，加入工具级 token 估算与生成速度；
2. ADR 0184：从挂在最新一条助手消息下，搬到输入栏固定位置——对话滚远了也能随手查；
3. ADR 0223：新增"剩余/已用"显示偏好，颜色阈值始终锚定剩余空间。

长对话、多工具调用的编程会话里，随手瞄一眼这个小圆环，就能从容掌握上下文的使用节奏。

【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop