mocode-ai 1.5.8 → 1.5.10

package/dist/context/vision-window.js

@@ -0,0 +1,220 @@
+// 视觉历史滑动窗口(Vision Window)
+//
+// 截图目前**永驻 history**,而每次请求都要重发整个 history → 图像 token **二次增长**
+// (1568×882 ≈1843 tk/张;20 步 ≈387k、50 步 ≈2.35M),长 GUI 任务必然中途 compact,
+// compact 把视觉历史摘要成文本 → 模型忘了自己点过哪,表现为重复点击 / 点错目标。
+//
+// 本模块在**存储层**按「固定张数(keep)+ 成批淘汰(batch)」把旧屏幕帧换成文本占位:
+//   - 图像 token 从二次增长压成线性;
+//   - 只有淘汰那一刻 history 才变字节 → 两次淘汰之间**前缀完全稳定** → prompt cache 可命中。
+//     (这也是必须「成批」而非「逐张老化」的唯一理由:逐张改前缀 = 缓存全废。)
+//
+// 契约(与 src/context/pipeline.ts optimizeToolResult 同款):纯函数、零 I/O、永不抛错。
+// 被剪掉的帧**不可复原**(模型只能重新截图拿到"当前"屏幕),所以占位必须留下可读标注
+// (帧名 + step),并在第一条占位里给出一次性恢复提示。
+//
+// 设计文档:design-notes/vision-window.md
+import { contentTokens } from '../llm/index.js';
+import { ATTACHMENT_PREAMBLE } from '../agent/tool-turn.js';
+/** 附件前言的后缀;与 ATTACHMENT_PREAMBLE 一起框出"帧名清单"的位置。 */
+const ATTACHMENT_TAIL = '. Analyze the attached image content directly.';
+/** 查不到帧名时的兜底占位名。 */
+const UNKNOWN_FRAME_NAME = 'frame';
+/** 恢复提示只写进**第一条**被剪占位,避免 N 条占位重复同一句话侵蚀 token。 */
+const RECOVERY_HINT = ' Call computer{screenshot} if you need the current screen.';
+/**
+ * 白名单:参与滑动窗口的屏幕帧名前缀。
+ *
+ * 取值来自**实际产出点**(design-notes/vision-window.md §2.2 要求实施时读一次代码定稿,不凭猜):
+ *  - ✅ `computer-`:`src/tools/builtins/computer.ts` 的 computer-result.png / computer-screenshot.png /
+ *    computer-zoom.png —— 每次动作回灌的屏幕帧,会被反复收发,是二次增长的来源。
+ *  - ❌ `browser`:`src/tools/builtins/browser.ts:235` 的附件名是 `${sessionId}.png`,**没有稳定前缀**,
+ *    按文档 §2.2 的约定移出白名单(收益小一档但不会误剪)。
+ *  - ❌ `screenshot` / `view_image` / 用户粘贴图:读的是"文档图"或用户意图的直接载体,剪掉是净损失。
+ *
+ * 新增屏幕帧产出点必须沿用 `computer-` 前缀才会自动进窗口;若前缀不同,请在白名单里显式登记
+ * 并同步更新 design-notes/vision-window.md。
+ */
+export const VISION_FRAME_NAME_PREFIXES = ['computer-'];
+const telemetry = { prunes: 0, framesDropped: 0 };
+function userContentParts(message) {
+    if (!message || typeof message !== 'object')
+        return null;
+    if (message.role !== 'user')
+        return null;
+    const content = message.content;
+    if (!Array.isArray(content))
+        return null;
+    const parts = [];
+    for (const part of content) {
+        if (part && typeof part === 'object')
+            parts.push(part);
+    }
+    return parts;
+}
+function imagePartCount(parts) {
+    let count = 0;
+    for (const part of parts)
+        if (part.type === 'image_url')
+            count++;
+    return count;
+}
+/** 从附件前言里解出帧名清单;不是前言返回 null。 */
+function frameNamesFromText(text) {
+    if (!text.startsWith(ATTACHMENT_PREAMBLE))
+        return null;
+    let body = text.slice(ATTACHMENT_PREAMBLE.length);
+    if (body.endsWith(ATTACHMENT_TAIL))
+        body = body.slice(0, -ATTACHMENT_TAIL.length);
+    const names = body
+        .split(',')
+        .map((name) => name.trim())
+        .filter((name) => name.length > 0);
+    return names.length > 0 ? names : null;
+}
+function frameNames(message) {
+    const parts = userContentParts(message);
+    if (!parts)
+        return null;
+    for (const part of parts) {
+        if (typeof part.text === 'string') {
+            const names = frameNamesFromText(part.text);
+            if (names)
+                return names;
+        }
+    }
+    return null;
+}
+/**
+ * 帧载体识别(§2.2 三条规则同时满足):
+ *  1. `role === 'user'` 且 content 是数组;
+ *  2. 数组里至少有 1 个 `image_url` part;
+ *  3. 前言以工具附件前言开头(从而排除用户粘贴图),且**所有**帧名命中白名单
+ *     (混进 view_image / screenshot / 用户图时不整条淘汰 —— 那些剪掉是净损失)。
+ *
+ * 已剪过的消息不再含 image_url part → 规则 2 自然失效 → 幂等。
+ * **不靠自定义字段打标**:消息对象会被 OpenAI SDK 原样发出,严格兼容后端可能 400。
+ */
+export function isFrameCarrier(message) {
+    try {
+        const parts = userContentParts(message);
+        if (!parts || imagePartCount(parts) === 0)
+            return false;
+        const names = frameNames(message);
+        if (!names)
+            return false;
+        return names.every((name) => VISION_FRAME_NAME_PREFIXES.some((prefix) => name.startsWith(prefix)));
+    }
+    catch {
+        // 永不抛错契约:任何意外形状都不该让 agent 循环挂掉。
+        return false;
+    }
+}
+/** 统计 history 里的帧载体数量与在途图像 token(供 `/cu status`)。 */
+export function visionWindowStats(messages) {
+    const stats = { frames: 0, images: 0, imageTokens: 0 };
+    if (!Array.isArray(messages))
+        return stats;
+    for (const message of messages) {
+        const parts = userContentParts(message);
+        if (!parts)
+            continue;
+        if (isFrameCarrier(message))
+            stats.frames++;
+        for (const part of parts) {
+            if (part.type !== 'image_url')
+                continue;
+            stats.images++;
+            // 复用 llm/index.ts 的口径(w*h/750),不重写面积公式,避免两套估算漂移。
+            stats.imageTokens += contentTokens([part]);
+        }
+    }
+    return stats;
+}
+/** 把一条帧载体消息的 content 换成纯文本占位(形状不变:仍是 role:'user' + ContentPart[])。 */
+function pruneFrameMessage(message, names, step, withHint) {
+    const parts = userContentParts(message) ?? [];
+    const lines = [];
+    let index = 0;
+    for (const part of parts) {
+        if (part.type !== 'image_url')
+            continue;
+        lines.push(`[screenshot omitted: ${names[index] ?? UNKNOWN_FRAME_NAME} · step ${step}]`);
+        index++;
+    }
+    if (lines.length === 0)
+        lines.push(`[screenshot omitted: ${names[0] ?? UNKNOWN_FRAME_NAME} · step ${step}]`);
+    if (withHint)
+        lines[0] = `${lines[0]}${RECOVERY_HINT}`;
+    const content = [{ type: 'text', text: lines.join('\n') }];
+    return { role: 'user', content };
+}
+function noopResult(messages) {
+    // changed=false 时必须返回入参引用,调用方才能用 === 判定"零开销"。
+    return { changed: false, dropped: 0, messages: messages };
+}
+/**
+ * 视觉滑动窗口剪枝。**幂等**;未达阈值时返回入参引用且 `changed=false`。
+ *
+ * 算法(淘汰单元 = 附件消息,一期不拆单张图,天然不触碰 tool_call_id 配对):
+ *   frames := 时间序(旧→新)的帧载体下标,n := |frames|
+ *   k      := floor((n - keep) / batch);k <= 0 → no-op
+ *   drop   := frames[0 .. k*batch)
+ *
+ * 由此:仅在 n 涨到 keep+batch 时一次性丢 batch 条,之后 n 落在 [keep, keep+batch-1]。
+ * 丢**固定批量**是关键 —— "超过 keep 就丢到剩 keep" 等于逐张老化,前缀每步都变。
+ */
+export function applyVisionWindow(messages, opts) {
+    try {
+        if (!Array.isArray(messages))
+            return noopResult(messages);
+        const keep = Math.floor(opts?.keep ?? 0);
+        if (!Number.isFinite(keep) || keep <= 0)
+            return noopResult(messages); // keep=0 → 完全关闭
+        const requestedBatch = Math.floor(opts?.batch ?? 1);
+        const batch = Number.isFinite(requestedBatch) && requestedBatch >= 1 ? requestedBatch : 1;
+        const step = Number.isFinite(opts?.step) ? Math.floor(opts.step) : 0;
+        const frameIndexes = [];
+        for (let i = 0; i < messages.length; i++) {
+            if (isFrameCarrier(messages[i]))
+                frameIndexes.push(i);
+        }
+        const batches = Math.floor((frameIndexes.length - keep) / batch);
+        if (batches <= 0)
+            return noopResult(messages);
+        const dropCount = batches * batch;
+        const dropped = new Set(frameIndexes.slice(0, dropCount));
+        // 只对被淘汰的消息做浅拷贝,其余保持原引用。
+        const next = [];
+        let written = 0;
+        for (let i = 0; i < messages.length; i++) {
+            const message = messages[i];
+            if (!dropped.has(i)) {
+                next.push(message);
+                continue;
+            }
+            next.push(pruneFrameMessage(message, frameNames(message) ?? [], step, written === 0));
+            written++;
+        }
+        return { changed: true, dropped: dropCount, messages: next };
+    }
+    catch {
+        return noopResult(messages);
+    }
+}
+/** 累积一次剪枝结果(由 HistoryManager 调用)。 */
+export function recordVisionWindowPrune(droppedFrames) {
+    if (!Number.isFinite(droppedFrames) || droppedFrames <= 0)
+        return;
+    telemetry.prunes++;
+    telemetry.framesDropped += Math.floor(droppedFrames);
+}
+/** 只读累积埋点快照。 */
+export function getVisionWindowTelemetry() {
+    return { prunes: telemetry.prunes, framesDropped: telemetry.framesDropped };
+}
+/** 清空累积埋点(会话切换 / 测试隔离)。 */
+export function resetVisionWindowTelemetry() {
+    telemetry.prunes = 0;
+    telemetry.framesDropped = 0;
+}

package/dist/i18n/index.js

@@ -43,6 +43,11 @@ const zhCN = {
     'commands.modelShow': '显示当前模型配置',
     'commands.modelUse': '按名称应用预设',
     'commands.modelDelete': '删除指定预设',
+    'commands.router': '工具预路由后端（LLM / Jev）',
+    'commands.routerStatus': '显示当前预路由后端与配置',
+    'commands.routerLlm': '用主 LLM 做预路由（默认）',
+    'commands.routerJev': '用 Jev systemone API 做预路由',
+    'commands.routerTest': '探测 Jev 端点连通性',
     'commands.mode': '切换 Agent 工作模式',
     'commands.modePlan': '只读探查并产出计划',
     'commands.modeAuto': '自动执行（工具按任务动态路由）',
@@ -278,6 +283,8 @@ const zhCN = {
     'cu.changedOn': '已允许按需路由 computer-control；只有明确 GUI 操作意图才会选择，且每个动作仍需权限确认。',
     'cu.changedOff': '已禁止 computer-control；路由器和运行时都会拦截后续 computer 调用。',
     'cu.usage': '用法：/cu on|off|status',
+    'cu.visionWindow': '视觉窗口 · {frames} 条帧消息 · history 内 {images} 张图 · 约 {tokens} 图像 token · keep {keep}/batch {batch} · 已淘汰 {dropped}',
+    'cu.actionLedger': '动作台账 · 已记录 {count} 条 GUI 动作',
     'mcp.status': 'MCP 服务：{state}',
     'mcp.stateOn': '开启',
     'mcp.stateOff': '关闭',
@@ -327,6 +334,20 @@ const zhCN = {
     'upgrade.pkgName': '包名：mocode-ai',
     'upgrade.failed': '[upgrade] 失败：{message}',
     'upgrade.usage': '/upgrade 用法：\n  /upgrade              升级到最新版本\n  /upgrade now          同 /upgrade\n  /upgrade check        检查当前版本与最新版本差异\n  /upgrade status       显示当前本地版本',
+    'router.status': '工具预路由后端：{mode}',
+    'router.modeLlm': 'LLM（与主 Agent 同一后端，默认）',
+    'router.modeJev': 'Jev（TypeSafe systemone API）',
+    'router.jevConfig': '端点 {baseUrl} · 模型 {model} · key {key} · 阈值 {min}/{minMcp}',
+    'router.source': '来源 {env}（{path}）',
+    'router.usage': '/router 用法：\n  /router                 显示当前后端与配置\n  /router llm             用主 LLM 做预路由（默认）\n  /router jev             用 Jev systemone API 做预路由\n  /router base <url>      设置 Jev 端点（本地兼容层可指向 localhost）\n  /router key <key>       设置 Jev API key\n  /router model <name>    设置 Jev 模型名（默认 jev-latest）\n  /router min <0-1>       设置通用出簇阈值（默认 0.65）\n  /router min-mcp <0-1>   设置 mcp 专用阈值（默认 0.85）\n  /router test            探测 Jev 端点连通性',
+    'router.changed': '已切换预路由后端 → {mode}（下一轮生效）',
+    'router.set': '已设置 {field} = {value}（下一轮生效）',
+    'router.invalid': '参数无效：{detail}',
+    'router.testRunning': '正在探测 Jev 端点…',
+    'router.testOk': 'Jev 端点可用：{latency}ms · 模型 {model}',
+    'router.testFail': 'Jev 端点不可用：{error}',
+    'router.saved': '已持久化到 {path}',
+    'router.needsKey': '尚未配置 Jev API key；请先运行 /router key <key>。',
 };
 const en = {
     'common.none': '(none)',
@@ -373,6 +394,11 @@ const en = {
     'commands.modelShow': 'Show current model configuration',
     'commands.modelUse': 'Apply a preset by name',
     'commands.modelDelete': 'Delete a preset',
+    'commands.router': 'Tool pre-routing backend (LLM / Jev)',
+    'commands.routerStatus': 'Show current pre-routing backend and config',
+    'commands.routerLlm': 'Route with the main LLM (default)',
+    'commands.routerJev': 'Route with the Jev systemone API',
+    'commands.routerTest': 'Probe Jev endpoint connectivity',
     'commands.mode': 'Switch Agent mode',
     'commands.modePlan': 'Read-only research and planning',
     'commands.modeAuto': 'Execute automatically with task-routed tools',
@@ -608,6 +634,8 @@ const en = {
     'cu.changedOn': 'Automatic routing may now select computer-control for explicit GUI intent; every action still requires permission approval.',
     'cu.changedOff': 'Computer-control is blocked; both the router and runtime reject subsequent computer calls.',
     'cu.usage': 'Usage: /cu on|off|status',
+    'cu.visionWindow': 'vision window · {frames} frame msg(s) · {images} image(s) in history · ~{tokens} image tk · keep {keep}/batch {batch} · {dropped} dropped',
+    'cu.actionLedger': 'action ledger · {count} gui actions logged',
     'mcp.status': 'MCP services: {state}',
     'mcp.stateOn': 'enabled',
     'mcp.stateOff': 'disabled',
@@ -657,6 +685,20 @@ const en = {
     'upgrade.pkgName': 'Package: mocode-ai',
     'upgrade.failed': '[upgrade] failed: {message}',
     'upgrade.usage': 'Usage: /upgrade\n  /upgrade              Upgrade to latest\n  /upgrade now          Same as /upgrade\n  /upgrade check        Check current vs latest\n  /upgrade status       Show current local version',
+    'router.status': 'Tool pre-routing backend: {mode}',
+    'router.modeLlm': 'LLM (same backend as the main agent; default)',
+    'router.modeJev': 'Jev (TypeSafe systemone API)',
+    'router.jevConfig': 'endpoint {baseUrl} · model {model} · key {key} · thresholds {min}/{minMcp}',
+    'router.source': 'Source {env} ({path})',
+    'router.usage': 'Usage: /router\n  /router                 Show backend and config\n  /router llm             Route with the main LLM (default)\n  /router jev             Route with the Jev systemone API\n  /router base <url>      Set the Jev endpoint (point at localhost for a local compat server)\n  /router key <key>       Set the Jev API key\n  /router model <name>    Set the Jev model name (default jev-latest)\n  /router min <0-1>       Set the general activation threshold (default 0.65)\n  /router min-mcp <0-1>   Set the mcp-specific threshold (default 0.85)\n  /router test            Probe Jev endpoint connectivity',
+    'router.changed': 'Pre-routing backend switched → {mode} (takes effect next turn)',
+    'router.set': 'Set {field} = {value} (takes effect next turn)',
+    'router.invalid': 'Invalid argument: {detail}',
+    'router.testRunning': 'Probing Jev endpoint…',
+    'router.testOk': 'Jev endpoint is reachable: {latency}ms · model {model}',
+    'router.testFail': 'Jev endpoint unreachable: {error}',
+    'router.saved': 'Persisted to {path}',
+    'router.needsKey': 'Jev API key is not configured yet; run /router key <key> first.',
 };
 const resources = {
     'zh-CN': zhCN,

package/dist/llm/providers/anthropic.js

@@ -114,14 +114,46 @@ export function encodeAnthropicMessages(input, promptCache = config.anthropicPro
             ], cacheCandidates);
         }
     }
-    if (promptCache) {
-        // 最后一个稳定消息块形成会话前缀断点；动态 session reminder 明确不参与。
+    /** Anthropic 允许的最大 cache 断点数(硬上限,超出直接 400)。 */
+    const MAX_CACHE_BREAKPOINTS = 4;
+    /** tools 断点在 encodeAnthropicTools 里打;tool 列表通常恒非空,这里保守预留它那一份额度。 */
+    const TOOLS_BREAKPOINT_RESERVE = 1;
+    /** 文档建议「最近 3 个 tool_result」;实际额度受 MAX_CACHE_BREAKPOINTS 约束后通常是 2。 */
+    const MAX_TOOL_RESULT_BREAKPOINTS = 3;
+    /**
+     * 打 cache 断点。对齐 Anthropic computer use 官方实践:**system + tools + 最近若干 tool_result**。
+     *
+     * 以前只在"最后一个稳定消息块"打 1 个 —— 那通常是本轮刚回灌的 tool_result / 最新用户图,
+     * 每轮都不一样,既拍不到真正稳定的前缀,又浪费了额度。
+     *
+     * 前缀越长、命中率越高,所以断点优先给**靠后但仍稳定**的 tool_result(tool 结果一旦提交永不改)。
+     *
+     * 注意:断点打在**本函数新建的 block 对象**上,不会写回 history 的消息对象 →
+     * 天然"每轮清空",不存在跨轮累积超限的问题。
+     */
+    function markCacheBreakpoints(system, cacheCandidates) {
+        let used = TOOLS_BREAKPOINT_RESERVE;
+        if (system.length > 0) {
+            system[system.length - 1].cache_control = { type: 'ephemeral' };
+            used++;
+        }
+        const toolResults = cacheCandidates.filter((block) => block.type === 'tool_result');
+        const slots = Math.min(MAX_TOOL_RESULT_BREAKPOINTS, MAX_CACHE_BREAKPOINTS - used);
+        if (slots <= 0)
+            return;
+        if (toolResults.length > 0) {
+            for (const block of toolResults.slice(-slots)) {
+                block.cache_control = { type: 'ephemeral' };
+            }
+            return;
+        }
+        // 纯对话(没有 tool_result)时退化到旧行为:最后一个稳定消息块。
         const last = cacheCandidates[cacheCandidates.length - 1];
         if (last)
             last.cache_control = { type: 'ephemeral' };
-        // 没有对话时仍缓存稳定 system prompt。
-        else if (system.length > 0)
-            system[system.length - 1].cache_control = { type: 'ephemeral' };
+    }
+    if (promptCache) {
+        markCacheBreakpoints(system, cacheCandidates);
     }
     return { system, messages };
 }

package/dist/repl/commands/registry.js

@@ -10,6 +10,7 @@ import { skillCommands } from './skill.js';
 import { compactCommands } from './compact.js';
 import { appearanceCommands } from './appearance.js';
 import { modelCommands } from './model.js';
+import { routerCommands } from './router.js';
 import { toolGroupCommands } from './tool-group.js';
 /**
  * 命令注册表。顺序即匹配优先级 —— 更具体的分支放前面。
@@ -29,6 +30,7 @@ export const commandHandlers = [
     ...compactCommands,
     ...appearanceCommands,
     ...modelCommands,
+    ...routerCommands,
     ...toolGroupCommands,
 ];
 /**

package/dist/repl/commands/router.js

@@ -0,0 +1,141 @@
+/**
+ * /router —— 工具预路由后端切换与配置(llm | jev)。
+ *
+ * 为什么单独一个命令而不是并进 /model:
+ * /model 管的是「主 Agent 用哪个大模型」(OpenAI/Anthropic 兼容),而预路由后端是**另一个**
+ * 决策面——可以让主 Agent 用 A 模型、预路由用 Jev。二者生命周期独立,故独立命令。
+ *
+ * 即时性:所有读写都落在 process.env(见 config/index.ts 的 getRouterMode/getJevRouterConfig),
+ * 而 routeToolGroups 在**每个真实用户 turn** 的调用点才读它 → 改完下一轮生效,无需重启。
+ * 这也是为什么不走 Config 单例:const config 在模块初始化时求值,拿不到运行时切换。
+ *
+ * 持久化:~/.mocode/config(与 /model /theme 同一入口 writeConfigKeys)。
+ * 注意 shell 里 export 了同名 MOCODE_ROUTER_* 时,loadEnvFiles 不回填该键,下次启动仍以 shell 为准。
+ */
+import * as layout from '../../ui/layout.js';
+import { ui } from '../../ui/theme.js';
+import { t } from '../../i18n/index.js';
+import { getRouterMode, updateRouterMode, getJevRouterConfig, updateJevRouterConfig, isJevRouterConfigured, } from '../../config/index.js';
+import { writeConfigKeys, CONFIG_PATH } from '../../config/file.js';
+import { probeJev } from '../../tools/jev-client.js';
+import { maskKey } from '../commands.js';
+import { unhandled, next } from './types.js';
+const ROUTER_ENV_KEYS = {
+    mode: 'MOCODE_ROUTER_MODE',
+    baseUrl: 'MOCODE_ROUTER_JEV_BASE_URL',
+    apiKey: 'MOCODE_ROUTER_JEV_API_KEY',
+    model: 'MOCODE_ROUTER_JEV_MODEL',
+    confidenceMin: 'MOCODE_ROUTER_CONFIDENCE_MIN',
+    confidenceMinMcp: 'MOCODE_ROUTER_CONFIDENCE_MIN_MCP',
+};
+export const routerCommands = [
+    async (ctx) => {
+        const { line } = ctx;
+        if (line !== '/router' && !line.startsWith('/router '))
+            return unhandled();
+        const rest = line.startsWith('/router ') ? line.slice('/router '.length).trim() : '';
+        const spaceIndex = rest.indexOf(' ');
+        const sub = (spaceIndex === -1 ? rest : rest.slice(0, spaceIndex)).toLowerCase();
+        const arg = spaceIndex === -1 ? '' : rest.slice(spaceIndex + 1).trim();
+        const showStatus = () => {
+            const mode = getRouterMode();
+            const label = mode === 'jev' ? t('router.modeJev') : t('router.modeLlm');
+            layout.contentWrite(`${ui.accent}${t('router.status', { mode: label })}${ui.reset}\n`);
+            const jev = getJevRouterConfig();
+            layout.contentWrite(`${ui.dim}${t('router.jevConfig', {
+                baseUrl: jev.baseUrl,
+                model: jev.model,
+                key: maskKey(jev.apiKey),
+                min: String(jev.confidenceMin),
+                minMcp: String(jev.confidenceMinMcp),
+            })}${ui.reset}\n`);
+            layout.contentWrite(`${ui.dim}${t('router.source', { env: ROUTER_ENV_KEYS.mode, path: CONFIG_PATH })}${ui.reset}\n`);
+        };
+        // /router 或 /router status
+        if (rest === '' || sub === 'status') {
+            showStatus();
+            return next();
+        }
+        // /router llm | /router jev —— 切换后端
+        if (sub === 'llm' || sub === 'jev') {
+            const mode = sub === 'jev' ? 'jev' : 'llm';
+            updateRouterMode(mode);
+            writeConfigKeys({ [ROUTER_ENV_KEYS.mode]: mode });
+            const label = mode === 'jev' ? t('router.modeJev') : t('router.modeLlm');
+            layout.contentWrite(`${ui.green}${t('router.changed', { mode: label })}${ui.reset}\n`);
+            // 切到 jev 但没配 key 是最常见的无用配置,当场提示,避免用户以为已生效。
+            if (mode === 'jev' && !isJevRouterConfigured()) {
+                layout.contentWrite(`${ui.yellow}${t('router.needsKey')}${ui.reset}\n`);
+            }
+            return next();
+        }
+        // /router base <url>
+        if (sub === 'base') {
+            if (!arg) {
+                layout.contentWrite(`${ui.yellow}${t('router.usage')}${ui.reset}\n`);
+                return next();
+            }
+            if (!/^https?:\/\//i.test(arg)) {
+                layout.contentWrite(`${ui.yellow}${t('router.invalid', { detail: arg })}${ui.reset}\n`);
+                return next();
+            }
+            const baseUrl = arg.replace(/\/+$/, '');
+            updateJevRouterConfig({ baseUrl });
+            writeConfigKeys({ [ROUTER_ENV_KEYS.baseUrl]: baseUrl });
+            layout.contentWrite(`${ui.green}${t('router.set', { field: 'baseUrl', value: baseUrl })}${ui.reset}\n`);
+            return next();
+        }
+        // /router key <key> —— 明文 key 写入 ~/.mocode/config,与 /model 对 LLM_API_KEY 的做法一致;显示只露末 4 位。
+        if (sub === 'key') {
+            if (!arg) {
+                layout.contentWrite(`${ui.yellow}${t('router.usage')}${ui.reset}\n`);
+                return next();
+            }
+            updateJevRouterConfig({ apiKey: arg });
+            writeConfigKeys({ [ROUTER_ENV_KEYS.apiKey]: arg });
+            layout.contentWrite(`${ui.green}${t('router.set', { field: 'apiKey', value: maskKey(arg) })}${ui.reset}\n`);
+            layout.contentWrite(`${ui.dim}${t('router.saved', { path: CONFIG_PATH })}${ui.reset}\n`);
+            return next();
+        }
+        // /router model <name>
+        if (sub === 'model') {
+            if (!arg) {
+                layout.contentWrite(`${ui.yellow}${t('router.usage')}${ui.reset}\n`);
+                return next();
+            }
+            updateJevRouterConfig({ model: arg });
+            writeConfigKeys({ [ROUTER_ENV_KEYS.model]: arg });
+            layout.contentWrite(`${ui.green}${t('router.set', { field: 'model', value: arg })}${ui.reset}\n`);
+            return next();
+        }
+        // /router min <0-1> 与 /router min-mcp <0-1>
+        if (sub === 'min' || sub === 'min-mcp') {
+            const value = Number(arg);
+            if (!arg || !Number.isFinite(value) || value < 0 || value > 1) {
+                layout.contentWrite(`${ui.yellow}${t('router.invalid', { detail: arg || '(空)' })}${ui.reset}\n`);
+                return next();
+            }
+            const field = sub === 'min' ? 'confidenceMin' : 'confidenceMinMcp';
+            const envKey = sub === 'min' ? ROUTER_ENV_KEYS.confidenceMin : ROUTER_ENV_KEYS.confidenceMinMcp;
+            updateJevRouterConfig({ [field]: value });
+            writeConfigKeys({ [envKey]: String(value) });
+            layout.contentWrite(`${ui.green}${t('router.set', { field: sub, value: String(value) })}${ui.reset}\n`);
+            return next();
+        }
+        // /router test —— 探测 Jev 端点连通性(不等下一轮,当场给结果)
+        if (sub === 'test') {
+            const jev = getJevRouterConfig();
+            layout.contentWrite(`${ui.dim}${t('router.testRunning')}${ui.reset}\n`);
+            const result = await probeJev({ baseUrl: jev.baseUrl, apiKey: jev.apiKey, model: jev.model });
+            if (result.ok) {
+                layout.contentWrite(`${ui.green}${t('router.testOk', { latency: String(result.latencyMs), model: result.model ?? jev.model })}${ui.reset}\n`);
+            }
+            else {
+                layout.contentWrite(`${ui.red}${t('router.testFail', { error: result.error ?? 'unknown' })}${ui.reset}\n`);
+            }
+            return next();
+        }
+        layout.contentWrite(`${ui.yellow}${t('router.usage')}${ui.reset}\n`);
+        return next();
+    },
+];

package/dist/repl/commands/tool-group.js

@@ -10,7 +10,7 @@ import * as layout from '../../ui/layout.js';
 import { ui } from '../../ui/theme.js';
 import { bannerLines } from '../../ui/render.js';
 import { t } from '../../i18n/index.js';
-import { isSubAgentRouteAllowed, updateSubAgentConfig, isFrontendRouteAllowed, updateFrontendToolsConfig, isComputerUseRouteAllowed, updateComputerUseConfig, isMcpEnabled, updateMcpConfig, isMemoryEnabled, isMemoryRouteAllowed, updateMemoryConfig, } from '../../config/index.js';
+import { isSubAgentRouteAllowed, updateSubAgentConfig, isFrontendRouteAllowed, updateFrontendToolsConfig, isComputerUseRouteAllowed, updateComputerUseConfig, isMcpEnabled, updateMcpConfig, isMemoryEnabled, isMemoryRouteAllowed, updateMemoryConfig, visionKeep, visionBatch, } from '../../config/index.js';
 import { updateConfigKey, CONFIG_PATH } from '../../config/file.js';
 import { getAgentMode } from '../../agent/mode.js';
 import { refreshChatTools } from '../../llm/index.js';
@@ -117,6 +117,38 @@ export const toolGroupCommands = [
             catch {
                 // 埋点不可用时不影响状态输出。
             }
+            // 视觉窗口:本地延时是线性项,图像二次增长才是长 GUI 任务的爆点,必须与延时分开暴露。
+            // 看点是「在途帧数停在 [keep, keep+batch-1] 不随步数涨」+「dropped 在涨(证明窗口真的在剪)」。
+            try {
+                const { visionWindowStats, getVisionWindowTelemetry } = await import('../../context/vision-window.js');
+                const vw = visionWindowStats(ctx.history);
+                if (vw.images > 0) {
+                    const tel = getVisionWindowTelemetry();
+                    layout.contentWrite(`${ui.dim}${t('cu.visionWindow', {
+                        frames: vw.frames,
+                        images: vw.images,
+                        tokens: vw.imageTokens,
+                        keep: visionKeep(),
+                        batch: visionBatch(),
+                        dropped: tel.framesDropped,
+                    })}${ui.reset}\n`);
+                }
+            }
+            catch {
+                // 同上:面板指标不可用不影响状态输出。
+            }
+            // GUI 动作台账(L2):与窗口指标并列。台账是时间轴(做过什么),窗口是空间轴(最新几帧),
+            // 二者都不显示时说明本会话还没跑过 computer。
+            try {
+                const { countGuiActions } = await import('../../session/gui-actions.js');
+                const ledgerCount = countGuiActions();
+                if (ledgerCount > 0) {
+                    layout.contentWrite(`${ui.dim}${t('cu.actionLedger', { count: ledgerCount })}${ui.reset}\n`);
+                }
+            }
+            catch {
+                // 台账不可读不影响状态输出。
+            }
             return next();
         }
         if (arg !== 'on' && arg !== 'off') {

package/dist/repl/commands.js

@@ -81,6 +81,16 @@ export function buildSlashCommands() {
                 { name: 'delete <name>', value: '/model delete ', submit: false, desc: d('commands.modelDelete') },
             ],
         },
+        {
+            name: '/router',
+            desc: d('commands.router'),
+            children: [
+                { name: 'status', value: '/router', desc: d('commands.routerStatus') },
+                { name: 'llm', value: '/router llm', desc: d('commands.routerLlm') },
+                { name: 'jev', value: '/router jev', desc: d('commands.routerJev') },
+                { name: 'test', value: '/router test', desc: d('commands.routerTest') },
+            ],
+        },
         {
             name: '/mode',
             desc: d('commands.mode'),
@@ -156,7 +166,7 @@ export const HELP_GROUPS = [
     { key: 'help.groupSession', names: ['/sessions', '/rollback', '/memory', '/skills', '/skill', '/init'] },
     {
         key: 'help.groupConfig',
-        names: ['/mode', '/subagent', '/fe', '/mcp', '/theme', '/pet', '/image', '/language', '/upgrade'],
+        names: ['/mode', '/subagent', '/fe', '/mcp', '/router', '/theme', '/pet', '/image', '/language', '/upgrade'],
     },
 ];
 /**

package/dist/repl/runtime.js

@@ -9,7 +9,7 @@ import { getAgentMode, setAgentMode, onModeChange } from '../agent/mode.js';
 import { sendState } from '../pet/bridge.js';
 import { setSandboxRoot } from '../sandbox/root.js';
 import { ui, setTheme } from '../ui/theme.js';
-import { bannerLines, displayWidth } from '../ui/render.js';
+import { bannerLines } from '../ui/render.js';
 import * as layout from '../ui/layout.js';
 import * as mouse from '../ui/mouse.js';
 import { promptWithSlashMenu, promptTurnPicker, promptRevertChoice } from '../ui/prompt.js';
@@ -226,27 +226,26 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
      * 首次提交任何输入(消息或斜杠命令)前由 layout.dismissWelcomeBlock 整块撤掉——
      * 「一打开就能看见,开始干活就消失」。/clear 清空后重新写一次(回到空会话状态)。
      */
-    // 欢迎块整块按终端宽度居中:先按纯文本(displayWidth 不剥 ANSI)算左缩进,再套色;
-    // 余数列归左,与输入框提示行的居中策略一致;超宽行由 contentWrite 兜底折行。
+    // 这里只产出**逻辑行**(带色、不带缩进);整块按终端宽度居中由 layout.writeWelcomeBlock
+    // 按写入当时的列宽现算,并把逻辑行源记入 layout state——resize 后按新列宽重新居中/折行,
+    // 否则块停留在启动宽度,缩窄后被截断成「…」(「提示不随窗口变化」bug)。
     const welcomeLines = () => {
-        const cols = layout.getGeo().cols;
-        const pad = (plain) => ' '.repeat(Math.max(0, Math.floor((cols - displayWidth(plain)) / 2)));
         const ideNotice = `⚠ ${t('welcome.ideNotice')}`;
         return [
             '',
-            `${pad(ideNotice)}${ui.yellow}${ui.bold}${ideNotice}${ui.reset}`,
+            `${ui.yellow}${ui.bold}${ideNotice}${ui.reset}`,
             '',
-            `${pad(t('welcome.gettingStarted'))}${ui.accent}${ui.bold}${t('welcome.gettingStarted')}${ui.reset}`,
-            `${pad(`· ${t('welcome.start1')}`)}${ui.dim}· ${t('welcome.start1')}${ui.reset}`,
-            `${pad(`· ${t('welcome.start2')}`)}${ui.dim}· ${t('welcome.start2')}${ui.reset}`,
-            `${pad(`· ${t('welcome.start3')}`)}${ui.dim}· ${t('welcome.start3')}${ui.reset}`,
+            `${ui.accent}${ui.bold}${t('welcome.gettingStarted')}${ui.reset}`,
+            `${ui.dim}· ${t('welcome.start1')}${ui.reset}`,
+            `${ui.dim}· ${t('welcome.start2')}${ui.reset}`,
+            `${ui.dim}· ${t('welcome.start3')}${ui.reset}`,
             '',
-            `${pad(t('welcome.capabilities'))}${ui.accent}${ui.bold}${t('welcome.capabilities')}${ui.reset}`,
-            `${pad(`· ${t('welcome.cap1')}`)}${ui.dim}· ${t('welcome.cap1')}${ui.reset}`,
-            `${pad(`· ${t('welcome.cap2')}`)}${ui.dim}· ${t('welcome.cap2')}${ui.reset}`,
-            `${pad(`· ${t('welcome.cap3')}`)}${ui.dim}· ${t('welcome.cap3')}${ui.reset}`,
+            `${ui.accent}${ui.bold}${t('welcome.capabilities')}${ui.reset}`,
+            `${ui.dim}· ${t('welcome.cap1')}${ui.reset}`,
+            `${ui.dim}· ${t('welcome.cap2')}${ui.reset}`,
+            `${ui.dim}· ${t('welcome.cap3')}${ui.reset}`,
             '',
-            `${pad(t('welcome.try'))}${ui.dim}${t('welcome.try')}${ui.reset}`,
+            `${ui.dim}${t('welcome.try')}${ui.reset}`,
             '',
         ];
     };