# @giladbarnea/pi-custom-footer 中文文档

规范地址：https://npmcn.com/package/%40giladbarnea/pi-custom-footer/

版本：0\.1\.16
npm 元数据更新时间：2026-11-15T12:08:09.070Z
中文译文更新时间：2026-11-16T08:54:57.489Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40giladbarnea/pi-custom-footer
原文对照：https://npmcn.com/package/%40giladbarnea/pi-custom-footer/?lang=original
项目主页：https://github.com/giladbarnea/custom-footer
源码仓库：https://github.com/giladbarnea/custom-footer

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

- 包体积（解压后）：75 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19\.0
- 运行依赖：0 个
- peer 依赖：@earendil-works/pi-ai \>=1\.4\.0，@earendil-works/pi-tui \>=1\.4\.0，@earendil-works/pi-coding-agent \>=1\.4\.0
- 首次发布：2026-09-06T07:27:30.754Z
- 最新版本发布：2026-11-15T12:08:08.765Z
- 近 30 天下载量：2563（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

上下文,缓存,成本, 和加载技能一览在皮.

## 安装

```sh
npm install @giladbarnea/pi-custom-footer
```

也可以使用：`pnpm add @giladbarnea/pi-custom-footer`、`yarn add @giladbarnea/pi-custom-footer`、`bun add @giladbarnea/pi-custom-footer`

## README

* * *

## 更新日期: 2026-11-15T13-19

# 自定义页脚

**了解还有多少背景。 看看每个转弯的成本.**

[![pi extension](https://img.shields.io/badge/pi-extension-blueviolet)](https://github.com/earendil-works/pi) [![npm](https://img.shields.io/npm/v/%40giladbarnea%2Fpi-custom-footer)](https://www.npmjs.com/package/@giladbarnea/pi-custom-footer) [![license](https://img.shields.io/github/license/giladbarnea/custom-footer)](https://npmcn.com/package/%40giladbarnea/pi-custom-footer/LICENSE)

一个 Pi 页脚, 将您的会话的背景、 缓存使用、 成本、 和装入的技能放在编辑器周围 .

**方便移动并优化多相机.** 它在电话上工作,键盘向上,在窄的tmux平板上,在宽的桌面上. 每一行都会先减少其最不重要的细节,所以你把重要的事实保留在任何大小上.

```sh
pi install npm:@giladbarnea/pi-custom-footer
```

支持Pi 1.4.x和1.5.x,最新的稳定未成年人及其前身.

在编辑器上方,请查看您的模型,思维级别,会话名称和ID. 被装入的技巧有自己的一行,有象征年龄. 压缩和上下文编辑删除已装入的文本已不再是逐字记录的技能 。 恢复文字恢复了技能. 当脚本输出带有读取逐字记录时,在代码脚本中读取的技能会计数. Pi不保留嵌入式读取结果,因此脚步将已读取的文字记录在一个自定义会话条目中,而这个条目从未发送到模型.

编辑下面,见:

-   **总体情况:** a 彩色分级仪表和使用/窗牌.
-   **整个对话的费用:** 累计费用和每个助理的平均费用.
-   **缓存行为 :** 会话命中率,当有空间时可重新使用会话符号(`97.6% session (38M reused)`),最后一条信息为 `hit 100%` 或者说 `miss 45%`。击中意味着90%以上的提示是从缓存读取的。 就像Pi自己的通知一样,重新开具缓存信使的出错显示了它的成本和原因:闲置的缺口或模型开关.
-   **缓存保持温暖多久:** `warm for 26m`,活:脚印每分钟重画一次. 它算到最近的三次:最后一个请求或缓存温暖加上模型的缓存寿命;皮自身闲置变暖的结束,当皮会刷新这个上下文;以及在这个皮会话中设定一个有pi-keep-cache-warm的最后期限. 一旦时间流逝,事实就会隐藏起来。 Pi的闲置变暖取决于Pi 1.5.1 及以后; 没有声明缓存寿命的模型,如OpenAI和Codex,都无所显示.
-   **你们在哪里** Git 分支、 脏标记、 目录和其他扩展状态信息 .
-   **订阅速度 :** 本周与目标比率相比的速度 `pace ━━━━●┊─── 1.07× ≤ target 1.18× · resets in 12h`少了空间,就读了 `pace ≤ target (1.18×)`,则 `pace ≤ 1.18×`。该标志将转向 `>` 当你超出预算时,点会通过时间标记。 超过30分钟的阅读会增加年龄,例如 `· 2h old`年龄超过节奏杆,在其余节奏之前。 可选: 仅当 a `quota` 缓存文件已存在 .

排版遵循您的 Pi 主题 。 头部和脚部各取能取去的行数最少. 为了适应,页脚会先去掉可选的再用脚趾后缀,再去掉其他细节或事实. 然后会去掉节奏栏和标签,圆形读取,去掉白空间,并去掉分支图标. 缓存时间会降低其标签( T)`26m`) (中文(简体) ). 击中或漏射会降低其百分比。 只有这样,页脚才会隐藏事实: `sub` 一个订阅的标记,一个呆滞的读取年龄, 速度读取与其重设的时间, 最后一个消息的平面 `hit` 或者说 `miss`,符号数,会话点击率,单词 `target`,缓存时间,并持续每个转弯的成本。 目标比率降至 `pace ≤ 1.18×`。缓存误差会提前放弃重新计费的符号。 它坚持其事业,直到这些事实的每一个都隐藏起来,并保持其代价到底。 最后,目标率只隐藏在它单独会添加一行的地方.

技能每过前6个终点站一行获得一行,最少1个. 21行的电话屏幕得到一行,27行的屏幕得到二,34行的屏幕得到三. 为了适应,行会先减少符号年龄,再减少分隔器,再缩短中间的长名(`caut…ctor`) (中文(简体) ). 只有这样,它才能隐藏技能 从结尾,背后 `+N` 数到最后一行的末尾.

**不重新扫描对话而调整大小 .** 页眉和页脚共享缓存值 。 会话更改刷新它们,包括叉和收缩.

技能年龄衡量自技能负载后首次响应以来的上下文增长. 缓存错过了镜像 Pi 本身的错账: 自上次请求或缓存时起, 符号重新开票, 其额外的缓存费用读取, 空闲时间 。 成本使用模型报告的价格,包括使用订阅时。 数字显示10以下有2个小数位,1个从10到100,没有100个.

节奏来自 `~/.cache/quota/provider-usage.json` (或低于 `XDG_CACHE_HOME`),作者的 `quota` 工具写入。 该工具尚未公开,没有文件,脚步没有速度。 阅读是用于会话模式的集合:克洛德,有线或可编码. 脚印只读那个文件。 它从不运行 `quota` 绝不取来。 颜色来自 `quota`绿地接近1.0×x, 冷却时, 有线电视会议显示.

## 发展

```sh
npm ci
npm test
npm run check
```

测试覆盖渲染值、技能跟踪、缓存再利用、会话变化、叉子、收缩和本地上下文编辑。 SDK测试使用本地脚本提供者,没有外部模型调用.

## 常见问题

### @giladbarnea/pi-custom-footer 是什么？

上下文,缓存,成本, 和加载技能一览在皮\.

### 如何安装 @giladbarnea/pi-custom-footer？

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

### @giladbarnea/pi-custom-footer 支持 TypeScript 吗？

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

### @giladbarnea/pi-custom-footer 支持 ESM 还是 CommonJS？

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

### @giladbarnea/pi-custom-footer 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @giladbarnea/pi-custom-footer 可以商用吗？

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

### @giladbarnea/pi-custom-footer 的下载量有多少？

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

### @giladbarnea/pi-custom-footer 还在维护吗？

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

