@next-open-ai/openbot 0.6.8 → 0.6.66

package/dist/core/config/desktop-config.js

@@ -3,7 +3,7 @@
  * 供 CLI、WebSocket Gateway 等读取与写入，与 Nest Desktop Backend 使用的 config.json / agents.json 一致。
  * provider-support.json 提供流行 provider 及模型目录，供配置时下拉备选；配置完成后可同步到 agent 目录 models.json 供 pi 使用。
  */
-import { readFile, writeFile } from "fs/promises";
+import { readFile, writeFile, cp, mkdir } from "fs/promises";
 import { readFileSync, existsSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -13,6 +13,10 @@ function getDesktopDir() {
     const home = process.env.HOME || process.env.USERPROFILE || homedir();
     return join(home, ".openbot", "desktop");
 }
+/** 获取预装资源目录（打包后在 Resources/presets，dev 时在仓库根 presets） */
+function getPresetsDir() {
+    return process.env.OPENBOT_PRESETS_DIR || join(process.cwd(), "presets");
+}
 const DEFAULT_AGENT_ID = "default";
 const DEFAULT_MAX_AGENT_SESSIONS = 5;
 /** 同步读取桌面全局配置（Gateway 等需要同步读的场景） */
@@ -57,7 +61,7 @@ export function getChannelsConfigSync() {
         return {};
     }
 }
-/** 同步读取 RAG embedding 配置；未配置或无效时返回 null，长记忆将空转 */
+/** 同步读取 RAG embedding 配置；embeddingSource 为 local 或未配置在线模型时返回 null，长记忆将空转 */
 export function getRagEmbeddingConfigSync() {
     try {
         const configPath = getConfigPath();
@@ -65,8 +69,27 @@ export function getRagEmbeddingConfigSync() {
             return null;
         const content = readFileSync(configPath, "utf-8");
         const data = JSON.parse(content);
-        const provider = data.rag?.embeddingProvider?.trim();
-        const modelId = data.rag?.embeddingModel?.trim();
+        const rag = data.rag;
+        if (rag?.embeddingSource === "local")
+            return null;
+        let provider;
+        let modelId;
+        if (rag?.embeddingModelItemCode && Array.isArray(data.configuredModels)) {
+            const code = rag.embeddingModelItemCode;
+            const item = data.configuredModels.find((m) => {
+                if (m.type !== "embedding")
+                    return false;
+                return m.modelItemCode === code || (m.provider && m.modelId && `${m.provider}:${m.modelId}` === code);
+            });
+            if (item && item.provider) {
+                provider = item.provider;
+                modelId = item.modelId;
+            }
+        }
+        if (!provider || !modelId) {
+            provider = rag?.embeddingProvider?.trim();
+            modelId = rag?.embeddingModel?.trim();
+        }
         if (!provider || !modelId)
             return null;
         const prov = data.providers?.[provider];
@@ -86,6 +109,43 @@ export function getRagEmbeddingConfigSync() {
         return null;
     }
 }
+/** 同步读取 RAG 本地 GGUF 模型路径；embeddingSource 非 local 或未填时返回 null，调用方使用默认模型（如 embeddinggemma）。 */
+export function getRagLocalModelPathSync() {
+    try {
+        const configPath = getConfigPath();
+        if (!existsSync(configPath))
+            return null;
+        const content = readFileSync(configPath, "utf-8");
+        const data = JSON.parse(content);
+        if (data.rag?.embeddingSource !== "local")
+            return null;
+        const modelPath = data.rag?.localModelPath?.trim();
+        return modelPath || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 同步读取 RAG 向量库配置；vectorStore 为 qdrant 且 url 有效时返回，否则为 null（使用本地向量库）。 */
+export function getRagQdrantConfigSync() {
+    try {
+        const configPath = getConfigPath();
+        if (!existsSync(configPath))
+            return null;
+        const content = readFileSync(configPath, "utf-8");
+        const data = JSON.parse(content);
+        if (data.rag?.vectorStore !== "qdrant" || !data.rag?.qdrant?.url?.trim())
+            return null;
+        return {
+            url: data.rag.qdrant.url.trim().replace(/\/$/, ""),
+            apiKey: data.rag.qdrant.apiKey?.trim(),
+            collection: data.rag.qdrant.collection?.trim(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
 const EMBEDDING_DEFAULT_BASE_URL = {
     openai: "https://api.openai.com/v1",
     "openai-custom": "",
@@ -149,8 +209,8 @@ export async function loadDesktopAgentConfig(agentId) {
         }
     }
     const resolvedAgentId = agentId === "default" ? "default" : agentId;
-    let provider = config.defaultProvider ?? "deepseek";
-    let model = config.defaultModel ?? "deepseek-chat";
+    let provider = config.defaultProvider ?? "ollama";
+    let model = config.defaultModel ?? "qwen3:4b";
     if (config.defaultModelItemCode && Array.isArray(config.configuredModels)) {
         const configured = config.configuredModels.find((m) => m.modelItemCode === config.defaultModelItemCode);
         if (configured) {
@@ -158,9 +218,14 @@ export async function loadDesktopAgentConfig(agentId) {
             model = configured.modelId;
         }
     }
+    /** 是否从当前智能体自己的配置得到了模型（有 modelItemCode 或 provider/model）；若否，则使用的是全局默认 */
+    let agentHadOwnModel = false;
     let workspaceName = resolvedAgentId;
     let mcpServers;
+    let mcpMaxResultTokens;
     let systemPrompt;
+    let useLongMemory = true;
+    let contextSize;
     if (existsSync(agentsPath)) {
         try {
             const raw = await readFile(agentsPath, "utf-8");
@@ -172,30 +237,49 @@ export async function loadDesktopAgentConfig(agentId) {
                     workspaceName = agent.workspace;
                 else if (agent.id)
                     workspaceName = agent.id;
-                if (agent.mcpServers && Array.isArray(agent.mcpServers)) {
-                    mcpServers = agent.mcpServers;
+                if (agent.mcpMaxResultTokens != null && typeof agent.mcpMaxResultTokens === "number" && agent.mcpMaxResultTokens > 0) {
+                    mcpMaxResultTokens = agent.mcpMaxResultTokens;
+                }
+                if (agent.contextSize != null && typeof agent.contextSize === "number" && agent.contextSize > 0) {
+                    contextSize = agent.contextSize;
+                }
+                if (agent.mcpServers != null) {
+                    if (Array.isArray(agent.mcpServers) || (typeof agent.mcpServers === "object" && !Array.isArray(agent.mcpServers))) {
+                        mcpServers = agent.mcpServers;
+                    }
                 }
                 if (agent.systemPrompt && typeof agent.systemPrompt === "string") {
                     systemPrompt = agent.systemPrompt.trim();
                 }
+                if (agent.useLongMemory !== undefined)
+                    useLongMemory = !!agent.useLongMemory;
                 if (agent.modelItemCode && Array.isArray(config.configuredModels)) {
                     const configured = config.configuredModels.find((m) => m.modelItemCode === agent.modelItemCode);
                     if (configured) {
                         provider = configured.provider;
                         model = configured.modelId;
+                        agentHadOwnModel = true;
                     }
                     else {
-                        if (agent.provider)
+                        if (agent.provider) {
                             provider = agent.provider;
-                        if (agent.model)
+                            agentHadOwnModel = true;
+                        }
+                        if (agent.model) {
                             model = agent.model;
+                            agentHadOwnModel = true;
+                        }
                     }
                 }
                 else {
-                    if (agent.provider)
+                    if (agent.provider) {
                         provider = agent.provider;
-                    if (agent.model)
+                        agentHadOwnModel = true;
+                    }
+                    if (agent.model) {
                         model = agent.model;
+                        agentHadOwnModel = true;
+                    }
                 }
             }
         }
@@ -203,11 +287,168 @@ export async function loadDesktopAgentConfig(agentId) {
             // ignore
         }
     }
+    // 本地 LLM 可用且当前智能体未配置自己的模型时，使用本地推理作为缺省，使所有智能体“拥有”该配置
+    if (!agentHadOwnModel && process.env.LOCAL_LLM_BASE_URL?.trim()) {
+        provider = "local";
+        model = "local-llm";
+    }
     const provConfig = config.providers?.[provider];
     const apiKey = provConfig?.apiKey && typeof provConfig.apiKey === "string" && provConfig.apiKey.trim()
         ? provConfig.apiKey.trim()
         : undefined;
-    return { provider, model, apiKey: apiKey ?? undefined, workspace: workspaceName, mcpServers, systemPrompt };
+    let runnerType = "local";
+    let coze;
+    let openclawx;
+    let opencode;
+    let claudeCode;
+    const tw = config.tools?.webSearch;
+    const timeoutSeconds = typeof tw?.timeoutSeconds === "number" && tw.timeoutSeconds > 0 ? tw.timeoutSeconds : 15;
+    const cacheTtlMinutes = typeof tw?.cacheTtlMinutes === "number" && tw.cacheTtlMinutes >= 0 ? tw.cacheTtlMinutes : 5;
+    const maxResultsRaw = typeof tw?.maxResults === "number" ? tw.maxResults : 5;
+    const maxResults = Math.min(10, Math.max(1, maxResultsRaw));
+    let webSearch = {
+        enabled: false,
+        provider: "duck-duck-scrape",
+        timeoutSeconds,
+        cacheTtlMinutes,
+        maxResults,
+    };
+    if (existsSync(agentsPath)) {
+        try {
+            const rawAgents = await readFile(agentsPath, "utf-8");
+            const dataAgents = JSON.parse(rawAgents);
+            const agentsList = Array.isArray(dataAgents.agents) ? dataAgents.agents : [];
+            const agentRow = agentsList.find((a) => a.id === resolvedAgentId);
+            if (agentRow) {
+                if (agentRow.runnerType === "coze" ||
+                    agentRow.runnerType === "openclawx" ||
+                    agentRow.runnerType === "opencode" ||
+                    agentRow.runnerType === "claude_code") {
+                    runnerType = agentRow.runnerType;
+                }
+                if (agentRow.runnerType === "claude_code") {
+                    const wd = agentRow.claudeCode?.workingDirectory;
+                    claudeCode = {
+                        workingDirectory: typeof wd === "string" && wd.trim() ? wd.trim() : undefined,
+                    };
+                }
+                if (agentRow.coze) {
+                    const row = agentRow.coze;
+                    const region = row.region === "cn" || row.region === "com" ? row.region : "com";
+                    const credsCn = row.cn;
+                    const credsCom = row.com;
+                    const legacyBotId = row.botId != null ? String(row.botId).trim() : "";
+                    const legacyKey = row.apiKey != null ? String(row.apiKey).trim() : "";
+                    const fromRegion = region === "cn"
+                        ? credsCn && String(credsCn.botId || "").trim() && String(credsCn.apiKey || "").trim()
+                            ? { botId: String(credsCn.botId).trim(), apiKey: String(credsCn.apiKey).trim() }
+                            : null
+                        : credsCom && String(credsCom.botId || "").trim() && String(credsCom.apiKey || "").trim()
+                            ? { botId: String(credsCom.botId).trim(), apiKey: String(credsCom.apiKey).trim() }
+                            : null;
+                    const fromLegacy = legacyBotId && legacyKey ? { botId: legacyBotId, apiKey: legacyKey } : null;
+                    const creds = fromRegion ?? fromLegacy;
+                    if (creds) {
+                        coze = {
+                            botId: creds.botId,
+                            apiKey: creds.apiKey,
+                            region,
+                            endpoint: row.endpoint?.trim(),
+                        };
+                    }
+                    else if (runnerType === "coze") {
+                        console.warn(`[loadDesktopAgentConfig] agentId=${resolvedAgentId} runnerType=coze but no credentials for region=${region} (configure 国内/国际 in proxy settings)`);
+                    }
+                }
+                if (agentRow.openclawx?.baseUrl) {
+                    openclawx = {
+                        baseUrl: String(agentRow.openclawx.baseUrl).replace(/\/$/, ""),
+                        apiKey: agentRow.openclawx.apiKey?.trim(),
+                    };
+                }
+                if (agentRow.opencode?.port != null) {
+                    const raw = agentRow.opencode;
+                    const port = Number(raw.port);
+                    if (!Number.isNaN(port) && port > 0) {
+                        const mode = raw.mode === "local" || raw.mode === "remote"
+                            ? raw.mode
+                            : raw.address != null && String(raw.address).trim()
+                                ? "remote"
+                                : "local";
+                        const address = mode === "remote" && raw.address != null
+                            ? String(raw.address).trim()
+                            : "127.0.0.1";
+                        if (mode === "local" || address) {
+                            const apiStyle = raw.apiStyle === "openai" ? "openai" : "server";
+                            opencode = {
+                                mode,
+                                address: mode === "remote" ? address : "127.0.0.1",
+                                port,
+                                password: raw.password != null ? String(raw.password).trim() : undefined,
+                                username: raw.username != null ? String(raw.username).trim() || undefined : undefined,
+                                apiStyle,
+                                path: raw.path != null ? String(raw.path).trim() || undefined : undefined,
+                                streamPath: raw.streamPath != null
+                                    ? String(raw.streamPath).trim() || undefined
+                                    : undefined,
+                                model: raw.model != null ? String(raw.model).trim() || undefined : undefined,
+                                workingDirectory: raw.workingDirectory != null ? String(raw.workingDirectory).trim() || undefined : undefined,
+                            };
+                        }
+                    }
+                }
+                if (agentRow.webSearch?.enabled === true) {
+                    let preferredProvider = agentRow.webSearch?.provider === "brave" || agentRow.webSearch?.provider === "duck-duck-scrape"
+                        ? agentRow.webSearch.provider
+                        : tw?.defaultProvider === "brave" || tw?.defaultProvider === "duck-duck-scrape"
+                            ? tw.defaultProvider
+                            : "duck-duck-scrape";
+                    let braveKey;
+                    if (preferredProvider === "brave") {
+                        braveKey =
+                            (typeof tw?.providers?.brave?.apiKey === "string" && tw.providers.brave.apiKey.trim()
+                                ? tw.providers.brave.apiKey.trim()
+                                : undefined) ??
+                                (process.env.BRAVE_API_KEY && process.env.BRAVE_API_KEY.trim() ? process.env.BRAVE_API_KEY.trim() : undefined);
+                        if (!braveKey)
+                            preferredProvider = "duck-duck-scrape";
+                    }
+                    const maxResultTokens = agentRow.webSearch?.maxResultTokens != null && typeof agentRow.webSearch?.maxResultTokens === "number" && agentRow.webSearch.maxResultTokens > 0
+                        ? agentRow.webSearch.maxResultTokens
+                        : undefined;
+                    webSearch = {
+                        enabled: true,
+                        provider: preferredProvider,
+                        apiKey: preferredProvider === "brave" ? braveKey : undefined,
+                        timeoutSeconds,
+                        cacheTtlMinutes,
+                        maxResults,
+                        maxResultTokens,
+                    };
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return {
+        provider,
+        model,
+        apiKey: apiKey ?? undefined,
+        workspace: workspaceName,
+        mcpServers,
+        mcpMaxResultTokens,
+        systemPrompt,
+        runnerType,
+        coze,
+        openclawx,
+        opencode,
+        claudeCode,
+        useLongMemory,
+        webSearch,
+        contextSize,
+    };
 }
 function ensureDesktopDir() {
     const desktopDir = getDesktopDir();
@@ -357,50 +598,209 @@ export async function getDesktopConfigList() {
  * 确保桌面目录下存在 provider-support.json（不存在则写入默认内容）。
  * 供配置供应商时作备选下拉列表项。
  */
+/**
+ * 确保桌面目录下存在 provider-support.json，并与预装的最新供应商列表合并。
+ */
 export async function ensureProviderSupportFile() {
+    const presetPath = join(getPresetsDir(), "preset-providers.json");
+    let presetData = { providers: DEFAULT_PROVIDER_SUPPORT };
+    if (existsSync(presetPath)) {
+        try {
+            presetData = JSON.parse(await readFile(presetPath, "utf-8"));
+        }
+        catch { }
+    }
+    const presetProviders = presetData.providers || DEFAULT_PROVIDER_SUPPORT;
     const path = getProviderSupportPath();
-    if (existsSync(path))
-        return;
     ensureDesktopDir();
-    await writeFile(path, JSON.stringify(DEFAULT_PROVIDER_SUPPORT, null, 2), "utf-8");
+    if (!existsSync(path)) {
+        await writeFile(path, JSON.stringify(presetProviders, null, 2), "utf-8");
+        return;
+    }
+    try {
+        const userContent = await readFile(path, "utf-8");
+        const userProviders = JSON.parse(userContent);
+        let changed = false;
+        for (const [providerId, presetEntry] of Object.entries(presetProviders)) {
+            if (!userProviders[providerId]) {
+                userProviders[providerId] = presetEntry;
+                changed = true;
+            }
+            else {
+                const userModels = userProviders[providerId].models || [];
+                for (const presetModel of presetEntry.models) {
+                    if (!userModels.some((m) => m.id === presetModel.id)) {
+                        userModels.push(presetModel);
+                        changed = true;
+                    }
+                }
+                userProviders[providerId].models = userModels;
+            }
+        }
+        if (changed) {
+            await writeFile(path, JSON.stringify(userProviders, null, 2), "utf-8");
+        }
+    }
+    catch {
+        await writeFile(path, JSON.stringify(presetProviders, null, 2), "utf-8");
+    }
 }
-/** 若 config.json 不存在则写入默认结构，供 CLI/Gateway 启动时初始化 */
+/** 预装本地推理缺省：推荐列表第一个 LLM（Qwen 3.5 4B）对应的本地文件名，与 modelUriToFilename 一致 */
+const DEFAULT_LOCAL_LLM_MODEL_ID = "hf_unsloth_Qwen3.5-4B-GGUF_Qwen3.5-4B-Q5_K_M.gguf";
+const DEFAULT_LOCAL_MODEL_ITEM_CODE = "local-qwen35-4b";
+/** 代码内建默认：local provider + 本地 Qwen 3.5 4B，首次与合并时优先保证存在 */
+const BUILTIN_DEFAULT_CONFIG = {
+    defaultProvider: "local",
+    defaultModel: DEFAULT_LOCAL_LLM_MODEL_ID,
+    defaultModelItemCode: DEFAULT_LOCAL_MODEL_ITEM_CODE,
+    defaultAgentId: DEFAULT_AGENT_ID,
+    maxAgentSessions: DEFAULT_MAX_AGENT_SESSIONS,
+    providers: {
+        local: { baseUrl: "http://127.0.0.1:11435/v1" },
+    },
+    configuredModels: [
+        {
+            provider: "local",
+            modelId: DEFAULT_LOCAL_LLM_MODEL_ID,
+            type: "llm",
+            alias: "Qwen 3.5 4B Q5_K_M",
+            modelItemCode: DEFAULT_LOCAL_MODEL_ITEM_CODE,
+        },
+        {
+            provider: "local",
+            modelId: "hf_ggml-org_embeddinggemma-300M-GGUF_embeddinggemma-300M-Q8_0.gguf",
+            type: "embedding",
+            alias: "EmbeddingGemma 300M Q8 (768维)",
+            modelItemCode: "local-embeddinggemma-300m",
+        },
+    ],
+};
+/** 若 config.json 不存在则用 preset-config.json 初始化，若存在则浅合并补充新基础键值。预装 local provider + 本地 Qwen 3.5 4B 模型并设为缺省；preset 与代码默认合并，保证 local 一定存在。 */
 async function ensureConfigJsonInitialized() {
+    const presetPath = join(getPresetsDir(), "preset-config.json");
+    let presetConfig = { ...BUILTIN_DEFAULT_CONFIG };
+    if (existsSync(presetPath)) {
+        try {
+            const data = JSON.parse(await readFile(presetPath, "utf-8"));
+            if (data.config && typeof data.config === "object") {
+                presetConfig = { ...BUILTIN_DEFAULT_CONFIG, ...data.config };
+                presetConfig.providers = { ...BUILTIN_DEFAULT_CONFIG.providers, ...(presetConfig.providers || {}) };
+                const hasLocalModel = (presetConfig.configuredModels || []).some((m) => m?.provider === "local" && (m?.modelId === DEFAULT_LOCAL_LLM_MODEL_ID || m?.modelItemCode === DEFAULT_LOCAL_MODEL_ITEM_CODE));
+                if (!hasLocalModel) {
+                    presetConfig.configuredModels = [
+                        ...(BUILTIN_DEFAULT_CONFIG.configuredModels || []),
+                        ...(presetConfig.configuredModels || []),
+                    ];
+                }
+            }
+        }
+        catch { }
+    }
     const configPath = getConfigPath();
-    if (existsSync(configPath))
-        return;
     ensureDesktopDir();
-    const defaultConfig = {
-        defaultProvider: "deepseek",
-        defaultModel: "deepseek-chat",
-        defaultAgentId: DEFAULT_AGENT_ID,
-        maxAgentSessions: DEFAULT_MAX_AGENT_SESSIONS,
-        providers: {},
-        configuredModels: [],
-    };
-    await writeFile(configPath, JSON.stringify(defaultConfig, null, 2), "utf-8");
+    if (!existsSync(configPath)) {
+        await writeFile(configPath, JSON.stringify(presetConfig, null, 2), "utf-8");
+        return;
+    }
+    try {
+        const userConfig = JSON.parse(await readFile(configPath, "utf-8"));
+        let changed = false;
+        for (const [key, value] of Object.entries(presetConfig)) {
+            if (userConfig[key] === undefined) {
+                userConfig[key] = value;
+                changed = true;
+            }
+        }
+        if (changed) {
+            await writeFile(configPath, JSON.stringify(userConfig, null, 2), "utf-8");
+        }
+    }
+    catch { }
 }
-/** 若 agents.json 不存在则写入默认智能体，供 CLI/Gateway 启动时初始化 */
+/** 合并 preset-agents.json 中的预置智能体，并随之释放对应的工作区技能 */
 async function ensureAgentsJsonInitialized() {
+    const presetPath = join(getPresetsDir(), "preset-agents.json");
+    let presetAgents = [];
+    if (existsSync(presetPath)) {
+        try {
+            const data = JSON.parse(await readFile(presetPath, "utf-8"));
+            if (Array.isArray(data.agents))
+                presetAgents = data.agents;
+        }
+        catch { }
+    }
     const agentsPath = join(getDesktopDir(), "agents.json");
-    if (existsSync(agentsPath))
-        return;
     ensureDesktopDir();
-    const defaultAgents = {
-        agents: [
-            { id: DEFAULT_AGENT_ID, name: "主智能体", workspace: DEFAULT_AGENT_ID },
-        ],
-    };
-    await writeFile(agentsPath, JSON.stringify(defaultAgents, null, 2), "utf-8");
+    let currentData = { agents: [] };
+    if (existsSync(agentsPath)) {
+        try {
+            currentData = JSON.parse(await readFile(agentsPath, "utf-8"));
+            if (!Array.isArray(currentData.agents))
+                currentData.agents = [];
+        }
+        catch { }
+    }
+    let changed = false;
+    for (const pa of presetAgents) {
+        if (!currentData.agents.some((a) => a.id === pa.id)) {
+            currentData.agents.push(pa);
+            changed = true;
+            try {
+                const srcSkillsDir = join(getPresetsDir(), "workspaces", pa.id, "skills");
+                const homeDir = process.env.HOME || process.env.USERPROFILE || homedir();
+                const destSkillsDir = join(homeDir, ".openbot", "workspace", pa.id, "skills");
+                if (existsSync(srcSkillsDir)) {
+                    if (!existsSync(destSkillsDir)) {
+                        await mkdir(destSkillsDir, { recursive: true });
+                    }
+                    await cp(srcSkillsDir, destSkillsDir, { recursive: true, force: false, errorOnExist: false });
+                }
+            }
+            catch (err) {
+                console.error(`Failed to copy preset skills for agent ${pa.id}:`, err);
+            }
+        }
+    }
+    // 所有未单独配置模型的智能体使用 config 的缺省模型（预装为 local + Qwen 3.5 4B）
+    const configPath = join(getDesktopDir(), "config.json");
+    if (existsSync(configPath)) {
+        try {
+            const configRaw = await readFile(configPath, "utf-8");
+            const configData = JSON.parse(configRaw);
+            const defProvider = configData.defaultProvider?.trim();
+            const defModel = configData.defaultModel?.trim();
+            const defCode = configData.defaultModelItemCode?.trim();
+            if (defProvider && defModel) {
+                for (const agent of currentData.agents) {
+                    const hasOwn = (agent.provider && String(agent.provider).trim()) || (agent.model && String(agent.model).trim()) || (agent.modelItemCode && String(agent.modelItemCode).trim());
+                    if (!hasOwn) {
+                        agent.provider = defProvider;
+                        agent.model = defModel;
+                        if (defCode)
+                            agent.modelItemCode = defCode;
+                        changed = true;
+                    }
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    if (changed || !existsSync(agentsPath)) {
+        await writeFile(agentsPath, JSON.stringify(currentData, null, 2), "utf-8");
+    }
 }
 /**
- * CLI / Gateway 运行时调用，确保 config.json、provider-support.json、agents.json 均完成初始化。
+ * CLI / Gateway 运行时调用，确保 config.json、provider-support.json、agents.json 均完成初始化，
+ * 并同步到 agent 目录 models.json，供 pi ModelRegistry 解析 local 等模型与凭证。
  */
 export async function ensureDesktopConfigInitialized() {
     ensureDesktopDir();
     await ensureProviderSupportFile();
     await ensureConfigJsonInitialized();
     await ensureAgentsJsonInitialized();
+    await syncDesktopConfigToModelsJson().catch((err) => {
+        console.warn("[ensureDesktopConfigInitialized] syncDesktopConfigToModelsJson failed:", err);
+    });
 }
 /**
  * 取某 provider 在 provider-support 中的第一个 llm 模型 id；若无则返回第一个模型 id。
@@ -451,6 +851,10 @@ const SYNC_DEFAULTS = {
     "openai-custom": { baseUrl: "", apiKey: "OPENAI_API_KEY", api: "openai-completions" },
     nvidia: { baseUrl: "https://integrate.api.nvidia.com/v1", apiKey: "NVIDIA_API_KEY", api: "openai-completions" },
     kimi: { baseUrl: "https://api.moonshot.cn/v1", apiKey: "MOONSHOT_API_KEY", api: "openai-completions" },
+    /** 本地 Ollama，无需真实 API Key */
+    ollama: { baseUrl: "http://localhost:11434/v1", apiKey: "OPENAI_API_KEY", api: "openai-completions" },
+    /** 内置本地推理（node-llama-cpp），无需 API Key，baseUrl 指向本地子进程服务 */
+    local: { baseUrl: "http://127.0.0.1:11435/v1", apiKey: "OPENAI_API_KEY", api: "openai-completions" },
 };
 const DEFAULT_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
 const DEFAULT_CONTEXT_WINDOW = 64000;
@@ -475,25 +879,41 @@ function configuredModelToPi(item, displayName) {
 }
 /**
  * 根据桌面 config（已配置的 providers + configuredModels）与 provider-support，生成并写入 agent 目录的 models.json。
- * 仅包含在 config 的 providers 中已配置的 provider；每个 provider 的 models 来自 configuredModels，结构含 reasoning、cost 等。
+ * 包含：config.providers 中已配置的 provider；以及 configuredModels / defaultProvider 中引用但未在 providers 中的 provider（用 support 默认 baseUrl 补全，避免 Ollama 等仅选模型未填 baseUrl 时连不上）。
  */
 export async function syncDesktopConfigToModelsJson() {
     const config = await readDesktopConfigJson();
     const configured = config.providers ?? {};
     const configuredModels = Array.isArray(config.configuredModels) ? config.configuredModels : [];
-    if (Object.keys(configured).length === 0) {
+    const support = await getProviderSupport();
+    const providerIdsFromModels = new Set();
+    for (const m of configuredModels)
+        if (m?.provider)
+            providerIdsFromModels.add(m.provider);
+    if (config.defaultProvider)
+        providerIdsFromModels.add(config.defaultProvider);
+    const allProviderIds = new Set([...Object.keys(configured), ...providerIdsFromModels]);
+    if (allProviderIds.size === 0) {
         return;
     }
-    const support = await getProviderSupport();
     const piProviders = {};
-    for (const [providerId, userConfig] of Object.entries(configured)) {
-        if (!userConfig?.apiKey?.trim())
+    for (const providerId of allProviderIds) {
+        const userConfig = configured[providerId];
+        // ollama / local 不需要 API Key，其他 provider 必须有 apiKey
+        const isNoKeyProvider = providerId === "ollama" || providerId === "local";
+        if (!isNoKeyProvider && !userConfig?.apiKey?.trim())
             continue;
         const defaults = SYNC_DEFAULTS[providerId] ?? { baseUrl: "", apiKey: "OPENAI_API_KEY", api: "openai-completions" };
-        const baseUrl = userConfig.baseUrl?.trim() || (support[providerId]?.baseUrl ?? "").trim() || defaults.baseUrl;
+        let baseUrl = userConfig?.baseUrl?.trim() || (support[providerId]?.baseUrl ?? "").trim() || defaults.baseUrl;
+        if (providerId === "ollama" && process.env.OLLAMA_BASE_URL?.trim()) {
+            const u = process.env.OLLAMA_BASE_URL.trim().replace(/\/$/, "");
+            baseUrl = u.endsWith("/v1") ? u : u + "/v1";
+        }
         if (!baseUrl)
             continue;
         const def = support[providerId];
+        if (!def)
+            continue;
         const items = configuredModels.filter((m) => m.provider === providerId);
         let models;
         if (items.length > 0) {
@@ -501,7 +921,11 @@ export async function syncDesktopConfigToModelsJson() {
                 const displayName = (item.alias && item.alias.trim()) ||
                     (def?.models?.find((m) => m.id === item.modelId)?.name) ||
                     item.modelId;
-                return configuredModelToPi(item, displayName);
+                const pi = configuredModelToPi(item, displayName);
+                // 本地 node-llama-cpp 关闭思考：不向 SDK 发送 reasoning，避免启用 thinking 相关参数
+                if (providerId === "local")
+                    return { ...pi, reasoning: false };
+                return pi;
             });
         }
         else if (def?.models?.length) {
@@ -520,7 +944,7 @@ export async function syncDesktopConfigToModelsJson() {
             continue;
         }
         piProviders[providerId] = {
-            name: (userConfig.alias?.trim() || def?.name) || providerId,
+            name: (userConfig?.alias?.trim() || def?.name) || providerId,
             apiKey: defaults.apiKey,
             api: defaults.api,
             baseUrl: baseUrl.replace(/\/$/, ""),