mocode-ai 0.1.9 → 0.2.0

package/dist/config/index.js

@@ -4,15 +4,17 @@ import path from 'node:path';
 import dotenv from 'dotenv';
 /**
  * 按优先级加载配置文件并回填 process.env:
- *   候选(文件内升序、后者覆盖前者):~/.mocode/config(全局)→ <cwd>/.mocode/config → <cwd>/.env(兼容旧用法)。
+ *   候选(后者覆盖前者,优先级升序):<cwd>/.env(兼容旧用法,最低)→ ~/.mocode/config(全局)→ <cwd>/.mocode/config(项目级覆盖,最高)。
  *   合并后只回填 process.env 里**尚未设置**的键——shell 里 export 的环境变量永远优先。
- * 故 `mocode` 可在任意目录 / 任意终端启动:全局配置(~/.mocode/config)兜底,项目级文件按需覆盖。
+ * 故 `mocode` 可在任意目录 / 任意终端启动:全局配置(~/.mocode/config)兜底(/model 与 mocode config 写此),
+ *   项目级 .mocode/config 按需覆盖全局;旧用法 .env 优先级最低,不再盖过全局 config——
+ *   否则 /model 写入 ~/.mocode/config 的 LLM 键会被项目 .env 里的同名旧值盖回。
  */
 function loadEnvFiles() {
     const candidates = [
-        path.join(os.homedir(), '.mocode', 'config'),
-        path.join(process.cwd(), '.mocode', 'config'),
-        path.join(process.cwd(), '.env'),
+        path.join(process.cwd(), '.env'), // 兼容旧用法,优先级最低
+        path.join(os.homedir(), '.mocode', 'config'), // 全局(/model 与 mocode config 写此)
+        path.join(process.cwd(), '.mocode', 'config'), // 项目级覆盖,优先级最高
     ];
     const fromFiles = {};
     for (const p of candidates) {
@@ -75,6 +77,7 @@ ${PLATFORM_NOTE}
 
 ## Workflow
 - Understand before acting: when unsure about requirements or code state, explore first; don't assume.
+- **Code exploration first action**: before reading files with read_file or searching with grep, check if a .codegraph/ index exists. If it does, use the codegraph tool (explore for questions/features, node for a specific symbol) as your FIRST step — it returns source + call paths in one shot. Only fall back to read_file/grep when codegraph misses, you need just-changed content, or you're editing a known small file. Build the index with \`codegraph init\` if none exists.
 - Small steps: break tasks into verifiable sub-steps. Before each step, think clearly about what to change and why.
 - Verify after change: run typecheck / tests / build via run_command to confirm it works. Never claim done without verification.
 
@@ -121,7 +124,7 @@ export const PLAN_MODE_SUFFIX = `
 ## ⛯ PLAN MODE (active now)
 You are in PLAN mode: investigate and design only — do NOT execute or change anything.
 - Your editing / command / memory-write tools (write_file, edit_file, run_command, memory_save, memory_update, memory_forget) have been REMOVED from your tool list. Use only the read-only tools available to you (read_file, glob, grep, codegraph, web_search, web_fetch, use_skill, ask_human, memory_search, memory_list) to investigate.
-- Research thoroughly: locate the relevant code, trace call paths, and understand existing patterns and conventions before designing. Prefer codegraph when a .codegraph/ index exists.
+- Research thoroughly: locate the relevant code, trace call paths, and understand existing patterns and conventions before designing. Your FIRST action for code exploration should be the codegraph tool (explore/node) when a .codegraph/ index exists — not read_file/grep. Use read_file/grep only to fill gaps codegraph leaves.
 - Then produce a clear, actionable implementation plan: files to change (with paths), what to change in each and why, the ordered steps, edge cases to handle, and how to verify (typecheck / tests / build). Be specific enough to execute against.
 - Present the plan as your final reply and STOP, unless the user explicitly asked you to "plan first then execute" / "先 plan 再 auto" / autonomous execution: in that case, after presenting the plan, call the switch_mode tool with mode="auto" to switch back to auto mode WITHIN THE SAME TURN and continue implementing the plan yourself (your write/edit/command/memory-write tools become available again immediately). The user will see no approval prompt because you self-switched.
 - If the user entered plan mode manually (via /plan or Shift+Tab) for a safety review and did NOT ask for autonomous execution, do NOT call switch_mode — present the plan and STOP. Do NOT ask the user for confirmation or approval in your text reply (e.g. "is this plan OK?", "shall I proceed?", "需要你确认") — the REPL automatically shows an approval prompt after you STOP, so asking in text is redundant and forces the user to answer twice. Just present the plan and end your reply.`;

package/dist/repl/index.js

@@ -113,7 +113,7 @@ function renderContextBar(history) {
     const pct = Math.min(1, est / win);
     const W = 10;
     const filled = Math.round(pct * W);
-    const bar = filled === 0 ? ' '.repeat(W) : '█'.repeat(filled) + '░'.repeat(W - filled);
+    const bar = '█'.repeat(filled) + '░'.repeat(W - filled);
     const src = contextState.lastUsage ? '实测' : '估算';
     const k = (n) => `${Math.round(n / 1000)}k`;
     const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.cyan;
@@ -129,7 +129,7 @@ function renderContextBarInline(history) {
     const pct = Math.min(1, est / win);
     const W = 10;
     const filled = Math.round(pct * W);
-    const bar = filled === 0 ? ' '.repeat(W) : '█'.repeat(filled) + '░'.repeat(W - filled);
+    const bar = '█'.repeat(filled) + '░'.repeat(W - filled);
     const k = (n) => `${Math.round(n / 1000)}k`;
     const pctCol = pct >= config.compactThreshold ? ui.yellow : ui.cyan;
     return `${ui.gray}[${pctCol}${bar}${ui.reset}] ${pctCol}${Math.round(pct * 100)}%${ui.reset} ${ui.dim}${k(est)}/${k(win)}${ui.reset}`;
@@ -183,15 +183,10 @@ let pendingPrefill = null; // /rollback 选中后预填的 user 输入(下轮 IN
 function onRunningKey(_str, key) {
     if (!key)
         return;
-    // SGR 鼠标滚轮:readline 把 \x1B[<btn;col;rowM 拆成多 fragment,经 mouse.consumeMouse 重组;
-    // 滚轮 → scrollBy(±5)(不调 setUserActive——与键盘滚动一致;流式 flushTimer 在 scrollOffset>0 时不重画,安全)。
-    const _m = mouse.consumeMouse(key.sequence ?? '');
-    if (_m.suppress) {
-        if (_m.wheel)
-            layout.scrollBy(_m.wheel * 5);
+    // 鼠标 fragment:重组 + 派发给 layout.handleMouseEvent(滚轮/框选/复制)。
+    if (mouse.swallow(key.sequence ?? ''))
         return;
-    }
-    // 滚动回看键(优先;不触发回尾):PgUp/PgDn 翻页,↑/↓ 每次 5 行(键盘;鼠标滚轮已由上方守卫处理)。
+    // 滚动回看键(优先;不触发回尾):PgUp/PgDn 翻页,↑/↓ 每次 5 行(键盘)。
     // 运行态无输入光标,↑/↓ 无其他用途,直接作滚动。
     if (key.name === 'pageup' ||
         key.name === 'pagedown' ||
@@ -250,6 +245,11 @@ function onRunningKey(_str, key) {
         layout.paintRunningInputEcho(runningInput, runningPlaceholder);
     }
 }
+/** 鼠标右键单击输入框(未拖动)时 layout 读剪贴板后回调:追加到 typeahead 缓冲(简单粘贴,不分长短)。 */
+function onRunningMousePaste(text) {
+    runningInput += text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    layout.paintRunningInputEcho(runningInput, runningPlaceholder);
+}
 /** 进入运行态:挂 keypress 监听 + raw mode + 新建 abort 控制器,返回其 signal。在 await runAgent 前、enterRunningMode 后调。 */
 function startRunningListener(placeholder) {
     runningPlaceholder = placeholder;
@@ -263,6 +263,7 @@ function startRunningListener(placeholder) {
     }
     stdin.resume();
     emitter.on('keypress', onRunningKey);
+    layout.setPasteHandler(onRunningMousePaste); // 鼠标右键单击输入框(未拖动)→ 读剪贴板贴入
     const ac = new AbortController();
     currentAbort = ac;
     return ac.signal;
@@ -270,6 +271,7 @@ function startRunningListener(placeholder) {
 /** 退出运行态:摘监听 + 清 abort。不 pause / 不 setRawMode(false)——紧接着 promptWithSlashMenu 自己接管 raw。 */
 function stopRunningListener() {
     emitter.off('keypress', onRunningKey);
+    layout.setPasteHandler(null);
     currentAbort = null;
 }
 /**

package/dist/tools/builtins/codegraph.js

@@ -50,9 +50,11 @@ function runCodegraph(args) {
 }
 export const codegraphTool = {
     name: 'codegraph',
-    description: 'Preferred for understanding/locating code, tracing call chains, assessing impact of changes in repos with a code index (.codegraph/).' +
-        ' Returns symbol source + call paths in one shot — more accurate/economical than read_file/grep.' +
-        ' Hints to run `codegraph init` when .codegraph/ is absent.',
+    description: 'FIRST CHOICE for understanding/locating code, tracing call chains, or assessing the impact of changes — use this before read_file/grep when a .codegraph/ index exists.' +
+        ' Returns symbol source + call paths in one shot — more accurate and economical than piecing together read_file/grep.' +
+        ' When to use: starting any code exploration; locating a symbol; understanding how a feature works; seeing what calls a function or what a change affects.' +
+        ' When NOT to use: no .codegraph/ index (build it first with `codegraph init`); reading a file you just edited; editing a single known small file — in those cases go straight to read_file/edit_file.' +
+        ' Fallback: if codegraph misses or the result is incomplete, then use read_file/grep/glob to fill the gaps.',
     parameters: {
         type: 'object',
         properties: {

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

@@ -124,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);
@@ -148,16 +149,10 @@ export async function promptIntervention(req) {
     function onKey(_str, key) {
         if (resolved || !key)
             return;
-        // SGR 鼠标 fragment:readline 拆碎 \x1B[<…M,经 mouse.consumeMouse 重组;
-        // 滚轮 → scrollBy(±5) 滚动查看 agent 输出内容(菜单只靠 ↑↓ 选,滚轮不选菜单);
-        // fragment 期间 suppress 吞掉防砸进 onKeyInput 的可打印插入。菜单经 scrollBy 末尾
-        // repaint()→paintInput(lastView) 重画,不被 viewport 滚动覆盖。
-        const _m = mouse.consumeMouse(key.sequence ?? '');
-        if (_m.suppress) {
-            if (_m.wheel)
-                layout.scrollBy(_m.wheel * 5);
+        // 鼠标 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' });
@@ -276,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();
@@ -297,6 +293,7 @@ export async function promptIntervention(req) {
         }
         catch (e) {
             // 进入失败:必须恢复运行态监听,否则 onRunningKey 残留摘除 → 本 turns 的 Ctrl+C/滚动/typeahead 全废
+            layout.setMouseEnabled(true);
             try {
                 emitter.removeListener('keypress', onKey);
             }