# @adeildo/pi-compact 中文文档

规范地址：https://npmcn.com/package/%40adeildo/pi-compact/

版本：6\.0\.0
npm 元数据更新时间：2026-11-02T14:03:06.759Z
中文译文更新时间：2026-11-06T20:46:44.876Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adeildo/pi-compact
原文对照：https://npmcn.com/package/%40adeildo/pi-compact/?lang=original
项目主页：https://github.com/felipeadeildo/pi-harness/tree/main/packages/compact#readme
源码仓库：https://github.com/felipeadeildo/pi-harness

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：37.6 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-10-12T16:02:44.070Z
- 最新版本发布：2026-11-02T14:03:06.470Z
- 近 30 天下载量：2371（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

保持长 pi会话上下文小:隐藏旧工具输出,保持每次调用,使代理能够再次运行,从会话板上写出pi的收缩摘要.

## 安装

```sh
npm install @adeildo/pi-compact
```

也可以使用：`pnpm add @adeildo/pi-compact`、`yarn add @adeildo/pi-compact`、`bun add @adeildo/pi-compact`

## README

# @ adeildo/ pi- compact

[![npm](https://img.shields.io/npm/v/@adeildo/pi-compact)](https://www.npmjs.com/package/@adeildo/pi-compact) [![pi SDK](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Ffelipeadeildo%2Fpi-harness%2Fmain%2Fpackage.json&query=%24.devDependencies%5B%22%40earendil-works%2Fpi-coding-agent%22%5D&label=pi%20SDK&color=6E56CF)](https://pi.dev/)

在很长的会话中,每个请求都会再次发送整个上下文,大部分是代理不再需要的旧工具输出. 这个软件包隐藏了旧的输出,并保留了重要的东西:你的单词,代理的单词和决定. 在一周的真正的会议中,它削减了大约三分之一的成本.

`pi install npm:@adeildo/pi-compact`

## 它会做什么

当运行结束 超过 150k 上下文符号时, 每个工具输出比过去 10 个转弯更老, 成为一行命名它的调用 :

```text
Output hidden to save context, about 4.2k tokens. It came from: read src/view.ts. Run it again if you need it.
```

-   你的留言,代理的言语,错误和最后的10个转折保持完整.
-   后出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出.
-   当Pi紧凑时, 董事会和你的遗言 在摘要之上没有改变.

每个小猪在聊天时会留下一条线 与它保存的东西 `Ctrl+O` 列出隐藏的电话.

![After a tool call, the prune's line: 181 old tool outputs hidden, 705k to 250k tokens, and below it what the next request pays to rewrite the cache and in how many requests that pays back. Then pi's cache miss notice for that rewrite.](https://raw.githubusercontent.com/felipeadeildo/pi-harness/main/packages/compact/assets/prune.png)  
_一个prune的行, 而一个缓存重写它的费用 在下一个请求._

## 图标和设置

`/prune` 隐藏运行结束时的旧输出,无论上下文大小.

这些在契约制表 `Alt+S`,并储存在 `compact` 内 `~/.pi/agent/extensions/pi-harness/settings.json`。 。 。 .

| 设置 | 默认 | 它会做什么 |
| --- | --- | --- |
| 隐藏旧工具输出 | 打开 | 打开花圈 |
| 在Anthropic一边 | 关 | 在Anthropic模型上,Anthropic 清除了旧的输出而不是prune, 代理保持其思维 |
| 上层 | `150000` | 多少个上下文的标志必须结束 普鲁纳 |
| 从板上写出来 | 打开 | 将板子放在了皮的总结上,写在下面的模型上. 关机时,Pi使用会话模型 |
| 型号 | `auto` | 写总结的模型. `auto` 选一个最便宜的会话提供者 |

标签还显示此会话的 prunes 释放了哪些内容, 以及代理机要再次运行多少个隐藏输出 。 高分量意味着prune隐藏着代理商仍然需要的输出.

[如何运作](https://npmcn.com/package/%40adeildo/pi-compact/docs/how-it-works.md) 解释一个棱柱运行时,它为什么这样工作,Anthropic自己的空地,以及它是如何测量的.

[![adeildo.dev](https://adeildo.dev/assets/images/cat.svg)](https://adeildo.dev/)  
[鸡尾酒](https://github.com/felipeadeildo/pi-harness) 由 [adeildo.dev (英语)](https://adeildo.dev/)

## 常见问题

### @adeildo/pi-compact 是什么？

保持长 pi会话上下文小:隐藏旧工具输出,保持每次调用,使代理能够再次运行,从会话板上写出pi的收缩摘要\.

### 如何安装 @adeildo/pi-compact？

在项目目录运行 npm install @adeildo/pi-compact，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-ai（\*）、@earendil-works/pi-tui（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @adeildo/pi-compact 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adeildo\_\_pi-compact 是否存在。

### @adeildo/pi-compact 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adeildo/pi-compact 可以商用吗？

@adeildo/pi-compact 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adeildo/pi-compact 的下载量有多少？

根据 npm 官方下载统计，@adeildo/pi-compact 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,371 次，日均约 79 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adeildo/pi-compact 还在维护吗？

最新版本 6\.0\.0 发布于 2026/11/02（5 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/10/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。