跳到主要内容
Pi Desk

插件介绍

上下文管理

查看上下文占用,保留对话,少带旧过程。

同一段对话 · 发送给模型的内容保留对话,上下文更轻。
少带 76k
忽略前120k tokens
对话与文字结论24k
旧思考与工具结果正文80k
近期保留过程16k
忽略后44k tokens
对话与文字结论24k
简要工具记录4k
近期保留过程16k
减少旧过程占用
留出空间,继续对话
对话与文字结论保留历史工具结果可回查
两条占用条使用相同尺度。数值仅作示意,不代表固定节省比例。

上下文管理插件可以手动或自动忽略较早的思考和工具结果正文。你的消息与助手已经写出的文字继续保留,后续请求少带一些旧过程。

它是怎么工作的

聊天记录是保存下来的完整历史,上下文是这一次发送给模型的内容。插件在发送前处理上下文,不改写原始聊天记录。

聊天记录完整存档
用户消息
助手文字
思考 · 工具结果
上下文忽略插件整理发送副本
发送给模型精简副本
用户消息
助手文字
旧思考省略
read · 文件读取记录
思考 · 工具结果
工具记录 → 按需回查原始工具结果
忽略不会删除原始聊天记录保留省略 / 简化旧过程

较早的工具结果正文会换成简要调用记录,需要原始结果时,助手可以按需查回。近期过程按设置保留,已识别的 Skill 读取也会受到保护。

因此,它不只是把用量数字变小:你可以继续沿用已有要求和文字结论,又不必让模型每次都携带全部旧过程。忽略不是生成摘要的“压缩”,两种操作可以配合使用。

试一次上下文忽略

先安装插件 @jetcrab/pi-desk-ctx,并按安装完成后的提示加载。已有会话需要更新工具时,在空闲后执行“更多 → 重载 Pi 配置”。

从工作台打开要继续的会话,在输入框底部找到附件图标右侧的圆环。电脑上将鼠标移到圆环,手机上轻点圆环,即可展开用量详情。

跟着做一次 · 操作示意
从完整工作台开始,跟随光标找到入口 · 示例用量
  1. 查看用量:关注“可忽略”和“忽略后预计保留”,判断这次能腾出多少空间。
  2. 点击“忽略”:等待当前回复结束后操作;没有可忽略内容时,按钮不可用。
  3. 继续对话:占用更新后,正常发送下一条要求即可,不需要新建会话。

让它自动处理

打开 设置 → 插件设置 → 上下文忽略 → 过程忽略。开启“自动忽略过程”后,插件会在合适时机检查规则,满足条件时处理旧过程。

配置示意 · 400k 容量模型
上下文忽略自动忽略开
①模型上下文容量
≤400k400k–600k其他模型
②何时忽略
当前用量≥280k
且
忽略后预计≤50k
③保留最近的过程
对话与结论始终保留
最近对话轮数≤3轮
过程用量上限≤30k
高级设置收起
恢复推荐操作仅示意保存
①
按模型容量选配置400k 模型使用 ≤400k 档。k 表示 1,000 tokens。
②
两个条件同时满足当前 ≥280k,且忽略后预计 ≤50k 才触发。同一规则是“且”,多条规则是“或”。
③
轮数与预算共同限制最多保留最近 3 轮的过程,同时不超过 30k;并非保证完整保留 3 轮。

图中的规则表示:当前占用至少 280k,并且忽略后预计不超过 50k,才会触发。如果预计仍需保留 90k,这条规则不会执行。添加多条规则时,满足其中一条即可。

这里使用 400k 容量模型举例。请在第二层页签中按实际模型容量选择范围和调整阈值,不要将这一组数值直接用于所有模型。“默认”用于未匹配到其他范围的模型;页签右侧的“+”可添加范围,容量上限可在页签下方直接编辑。界面中的 1k = 1,000 tokens。

按需要调整

  • 想多保留近期细节:适当增加“最近对话轮数”和“过程用量上限”。两项共同生效;设置 3 轮,不代表这 3 轮的全部过程都会原样保留。
  • 任务进行中也需要整理:在当前范围底部启用“任务中记录进展”。达到设置用量并满足忽略条件后,插件会请助手先补充必要进展,再处理旧过程。
  • 需要限制图片总量:切换到“图片整理”页签,独立设置自动整理、触发大小和历史图片保留范围。它不受过程忽略开关控制。
  • 希望回到初始配置:点击“恢复推荐”并确认,检查后再点击“保存设置”。修改配置后,后续新一轮任务会读取新设置。

使用时记住

  • 占用是估算,不是账单。 “已忽略”也不是累计节省量;实际输入成本还受模型、缓存和计费方式影响。
  • 历史保留,不等于每次全部发送。 被忽略的旧过程不再自动进入后续请求;历史工具结果可按需查回,但没有“一键恢复全部上下文”的入口。