# @bismawy/pi-arnative 中文文档

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

版本：0\.9\.1
npm 元数据更新时间：2026-11-02T04:05:47.908Z
中文译文更新时间：2026-11-08T03:48:14.529Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：806 kB，43 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-09-26T11:19:30.165Z
- 最新版本发布：2026-11-02T04:05:47.719Z
- 近 30 天下载量：3465（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

被精炼的美学. 相会相器. 为 Pi. Warm 主题所建,圆形工具箱,制表头,紧凑脚印和/usage仪表板.

## 安装

```sh
npm install @bismawy/pi-arnative
```

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

## README

# 初始状态

被精炼的美学. 相会相器. 为皮所建.

[![Custom badge](https://shieldcn.dev/badge/pi-%20Packages.svg?variant=outline&size=xs&logo=ri%3APiPiBold)](https://pi.dev/packages/@bismawy/pi-arnative) [![badge](https://shieldcn.dev/npm/@bismawy/pi-arnative.svg?variant=outline&size=xs)](https://www.npmjs.com/package/@bismawy/pi-arnative) [![license](https://shieldcn.dev/github/bismawy/pi-arnative/license.svg?variant=outline&size=xs)](https://github.com/bismawy/pi-arnative)

![pi-arnative](https://raw.githubusercontent.com/bismawy/pi-arnative/main/assets/pi-arnative.webp)

## 概览

pi-arnative用统一的视觉界面来取代pi的默认终端铬.

-   温暖主题: 对比性检查 OKLCH 不漂移生成的调色板( )`arnative` 外加十变相.
-   标签页眉:显示目录、模型、背景、技能、扩展和快捷键的压缩框菜单.
-   圆形工具框:状态、自旋器、运行时间长度和可点击 `[show]` 编号 : `[hide]` 输出切换.
-   任务列表 : `todo` 工具,则, `/todos` 视图和编辑器上方的框式部件,在所有任务完成后自动按住 30 .
-   增强页脚: 三行状态网格(`Arnative (Full)`)或单相撞行(`Arnative (Minimal)`) 跟踪分支,diff,活性持续时间,和符号速度.
-   工作自旋器:18个动画预设,预览和可选 `[g]` 梯度扫描 .
-   转写时钟:有干净气泡背景的通訊时间戳.
-   用法盘:通过当地会议实时记号和成本跟踪 `/usage`。 。 。 .
-   自定义提供者: 交互式 `/providers` 向导以探测端点、选择模型、设定思维级别、编辑基准 URL、提供者 id 或 API 密钥,并保存 OpenAI-、Anthropic-、双子座或 Ollama 兼容频道到 `models.json` 财务报告和审定财务报表 `auth.json`。 。 。 .
-   模型治疗: 背景同步( E)`/model-heal`填补缺失的相通旗, `/models` 参数限制,以及已接受的推理努力水平 `models.json`。 。 。 .
-   自动压缩(Auto-compact):回合后自动上下文收缩,使用智能窗口分级或固定符号预算结算.

**配置预设( P)**

保存到 `~/.pi/agent/arnative/config.json` 通过 `/arnative`数字 :

-   **页眉和页脚 :** `Arnative (Full)` (违约), `Arnative (Minimal)` (仅脚;单击头文本或按) `ctrl+alt+m` 切换),或 `Pi (system)`。 。 。 .
-   **动画 :** 18个预设`Arnative` 默认, `Pi (system)`,和字母的变体). 新闻 `[g]` 切换谷歌梯度扫描.
-   **自动压缩 :** 默认关闭. **聪明** 相近于~200k令牌的电位(`≥768k→20%`, (中文(简体) ), `≥384k→40%`, (中文(简体) ), `≥192k→80%`, (中文(简体) ), `<192k→pi core`),或选择固定预算(`100k` 改为 `400k`) (中文(简体) ).
-   **模型治愈:** **满** (默认:离线相配旗, `GET /models` 以6h TTL为极限,以24h TTL为推理工作探测器, **旗帜** (仅下行),或 **关闭**。手编辑的字段永远不会被覆盖.
-   **任务列表( A)`todo`:** 每会话存储于 `~/.pi/agent/arnative/todos/<session-id>.json` (卸载) `@juicesharp/rpiv-todo` 首先避免工具名称冲突。 点击 `[click to expand]` 编号 : `[click to collapse]` 或新闻 `ctrl+alt+o` (单位:千美元)`alt+o`切换; 单击 `↑`编号 :`↓` 柜台或新闻机 `ctrl+alt+j`编号 :`k` (单位:千美元)`alt+j`编号 :`k`)为卷. 完成后自动追击30s(套) `PI_ARNATIVE_TODO_HIDE_MS` 要覆盖, `0` 用于立即隐藏; 正在扩展定时器 .

## 安装

```bash
pi install npm:@bismawy/pi-arnative
```

需要一个 [神经字型](https://www.nerdfonts.com/font-downloads)在新的安装上, `arnative` 如果没有设定主题,则自动应用;随时通过 `/arnative themes` 或者说 `/settings` → **主题**。 。 。 .

地方发展:

```bash
npm run dev                  # run pi against this checkout, nothing installed
npm run overlay              # copy extensions/ lib/ themes/ into the installed npm package
```

在发布前看到一个变化: `npm run overlay`,然后按 `/reload` 数字 在同一过程中重新评价扩展类型Script, 因此重新装入复制的代码时没有 重新安装, 不重新启动 。 软件包会保留 npm 安装; 此目录中没有任何 pi 点 。 A 类 此处删除的模块是从已安装的复制件中打印出来的(一个 stale 入口会继续加载),以及 `pi update --extensions` 在更高版本存在后恢复已发布的代码. `npm run overlay -- --dry-run` 列出将移动什么; `PI_CODING_AGENT_DIR` 目标另一个代理目录.

## 快捷键

| 密钥 (Linux / 胜利) | 行动 |
| --- | --- |
| `ctrl+alt+t` • 妇女 `alt+t` | 循环页眉标签 |
| `ctrl+alt+r` • 妇女 `alt+r` | 快速重装( E)`/reload`(中文(简体) ) |
| `ctrl+alt+n` • 妇女 `alt+n` | 新会 议`/new`(中文(简体) ) |
| `ctrl+alt+m` • 妇女 `alt+m` | 切换最小页脚 |
| `ctrl+alt+o` • 妇女 `alt+o` | 展开或崩溃任务列表 |
| `ctrl+alt+j` • 妇女 `alt+j` | 向下滚动任务列表 |
| `ctrl+alt+k` • 妇女 `alt+k` | 向上滚动任务列表 |
| 点击 `[show]` 编号 : `[hide]` • 妇女 `ctrl+o` | 切换工具输出框 |
| `←` 编号 : `Esc` | 退到父菜单/ 关闭活动屏幕 |
| `/arnative` | 设置菜单(主题、标题、页脚、动画、自动兼容、模型治愈、提供商、使用) |
| `/usage` | 托肯成本仪表板( C) |
| `/todos` | 完整任务列表重写 |
| `/providers` | 自定义提供者管理器 |
| `/model-heal` | 运行 `models.json` 愈合已经过去 |

**密钥绑定平台说明( P)**

捆绑 `app.session.new` 内 `~/.pi/agent/keybindings.json`数字 :

```json
{
  "app.session.new": ["ctrl+alt+n", "alt+n"]
}
```

-   **视窗/ WSL :** 窗口终端地图 `Ctrl+Alt` 改为 AltGr; 使用 `alt+…` 或禁用 `altGrAliasing`。 。 。 .
-   **马可斯:** 使用 `ctrl+option+…`。 。 。 .
-   **tmux / Herdr 代码 :** 设定 `PI_TUI_ESC_TIMEOUT=100` 若为 `Esc` 有延迟.

## 建筑

**扩展和组件**

| 文件 | 作用 |
| --- | --- |
| `extensions/arnative.ts` | `/arnative` 设置菜单和现场预览拾取器 |
| `extensions/section-headers.ts` | 标签页眉和资源框 |
| `extensions/footer.ts` | 三行状态网格, 最小页脚, 和框式编辑器 |
| `extensions/tools.ts` | 圆形工具箱、旋转器、持续时间和 `[show]` 编号 : `[hide]` 切换 |
| `extensions/todos.ts` | `todo` 工具,编辑器上方的框式部件,以及 `/todos` 屏幕 |
| `extensions/animations.ts` | Spinner 预设拾取器和活预览 |
| `extensions/autocompact.ts` | 智能和固定预算环境压缩 |
| `extensions/model-heal.ts` | 自动 `models.json` 愈合触发器和 `/model-heal` |
| `extensions/timestamps.ts` | 信息时间戳和气泡背景 |
| `extensions/ui-render-tweaks.ts` | 对比的扭矩、选择样式和UI抛光 |
| `extensions/usage.ts` | 托肯和成本仪表板(美元)`/usage`(中文(简体) ) |
| `lib/todos.ts` | 任务状态、窗口布局、框行和会话存储 |
| `lib/spinner.ts` | Spinner 预设目录、框架和梯度画家 |
| `lib/provider.ts` | 自定义提供者探测器、取型器和配置写入器 |
| `lib/model-heal.ts` | 相配的旗帜, `/models` 限制同步和推理努力探测器 |
| `lib/list-picker.ts` | 共享现场审查和多选取器组件 |

**主题变量和开发**

**主题`themes/gen-themes.mjs` + 键 `lib/color.ts`:** `arnative` • 妇女 `sun` • 妇女 `zinc` • 妇女 `violet` • 妇女 `emerald` • 妇女 `matrix` • 妇女 `cyberpunk` • 妇女 `synthwave` • 妇女 `gruvbox` • 妇女 `nord` • 妇女 `dracula`

```bash
npm test                              # Run self-checks and unit tests
npm run themes                        # Regenerate theme JSON files
npm run preview                       # Live preview in Pi and stamp .git/arnative-preview
git config core.hooksPath .githooks   # Enable pre-push preview verification hook
```

## 许可证

分发于 **麻省理工学院** 执照.

## 作者

[基准a](https://github.com/bismawy)

## 常见问题

### @bismawy/pi-arnative 是什么？

被精炼的美学\. 相会相器\. 为 Pi\. Warm 主题所建,圆形工具箱,制表头,紧凑脚印和/usage仪表板\.

### 如何安装 @bismawy/pi-arnative？

在项目目录运行 npm install @bismawy/pi-arnative，或使用 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 需要手动安装。

### @bismawy/pi-arnative 支持 TypeScript 吗？

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

### @bismawy/pi-arnative 支持 ESM 还是 CommonJS？

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

### @bismawy/pi-arnative 可以商用吗？

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

### @bismawy/pi-arnative 的下载量有多少？

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

### @bismawy/pi-arnative 还在维护吗？

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