mocode-ai 0.1.10 → 0.2.1

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,152 @@ 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();
+        repaint(); // 补一次输入区重画:INPUT 态 repaintViewport 把真光标留在内容区续写位,须靠 repaint 把它带回输入框(否则点内容区会现假闪烁光标,见 issue)
+        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();
+        repaint(); // 同上:把真光标带回输入框,防拖动选区期间光标停留内容区闪烁
+        return;
+    }
+    // release(左键)
+    selecting = false;
+    if (!selection)
+        return;
+    if (!selection.dragged) {
+        // 内容区纯点击(未拖动):只清选区,不复制(复制交给右键)。
+        selection = null;
+        repaintViewport();
+        repaint(); // 同上:把真光标带回输入框
+        return;
+    }
+    // 拖动过:保留高亮选区供右键复制(不在此处复制,复制交给右键释放分支)。
+    repaint(); // 同上:把真光标带回输入框
+}
 /** 回尾(offset=0);仅当原本滚动过才重画(避免每轮 enterRunningMode 闪烁)。 */
 export function resetScroll() {
     if (scrollOffset === 0)
@@ -814,7 +1037,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 +1221,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 +1231,8 @@ export function enterAltScreen() {
     scrollLockUntil = 0;
     mdActive = false;
     mdBuf = '';
+    selection = null;
+    selecting = false;
     content.reset();
     exitHandler = () => exitAltScreen();
     process.on('exit', exitHandler);
@@ -1055,6 +1281,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 +1295,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 {