pi-session-peek 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.2
+
+- Wheel over the list now scrolls the list like a scrollbar instead of moving the selection. The selection stays where it is and comes back into view on `↑` / `↓`, a click, a new filter or a delete.
+- Search: plain terms no longer match the working directory, only the conversation and the session name. With the current-directory scope every session shares the same path prefix, so a word from the path used to match all of them. Use `dir:` (or `cwd:`) to search paths.
+- Internal: the picker component is split into `preview`, `list` and `drag-select` modules, escape-sequence helpers are consolidated in `ansi.ts`, and the theme is typed against pi's `Theme`. No behaviour change.
+
 ## 0.5.1
 
 - Terminal escape sequences and control characters in message text, tool arguments and session names are stripped when parsing, so a pasted colour dump or an OSC sequence in a reply can no longer break the preview layout or reach the terminal.

package/README.md

@@ -12,7 +12,7 @@ Search your [pi](https://pi.dev) session history by what was actually said, read
 
 - Opens a two-pane picker with `/peek` or `/peek <keyword>`: sessions on the left, the full conversation on the right.
 - Renders the conversation with pi's own Markdown renderer, so headings, code blocks with syntax highlighting, tables and lists look the same as in the main transcript.
-- Filters as you type across conversation text, session name and working directory. Tool call arguments and results are excluded from the search, so a keyword only matches sessions that actually discussed it.
+- Filters as you type across conversation text and session name. The working directory is searched only with an explicit `dir:`, so a word from a project path does not match every session in that project. Tool call arguments and results are excluded from the search, so a keyword only matches sessions that actually discussed it.
 - Requires every space-separated keyword to match, and shows a snippet around the first hit in the list.
 - Understands `"exact phrases"`, `either|or`, `-exclude`, `name:` / `dir:` / `user:` / `ai:` prefixes and `/regex/`.
 - Limits results to recently active sessions with `@7d`, `@24h`, `@2w` or `@1m`.
@@ -80,7 +80,7 @@ In TUI mode, run `/peek` and start typing. Press `Enter` on a session to continu
 | --- | --- |
 | Click a session in the list | Select it |
 | Double-click a session | Resume it (same as `Enter`) |
-| Wheel over the list | Move the selection |
+| Wheel over the list | Scroll the list like a scrollbar; the selection stays where it is. `↑` `↓`, a click or a new filter bring it back into view. |
 | Wheel over the preview | Scroll the preview three lines per notch (`Alt` for five times faster) |
 | Click the scope label in the header | Toggle current directory tree ↔ all projects (same as `Tab`) |
 | Click the search box or the rename line | Move the cursor |
@@ -98,7 +98,7 @@ The filter is case-insensitive and matches anywhere in the text. Whitespace sepa
 | `token undefined` | Sessions containing both `token` and `undefined`, in any order and any message |
 | `"token undefined"` | The exact phrase. Whitespace inside the quotes matches any run of whitespace, including a line break. |
 | `vue\|react` | Sessions containing `vue` or `react` |
-| `-draft` | Sessions that do not contain `draft` anywhere (messages, name or directory) |
+| `-draft` | Sessions that do not contain `draft` in any message or in the session name |
 | `name:auth` | Session name only. `dir:` or `cwd:` for the working directory. |
 | `user:deploy` | Only the messages you wrote. `ai:` or `assistant:` for the replies. |
 | `/\bfoo\d+\b/` | JavaScript regular expression, case-insensitive, `^` and `$` match line boundaries. Use `\s` instead of a space. |
@@ -107,7 +107,7 @@ The filter is case-insensitive and matches anywhere in the text. Whitespace sepa
 
 Quotes are the escape hatch: `"-foo"`, `"a|b"`, `"name:x"` and `"/x/"` search for those characters literally. A regex that fails to compile is searched as plain text. Only positive terms are highlighted in the preview, and `name:` / `dir:` terms never touch the conversation, so `name:auth` alone shows the full conversation with no highlights.
 
-The search index holds user and assistant messages, the session name and the working directory. It does not hold tool call arguments or tool results, and the tool lines shown by `Ctrl+T` are never matched or highlighted.
+The search index holds user and assistant messages and the session name. The working directory is matched only by `dir:` / `cwd:` terms: with the current-directory scope every session shares the same path prefix, so a plain word from the path would match all of them. The index does not hold tool call arguments or tool results, and the tool lines shown by `Ctrl+T` are never matched or highlighted.
 
 ## 🌐 Language
 
@@ -134,13 +134,19 @@ On Windows PowerShell: `$env:PI_SESSION_PEEK_LANG = "en"` before starting pi. Th
 
 ```text
 pi-session-peek/
-├── index.ts                 # Registers /peek and the startup flags, injects delete / rename / fork
+├── index.ts                 # Registers /peek and the startup flags, injects delete / rename / fork / copy
 ├── src/
-│   ├── peek-component.ts    # The two-pane TUI component
+│   ├── peek-component.ts    # The two-pane component: state, key and mouse routing, header / footer, pane composition
+│   ├── preview.ts           # Right pane: preview lines and hit lines for a session, initial offset, Ctrl+N/P targets
+│   ├── list.ts              # Left pane: two rows per session, viewport following
+│   ├── drag-select.ts       # Drag-selection state machine: press / drag / release / auto-scroll
+│   ├── selection.ts         # Selection geometry: ranges, inverse-video highlight, text extraction
+│   ├── layout.ts            # Pane widths and body height
 │   ├── sessions.ts          # Scans and parses session JSONL, rename / delete helpers
-│   ├── query.ts             # Query parsing, highlighting, hit snippets
+│   ├── query.ts             # Query parsing, matching, highlighting, hit snippets
 │   ├── mouse.ts             # Mouse reporting for pi's regular (non-fullscreen) mode
-│   ├── selection.ts         # Pane-confined drag selection: ranges, highlight, text extraction
+│   ├── ansi.ts              # Escape-sequence tokenising, SGR tracking, input sanitising
+│   ├── theme.ts             # The subset of pi's Theme the picker uses
 │   ├── i18n.ts              # Chinese / English UI strings and locale detection
 │   └── text.ts              # Path, time and width helpers
 ├── scripts/screenshot.mjs   # Optional: renders a synthetic screenshot from component output

package/README.zh-CN.md

@@ -12,7 +12,7 @@
 
 - `/peek` 或 `/peek 关键词` 打开左右分栏的选择器：左边是会话列表，右边是完整对话。
 - 右栏用 pi 自己的 Markdown 渲染器画，标题、带语法高亮的代码块、表格、列表和主界面里的对话一个样子。
-- 边打字边过滤，搜的是对话正文、会话名和工作目录。工具调用的参数和结果不进搜索索引，所以只会命中真正讨论过这个词的会话。
+- 边打字边过滤，搜的是对话正文和会话名。工作目录只在显式写 `dir:` 时才搜，项目路径里的词不会把整个项目的会话都命中。工具调用的参数和结果不进搜索索引，所以只会命中真正讨论过这个词的会话。
 - 空格分隔多个关键词，全部命中才显示；列表里直接显示第一个命中处的片段。
 - 支持 `"精确短语"`、`a|b` 任一命中、`-排除`、`name:` / `dir:` / `user:` / `ai:` 限定范围，以及 `/正则/`。
 - `@7d`、`@24h`、`@2w`、`@1m` 只看最近活动过的会话。
@@ -80,7 +80,7 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 | --- | --- |
 | 点列表里的会话 | 选中 |
 | 双击会话 | 进入，和 `Enter` 一样 |
-| 在列表上滚滚轮 | 换选中项 |
+| 在列表上滚滚轮 | 像滚动条一样滚列表，选中项不变；`↑` `↓`、点击或改过滤词会把选中项带回视野 |
 | 在预览上滚滚轮 | 预览每格滚三行，按住 `Alt` 快五倍 |
 | 点头部的范围字样 | 当前目录树 ↔ 全部项目，和 `Tab` 一样 |
 | 点搜索框或改名行 | 移动光标 |
@@ -98,7 +98,7 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 | `token undefined` | 同时包含 `token` 和 `undefined` 的会话，顺序不限，可以在不同的消息里 |
 | `"token undefined"` | 精确短语。引号里的空白可以匹配正文里的任意一段空白，包括换行 |
 | `vue\|react` | 包含 `vue` 或 `react` 的会话 |
-| `-draft` | 哪里都不含 `draft` 的会话（消息、会话名、目录都算） |
+| `-draft` | 消息和会话名里都不含 `draft` 的会话 |
 | `name:auth` | 只在会话名里找。`dir:` 或 `cwd:` 只看工作目录 |
 | `user:deploy` | 只看你发的消息。`ai:` 或 `assistant:` 只看回复 |
 | `/\bfoo\d+\b/` | JavaScript 正则，大小写不敏感，`^` 和 `$` 匹配行首行尾。空格用 `\s` 代替 |
@@ -107,7 +107,7 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 
 引号是万能转义：`"-foo"`、`"a|b"`、`"name:x"`、`"/x/"` 都按字面搜这些字符。正则写错了就当普通文字搜。预览里只高亮正向的词，`name:` / `dir:` 的词不碰对话正文，所以只输入 `name:auth` 时右栏显示完整对话、没有高亮。
 
-索引里有用户和助手的消息、会话名、工作目录。没有工具调用的参数和结果，`Ctrl+T` 显示的工具行也不参与匹配和高亮。
+索引里有用户和助手的消息和会话名。工作目录只由 `dir:` / `cwd:` 匹配：当前目录树范围下所有会话的路径都带同一段前缀，普通词一碰到路径就会命中全部会话。没有工具调用的参数和结果，`Ctrl+T` 显示的工具行也不参与匹配和高亮。
 
 ## 🌐 界面语言
 
@@ -134,13 +134,19 @@ Windows PowerShell 里先执行 `$env:PI_SESSION_PEEK_LANG = "en"` 再启动 pi
 
 ```text
 pi-session-peek/
-├── index.ts                 # 注册 /peek 和启动参数，注入删除 / 重命名 / 分叉
+├── index.ts                 # 注册 /peek 和启动参数，注入删除 / 重命名 / 分叉 / 复制
 ├── src/
-│   ├── peek-component.ts    # 双栏 TUI 组件
+│   ├── peek-component.ts    # 双栏组件：状态、按键和鼠标路由、头尾、双栏拼接
+│   ├── preview.ts           # 右栏：按会话生成预览行和命中行、初始滚动位置、Ctrl+N/P 跳转目标
+│   ├── list.ts              # 左栏：每个会话两行、视口跟随
+│   ├── drag-select.ts       # 拖选状态机：按下 / 拖动 / 松开 / 自动滚动
+│   ├── selection.ts         # 选区几何：区间、反显、取文字
+│   ├── layout.ts            # 分栏宽度和主体高度
 │   ├── sessions.ts          # 扫描解析会话 JSONL，重命名 / 删除
-│   ├── query.ts             # 查询解析、高亮、命中片段
+│   ├── query.ts             # 查询解析、匹配、高亮、命中片段
 │   ├── mouse.ts             # 常规（非全屏）模式下的鼠标上报
-│   ├── selection.ts         # 限定在一栏内的拖选：区间、反显、取文字
+│   ├── ansi.ts              # 转义序列分词、SGR 跟踪、输入净化
+│   ├── theme.ts             # 选择器用到的 pi Theme 子集
 │   ├── i18n.ts              # 中英文界面文案和语言检测
 │   └── text.ts              # 路径、时间、宽度工具
 ├── scripts/screenshot.mjs   # 可选：用组件渲染输出生成一张合成截图

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-session-peek",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Pi extension: search session history in a two-pane picker with full conversation preview, then resume or fork.",
   "type": "module",
   "license": "MIT",

package/src/ansi.ts

@@ -0,0 +1,73 @@
+// 终端转义序列相关的工具，三种用途分开：
+//   1. ANSI_SEQ_RE / splitAnsi：把 pi-tui 渲染出来的一行拆成"可见文字 / 序列"两类片段，序列原样保留、
+//      绝不吞可见字。高亮（query.ts）和反显（selection.ts）都靠它，两边必须用同一个正则，
+//      否则"记为命中的行"和"高亮到的行"会对不上
+//   2. applySgr：只跟踪 SGR 里高亮会碰到的几项（前景色、粗体 / 暗淡、下划线），高亮结束时把外层样式恢复回去
+//   3. sanitizeText：解析会话 JSONL 时净化输入。比 1 宽得多：DCS / PM / SOS、没终止的 OSC、孤立的 ESC、
+//      C0 控制字符全去掉，宁可多删。每个 ANSI_SEQ_RE 能匹配的序列都在它的覆盖范围内，反之不然
+// scripts/screenshot.mjs 有一个自己的 SGR → CSS 状态机（要斜体和背景色），用途不同，不共用
+
+/** pi-tui 会产生的三类序列：CSI（颜色等）、OSC（超链接）、APC。带 g，只用于 matchAll / replace，两者都不受 lastIndex 影响 */
+export const ANSI_SEQ_RE = /\x1b\[[0-9;?<>=!]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b_[^\x07\x1b]*(?:\x07|\x1b\\)/g;
+
+/** 行尾连续的序列（39m、49m 之类的收尾码） */
+export const ANSI_TAIL_RE = new RegExp(`(?:${ANSI_SEQ_RE.source})+$`);
+
+export interface AnsiSegment {
+  text: string;
+  esc: boolean; // true：这一段是一个完整的转义序列
+}
+
+/** 一行拆成可见文本和转义序列交替的片段，按顺序拼回去就是原样 */
+export function splitAnsi(line: string): AnsiSegment[] {
+  const segs: AnsiSegment[] = [];
+  let last = 0;
+  for (const m of line.matchAll(ANSI_SEQ_RE)) {
+    if (m.index > last) segs.push({ text: line.slice(last, m.index), esc: false });
+    segs.push({ text: m[0], esc: true });
+    last = m.index + m[0].length;
+  }
+  if (last < line.length) segs.push({ text: line.slice(last), esc: false });
+  return segs;
+}
+
+/** 是不是 SGR（CSI … m）：只有它会改样式 */
+export const isSgr = (seq: string): boolean => seq.startsWith("\x1b[") && seq.endsWith("m");
+
+// 只跟踪高亮会碰到的几项：前景色、粗体 / 暗淡、下划线
+export interface SgrStyle {
+  fg: string;
+  bold: boolean;
+  dim: boolean;
+  underline: boolean;
+}
+
+export function applySgr(st: SgrStyle, seq: string): void {
+  const m = /^\x1b\[([0-9;]*)m$/.exec(seq);
+  if (!m) return;
+  const p = m[1] === "" ? [0] : m[1].split(";").map(Number);
+  for (let i = 0; i < p.length; i++) {
+    const c = p[i];
+    if (c === 0) {
+      st.fg = "";
+      st.bold = st.dim = st.underline = false;
+    } else if (c === 1) st.bold = true;
+    else if (c === 2) st.dim = true;
+    else if (c === 22) st.bold = st.dim = false;
+    else if (c === 4) st.underline = true;
+    else if (c === 24) st.underline = false;
+    else if ((c >= 30 && c <= 37) || (c >= 90 && c <= 97)) st.fg = `\x1b[${c}m`;
+    else if (c === 39) st.fg = "";
+    else if (c === 38 || c === 48) {
+      // 扩展色 38;5;n / 38;2;r;g;b；背景色（48）只需要跳过它的参数
+      const n = p[i + 1] === 5 ? 2 : p[i + 1] === 2 ? 4 : 0;
+      if (c === 38 && n) st.fg = `\x1b[${p.slice(i, i + n + 1).join(";")}m`;
+      i += n;
+    }
+  }
+}
+
+// 终端转义序列（CSI / OSC / DCS / APC 等）和除 \t \n 外的 C0 控制字符。正文里带这些会原样写到屏幕上：
+// 排版错乱、宽度算错，OSC 52 之类的还能改剪贴板 / 窗口标题
+const CONTROL_RE = /\x1b(?:\[[0-?]*[ -/]*[@-~]|[\]P_^X][^\x07\x1b]*(?:\x07|\x1b\\)?|[@-Z\\-_])|[\x00-\x08\x0b-\x1f\x7f]/g;
+export const sanitizeText = (s: string) => s.replace(/\r\n?/g, "\n").replace(CONTROL_RE, "");

package/src/drag-select.ts

@@ -0,0 +1,119 @@
+import { SEP } from "./layout.ts";
+import type { Cell, Pane, Selection } from "./selection.ts";
+
+// 鼠标拖选的状态机：按下（begin）→ 拖动（move）→ 松开（release），中间拖出预览上下边时自动滚动。
+// 选区本身的几何（起止排序、每行列区间、反显、取文字）是 selection.ts 的纯函数，这里只管"现在选到哪了"。
+// 坐标一律是主体行号（组件 y 减去 BODY_TOP）；组件通过 host 提供分栏尺寸和滚动位置，并接收自动滚动的写回
+
+const AUTO_SCROLL_MS = 50; // 拖选拖出预览上下边时自动滚动的节奏，和 pi-tui 一样
+
+export interface DragHost {
+  /** 最近一次 render 的分栏尺寸和两栏当前的滚动偏移 */
+  geometry(): { lw: number; rw: number; H: number; listOffset: number; previewOffset: number };
+  /** 预览总行数，自动滚动到底时停 */
+  previewLength(): number;
+  /** 自动滚动写回预览偏移；紧接着的 move 用新值算格 */
+  setPreviewOffset(n: number): void;
+  /** 自动滚动改了状态，让组件重画（invalidate + requestRender） */
+  changed(): void;
+}
+
+export class DragSelect {
+  sel?: Selection; // 鼠标拖出来的选区，只在一栏里
+  dragging = false; // 左键还按着
+  selMoved = false; // 按下之后拖过没有；没拖过的选区不显示也不算数（那是单击）
+  dragX = 0; // 最近一次拖动的列，自动滚动时焦点跟着它
+  autoScrollDir = 0; // 拖出预览上下边：-1 往上 1 往下
+  autoScrollTimer?: ReturnType<typeof setInterval>;
+
+  constructor(private host: DragHost) {}
+
+  // 拖过的才算选区，只按下没拖的是单击
+  active(): Selection | undefined {
+    return this.sel && this.selMoved ? this.sel : undefined;
+  }
+
+  clear(): void {
+    this.sel = undefined;
+    this.dragging = false;
+    this.selMoved = false;
+    this.stopAutoScroll();
+  }
+
+  // 屏幕位置换成某一栏的内容坐标：行是内容的绝对行号，列夹在这一栏里，拖到栏外也只选栏内的字
+  cellAt(pane: Pane, x: number, bodyRow: number): Cell {
+    const { lw, rw, H, listOffset, previewOffset } = this.host.geometry();
+    const row = Math.max(0, Math.min(H - 1, bodyRow));
+    if (pane === "list") return { row: listOffset * 2 + row, col: Math.max(0, Math.min(lw - 1, x)) };
+    return { row: previewOffset + row, col: Math.max(0, Math.min(rw - 1, x - lw - SEP)) };
+  }
+
+  // 按下：可能是拖选的起点，拖起来才算数
+  begin(pane: Pane, x: number, bodyRow: number): void {
+    const cell = this.cellAt(pane, x, bodyRow);
+    this.sel = { pane, anchor: cell, focus: { ...cell } };
+    this.dragging = true;
+    this.dragX = x;
+  }
+
+  // 拖到某个位置：焦点跟过去。返回有没有变
+  move(x: number, bodyRow: number): boolean {
+    this.dragX = x;
+    const changed = this.dragTo(x, bodyRow);
+    if (changed) this.selMoved = true;
+    return changed;
+  }
+
+  private dragTo(x: number, bodyRow: number): boolean {
+    if (!this.sel) return false;
+    const cell = this.cellAt(this.sel.pane, x, bodyRow);
+    if (cell.row === this.sel.focus.row && cell.col === this.sel.focus.col) return false;
+    this.sel.focus = cell;
+    return true;
+  }
+
+  // 指针在预览上边（-1）/ 下边（1）时开始自动滚，回到里面（0）停
+  autoScroll(dir: -1 | 0 | 1): void {
+    this.autoScrollDir = dir;
+    if (!dir) {
+      this.stopAutoScroll();
+      return;
+    }
+    if (this.autoScrollTimer) return;
+    this.autoScrollTimer = setInterval(() => this.tick(), AUTO_SCROLL_MS);
+    this.autoScrollTimer.unref?.();
+  }
+
+  // 每次滚一行，焦点跟着指针：指针在上边就是视口第一行，在下边就是最后一行
+  private tick(): void {
+    const { H, previewOffset } = this.host.geometry();
+    const maxOff = Math.max(0, this.host.previewLength() - H);
+    const next = Math.max(0, Math.min(maxOff, previewOffset + this.autoScrollDir));
+    if (!this.sel || !this.dragging || next === previewOffset) {
+      this.stopAutoScroll();
+      return;
+    }
+    this.host.setPreviewOffset(next);
+    if (this.dragTo(this.dragX, this.autoScrollDir < 0 ? -1 : H)) this.selMoved = true;
+    this.host.changed();
+  }
+
+  // 松开：没拖过就是单击，选区作废。返回是不是我们在跟踪的那次按下
+  release(): boolean {
+    if (!this.dragging) return false;
+    this.dragging = false;
+    this.stopAutoScroll();
+    if (!this.selMoved) this.sel = undefined;
+    return true;
+  }
+
+  private stopAutoScroll(): void {
+    if (this.autoScrollTimer) clearInterval(this.autoScrollTimer);
+    this.autoScrollTimer = undefined;
+    this.autoScrollDir = 0;
+  }
+
+  dispose(): void {
+    this.stopAutoScroll();
+  }
+}

package/src/i18n.ts

@@ -27,7 +27,7 @@ const zh = {
   hitPos: " 命中 {k}/{n}",
   truncated: "（会话过长，仅显示最后 {n} 条）",
   hitInTruncated: "关键词命中在未显示的更早消息中",
-  hitOnlyMeta: "关键词仅命中会话名或目录，对话正文无匹配",
+  hitOnlyMeta: "关键词仅命中会话名，对话正文无匹配",
   you: "👤 你",
   ai: "🤖 AI",
   renamePrefix: "✏ 重命名: ",
@@ -70,7 +70,7 @@ const en: Record<keyof typeof zh, string> = {
   hitPos: " hit {k}/{n}",
   truncated: "(long session, showing the last {n} messages)",
   hitInTruncated: "Keyword hits are in earlier messages not shown here",
-  hitOnlyMeta: "Keyword matched only the session name or directory, not the conversation",
+  hitOnlyMeta: "Keyword matched only the session name, not the conversation",
   you: "👤 You",
   ai: "🤖 AI",
   renamePrefix: "✏ Rename: ",

package/src/layout.ts

@@ -0,0 +1,18 @@
+// 双栏选择器的几何：头部占几行、分隔线几列、主体多高、左右栏多宽。
+// 组件、左栏、拖选都要用，单独放一个文件，免得它们反向 import 组件
+
+export const BODY_TOP = 3; // 头部、搜索框、分隔线之后才是双栏主体
+export const SEP = 3; // 两栏之间 " │ " 占的列数
+
+// 主体高度。每次都读 process.stdout.rows，终端拉伸后布局跟着变；读不到时用启动时记下的行数
+export function bodyRows(termRows: number): number {
+  const rows = process.stdout.rows || termRows || 24;
+  return Math.max(8, Math.min(rows - 12, 30));
+}
+
+// 左栏占 40%，夹在 26 到 56 列之间；右栏拿剩下的，至少 20 列
+export function paneWidths(width: number): { lw: number; rw: number } {
+  const lw = Math.max(26, Math.min(56, Math.floor(width * 0.4)));
+  const rw = Math.max(20, width - lw - SEP);
+  return { lw, rw };
+}

package/src/list.ts

@@ -0,0 +1,64 @@
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { anyMatch, highlight, snippet, type RoleTerms } from "./query.ts";
+import type { PeekSession } from "./sessions.ts";
+import { fmtTime, padEndVisible } from "./text.ts";
+import type { PeekTheme } from "./theme.ts";
+
+// 左栏：每个会话两行，全是纯函数。滚动偏移由组件持有，这里只算"选中项要留在视口里时偏移该是多少"
+
+// 主体 height 行能放下几个会话（每个两行）
+export const visibleItems = (height: number): number => Math.max(1, Math.floor(height / 2));
+
+// 选中项跑出视口时把偏移挪过去，其余情况不动
+export function followSelection(selected: number, offset: number, visible: number): number {
+  if (selected < offset) return selected;
+  if (selected >= offset + visible) return selected - visible + 1;
+  return offset;
+}
+
+// 一个会话的两行：时间 + 目录（有正文关键词时加命中数），首条消息或命中片段
+export function listRows(s: PeekSession, sel: boolean, lw: number, rt: RoleTerms, hasBody: boolean, t: PeekTheme): [string, string] {
+  const time = fmtTime(s.time);
+  const cwdTail = s.cwd.replace(/\\/g, "/").split("/").slice(-2).join("/");
+  const hitBadge = hasBody
+    ? ` ·${s.msgs.reduce((n, m) => n + (anyMatch(m.text, rt[m.role]) ? 1 : 0), 0)}`
+    : "";
+  const l1 = `${sel ? "›" : " "} ${time} ${cwdTail}${hitBadge}`;
+  const snip = hasBody ? snippet(s.msgs, rt, lw) : undefined;
+  const l2 = snip !== undefined
+    ? `  ${highlight(snip.text, rt[snip.role], t)}`
+    : `  ${s.first}${s.name ? `  [${s.name}]` : ""}`;
+  if (sel) {
+    return [
+      t.bg("selectedBg", padEndVisible(t.fg("accent", truncateToWidth(l1, lw)), lw)),
+      t.bg("selectedBg", padEndVisible(truncateToWidth(l2, lw), lw)),
+    ];
+  }
+  return [padEndVisible(l1, lw), padEndVisible(t.fg("dim", truncateToWidth(l2, lw)), lw)];
+}
+
+// 从 offset 起画满 height 行，每个会话两行，没会话的位置留空
+export function buildList(
+  filtered: PeekSession[],
+  selected: number,
+  offset: number,
+  height: number,
+  lw: number,
+  rt: RoleTerms,
+  hasBody: boolean,
+  t: PeekTheme,
+): string[] {
+  const rows: string[] = [];
+  for (let i = 0, n = visibleItems(height); i < n; i++) {
+    const idx = offset + i;
+    const s = filtered[idx];
+    if (!s) {
+      rows.push(" ".repeat(lw), " ".repeat(lw));
+      continue;
+    }
+    rows.push(...listRows(s, idx === selected, lw, rt, hasBody, t));
+  }
+  // 每项两行，height 是奇数时会少一行，补空行，否则最后一行右栏会顶到左边
+  while (rows.length < height) rows.push(" ".repeat(lw));
+  return rows.slice(0, height);
+}