mocode-ai 1.3.1 → 1.3.2

package/README.md

@@ -82,6 +82,7 @@ MoCode isn't a chat box with a coat of paint — it's an agent that actually get
 - **Project context (`AGENTS.md`)** — A single project-level memory file at `AGENTS.md` captures both static facts (project description, commands, module list, directory tree) and human/AI-written insights (conventions, architectural decisions, pitfalls). Generate it once with `/init`, then keep it up to date by hand or by asking the agent to refresh it. Loaded automatically into the system prompt on every turn.
 - **Session notepad (notes.md)** — For complex multi-step tasks (≥3 file changes / ≥5 tool calls), the agent maintains a working notepad at `.mocode/sessions/<sessionId>/notes.md` (file-based, survives context compression). It records the execution plan with the dedicated `plan_update` tool — a three-state step machine (`pending`/`in_progress`/`completed`, at most one `in_progress`) that auto-settles to `## Done:` when finished. The active plan is re-injected into the system prompt after compaction and re-synced into context whenever notes.md changes, and a gentle reminder nudges the agent if it goes several tool-steps without updating the plan. A live progress chip in the TUI status bar shows `plan: [title] (3/7) ▸ [current step]`.
 - **Interruptible and reversible** — Ctrl+C interrupts the current turn at any time (kills child processes recursively, rolls history back to before the turn started, leaves no half-finished tool calls). `/rollback` restores file changes from per-turn snapshots, with a per-file keep/undo choice — no git dependency required.
+- **Input safety net** — Long prompts no longer fear a stray Enter: `Ctrl+G` opens an in-TUI composer popup (notepad-style editing — Enter inserts a newline, with soft wrap, selection, copy/cut/paste and undo; Ctrl+S fills the text back into the input box without sending). `Ctrl+R`/`Ctrl+P` fuzzy-search your input history (Enter only fills it back), and the post-send recall window widens to 2 seconds with any-key recall for long inputs.
 - **Sandbox protection** — File reads/writes go through a sandbox that blocks out-of-bounds paths (`../../`, absolute paths outside the root, symlink escapes, etc.), so the agent never touches files outside your working directory.
 
 ## Features

package/README.zh-CN.md

@@ -81,6 +81,7 @@ mocode 不是一个套壳聊天框,而是一个能真正动手干活的 agent:
 - **跨会话长期记忆** — agent 能把项目架构、约定、踩过的坑存成长期记忆,下次会话自动加载;后台还会定期从对话里反思挖掘值得记住的事。记忆可增删改、带召回衰减。
 - **会话记事本(notes.md)** — 复杂多步任务(≥3 处文件改动 / ≥5 步工具调用)时,agent 在 `.mocode/sessions/<sessionId>/notes.md` 维护一个工作记事本(落盘抗压缩),可记录中间发现、设计决策、待验证问题和结构化计划。执行计划由专用 `plan_update` 工具维护——三态步骤机(`pending`/`in_progress`/`completed`,同一时刻至多一个 `in_progress`),全部完成自动结算为 `## Done:`。活跃 plan 在压缩后重注入系统提示、notes.md 一变就重同步进上下文,若连续多步未更新还会有温和提醒。TUI 状态栏实时显示进度 chip:`plan: [标题] (3/7) ▸ [当前步]`。
 - **可中断、可回滚** — Ctrl+C 随时打断当前轮次(树杀子进程,历史还原到本轮开始前,不留残半的工具调用);`/rollback` 按轮次快照恢复文件改动,逐个文件「保留/撤销」,不依赖 git。
+- **输入安全网** — 长 prompt 不再怕误按 Enter:`Ctrl+G` 弹出 TUI 内「输入面板」(记事本式编辑,Enter=换行、软换行、选区、复制/剪切/粘贴、撤销,Ctrl+S 填回输入框不自动发送);`Ctrl+R`/`Ctrl+P` 模糊搜索历史输入(Enter 只回填不发送);长文本误发后撤回窗口自动放宽到 2 秒且任意键可撤回。
 - **沙箱防护** — 文件读写经沙箱拦截,挡掉越界路径(`../../`、绝对外圈、软链出圈等),不碰工作目录之外的文件。
 
 ## 特性

package/dist/i18n/index.js

@@ -107,6 +107,12 @@ const zhCN = {
     'prompt.revertDetail': '（{count} 个文件恢复到回滚前）',
     'prompt.messagesOnly': '只撤销消息，保留文件改动',
     'prompt.emptyPlaceholder': '输入消息，按 Enter 开始对话；输入 /help 查看命令…',
+    'prompt.confirmSendHint': '再按一次 Enter 发送 · 其它键继续编辑',
+    'composer.title': '输入面板',
+    'composer.pos': '{row}/{total} 行 · {col} 列 · {chars} 字',
+    'composer.hint': 'Enter 换行 · Ctrl+S 回填 · Esc 取消 · Ctrl+Z 撤销 · Ctrl+C/X/V 复制/剪切/粘贴 · Ctrl+A 全选',
+    'history.hint': '输入过滤 · ↑↓ 选择 · Enter 填入输入框 · Ctrl+Enter 直接发送 · Esc 取消',
+    'history.empty': '（无匹配的历史输入）',
     'welcome.gettingStarted': '快速上手',
     'welcome.start1': '直接输入消息，按 Enter 发送；Shift+Tab 切换 auto / plan 模式',
     'welcome.start2': '输入 / 打开命令菜单；输入 /help 查看全部命令',
@@ -141,7 +147,7 @@ const zhCN = {
     'repl.didYouMean': '你是不是想输入 {value}？',
     'repl.unknownCommandHint': '输入 /help 查看全部命令（普通文本直接打字发送，不必加 /）',
     'theme.default': '16 色原版（深底）',
-    'theme.light': '浅底终端',
+    'theme.light': 'Solarized 浅色系',
     'theme.solarized': 'Solarized 强调色',
     'theme.gruvbox': 'Gruvbox 暖色',
     'theme.nord': 'Nord 冷色',
@@ -172,7 +178,7 @@ const zhCN = {
     'status.measured': '实测',
     'status.estimated': '估算',
     'status.messages': '{count} 条消息',
-    'agent.sending': '发送中…  (Esc / Ctrl+C 撤回)',
+    'agent.sending': '发送中…  (任意键 / Esc / Ctrl+C 撤回)',
     'agent.thinking': '思考中',
     'agent.generating': '生成 {tool}',
     'agent.executing': '执行 {tool}',
@@ -391,6 +397,12 @@ const en = {
     'prompt.revertDetail': ' ({count} files restored to before the rollback)',
     'prompt.messagesOnly': 'Roll back messages only; keep file changes',
     'prompt.emptyPlaceholder': 'Type a message, press Enter to send; /help for commands…',
+    'prompt.confirmSendHint': 'Press Enter again to send · any other key keeps editing',
+    'composer.title': 'Composer',
+    'composer.pos': '{row}/{total} lines · col {col} · {chars} chars',
+    'composer.hint': 'Enter Newline · Ctrl+S Fill input · Esc Cancel · Ctrl+Z Undo · Ctrl+C/X/V Copy/Cut/Paste · Ctrl+A Select all · Shift+Arrows Select',
+    'history.hint': 'Type to filter · ↑↓ Select · Enter Fill input · Ctrl+Enter Send · Esc Cancel',
+    'history.empty': '(no matching history)',
     'welcome.gettingStarted': 'Getting started',
     'welcome.start1': 'Type a message and press Enter; Shift+Tab toggles auto / plan mode',
     'welcome.start2': 'Type / for the command menu; /help lists all commands',
@@ -425,7 +437,7 @@ const en = {
     'repl.didYouMean': 'Did you mean {value}?',
     'repl.unknownCommandHint': 'Run /help for all commands (plain text is sent as-is, no slash needed)',
     'theme.default': 'Original 16-color theme (dark)',
-    'theme.light': 'Light terminal',
+    'theme.light': 'Light Solarized palette',
     'theme.solarized': 'Solarized accents',
     'theme.gruvbox': 'Warm Gruvbox colors',
     'theme.nord': 'Cool Nord colors',
@@ -456,7 +468,7 @@ const en = {
     'status.measured': 'measured',
     'status.estimated': 'estimated',
     'status.messages': '{count} messages',
-    'agent.sending': 'Sending…  (Esc / Ctrl+C to recall)',
+    'agent.sending': 'Sending…  (any key / Esc / Ctrl+C to recall)',
     'agent.thinking': 'Thinking',
     'agent.generating': 'Generating {tool}',
     'agent.executing': 'Running {tool}',

package/dist/repl/index.js

@@ -10,7 +10,7 @@ import { runAgent } from '../agent/index.js';
 import { getAgentMode, setAgentMode, onModeChange } from '../agent/mode.js';
 import { togglePet, killPetProcess, listSkins, setSkin, sendState } from '../pet/bridge.js';
 import { setSandboxRoot } from '../sandbox/root.js';
-import { ui, setTheme, getTheme, listThemes, themeExists, applyTerminalBackground } from '../ui/theme.js';
+import { ui, setTheme, getTheme, listThemes, themeExists } from '../ui/theme.js';
 import { bannerLines, displayWidth, padEndDisplay, summarizeToolCall, summarizeToolResult } from '../ui/render.js';
 import * as layout from '../ui/layout.js';
 import * as mouse from '../ui/mouse.js';
@@ -35,6 +35,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { getSandboxRoot } from '../sandbox/root.js';
 import { setCurrentSessionId, getCurrentSessionId } from '../session/state.js';
+import { collectQueryHistory } from '../session/query-history.js';
 import { checkVersion, fetchLatestVersion, getCurrentVersion, runUpgradeForeground, } from '../commands/upgrade.js';
 /**
  * readline 的 prompt 必须是纯文本(无 ANSI):readline 按字符数算光标位置,
@@ -457,7 +458,21 @@ let pendingPrefill = null; // /rollback 选中后预填的 user 输入(下轮 IN
 // 500ms 内 Ctrl+C / Esc → 整条用户气泡从内容区擦掉 + 原行 prefilled 回输入框(可改可再发);
 // 期间再按 Enter 立即推进 / 时间到自然推进 → 走原流程 enterRunningMode + runTurn。
 // attachmentsCount 记 pendingAttachments 当时长度——撤回时 attachments 保留(用户意图未变,只是改字)。
+// 短单行:500ms(不拖慢日常)。长文本:MOCODE_RECALL_MS,默认 2000ms —— 人发现"误发了"通常要 1-3 秒,
+// 500ms 根本来不及反应,只能事后 /rollback。
 const PENDING_RECALL_MS = 500;
+const PENDING_RECALL_LONG_MS = 2000;
+/** 长输入阈值:与 prompt.ts 的二次确认阈值保持一致(≥2 行 或 ≥120 码点)。 */
+const LONG_INPUT_CHARS = 120;
+/** 按输入长度决定撤回窗口:长 prompt 给更宽的补救时间,短单行仍走 500ms。 */
+function recallWindowMs(input) {
+    const joined = input.join('\n');
+    const long = input.length >= 2 || [...joined].length >= LONG_INPUT_CHARS;
+    if (!long)
+        return PENDING_RECALL_MS;
+    const env = Number(process.env.MOCODE_RECALL_MS);
+    return Number.isFinite(env) && env >= 0 ? env : PENDING_RECALL_LONG_MS;
+}
 let pendingRecall = null;
 let pendingTimer = null;
 // agent 模式状态已提到 src/agent/mode.ts(共享叶子:switch_mode 工具可写、agent 每步读、repl 注册 onModeChange 监听器)。
@@ -688,15 +703,19 @@ function awaitPendingRecall(input, attachmentsCount, placeholder) {
                 finalize(false);
                 return;
             }
-            // 立即 commit
+            // 确认立即发送:Enter / Return
             if (key.name === 'enter' || key.name === 'return') {
                 finalize(true);
                 return;
             }
-            // 其他键忽略
+            // 其它任何键 → 撤回。
+            // 旧实现把非 Enter 键"忽略"掉:误按 Enter 后人的第一反应是狂敲键盘 / 按空格 / 按退格,
+            // 这一串输入被静默丢弃,白白错过补救窗口。撤回窗口期间输入框尚未接管键盘,
+            // 这些键本来也不会进输入框,吞掉它们没有任何收益 —— 全部当作撤回信号更有用。
+            finalize(false);
         };
         emitter.on('keypress', onPendingKey);
-        pendingTimer = setTimeout(() => finalize(true), PENDING_RECALL_MS);
+        pendingTimer = setTimeout(() => finalize(true), recallWindowMs(input));
         pendingTimer.unref?.();
     });
 }
@@ -1274,6 +1293,9 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                 prompt: PROMPT,
                 commands: buildSlashCommands(),
                 onCycleMode: cycleMode,
+                // Ctrl+R / Ctrl+P 历史搜索候选源:惰性工厂——当前会话内存 queryHistory + 最近落盘会话,
+                // 聚合要读盘,只有面板真正打开(Ctrl+R/P)才求值,平常轮次零开销
+                history: () => collectQueryHistory(queryHistory).map((e) => e.text),
                 // /rollback 预填优先;否则上一轮运行中 typeahead 打的字 → 预填进输入框,用户可改可发
                 ...(pendingPrefill
                     ? { initialLines: pendingPrefill }
@@ -1880,7 +1902,6 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             // 切:setTheme → 重算状态行(新色)→ 清内容重绘(历史 / 横幅,镜像启动 + /resume)→ 确认 → 持久化。
             // markdown MEMO 按 themeVersion 自动失效,故 renderHistory 取新色;状态栏 / 输入框由 continue 回 INPUT 态时读 getter 刷。
             setTheme(name);
-            applyTerminalBackground();
             refreshStatusBase(history);
             layout.clearContent();
             if (history.some((m) => m.role === 'user')) {

package/dist/session/query-history.js

@@ -0,0 +1,45 @@
+import { listSessions, loadSession } from './persist.js';
+/** 当前会话条目的 sessionId 标记。 */
+export const CURRENT_SESSION = 'current';
+export function collectQueryHistory(current, opts = {}) {
+    const maxSessions = Math.max(0, opts.maxSessions ?? 20);
+    const maxEntries = Math.max(1, opts.maxEntries ?? 500);
+    const seen = new Set();
+    const out = [];
+    const push = (raw, sessionId, at) => {
+        if (out.length >= maxEntries)
+            return;
+        const text = raw.trim();
+        if (!text || seen.has(text))
+            return;
+        seen.add(text);
+        out.push({ text, sessionId, at });
+    };
+    // 当前会话:数组末尾最新 → 倒序,让"刚发的"排最前。
+    for (let i = current.length - 1; i >= 0; i--)
+        push(current[i] ?? '', CURRENT_SESSION, '');
+    if (out.length < maxEntries && maxSessions > 0) {
+        // listSessions 已按 createdAt 降序(最新在前);损坏文件内部跳过。
+        for (const meta of listSessions(maxSessions)) {
+            let rec;
+            try {
+                rec = loadSession(meta.id);
+            }
+            catch {
+                continue;
+            }
+            const qh = rec?.queryHistory;
+            if (!qh?.length)
+                continue;
+            for (let i = qh.length - 1; i >= 0; i--)
+                push(qh[i] ?? '', meta.id, meta.createdAt ?? '');
+            if (out.length >= maxEntries)
+                break;
+        }
+    }
+    return out;
+}
+/** 取展示用首行(多行 query 折叠成一行;换行符显示为 ␊)。 */
+export function historyFirstLine(text) {
+    return text.split('\n')[0] ?? '';
+}

package/dist/ui/batch.js

@@ -275,14 +275,20 @@ function buildEntryDetailLines(e, indent = '      ') {
     }
     return lines;
 }
+/** entry 第一层明细行的结果指纹:结果/失败态/diff 有变时指纹变,驱动运行态原位刷新。 */
+function entryLineDigest(e) {
+    return `${e.resultSummary}\u0001${e.diffBlock ? '1' : '0'}\u0001${e.failed ? '1' : '0'}`;
+}
+/** 单条第一层明细行。isLast 决定分支符(└─/├─);结果回填原位替换时也要用对分支符。 */
+function buildEntryLine(e, index, isLast, extraIndent = '') {
+    const result = e.resultSummary ? `  ${ui.gray}↳ ${e.resultSummary}${ui.reset}` : '';
+    const branch = isLast ? '└─' : '├─';
+    const failure = e.failed ? `${ui.red}×${ui.reset} ` : '';
+    return sanitizeRow(`${extraIndent}    ${ui.dim}${branch}${ui.reset} ${failure}${ui.accent}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}${result}`);
+}
 /** 第一层只展示有哪些调用及其简短结果，不展开完整输出。extraIndent 供子批嵌套加深缩进。 */
 function buildExpandedLines(entries, extraIndent = '') {
-    return entries.map((e, index) => {
-        const result = e.resultSummary ? `  ${ui.gray}↳ ${e.resultSummary}${ui.reset}` : '';
-        const branch = index === entries.length - 1 ? '└─' : '├─';
-        const failure = e.failed ? `${ui.red}×${ui.reset} ` : '';
-        return sanitizeRow(`${extraIndent}    ${ui.dim}${branch}${ui.reset} ${failure}${ui.accent}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}${result}`);
-    });
+    return entries.map((e, index) => buildEntryLine(e, index, index === entries.length - 1, extraIndent));
 }
 function entryDetailIndent(entries, index) {
     return index < entries.length - 1 ? '    │  ' : '       ';
@@ -295,7 +301,8 @@ export function endBatch(id, layout) {
     b.finishedAt ??= Date.now();
     if (b.summaryAbsIdx >= 0) {
         layout.contentReplaceLine?.(b.summaryAbsIdx, buildSummaryLine(b));
-        // 执行阶段只展示实时摘要；到 endBatch 才开放点击，避免未完成 batch 的第一层列表失步。
+        // 点击命中在 showLiveBatch 首次落盘时即已登记(运行态可展开);这里幂等重登,
+        // 并把摘要行刷成最终完成态文案。
         absLineToBatchId.set(b.summaryAbsIdx, b.id);
         return;
     }
@@ -323,7 +330,9 @@ export function endBatch(id, layout) {
     absLineToBatchId.set(b.summaryAbsIdx, b.id);
 }
 /**
- * 工具执行中立即显示/刷新摘要，但暂不登记点击命中；endBatch 收尾后才开放两层展开。
+ * 工具执行中立即显示/刷新摘要,并登记点击命中——运行态即可展开/折叠(此前只在
+ * endBatch 收尾后开放,导致「连续无正文的工具链」在整轮结束前无法展开,用户报告痛点)。
+ * 展开态下由 syncLiveExpanded 保持明细视图与新 entry/结果同步。
  */
 export function showLiveBatch(id, layout) {
     const b = batches.get(id);
@@ -360,10 +369,12 @@ export function showLiveBatch(id, layout) {
             }
             layout.contentInsertAfter(anchor, [sanitizeRow(summary)], false);
             b.summaryAbsIdx = anchor + 1;
+            absLineToBatchId.set(b.summaryAbsIdx, b.id); // 运行态同样开放点击(endBatch 幂等重登)
             return;
         }
         layout.contentWrite(summary + '\n');
         b.summaryAbsIdx = Math.max(0, layout.totalRows() - 2);
+        absLineToBatchId.set(b.summaryAbsIdx, b.id); // 运行态同样开放点击
         // 首条摘要通过增量 contentWrite 落屏时，markdown→普通内容的边界可能只更新了
         // buffer/续写位；直到第二个 header 的 contentReplaceLine 或后续正文重绘才完全可见。
         // 立即按 buffer 原子重画，确保慢工具执行期间摘要前的空行已经显示。
@@ -377,6 +388,30 @@ export function showLiveBatch(id, layout) {
     else {
         layout.contentReplaceLine(b.summaryAbsIdx, summary);
     }
+    // 展开态的运行态同步:已渲染 entry 的结果回填原位替换 + 新 entry 追加。
+    syncLiveExpanded(b, layout);
+}
+/** 展开态 batch 的运行态同步(每次 showLiveBatch 后调):不展开/未落盘时 no-op。 */
+function syncLiveExpanded(b, layout) {
+    if (!expandedBatches.has(b.id) || b.summaryAbsIdx < 0)
+        return;
+    // ① 已渲染 entry 的结果晚于渲染到达 → 原位替换该明细行(否则展开视图永远停在「无结果」)。
+    for (let i = 0; i < b.renderedCount && i < b.entries.length; i++) {
+        const e = b.entries[i];
+        const digest = entryLineDigest(e);
+        if (e.renderedDigest === digest)
+            continue;
+        const abs = findParentEntryAbsLine(b.id, i);
+        if (abs == null)
+            continue;
+        layout.contentReplaceLine(abs, buildEntryLine(e, i, i === b.entries.length - 1, b.indent ?? ''));
+        e.renderedDigest = digest;
+    }
+    // ② 新 entry(运行态 recordCall 后)追加到明细区末尾。
+    const ins = layout.contentInsertAfter;
+    if (ins && b.entries.length > b.renderedCount) {
+        refreshBatchExpanded(b.id, { contentInsertAfter: ins });
+    }
 }
 /** 绝对行索引 → 命中 batch id(用于鼠标 release 反查);非摘要行返 null。 */
 export function findBatchByAbsLine(absLine) {
@@ -412,12 +447,25 @@ export function refreshBatchExpanded(id, layout) {
     // 实时追加:不锚定视口,让新明细行自然出现在屏底。
     // 组容器批的 entry 与子批摘要行交错,新 entry 必须插在当前块末尾,
     // 不能简单用 summaryAbsIdx+renderedCount(否则 entry 会插到前一个子批摘要行之前)。
+    // 块末还必须计入已渲染 entry 的二层展开明细行(toggleEntry 把明细插在 entry 行下方,
+    // 会把后续 entry 行整体下移;运行态可交互后这条路径高频,漏算会插错位)。
     let anchor = b.summaryAbsIdx + b.renderedCount;
+    for (const j of b.expandedEntries) {
+        if (j < b.renderedCount) {
+            anchor += buildEntryDetailLines(b.entries[j], entryDetailIndent(b.entries, j)).length;
+        }
+    }
     if (b.groupParent) {
-        let maxIdx = b.summaryAbsIdx;
+        let maxIdx = anchor;
         for (const [idx, target] of absLineToEntry) {
-            if (target.batchId === b.id && idx > maxIdx)
-                maxIdx = idx;
+            if (target.batchId !== b.id)
+                continue;
+            // entry 行自身(含其二层明细)的块末位置
+            const end = b.expandedEntries.has(target.entryIndex)
+                ? idx + buildEntryDetailLines(b.entries[target.entryIndex], entryDetailIndent(b.entries, target.entryIndex)).length
+                : idx;
+            if (end > maxIdx)
+                maxIdx = end;
         }
         for (const child of batches.values()) {
             if (child.parentId === b.id && child.summaryAbsIdx >= 0) {
@@ -438,6 +486,7 @@ export function refreshBatchExpanded(id, layout) {
     // 登记新增明细行的点击命中(按实际插入位置)
     for (let i = 0; i < newEntries.length; i++) {
         absLineToEntry.set(anchor + 1 + i, { batchId: b.id, entryIndex: b.renderedCount + i });
+        newEntries[i].renderedDigest = entryLineDigest(newEntries[i]);
     }
     b.renderedCount = b.entries.length;
 }
@@ -468,6 +517,7 @@ function expand(b, layout, live = false) {
     b.renderedCount = b.entries.length;
     for (let i = 0; i < b.entries.length; i++) {
         absLineToEntry.set(b.summaryAbsIdx + 1 + i, { batchId: b.id, entryIndex: i });
+        b.entries[i].renderedDigest = entryLineDigest(b.entries[i]); // 记指纹,供运行态结果回填原位刷新
     }
     // 组容器批展开时:把之前被折叠隐藏的子批摘要行重新插回对应 entry 下方,
     // 否则子批摘要行会留在父批摘要行之后、造成明细重复/错位。
@@ -507,6 +557,7 @@ export function expandSingleEntryFully(id, layout) {
     layout.contentWrite('\n');
     expandedBatches.add(id);
     b.expandedEntries.add(0);
+    b.entries[0].renderedDigest = entryLineDigest(b.entries[0]);
     absLineToEntry.set(b.summaryAbsIdx + 1, { batchId: id, entryIndex: 0 });
 }
 function collapse(b, layout) {

package/dist/ui/clipboard.js

@@ -6,8 +6,9 @@ import { spawn } from 'node:child_process';
  * 写入(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 集成终端配置)。
+ *  2. 本地原生工具(best-effort,失败静默):win32=PowerShell Set-Clipboard(stdin 显式 Unicode 编码,
+ *     保证剪贴板正文无 BOM/杂字符——clip.exe 会把 BOM 字符 U+FEFF 留进正文,终端级粘贴会把它敲进输入框)、
+ *     darwin=pbcopy、linux=wl-copy / xclip / xsel。覆盖 OSC52 被禁用的场景(如部分 VS Code 集成终端配置)。
  * 两条都发:哪条生效由环境决定,重复写同一内容无副作用。
  *
  * 读取(readClipboard):OSC 52 是单向的(终端不会把剪贴板内容回传给应用,即便发 `\x1B]52;c;?\x07`
@@ -41,9 +42,23 @@ function pipeTo(cmd, args, buf) {
 /** 本地原生剪贴板(best-effort)。 */
 function nativeCopy(text) {
     if (platform === 'win32') {
-        // clip.exe 在 Win10+ 接受 UTF-16LE 字节(无 BOM),可正确处理中文/emoji;
-        // 直接管 UTF-8 会按控制台代码页解码致乱码,故用 utf16le。
-        pipeTo('clip', [], Buffer.from(text, 'utf16le'));
+        // 不走 clip.exe 直写:BOM-less UTF-16LE 会被按控制台代码页(GBK)解码成乱码,
+        // 而 BOM 版虽能正确解码,clip.exe 却会把 BOM 字符(U+FEFF)留进剪贴板正文——
+        // 终端级粘贴(Ctrl+V 由终端直接灌键盘输入)绕过 readClipboard 的 FEFF 剥离,
+        // FEFF 会敲进输入框渲染成缺字形方块。故改走 PowerShell stdin:显式 Unicode
+        // 输入编码,无 BOM、无杂字符;PowerShell 拉不起(spawn error)才兜底 clip.exe+BOM。
+        const buf = Buffer.from(text, 'utf16le');
+        const bom = Buffer.from([0xff, 0xfe]);
+        try {
+            const p = spawn('powershell', ['-NoProfile', '-NonInteractive', '-Command',
+                '[Console]::InputEncoding=[System.Text.Encoding]::Unicode; Set-Clipboard -Value ([Console]::In.ReadToEnd())'], { stdio: ['pipe', 'ignore', 'ignore'], windowsHide: true });
+            p.on('error', () => pipeTo('clip', [], Buffer.concat([bom, buf]))); // 无 PowerShell:退 clip.exe(乱码/FEFF 风险自负,OSC52 兜底)
+            p.stdin.on('error', () => { });
+            p.stdin.end(buf);
+        }
+        catch {
+            pipeTo('clip', [], Buffer.concat([bom, buf]));
+        }
     }
     else if (platform === 'darwin') {
         pipeTo('pbcopy', [], Buffer.from(text, 'utf8'));
@@ -101,7 +116,10 @@ export async function readClipboard() {
         // 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$/, '') ?? '';
+        // 末尾 strip 一个 \n:PowerShell 把字符串写到 stdout 时会追加行终止符(实验证实
+        // clipboard=abc 时读回 abc\r\n),属输出伪影而非剪贴板内容;真以换行结尾的剪贴板
+        // 内容多出的一个 \n 恰好被抵消,不受影响。
+        return out?.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n').replace(/\r$/, '').replace(/\n$/, '') ?? '';
     }
     if (platform === 'darwin') {
         return (await captureOutput('pbpaste', [], 'utf8')) ?? '';