omp packages

pi-lazy-panel0.2.1

A lazygit-style TUI for browsing, resuming and managing pi sessions (/lazy-panel)

jiajiecheng Published 23 hours ago MIT ~1.4K downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

English | 中文

简介

pi-lazy-panel 是 pi 会话和会话树管理的面板，提供类似于 lazygit 的操作方式和 TUI 风格。安装后在 pi 中执行 /lazy-panel，即可打开一个占满终端的三面板界面：

  • 左上 SESSIONS：历史会话列表（对应 /resume）
  • 左下 TREE：当前所选会话的对话树（对应 /tree，随上方选择自动切换）
  • 右侧 CONTENT：所选节点的对话详情，用 pi 原生 Markdown 渲染，区分「我」和「AI」

围绕会话的常用操作（新建 / 恢复 / 分叉 / 克隆 / 改名 / 删除 / 压缩 / 导出 / 导入 / 分享 / 复制）都收敛成单键快捷键，全程无需鼠标。

按 , 打开内置的设置面板：常规（语言、默认范围、默认排序）、布局（左侧栏宽度）、快捷键（按作用域，直接按下想绑的键来录入）、主题（切 pi 自己的主题）。每一处改动立即生效并写回 ~/.pi/agent/lazy-panel.json，不需要手写 JSON。

界面预览

pi-lazy-panel 界面预览

特点

  1. 纯粹的键盘流，大部分的操作使用一个键就能完成（hjkl 移动、d 删除、r 改名，参考 lazygit）
  2. 三面板联动：SESSIONS → TREE → CONTENT 随光标自动级联刷新
  3. 覆盖全套会话命令：resume / new / fork / clone / rename / delete / compact / export / import / share / copy
  4. 会话树导航：可恢复到任意节点，并选择「不摘要 / 摘要 / 自定义摘要」处理被放弃的分支
  5. lazygit 风格搜索：/ 就地跳转、n / N 循环，支持 name: model: path: tag: role: after: before: 限定词
  6. 主题跟随 pi 自动切换——设置页直接切 pi 自己的主题，内置主题和 ~/.pi/agent/themes/ 下的自定义主题都在列表里
  7. 支持中英文（跟随系统语言，可在配置里覆盖）
  8. 快捷键完全可自定义：在设置页里改，或直接改 ~/.pi/agent/lazy-panel.json
  9. 鼠标轻量适配（滚轮滚动、单击聚焦、双击进入 / 折叠）
  10. 内置设置面板（,）：常规 / 布局 / 快捷键 / 主题四类就地编辑，快捷键靠按键录入，会被按键冲突挡在写入之前，改一处立刻落盘一处

快速开始

需要已安装 pi，在 pi 中执行安装命令：

# npm
pi install npm:pi-lazy-panel

# GitHub
pi install git:github.com/JessieChan0730/pi-lazy-panel

安装后在 pi 里执行 /lazy-panel 打开面板，? 可查看当前面板的全部快捷键，, 打开设置页。

本地开发

pi 相关的包是 devDependencies，克隆后必须先安装依赖：

npm install            # 安装依赖（含 pi 相关包，默认不会自动装）
npm run dev            # 用 pi -e ./src/index.ts 临时加载插件，不写配置
npm run install:pi     # pi install . 把本目录注册进 pi，只需一次；改完代码在 pi 里 /reload 即最新

提交前请跑全部检查（与 pre-push 钩子一致）：

npm run lint           # ESLint
npm run check          # tsc --noEmit
npm test               # 单元测试
npm run i18n:check     # 中英文案对齐

兼容性

  • 运行环境：Node.js ≥ 20。
  • pi 版本：作为 pi 插件运行，依赖 pi 的会话 API（@earendil-works/pi-coding-agent）。
  • 运行模式：仅在 pi 的 TUI 模式下可用（非 TUI 模式下 /lazy-panel 会拒绝打开）。
  • 操作系统：跨平台，Windows / macOS / Linux 均可（路径按平台统一处理）。
  • 终端：regular 模式下的鼠标支持需要终端支持 SGR 鼠标上报（现代终端基本都支持）；不支持也不影响键盘操作。
  • 可选外部命令：/share 需要已登录的 GitHub CLI（gh）；删除会话时若存在 trash 则移入回收站，否则直接删除。

配置文件

配置文件位于 ~/.pi/agent/lazy-panel.json，所有字段均为可选，缺省时使用内置默认值：

{
 "locale": "zh",
 "defaultScope": "all",
 "defaultSort": "recent",
 "leftColumnRatio": 0.25,
 "keymap": {
  "global": { "help": "F1", "scope-all": ["A", "ctrl+space"] },
  "sessions": { "session-delete": "ctrl+d", "session-share": null }
 }
}
字段 说明 可选值 / 范围 默认
locale UI 语言 "en" / "zh" 跟随系统语言
defaultScope 打开时的会话范围 "current-folder" / "all" "current-folder"
defaultSort 会话列表排序 "recent" / "created" / "title" / "threaded" "recent"
leftColumnRatio 左侧列宽占比 0.15 ~ 0.6 0.25
keymap 自定义快捷键 见下 内置键位

keymap 按 scope（global / sessions / tree / content / tree-dialog）分组，键为动作 id、值为一个或多个 chord（如 "ctrl+d"、["A", "ctrl+space"]）；用户提供的键位整体替换该动作的默认值，null 表示解绑。完整的动作 id 与键位说明见 docs/keybindings.zh.md。

设置页（,）改的就是这个文件：只改动过的字段，其余内容（含缩进、行尾）原样保留；其他窗口的不相交修改会自动合并，同字段冲突时停下写入并提供重试。

下一步计划

0.2.0 加上了设置面板；0.2.x 系列用来修问题、打磨和代码优化，不加新功能。

两个已知的显示问题仍未解决：关掉 ? 后马上切面板会闪一帧残影；pi 处于 regular（主屏）模式时，会话很长会把面板顶部截断——后者用 pi --tui-mode fullscreen（或 pi 的 settings.json 里 "tuiMode": "fullscreen"）可以避开。

贡献

欢迎贡献代码——本地环境、代码规范与提交 / PR 流程见 CONTRIBUTING.zh.md。

License

基于 MIT 许可证授权。