mocode-ai 0.1.10 → 0.2.0

package/dist/ui/clipboard.js

@@ -0,0 +1,118 @@
+import { stdout, platform } from 'node:process';
+import { spawn } from 'node:child_process';
+/**
+ * 系统剪贴板读写(叶子模块,无 UI 依赖)。
+ *
+ * 写入(copyToClipboard):选区复制(layout 鼠标选择)与 /copy 等命令共用,双通道:
+ *  1. OSC 52(`\x1B]52;c;<base64>\x07`):请求终端把文本写入系统剪贴板。经终端转发,SSH / 远程也生效;
+ *     Windows Terminal ≥1.16、iTerm2、kitty、WezTerm 等支持(部分终端默认关,需开"允许应用访问剪贴板")。
+ *  2. 本地原生工具(best-effort,失败静默):win32=clip.exe(UTF-16LE)、darwin=pbcopy、
+ *     linux=wl-copy / xclip / xsel。覆盖 OSC52 被禁用的场景(如部分 VS Code 集成终端配置)。
+ * 两条都发:哪条生效由环境决定,重复写同一内容无副作用。
+ *
+ * 读取(readClipboard):OSC 52 是单向的(终端不会把剪贴板内容回传给应用,即便发 `\x1B]52;c;?\x07`
+ * 请求读取,多数终端出于安全考虑不响应),故读只能靠本地原生工具:win32=PowerShell Get-Clipboard、
+ * darwin=pbpaste、linux=wl-paste / xclip -o / xsel -o。供鼠标点击输入框时"贴入"用。
+ */
+/** OSC 52:base64(UTF-8) 写系统剪贴板(c=clipboard 选区)。 */
+function osc52(text) {
+    const b64 = Buffer.from(text, 'utf8').toString('base64');
+    // 长度保护:部分终端对 OSC52 载荷有上限(常见 ~74KB / 100KB),超限直接跳过 OSC52
+    // (仍走原生通道),避免半截 base64 污染终端。
+    if (b64.length > 100000)
+        return;
+    stdout.write(`\x1B]52;c;${b64}\x07`);
+}
+/** spawn 一个吃 stdin 的剪贴板工具,把 buf 写入其 stdin;所有错误静默(best-effort)。 */
+function pipeTo(cmd, args, buf) {
+    try {
+        const p = spawn(cmd, args, {
+            stdio: ['pipe', 'ignore', 'ignore'],
+            windowsHide: true,
+        });
+        p.on('error', () => { }); // 命令不存在等:静默(OSC52 兜底)
+        p.stdin.on('error', () => { });
+        p.stdin.end(buf);
+    }
+    catch {
+        // 忽略
+    }
+}
+/** 本地原生剪贴板(best-effort)。 */
+function nativeCopy(text) {
+    if (platform === 'win32') {
+        // clip.exe 在 Win10+ 接受 UTF-16LE 字节(无 BOM),可正确处理中文/emoji;
+        // 直接管 UTF-8 会按控制台代码页解码致乱码,故用 utf16le。
+        pipeTo('clip', [], Buffer.from(text, 'utf16le'));
+    }
+    else if (platform === 'darwin') {
+        pipeTo('pbcopy', [], Buffer.from(text, 'utf8'));
+    }
+    else {
+        // linux:Wayland 优先 wl-copy,X11 退 xclip / xsel(装了哪个用哪个;spawn error 静默跳过)
+        const b = Buffer.from(text, 'utf8');
+        pipeTo('wl-copy', [], b);
+        pipeTo('xclip', ['-selection', 'clipboard'], b);
+        pipeTo('xsel', ['--clipboard', '--input'], b);
+    }
+}
+/** 写入系统剪贴板(OSC52 + 本地原生双通道)。 */
+export function copyToClipboard(text) {
+    if (!text)
+        return;
+    osc52(text);
+    nativeCopy(text);
+}
+/** spawn 一个不吃 stdin、把 stdout 收集成字符串的命令;失败返回 null(不抛)。 */
+function captureOutput(cmd, args, encoding) {
+    return new Promise((resolve) => {
+        try {
+            const p = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
+            const chunks = [];
+            let settled = false;
+            const finish = (v) => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve(v);
+            };
+            p.stdout.on('data', (c) => chunks.push(c));
+            p.stdout.on('error', () => finish(null));
+            p.on('error', () => finish(null));
+            p.on('close', (code) => {
+                if (code !== 0)
+                    return finish(null);
+                finish(Buffer.concat(chunks).toString(encoding));
+            });
+        }
+        catch {
+            resolve(null);
+        }
+    });
+}
+/**
+ * 读取系统剪贴板(本地原生工具,OSC52 无法读取——终端不回传)。
+ * win32 用 PowerShell -NoProfile Get-Clipboard(比 clip.exe 只写无读更可靠,系统自带无需安装);
+ * darwin=pbpaste;linux 依次尝试 wl-paste / xclip -o / xsel -o,装了哪个用哪个。
+ * 都失败返回空串(不抛),调用方按"无内容可贴"处理。
+ */
+export async function readClipboard() {
+    if (platform === 'win32') {
+        // Get-Clipboard 默认按控制台代码页输出;显式转 UTF8 避免中文乱码。
+        const out = await captureOutput('powershell', ['-NoProfile', '-NonInteractive', '-Command',
+            '[Console]::OutputEncoding=[System.Text.Encoding]::UTF8; Get-Clipboard -Raw'], 'utf8');
+        return out?.replace(/\r\n/g, '\n').replace(/\r$/, '') ?? '';
+    }
+    if (platform === 'darwin') {
+        return (await captureOutput('pbpaste', [], 'utf8')) ?? '';
+    }
+    // linux:按顺序试,第一个成功(非 null)即用
+    const wl = await captureOutput('wl-paste', ['--no-newline'], 'utf8');
+    if (wl != null)
+        return wl;
+    const xc = await captureOutput('xclip', ['-selection', 'clipboard', '-o'], 'utf8');
+    if (xc != null)
+        return xc;
+    const xs = await captureOutput('xsel', ['--clipboard', '--output'], 'utf8');
+    return xs ?? '';
+}

package/dist/ui/content.js

@@ -104,3 +104,8 @@ export function sliceFromEnd(offset, count) {
 export function totalRows() {
     return rows.length + (hasCurrent ? 1 : 0);
 }
+/** 取绝对行索引(0-based,含当前行)的原始自洽行;越界返 null。供鼠标选区文本提取。 */
+export function lineAt(abs) {
+    const all = snapshot();
+    return abs >= 0 && abs < all.length ? all[abs] : null;
+}

package/dist/ui/intervention.js

@@ -3,6 +3,7 @@ import { stdin, stderr } from 'node:process';
 import { ui } from './theme.js';
 import { displayWidth, truncateDisplay } from './render.js';
 import * as layout from './layout.js';
+import * as mouse from './mouse.js';
 import { Spinner } from './spinner.js';
 const emitter = stdin;
 /** choice 末尾的"自定义输入"项标签(纯 ASCII,宽度安全)。选中后切到 input 子态。 */
@@ -123,6 +124,7 @@ export async function promptIntervention(req) {
     }
     /** 退出:摘自己的监听 + 恢复快照监听 + 擦菜单恢复内容区。不 setRawMode(false)/pause stdin(运行态由 repl 接管)。 */
     function cleanup() {
+        layout.setMouseEnabled(true); // 恢复鼠标框选(面板期间禁,防拖拽覆盖菜单)
         emitter.removeListener('keypress', onKey);
         for (const l of savedListeners)
             emitter.on('keypress', l);
@@ -147,6 +149,10 @@ export async function promptIntervention(req) {
     function onKey(_str, key) {
         if (resolved || !key)
             return;
+        // 鼠标 fragment:滚轮走 handleMouseEvent(mouseEnabled=true 时仍可滚动查看内容,与之前行为一致);
+        // 框选/拖拽在面板期间被 layout.setMouseEnabled(false) 挡掉(防 viewport 重画覆盖菜单)。
+        if (mouse.swallow(key.sequence ?? ''))
+            return;
         // Ctrl+C → 取消(不 reject SIGINT——否则经 executeTool 的 try/catch 变成 tool 错误串)
         if (key.ctrl && key.name === 'c') {
             finish({ action: 'cancelled' });
@@ -265,8 +271,9 @@ export async function promptIntervention(req) {
     return new Promise((res, rej) => {
         resolve = res;
         try {
-            // 进入面板:停 spinner(避免 onFrame 覆盖)+ 回尾(若用户正滚动回看)
+            // 进入面板:停 spinner(避免 onFrame 覆盖)+ 禁鼠标框选(防拖拽 viewport 重画覆盖菜单)+ 回尾(若用户正滚动回看)
             Spinner.pauseCurrent();
+            layout.setMouseEnabled(false);
             layout.resetScroll();
             // 快照现有 keypress 监听(运行态的 onRunningKey)并摘掉,挂自己的 onKey
             savedListeners = emitter.listeners('keypress').slice();
@@ -286,6 +293,7 @@ export async function promptIntervention(req) {
         }
         catch (e) {
             // 进入失败:必须恢复运行态监听,否则 onRunningKey 残留摘除 → 本 turns 的 Ctrl+C/滚动/typeahead 全废
+            layout.setMouseEnabled(true);
             try {
                 emitter.removeListener('keypress', onKey);
             }

package/dist/ui/layout.js

@@ -2,9 +2,11 @@ import { stdin, stdout } from 'node:process';
 import { appendFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { charWidth, displayWidth, truncateDisplay, truncateDisplayHead, ansiDisplayWidth, wrapByDisplayWidth, fmtElapsed, } from './render.js';
+import { charWidth, displayWidth, truncateDisplay, truncateDisplayHead, ansiDisplayWidth, wrapByDisplayWidth, fmtElapsed, stripAnsi, sliceByDisplayCol, } from './render.js';
 import { ui } from './theme.js';
 import * as content from './content.js';
+import * as mouse from './mouse.js';
+import { copyToClipboard, readClipboard } from './clipboard.js';
 import { renderMarkdown } from './markdown.js';
 // ── 内部状态 ──
 let active = false;
@@ -46,16 +48,26 @@ let sigwinchHandler = null;
 // 非 md 写(contentWrite)先 commitMd 收尾(清 segMark,后续写不再被 setLines 截断)。
 let mdActive = false;
 let mdBuf = '';
+let selection = null;
+let selecting = false; // 左键按下中(press→release 之间)
+let mouseEnabled = true; // 导航菜单(picker)期间置 false:只吞报表不做选区/滚动,防菜单被 viewport 重画覆盖
+const WHEEL_LINES = 3; // 滚轮每格滚动行数
+// 点击输入框粘贴:当前文本输入方(prompt.ts / repl 运行态 typeahead)注册回调,接收剪贴板文本贴入。
+// 只在输入区(底栏输入行)内右键单击(未拖动)时触发——与内容区选区互不干扰(内容区左键=框选,右键=复制)。
+let pasteHandler = null;
 const esc = {
     altOn: '\x1B[?1049h',
     altOff: '\x1B[?1049l',
-    // xterm alternate scroll mode(DECSET 1007):alt 屏内滚轮转发 ↑/↓ 键序列(\x1B[A/\x1B[B),
-    // 不抓取任何鼠标点击/拖拽事件——终端原生框选与复制全程可用,不需要按 Shift 逃生。
-    // 主流终端(Windows Terminal ≥1.14、xterm、VTE 系 GNOME Terminal、Konsole、iTerm2)均支持;
-    // 不支持的终端会静默忽略此转义序列,退化为"滚轮不滚动,但选区复制始终能用"——不会更差。
-    // 滚轮转发出的 ↑/↓ 由 onKey/onRunningKey 现有的 plain ↑/↓ 分支接住(见下方 scrollBy 调用点)。
-    altScrollOn: '\x1B[?1007h',
-    altScrollOff: '\x1B[?1007l',
+    // 完整鼠标追踪(仿 Claude Code 全屏渲染):1000=按键(按下/释放)+ 1002=拖动 motion + 1006=SGR 编码。
+    // 拿到按下/拖动/释放的坐标后,由 layout 在应用层维护选区(mouse.ts 重组报表 → handleMouseEvent):
+    //  - 左键:内容区按下开选区、拖动扩展(触边自动翻页跨屏)、释放只留高亮,不自动复制;输入框不响应
+    //    (不干扰正常打字/焦点)。
+    //  - 右键(单击,press→release 未拖动):落在输入框 → 读剪贴板贴入(setPasteHandler 回调);
+    //    落在内容区 → 复制当前选区(若有)到剪贴板(clipboard.ts),静默不弹提示。
+    //  - 滚轮报表(button&64)转 scrollBy。
+    // 代价:终端原生框选被鼠标捕获接管——想用终端原生选区可按住 Shift(多数终端放行)。
+    mouseOn: '\x1B[?1000h\x1B[?1002h\x1B[?1006h',
+    mouseOff: '\x1B[?1006l\x1B[?1002l\x1B[?1000l', // 关:反序
     cursorShow: '\x1B[?25h',
     cursorHide: '\x1B[?25l',
     clearLine: '\x1B[2K',
@@ -389,9 +401,63 @@ export function clearContent() {
 export function isScrolled() {
     return scrollOffset > 0;
 }
+/** viewport 窗口起点绝对行索引(0-based,对齐 content.sliceFromEnd 的 start)。 */
+function viewportAbsStart() {
+    const g = getGeo();
+    const total = content.totalRows();
+    const end = Math.max(0, total - scrollOffset);
+    return Math.max(0, end - g.contentBottom);
+}
+/** 屏行(1-based,内容区内)→ 绝对缓冲行索引(0-based)。 */
+function screenRowToAbsLine(row) {
+    return viewportAbsStart() + (row - 1);
+}
+/** 选区归一化(anchor/end 按阅读顺序排序为 start/end)。无选区返 null。 */
+function normalizeSelection() {
+    if (!selection)
+        return null;
+    const a = { line: selection.anchorLine, col: selection.anchorCol };
+    const b = { line: selection.endLine, col: selection.endCol };
+    const aFirst = a.line < b.line || (a.line === b.line && a.col <= b.col);
+    return aFirst
+        ? { startLine: a.line, startCol: a.col, endLine: b.line, endCol: b.col }
+        : { startLine: b.line, startCol: b.col, endLine: a.line, endCol: a.col };
+}
+/** 给自洽带色行的显示列区间 [colStart,colEnd) 套反白(\x1B[7m...\x1B[27m),SGR 码原样穿过不受影响。 */
+function highlightRange(line, colStart, colEnd) {
+    if (colEnd <= colStart)
+        return line;
+    const parts = line.split(/(\x1b\[[0-9;]*m)/);
+    let w = 0;
+    let out = '';
+    let opened = false;
+    for (let i = 0; i < parts.length; i++) {
+        if (i % 2 === 1) {
+            out += parts[i]; // SGR 码原样穿过
+            continue;
+        }
+        for (const ch of parts[i]) {
+            const cw = charWidth(ch.codePointAt(0) ?? 0);
+            if (!opened && w >= colStart && w < colEnd) {
+                out += '\x1B[7m';
+                opened = true;
+            }
+            if (opened && w >= colEnd) {
+                out += '\x1B[27m';
+                opened = false;
+            }
+            out += ch;
+            w += cw;
+        }
+    }
+    if (opened)
+        out += '\x1B[27m';
+    return out;
+}
 /**
  * 重画内容区 viewport:按 scrollOffset 取缓冲尾窗,逐行 cup+clearline+rowtext 映射到屏 1..contentBottom。
  * offset=0 即尾窗(== 实时屏,resize / 回尾时用)。清行含 contentBottom——顺带擦 WT 边距漏影(状态行重复)。
+ * 有活跃选区(鼠标拖拽中)时,对选中范围套反白——纯视觉,不影响缓冲内容。
  */
 export function repaintViewport() {
     if (!active)
@@ -399,9 +465,20 @@ export function repaintViewport() {
     const g = getGeo();
     const h = g.contentBottom;
     const slice = content.sliceFromEnd(scrollOffset, h);
+    const sel = normalizeSelection();
+    const absStart = sel ? viewportAbsStart() : 0;
     let p = '';
     for (let r = 1; r <= h; r++) {
-        const line = slice[r - 1] ?? '';
+        let line = slice[r - 1] ?? '';
+        if (sel) {
+            const absLine = absStart + r - 1;
+            if (absLine >= sel.startLine && absLine <= sel.endLine) {
+                const lineW = ansiDisplayWidth(line);
+                const colStart = absLine === sel.startLine ? sel.startCol : 0;
+                const colEnd = absLine === sel.endLine ? sel.endCol : lineW;
+                line = highlightRange(line, colStart, colEnd);
+            }
+        }
         p += cup(r, 1) + esc.clearLine + line;
     }
     // 光标:合并进同一 write(若拆成两次 stdout.write,行写完光标会暂留 contentRow/contentBottom,
@@ -438,6 +515,148 @@ export function scrollBy(delta) {
     repaintViewport();
     repaint();
 }
+/** 清活跃选区(不复制),若原有选区则重画去掉反白。供 ESC / 点击别处 / 退出滚动态等场景调。 */
+export function clearSelection() {
+    if (!selection)
+        return;
+    selection = null;
+    if (scrollOffset >= 0)
+        repaintViewport();
+}
+/**
+ * 注册"点击输入框粘贴"回调:当前持有文本输入的模块(prompt.ts 的 promptWithSlashMenu / repl 运行态
+ * typeahead)在挂键盘监听时调,退出时传 null 注销。点击输入行(未拖动)时 layout 读剪贴板后回调此函数,
+ * 由回调方完成插入(各输入状态的行/光标结构不同,layout 不掺和文本编辑逻辑,只管"贴入"这个动作触发)。
+ */
+export function setPasteHandler(fn) {
+    pasteHandler = fn;
+}
+/** picker / 介入面板期间禁用鼠标选区与滚轮(避免 viewport 重画覆盖菜单);面板退出后恢复。 */
+export function setMouseEnabled(v) {
+    mouseEnabled = v;
+    if (!v) {
+        selecting = false;
+        if (selection) {
+            selection = null;
+            repaintViewport();
+        }
+    }
+}
+/** 从归一化选区抠出纯文本(去 ANSI,按显示列裁切,行间 \n 拼接)。越界行跳过(缓冲被 trim 等边界情况)。 */
+function extractSelectionText(sel) {
+    const out = [];
+    for (let abs = sel.startLine; abs <= sel.endLine; abs++) {
+        const raw = content.lineAt(abs);
+        if (raw == null)
+            continue;
+        const plain = stripAnsi(raw);
+        const lineW = displayWidth(plain);
+        const colStart = abs === sel.startLine ? sel.startCol : 0;
+        const colEnd = abs === sel.endLine ? sel.endCol : lineW;
+        out.push(sliceByDisplayCol(plain, colStart, colEnd));
+    }
+    return out.join('\n');
+}
+/** 屏行是否落在底栏输入行范围内(paintInput 的 firstInputRow..firstInputRow+inputRowsAvail-1)。 */
+function isInputRow(row) {
+    const g = getGeo();
+    const firstInputRow = g.contentBottom + 4;
+    const inputRowsAvail = Math.max(0, g.footerH - 5);
+    return row >= firstInputRow && row < firstInputRow + inputRowsAvail;
+}
+/** 右键单击输入行(未拖动的 press→release):读剪贴板 + 回调 pasteHandler 贴入。异步但不阻塞其他事件。 */
+function pasteIntoInput() {
+    if (!pasteHandler)
+        return;
+    const handler = pasteHandler;
+    readClipboard()
+        .then((text) => {
+        if (text && active)
+            handler(text);
+    })
+        .catch(() => { });
+}
+/**
+ * 鼠标事件分发(mouse.setHandler 注册)。
+ *  - 左键(button 0):内容区按下开选区、拖动扩展(触边自动翻页)、释放只更新高亮**不复制**;
+ *    纯点击(未拖动)清空旧选区(点别处的常见预期);落在输入行不做任何特殊处理(不选区、不粘贴——
+ *    留给终端 / 正常打字焦点行为,避免误触发)。
+ *  - 右键(button 2,单击 = press→release 未拖动):落在输入行 → 读剪贴板贴入(仿常见终端"右键粘贴");
+ *    落在内容区 → 复制当前选区(若有)到剪贴板后立即清空高亮(视觉确认"已复制",不留旧选区误导),
+ *    静默不弹提示;都无对应状态则 no-op。
+ *  - 滚轮(button&64,由 mouse.ts 解析为 wheel 事件):照常 scrollBy。
+ * 选区坐标存绝对缓冲行(viewportAbsStart + 屏行),故翻页 / 追加新内容期间选区锚点仍指向同段文字。
+ */
+function handleMouseEvent(e) {
+    if (!active)
+        return;
+    if (e.type === 'wheel') {
+        if (mouseEnabled)
+            scrollBy(e.dir * WHEEL_LINES);
+        return;
+    }
+    if (!mouseEnabled)
+        return;
+    const g = getGeo();
+    const col = Math.max(0, e.col - 1); // SGR 报表列 1-based → 显示列 0-based
+    // 右键释放:落输入行 → 贴入;落内容区 → 复制当前选区后清空(去掉高亮),不可重复右键复制同一选区。
+    if (e.type === 'release' && e.button === 2) {
+        if (isInputRow(e.row)) {
+            pasteIntoInput();
+            return;
+        }
+        const sel = normalizeSelection();
+        if (!sel)
+            return;
+        const text = extractSelectionText(sel);
+        selection = null;
+        repaintViewport(); // 复制后清高亮:视觉反馈"已复制",不留旧选区误导
+        if (!text)
+            return;
+        copyToClipboard(text);
+        return;
+    }
+    if (e.button !== 0)
+        return; // 其余中/右键 press/drag 不处理(终端原生右键菜单等不受影响)
+    if (e.type === 'press') {
+        if (isInputRow(e.row))
+            return; // 输入行左键不做选区(不干扰正常打字/焦点)
+        selecting = true;
+        const rowInContent = Math.max(1, Math.min(e.row, g.contentBottom));
+        const absLine = screenRowToAbsLine(rowInContent);
+        selection = { anchorLine: absLine, anchorCol: col, endLine: absLine, endCol: col, dragged: false };
+        repaintViewport();
+        return;
+    }
+    if (e.type === 'drag') {
+        if (!selecting || !selection)
+            return;
+        // 触边自动翻页:motion 事件持续到达时靠此逐步滚动,把选区扩展到滚出去的历史行。
+        if (e.row <= 1)
+            scrollBy(WHEEL_LINES);
+        else if (e.row >= g.contentBottom)
+            scrollBy(-WHEEL_LINES);
+        const rowInContent = Math.max(1, Math.min(e.row, g.contentBottom));
+        const absLine = screenRowToAbsLine(rowInContent);
+        if (absLine !== selection.endLine || col !== selection.endCol)
+            selection.dragged = true;
+        selection.endLine = absLine;
+        selection.endCol = col;
+        repaintViewport();
+        return;
+    }
+    // release(左键)
+    selecting = false;
+    if (!selection)
+        return;
+    if (!selection.dragged) {
+        // 内容区纯点击(未拖动):只清选区,不复制(复制交给右键)。
+        selection = null;
+        repaintViewport();
+        return;
+    }
+    // 拖动过:保留高亮选区供右键复制(不在此处复制,复制交给右键释放分支)。
+}
 /** 回尾(offset=0);仅当原本滚动过才重画(避免每轮 enterRunningMode 闪烁)。 */
 export function resetScroll() {
     if (scrollOffset === 0)
@@ -814,7 +1033,7 @@ export function paintInput(view) {
         const line = slice[g.contentBottom - 1] ?? '';
         buf += cup(g.contentBottom, 1) + esc.clearLine + line;
     }
-    // 2c. 虚拟空行(内容区与状态栏之间的视觉间隔,属底栏非内容):恒清空,防底栏撑高时旧内容残留该行
+    // 2c. 虚拟空行(内容区与状态栏之间的视觉间隔,属底栏非内容):恒清空,防底栏撑高时旧内容残留该行。
     buf += cup(g.contentBottom + 1, 1) + esc.clearLine;
     // 3. 状态行:spinner 行 + model 行(两行式底栏)
     const spinnerRow = g.contentBottom + 2; // +1 虚拟空行,+2 spinner 行
@@ -998,7 +1217,8 @@ export function enterAltScreen() {
         return;
     active = true;
     stdout.write(esc.altOn);
-    stdout.write(esc.altScrollOn); // alt 屏滚轮转发 ↑/↓(不抓鼠标点击/拖拽,原生选区复制不受影响)
+    stdout.write(esc.mouseOn); // 完整鼠标追踪(按下/拖动/释放/滚轮)→ mouse.swallow 重组 → handleMouseEvent
+    mouse.setHandler(handleMouseEvent);
     setRegion(6); // 1 虚拟空 + 1 spinner行 + 1 上线 + 1 输入 + 1 下线 + 1 model行(两行式底栏)
     contentRow = 1;
     contentCol = 1;
@@ -1007,6 +1227,8 @@ export function enterAltScreen() {
     scrollLockUntil = 0;
     mdActive = false;
     mdBuf = '';
+    selection = null;
+    selecting = false;
     content.reset();
     exitHandler = () => exitAltScreen();
     process.on('exit', exitHandler);
@@ -1055,6 +1277,10 @@ export function exitAltScreen() {
     scrollLockUntil = 0; // 清轮首滚动锁(防状态泄漏到下次进 alt 屏)
     frameRow = 0; // 清 spinner 帧位置(防状态泄漏到下次进 alt 屏)
     frameCol = 0;
+    mouse.setHandler(null);
+    mouse.resetMouse();
+    selection = null;
+    selecting = false;
     // raw 还原独立 try:非 TTY / 不支持时 setRawMode 抛错,不应阻断 stdout 恢复(alt 退屏必须执行)。
     try {
         stdin.setRawMode(false); // 还原 raw(RUNNING 态常驻 raw,退出时必须还原,否则终端残留 raw 模式)
@@ -1065,7 +1291,7 @@ export function exitAltScreen() {
     try {
         stdout.write('\x1B[r'); // 复位 DECSTBM margins
         stdout.write(esc.cursorShow);
-        stdout.write(esc.altScrollOff); // 关 alt 屏滚轮转发
+        stdout.write(esc.mouseOff); // 关鼠标追踪(反序:先 1006l 再 1002l 再 1000l)
         stdout.write(esc.altOff); // 退 alt(恢复主屏 + 光标)
     }
     catch {

package/dist/ui/mouse.js

@@ -1,93 +1,90 @@
-// SGR 鼠标报表重组器(叶子,仅正则,无依赖)。
+// SGR 鼠标报表重组器 + 事件分发(叶子:仅正则 + 回调,无 UI 依赖)。
 //
-// 背景:layout 进 alt 屏时发 \x1B[?1000h + \x1B[?1006h 启 SGR 鼠标追踪,终端把滚轮/点击发为
-// \x1B[<button;col;rowM(按下/滚轮/拖动)或 m(释放)。但 Node readline 的 emitKeypressEvents
-// 不认 `<` 为 CSI 参数字节,把一条报表拆成 `\x1b[<` + 逐字符 共 9 个 keypress(数字/`;`/`M` 有
-// 可打印 name,会被当文本砸进输入框)。本模块在 keypress 层重组:每个 keypress 的 key.sequence
-// 喂入 consumeMouse,内部状态机把 fragment 拼回完整报表,期间所有 fragment 返回 suppress=true
-// 让调用方吞掉,完整报表解出滚轮方向后返回 wheel(±1)由调用方调 layout.scrollBy(wheel*5)。
+// 背景:layout 进 alt 屏时发 \x1B[?1000h + \x1B[?1002h + \x1B[?1006h,启用:
+//   1000 = 按键事件追踪(按下 / 释放),1002 = 拖动追踪(按住键移动时上报 motion),
+//   1006 = SGR 编码 → \x1B[<btn;col;rowM(按下 / 拖动)或 \x1B[<btn;col;rowm(释放)。
+// 有了 1002 的拖动上报,才能实现"按住左键拖过多屏 → 应用层维护选区 → 松开复制"(仿 Claude Code)。
 //
-// 触发可靠:首 fragment `\x1b[<` 是 SGR 鼠标独有——真 Esc 的 key.name==='escape'、sequence==='\x1b';
-// 人按 Esc 再按 < 得 `\x1b<`(meta-<),不进 CSI 分支。故 `\x1b[<` 单 keypress 只能是 SGR 报表开头。
-// 后续 fragment 同步背靠背到达(终端一次发整条报表,readline 在同一 onData chunk 内同步抛完)。
-/** 单条完整报表(非 g:用于 test,不推进 lastIndex);捕获 button。 */
-const REPORT_RE = /\x1b\[<(\d+);\d+;\d+[Mm]/;
-/** 全局报表(用于 matchAll 取所有完整报表,取末条)。 */
-const REPORT_RE_G = /\x1b\[<(\d+);\d+;\d+[Mm]/g;
+// 但 Node readline 的 emitKeypressEvents 不认 `<` 为 CSI 参数字节,把一条报表拆成 `\x1b[<` +
+// 逐字符共 ≥9 个 keypress(数字 / `;` / `M` 有可打印 name,会被当文本砸进输入框)。故本模块在
+// keypress 层重组:每个 keypress 的 key.sequence 喂入 swallow,内部状态机把 fragment 拼回完整报表,
+// 期间所有 fragment 返回 true(调用方须 return 吞掉,防砸进输入框);报表拼齐后解析成结构化
+// MouseEvent 派发给已注册的 handler(layout 注册,做滚动 / 选区 / 复制)。
+//
+// 触发可靠:首 fragment `\x1b[<` 是 SGR 鼠标独有——真 Esc 的 sequence==='\x1b';人按 Esc 再按 <
+// 得 `\x1b<`(meta-<),不进 CSI 分支。故 `\x1b[<` 开头只能是 SGR 报表。
+/** 单条完整报表(捕获 button / col / row / 终止符 M|m)。 */
+const REPORT_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/;
+/** 全局版:一个 chunk 里可能背靠背多条(拖动 motion 连发),matchAll 取全部。 */
+const REPORT_RE_G = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
 /** 收集中 buf 允许的形状:\x1b[< 后跟 [0-9;] 任意个,末尾可选一个 M/m(未完成或刚完成)。 */
 const PARTIAL_RE = /^\x1b\[<[0-9;]*[Mm]?$/;
 const START = '\x1b[<';
-/** button & 64 为滚轮:64=上(+1)、65=下(-1);其余(点击/拖动/移动/释放)→ 0。 */
-function wheelDir(button) {
-    if (!(button & 64))
-        return 0;
-    return button & 1 ? -1 : +1;
-}
-/**
- * 纯函数:从可能含 ≥1 条完整报表的串里取末条滚轮方向(+1 上 / -1 下 / 0 无或非滚轮)。
- * 供"整体抛出整条报表"的前向兼容分支与测试用(当前 Node 拆碎,正常路径走 consumeMouse)。
- */
-export function wheelFromReport(seq) {
-    let last = 0;
-    for (const m of seq.matchAll(REPORT_RE_G)) {
-        last = wheelDir(Number(m[1]));
-    }
-    return last;
-}
+let handler = null;
 let collecting = false;
 let buf = '';
-let stallTimer = null;
-function resetState() {
-    collecting = false;
-    buf = '';
-    if (stallTimer) {
-        clearTimeout(stallTimer);
-        stallTimer = null;
-    }
+/** 注册事件回调(layout 进 alt 屏时注册)。 */
+export function setHandler(fn) {
+    handler = fn;
 }
 /** 复位内部收集状态(退出 alt 屏 / 测试间清污染)。 */
 export function resetMouse() {
-    resetState();
+    collecting = false;
+    buf = '';
+}
+/** button 位:64=滚轮(&1 区分上下),32=拖动 motion,低 2 位=键(0=左,1=中,2=右)。 */
+function emit(button, col, row, term) {
+    if (!handler)
+        return;
+    if (button & 64) {
+        handler({ type: 'wheel', dir: button & 1 ? -1 : +1 });
+        return;
+    }
+    const btn = button & 3;
+    if (term === 'm') {
+        handler({ type: 'release', col, row, button: btn });
+        return;
+    }
+    if (button & 32) {
+        handler({ type: 'drag', col, row, button: btn });
+        return;
+    }
+    handler({ type: 'press', col, row, button: btn });
 }
-function armStall() {
-    if (stallTimer)
-        clearTimeout(stallTimer);
-    // 100ms 内未收齐视为畸形/丢失,丢半截(终端报表原子发出,跨 chunk >100ms 罕见;有界安全)。
-    const t = setTimeout(resetState, 100);
-    t.unref();
-    stallTimer = t;
+/** 解出串中所有完整报表并按序派发(拖动 motion 一个 chunk 多条时全处理)。 */
+function dispatchAll(s) {
+    for (const m of s.matchAll(REPORT_RE_G)) {
+        emit(Number(m[1]), Number(m[2]), Number(m[3]), m[4]);
+    }
 }
 /**
- * 喂入一个 keypress 的 key.sequence,返回 { suppress, wheel }。
- *  - suppress=true:本 keypress 是鼠标 fragment(或完整报表),调用方须 return 吞掉。
- *  - wheel≠0:刚重组出一条完整滚轮报表,调用方调 layout.scrollBy(wheel*5)。
- *  - suppress=false:非鼠标,放行正常处理。
+ * 喂入一个 keypress 的 key.sequence。
+ * 返回 true=本 keypress 是鼠标 fragment(或完整报表),调用方须 return 吞掉;
+ * 返回 false=非鼠标,放行正常处理。完整报表拼齐时同步派发 MouseEvent 给 handler。
  */
-export function consumeMouse(seq) {
+export function swallow(seq) {
+    if (!seq)
+        return false;
     if (!collecting) {
         if (!seq.startsWith(START))
-            return { wheel: 0, suppress: false };
-        // 前向兼容:若未来 Node 整体抛整条报表(含完整 \x1B[<…M),直接解。
-        if (REPORT_RE.test(seq))
-            return { wheel: wheelFromReport(seq), suppress: true };
-        // 开收:首 fragment(典型 readline 的 `\x1b[<`,或 `\x1b[<64;5;` 半截)。
+            return false;
+        // 单 keypress 已含完整报表(未来 Node 可能整体抛):直接解。
+        if (REPORT_RE.test(seq)) {
+            dispatchAll(seq);
+            return true;
+        }
         collecting = true;
         buf = seq;
-        armStall();
-        return { wheel: 0, suppress: true };
+        return true;
     }
-    // 收集中:追加。
     buf += seq;
     if (REPORT_RE.test(buf)) {
-        const wheel = wheelFromReport(buf);
-        resetState();
-        return { wheel, suppress: true };
-    }
-    if (PARTIAL_RE.test(buf)) {
-        // 合法未完成形状(无 M/m 终止)—— 继续等下一 fragment。
-        return { wheel: 0, suppress: true };
+        dispatchAll(buf);
+        resetMouse();
+        return true;
     }
-    // 偏离合法形状:畸形垃圾(报表跨 chunk 超时/编码异常)。丢半截,吞掉不打扰。
-    resetState();
-    return { wheel: 0, suppress: true };
+    if (PARTIAL_RE.test(buf))
+        return true; // 合法未完成形状,继续等
+    resetMouse(); // 偏离合法形状:畸形垃圾,丢半截,吞掉不打扰
+    return true;
 }