@nvae/llmswitch 0.2.0 → 0.5.0

package/dist/commands/prompts.js

@@ -1,8 +1,10 @@
 import * as p from "@clack/prompts";
+import { normalizeProxyValue } from "../types.js";
 import { isApiFormat } from "../types.js";
 import { formatLabel, supportedFormats } from "../formats/compatibility.js";
 import { getPreset, presetsForTool } from "../presets/index.js";
-import { assertValidProfileName, profileExists, saveProfile, } from "../store/profiles.js";
+import { detectApiFormat } from "../utils/detect-format.js";
+import { assertValidProfileName, listProfiles, profileExists, saveProfile, } from "../store/profiles.js";
 import { fetchModelList, preferResolvedBaseUrl, } from "../utils/fetch-models.js";
 import { normalizeBaseUrlForFormat } from "../utils/base-url.js";
 import { maskSecret } from "../utils/fs.js";
@@ -167,6 +169,48 @@ async function promptEditUpstream(tool, current) {
     }
     return { apiFormat: picked };
 }
+const NAME_GEN_CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+/**
+ * 生成 5 位小写字母与数字的随机 profile 名称，并确保不与现有名称冲突。
+ */
+export function generateProfileName(tool) {
+    for (let attempt = 0; attempt < 32; attempt++) {
+        let name = "";
+        for (let i = 0; i < 5; i++) {
+            name += NAME_GEN_CHARS[Math.floor(Math.random() * NAME_GEN_CHARS.length)];
+        }
+        if (!profileExists(tool, name))
+            return name;
+    }
+    return `p${Date.now().toString(36).slice(-4)}`;
+}
+/**
+ * 显示名称默认值：基于现有 provider-N 递增（provider-1、provider-2 …）。
+ */
+export function suggestDisplayName(tool) {
+    let max = 0;
+    for (const profile of listProfiles(tool)) {
+        const match = /^provider-(\d+)$/i.exec(profile.displayName);
+        if (match)
+            max = Math.max(max, Number(match[1]));
+    }
+    return `provider-${max + 1}`;
+}
+/**
+ * 供应商列表 label：显示名称 +（profile 名称 · 状态标记）。
+ * 例：DeepSeek（6ham6 · 已启用）；显示名与名称相同时省略名称。
+ */
+export function formatProfileListLabel(profile, opts) {
+    const display = profile.displayName || profile.name;
+    const parts = [];
+    if (profile.displayName !== profile.name)
+        parts.push(profile.name);
+    if (profile.name === opts.defaultName)
+        parts.push("默认");
+    if (profile.name === opts.activeName)
+        parts.push("已启用");
+    return parts.length ? `${display}（${parts.join(" · ")}）` : display;
+}
 export async function promptProfileDraft(tool, partial = {}) {
     p.intro(`为 ${tool} 添加供应商配置`);
     const presets = presetsForTool(tool);
@@ -198,25 +242,7 @@ export async function promptProfileDraft(tool, partial = {}) {
     }
     let name = partial.name;
     if (!name) {
-        const v = await p.text({
-            message: "Profile 名称（用于命令行引用）",
-            placeholder: preset.id === "custom" ? "my-provider" : preset.id,
-            validate: (val) => {
-                if (!val?.trim())
-                    return "名称不能为空";
-                try {
-                    assertValidProfileName(val.trim());
-                }
-                catch (e) {
-                    return e instanceof Error ? e.message : "名称无效";
-                }
-                if (profileExists(tool, val.trim())) {
-                    return `「${val.trim()}」已存在`;
-                }
-            },
-        });
-        exitOnCancel(v);
-        name = v.trim();
+        name = generateProfileName(tool);
     }
     else {
         assertValidProfileName(name);
@@ -227,40 +253,12 @@ export async function promptProfileDraft(tool, partial = {}) {
     let displayName = partial.displayName;
     if (!displayName) {
         const v = await p.text({
-            message: "显示名称",
-            initialValue: preset.id === "custom" ? name : preset.displayName,
+            message: "显示名称（回车使用默认值，也可修改）",
+            initialValue: preset.id === "custom" ? suggestDisplayName(tool) : preset.displayName,
         });
         exitOnCancel(v);
         displayName = v.trim() || name;
     }
-    let apiFormat;
-    let bridgeMode;
-    if (partial.apiFormat) {
-        apiFormat = partial.apiFormat;
-        bridgeMode = partial.bridgeMode;
-    }
-    else if (preset.id === "custom") {
-        if (tool === "claude") {
-            // Claude custom: Chat Completions only, translated via local bridge.
-            apiFormat = "openai-chat";
-            bridgeMode = undefined;
-        }
-        else {
-            const upstream = await promptOpenAiCompatibleUpstream(tool, {
-                apiFormat: "openai-chat",
-                bridgeMode: "chat",
-            });
-            apiFormat = upstream.apiFormat;
-            bridgeMode = upstream.bridgeMode;
-        }
-    }
-    else {
-        apiFormat = preset.apiFormat;
-        bridgeMode = undefined;
-    }
-    if (!isApiFormat(apiFormat) || !supportedFormats(tool).includes(apiFormat)) {
-        throw new Error(`${tool} 不支持格式 ${apiFormat}。可用：${supportedFormats(tool).join(", ")}`);
-    }
     let baseUrl = partial.baseUrl;
     if (!baseUrl) {
         const v = await p.text({
@@ -274,14 +272,6 @@ export async function promptProfileDraft(tool, partial = {}) {
         exitOnCancel(v);
         baseUrl = v.trim();
     }
-    {
-        const before = baseUrl.trim().replace(/\/+$/, "");
-        const normalized = normalizeBaseUrlForFormat(apiFormat, baseUrl);
-        if (normalized !== before) {
-            p.log.info(`已自动将 Base URL 规范为 ${normalized}`);
-        }
-        baseUrl = normalized;
-    }
     let apiKey = partial.apiKey;
     if (apiKey === undefined) {
         const v = await p.password({
@@ -293,15 +283,11 @@ export async function promptProfileDraft(tool, partial = {}) {
         }
         apiKey = v || "";
     }
-    // Proxy before model fetch so listing can go through the same upstream proxy.
-    let proxyHttp = partial.proxyHttp;
-    let proxyHttps = partial.proxyHttps;
-    let proxyAll = partial.proxyAll;
-    if (proxyHttp === undefined &&
-        proxyHttps === undefined &&
-        proxyAll === undefined) {
+    // Proxy before probing / model fetch so requests go through the same upstream.
+    let proxyUrl = partial.proxy;
+    if (proxyUrl === undefined) {
         const wantProxy = await p.confirm({
-            message: "是否配置上游代理？（拉取模型与后续工具请求均可走 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY）",
+            message: "是否配置上游代理？（拉取模型与后续该 provider 的请求都会走此代理）",
             initialValue: false,
         });
         if (p.isCancel(wantProxy)) {
@@ -309,28 +295,75 @@ export async function promptProfileDraft(tool, partial = {}) {
             process.exit(0);
         }
         if (wantProxy) {
-            proxyAll =
+            proxyUrl =
                 (await promptText({
-                    message: "ALL_PROXY（如 socks5h://127.0.0.1:1080，可留空）",
-                    placeholder: "socks5h://127.0.0.1:1080",
-                })) || undefined;
-            proxyHttp =
-                (await promptText({
-                    message: "HTTP_PROXY（可留空）",
-                    placeholder: "http://127.0.0.1:5112",
-                })) || undefined;
-            proxyHttps =
-                (await promptText({
-                    message: "HTTPS_PROXY（可留空）",
-                    placeholder: "http://127.0.0.1:5112",
+                    message: "代理地址（支持 http/https/socks5，可留空）",
+                    placeholder: "socks5://127.0.0.1:1080",
+                    validate: validateProxyUrl,
                 })) || undefined;
         }
     }
-    const proxy = buildProxyConfig({
-        http: proxyHttp,
-        https: proxyHttps,
-        all: proxyAll,
-    });
+    const proxy = buildProxyConfig({ url: proxyUrl });
+    let apiFormat;
+    let bridgeMode;
+    if (partial.apiFormat) {
+        apiFormat = partial.apiFormat;
+        bridgeMode = partial.bridgeMode;
+    }
+    else if (preset.id !== "custom") {
+        apiFormat = preset.apiFormat;
+        bridgeMode = undefined;
+    }
+    else {
+        // 自定义上游：自动识别接口类型，识别失败才让用户手动选择
+        const spin = p.spinner();
+        spin.start("正在识别接口类型…");
+        const detected = await detectApiFormat(tool, {
+            baseUrl,
+            apiKey: apiKey || "",
+            proxy,
+        });
+        if (detected.detected) {
+            apiFormat = detected.apiFormat;
+            bridgeMode = detected.bridgeMode;
+            spin.stop(detected.source === "ollama-tags"
+                ? "已识别接口：Ollama 本地（OpenAI Chat Completions）"
+                : `已识别接口：${formatLabel(apiFormat)}`);
+            if (detected.resolvedBaseUrl &&
+                detected.resolvedBaseUrl !== baseUrl.trim().replace(/\/+$/, "")) {
+                p.log.info(`已根据可用接口将 Base URL 规范为 ${detected.resolvedBaseUrl}（原输入：${baseUrl}）`);
+                baseUrl = detected.resolvedBaseUrl;
+            }
+        }
+        else {
+            spin.stop("未能自动识别接口类型");
+            p.log.warn("未能自动识别接口类型，请手动选择。");
+            if (tool === "claude") {
+                // Claude 自定义上游历史默认：Chat Completions，经本地桥转换
+                apiFormat = "openai-chat";
+                bridgeMode = undefined;
+            }
+            else {
+                const upstream = await promptOpenAiCompatibleUpstream(tool, {
+                    apiFormat: "openai-chat",
+                    bridgeMode: "chat",
+                });
+                apiFormat = upstream.apiFormat;
+                bridgeMode = upstream.bridgeMode;
+            }
+        }
+    }
+    if (!isApiFormat(apiFormat) || !supportedFormats(tool).includes(apiFormat)) {
+        throw new Error(`${tool} 不支持格式 ${apiFormat}。可用：${supportedFormats(tool).join(", ")}`);
+    }
+    {
+        const before = baseUrl.trim().replace(/\/+$/, "");
+        const normalized = normalizeBaseUrlForFormat(apiFormat, baseUrl);
+        if (normalized !== before) {
+            p.log.info(`已自动将 Base URL 规范为 ${normalized}`);
+        }
+        baseUrl = normalized;
+    }
     if (tool === "codex" && apiFormat === "openai-chat" && !bridgeMode) {
         bridgeMode = "chat";
     }
@@ -367,7 +400,7 @@ export async function promptProfileDraft(tool, partial = {}) {
         updatedAt: new Date().toISOString(),
     };
     saveProfile(tool, profile);
-    p.log.success(`已保存供应商「${name}」`);
+    p.log.success(`已保存供应商「${profile.displayName}」（${profile.name}，名称与显示名称均可引用）`);
     return profile;
 }
 /**
@@ -417,23 +450,13 @@ export async function promptEditProfile(tool, current) {
         }
         apiKey = v || "";
     }
-    const http = await promptText({
-        message: "HTTP_PROXY（留空清除）",
-        initialValue: current.proxy?.http || "",
-    });
-    const https = await promptText({
-        message: "HTTPS_PROXY（留空清除）",
-        initialValue: current.proxy?.https || "",
-    });
-    const all = await promptText({
-        message: "ALL_PROXY（留空清除）",
-        initialValue: current.proxy?.all || "",
-    });
-    const proxy = buildProxyConfig({
-        http: http || undefined,
-        https: https || undefined,
-        all: all || undefined,
+    const proxyInput = await promptText({
+        message: "代理地址（支持 http/https/socks5，留空清除）",
+        placeholder: "socks5://127.0.0.1:1080",
+        initialValue: current.proxy || "",
+        validate: validateProxyUrl,
     });
+    const proxy = buildProxyConfig({ url: proxyInput || undefined });
     const next = {
         ...current,
         displayName,
@@ -503,7 +526,7 @@ async function selectModelsFromFetched(fetched, input) {
     const preferredList = (input.preferredList || []).filter((m) => fetched.includes(m));
     const presetList = (input.presetModels || []).filter((m) => fetched.includes(m));
     const picked = await p.multiselect({
-        message: "选择要保存到 profile 的模型（空格选择，回车确认）",
+        message: "选择启用模型（多选，空格选择，回车确认）",
         options: fetched.map((id) => ({
             value: id,
             label: id,
@@ -551,10 +574,6 @@ async function manualModelsEntry(input) {
     return { defaultModel, modelList };
 }
 export async function tryFetchModels(input) {
-    if (!input.apiKey.trim()) {
-        p.log.info("未填写 API Key，跳过自动拉取模型列表。");
-        return null;
-    }
     const spin = p.spinner();
     spin.start("正在从接口拉取模型列表…");
     try {
@@ -581,15 +600,37 @@ export async function tryFetchModels(input) {
         return null;
     }
 }
-export function buildProxyConfig(input) {
-    const proxy = {};
-    if (input.http?.trim())
-        proxy.http = input.http.trim();
-    if (input.https?.trim())
-        proxy.https = input.https.trim();
-    if (input.all?.trim())
-        proxy.all = input.all.trim();
-    if (!proxy.http && !proxy.https && !proxy.all)
+const SUPPORTED_PROXY_SCHEMES = [
+    "http",
+    "https",
+    "socks",
+    "socks4",
+    "socks4a",
+    "socks5",
+    "socks5h",
+];
+/**
+ * Validate a single proxy URL for the interactive prompts. Empty is allowed
+ * (clears the proxy). Returns an error message string when invalid.
+ */
+export function validateProxyUrl(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
         return undefined;
-    return proxy;
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        return "代理地址格式无效，示例：http://127.0.0.1:7890 或 socks5://127.0.0.1:1080";
+    }
+    const scheme = url.protocol.replace(/:$/, "").toLowerCase();
+    if (!SUPPORTED_PROXY_SCHEMES.includes(scheme)) {
+        return `不支持的代理协议「${scheme}」。支持：http、https、socks5（含 socks/socks4/socks4a/socks5h）`;
+    }
+    return undefined;
+}
+/** Normalize a single proxy URL input into the stored value. */
+export function buildProxyConfig(input) {
+    return normalizeProxyValue(input.url);
 }

package/dist/commands/setup-cmd.js

@@ -0,0 +1,175 @@
+import * as p from "@clack/prompts";
+import { TOOLS, isTool } from "../types.js";
+import { applyProfile } from "../adapters/index.js";
+import { ensureDefaultProvider, getActiveProfile, listProfiles, requireProfile, } from "../store/profiles.js";
+import { exitOnCancel, formatProfileListLabel, promptProfileDraft } from "./prompts.js";
+import { launchTool, resolveBinary, which } from "./launch.js";
+const TOOL_LABEL = {
+    claude: "Claude Code",
+    codex: "Codex",
+    opencode: "OpenCode",
+};
+export function registerSetupCommand(program) {
+    program
+        .command("setup")
+        .alias("init")
+        .description("引导式初始化：选择工具 → 添加供应商 → 选择模型 → 启用 → 启动")
+        .option("-t, --tool <tool>", "跳过工具选择，直接为指定工具引导")
+        .option("--json", "以 JSON 输出引导结果")
+        .action(async (opts) => {
+        if (opts.tool && !isTool(opts.tool)) {
+            throw new Error(`未知工具「${opts.tool}」。可选：${TOOLS.join(", ")}`);
+        }
+        const tool = opts.tool !== undefined && isTool(opts.tool)
+            ? opts.tool
+            : await pickSetupTool();
+        const result = await runSetupWizard(tool);
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        p.outro(`${TOOL_LABEL[tool]} 配置完成。下次直接启动：llms launch ${tool}`);
+    });
+}
+/** 工具选择：只列出已安装的工具；仅装一个时自动选中。 */
+export async function pickSetupTool() {
+    const installed = TOOLS.filter((tool) => which(resolveBinary(tool)) !== null);
+    if (installed.length === 1) {
+        p.log.info(`检测到已安装 ${TOOL_LABEL[installed[0]]}，直接进入配置。`);
+        return installed[0];
+    }
+    const selected = await p.select({
+        message: "选择要配置的工具",
+        options: TOOLS.map((tool) => ({
+            value: tool,
+            label: TOOL_LABEL[tool],
+            hint: installed.includes(tool)
+                ? "已安装"
+                : "未检测到（启动前需安装或设置 *_BIN）",
+        })),
+        initialValue: installed[0] ?? TOOLS[0],
+    });
+    exitOnCancel(selected);
+    return selected;
+}
+/**
+ * 连贯启动流程：
+ * - 已有供应商 → 直接启动（当前启用 / 默认供应商）。
+ * - 无供应商 → 自动引导：添加供应商 → 选择模型 → 静默启用 → 自动启动。
+ */
+export async function runToolFlow(tool) {
+    const profiles = listProfiles(tool);
+    if (profiles.length === 0) {
+        if (!process.stdin.isTTY) {
+            throw new Error(`暂无 ${tool} 供应商，请先：llms ${tool} provider`);
+        }
+        p.log.step("尚未配置供应商，开始引导。");
+        const created = await promptProfileDraft(tool);
+        ensureDefaultProvider(tool);
+        try {
+            await launchTool({ tool, profile: created.name });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            p.log.error(msg);
+            p.log.warn(`供应商「${created.name}」已保存并启用。可用：llms launch ${tool}，或设置 ${tool.toUpperCase()}_BIN 指定可执行文件。`);
+        }
+        return;
+    }
+    try {
+        await launchTool({ tool });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        p.log.error(msg);
+        p.log.warn(`可用：llms launch ${tool} [模型]，或设置 ${tool.toUpperCase()}_BIN 指定可执行文件。`);
+    }
+}
+/**
+ * 引导式初始化：添加（或复用）供应商 → 启用 → 可选启动。
+ * 内部复用 provider / model / use / launch 的既有逻辑。
+ */
+export async function runSetupWizard(tool) {
+    p.intro(`初始化 ${TOOL_LABEL[tool]}`);
+    const existing = listProfiles(tool);
+    let profileName;
+    if (existing.length > 0) {
+        const choice = await p.select({
+            message: "检测到已有供应商配置，如何继续？",
+            options: [
+                {
+                    value: "add",
+                    label: "添加新供应商",
+                    hint: "重新走一遍引导",
+                },
+                {
+                    value: "use",
+                    label: "使用现有供应商",
+                    hint: "直接启用并启动",
+                },
+            ],
+            initialValue: "add",
+        });
+        exitOnCancel(choice);
+        if (choice === "use") {
+            const active = getActiveProfile(tool)?.name ?? null;
+            const defaultName = ensureDefaultProvider(tool);
+            const picked = await p.select({
+                message: "选择要启用的供应商",
+                options: existing.map((profile) => ({
+                    value: profile.name,
+                    label: formatProfileListLabel(profile, {
+                        defaultName,
+                        activeName: active,
+                    }),
+                })),
+                initialValue: active || defaultName || existing[0].name,
+            });
+            exitOnCancel(picked);
+            profileName = picked;
+        }
+        else {
+            profileName = (await promptProfileDraft(tool)).name;
+        }
+    }
+    else {
+        profileName = (await promptProfileDraft(tool)).name;
+    }
+    ensureDefaultProvider(tool);
+    const profile = requireProfile(tool, profileName);
+    // 静默启用：不再询问，用户可在 provider 菜单中关闭
+    const applied = await applyProfile(tool, profile);
+    p.log.success(`已启用 ${tool}/${profile.name}（${profile.displayName || profile.name}），默认模型 ${profile.models.default}`);
+    p.log.info(`配置文件：${applied.configPath}`);
+    p.log.info(applied.restartHint);
+    const result = {
+        tool,
+        profile: profile.name,
+        defaultModel: profile.models.default,
+        enabled: true,
+        launched: false,
+        configPath: applied.configPath,
+    };
+    const launch = await p.confirm({
+        message: `是否立即启动 ${TOOL_LABEL[tool]}？`,
+        initialValue: true,
+    });
+    if (p.isCancel(launch)) {
+        p.cancel("已取消");
+        process.exit(0);
+    }
+    if (launch) {
+        try {
+            const plan = await launchTool({ tool, profile: profile.name });
+            result.launched = true;
+            result.configPath = plan.configPath || result.configPath;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            p.log.error(msg);
+            p.log.warn(`未能启动。稍后可用：llms launch ${tool}，或设置 ${tool.toUpperCase()}_BIN 指定可执行文件。`);
+        }
+    }
+    p.outro(`已就绪：llms launch ${tool}`);
+    return result;
+}

package/dist/commands/tool.js

@@ -1,13 +1,16 @@
 import * as p from "@clack/prompts";
 import { applyProfile, deactivateProfile } from "../adapters/index.js";
 import { formatLabel } from "../formats/compatibility.js";
-import { deleteProfile, ensureDefaultProvider, getActiveProfile, getDefaultProfile, listProfiles, publicProfileView, requireProfile, saveProfile, setDefaultProfile, } from "../store/profiles.js";
+import { deleteProfile, ensureDefaultProvider, getActiveProfile, getDefaultProfile, listProfiles, publicProfileView, requireProfile, resolveProfileOrThrow, saveProfile, setDefaultProfile, } from "../store/profiles.js";
 import { formatProxySummary } from "../utils/proxy.js";
-import { exitOnCancel, promptEditProfile, promptProfileDraft, resolveModelsInteractive, } from "./prompts.js";
+import { runToolFlow } from "./setup-cmd.js";
+import { exitOnCancel, formatProfileListLabel, promptEditProfile, promptProfileDraft, resolveModelsInteractive, } from "./prompts.js";
 export function registerToolCommand(program, tool) {
     const cmd = program
         .command(tool)
         .description(`管理 ${tool} 的供应商与模型配置`);
+    // llms <tool>（无子命令）：连贯启动，未配置时自动引导
+    cmd.action(() => runToolFlow(tool));
     cmd
         .command("provider")
         .description("管理模型供应商：添加 / 默认 / 启用禁用 / 查看 / 编辑 / 删除")
@@ -34,7 +37,7 @@ export function registerToolCommand(program, tool) {
         .action(async (name, opts) => {
         ensureDefaultProvider(tool);
         const profileName = await resolveProfileName(tool, name);
-        const profile = requireProfile(tool, profileName);
+        const profile = resolveProfileOrThrow(tool, profileName);
         const result = await applyProfile(tool, profile);
         if (opts?.json) {
             console.log(JSON.stringify(result, null, 2));
@@ -104,7 +107,7 @@ async function runProviderManager(tool) {
                 ...profiles.map((profile) => ({
                     value: profile.name,
                     // hint 仅高亮时可见，状态标在 label 上便于扫一眼认出默认项
-                    label: formatProviderListLabel(profile, {
+                    label: formatProfileListLabel(profile, {
                         defaultName,
                         activeName: active,
                     }),
@@ -123,7 +126,9 @@ async function runProviderManager(tool) {
         }
         if (selected === "__new__") {
             await handleProviderAdd(tool);
-            continue;
+            // 添加完成后直接结束，不再返回供应商列表
+            p.outro("添加完成");
+            return;
         }
         await handleProviderActions(tool, selected);
     }
@@ -131,20 +136,11 @@ async function runProviderManager(tool) {
 async function handleProviderAdd(tool) {
     const created = await promptProfileDraft(tool);
     ensureDefaultProvider(tool);
-    const enable = await p.confirm({
-        message: `是否立即启用「${created.name}」？`,
-        initialValue: true,
-    });
-    if (p.isCancel(enable)) {
-        p.cancel("已取消");
-        process.exit(0);
-    }
-    if (enable) {
-        const result = await applyProfile(tool, created);
-        p.log.success(`已启用 ${tool}/${created.name}`);
-        p.log.info(`配置文件：${result.configPath}`);
-        p.log.info(result.restartHint);
-    }
+    // 静默启用：不再询问，用户可在 provider 菜单中关闭
+    const result = await applyProfile(tool, created);
+    p.log.success(`已启用 ${tool}/${created.name}（${created.displayName || created.name}）`);
+    p.log.info(`配置文件：${result.configPath}`);
+    p.log.info(result.restartHint);
 }
 async function handleProviderActions(tool, profileName) {
     while (true) {
@@ -318,8 +314,7 @@ async function configureProfileModels(tool, profile) {
 }
 async function resolveProfileName(tool, name) {
     if (name) {
-        requireProfile(tool, name);
-        return name;
+        return resolveProfileOrThrow(tool, name).name;
     }
     ensureDefaultProvider(tool);
     const profiles = listProfiles(tool);
@@ -332,7 +327,7 @@ async function resolveProfileName(tool, name) {
         message: `选择 ${tool} 供应商`,
         options: profiles.map((profile) => ({
             value: profile.name,
-            label: formatProviderListLabel(profile, {
+            label: formatProfileListLabel(profile, {
                 defaultName,
                 activeName: active,
             }),
@@ -343,16 +338,6 @@ async function resolveProfileName(tool, name) {
     exitOnCancel(selected);
     return selected;
 }
-/** 列表项 label 始终可见；hint 仅在高亮行显示。 */
-function formatProviderListLabel(profile, opts) {
-    const name = profile.displayName || profile.name;
-    const tags = [];
-    if (profile.name === opts.defaultName)
-        tags.push("默认");
-    if (profile.name === opts.activeName)
-        tags.push("已启用");
-    return tags.length ? `${name}（${tags.join(" · ")}）` : name;
-}
 function registerModelCommands(parent, tool) {
     parent
         .command("model")
@@ -362,7 +347,7 @@ function registerModelCommands(parent, tool) {
         .action(async (opts) => {
         p.intro(`配置 ${tool} 模型`);
         const profile = opts.profile
-            ? requireProfile(tool, opts.profile)
+            ? resolveProfileOrThrow(tool, opts.profile)
             : requireProfile(tool, await resolveProfileName(tool));
         await configureProfileModels(tool, profile);
         if (opts.json) {

package/dist/presets/index.js

@@ -1,5 +1,5 @@
 import { supportedFormats } from "../formats/compatibility.js";
-export const PRESET_IDS = ["custom", "openai", "anthropic"];
+export const PRESET_IDS = ["custom", "openai", "anthropic", "ollama"];
 export const PRESETS = [
     {
         id: "custom",
@@ -28,6 +28,15 @@ export const PRESETS = [
         models: [],
         tools: ["claude", "opencode"],
     },
+    {
+        id: "ollama",
+        displayName: "Ollama（本地）",
+        apiFormat: "openai-chat",
+        baseUrl: "http://localhost:11434",
+        defaultModel: "",
+        models: [],
+        tools: ["claude", "codex", "opencode"],
+    },
 ];
 export function isPresetId(value) {
     return PRESET_IDS.includes(value);