@next-open-ai/openclawx 0.6.6

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

@@ -0,0 +1,521 @@
+/**
+ * 桌面端配置单一入口（~/.openbot/desktop）。
+ * 供 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 { readFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { getOpenbotAgentDir } from "../agent/agent-dir.js";
+import { DEFAULT_PROVIDER_SUPPORT, } from "./provider-support-default.js";
+function getDesktopDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || homedir();
+    return join(home, ".openbot", "desktop");
+}
+const DEFAULT_AGENT_ID = "default";
+const DEFAULT_MAX_AGENT_SESSIONS = 5;
+/** 同步读取桌面全局配置（Gateway 等需要同步读的场景） */
+function getConfigPath() {
+    return join(getDesktopDir(), "config.json");
+}
+const PROVIDER_SUPPORT_FILENAME = "provider-support.json";
+function getProviderSupportPath() {
+    return join(getDesktopDir(), PROVIDER_SUPPORT_FILENAME);
+}
+/**
+ * 同步读取桌面全局配置中的 maxAgentSessions 等。
+ * Gateway 进程内使用，用于会话上限等。
+ */
+export function getDesktopConfig() {
+    try {
+        const configPath = getConfigPath();
+        if (!existsSync(configPath)) {
+            return { maxAgentSessions: DEFAULT_MAX_AGENT_SESSIONS };
+        }
+        const content = readFileSync(configPath, "utf-8");
+        const data = JSON.parse(content);
+        const max = data.maxAgentSessions;
+        const maxAgentSessions = typeof max === "number" && max > 0 ? Math.floor(max) : DEFAULT_MAX_AGENT_SESSIONS;
+        return { maxAgentSessions };
+    }
+    catch {
+        return { maxAgentSessions: DEFAULT_MAX_AGENT_SESSIONS };
+    }
+}
+/** 同步读取 RAG embedding 配置；未配置或无效时返回 null，长记忆将空转 */
+export function getRagEmbeddingConfigSync() {
+    try {
+        const configPath = getConfigPath();
+        if (!existsSync(configPath))
+            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();
+        if (!provider || !modelId)
+            return null;
+        const prov = data.providers?.[provider];
+        const apiKey = prov?.apiKey?.trim();
+        if (!apiKey)
+            return null;
+        let baseUrl = prov?.baseUrl?.trim();
+        if (!baseUrl) {
+            const d = EMBEDDING_DEFAULT_BASE_URL[provider];
+            baseUrl = d ?? "";
+        }
+        if (!baseUrl)
+            return null;
+        return { provider, modelId, apiKey, baseUrl: baseUrl.replace(/\/$/, "") };
+    }
+    catch {
+        return null;
+    }
+}
+const EMBEDDING_DEFAULT_BASE_URL = {
+    openai: "https://api.openai.com/v1",
+    "openai-custom": "",
+    deepseek: "https://api.deepseek.com/v1",
+    dashscope: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+    nvidia: "https://integrate.api.nvidia.com/v1",
+    kimi: "https://api.moonshot.cn/v1",
+};
+/**
+ * 从 config.json 读取缺省智能体 id（defaultAgentId）。
+ * 若未配置、或该 id 在 agents.json 中不存在，则返回 default。
+ */
+export async function getBoundAgentIdForCli() {
+    const desktopDir = getDesktopDir();
+    const configPath = join(desktopDir, "config.json");
+    const agentsPath = join(desktopDir, "agents.json");
+    let boundId = DEFAULT_AGENT_ID;
+    if (existsSync(configPath)) {
+        try {
+            const raw = await readFile(configPath, "utf-8");
+            const config = JSON.parse(raw);
+            const id = config.defaultAgentId ? String(config.defaultAgentId).trim() : "";
+            if (id)
+                boundId = id;
+        }
+        catch {
+            // ignore, use default
+        }
+    }
+    if (boundId === DEFAULT_AGENT_ID)
+        return DEFAULT_AGENT_ID;
+    if (!existsSync(agentsPath))
+        return DEFAULT_AGENT_ID;
+    try {
+        const raw = await readFile(agentsPath, "utf-8");
+        const data = JSON.parse(raw);
+        const agents = Array.isArray(data.agents) ? data.agents : [];
+        const found = agents.some((a) => a.id === boundId);
+        return found ? boundId : DEFAULT_AGENT_ID;
+    }
+    catch {
+        return DEFAULT_AGENT_ID;
+    }
+}
+/**
+ * 根据 agentId 从桌面配置中读取该 agent 的 provider、model 及 API Key。
+ * 若文件不存在或解析失败返回 null，调用方使用环境变量或默认值。
+ */
+export async function loadDesktopAgentConfig(agentId) {
+    const desktopDir = getDesktopDir();
+    const configPath = join(desktopDir, "config.json");
+    const agentsPath = join(desktopDir, "agents.json");
+    let config = {};
+    if (existsSync(configPath)) {
+        try {
+            const raw = await readFile(configPath, "utf-8");
+            config = JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    const resolvedAgentId = agentId === "default" ? "default" : agentId;
+    let provider = config.defaultProvider ?? "deepseek";
+    let model = config.defaultModel ?? "deepseek-chat";
+    if (config.defaultModelItemCode && Array.isArray(config.configuredModels)) {
+        const configured = config.configuredModels.find((m) => m.modelItemCode === config.defaultModelItemCode);
+        if (configured) {
+            provider = configured.provider;
+            model = configured.modelId;
+        }
+    }
+    let workspaceName = resolvedAgentId;
+    let mcpServers;
+    if (existsSync(agentsPath)) {
+        try {
+            const raw = await readFile(agentsPath, "utf-8");
+            const data = JSON.parse(raw);
+            const agents = Array.isArray(data.agents) ? data.agents : [];
+            const agent = agents.find((a) => a.id === resolvedAgentId);
+            if (agent) {
+                if (agent.workspace)
+                    workspaceName = agent.workspace;
+                else if (agent.id)
+                    workspaceName = agent.id;
+                if (agent.mcpServers && Array.isArray(agent.mcpServers)) {
+                    mcpServers = agent.mcpServers;
+                }
+                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;
+                    }
+                    else {
+                        if (agent.provider)
+                            provider = agent.provider;
+                        if (agent.model)
+                            model = agent.model;
+                    }
+                }
+                else {
+                    if (agent.provider)
+                        provider = agent.provider;
+                    if (agent.model)
+                        model = agent.model;
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    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 };
+}
+function ensureDesktopDir() {
+    const desktopDir = getDesktopDir();
+    if (!existsSync(desktopDir)) {
+        mkdirSync(desktopDir, { recursive: true });
+    }
+    return desktopDir;
+}
+async function readDesktopConfigJson() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath))
+        return {};
+    try {
+        const raw = await readFile(configPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeDesktopConfigJson(config) {
+    ensureDesktopDir();
+    const configPath = getConfigPath();
+    await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+/**
+ * 将某 provider 的 API Key 写入桌面 config（中心化配置源）。
+ * openbot login 使用：缺省 alias 与 provider 同名；若有 baseUrl 则一并写入。
+ * 若传入 modelId 或未传则取该 provider 第一个模型，会补齐 defaultProvider/defaultModel、configuredModels、agents 默认智能体，后续可直接运行。
+ */
+export async function setProviderApiKey(provider, apiKey, modelId) {
+    const config = await readDesktopConfigJson();
+    if (!config.providers)
+        config.providers = {};
+    if (!config.providers[provider])
+        config.providers[provider] = {};
+    const entry = config.providers[provider];
+    entry.apiKey = apiKey.trim();
+    if (entry.alias === undefined || entry.alias === "")
+        entry.alias = provider;
+    const support = await getProviderSupport();
+    const supportEntry = support[provider];
+    if (supportEntry?.baseUrl != null && String(supportEntry.baseUrl).trim() !== "" && !(entry.baseUrl != null && String(entry.baseUrl).trim() !== "")) {
+        entry.baseUrl = supportEntry.baseUrl.trim();
+    }
+    await writeDesktopConfigJson(config);
+    const effectiveModelId = (modelId != null && String(modelId).trim() !== "")
+        ? String(modelId).trim()
+        : await getFirstModelForProvider(provider);
+    if (effectiveModelId) {
+        await setDefaultModel(provider, effectiveModelId);
+    }
+    else {
+        await syncDesktopConfigToModelsJson();
+    }
+}
+/** 生成 configuredModels 项的 modelItemCode，与界面约定一致 */
+function buildModelItemCode(provider, modelId) {
+    return `${provider}_${modelId}`.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+/**
+ * 将全局默认 provider/model 写入桌面 config，并在 configuredModels 中增加/更新对应项，agents.json 中缺省智能体写入 modelItemCode。
+ * openbot config set-model 使用此方法。
+ */
+export async function setDefaultModel(provider, modelId) {
+    const modelIdTrim = modelId.trim();
+    const modelItemCode = buildModelItemCode(provider, modelIdTrim);
+    const config = await readDesktopConfigJson();
+    config.defaultProvider = provider;
+    config.defaultModel = modelIdTrim;
+    config.defaultModelItemCode = modelItemCode;
+    if (!Array.isArray(config.configuredModels))
+        config.configuredModels = [];
+    const list = config.configuredModels;
+    const existing = list.find((m) => m.modelItemCode === modelItemCode || (m.provider === provider && m.modelId === modelIdTrim));
+    const item = {
+        provider,
+        modelId: modelIdTrim,
+        type: "llm",
+        alias: `${modelIdTrim} item`,
+        modelItemCode,
+        reasoning: false,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 64000,
+        maxTokens: 8192,
+    };
+    if (existing) {
+        Object.assign(existing, item);
+    }
+    else {
+        list.push(item);
+    }
+    await writeDesktopConfigJson(config);
+    const agentsPath = join(getDesktopDir(), "agents.json");
+    if (existsSync(agentsPath)) {
+        try {
+            const raw = await readFile(agentsPath, "utf-8");
+            const data = JSON.parse(raw);
+            const agents = Array.isArray(data.agents) ? data.agents : [];
+            const defaultAgent = agents.find((a) => a.id === DEFAULT_AGENT_ID);
+            if (defaultAgent) {
+                defaultAgent.provider = provider;
+                defaultAgent.model = modelIdTrim;
+                defaultAgent.modelItemCode = modelItemCode;
+            }
+            else {
+                agents.unshift({
+                    id: DEFAULT_AGENT_ID,
+                    name: "主智能体",
+                    workspace: DEFAULT_AGENT_ID,
+                    provider,
+                    model: modelIdTrim,
+                    modelItemCode,
+                });
+            }
+            await writeFile(agentsPath, JSON.stringify({ agents }, null, 2), "utf-8");
+        }
+        catch {
+            // ignore
+        }
+    }
+    await syncDesktopConfigToModelsJson();
+}
+/**
+ * 供 CLI config list 使用，从桌面 config 读出配置列表。
+ */
+export async function getDesktopConfigList() {
+    const config = await readDesktopConfigJson();
+    const defaultProvider = config.defaultProvider ?? "deepseek";
+    const defaultModel = config.defaultModel ?? "deepseek-chat";
+    const providers = config.providers ?? {};
+    const entries = Object.entries(providers).map(([name, p]) => ({
+        provider: name,
+        defaultModel: name === defaultProvider ? defaultModel : "—",
+        hasKey: !!(p?.apiKey && String(p.apiKey).trim()),
+    }));
+    if (entries.length === 0) {
+        entries.push({
+            provider: defaultProvider,
+            defaultModel,
+            hasKey: false,
+        });
+    }
+    return { defaultProvider, defaultModel, defaultModelItemCode: config.defaultModelItemCode, providers: entries };
+}
+/**
+ * 确保桌面目录下存在 provider-support.json（不存在则写入默认内容）。
+ * 供配置供应商时作备选下拉列表项。
+ */
+export async function ensureProviderSupportFile() {
+    const path = getProviderSupportPath();
+    if (existsSync(path))
+        return;
+    ensureDesktopDir();
+    await writeFile(path, JSON.stringify(DEFAULT_PROVIDER_SUPPORT, null, 2), "utf-8");
+}
+/** 若 config.json 不存在则写入默认结构，供 CLI/Gateway 启动时初始化 */
+async function ensureConfigJsonInitialized() {
+    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");
+}
+/** 若 agents.json 不存在则写入默认智能体，供 CLI/Gateway 启动时初始化 */
+async function ensureAgentsJsonInitialized() {
+    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");
+}
+/**
+ * CLI / Gateway 运行时调用，确保 config.json、provider-support.json、agents.json 均完成初始化。
+ */
+export async function ensureDesktopConfigInitialized() {
+    ensureDesktopDir();
+    await ensureProviderSupportFile();
+    await ensureConfigJsonInitialized();
+    await ensureAgentsJsonInitialized();
+}
+/**
+ * 取某 provider 在 provider-support 中的第一个 llm 模型 id；若无则返回第一个模型 id。
+ */
+export async function getFirstModelForProvider(provider) {
+    const support = await getProviderSupport();
+    const entry = support[provider];
+    if (!entry?.models?.length)
+        return null;
+    const llm = entry.models.find((m) => m.types?.includes("llm"));
+    if (llm)
+        return llm.id;
+    return entry.models[0].id;
+}
+/**
+ * 读取桌面 provider-support.json（流行 provider 及模型目录）。
+ * 若文件不存在则先写入默认内容再返回；若存在则与默认合并，补全默认中已有而文件中缺失的 provider（如新增的 openai-custom）。
+ */
+export async function getProviderSupport() {
+    await ensureProviderSupportFile();
+    const path = getProviderSupportPath();
+    try {
+        const raw = await readFile(path, "utf-8");
+        const fromFile = JSON.parse(raw);
+        const merged = { ...fromFile };
+        let hasNew = false;
+        for (const [id, entry] of Object.entries(DEFAULT_PROVIDER_SUPPORT)) {
+            if (!(id in merged)) {
+                merged[id] = entry;
+                hasNew = true;
+            }
+        }
+        if (hasNew) {
+            await writeFile(path, JSON.stringify(merged, null, 2), "utf-8");
+        }
+        return merged;
+    }
+    catch {
+        return DEFAULT_PROVIDER_SUPPORT;
+    }
+}
+/** 同步到 pi models.json 时使用的默认 baseUrl / apiKey 环境变量名 / api，provider-support 中不再存储 */
+const SYNC_DEFAULTS = {
+    deepseek: { baseUrl: "https://api.deepseek.com", apiKey: "OPENAI_API_KEY", api: "openai-completions" },
+    dashscope: { baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1", apiKey: "DASHSCOPE_API_KEY", api: "openai-completions" },
+    openai: { baseUrl: "https://api.openai.com/v1", apiKey: "OPENAI_API_KEY", api: "openai-completions" },
+    /** 自定义端点，baseUrl 由用户填写，兼容所有 OpenAI 接口 */
+    "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" },
+};
+const DEFAULT_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+const DEFAULT_CONTEXT_WINDOW = 64000;
+const DEFAULT_MAX_TOKENS = 8192;
+function configuredModelToPi(item, displayName) {
+    const cost = item.cost ?? {};
+    return {
+        id: item.modelId,
+        name: displayName,
+        reasoning: item.reasoning ?? false,
+        input: ["text"],
+        cost: {
+            input: cost.input ?? 0,
+            output: cost.output ?? 0,
+            cacheRead: cost.cacheRead ?? 0,
+            cacheWrite: cost.cacheWrite ?? 0,
+        },
+        contextWindow: item.contextWindow ?? DEFAULT_CONTEXT_WINDOW,
+        maxTokens: item.maxTokens ?? DEFAULT_MAX_TOKENS,
+        supportsTools: true,
+    };
+}
+/**
+ * 根据桌面 config（已配置的 providers + configuredModels）与 provider-support，生成并写入 agent 目录的 models.json。
+ * 仅包含在 config 的 providers 中已配置的 provider；每个 provider 的 models 来自 configuredModels，结构含 reasoning、cost 等。
+ */
+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) {
+        return;
+    }
+    const support = await getProviderSupport();
+    const piProviders = {};
+    for (const [providerId, userConfig] of Object.entries(configured)) {
+        if (!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;
+        if (!baseUrl)
+            continue;
+        const def = support[providerId];
+        const items = configuredModels.filter((m) => m.provider === providerId);
+        let models;
+        if (items.length > 0) {
+            models = items.map((item) => {
+                const displayName = (item.alias && item.alias.trim()) ||
+                    (def?.models?.find((m) => m.id === item.modelId)?.name) ||
+                    item.modelId;
+                return configuredModelToPi(item, displayName);
+            });
+        }
+        else if (def?.models?.length) {
+            models = def.models.map((m) => configuredModelToPi({
+                provider: providerId,
+                modelId: m.id,
+                type: "llm",
+                alias: m.name,
+                reasoning: false,
+                cost: DEFAULT_COST,
+                contextWindow: DEFAULT_CONTEXT_WINDOW,
+                maxTokens: DEFAULT_MAX_TOKENS,
+            }, m.name || m.id));
+        }
+        else {
+            continue;
+        }
+        piProviders[providerId] = {
+            name: (userConfig.alias?.trim() || def?.name) || providerId,
+            apiKey: defaults.apiKey,
+            api: defaults.api,
+            baseUrl: baseUrl.replace(/\/$/, ""),
+            authHeader: true,
+            models,
+        };
+    }
+    if (Object.keys(piProviders).length === 0)
+        return;
+    const agentDir = getOpenbotAgentDir();
+    if (!existsSync(agentDir)) {
+        mkdirSync(agentDir, { recursive: true });
+    }
+    const modelsPath = join(agentDir, "models.json");
+    await writeFile(modelsPath, JSON.stringify({ providers: piProviders }, null, 2), "utf-8");
+}

package/dist/core/config/provider-support-default.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 默认的 provider 及模型目录，供配置时下拉备选。
+ * 桌面 provider-support.json 若不存在则使用此默认并写入桌面目录。
+ * 官方 provider 可预设 baseUrl，CLI login 时会写入 config；未知或自定义 OpenAI 接口可不设。
+ */
+/** 模型支持的能力类型，配置处（如 agent 配置、长记忆 embedding 选择）可按类型筛选可用模型 */
+export type ModelSupportType = "llm" | "embedding" | "image" | "audio" | "video";
+export interface ProviderSupportModel {
+    id: string;
+    name: string;
+    /** 支持的类型，如 llm / embedding / image / audio / video；缺省视为 ["llm"] */
+    types?: ModelSupportType[];
+}
+export interface ProviderSupportEntry {
+    name: string;
+    /** 官方 API 的 baseUrl，CLI login 时会写入 config；不设或空表示需用户在桌面填写（如自定义端点） */
+    baseUrl?: string;
+    models: ProviderSupportModel[];
+}
+export type ProviderSupport = Record<string, ProviderSupportEntry>;
+export declare const DEFAULT_PROVIDER_SUPPORT: ProviderSupport;

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

@@ -0,0 +1,57 @@
+export const DEFAULT_PROVIDER_SUPPORT = {
+    deepseek: {
+        name: "DeepSeek",
+        baseUrl: "https://api.deepseek.com",
+        models: [
+            { id: "deepseek-chat", name: "DeepSeek Chat", types: ["llm"] },
+            { id: "deepseek-reasoner", name: "DeepSeek Reasoner", types: ["llm"] },
+        ],
+    },
+    dashscope: {
+        name: "DashScope (Alibaba)",
+        baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+        models: [
+            { id: "qwen-max", name: "Qwen Max", types: ["llm"] },
+            { id: "qwen-plus", name: "Qwen Plus", types: ["llm"] },
+        ],
+    },
+    openai: {
+        name: "OpenAI",
+        baseUrl: "https://api.openai.com/v1",
+        models: [
+            { id: "gpt-4o", name: "GPT-4o", types: ["llm"] },
+            { id: "gpt-4o-mini", name: "GPT-4o Mini", types: ["llm"] },
+            { id: "text-embedding-3-small", name: "Text Embedding 3 Small", types: ["embedding"] },
+        ],
+    },
+    /** 自定义 Base URL，兼容所有 OpenAI 接口（本地/第三方兼容端点）；baseUrl 不预设，由用户在桌面填写 */
+    "openai-custom": {
+        name: "OpenAI (自定义)",
+        models: [
+            { 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"] },
+            { id: "gpt-3.5-turbo", name: "GPT-3.5 Turbo", types: ["llm"] },
+            { id: "text-embedding-3-small", name: "Text Embedding 3 Small", types: ["embedding"] },
+            { id: "text-embedding-ada-002", name: "Text Embedding Ada 002", types: ["embedding"] },
+        ],
+    },
+    nvidia: {
+        name: "NVIDIA",
+        baseUrl: "https://integrate.api.nvidia.com/v1",
+        models: [
+            { id: "moonshotai/kimi-k2.5", name: "Kimi K2.5", types: ["llm"] },
+            { id: "nvidia/nemotron-nano-12b-v2", name: "Nemotron Nano 12B v2", types: ["llm"] },
+            { id: "nvidia/nemotron-nano-9b-v2", name: "Nemotron Nano 9B v2", types: ["llm"] },
+        ],
+    },
+    kimi: {
+        name: "Kimi (Moonshot)",
+        baseUrl: "https://api.moonshot.cn/v1",
+        models: [
+            { id: "moonshot-v1-8k", name: "Moonshot 8K", types: ["llm"] },
+            { id: "moonshot-v1-32k", name: "Moonshot 32K", types: ["llm"] },
+            { id: "moonshot-v1-128k", name: "Moonshot 128K", types: ["llm"] },
+        ],
+    },
+};

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

@@ -0,0 +1 @@
+export { resolveInstallTarget, installSkillByUrl, installSkillFromPath, installSkillFromUpload, type InstallByUrlOptions, type InstallByUrlResult, type InstallFromPathOptions, type InstallFromPathResult, type InstallFromUploadOptions, } from "./skill-installer.js";

package/dist/core/installer/index.js

@@ -0,0 +1 @@
+export { resolveInstallTarget, installSkillByUrl, installSkillFromPath, installSkillFromUpload, } from "./skill-installer.js";

package/dist/core/installer/skill-installer.d.ts

@@ -0,0 +1,39 @@
+/** 解析 targetAgentId 得到安装目标：global 或 workspace + 工作区名 */
+export declare function resolveInstallTarget(targetAgentId: string | undefined): Promise<{
+    scope: "global" | "workspace";
+    workspace: string;
+}>;
+export interface InstallByUrlOptions {
+    scope: "global" | "workspace";
+    workspace?: string;
+}
+export interface InstallByUrlResult {
+    stdout: string;
+    stderr: string;
+    installDir: string;
+}
+/**
+ * 通过 npx skills add 安装技能到指定目录（与 Nest SkillsService 逻辑一致）。
+ */
+export declare function installSkillByUrl(url: string, options?: InstallByUrlOptions): Promise<InstallByUrlResult>;
+export interface InstallFromPathOptions {
+    scope: "global" | "workspace";
+    workspace?: string;
+}
+export interface InstallFromPathResult {
+    installDir: string;
+    name: string;
+}
+/**
+ * 从本地目录安装技能：将指定目录复制到目标 skills 目录。
+ */
+export declare function installSkillFromPath(localPath: string, options?: InstallFromPathOptions): Promise<InstallFromPathResult>;
+export interface InstallFromUploadOptions {
+    scope: "global" | "workspace";
+    workspace?: string;
+}
+/**
+ * 从上传的 zip 安装技能：解压到临时目录，校验为单个技能目录（含 SKILL.md），再复制到目标。
+ * 支持两种 zip 结构：① 单个顶层目录且内含 SKILL.md；② 根目录直接含 SKILL.md（将视为技能根目录）。
+ */
+export declare function installSkillFromUpload(zipBuffer: Buffer, options?: InstallFromUploadOptions): Promise<InstallFromPathResult>;