# ◌ pi-glance
**[Pi](https://github.com/earendil-works/pi) 的圆角编辑器与状态栏。**
[English](./README.md) · 简体中文
[](https://www.npmjs.com/package/pi-glance)
[](https://github.com/LinYS77/pi-glance/actions/workflows/ci.yml)
[](LICENSE)
[](https://pi.dev/packages/pi-glance)
## 安装
```bash
# 仅在当前会话试用
pi -e npm:pi-glance
# 或长期安装
pi install npm:pi-glance
```
重启 Pi，或执行 `/reload`。
## 功能
- **圆角编辑器** — 保留 Pi 原有的编辑、历史、自动补全和快捷键。
- **自适应状态栏** — Git · 费用 · 输出吞吐率 · 上下文 · Tokens · 扩展状态 · 模型。空间不足时，模型最后隐藏。
- **输入暂存** — `alt+s` 暂存提示词，再按恢复；输入框已有新内容时，两份内容交换。
- **Activity 状态** — 默认使用下边框文字；也可选择工作扫光、压缩／摘要倍率扫光和重试闪烁，调整速度、配色、倍率及闪烁频率。
- **22 套配色** — 分别选择亮色与暗色方案，实时预览。
无额外运行时依赖，不收集遥测数据。
### 输出吞吐率
`tok/s` 表示**平均输出吞吐率**，不是原始解码速度：供应商报告的总输出 tokens（包含推理和工具调用），除以各次请求的观测总耗时。输出已包含推理 tokens，不再扣除，也不重复相加。计时包含首包延迟与思考时间，排除工具执行、请求间等待和阻塞式 UI 提示。
Pi 会话层重试会排除失败请求及其退避等待；SDK 内部或上游重试仍可能包含在观测到的请求耗时中，无法可靠分离其等待时间。
`~` 表示当前运行中已完成请求的平均值，运行结束后成为最终值。新运行会清除旧速率；请求边界缺失、无法配对或计时／输出用量无效时显示未知，不按分块猜测 tokens，也不设置速度上限。
## 设置
运行 `/glance`，设置 **Appearance（外观）**、**Status line（状态栏）**、**Activity（活动状态）** 和 **Input（输入）**。`Tab` 切换分区，方向键调整，`S` 保存。
预览在设置下方按完整输入区宽度显示；关闭面板后保留输入内容和光标位置。
预览图使用示例数据。
## 说明
- 默认使用 Nerd Font 图标。使用普通字体时，可在 `/glance` → **Appearance** → **Icons** 中选择 `Plain`。
- 活动状态默认使用 **Text** 文字模式，可在 **Activity** 选择 **Sweep** 边框动效。
- Git 默认使用 **Summary**，显示变更文件数和已跟踪内容的增删行数。无变化时，本地轮询从 5 秒逐步延长到 30 秒，工具等活动会提前刷新；外部编辑通过轮询发现。**Auto fetch** 每 5 分钟更新上游，可在 **Status line → Git** 关闭。
- 草稿按会话保存在本机，重载后可取回，恢复后删除；`--no-session` 仅使用内存。
- **Extensions** 在顶部显示兼容插件发布的状态文字。可在 **Status line** 中开关、排序或查看详情；无状态时不占位。
- 其他编辑器或页脚扩展可能覆盖 Glance 的部分显示。
- 需要 Pi 1.0.0+、Node.js 22.19.0 或更高版本。
## 更新
```bash
pi update npm:pi-glance
```
## 参与贡献
欢迎提交 Issue 和 Pull Request。开发说明见 [CONTEXT.md](./CONTEXT.md)。
## 许可证
[MIT](LICENSE) © 2026 linys77