mocode-ai 1.3.9 → 1.4.0

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

@@ -0,0 +1,233 @@
+/**
+ * 自动工具路由的 capability gate 命令组：/subagent · /fe(/frontend) · /cu(/computer) ·
+ * /mcp · /memory_switch · /memory_status。
+ *
+ * `/subagent`、`/fe`、`/cu` 不再把工具常驻加入 schema：on/unset 仅允许下一真实用户轮的
+ * LLM router 按需选择对应簇，off 写入 env=false 并形成硬否决。refreshChatTools 只为没有
+ * ToolPolicy 的 legacy 嵌入路径保留。MCP 仍负责真实连接生命周期；memory 开关还控制索引。
+ */
+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 { updateConfigKey, CONFIG_PATH } from '../../config/file.js';
+import { getAgentMode } from '../../agent/mode.js';
+import { refreshChatTools } from '../../llm/index.js';
+import { registerToolsExtension } from '../../tools/registry.js';
+import { initializeAllMcp, getMcpTools, closeAllMcp } from '../../mcp/index.js';
+import { unhandled, next } from './types.js';
+export const toolGroupCommands = [
+    // /subagent [status|on|off] — orchestration 簇的兼容 capability gate。
+    (ctx) => {
+        const { line } = ctx;
+        if (line !== '/subagent' && !line.startsWith('/subagent '))
+            return unhandled();
+        const arg = line.startsWith('/subagent ') ? line.slice('/subagent '.length).trim().toLowerCase() : 'status';
+        if (arg === '' || arg === 'status') {
+            const enabled = isSubAgentRouteAllowed();
+            const state = t(enabled ? 'subagent.stateOn' : 'subagent.stateOff');
+            layout.contentWrite(`${ui.accent}${t('subagent.status', { state })}${ui.reset}\n` +
+                `${ui.dim}MOCODE_SUBAGENT_ENABLED=${enabled ? 'true' : 'false'} · ${CONFIG_PATH}${ui.reset}\n`);
+            return next();
+        }
+        if (arg !== 'on' && arg !== 'off') {
+            layout.contentWrite(`${ui.yellow}${t('subagent.usage')}${ui.reset}\n`);
+            return next();
+        }
+        const enabled = arg === 'on';
+        if (enabled !== isSubAgentRouteAllowed()) {
+            updateSubAgentConfig(enabled);
+            updateConfigKey('MOCODE_SUBAGENT_ENABLED', enabled ? 'true' : 'false');
+            refreshChatTools();
+            ctx.history[0] = { role: 'system', content: ctx.buildSystemMessage(getAgentMode() === 'plan') };
+            layout.rewriteBanner(bannerLines(ctx.banner()));
+        }
+        layout.contentWrite(`${enabled ? ui.green : ui.yellow}${t(enabled ? 'subagent.changedOn' : 'subagent.changedOff')}${ui.reset}\n`);
+        return next();
+    },
+    // /fe|/frontend [status|on|off] — browser-debug + desktop-observe 的兼容 gate。
+    // view_image 是 common 工具，不受此开关影响。
+    (ctx) => {
+        const { line } = ctx;
+        const isFe = line === '/fe' || line.startsWith('/fe ') || line === '/frontend' || line.startsWith('/frontend ');
+        if (!isFe)
+            return unhandled();
+        const raw = line.startsWith('/fe ')
+            ? line.slice('/fe '.length)
+            : line.startsWith('/frontend ')
+                ? line.slice('/frontend '.length)
+                : line === '/frontend'
+                    ? ''
+                    : line.slice('/fe'.length);
+        const arg = raw.trim().toLowerCase();
+        if (arg === '' || arg === 'status') {
+            const enabled = isFrontendRouteAllowed();
+            const state = t(enabled ? 'fe.stateOn' : 'fe.stateOff');
+            layout.contentWrite(`${ui.accent}${t('fe.status', { state })}${ui.reset}\n` +
+                `${ui.dim}MOCODE_FRONTEND_TOOLS_ENABLED=${enabled ? 'true' : 'false'} · ${CONFIG_PATH}${ui.reset}\n`);
+            return next();
+        }
+        if (arg !== 'on' && arg !== 'off') {
+            layout.contentWrite(`${ui.yellow}${t('fe.usage')}${ui.reset}\n`);
+            return next();
+        }
+        const enabled = arg === 'on';
+        if (enabled !== isFrontendRouteAllowed()) {
+            updateFrontendToolsConfig(enabled);
+            updateConfigKey('MOCODE_FRONTEND_TOOLS_ENABLED', enabled ? 'true' : 'false');
+            refreshChatTools();
+            ctx.history[0] = { role: 'system', content: ctx.buildSystemMessage(getAgentMode() === 'plan') };
+            layout.rewriteBanner(bannerLines(ctx.banner()));
+        }
+        layout.contentWrite(`${enabled ? ui.green : ui.yellow}${t(enabled ? 'fe.changedOn' : 'fe.changedOff')}${ui.reset}\n`);
+        return next();
+    },
+    // /cu|/computer [status|on|off] — computer-control 的高危 capability gate。
+    // on 仅允许 router 在用户明确要求 GUI 操作时选择；每个动作仍经过权限门，plan 永远过滤。
+    (ctx) => {
+        const { line } = ctx;
+        const isCu = line === '/cu' || line.startsWith('/cu ') || line === '/computer' || line.startsWith('/computer ');
+        if (!isCu)
+            return unhandled();
+        const raw = line.startsWith('/cu ')
+            ? line.slice('/cu '.length)
+            : line.startsWith('/computer ')
+                ? line.slice('/computer '.length)
+                : line === '/computer'
+                    ? ''
+                    : line.slice('/cu'.length);
+        const arg = raw.trim().toLowerCase();
+        if (arg === '' || arg === 'status') {
+            const enabled = isComputerUseRouteAllowed();
+            const state = t(enabled ? 'cu.stateOn' : 'cu.stateOff');
+            layout.contentWrite(`${ui.accent}${t('cu.status', { state })}${ui.reset}\n` +
+                `${ui.dim}MOCODE_COMPUTER_USE_ENABLED=${enabled ? 'true' : 'false'} · ${CONFIG_PATH}${ui.reset}\n`);
+            return next();
+        }
+        if (arg !== 'on' && arg !== 'off') {
+            layout.contentWrite(`${ui.yellow}${t('cu.usage')}${ui.reset}\n`);
+            return next();
+        }
+        const enabled = arg === 'on';
+        if (enabled !== isComputerUseRouteAllowed()) {
+            updateComputerUseConfig(enabled);
+            updateConfigKey('MOCODE_COMPUTER_USE_ENABLED', enabled ? 'true' : 'false');
+            refreshChatTools();
+            ctx.history[0] = { role: 'system', content: ctx.buildSystemMessage(getAgentMode() === 'plan') };
+            layout.rewriteBanner(bannerLines(ctx.banner()));
+        }
+        layout.contentWrite(`${enabled ? ui.green : ui.yellow}${t(enabled ? 'cu.changedOn' : 'cu.changedOff')}${ui.reset}\n`);
+        return next();
+    },
+    // /mcp [status|on|off] — 唯一带 async 副作用的开关(on 连 MCP,off 断)。
+    async (ctx) => {
+        const { line } = ctx;
+        if (line !== '/mcp' && !line.startsWith('/mcp '))
+            return unhandled();
+        const arg = line.startsWith('/mcp ') ? line.slice('/mcp '.length).trim().toLowerCase() : 'status';
+        if (arg === '' || arg === 'status') {
+            const enabled = isMcpEnabled();
+            const state = t(enabled ? 'mcp.stateOn' : 'mcp.stateOff');
+            layout.contentWrite(`${ui.accent}${t('mcp.status', { state })}${ui.reset}\n` +
+                `${ui.dim}MOCODE_MCP_ENABLED=${enabled ? 'true' : 'false'} · ${CONFIG_PATH}${ui.reset}\n` +
+                `${ui.dim}${t('mcp.restartHint')}${ui.reset}\n`);
+            return next();
+        }
+        if (arg !== 'on' && arg !== 'off') {
+            layout.contentWrite(`${ui.yellow}${t('mcp.usage')}${ui.reset}\n`);
+            return next();
+        }
+        const enabled = arg === 'on';
+        if (enabled === isMcpEnabled()) {
+            layout.contentWrite(`${ui.dim}${t('mcp.unchanged', { state: t(enabled ? 'mcp.stateOn' : 'mcp.stateOff') })}${ui.reset}\n`);
+            return next();
+        }
+        updateMcpConfig(enabled);
+        updateConfigKey('MOCODE_MCP_ENABLED', enabled ? 'true' : 'false');
+        if (enabled) {
+            await initializeAllMcp();
+            registerToolsExtension('mcp', getMcpTools());
+        }
+        else {
+            await closeAllMcp();
+            registerToolsExtension('mcp', []);
+        }
+        refreshChatTools();
+        ctx.history[0] = { role: 'system', content: ctx.buildSystemMessage(getAgentMode() === 'plan') };
+        layout.rewriteBanner(bannerLines(ctx.banner()));
+        layout.contentWrite(`${enabled ? ui.green : ui.yellow}${t(enabled ? 'mcp.changedOn' : 'mcp.changedOff')}${ui.reset}\n`);
+        return next();
+    },
+    // /memory_switch [on|off|status] · /memory_status — 同时管理 memory route gate 与 Memory Index。
+    // 无参切换；status 明确区分“可被路由”和“索引/反思已启用”，避免 unset 状态被误报为禁用。
+    (ctx) => {
+        const { line } = ctx;
+        const isMemSwitch = line === '/memory_switch' ||
+            line.startsWith('/memory_switch ') ||
+            line === '/memory_status' ||
+            line.startsWith('/memory_status ');
+        if (!isMemSwitch)
+            return unhandled();
+        try {
+            const switchArg = line.startsWith('/memory_switch ')
+                ? line.slice('/memory_switch '.length).trim().toLowerCase()
+                : '';
+            const showStatus = line === '/memory_status' || line.startsWith('/memory_status ') || switchArg === 'status';
+            if (showStatus) {
+                const routeAllowed = isMemoryRouteAllowed();
+                const indexEnabled = isMemoryEnabled();
+                layout.contentWrite(`${ui.accent}${t('memory.routeStatus', {
+                    state: t(routeAllowed ? 'memory.stateAllowed' : 'memory.stateBlocked'),
+                })}${ui.reset}\n` +
+                    `${ui.accent}${t('memory.indexStatus', {
+                        state: t(indexEnabled ? 'memory.stateEnabled' : 'memory.stateDisabled'),
+                    })}${ui.reset}\n`);
+                layout.contentWrite(`${ui.dim}${t('memory.source', {
+                    value: process.env.MEMORY_ENABLED ?? '<unset>',
+                    path: CONFIG_PATH,
+                })}${ui.reset}\n` + `${ui.dim}${t('memory.statusHint')}${ui.reset}\n`);
+                return next();
+            }
+            let nextEnabled;
+            if (switchArg === '') {
+                nextEnabled = !isMemoryEnabled();
+            }
+            else if (['on', 'true', '1', 'yes', 'y', 'enable', 'enabled'].includes(switchArg)) {
+                nextEnabled = true;
+            }
+            else if (['off', 'false', '0', 'no', 'n', 'disable', 'disabled'].includes(switchArg)) {
+                nextEnabled = false;
+            }
+            else {
+                layout.contentWrite(`${ui.yellow}${t('memory.usage')}${ui.reset}\n`);
+                return next();
+            }
+            const indexEnabled = isMemoryEnabled();
+            const routeAllowed = isMemoryRouteAllowed();
+            const alreadyAligned = nextEnabled ? indexEnabled && routeAllowed : !indexEnabled && !routeAllowed;
+            if (alreadyAligned) {
+                layout.contentWrite(`${ui.dim}${t('memory.unchanged', {
+                    state: t(nextEnabled ? 'memory.stateEnabled' : 'memory.stateDisabled'),
+                })}${ui.reset}\n`);
+                return next();
+            }
+            updateMemoryConfig(nextEnabled);
+            updateConfigKey('MEMORY_ENABLED', nextEnabled ? 'true' : 'false');
+            // 自动路由读取 env gate；legacy chatTools 同步刷新。
+            refreshChatTools();
+            ctx.history[0] = { role: 'system', content: ctx.buildSystemMessage(getAgentMode() === 'plan') };
+            layout.contentWrite(`${nextEnabled ? ui.green : ui.yellow}${t(nextEnabled ? 'memory.changedOn' : 'memory.changedOff')}${ui.reset}\n`);
+            layout.contentWrite(`${ui.dim}${t('memory.saved', {
+                path: CONFIG_PATH,
+                value: nextEnabled ? 'true' : 'false',
+            })}${ui.reset}\n`);
+            // 即时刷新 banner；当前已发出的 immutable policy snapshot 不受影响。
+            layout.rewriteBanner(bannerLines(ctx.banner()));
+        }
+        catch (error) {
+            layout.contentWrite(`${ui.red}${t('memory.failed', { error: error instanceof Error ? error.message : String(error) })}${ui.reset}\n`);
+        }
+        return next();
+    },
+];

package/dist/repl/commands/types.js

@@ -0,0 +1,4 @@
+export const unhandled = () => ({ kind: 'unhandled' });
+export const next = () => ({ kind: 'next' });
+export const exit = () => ({ kind: 'exit' });
+export const forward = (input) => ({ kind: 'forward', input });

package/dist/repl/commands.js

@@ -0,0 +1,324 @@
+import { ui } from '../ui/theme.js';
+import { t } from '../i18n/index.js';
+import { DEFAULT_CONTEXT_WINDOW_TOKENS } from '../config/index.js';
+export const PROMPT = '❯ ';
+/**
+ * 斜杠命令树(仅用于输入菜单；分发仍走下方 if 链)。
+ * 分支节点只负责导航，叶子的 value 保持现有命令文本，因此不破坏命令兼容性。
+ */
+export function buildSlashCommands() {
+    const d = (key) => t(key);
+    return [
+        { name: '/help', desc: d('commands.help') },
+        { name: '/exit', desc: d('commands.exit') },
+        { name: '/clear', desc: d('commands.clear') },
+        { name: '/context', desc: d('commands.context') },
+        { name: '/skills', desc: d('commands.skills') },
+        { name: '/skill', desc: '执行某个 skill(/skill <name> [args-json])' },
+        { name: '/compact', desc: d('commands.compact') },
+        { name: '/resume', desc: d('commands.sessionResume') },
+        { name: '/sessions', desc: d('commands.sessionBrowse') },
+        { name: '/rollback', desc: d('commands.sessionRollback') },
+        {
+            name: '/memory',
+            desc: d('commands.memory'),
+            children: [
+                { name: 'overview', value: '/memory', desc: d('commands.memoryOverview') },
+                { name: 'toggle', value: '/memory_switch', desc: d('commands.memoryToggle') },
+                { name: 'on', value: '/memory_switch on', desc: d('commands.memoryOn') },
+                { name: 'off', value: '/memory_switch off', desc: d('commands.memoryOff') },
+                { name: 'status', value: '/memory_status', desc: d('commands.memoryStatus') },
+                { name: 'reflect', value: '/reflect', desc: d('commands.memoryReflect') },
+            ],
+        },
+        { name: '/init', desc: d('commands.memoryInit') },
+        {
+            name: '/subagent',
+            desc: d('commands.subagent'),
+            children: [
+                { name: 'on', value: '/subagent on', desc: d('commands.subagentOn') },
+                { name: 'off', value: '/subagent off', desc: d('commands.subagentOff') },
+                { name: 'status', value: '/subagent status', desc: d('commands.subagentStatus') },
+            ],
+        },
+        {
+            name: '/fe',
+            desc: d('commands.fe'),
+            children: [
+                { name: 'on', value: '/fe on', desc: d('commands.feOn') },
+                { name: 'off', value: '/fe off', desc: d('commands.feOff') },
+                { name: 'status', value: '/fe status', desc: d('commands.feStatus') },
+            ],
+        },
+        {
+            name: '/cu',
+            desc: d('commands.cu'),
+            children: [
+                { name: 'on', value: '/cu on', desc: d('commands.cuOn') },
+                { name: 'off', value: '/cu off', desc: d('commands.cuOff') },
+                { name: 'status', value: '/cu status', desc: d('commands.cuStatus') },
+            ],
+        },
+        {
+            name: '/mcp',
+            desc: d('commands.mcp'),
+            children: [
+                { name: 'on', value: '/mcp on', desc: d('commands.mcpOn') },
+                { name: 'off', value: '/mcp off', desc: d('commands.mcpOff') },
+                { name: 'status', value: '/mcp status', desc: d('commands.mcpStatus') },
+            ],
+        },
+        { name: '/theme', desc: d('commands.theme') },
+        {
+            name: '/model',
+            desc: d('commands.model'),
+            children: [
+                { name: 'configure', value: '/model', desc: d('commands.modelConfigure') },
+                { name: 'switch', value: '/model switch', desc: d('commands.modelSwitch') },
+                { name: 'list', value: '/model list', desc: d('commands.modelList') },
+                { name: 'show', value: '/model show', desc: d('commands.modelShow') },
+                { name: 'use <name>', value: '/model use ', submit: false, desc: d('commands.modelUse') },
+                { name: 'delete <name>', value: '/model delete ', submit: false, desc: d('commands.modelDelete') },
+            ],
+        },
+        {
+            name: '/mode',
+            desc: d('commands.mode'),
+            children: [
+                { name: 'plan', value: '/plan', desc: d('commands.modePlan') },
+                { name: 'auto', value: '/auto', desc: d('commands.modeAuto') },
+            ],
+        },
+        {
+            name: '/pet',
+            desc: d('commands.pet'),
+            children: [
+                { name: 'toggle', value: '/pet', desc: d('commands.petToggle') },
+                { name: 'skin', value: '/pet skin', desc: d('commands.petSkin') },
+                { name: 'quit', value: '/pet quit', desc: d('commands.petQuit') },
+            ],
+        },
+        {
+            name: '/image',
+            desc: d('commands.image'),
+            children: [
+                { name: 'attach <path>', value: '/image ', submit: false, desc: d('commands.imageAttach') },
+                { name: 'list', value: '/image list', desc: d('commands.imageList') },
+                { name: 'clear', value: '/image clear', desc: d('commands.imageClear') },
+            ],
+        },
+        {
+            name: '/language',
+            desc: d('commands.language'),
+            children: [
+                { name: 'zh-CN', value: '/language zh-CN', desc: d('commands.languageZh') },
+                { name: 'en', value: '/language en', desc: d('commands.languageEn') },
+            ],
+        },
+        {
+            name: '/upgrade',
+            desc: d('commands.upgrade'),
+            children: [
+                { name: 'now', value: '/upgrade', desc: d('commands.upgradeNow') },
+                { name: 'check', value: '/upgrade check', desc: d('commands.upgradeCheck') },
+                { name: 'status', value: '/upgrade status', desc: d('commands.upgradeStatus') },
+            ],
+        },
+    ];
+}
+/** 从菜单树递归生成 /help 内容；叶子 value 与菜单路径不同则同时展示真实命令。 */
+export function slashHelpLines(nodes = buildSlashCommands(), parentPath = '', depth = 0) {
+    const lines = [];
+    for (const node of nodes) {
+        const menuPath = parentPath ? `${parentPath} ${node.name}` : node.name;
+        const isBranch = Boolean(node.children?.length);
+        const actual = node.value?.trimEnd();
+        const mapping = actual && actual !== menuPath ? ` ${ui.dim}→ ${actual}${ui.reset}` : '';
+        const marker = isBranch ? ` ${ui.dim}›${ui.reset}` : '';
+        lines.push(`${'  '.repeat(depth)}${ui.accent}${menuPath}${ui.reset}${marker}${mapping}  ${ui.dim}${node.desc}${ui.reset}`);
+        if (node.children?.length)
+            lines.push(...slashHelpLines(node.children, menuPath, depth + 1));
+    }
+    return lines;
+}
+/** chat 常见错误类别 → 中文引导文案的 i18n 键(识别不出的错误不走这张表,保留原始诊断)。 */
+export const LLM_ERROR_HINT_KEYS = {
+    auth: 'repl.llmAuthError',
+    quota: 'repl.llmQuotaError',
+    timeout: 'repl.llmTimeoutError',
+    network: 'repl.llmNetworkError',
+    context: 'repl.llmContextError',
+};
+/** /help 的分组:按使用场景归组,组内保持菜单树顺序。未列入的顶层命令兜底进「其他」。 */
+export const HELP_GROUPS = [
+    { key: 'help.groupFrequent', names: ['/help', '/clear', '/context', '/compact', '/resume', '/model'] },
+    { key: 'help.groupSession', names: ['/sessions', '/rollback', '/memory', '/skills', '/skill', '/init'] },
+    {
+        key: 'help.groupConfig',
+        names: ['/mode', '/subagent', '/fe', '/mcp', '/theme', '/pet', '/image', '/language', '/upgrade'],
+    },
+];
+/**
+ * 菜单树里全部可用命令名(含分支路径与叶子的真实命令),供未知命令纠错建议用。
+ * /quit、/frontend 确实可用但没登记进菜单树,单独补上——否则用户照提示打了却仍被判未知。
+ */
+export function knownCommandNames() {
+    const out = [];
+    const walk = (nodes, parent) => {
+        for (const node of nodes) {
+            const path = parent ? `${parent} ${node.name}` : node.name;
+            out.push(path);
+            const actual = node.value?.trim();
+            if (actual)
+                out.push(actual.split(/\s+/)[0]);
+            if (node.children?.length)
+                walk(node.children, path);
+        }
+    };
+    walk(buildSlashCommands(), '');
+    out.push('/quit', '/frontend');
+    return [...new Set(out)];
+}
+/**
+ * 是否"长得像一条斜杠命令":单个前导 / + 词字符(字母开头,可含数字/下划线/连字符)。
+ * 用来把 /hepl 这类拼写错误与 /tmp/foo、/src/index.ts:12:5 这类路径区分开——
+ * 后者在编码 agent 里很常见,同样以 / 开头,绝不能被当成命令拦下。
+ */
+export function isCommandShape(cmd) {
+    return /^\/[A-Za-z][\w-]*$/.test(cmd);
+}
+/** Levenshtein 距离(标准 DP)。短命令字符串,直接两行数组滚动即可。 */
+export function editDistance(a, b) {
+    if (a === b)
+        return 0;
+    if (!a.length)
+        return b.length;
+    if (!b.length)
+        return a.length;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const cur = [i];
+        for (let j = 1; j <= b.length; j++) {
+            cur[j] = Math.min(prev[j] + 1, // 删
+            cur[j - 1] + 1, // 插
+            prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        prev = cur;
+    }
+    return prev[b.length];
+}
+/** 未知命令的纠错建议:返回编辑距离最近且在阈值内的命令名,没有则 null(不要瞎猜)。 */
+export function suggestCommand(input) {
+    // 阈值随长度放宽,但对短命令保持严格:/hepl(5) vs /help 距离 2 → 命中;
+    // /x(2) 不该被建议成任何东西。
+    const threshold = Math.max(1, Math.ceil(input.length / 3));
+    let best = null;
+    let bestDist = Infinity;
+    for (const name of knownCommandNames()) {
+        if (name === input)
+            continue; // 别建议"你自己"(分支节点如 /mode 也在候选里)
+        const d = editDistance(input, name);
+        if (d < bestDist) {
+            bestDist = d;
+            best = name;
+        }
+    }
+    return bestDist <= threshold ? best : null;
+}
+/** 主题名 → 本地化描述。 */
+export function themeDescription(name) {
+    const key = `theme.${name}`;
+    return name in
+        {
+            default: 1,
+            light: 1,
+            solarized: 1,
+            gruvbox: 1,
+            nord: 1,
+            orange: 1,
+            rose: 1,
+            emerald: 1,
+            amber: 1,
+            lavender: 1,
+            sunset: 1,
+        }
+        ? t(key)
+        : '';
+}
+/** /model 预设后端：同时声明原生协议；旧服务继续走 OpenAI-compatible。 */
+export const MODEL_PRESETS = [
+    {
+        label: 'Anthropic Claude',
+        provider: 'anthropic',
+        baseURL: 'https://api.anthropic.com',
+        model: 'claude-sonnet-4-5',
+        window: 200000,
+        anthropicPromptCache: true,
+    },
+    {
+        label: 'GLM(智谱)',
+        provider: 'openai',
+        baseURL: 'https://open.bigmodel.cn/api/v3',
+        model: 'glm-4.6',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+    {
+        label: 'DeepSeek',
+        provider: 'openai',
+        baseURL: 'https://api.deepseek.com',
+        model: 'deepseek-chat',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+    {
+        label: 'Qwen(阿里)',
+        provider: 'openai',
+        baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+        model: 'qwen-plus',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+    // MiniMax OpenAI 兼容端点(https://platform.minimax.io/docs/api-reference/text-openai-api)。
+    // MiniMax-M3 为唯一支持图片/视频输入的模型;M2 系列纯文本(见 llm/capabilities.ts KNOWN_TEXT_ONLY_PREFIXES)。
+    {
+        label: 'MiniMax',
+        provider: 'openai',
+        baseURL: 'https://api.minimax.io/v1',
+        model: 'MiniMax-M3',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+    {
+        label: '本地 Ollama',
+        provider: 'openai',
+        baseURL: 'http://localhost:11434/v1',
+        model: 'qwen2.5:7b',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+    {
+        label: '本地 vLLM',
+        provider: 'openai',
+        baseURL: 'http://localhost:8000/v1',
+        model: 'default',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+    {
+        label: '自定义 base_url',
+        provider: 'openai',
+        baseURL: '',
+        model: '',
+        window: DEFAULT_CONTEXT_WINDOW_TOKENS,
+        anthropicPromptCache: false,
+    },
+];
+/** apiKey 脱敏:只露末 4 位,前面打星号(显示用,绝不把明文 key 写进内容区)。 */
+export function maskKey(k) {
+    if (!k)
+        return '(未设置)';
+    if (k.length <= 8)
+        return '****';
+    return `${'='.repeat(Math.min(k.length - 4, 20))}${k.slice(-4)}`;
+}