插件核心功能：可视化Agent输入侧上下文

大家好，我是小木头。在Pi Agent中安装了插件、添加了Skill以及项目规则后，你是否清楚模型收到的系统提示词和工具说明具体包含哪些内容？明确区分直接加入的内容与需读取文件后才进入上下文的数据，是调试Agent的关键。本期视频将介绍一款名为Pi Context View的流行插件，帮助开发者在Pi Agent中查看这些隐藏内容。该插件主要用于检查配置并验证数据是否按预期工作，特别适合经常调整插件、Skill或自行开发扩展的用户。通过它，你可以查看模型接收到的指令和工具定义，确保Agent的行为符合设计初衷。

安装与基础操作：从终端到上下文视图

要使用Pi Context View，首先需要在终端输入安装命令并等待完成。本次演示基于0.8.0版本，要求Pi为1.3或更新版本。安装成功后启动Pi，若会话已开启，需先执行/reload重新加载扩展，再输入/context打开上下文视图。该插件提供两个主要入口：Usage用于展示上下文的分类和估算占用情况，Injections则展开系统提示词、工具定义及扩展加入的内容。有些变化仅发生在发给模型的请求中，平时聊天时无法直接看到。例如，确认工具参数、项目规则是否出现在系统提示词中，或追溯某段指令的来源时，展开相应内容即可获取输入侧的检查依据。

上下文组成解析：系统指令、工具与动态数据

在上下文中，不同来源的内容被清晰分类。系统指令和项目规则告诉Agent如何工作及遵守的要求；工具定义说明有哪些工具、能做什么及接收的参数。在任务进行中，对话历史、工具调用和返回结果会持续加入上下文。此外，读取文件带入正文，搜索代码带入匹配结果，运行测试带入日志或测试结果。部分历史可能被整理成摘要供后续使用。聊天窗口只能看到部分内容，而系统提示词、工具说明和扩展临时加入的内容通常需借助此插件检查。以新增指令和工具的插件为例，新增系统指令归入系统提示词分类，新增工具的名称、说明和参数则归入工具定义分类。

插件调试技巧：对比安装前后与检查Skill读取状态

为了确认插件提供的指令和工具是否生效，建议在安装插件前后各开一个新会话，保持Pi版本、模型、项目和原有工具一致。展开系统提示词和工具定义后对比，可清晰看到新增内容。值得注意的是，Pi Context View作为界面插件自身不主动增加模型上下文。在检查Skill时，需分别查看列表和已读取的正文。样本中模型先收到名称、描述和路径，知道Skill文件位置。右侧文件仍在本地时正文未被读取；当Agent使用read工具后，返回的内容作为工具结果加入左侧上下文列表。仅看到名称不代表整份文件已读入，必须确认正文是否出现在列表中。

项目规则验证与工具输出检查：区分定义与结果

项目规则的验证同样需要细致操作。先展开系统提示词找到对应内容，再搜索一句你写过的要求或需求，确认其是否出现在当前可查看的提示词中。若要查看读文件、搜索或测试等操作在上下文中增加了什么，需在Usage中展开Tool Output。这里是工具返回的内容，与说明工具怎么用的“工具定义”是不同的部分。检查这两处可以分别确认规则和工具结果是否进入上下文以及如何影响它。当内容较多时，可直接在Injections中按名称筛选，如搜索“read”打开工具定义，再搜“limit”查看限制读取行数的参数说明。知道名称时可按名搜索；仅记得指令或参数片段时，可切换到基于内容的搜索。

实战案例：优化文件读取以节省上下文窗口

通过插件发现，有时Agent会完整读取大文件导致返回大量字符。例如，从600行配置样本中找2个值时，完整读取返回36,000多个字符。通过插件观察发现这是全量读取。优化策略是让Agent先搜索位置，再读取附近内容。调整后合计返回仅397个字符，2个目标值依然保留。这样能有效节省上下文窗口。具体读取逻辑需由用户指导Agent。Pi本身支持自动压缩历史或手动执行/compact。正常工作时可继续使用原生压缩，想了解压缩后模型还能看到什么，需打开Compacted Data和保留的消息。展开后可查看摘要内容、分类数字及保留的待办事项等。

数据估算与局限性：字符数非费用，观察非因果

上下文内容的分类数字主要根据字符数等方法来估算，适合比较组成和查找内容。实际费用则要看服务的用量记录。此外，扩展的加载顺序会影响部分变化是否可见。检查到某条指令只能确认它出现在可观察的内容中，不能单凭此解释模型为什么做出某个决定。你可以先选定具体问题（如项目规则是否加入、工具有哪些参数、Skill正文是否读入），找到对应分类搜索并展开内容，再决定是否调整配置。Pi Context View的价值在于让这些平时不容易看见的输入变得可以检查，为配置和调试Agent提供依据。如果内容对你有帮助，欢迎点赞投币收藏。

结论

Pi Context View插件通过可视化Agent的输入侧上下文，解决了系统提示词、工具定义及动态数据（如Skill读取结果）不可见的问题。它提供了Usage和Injections两个入口，支持按名称或内容搜索，并能对比安装前后的差异。用户可利用它验证项目规则、检查工具参数及优化文件读取策略（如先搜索后局部读取以节省Token）。尽管其估算数据基于字符数而非实际费用，且观察到的内容不能直接解释模型决策因果，但它仍是调试Agent配置、确保指令按预期生效的重要工具。