@bismawy/pi-arnative

中文文档
0.9.1发布于 2026/11/02MITES Module零依赖近 30 天下载 3465

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

中文使用文档
文档目录6 节
  1. 概览
  2. 安装
  3. 快捷键
  4. 建筑
  5. 许可证
  6. 作者

初始状态

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

Custom badge badge license

pi-arnative

概览

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 用于立即隐藏; 正在扩展定时器 .

安装

pi install npm:@bismawy/pi-arnative

需要一个 神经字型在新的安装上, arnative 如果没有设定主题,则自动应用;随时通过 /arnative themes 或者说 /settings → 主题。 。 。 .

地方发展:

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数字 :

{
  "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.tstodo 工具,编辑器上方的框式部件,以及 /todos 屏幕
extensions/animations.tsSpinner 预设拾取器和活预览
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.tsSpinner 预设目录、框架和梯度画家
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

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

版本与发布记录

@bismawy/pi-arnative 共发布 39 个版本,首次发布于 2026/09/26;过去 12 个月发布了 39 个版本。

版本发布日期距今
0.9.1latest2026/11/026 天前
0.9.02026/10/318 天前
0.8.22026/10/2811 天前
0.8.12026/10/2612 天前
0.8.02026/10/2613 天前
0.8.0-rc.1next2026/10/2513 天前

关于 @bismawy/pi-arnative 的常见问题

@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 和提交记录判断。