@next-open-ai/openbot 0.6.16 → 0.6.66

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

@@ -209,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) {
@@ -218,10 +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");
@@ -233,6 +237,12 @@ export async function loadDesktopAgentConfig(agentId) {
                     workspaceName = agent.workspace;
                 else if (agent.id)
                     workspaceName = agent.id;
+                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;
@@ -248,19 +258,28 @@ export async function loadDesktopAgentConfig(agentId) {
                     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;
+                    }
                 }
             }
         }
@@ -268,6 +287,11 @@ 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()
@@ -276,6 +300,19 @@ export async function loadDesktopAgentConfig(agentId) {
     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");
@@ -285,9 +322,16 @@ export async function loadDesktopAgentConfig(agentId) {
             if (agentRow) {
                 if (agentRow.runnerType === "coze" ||
                     agentRow.runnerType === "openclawx" ||
-                    agentRow.runnerType === "opencode") {
+                    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";
@@ -353,6 +397,35 @@ export async function loadDesktopAgentConfig(agentId) {
                         }
                     }
                 }
+                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 {
@@ -365,12 +438,16 @@ export async function loadDesktopAgentConfig(agentId) {
         apiKey: apiKey ?? undefined,
         workspace: workspaceName,
         mcpServers,
+        mcpMaxResultTokens,
         systemPrompt,
         runnerType,
         coze,
         openclawx,
         opencode,
+        claudeCode,
         useLongMemory,
+        webSearch,
+        contextSize,
     };
 }
 function ensureDesktopDir() {
@@ -568,22 +645,54 @@ export async function ensureProviderSupportFile() {
         await writeFile(path, JSON.stringify(presetProviders, null, 2), "utf-8");
     }
 }
-/** 若 config.json 不存在则用 preset-config.json 初始化，若存在则浅合并补充新基础键值 */
+/** 预装本地推理缺省：推荐列表第一个 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 = {
-        defaultProvider: "deepseek",
-        defaultModel: "deepseek-chat",
-        defaultAgentId: DEFAULT_AGENT_ID,
-        maxAgentSessions: DEFAULT_MAX_AGENT_SESSIONS,
-        providers: {},
-        configuredModels: [],
-    };
+    let presetConfig = { ...BUILTIN_DEFAULT_CONFIG };
     if (existsSync(presetPath)) {
         try {
             const data = JSON.parse(await readFile(presetPath, "utf-8"));
-            if (data.config)
-                presetConfig = data.config;
+            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 { }
     }
@@ -652,18 +761,46 @@ async function ensureAgentsJsonInitialized() {
             }
         }
     }
+    // 所有未单独配置模型的智能体使用 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。
@@ -714,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;
@@ -738,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) {
@@ -764,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) {
@@ -783,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(/\/$/, ""),

package/dist/core/config/provider-support-default.js

@@ -28,6 +28,7 @@ export const DEFAULT_PROVIDER_SUPPORT = {
     "openai-custom": {
         name: "OpenAI (自定义)",
         models: [
+            { id: "qwen3.5:4b", name: "Qwen3.5 4B", types: ["llm"] },
             { id: "gpt-4o", name: "GPT-4o", types: ["llm"] },
             { id: "gpt-4o-mini", name: "GPT-4o Mini", types: ["llm"] },
             { id: "gpt-4-turbo", name: "GPT-4 Turbo", types: ["llm"] },
@@ -54,4 +55,30 @@ export const DEFAULT_PROVIDER_SUPPORT = {
             { id: "moonshot-v1-128k", name: "Moonshot 128K", types: ["llm"] },
         ],
     },
+    /** 本地 Ollama 服务，兼容 OpenAI API；baseUrl 指向本机 Ollama 默认端口 */
+    ollama: {
+        name: "Ollama (本地)",
+        baseUrl: "http://localhost:11434/v1",
+        models: [
+            { id: "qwen3:4b", name: "Qwen3 4B", types: ["llm"] },
+            { id: "qwen3:8b", name: "Qwen3 8B", types: ["llm"] },
+            { id: "qwen3:14b", name: "Qwen3 14B", types: ["llm"] },
+            { id: "llama3.2:3b", name: "Llama 3.2 3B", types: ["llm"] },
+            { id: "llama3.2:1b", name: "Llama 3.2 1B", types: ["llm"] },
+            { id: "nomic-embed-text", name: "Nomic Embed Text", types: ["embedding"] },
+        ],
+    },
+    /**
+     * 内置本地推理（node-llama-cpp），无需安装 Ollama。
+     * baseUrl 指向本地 LLM 子进程服务；模型列表为推荐的 GGUF 模型，可在本地模型管理页面增删。
+     * 无需 API Key。
+     */
+    local: {
+        name: "本地推理 (node-llama-cpp)",
+        baseUrl: "http://127.0.0.1:11435/v1",
+        models: [
+            { id: "local-llm", name: "本地 LLM（当前加载）", types: ["llm"] },
+            { id: "local-embedding", name: "本地 Embedding（当前加载）", types: ["embedding"] },
+        ],
+    },
 };

package/dist/core/extensions/index.d.ts

@@ -0,0 +1 @@
+export { loadExtensionFactories, clearExtensionFactoriesCache } from "./load.js";

package/dist/core/extensions/index.js

@@ -0,0 +1 @@
+export { loadExtensionFactories, clearExtensionFactoriesCache } from "./load.js";

package/dist/core/extensions/load.d.ts

@@ -0,0 +1,11 @@
+import type { ExtensionFactory } from "@mariozechner/pi-coding-agent";
+/**
+ * 扫描 ~/.openbot/plugins，加载所有已安装的扩展包，返回 ExtensionFactory 数组。
+ * 进程内缓存结果；若需重载可调用 clearExtensionFactoriesCache()。
+ */
+export declare function loadExtensionFactories(): ExtensionFactory[];
+/**
+ * 清除扩展 factory 缓存，下次 loadExtensionFactories() 时会重新扫描并加载。
+ * 用于安装/卸载扩展后希望不重启即生效的场景（若调用方在适当时机调用）。
+ */
+export declare function clearExtensionFactoriesCache(): void;

package/dist/core/extensions/load.js

@@ -0,0 +1,101 @@
+/**
+ * 从 ~/.openbot/plugins 目录加载通过 openbot extension install 安装的 npm 包，
+ * 将每个包的默认导出规范为 ExtensionFactory 并返回，供 AgentManager 注入到 DefaultResourceLoader.extensionFactories。
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { getOpenbotPluginsDir } from "../agent/agent-dir.js";
+let cachedFactories = null;
+/**
+ * 从插件目录的 package.json 读取 dependencies（及 optionalDependencies）的包名列表。
+ * 仅返回在 node_modules 中实际存在的包名。
+ */
+function getInstalledPluginNames(pluginsDir) {
+    const pkgPath = join(pluginsDir, "package.json");
+    if (!existsSync(pkgPath))
+        return [];
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+    const deps = {
+        ...pkg.dependencies,
+        ...pkg.optionalDependencies,
+    };
+    const names = Object.keys(deps || {});
+    return names.filter((name) => {
+        const dir = join(pluginsDir, "node_modules", name);
+        return existsSync(dir);
+    });
+}
+/**
+ * 将包默认导出规范为 ExtensionFactory：(pi) => void。
+ * 插件可导出 (pi) => void 或 () => (pi) => void（工厂），此处统一为 (pi) => void。
+ */
+function toExtensionFactory(fn) {
+    if (typeof fn !== "function")
+        return null;
+    if (fn.length === 1)
+        return fn; // (pi) => void
+    if (fn.length === 0) {
+        const result = fn();
+        if (typeof result === "function")
+            return result; // () => (pi) => void
+    }
+    return null;
+}
+/**
+ * 加载单个插件包，返回 ExtensionFactory 或 null（失败时打日志并返回 null）。
+ * 使用 require(pkgName) 从 plugins 目录的 node_modules 解析，以便插件自身依赖正确解析。
+ */
+function loadOnePlugin(pluginsDir, pkgName) {
+    const require = createRequire(join(pluginsDir, "package.json"));
+    let mod;
+    try {
+        mod = require(pkgName);
+    }
+    catch (err) {
+        console.warn(`[extensions] Failed to load plugin "${pkgName}":`, err);
+        return null;
+    }
+    const def = mod && typeof mod === "object" && "default" in mod ? mod.default : mod;
+    const factory = toExtensionFactory(def);
+    if (!factory) {
+        console.warn(`[extensions] Plugin "${pkgName}" default export is not a function; skipped.`);
+        return null;
+    }
+    return factory;
+}
+/**
+ * 扫描 ~/.openbot/plugins，加载所有已安装的扩展包，返回 ExtensionFactory 数组。
+ * 进程内缓存结果；若需重载可调用 clearExtensionFactoriesCache()。
+ */
+export function loadExtensionFactories() {
+    if (cachedFactories !== null)
+        return cachedFactories;
+    const pluginsDir = getOpenbotPluginsDir();
+    if (!existsSync(pluginsDir)) {
+        cachedFactories = [];
+        return cachedFactories;
+    }
+    const names = getInstalledPluginNames(pluginsDir);
+    const factories = [];
+    for (const name of names) {
+        const factory = loadOnePlugin(pluginsDir, name);
+        if (factory)
+            factories.push(factory);
+    }
+    cachedFactories = factories;
+    return factories;
+}
+/**
+ * 清除扩展 factory 缓存，下次 loadExtensionFactories() 时会重新扫描并加载。
+ * 用于安装/卸载扩展后希望不重启即生效的场景（若调用方在适当时机调用）。
+ */
+export function clearExtensionFactoriesCache() {
+    cachedFactories = null;
+}

package/dist/core/local-llm-server/download-model.d.ts

@@ -0,0 +1,16 @@
+export declare const DEFAULT_LLM_MODEL_URI = "hf:unsloth/Qwen3.5-4B-GGUF/Qwen3.5-4B-Q5_K_M.gguf";
+export interface DownloadModelOptions {
+    useMirror?: boolean;
+    signal?: AbortSignal;
+    onProgress?: (p: {
+        downloadedSize: number;
+        totalSize: number;
+        percent: number;
+    }) => void;
+}
+/**
+ * 下载模型到本地缓存目录。
+ * @returns 解析后的本地文件路径
+ */
+export declare function downloadModel(modelUri: string, options?: DownloadModelOptions): Promise<string>;
+export declare function getResolvedBasename(modelUri: string): string;

package/dist/core/local-llm-server/download-model.js

@@ -0,0 +1,37 @@
+/**
+ * 本地模型下载（供 CLI 与 Nest LocalModelsService 复用）。
+ * 使用 node-llama-cpp resolveModelFile，缓存目录 ~/.openbot/.cached_models/。
+ */
+import { basename } from "node:path";
+import { LOCAL_LLM_CACHE_DIR } from "./model-resolve.js";
+export const DEFAULT_LLM_MODEL_URI = "hf:unsloth/Qwen3.5-4B-GGUF/Qwen3.5-4B-Q5_K_M.gguf";
+/**
+ * 下载模型到本地缓存目录。
+ * @returns 解析后的本地文件路径
+ */
+export async function downloadModel(modelUri, options = {}) {
+    const { resolveModelFile } = await import("node-llama-cpp");
+    const { useMirror = false, signal, onProgress } = options;
+    const hfToken = process.env.HF_TOKEN || process.env.HUGGING_FACE_TOKEN;
+    const opts = {
+        directory: LOCAL_LLM_CACHE_DIR,
+        endpoints: {
+            huggingFace: useMirror ? "https://hf-mirror.com/" : "https://huggingface.co/",
+        },
+    };
+    if (signal)
+        opts.signal = signal;
+    if (hfToken)
+        opts.headers = { Authorization: `Bearer ${hfToken}` };
+    if (onProgress) {
+        opts.onProgress = ({ downloadedSize, totalSize }) => {
+            const percent = totalSize ? Math.round((downloadedSize / totalSize) * 100) : 0;
+            onProgress({ downloadedSize, totalSize, percent });
+        };
+    }
+    const resolved = await resolveModelFile(modelUri, opts);
+    return resolved;
+}
+export function getResolvedBasename(modelUri) {
+    return basename(modelUri.replace(/^hf:[^/]+\//, "").replace(/\//g, "_"));
+}

package/dist/core/local-llm-server/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * local-llm-server 入口。
+ *
+ * 两种运行模式：
+ * 1. 子进程模式（--child）：直接加载模型并启动 HTTP 服务，由主进程 fork 调用。
+ * 2. 主进程模式（默认导出）：fork 子进程，管理其生命周期，提供 baseUrl 给调用方。
+ *
+ * 主进程通过 startLocalLlmServer() 启动，返回 { baseUrl, stop }。
+ * 子进程就绪后通过 IPC 发送 { type: "ready" } 通知主进程。
+ */
+export interface LocalLlmServerOptions {
+    port?: number;
+    llmModelPath?: string;
+    embeddingModelPath?: string;
+    /** 上下文窗口 token 数，默认 32768（32K），需能容纳 system + tools + 对话；显存不足时在智能体配置中调小 */
+    contextSize?: number;
+    /** 等待子进程就绪的超时毫秒数，默认 300000（5 分钟，冷启/大模型加载可能较慢） */
+    readyTimeoutMs?: number;
+}
+export interface LocalLlmServerHandle {
+    baseUrl: string;
+    stop: () => void;
+}
+/**
+ * 停止本地 LLM 子进程服务（若正在运行）。用于切换模型前先停止再启动。
+ */
+export declare function stopLocalLlmServer(): void;
+/**
+ * 启动本地 LLM 子进程服务。
+ * 已启动时直接返回已有 handle（单例）。需先 stop 再传新参数重启。
+ */
+export declare function startLocalLlmServer(opts?: LocalLlmServerOptions): Promise<LocalLlmServerHandle>;