pi-session-peek 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.0
+
+- Mouse support in both panes. Click a session to select it, double-click to resume, wheel over the list to move the selection, wheel over the preview to scroll it (`Alt` for five times faster), click the scope label to toggle it, click the search box or rename line to move the cursor. Pi only enables mouse reporting in fullscreen mode, so in the regular mode the picker turns it on itself while open and locates itself on screen with a cursor position query; the terminal's own text selection is unavailable meanwhile (usually `Shift` restores it). `PI_SESSION_PEEK_MOUSE=0` disables it.
+- Drag to select text inside one pane. The selection never crosses the divider: dragging from the list into the preview, or past either edge, keeps selecting the pane where the drag started, and lines wrap at that pane's width. Dragging below or above the preview scrolls it. Nothing is copied on release; `Ctrl+C` copies the selection (and closes the picker as before when there is none), a click anywhere clears it.
+
 ## 0.4.1
 
 - `Ctrl+T` shows tool calls in the preview: one dim line per call with the tool name and its main argument (command, path, URL, query…), placed under the reply that made it. Off by default. Tool results are still not stored, and the tool lines are never searched or highlighted.

package/README.md

@@ -74,6 +74,21 @@ In TUI mode, run `/peek` and start typing. Press `Enter` on a session to continu
 | `Ctrl+D` | Delete, confirmed with `y` or `Enter`. Moves the file to the system trash whenever one is available (`trash` CLI, then the Windows Recycle Bin via PowerShell, Finder on macOS, `gio trash` / `trash-put` on Linux). Deletes permanently only if none of those work. |
 | `Esc` `Ctrl+C` | Close |
 
+## 🖱️ Mouse
+
+| Action | Effect |
+| --- | --- |
+| 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 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 |
+| Drag inside a pane | Select text in that pane only. Dragging across the divider or past the edge keeps the selection in the pane where it started, and lines wrap within that pane. |
+| `Ctrl+C` with a selection | Copy it to the clipboard. Nothing is copied on release. Without a selection `Ctrl+C` closes as before; a click anywhere clears the selection. |
+
+Mouse reporting is switched on only while the picker is open and switched off when it closes, so the rest of pi is unaffected. While it is on, the terminal's own text selection and scrollback are unavailable; most terminals give them back while `Shift` is held, but that selection is the terminal's and spans both panes. Set `PI_SESSION_PEEK_MOUSE=0` to keep the mouse off. In pi's fullscreen mode the picker uses pi's own mouse handling and the variable is ignored.
+
 ## 🔎 Search syntax
 
 The filter is case-insensitive and matches anywhere in the text. Whitespace separates terms, and every term must be satisfied.
@@ -110,7 +125,7 @@ On Windows PowerShell: `$env:PI_SESSION_PEEK_LANG = "en"` before starting pi. Th
 ## 🚧 Limitations
 
 - TUI mode only.
-- No mouse support. Pi only enables mouse input in its experimental fullscreen mode, and this picker does not handle it yet.
+- The mouse needs a terminal that supports SGR mouse reporting and the cursor position report (`CSI 6 n`). Windows Terminal, iTerm2, kitty, WezTerm, Alacritty, GNOME Terminal and VS Code all do; the legacy Windows console does not.
 - The preview shows the last 500 messages of very long sessions. Hits in earlier messages are still counted and announced.
 - `pi --peek` without a value is rejected by pi at startup. Use `pi --rp` to open without a keyword.
 - Only sessions under `~/.pi/agent/sessions` (or `$PI_CODING_AGENT_DIR/sessions`) are scanned.
@@ -124,6 +139,8 @@ pi-session-peek/
 │   ├── peek-component.ts    # The two-pane TUI component
 │   ├── sessions.ts          # Scans and parses session JSONL, rename / delete helpers
 │   ├── query.ts             # Query parsing, highlighting, hit snippets
+│   ├── mouse.ts             # Mouse reporting for pi's regular (non-fullscreen) mode
+│   ├── selection.ts         # Pane-confined drag selection: ranges, highlight, text extraction
 │   ├── 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

@@ -74,6 +74,21 @@ pi 扩展以你的用户权限运行，只装信得过的包。
 | `Ctrl+D` | 删除，按 `y` 或 `Enter` 确认。只要系统有回收站就优先进回收站（`trash` 命令、Windows 用 PowerShell 进回收站、macOS 用 Finder、Linux 用 `gio trash` / `trash-put`），全都不可用才直接删文件。 |
 | `Esc` `Ctrl+C` | 关闭 |
 
+## 🖱️ 鼠标
+
+| 操作 | 作用 |
+| --- | --- |
+| 点列表里的会话 | 选中 |
+| 双击会话 | 进入，和 `Enter` 一样 |
+| 在列表上滚滚轮 | 换选中项 |
+| 在预览上滚滚轮 | 预览每格滚三行，按住 `Alt` 快五倍 |
+| 点头部的范围字样 | 当前目录树 ↔ 全部项目，和 `Tab` 一样 |
+| 点搜索框或改名行 | 移动光标 |
+| 在某一栏里按住拖动 | 只选这一栏的文字。拖过分隔线或拖出边界，选区仍留在起点那一栏里，按这一栏的宽度换行。 |
+| 有选区时按 `Ctrl+C` | 复制到剪贴板。松开鼠标不会自动复制。没有选区时 `Ctrl+C` 仍是关闭；点一下任意位置清掉选区。 |
+
+鼠标上报只在选择器打开时开、关闭时关，pi 的其他界面不受影响。开着的时候终端自带的选文字和滚回看历史不能用，多数终端按住 `Shift` 可以照旧，但那是终端自己的选区，会横跨两栏。不想要鼠标就设 `PI_SESSION_PEEK_MOUSE=0`。pi 的全屏模式下走 pi 自己的鼠标分发，这个变量不起作用。
+
 ## 🔎 搜索语法
 
 大小写不敏感，匹配文本中任意位置。空白分隔多个词，每个词都要满足。
@@ -110,7 +125,7 @@ Windows PowerShell 里先执行 `$env:PI_SESSION_PEEK_LANG = "en"` 再启动 pi
 ## 🚧 限制
 
 - 只支持 TUI 模式。
-- 不支持鼠标。pi 只在实验性的全屏模式里开鼠标，这个选择器还没处理鼠标事件。
+- 鼠标需要终端支持 SGR 鼠标上报和光标位置回报（`CSI 6 n`）。Windows Terminal、iTerm2、kitty、WezTerm、Alacritty、GNOME Terminal、VS Code 都支持，老式 Windows 控制台不支持。
 - 特别长的会话预览只显示最后 500 条消息，更早的命中仍会计数并提示。
 - `pi --peek` 不带值会被 pi 在启动时拒绝，不带关键词请用 `pi --rp`。
 - 只扫描 `~/.pi/agent/sessions`（或 `$PI_CODING_AGENT_DIR/sessions`）下的会话。
@@ -124,6 +139,8 @@ pi-session-peek/
 │   ├── peek-component.ts    # 双栏 TUI 组件
 │   ├── sessions.ts          # 扫描解析会话 JSONL，重命名 / 删除
 │   ├── query.ts             # 查询解析、高亮、命中片段
+│   ├── mouse.ts             # 常规（非全屏）模式下的鼠标上报
+│   ├── selection.ts         # 限定在一栏内的拖选：区间、反显、取文字
 │   ├── i18n.ts              # 中英文界面文案和语言检测
 │   └── text.ts              # 路径、时间、宽度工具
 ├── scripts/screenshot.mjs   # 可选：用组件渲染输出生成一张合成截图

package/index.ts

@@ -1,6 +1,7 @@
-import { getMarkdownTheme, SessionManager, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { copyToClipboard, getMarkdownTheme, SessionManager, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { basename } from "node:path";
 import { msg } from "./src/i18n.ts";
+import { attachMouse } from "./src/mouse.ts";
 import { PeekComponent } from "./src/peek-component.ts";
 import { deleteSession, renameSession, scanSessions, type PeekSession } from "./src/sessions.ts";
 
@@ -65,6 +66,18 @@ export default function (pi: ExtensionAPI) {
       const picked = await ctx.ui.custom<Picked>((tui, theme, _kb, done) => {
         const comp = new PeekComponent(all, ctx.cwd, theme, getMarkdownTheme(), process.stdout.rows || 24, initial);
         comp.requestRender = () => tui.requestRender();
+        // 常规模式 pi 不开鼠标，自己开；全屏模式 pi-tui 会直接调 comp.handleMouse
+        const mouse = attachMouse(comp, tui);
+        comp.onDispose = () => mouse.dispose();
+        // 鼠标拖选后 Ctrl+C 复制。用 pi 自己的复制：原生剪贴板，不行再退到 OSC 52
+        comp.onCopy = async (text) => {
+          try {
+            await copyToClipboard(text);
+            return true;
+          } catch {
+            return false;
+          }
+        };
         comp.onResume = (s) => {
           lastQuery = comp.getQuery();
           done({ s, action: "resume" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-session-peek",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "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/i18n.ts

@@ -32,7 +32,10 @@ const zh = {
   ai: "🤖 AI",
   renamePrefix: "✏ 重命名: ",
   confirmDelete: "⚠ 删除会话 [{desc}]？按 y / Enter 确认，任意其他键取消",
-  footer: "↑↓ 选择  PgUp/Dn·^U/^F·⇧↑↓ 滚动  ^N/^P 命中  ^T 工具  Tab 范围  ^D 删除  ^R 改名  ^O 分叉  Enter 进入  Esc/^C 关闭",
+  footer: "↑↓ 选择  PgUp/Dn·^U/^F·⇧↑↓ 滚动  ^N/^P 命中  ^T 工具  Tab 范围  ^D 删除  ^R 改名  ^O 分叉  Enter 进入  Esc/^C 关闭  🖱 点选·双击进入·拖选·滚轮",
+  selHint: "▭ 已选 {n} 行  ^C 复制  点击别处取消",
+  copied: "✓ 已复制 {n} 行",
+  copyFailed: "✗ 复制失败",
   since: "近{n}{unit}",
   unitH: "小时",
   unitD: "天",
@@ -72,7 +75,10 @@ const en: Record<keyof typeof zh, string> = {
   ai: "🤖 AI",
   renamePrefix: "✏ Rename: ",
   confirmDelete: "⚠ Delete session [{desc}]? y / Enter to confirm, any other key to cancel",
-  footer: "↑↓ select  PgUp/Dn·^U/^F·⇧↑↓ scroll  ^N/^P hits  ^T tools  Tab scope  ^D del  ^R rename  ^O fork  Enter open  Esc close",
+  footer: "↑↓ select  PgUp/Dn·^U/^F·⇧↑↓ scroll  ^N/^P hits  ^T tools  Tab scope  ^D del  ^R rename  ^O fork  Enter open  Esc close  🖱 click·dbl-click·drag·wheel",
+  selHint: "▭ {n} lines selected  ^C copy  click elsewhere to clear",
+  copied: "✓ Copied {n} lines",
+  copyFailed: "✗ Copy failed",
   since: "last {n}{unit}",
   unitH: "h",
   unitD: "d",

package/src/mouse.ts

@@ -0,0 +1,207 @@
+import type { TuiInputListenerResult, TuiMouseButton, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
+
+// pi 只在全屏模式开鼠标上报，常规模式要自己开：选择器打开时让终端用 SGR 格式上报鼠标（CSI ?1000h ?1006h），
+// 在 TUI 的输入监听里截下 \x1b[<b;x;yM / m，换算成组件内的行列交给 handleMouse，关闭时再关掉。
+//
+// 组件在屏幕上的顶行 pi 自己也不知道：常规模式只做相对光标移动，起始行取决于启动时 shell 的光标停在哪。
+// 所以每次重画之后发一个光标位置查询（CSI 6 n），终端回 \x1b[row;colR。硬件光标停在组件里带焦点的
+// 输入框那一行，减掉这一行在组件里的偏移就是顶行。全屏模式下 pi-tui 自带鼠标分发，这里什么都不做。
+//
+// 开了鼠标上报之后终端自己的选文字 / 滚回看历史就不能用了（多数终端按住 Shift 仍可以），
+// 不想要的话设 PI_SESSION_PEEK_MOUSE=0。
+
+// 1002：按着键移动也上报，拖选要用；不认 1002 的终端退到 1000 只报按下松开
+const ENABLE_MOUSE = "\x1b[?1000h\x1b[?1002h\x1b[?1006h";
+const DISABLE_MOUSE = "\x1b[?1006l\x1b[?1002l\x1b[?1000l";
+const CURSOR_QUERY = "\x1b[6n";
+const DOUBLE_CLICK_MS = 500; // 和 pi-tui 全屏模式一样
+const QUERY_TIMEOUT_MS = 1000; // 终端不回复就当丢了，允许下次重画再问
+const ALT_WHEEL_MULTIPLIER = 5; // 和 pi-tui 一样，按住 Alt 滚快五倍
+export const DETACH_GRACE_MS = 150; // 关闭后再听一小会儿：终端可能还有已经发出、在路上的鼠标序列
+
+const SGR_MOUSE = /^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/;
+const CURSOR_REPORT = /^\x1b\[(\d+);(\d+)R$/;
+
+export interface MouseTarget {
+  handleMouse(ev: TuiMouseEvent): TuiMouseEventResult | undefined;
+  /** 硬件光标在组件内的行号（0 起）；没有焦点时返回 undefined，此时光标不在组件上，测不准 */
+  cursorRow(): number | undefined;
+  /** 由 attachMouse 赋值，组件每次 render 之后调用 */
+  afterRender?: () => void;
+}
+
+/** 用到的 TUI 子集，测试里好造假 */
+export interface MouseHost {
+  readonly mode: string;
+  terminal: { write(data: string): void; readonly columns: number; readonly rows: number };
+  addInputListener(listener: (data: string) => TuiInputListenerResult): () => void;
+  requestRender(): void;
+}
+
+export interface MouseBridge {
+  /** 常规模式下为 true；全屏模式 pi-tui 自己分发鼠标，这里不介入 */
+  readonly active: boolean;
+  dispose(): void;
+}
+
+function decodeButton(b: number): TuiMouseButton {
+  switch (b & 3) {
+    case 0:
+      return "left";
+    case 1:
+      return "middle";
+    case 2:
+      return "right";
+    default:
+      return "none";
+  }
+}
+
+export function attachMouse(target: MouseTarget, tui: MouseHost, env: NodeJS.ProcessEnv = process.env): MouseBridge {
+  if (tui.mode !== "regular" || !tui.terminal || env.PI_SESSION_PEEK_MOUSE === "0") {
+    return { active: false, dispose() {} };
+  }
+
+  let top: number | undefined; // 组件顶行在屏幕上的行号（0 起），没测到之前鼠标事件只吞不发
+  let inflight: number | undefined; // 已发出、还没收到回复的查询：发出时光标所在的组件内行号
+  let dirty = false; // 查询在途时又重画了，回复之后要再问一次
+  let scheduled = false;
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  let pressed: { x: number; y: number } | undefined;
+  let moved = false; // 按下之后指针换过格没有；换过就不算单击
+  let lastClick: { x: number; y: number; at: number; count: number } | undefined;
+  let disposed = false;
+  let off: (() => void) | undefined;
+
+  const clearTimer = (): void => {
+    if (timer) clearTimeout(timer);
+    timer = undefined;
+  };
+  const detach = (): void => {
+    off?.();
+    off = undefined;
+  };
+  // 关闭后不马上摘监听：查询的回复和路上的鼠标序列都要吃掉，别漏进 pi 的编辑器
+  const scheduleDetach = (): void => {
+    const t = setTimeout(detach, DETACH_GRACE_MS);
+    t.unref?.();
+  };
+  // 查询结束（收到回复或超时）
+  const finishQuery = (): void => {
+    inflight = undefined;
+    clearTimer();
+    if (disposed) scheduleDetach();
+    else if (dirty) schedule();
+  };
+  const query = (): void => {
+    scheduled = false;
+    if (disposed || inflight !== undefined) return;
+    const row = target.cursorRow();
+    if (row === undefined) return;
+    dirty = false;
+    inflight = row;
+    tui.terminal.write(CURSOR_QUERY);
+    timer = setTimeout(finishQuery, QUERY_TIMEOUT_MS);
+    timer.unref?.();
+  };
+  // 等 pi 把这一帧写完、光标摆好再问
+  const schedule = (): void => {
+    if (scheduled || disposed) return;
+    scheduled = true;
+    process.nextTick(query);
+  };
+  target.afterRender = () => {
+    dirty = true;
+    schedule();
+  };
+
+  off = tui.addInputListener((data): TuiInputListenerResult => {
+    const cpr = CURSOR_REPORT.exec(data);
+    if (cpr) {
+      if (inflight === undefined) return undefined; // 不是我们问的
+      top = Number(cpr[1]) - 1 - inflight;
+      finishQuery();
+      return { consume: true };
+    }
+    const m = SGR_MOUSE.exec(data);
+    if (!m) return undefined;
+    if (top === undefined || disposed) return { consume: true };
+    const b = Number(m[1]);
+    const sx = Number(m[2]) - 1;
+    const sy = Number(m[3]) - 1;
+    const release = m[4] === "m";
+    const base = {
+      x: sx,
+      y: sy - top,
+      screenX: sx,
+      screenY: sy,
+      width: tui.terminal.columns,
+      height: tui.terminal.rows,
+      shift: (b & 4) !== 0,
+      alt: (b & 8) !== 0,
+      ctrl: (b & 16) !== 0,
+    };
+    let render = false;
+    const dispatch = (ev: TuiMouseEvent): void => {
+      const r = target.handleMouse(ev);
+      if (!r || !(r.handled || r.capture || r.focus)) return;
+      // 和 pi-tui 一样：按下、点击、滚轮默认重画，松开默认不重画
+      render ||= r.render ?? ev.type !== "release";
+    };
+    if (b & 64) {
+      const dir = (b & 3) === 0 ? -1 : (b & 3) === 1 ? 1 : 0; // 66 / 67 是横向滚轮，不管
+      if (!release && dir) {
+        dispatch({ ...base, type: "wheel", button: "none", wheelDelta: dir * (base.alt ? ALT_WHEEL_MULTIPLIER : 1) });
+      }
+    } else {
+      const button = decodeButton(b);
+      if (b & 32) {
+        // 按着键移动。没开 1003，不带键的纯移动不该来，来了也不管
+        if (button === "none" || !pressed) return { consume: true };
+        if (sx !== pressed.x || sy !== pressed.y) moved = true;
+        dispatch({ ...base, type: "drag", button });
+      } else if (!release) {
+        pressed = { x: sx, y: sy };
+        moved = false;
+        dispatch({ ...base, type: "press", button });
+      } else {
+        if (pressed && (sx !== pressed.x || sy !== pressed.y)) moved = true;
+        dispatch({ ...base, type: "release", button });
+        // 按下松开之间没动过算一次点击；短时间内在同一格连点，次数 1 → 2 → 3 循环
+        if (pressed && !moved) {
+          const now = Date.now();
+          const again = lastClick && now - lastClick.at <= DOUBLE_CLICK_MS && lastClick.x === sx && lastClick.y === sy;
+          const count = again && lastClick ? (lastClick.count % 3) + 1 : 1;
+          lastClick = { x: sx, y: sy, at: now, count };
+          dispatch({ ...base, type: "click", button, clickCount: count });
+        }
+        pressed = undefined;
+      }
+    }
+    if (render) tui.requestRender();
+    return { consume: true };
+  });
+
+  // pi 崩了或被杀时终端会留在鼠标模式，之后点一下 shell 里就冒乱码，退出时尽量关掉
+  const restore = (): void => {
+    try {
+      tui.terminal.write(DISABLE_MOUSE);
+    } catch {
+      // 退出时 stdout 可能已经关了
+    }
+  };
+  process.once("exit", restore);
+
+  const dispose = (): void => {
+    if (disposed) return;
+    disposed = true;
+    process.off("exit", restore);
+    target.afterRender = undefined;
+    // 选择器开着时切到了全屏模式的话，鼠标已经归 pi-tui 管，别去关
+    if (tui.mode === "regular") restore();
+    if (inflight === undefined) scheduleDetach();
+  };
+
+  tui.terminal.write(ENABLE_MOUSE);
+  return { active: true, dispose };
+}

package/src/peek-component.ts

@@ -8,14 +8,23 @@ import {
   type Component,
   type Focusable,
   type MarkdownTheme,
+  type TuiMouseEvent,
+  type TuiMouseEventResult,
 } from "@earendil-works/pi-tui";
 import { msg } from "./i18n.ts";
-import { anyMatch, highlight, lineHasMatch, matchesSession, parseQuery, roleTerms, snippet, type ParsedQuery } from "./query.ts";
+import { anyMatch, highlight, lineHasMatch, matchesSession, parseQuery, roleTerms, snippet, type ParsedQuery, type RoleTerms } from "./query.ts";
+import { bounds, highlightColumns, rowColumns, selectionText, type Cell, type Pane, type Selection } from "./selection.ts";
 import type { PeekMsg, PeekSession } from "./sessions.ts";
 import { fmtTime, normPath, padEndVisible } from "./text.ts";
 
 // 双栏选择器。文件操作（删除 / 重命名 / 分叉）不在这里做，由 index.ts 通过回调注入
 
+const BODY_TOP = 3; // 头部、搜索框、分隔线之后才是双栏主体
+const SEP = 3; // 两栏之间 " │ " 占的列数
+const WHEEL_LINES = 3; // 滚轮每格滚几行预览，和 Shift+↑↓ 一样
+const AUTO_SCROLL_MS = 50; // 拖选拖出预览上下边时自动滚动的节奏，和 pi-tui 一样
+const HINT_MS = 1500; // 底部"已复制"提示停留时间
+
 export class PeekComponent implements Component, Focusable {
   private input: Input;
   private scope: "current" | "all";
@@ -33,6 +42,16 @@ export class PeekComponent implements Component, Focusable {
   private renameInput: Input;
   private cachedWidth = -1;
   private cachedLines: string[] = [];
+  private layout = { lw: 0, rw: 0, H: 0 }; // 最近一次 render 的分栏尺寸，鼠标定位用
+  private scopeSpan: [number, number] = [0, 0]; // 头部"范围"字样占的列区间，点击切换范围
+  private sel?: Selection; // 鼠标拖出来的选区，只在一栏里
+  private dragging = false; // 左键还按着
+  private selMoved = false; // 按下之后拖过没有；没拖过的选区不显示也不算数（那是单击）
+  private dragX = 0; // 最近一次拖动的列，自动滚动时焦点跟着它
+  private autoScrollDir = 0; // 拖出预览上下边：-1 往上 1 往下
+  private autoScrollTimer?: ReturnType<typeof setInterval>;
+  private hint?: { text: string; ok: boolean }; // 底部一闪而过的复制结果
+  private hintTimer?: ReturnType<typeof setTimeout>;
   private _focused = false;
 
   // 由 index.ts 注入
@@ -41,7 +60,10 @@ export class PeekComponent implements Component, Focusable {
   onCancel?: () => void;
   onDelete?: (s: PeekSession) => Promise<boolean>;
   onRename?: (s: PeekSession, name: string) => Promise<boolean>;
+  onCopy?: (text: string) => Promise<boolean>; // 拖选后 Ctrl+C
+  onDispose?: () => void; // 关闭时
   requestRender?: () => void; // 异步操作完成后让 TUI 重画
+  afterRender?: () => void; // 每次 render 之后调用；常规模式的鼠标桥接靠它重新测组件在屏幕上的位置
 
   constructor(
     private all: PeekSession[],
@@ -97,6 +119,33 @@ export class PeekComponent implements Component, Focusable {
     this.selected = idx >= 0 ? idx : keepSelection ? Math.min(this.selected, Math.max(0, out.length - 1)) : 0;
     if (!keepSelection) this.listOffset = 0;
     this.previewKey = "";
+    this.clearSelection();
+  }
+
+  // 换选中的会话：预览重建，拖选的选区作废
+  private select(idx: number): void {
+    this.selected = idx;
+    this.previewKey = "";
+    this.clearSelection();
+  }
+
+  private clearSelection(): void {
+    this.sel = undefined;
+    this.dragging = false;
+    this.selMoved = false;
+    this.stopAutoScroll();
+  }
+
+  // 拖过的才算选区，只按下没拖的是单击
+  private activeSel(): Selection | undefined {
+    return this.sel && this.selMoved ? this.sel : undefined;
+  }
+
+  dispose(): void {
+    this.stopAutoScroll();
+    if (this.hintTimer) clearTimeout(this.hintTimer);
+    this.hintTimer = undefined;
+    this.onDispose?.();
   }
 
   private bodyHeight(): number {
@@ -152,6 +201,7 @@ export class PeekComponent implements Component, Focusable {
               // 选中位置留在原地
               this.selected = Math.min(this.selected, Math.max(0, this.filtered.length - 1));
               this.previewKey = "";
+              this.clearSelection();
             }
             this.invalidate();
             this.requestRender?.();
@@ -161,6 +211,11 @@ export class PeekComponent implements Component, Focusable {
       return;
     }
     if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
+      // 有拖选的选区时 Ctrl+C 是复制，和终端里的习惯一样；没有才是关闭
+      if (matchesKey(data, Key.ctrl("c")) && this.activeSel()) {
+        this.copySelection();
+        return;
+      }
       this.onCancel?.();
       return;
     }
@@ -189,16 +244,14 @@ export class PeekComponent implements Component, Focusable {
     }
     if (matchesKey(data, Key.up)) {
       if (this.selected > 0) {
-        this.selected--;
-        this.previewKey = "";
+        this.select(this.selected - 1);
         this.invalidate();
       }
       return;
     }
     if (matchesKey(data, Key.down)) {
       if (this.selected < this.filtered.length - 1) {
-        this.selected++;
-        this.previewKey = "";
+        this.select(this.selected + 1);
         this.invalidate();
       }
       return;
@@ -228,6 +281,7 @@ export class PeekComponent implements Component, Focusable {
     if (matchesKey(data, Key.ctrl("t"))) {
       this.showTools = !this.showTools;
       this.previewKey = "";
+      this.clearSelection();
       this.invalidate();
       return;
     }
@@ -256,6 +310,202 @@ export class PeekComponent implements Component, Focusable {
     this.invalidate();
   }
 
+  // 硬件光标在组件内的行号：搜索框在第 1 行，改名时在最后一行。常规模式的鼠标桥接靠它算组件顶行
+  cursorRow(): number | undefined {
+    if (!this._focused || !this.layout.H) return undefined;
+    return this.renaming ? BODY_TOP + this.layout.H + 1 : 1;
+  }
+
+  // 鼠标：左栏按下选中、双击进入、滚轮换选中项；右栏滚轮滚预览；点头部"范围"切换；点输入框移光标；
+  // 在任一栏里按住拖动是选文字，只选这一栏，Ctrl+C 复制。
+  // 全屏模式由 pi-tui 按布局直接调，常规模式由 mouse.ts 换算成组件内坐标后调。坐标以组件左上角为原点
+  handleMouse(ev: TuiMouseEvent): TuiMouseEventResult | undefined {
+    const { lw, H } = this.layout;
+    if (!H) return undefined; // 还没画过，不知道分栏在哪
+    const inList = ev.x < lw;
+    const bodyRow = ev.y - BODY_TOP;
+    const inBody = bodyRow >= 0 && bodyRow < H;
+    const itemAt = (): number => (inList && inBody ? this.listOffset + (bodyRow >> 1) : -1); // 每项两行
+
+    if (ev.type === "wheel") {
+      const delta = ev.wheelDelta ?? 0;
+      if (!delta) return undefined;
+      let changed = this.confirmingDelete; // 和按键一样，滚一下就算取消确认，免得删错换过去的那条
+      this.confirmingDelete = false;
+      if (inList) {
+        if (!this.renaming) {
+          // 改名中换了会话就改错对象了
+          const next = Math.max(0, Math.min(this.filtered.length - 1, this.selected + delta));
+          if (next !== this.selected) {
+            this.select(next);
+            changed = true;
+          }
+        }
+      } else {
+        const maxOff = Math.max(0, this.previewLines.length - H);
+        const next = Math.max(0, Math.min(maxOff, this.previewOffset + delta * WHEEL_LINES));
+        if (next !== this.previewOffset) {
+          this.previewOffset = next;
+          changed = true;
+        }
+      }
+      if (changed) this.invalidate();
+      return { handled: true, render: changed };
+    }
+    if (ev.type === "drag") {
+      if (!this.dragging || !this.sel || ev.button !== "left") return undefined;
+      this.dragX = ev.x;
+      const changed = this.dragTo(ev.x, ev.y);
+      if (changed) this.selMoved = true;
+      // 右栏拖出上下边就自动滚；左栏不滚，列表是跟着选中项走的
+      if (this.sel.pane === "preview") this.setAutoScroll(bodyRow < 0 ? -1 : bodyRow >= H ? 1 : 0);
+      if (changed) this.invalidate();
+      return { handled: true, render: changed };
+    }
+    if (ev.button !== "left") return undefined;
+    if (ev.type === "release") {
+      if (!this.dragging) return undefined;
+      this.dragging = false;
+      this.stopAutoScroll();
+      if (!this.selMoved) this.sel = undefined; // 没拖过就是单击
+      return { handled: true, render: false };
+    }
+    if (ev.type === "click") {
+      // 单击在 press 里已经选中了，双击才进入
+      const s = this.filtered[itemAt()];
+      if (!s) return undefined;
+      if (!this.renaming && (ev.clickCount ?? 1) >= 2) this.onResume?.(s);
+      return { handled: true, render: false };
+    }
+    if (ev.type !== "press") return undefined;
+
+    // 删除确认和已有的选区：点一下就没了，和按键一样
+    let changed = this.confirmingDelete || this.activeSel() !== undefined;
+    this.confirmingDelete = false;
+    this.clearSelection();
+    let handled = changed;
+    if (this.renaming) {
+      if (ev.y === BODY_TOP + H + 1) {
+        // 改名行：点哪里光标就去哪里
+        this.renameInput.handleMouse({ ...ev, x: ev.x - visibleWidth(msg("renamePrefix")), y: 0 });
+        handled = changed = true;
+      }
+    } else if (ev.y === 1) {
+      this.input.handleMouse({ ...ev, y: 0 });
+      handled = changed = true;
+    } else if (ev.y === 0) {
+      if (ev.x >= this.scopeSpan[0] && ev.x < this.scopeSpan[1]) {
+        this.scope = this.scope === "all" ? "current" : "all";
+        this.refilter();
+        handled = changed = true;
+      }
+    } else {
+      const idx = itemAt();
+      if (idx >= 0 && idx < this.filtered.length && idx !== this.selected) {
+        this.select(idx);
+        changed = true;
+      }
+    }
+    if (inBody) {
+      // 两栏里按下都可能是拖选的起点，拖起来才算数；接管后面的拖动和松开
+      const pane: Pane = inList ? "list" : "preview";
+      const cell = this.cellAt(pane, ev.x, bodyRow);
+      this.sel = { pane, anchor: cell, focus: { ...cell } };
+      this.dragging = true;
+      this.dragX = ev.x;
+      handled = true;
+    }
+    if (!handled) return undefined;
+    if (changed) this.invalidate();
+    return inBody ? { handled: true, capture: true, render: changed } : { handled: true, render: changed };
+  }
+
+  // 屏幕位置换成某一栏的内容坐标：行是内容的绝对行号，列夹在这一栏里，拖到栏外也只选栏内的字
+  private cellAt(pane: Pane, x: number, bodyRow: number): Cell {
+    const { lw, rw, H } = this.layout;
+    const row = Math.max(0, Math.min(H - 1, bodyRow));
+    if (pane === "list") return { row: this.listOffset * 2 + row, col: Math.max(0, Math.min(lw - 1, x)) };
+    return { row: this.previewOffset + row, col: Math.max(0, Math.min(rw - 1, x - lw - SEP)) };
+  }
+
+  // 拖到某个位置：焦点跟过去。返回有没有变
+  private dragTo(x: number, y: number): boolean {
+    if (!this.sel) return false;
+    const cell = this.cellAt(this.sel.pane, x, y - BODY_TOP);
+    if (cell.row === this.sel.focus.row && cell.col === this.sel.focus.col) return false;
+    this.sel.focus = cell;
+    return true;
+  }
+
+  private setAutoScroll(dir: number): void {
+    this.autoScrollDir = dir;
+    if (!dir) {
+      this.stopAutoScroll();
+      return;
+    }
+    if (this.autoScrollTimer) return;
+    this.autoScrollTimer = setInterval(() => this.autoScrollTick(), AUTO_SCROLL_MS);
+    this.autoScrollTimer.unref?.();
+  }
+
+  // 每次滚一行，焦点跟着指针：指针在上边就是视口第一行，在下边就是最后一行
+  private autoScrollTick(): void {
+    const { H } = this.layout;
+    const maxOff = Math.max(0, this.previewLines.length - H);
+    const next = Math.max(0, Math.min(maxOff, this.previewOffset + this.autoScrollDir));
+    if (!this.sel || !this.dragging || next === this.previewOffset) {
+      this.stopAutoScroll();
+      return;
+    }
+    this.previewOffset = next;
+    if (this.dragTo(this.dragX, this.autoScrollDir < 0 ? BODY_TOP - 1 : BODY_TOP + H)) this.selMoved = true;
+    this.invalidate();
+    this.requestRender?.();
+  }
+
+  private stopAutoScroll(): void {
+    if (this.autoScrollTimer) clearInterval(this.autoScrollTimer);
+    this.autoScrollTimer = undefined;
+    this.autoScrollDir = 0;
+  }
+
+  // 选区里的纯文本
+  private selectionToText(sel: Selection): string {
+    const { lw, rw } = this.layout;
+    if (sel.pane === "preview") return selectionText(sel, rw, (row) => this.previewLines[row]);
+    const { rt, hasBody } = this.listTerms();
+    return selectionText(sel, lw, (row) => {
+      const s = this.filtered[row >> 1];
+      return s && this.listRows(s, (row >> 1) === this.selected, lw, rt, hasBody)[row & 1];
+    });
+  }
+
+  // Ctrl+C：复制选区，清掉高亮，底部闪一下结果
+  private copySelection(): void {
+    const sel = this.activeSel();
+    if (!sel) return;
+    const text = this.selectionToText(sel);
+    const n = text.split("\n").length;
+    this.clearSelection();
+    this.invalidate();
+    if (!text.trim() || !this.onCopy) return;
+    void this.onCopy(text).then((ok) => this.showHint(ok ? msg("copied", { n }) : msg("copyFailed"), ok));
+  }
+
+  private showHint(text: string, ok: boolean): void {
+    this.hint = { text, ok };
+    if (this.hintTimer) clearTimeout(this.hintTimer);
+    this.hintTimer = setTimeout(() => {
+      this.hintTimer = undefined;
+      this.hint = undefined;
+      this.invalidate();
+      this.requestRender?.();
+    }, HINT_MS);
+    this.hintTimer.unref?.();
+    this.invalidate();
+    this.requestRender?.();
+  }
+
   // 预览里跳到当前视口之外的下一个 / 上一个命中行，到头了回绕。同一屏里的多个命中算一处，
   // 否则一段里连着几行都命中要按好几次才过得去
   private jumpMatch(dir: 1 | -1): void {
@@ -275,11 +525,37 @@ export class PeekComponent implements Component, Focusable {
     }
   }
 
+  // 左栏用的关键词：排除词和 name: / cwd: 不在正文里高亮
+  private listTerms(): { rt: RoleTerms; hasBody: boolean } {
+    const rt = roleTerms(this.query().terms);
+    return { rt, hasBody: rt.user.length > 0 || rt.assistant.length > 0 };
+  }
+
+  // 左栏一个会话的两行：时间 + 目录（有正文关键词时加命中数），首条消息或命中片段
+  private listRows(s: PeekSession, sel: boolean, lw: number, rt: RoleTerms, hasBody: boolean): [string, string] {
+    const t = this.theme;
+    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)];
+  }
+
   // 左栏，每个会话两行
   private buildList(height: number, lw: number): string[] {
-    const t = this.theme;
-    const rt = roleTerms(this.query().terms); // 排除词和 name: / cwd: 不在正文里高亮
-    const hasBody = rt.user.length > 0 || rt.assistant.length > 0;
+    const { rt, hasBody } = this.listTerms();
     const visible = Math.max(1, Math.floor(height / 2));
     if (this.selected < this.listOffset) this.listOffset = this.selected;
     if (this.selected >= this.listOffset + visible) {
@@ -294,26 +570,7 @@ export class PeekComponent implements Component, Focusable {
         rows.push(" ".repeat(lw), " ".repeat(lw));
         continue;
       }
-      const sel = idx === this.selected;
-      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) {
-        rows.push(t.bg("selectedBg", padEndVisible(t.fg("accent", truncateToWidth(l1, lw)), lw)));
-        rows.push(t.bg("selectedBg", padEndVisible(truncateToWidth(l2, lw), lw)));
-      } else {
-        rows.push(padEndVisible(l1, lw));
-        rows.push(padEndVisible(t.fg("dim", truncateToWidth(l2, lw)), lw));
-      }
+      rows.push(...this.listRows(s, idx === this.selected, lw, rt, hasBody));
     }
     // 每项两行，height 是奇数时会少一行，补空行，否则最后一行右栏会顶到左边
     while (rows.length < height) rows.push(" ".repeat(lw));
@@ -441,16 +698,24 @@ export class PeekComponent implements Component, Focusable {
   render(width: number): string[] {
     const H = this.bodyHeight();
     const cacheKey = width * 1000 + H; // 宽或高变了都要重画
-    if (this.cachedWidth === cacheKey) return this.cachedLines;
+    if (this.cachedWidth === cacheKey) {
+      // 缓存命中时组件在屏幕上的位置也可能变了（上面多了一行状态提示），照样通知一次，桥接那边自己去重
+      this.afterRender?.();
+      return this.cachedLines;
+    }
     const t = this.theme;
     const lw = Math.max(26, Math.min(56, Math.floor(width * 0.4)));
     const rw = Math.max(20, width - lw - 3);
+    this.layout = { lw, rw, H };
 
     const out: string[] = [];
 
     // 头部：标题、范围、时间过滤、匹配数，然后是搜索框
     const scopeLabel = this.scope === "all" ? msg("scopeAll") : msg("scopeCurrent");
     const { sinceLabel } = this.query();
+    // 「范围[Tab]: 当前目录树」整段都能点
+    const scopeStart = visibleWidth(msg("title"));
+    this.scopeSpan = [scopeStart, scopeStart + visibleWidth(msg("scopeLabel") + scopeLabel)];
     const head =
       t.fg("accent", t.bold(msg("title"))) +
       t.fg("dim", msg("scopeLabel")) +
@@ -478,17 +743,26 @@ export class PeekComponent implements Component, Focusable {
     if (this.previewLines.length > H) info += ` (${this.previewOffset + 1}-${end}/${this.previewLines.length})`;
     const scrollInfo = info ? t.fg("dim", info) : "";
 
+    const sel = this.activeSel();
     for (let i = 0; i < H; i++) {
-      const l = leftRows[i] ?? " ".repeat(lw);
+      let l = leftRows[i] ?? " ".repeat(lw);
       let r = rightRows[i] ?? "";
-      if (i === 0 && scrollInfo) {
-        r = truncateToWidth(r, Math.max(0, rw - visibleWidth(scrollInfo))) + scrollInfo;
+      const infoW = i === 0 && scrollInfo ? visibleWidth(scrollInfo) : 0;
+      if (infoW) r = truncateToWidth(r, Math.max(0, rw - infoW));
+      r = padEndVisible(r, rw - infoW) + (infoW ? scrollInfo : "");
+      // 拖选的高亮最后叠上去，反显整格；右栏第一行别盖到右上角的命中信息
+      if (sel?.pane === "list") {
+        const cols = rowColumns(sel, this.listOffset * 2 + i, l, lw);
+        if (cols) l = highlightColumns(l, cols[0], cols[1]);
+      } else if (sel?.pane === "preview") {
+        const cols = rowColumns(sel, this.previewOffset + i, r, rw - infoW);
+        if (cols) r = highlightColumns(r, cols[0], cols[1]);
       }
       // 左栏在 buildList 里已经 pad 到 lw，这里再 pad 会把带样式的行截坏
-      out.push(l + t.fg("borderMuted", " │ ") + padEndVisible(r, rw));
+      out.push(l + t.fg("borderMuted", " │ ") + r);
     }
 
-    // 底部：重命名和删除确认时换成对应的操作行
+    // 底部：重命名和删除确认时换成对应的操作行，复制结果和选区提示也在这里
     out.push(t.fg("borderMuted", "─".repeat(width)));
     if (this.renaming) {
       const prefix = msg("renamePrefix");
@@ -503,6 +777,11 @@ export class PeekComponent implements Component, Focusable {
           width,
         ),
       );
+    } else if (this.hint) {
+      out.push(truncateToWidth(t.fg(this.hint.ok ? "success" : "error", this.hint.text), width));
+    } else if (sel) {
+      const [s, e] = bounds(sel);
+      out.push(truncateToWidth(t.fg("warning", msg("selHint", { n: e.row - s.row + 1 })), width));
     } else {
       out.push(
         truncateToWidth(
@@ -514,6 +793,7 @@ export class PeekComponent implements Component, Focusable {
 
     this.cachedWidth = cacheKey;
     this.cachedLines = out;
+    this.afterRender?.();
     return out;
   }
 

package/src/selection.ts

@@ -0,0 +1,96 @@
+import { sliceByColumn, stripTerminalSequences, visibleWidth } from "@earendil-works/pi-tui";
+
+// 鼠标拖出来的选区。只在一个栏里：行号是这一栏内容的绝对行号（左栏每个会话两行，右栏是预览行），
+// 列号是栏内列号。起止格都算在内，中间的行整行选中，所以从左栏拖到右栏也只会选左栏的字
+
+export type Pane = "list" | "preview";
+
+export interface Cell {
+  row: number;
+  col: number;
+}
+
+export interface Selection {
+  pane: Pane;
+  anchor: Cell; // 按下的格
+  focus: Cell; // 现在拖到的格
+}
+
+// CSI / OSC / APC 序列，反显时要原样保留
+const SEQ = /\x1b\[[0-9;?<>=!]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b_[^\x07\x1b]*(?:\x07|\x1b\\)/g;
+const TAIL = new RegExp(`(?:${SEQ.source})+$`); // 行尾的样式收尾码
+const graphemes = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+
+/** 起止格，按阅读顺序 */
+export function bounds(sel: Selection): [Cell, Cell] {
+  const a = sel.anchor;
+  const f = sel.focus;
+  const ordered = a.row < f.row || (a.row === f.row && a.col <= f.col);
+  return ordered ? [a, f] : [f, a];
+}
+
+// 每个字符占的列区间，宽字符两列
+function cells(line: string): { start: number; end: number }[] {
+  const out: { start: number; end: number }[] = [];
+  let col = 0;
+  for (const { segment } of graphemes.segment(stripTerminalSequences(line))) {
+    const w = visibleWidth(segment);
+    if (w > 0) out.push({ start: col, end: col + w });
+    col += w;
+  }
+  return out;
+}
+
+/**
+ * 某一行被选中的列区间 [c0, c1)。边界吸附到整个字符，宽字符不会被切掉一半；
+ * 这一行不在选区里返回 undefined。width 是这一栏的宽度
+ */
+export function rowColumns(sel: Selection, row: number, line: string, width: number): [number, number] | undefined {
+  const [s, e] = bounds(sel);
+  if (row < s.row || row > e.row) return undefined;
+  let c0 = row === s.row ? s.col : 0;
+  let c1 = row === e.row ? e.col + 1 : width;
+  const cs = cells(line);
+  const g0 = cs.find((g) => c0 >= g.start && c0 < g.end);
+  if (g0) c0 = g0.start;
+  const g1 = cs.find((g) => c1 - 1 >= g.start && c1 - 1 < g.end);
+  if (g1) c1 = g1.end;
+  c0 = Math.max(0, Math.min(c0, width));
+  c1 = Math.max(c0, Math.min(c1, width));
+  return c1 > c0 ? [c0, c1] : undefined;
+}
+
+// 整段反显。段里原有的样式码照留，每个样式码后面补一次反显，免得被 0m 之类的重置掉
+function inverse(text: string): string {
+  let out = "\x1b[7m";
+  let last = 0;
+  for (const m of text.matchAll(SEQ)) {
+    out += text.slice(last, m.index) + m[0];
+    if (m[0].startsWith("\x1b[") && m[0].endsWith("m")) out += "\x1b[7m";
+    last = m.index + m[0].length;
+  }
+  return out + text.slice(last) + "\x1b[27m";
+}
+
+/** 给一行的 [c0, c1) 列加反显，其余部分原样 */
+export function highlightColumns(line: string, c0: number, c1: number): string {
+  const w = visibleWidth(line);
+  const before = sliceByColumn(line, 0, c0, true);
+  const mid = sliceByColumn(line, c0, c1 - c0, true);
+  const after = sliceByColumn(line, c1, Math.max(0, w - c1), true);
+  // sliceByColumn 切到行尾时会丢掉最后那些收尾码（39m、49m 之类），补回去，否则背景色会漏到右边
+  const tail = TAIL.exec(line)?.[0] ?? "";
+  return before + inverse(mid) + after + tail;
+}
+
+/** 选区里的纯文本：每行去掉样式和尾部空白，行间用换行。lineAt 给不出的行当空行 */
+export function selectionText(sel: Selection, width: number, lineAt: (row: number) => string | undefined): string {
+  const [s, e] = bounds(sel);
+  const lines: string[] = [];
+  for (let row = s.row; row <= e.row; row++) {
+    const line = lineAt(row) ?? "";
+    const cols = rowColumns(sel, row, line, width);
+    lines.push(cols ? stripTerminalSequences(sliceByColumn(line, cols[0], cols[1] - cols[0], true)).trimEnd() : "");
+  }
+  return lines.join("\n");
+}