# @juanbenjumea/pi-dynamic-footer 中文文档

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

版本：0\.1\.11
npm 元数据更新时间：2026-11-01T12:02:22.700Z
中文译文更新时间：2026-11-01T14:44:19.702Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：79.4 kB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \>=0\.80\.0
- 首次发布：2026-07-22T21:56:51.212Z
- 最新版本发布：2026-11-01T12:02:22.321Z
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

动态配置页脚的pi与实时观察：上下文测量，TPS，令牌/成本跟踪，订阅使用栏，git状态，和一个完整的设置UI。

## 安装

```sh
npm install @juanbenjumea/pi-dynamic-footer
```

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

## README

# pi-dynamic-footer

一个可配置的活动页脚 [π](https://github.com/earendil-works/pi)． 它将pi的默认页脚替换为上下文使用、模型/思维水平、TPS、令牌和成本跟踪、缓存比率、git状态和订阅配额条。

## 安装

```bash
pi install npm:@juanbenjumea/pi-dynamic-footer
```

## 命令

| 命令 | 行动 |
| --- | --- |
| `/footer` 或者 `/footer menu` | 打开页脚操作菜单 |
| `/footer toggle` | 显示或隐藏页脚 |
| `/footer path` | 切换文件夹名称或完整路径 |
| `/footer settings` | 配置段、预设和上下文区域 |

该页脚在默认情况下是启用的，并取代pi的默认页脚。它通过首先丢弃低优先级的段来适应窄终端。

## 配额酒吧

当提供程序凭据可用时，将显示配额栏。支持供应商:

-   克劳德/克劳德·马克斯
-   OpenAI法典
-   OpenCode去
-   ClinePass
-   乌曼
-   GitHub副驾驶员
-   谷歌双子座
-   乔任梁编码
-   合成
-   z.ai / GLM
-   光标
-   CommandCode
-   Openference

API密钥通常来自pi `auth.json`;提供程序还支持其文档化的环境变量。游标和CommandCode订阅的使用需要一个浏览器会话cookie `quota-sessions.json`，而不是API密钥。OpenCode Go帐户轮换由 [`@juanbenjumea/pi-multi-opencode-go`](https://www.npmjs.com/package/@juanbenjumea/pi-multi-opencode-go).

## 配置

使用 `/footer settings` 要配置这些段：

`modelThink`， `provider`， `runtime`， `pwd`， `git`， `contextUsage`， `contextProgress`， `contextPercentage`， `contextNumbers`， `tokens`， `tps`， `cost`， `cache`， `turnCount`, `usageBars`.

预设:

-   **最小的** -模型和基本上下文信息
-   **标准** -平衡默认布局
-   **详细的** -所有段，包括TPS和转弯数
-   **表演** -模型，环境，TPS和成本

背景阈值默认为70%（专家）和85%（警告）。专家阈值不能超过警告阈值。

集 `PI_OBS_SHOW_FULL_PATH=1` 首先启用完整的home-relative工作目录路径。

## 开发

```bash
npm test
npm run typecheck
```

## 隐私

使用情况数据保存在内存中，不写入磁盘。下只存储页脚设置 `~/.pi/agent/observability/` (或 `$PI_CODING_AGENT_DIR/observability/`）. 经过身份验证的请求使用固定的HTTPS提供程序端点。

## 许可证

麻省理工学院

## 常见问题

### @juanbenjumea/pi-dynamic-footer 是什么？

动态配置页脚的pi与实时观察：上下文测量，TPS，令牌/成本跟踪，订阅使用栏，git状态，和一个完整的设置UI。

### 如何安装 @juanbenjumea/pi-dynamic-footer？

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

### @juanbenjumea/pi-dynamic-footer 支持 TypeScript 吗？

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

### @juanbenjumea/pi-dynamic-footer 支持 ESM 还是 CommonJS？

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

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

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

### @juanbenjumea/pi-dynamic-footer 可以商用吗？

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

### @juanbenjumea/pi-dynamic-footer 还在维护吗？

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