@nextclaw/server 0.5.25 → 0.5.27

package/dist/index.d.ts

@@ -15,6 +15,7 @@ type ApiResponse<T> = {
     error: ApiError;
 };
 type ProviderConfigView = {
+    displayName?: string;
     apiKeySet: boolean;
     apiKeyMasked?: string;
     apiBase?: string | null;
@@ -23,6 +24,7 @@ type ProviderConfigView = {
     models?: string[];
 };
 type ProviderConfigUpdate = {
+    displayName?: string | null;
     apiKey?: string | null;
     apiBase?: string | null;
     extraHeaders?: Record<string, string> | null;
@@ -32,6 +34,15 @@ type ProviderConfigUpdate = {
 type ProviderConnectionTestRequest = ProviderConfigUpdate & {
     model?: string | null;
 };
+type ProviderCreateRequest = ProviderConfigUpdate;
+type ProviderCreateResult = {
+    name: string;
+    provider: ProviderConfigView;
+};
+type ProviderDeleteResult = {
+    deleted: boolean;
+    provider: string;
+};
 type ProviderConnectionTestResult = {
     success: boolean;
     provider: string;
@@ -288,6 +299,7 @@ type ConfigView = {
 type ProviderSpecView = {
     name: string;
     displayName?: string;
+    isCustom?: boolean;
     modelPrefix?: string;
     keywords: string[];
     envKey: string;
@@ -387,12 +399,14 @@ type MarketplaceInstallSpec = {
     spec: string;
     command: string;
 };
+type MarketplaceLocalizedTextMap = Record<string, string>;
 type MarketplaceItemSummary = {
     id: string;
     slug: string;
     type: MarketplaceItemType;
     name: string;
     summary: string;
+    summaryI18n: MarketplaceLocalizedTextMap;
     tags: string[];
     author: string;
     install: MarketplaceInstallSpec;
@@ -400,10 +414,33 @@ type MarketplaceItemSummary = {
 };
 type MarketplaceItemView = MarketplaceItemSummary & {
     description?: string;
+    descriptionI18n?: MarketplaceLocalizedTextMap;
     sourceRepo?: string;
     homepage?: string;
     publishedAt: string;
 };
+type MarketplaceSkillContentView = {
+    type: "skill";
+    slug: string;
+    name: string;
+    install: MarketplaceInstallSpec;
+    source: "workspace" | "builtin" | "git" | "remote";
+    raw: string;
+    metadataRaw?: string;
+    bodyRaw: string;
+    sourceUrl?: string;
+};
+type MarketplacePluginContentView = {
+    type: "plugin";
+    slug: string;
+    name: string;
+    install: MarketplaceInstallSpec;
+    source: "npm" | "repo" | "remote";
+    raw?: string;
+    bodyRaw?: string;
+    metadataRaw?: string;
+    sourceUrl?: string;
+};
 type MarketplaceListView = {
     total: number;
     page: number;
@@ -597,6 +634,11 @@ declare function updateModel(configPath: string, patch: {
     maxTokens?: number;
 }): ConfigView;
 declare function updateProvider(configPath: string, providerName: string, patch: ProviderConfigUpdate): ProviderConfigView | null;
+declare function createCustomProvider(configPath: string, patch?: ProviderConfigUpdate): {
+    name: string;
+    provider: ProviderConfigView;
+};
+declare function deleteCustomProvider(configPath: string, providerName: string): boolean | null;
 declare function testProviderConnection(configPath: string, providerName: string, patch: ProviderConnectionTestRequest): Promise<ProviderConnectionTestResult | null>;
 declare function updateChannel(configPath: string, channelName: string, patch: Record<string, unknown>): Record<string, unknown> | null;
 declare function listSessions(configPath: string, query?: {
@@ -610,4 +652,4 @@ declare function deleteSession(configPath: string, key: string): boolean;
 declare function updateRuntime(configPath: string, patch: RuntimeConfigUpdate): Pick<ConfigView, "agents" | "bindings" | "session">;
 declare function updateSecrets(configPath: string, patch: SecretsConfigUpdate): SecretsView;
 
-export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createUiRouter, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };
+export { type AgentBindingView, type AgentProfileView, type ApiError, type ApiResponse, type BindingPeerView, type ChannelSpecView, type ChatTurnRequest, type ChatTurnResult, type ChatTurnStreamEvent, type ChatTurnView, type ConfigActionExecuteRequest, type ConfigActionExecuteResult, type ConfigActionManifest, type ConfigActionType, type ConfigMetaView, type ConfigSchemaResponse, type ConfigUiHint, type ConfigUiHints, type ConfigView, type CronActionResult, type CronEnableRequest, type CronJobStateView, type CronJobView, type CronListView, type CronPayloadView, type CronRunRequest, type CronScheduleView, type MarketplaceApiConfig, type MarketplaceInstallKind, type MarketplaceInstallSkillParams, type MarketplaceInstallSpec, type MarketplaceInstalledRecord, type MarketplaceInstalledView, type MarketplaceInstaller, type MarketplaceItemSummary, type MarketplaceItemType, type MarketplaceItemView, type MarketplaceListView, type MarketplaceLocalizedTextMap, type MarketplacePluginContentView, type MarketplacePluginInstallRequest, type MarketplacePluginInstallResult, type MarketplacePluginManageAction, type MarketplacePluginManageRequest, type MarketplacePluginManageResult, type MarketplaceRecommendationView, type MarketplaceSkillContentView, type MarketplaceSkillInstallRequest, type MarketplaceSkillInstallResult, type MarketplaceSkillManageAction, type MarketplaceSkillManageRequest, type MarketplaceSkillManageResult, type MarketplaceSort, type ProviderConfigUpdate, type ProviderConfigView, type ProviderConnectionTestRequest, type ProviderConnectionTestResult, type ProviderCreateRequest, type ProviderCreateResult, type ProviderDeleteResult, type ProviderSpecView, type RuntimeConfigUpdate, type SecretProviderEnvView, type SecretProviderExecView, type SecretProviderFileView, type SecretProviderView, type SecretRefView, type SecretSourceView, type SecretsConfigUpdate, type SecretsView, type SessionConfigView, type SessionEntryView, type SessionEventView, type SessionHistoryView, type SessionMessageView, type SessionPatchUpdate, type SessionsListView, type UiChatRuntime, type UiServerEvent, type UiServerHandle, type UiServerOptions, buildConfigMeta, buildConfigSchemaView, buildConfigView, createCustomProvider, createUiRouter, deleteCustomProvider, deleteSession, executeConfigAction, getSessionHistory, listSessions, loadConfigOrDefault, patchSession, startUiServer, testProviderConnection, updateChannel, updateModel, updateProvider, updateRuntime, updateSecrets };

package/dist/index.js

@@ -5,11 +5,12 @@ import { cors } from "hono/cors";
 import { serve } from "@hono/node-server";
 import { WebSocketServer, WebSocket } from "ws";
 import { existsSync, readFileSync } from "fs";
-import { readFile, stat } from "fs/promises";
+import { readFile as readFile2, stat } from "fs/promises";
 import { join } from "path";
 
 // src/ui/router.ts
 import { Hono } from "hono";
+import { readFile } from "fs/promises";
 import * as NextclawCore from "@nextclaw/core";
 import { buildPluginStatusReport } from "@nextclaw/openclaw-compat";
 
@@ -34,7 +35,7 @@ var MASK_MIN_LENGTH = 8;
 var EXTRA_SENSITIVE_PATH_PATTERNS = [/authorization/i, /cookie/i, /session/i, /bearer/i];
 var PROVIDER_TEST_MODEL_FALLBACKS = {
   openai: "gpt-5-mini",
-  deepseek: "deepseek-v3.2",
+  deepseek: "deepseek-chat",
   gemini: "gemini-3-flash-preview",
   zhipu: "glm-5",
   dashscope: "qwen3.5-flash",
@@ -59,6 +60,53 @@ var PREFERRED_PROVIDER_ORDER = [
 var PREFERRED_PROVIDER_ORDER_INDEX = new Map(
   PREFERRED_PROVIDER_ORDER.map((name, index) => [name, index])
 );
+var BUILTIN_PROVIDER_NAMES = new Set(PROVIDERS.map((spec) => spec.name));
+var CUSTOM_PROVIDER_WIRE_API_OPTIONS = ["auto", "chat", "responses"];
+var CUSTOM_PROVIDER_PREFIX = "custom-";
+function normalizeOptionalDisplayName(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function isCustomProviderName(name) {
+  return name.trim().length > 0 && !BUILTIN_PROVIDER_NAMES.has(name);
+}
+function resolveCustomProviderFallbackDisplayName(name) {
+  if (name.startsWith(CUSTOM_PROVIDER_PREFIX)) {
+    const suffix = name.slice(CUSTOM_PROVIDER_PREFIX.length);
+    if (/^\d+$/.test(suffix)) {
+      return `Custom ${suffix}`;
+    }
+  }
+  return name;
+}
+function resolveProviderDisplayName(providerName, provider, spec) {
+  const configDisplayName = normalizeOptionalDisplayName(provider?.displayName);
+  if (isCustomProviderName(providerName)) {
+    return configDisplayName ?? resolveCustomProviderFallbackDisplayName(providerName);
+  }
+  return spec?.displayName ?? configDisplayName ?? spec?.name;
+}
+function listCustomProviderNames(config) {
+  return Object.keys(config.providers).filter((name) => isCustomProviderName(name));
+}
+function findNextCustomProviderName(config) {
+  const providers = config.providers;
+  let index = 1;
+  while (providers[`${CUSTOM_PROVIDER_PREFIX}${index}`]) {
+    index += 1;
+  }
+  return `${CUSTOM_PROVIDER_PREFIX}${index}`;
+}
+function clearSecretRefsByPrefix(config, pathPrefix) {
+  for (const key of Object.keys(config.secrets.refs)) {
+    if (key === pathPrefix || key.startsWith(`${pathPrefix}.`)) {
+      delete config.secrets.refs[key];
+    }
+  }
+}
 var DOCS_BASE_URL = "https://docs.nextclaw.io";
 var CHANNEL_TUTORIAL_URLS = {
   feishu: {
@@ -295,14 +343,16 @@ function toProviderView(config, provider, providerName, uiHints, spec) {
     uiHints
   ) : null;
   const view = {
+    displayName: resolveProviderDisplayName(providerName, provider, spec),
     apiKeySet: masked.apiKeySet || apiKeyRefSet,
     apiKeyMasked: masked.apiKeyMasked ?? (apiKeyRefSet ? "****" : void 0),
     apiBase: provider.apiBase ?? null,
     extraHeaders: extraHeaders && Object.keys(extraHeaders).length > 0 ? extraHeaders : null,
     models: normalizeModelList(provider.models ?? [])
   };
-  if (spec?.supportsWireApi) {
-    view.wireApi = provider.wireApi ?? spec.defaultWireApi ?? "auto";
+  const supportsWireApi = Boolean(spec?.supportsWireApi) || isCustomProviderName(providerName);
+  if (supportsWireApi) {
+    view.wireApi = provider.wireApi ?? spec?.defaultWireApi ?? "auto";
   }
   return view;
 }
@@ -340,20 +390,25 @@ function clearSecretRef(config, path) {
   }
 }
 function buildConfigMeta(config) {
-  const providers = PROVIDERS.map((spec) => ({
-    name: spec.name,
-    displayName: spec.displayName,
-    modelPrefix: spec.modelPrefix,
-    keywords: spec.keywords,
-    envKey: spec.envKey,
-    isGateway: spec.isGateway,
-    isLocal: spec.isLocal,
-    defaultApiBase: spec.defaultApiBase,
-    defaultModels: normalizeModelList(spec.defaultModels ?? []),
-    supportsWireApi: spec.supportsWireApi,
-    wireApiOptions: spec.wireApiOptions,
-    defaultWireApi: spec.defaultWireApi
-  })).sort((left, right) => {
+  const configProviders = config.providers;
+  const builtinProviders = PROVIDERS.map((spec) => {
+    const providerConfig = configProviders[spec.name];
+    return {
+      name: spec.name,
+      displayName: resolveProviderDisplayName(spec.name, providerConfig, spec),
+      isCustom: false,
+      modelPrefix: spec.modelPrefix,
+      keywords: spec.keywords,
+      envKey: spec.envKey,
+      isGateway: spec.isGateway,
+      isLocal: spec.isLocal,
+      defaultApiBase: spec.defaultApiBase,
+      defaultModels: normalizeModelList(spec.defaultModels ?? []),
+      supportsWireApi: spec.supportsWireApi,
+      wireApiOptions: spec.wireApiOptions,
+      defaultWireApi: spec.defaultWireApi
+    };
+  }).sort((left, right) => {
     const leftRank = PREFERRED_PROVIDER_ORDER_INDEX.get(left.name);
     const rightRank = PREFERRED_PROVIDER_ORDER_INDEX.get(right.name);
     if (leftRank !== void 0 && rightRank !== void 0) {
@@ -367,6 +422,26 @@ function buildConfigMeta(config) {
     }
     return left.name.localeCompare(right.name);
   });
+  const customProviders = listCustomProviderNames(config).sort((left, right) => left.localeCompare(right, void 0, { numeric: true, sensitivity: "base" })).map((name) => {
+    const providerConfig = configProviders[name];
+    const displayName = resolveProviderDisplayName(name, providerConfig);
+    return {
+      name,
+      displayName,
+      isCustom: true,
+      modelPrefix: name,
+      keywords: normalizeModelList([name, displayName ?? ""]),
+      envKey: "OPENAI_API_KEY",
+      isGateway: false,
+      isLocal: false,
+      defaultApiBase: void 0,
+      defaultModels: [],
+      supportsWireApi: true,
+      wireApiOptions: CUSTOM_PROVIDER_WIRE_API_OPTIONS,
+      defaultWireApi: "auto"
+    };
+  });
+  const providers = [...customProviders, ...builtinProviders];
   const channels = Object.keys(config.channels).map((name) => {
     const tutorialUrls = CHANNEL_TUTORIAL_URLS[name];
     const tutorialUrl = tutorialUrls?.default ?? tutorialUrls?.en ?? tutorialUrls?.zh;
@@ -457,6 +532,10 @@ function updateProvider(configPath, providerName, patch) {
     return null;
   }
   const spec = findProviderByName(providerName);
+  const isCustom = isCustomProviderName(providerName);
+  if (Object.prototype.hasOwnProperty.call(patch, "displayName") && isCustom) {
+    provider.displayName = normalizeOptionalDisplayName(patch.displayName) ?? "";
+  }
   if (Object.prototype.hasOwnProperty.call(patch, "apiKey")) {
     provider.apiKey = patch.apiKey ?? "";
     clearSecretRef(config, `providers.${providerName}.apiKey`);
@@ -467,8 +546,8 @@ function updateProvider(configPath, providerName, patch) {
   if (Object.prototype.hasOwnProperty.call(patch, "extraHeaders")) {
     provider.extraHeaders = patch.extraHeaders ?? null;
   }
-  if (Object.prototype.hasOwnProperty.call(patch, "wireApi") && spec?.supportsWireApi) {
-    provider.wireApi = patch.wireApi ?? spec.defaultWireApi ?? "auto";
+  if (Object.prototype.hasOwnProperty.call(patch, "wireApi") && (spec?.supportsWireApi || isCustom)) {
+    provider.wireApi = patch.wireApi ?? spec?.defaultWireApi ?? "auto";
   }
   if (Object.prototype.hasOwnProperty.call(patch, "models")) {
     provider.models = normalizeModelList(patch.models ?? []);
@@ -479,6 +558,43 @@ function updateProvider(configPath, providerName, patch) {
   const updated = next.providers[providerName];
   return toProviderView(next, updated, providerName, uiHints, spec ?? void 0);
 }
+function createCustomProvider(configPath, patch = {}) {
+  const config = loadConfigOrDefault(configPath);
+  const providerName = findNextCustomProviderName(config);
+  const providers = config.providers;
+  const generatedDisplayName = resolveCustomProviderFallbackDisplayName(providerName);
+  providers[providerName] = {
+    displayName: normalizeOptionalDisplayName(patch.displayName) ?? generatedDisplayName,
+    apiKey: normalizeOptionalString(patch.apiKey) ?? "",
+    apiBase: normalizeOptionalString(patch.apiBase),
+    extraHeaders: normalizeHeaders(patch.extraHeaders ?? null),
+    wireApi: patch.wireApi ?? "auto",
+    models: normalizeModelList(patch.models ?? [])
+  };
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  const uiHints = buildUiHints(next);
+  const created = next.providers[providerName];
+  return {
+    name: providerName,
+    provider: toProviderView(next, created, providerName, uiHints)
+  };
+}
+function deleteCustomProvider(configPath, providerName) {
+  if (!isCustomProviderName(providerName)) {
+    return null;
+  }
+  const config = loadConfigOrDefault(configPath);
+  const providers = config.providers;
+  if (!providers[providerName]) {
+    return null;
+  }
+  delete providers[providerName];
+  clearSecretRefsByPrefix(config, `providers.${providerName}`);
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  return true;
+}
 function normalizeOptionalString(value) {
   if (typeof value !== "string") {
     return null;
@@ -496,10 +612,37 @@ function normalizeHeaders(input) {
   }
   return Object.fromEntries(entries);
 }
-function resolveTestModel(config, providerName, requestedModel) {
+function buildScopedProviderModel(providerName, model, spec) {
+  const trimmed = model.trim();
+  if (!trimmed) {
+    return "";
+  }
+  if (trimmed.includes("/")) {
+    return trimmed;
+  }
+  if (isCustomProviderName(providerName)) {
+    return trimmed;
+  }
+  const prefix = (spec?.modelPrefix ?? providerName).trim();
+  if (!prefix) {
+    return trimmed;
+  }
+  return `${prefix}/${trimmed}`;
+}
+function resolveTestModel(config, providerName, requestedModel, provider, spec) {
   if (requestedModel) {
+    if (isCustomProviderName(providerName)) {
+      const prefix = `${providerName}/`;
+      if (requestedModel.startsWith(prefix)) {
+        return requestedModel.slice(prefix.length) || null;
+      }
+    }
     return requestedModel;
   }
+  const providerModels = normalizeModelList(provider.models ?? []).map((modelId) => buildScopedProviderModel(providerName, modelId, spec)).filter((modelId) => modelId.length > 0);
+  if (providerModels.length > 0) {
+    return providerModels[0];
+  }
   const defaultModel = normalizeOptionalString(config.agents.defaults.model);
   if (defaultModel) {
     const routedProvider = getProviderName(config, defaultModel);
@@ -507,6 +650,9 @@ function resolveTestModel(config, providerName, requestedModel) {
       return defaultModel;
     }
   }
+  if (isCustomProviderName(providerName)) {
+    return null;
+  }
   return PROVIDER_TEST_MODEL_FALLBACKS[providerName] ?? defaultModel ?? null;
 }
 function stringifyError(error) {
@@ -530,7 +676,8 @@ async function testProviderConnection(configPath, providerName, patch) {
   const apiBase = hasApiBasePatch ? patchedApiBase ?? spec?.defaultApiBase ?? null : currentApiBase ?? spec?.defaultApiBase ?? null;
   const hasHeadersPatch = Object.prototype.hasOwnProperty.call(patch, "extraHeaders");
   const extraHeaders = hasHeadersPatch ? normalizeHeaders(patch.extraHeaders ?? null) : normalizeHeaders(provider.extraHeaders ?? null);
-  const wireApi = spec?.supportsWireApi ? patch.wireApi ?? provider.wireApi ?? spec.defaultWireApi ?? "auto" : null;
+  const isCustom = isCustomProviderName(providerName);
+  const wireApi = spec?.supportsWireApi || isCustom ? patch.wireApi ?? provider.wireApi ?? spec?.defaultWireApi ?? "auto" : null;
   if (!apiKey && !spec?.isLocal) {
     return {
       success: false,
@@ -540,13 +687,13 @@ async function testProviderConnection(configPath, providerName, patch) {
     };
   }
   const requestedModel = normalizeOptionalString(patch.model);
-  const model = resolveTestModel(config, providerName, requestedModel);
+  const model = resolveTestModel(config, providerName, requestedModel, provider, spec ?? void 0);
   if (!model) {
     return {
       success: false,
       provider: providerName,
       latencyMs: 0,
-      message: "No test model found. Set a default model first, then try again."
+      message: "No test model found. Configure provider models or set a default model for this provider, then try again."
     };
   }
   const probe = new LiteLLMProvider({
@@ -1287,6 +1434,141 @@ function sanitizeMarketplaceItem(item) {
   delete next.metrics;
   return next;
 }
+var MARKETPLACE_ZH_COPY_BY_SLUG = {
+  weather: {
+    summary: "NextClaw \u5185\u7F6E\u6280\u80FD\uFF0C\u7528\u4E8E\u5929\u6C14\u67E5\u8BE2\u5DE5\u4F5C\u6D41\u3002",
+    description: "\u5728 NextClaw \u4E2D\u63D0\u4F9B\u5FEB\u901F\u5929\u6C14\u67E5\u8BE2\u5DE5\u4F5C\u6D41\u3002"
+  },
+  summarize: {
+    summary: "NextClaw \u5185\u7F6E\u6280\u80FD\uFF0C\u7528\u4E8E\u7ED3\u6784\u5316\u6458\u8981\u3002",
+    description: "\u5728 NextClaw \u4E2D\u63D0\u4F9B\u6587\u4EF6\u4E0E\u957F\u6587\u672C\u7684\u6458\u8981\u5DE5\u4F5C\u6D41\u3002"
+  },
+  github: {
+    summary: "NextClaw \u5185\u7F6E\u6280\u80FD\uFF0C\u7528\u4E8E GitHub \u5DE5\u4F5C\u6D41\u3002",
+    description: "\u5728 NextClaw \u4E2D\u63D0\u4F9B Issue\u3001PR \u4E0E\u4ED3\u5E93\u76F8\u5173\u5DE5\u4F5C\u6D41\u6307\u5F15\u3002"
+  },
+  tmux: {
+    summary: "NextClaw \u5185\u7F6E\u6280\u80FD\uFF0C\u7528\u4E8E\u7EC8\u7AEF/Tmux \u534F\u4F5C\u5DE5\u4F5C\u6D41\u3002",
+    description: "\u5728 NextClaw \u4E2D\u63D0\u4F9B\u57FA\u4E8E Tmux \u7684\u4EFB\u52A1\u6267\u884C\u5DE5\u4F5C\u6D41\u6307\u5F15\u3002"
+  },
+  gog: {
+    summary: "NextClaw \u5185\u7F6E\u6280\u80FD\uFF0C\u7528\u4E8E\u56FE\u8C31\u5BFC\u5411\u751F\u6210\u5DE5\u4F5C\u6D41\u3002",
+    description: "\u5728 NextClaw \u4E2D\u63D0\u4F9B\u56FE\u8C31\u4E0E\u89C4\u5212\u5BFC\u5411\u5DE5\u4F5C\u6D41\u6307\u5F15\u3002"
+  },
+  pdf: {
+    summary: "Anthropic \u6280\u80FD\uFF0C\u7528\u4E8E PDF \u8BFB\u53D6/\u5408\u5E76/\u62C6\u5206/OCR \u5DE5\u4F5C\u6D41\u3002",
+    description: "\u4F7F\u7528\u8BE5\u6280\u80FD\u53EF\u8BFB\u53D6\u3001\u63D0\u53D6\u3001\u5408\u5E76\u3001\u62C6\u5206\u3001\u65CB\u8F6C\u5E76\u5BF9 PDF \u6267\u884C OCR \u5904\u7406\u3002"
+  },
+  docx: {
+    summary: "Anthropic \u6280\u80FD\uFF0C\u7528\u4E8E\u521B\u5EFA\u548C\u7F16\u8F91 Word \u6587\u6863\u3002",
+    description: "\u4F7F\u7528\u8BE5\u6280\u80FD\u53EF\u521B\u5EFA\u3001\u8BFB\u53D6\u3001\u7F16\u8F91\u5E76\u91CD\u6784 .docx \u6587\u6863\u3002"
+  },
+  pptx: {
+    summary: "Anthropic \u6280\u80FD\uFF0C\u7528\u4E8E\u6F14\u793A\u6587\u7A3F\u64CD\u4F5C\u3002",
+    description: "\u4F7F\u7528\u8BE5\u6280\u80FD\u53EF\u521B\u5EFA\u3001\u89E3\u6790\u3001\u7F16\u8F91\u5E76\u91CD\u7EC4 .pptx \u6F14\u793A\u6587\u7A3F\u3002"
+  },
+  xlsx: {
+    summary: "Anthropic \u6280\u80FD\uFF0C\u7528\u4E8E\u8868\u683C\u6587\u6863\u5DE5\u4F5C\u6D41\u3002",
+    description: "\u4F7F\u7528\u8BE5\u6280\u80FD\u53EF\u6253\u5F00\u3001\u7F16\u8F91\u3001\u6E05\u6D17\u5E76\u8F6C\u6362 .xlsx \u4E0E .csv \u7B49\u8868\u683C\u6587\u4EF6\u3002"
+  },
+  bird: {
+    summary: "OpenClaw \u793E\u533A\u6280\u80FD\uFF0C\u7528\u4E8E X/Twitter \u8BFB\u53D6/\u641C\u7D22/\u53D1\u5E03\u5DE5\u4F5C\u6D41\u3002",
+    description: "\u4F7F\u7528 bird CLI \u5728\u4EE3\u7406\u5DE5\u4F5C\u6D41\u4E2D\u8BFB\u53D6\u7EBF\u7A0B\u3001\u641C\u7D22\u5E16\u5B50\u5E76\u8D77\u8349\u63A8\u6587/\u56DE\u590D\u3002"
+  },
+  "cloudflare-deploy": {
+    summary: "OpenAI \u7CBE\u9009\u6280\u80FD\uFF0C\u7528\u4E8E\u5728 Cloudflare \u4E0A\u90E8\u7F72\u5E94\u7528\u4E0E\u57FA\u7840\u8BBE\u65BD\u3002",
+    description: "\u4F7F\u7528\u8BE5\u6280\u80FD\u53EF\u9009\u62E9 Cloudflare \u4EA7\u54C1\u5E76\u90E8\u7F72 Workers\u3001Pages \u53CA\u76F8\u5173\u670D\u52A1\u3002"
+  },
+  "channel-plugin-discord": {
+    summary: "NextClaw \u5B98\u65B9\u63D2\u4EF6\uFF0C\u7528\u4E8E Discord \u6E20\u9053\u96C6\u6210\u3002",
+    description: "\u901A\u8FC7 NextClaw \u63D2\u4EF6\u8FD0\u884C\u65F6\u63D0\u4F9B Discord \u6E20\u9053\u7684\u5165\u7AD9/\u51FA\u7AD9\u652F\u6301\u3002"
+  },
+  "channel-plugin-telegram": {
+    summary: "NextClaw \u5B98\u65B9\u63D2\u4EF6\uFF0C\u7528\u4E8E Telegram \u6E20\u9053\u96C6\u6210\u3002",
+    description: "\u901A\u8FC7 NextClaw \u63D2\u4EF6\u8FD0\u884C\u65F6\u63D0\u4F9B Telegram \u6E20\u9053\u7684\u5165\u7AD9/\u51FA\u7AD9\u652F\u6301\u3002"
+  },
+  "channel-plugin-slack": {
+    summary: "NextClaw \u5B98\u65B9\u63D2\u4EF6\uFF0C\u7528\u4E8E Slack \u6E20\u9053\u96C6\u6210\u3002",
+    description: "\u901A\u8FC7 NextClaw \u63D2\u4EF6\u8FD0\u884C\u65F6\u63D0\u4F9B Slack \u6E20\u9053\u7684\u5165\u7AD9/\u51FA\u7AD9\u652F\u6301\u3002"
+  },
+  "channel-plugin-wecom": {
+    summary: "NextClaw \u5B98\u65B9\u63D2\u4EF6\uFF0C\u7528\u4E8E\u4F01\u4E1A\u5FAE\u4FE1\u6E20\u9053\u96C6\u6210\u3002",
+    description: "\u901A\u8FC7 NextClaw \u63D2\u4EF6\u8FD0\u884C\u65F6\u63D0\u4F9B\u4F01\u4E1A\u5FAE\u4FE1\u6E20\u9053\u7684\u5165\u7AD9/\u51FA\u7AD9\u652F\u6301\u3002"
+  },
+  "channel-plugin-email": {
+    summary: "NextClaw \u5B98\u65B9\u63D2\u4EF6\uFF0C\u7528\u4E8E Email \u6E20\u9053\u96C6\u6210\u3002",
+    description: "\u901A\u8FC7 NextClaw \u63D2\u4EF6\u8FD0\u884C\u65F6\u63D0\u4F9B Email \u6E20\u9053\u7684\u5165\u7AD9/\u51FA\u7AD9\u652F\u6301\u3002"
+  },
+  "channel-plugin-whatsapp": {
+    summary: "NextClaw \u5B98\u65B9\u63D2\u4EF6\uFF0C\u7528\u4E8E WhatsApp \u6E20\u9053\u96C6\u6210\u3002",
+    description: "\u901A\u8FC7 NextClaw \u63D2\u4EF6\u8FD0\u884C\u65F6\u63D0\u4F9B WhatsApp \u6E20\u9053\u7684\u5165\u7AD9/\u51FA\u7AD9\u652F\u6301\u3002"
+  },
+  "channel-plugin-clawbay": {
+    summary: "Clawbay \u5B98\u65B9\u6E20\u9053\u63D2\u4EF6\uFF0C\u7528\u4E8E NextClaw \u96C6\u6210\u3002",
+    description: "\u901A\u8FC7\u63D2\u4EF6\u8FD0\u884C\u65F6\u4E3A NextClaw \u63D0\u4F9B Clawbay \u6E20\u9053\u80FD\u529B\u3002"
+  }
+};
+function readLocalizedMap(value) {
+  const localized = {};
+  if (!isRecord(value)) {
+    return localized;
+  }
+  for (const [key, entry] of Object.entries(value)) {
+    if (typeof entry !== "string" || entry.trim().length === 0) {
+      continue;
+    }
+    localized[key] = entry.trim();
+  }
+  return localized;
+}
+function normalizeLocaleTag(value) {
+  return value.trim().toLowerCase().replace(/_/g, "-");
+}
+function pickLocaleFamilyValue(localized, localeFamily) {
+  const normalizedFamily = normalizeLocaleTag(localeFamily).split("-")[0];
+  if (!normalizedFamily) {
+    return void 0;
+  }
+  let familyMatch;
+  for (const [locale, text] of Object.entries(localized)) {
+    const normalizedLocale = normalizeLocaleTag(locale);
+    if (!normalizedLocale) {
+      continue;
+    }
+    if (normalizedLocale === normalizedFamily) {
+      return text;
+    }
+    if (!familyMatch && normalizedLocale.startsWith(`${normalizedFamily}-`)) {
+      familyMatch = text;
+    }
+  }
+  return familyMatch;
+}
+function normalizeLocalizedTextMap(primaryText, localized, zhFallback) {
+  const next = readLocalizedMap(localized);
+  if (!next.en) {
+    next.en = pickLocaleFamilyValue(next, "en") ?? primaryText;
+  }
+  if (!next.zh) {
+    next.zh = pickLocaleFamilyValue(next, "zh") ?? (zhFallback && zhFallback.trim().length > 0 ? zhFallback.trim() : next.en);
+  }
+  return next;
+}
+function normalizeMarketplaceItemForUi(item) {
+  const zhCopy = MARKETPLACE_ZH_COPY_BY_SLUG[item.slug];
+  const next = {
+    ...item,
+    summaryI18n: normalizeLocalizedTextMap(item.summary, item.summaryI18n, zhCopy?.summary)
+  };
+  if ("description" in item && typeof item.description === "string" && item.description.trim().length > 0) {
+    next.descriptionI18n = normalizeLocalizedTextMap(
+      item.description,
+      item.descriptionI18n,
+      zhCopy?.description
+    );
+  }
+  return next;
+}
 function toPositiveInt(raw, fallback) {
   if (!raw) {
     return fallback;
@@ -1314,6 +1596,192 @@ function isSupportedMarketplaceSkillItem(item, knownSkillNames) {
   }
   return item.install.kind === "builtin" && knownSkillNames.has(item.install.spec);
 }
+function splitMarkdownFrontmatter(raw) {
+  const normalized = raw.replace(/\r\n/g, "\n");
+  const match = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match) {
+    return { bodyRaw: normalized };
+  }
+  return {
+    metadataRaw: match[1]?.trim() || void 0,
+    bodyRaw: match[2] ?? ""
+  };
+}
+async function loadLocalSkillMarkdown(options, skillName) {
+  const config = loadConfigOrDefault(options.configPath);
+  const loader = createSkillsLoader(getWorkspacePathFromConfig3(config));
+  if (!loader) {
+    return null;
+  }
+  const skillInfo = loader.listSkills(false).find((skill) => skill.name === skillName);
+  if (!skillInfo) {
+    return null;
+  }
+  try {
+    const raw = await readFile(skillInfo.path, "utf-8");
+    return {
+      raw,
+      source: skillInfo.source
+    };
+  } catch {
+    return null;
+  }
+}
+function parseGitSkillSpec(rawSpec) {
+  const spec = rawSpec.trim();
+  if (!spec) {
+    return null;
+  }
+  const segments = spec.split("/").filter(Boolean);
+  if (segments.length < 3) {
+    return null;
+  }
+  return {
+    owner: segments[0] ?? "",
+    repo: segments[1] ?? "",
+    skillPath: segments.slice(2).join("/")
+  };
+}
+async function fetchTextWithFallback(urls) {
+  for (const url of urls) {
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          Accept: "text/plain, text/markdown, application/json"
+        }
+      });
+      if (!response.ok) {
+        continue;
+      }
+      const text = await response.text();
+      if (text.trim().length === 0) {
+        continue;
+      }
+      return { text, url };
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+async function loadGitSkillMarkdownFromSpec(rawSpec) {
+  const parsed = parseGitSkillSpec(rawSpec);
+  if (!parsed) {
+    return null;
+  }
+  const candidates = [
+    `https://raw.githubusercontent.com/${parsed.owner}/${parsed.repo}/main/${parsed.skillPath}/SKILL.md`,
+    `https://raw.githubusercontent.com/${parsed.owner}/${parsed.repo}/master/${parsed.skillPath}/SKILL.md`
+  ];
+  const result = await fetchTextWithFallback(candidates);
+  if (!result) {
+    return null;
+  }
+  return {
+    raw: result.text,
+    sourceUrl: result.url
+  };
+}
+async function loadPluginReadmeFromNpm(spec) {
+  const encodedSpec = encodeURIComponent(spec);
+  const registryUrl = `https://registry.npmjs.org/${encodedSpec}`;
+  try {
+    const response = await fetch(registryUrl, {
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    if (!response.ok) {
+      return null;
+    }
+    const payload = await response.json();
+    const readme = typeof payload.readme === "string" ? payload.readme : "";
+    const latest = isRecord(payload["dist-tags"]) && typeof payload["dist-tags"].latest === "string" ? payload["dist-tags"].latest : void 0;
+    const metadata = {
+      name: typeof payload.name === "string" ? payload.name : spec,
+      version: latest,
+      description: typeof payload.description === "string" ? payload.description : void 0,
+      homepage: typeof payload.homepage === "string" ? payload.homepage : void 0
+    };
+    if (readme.trim().length === 0) {
+      return null;
+    }
+    return {
+      readme,
+      sourceUrl: registryUrl,
+      metadataRaw: JSON.stringify(metadata, null, 2)
+    };
+  } catch {
+    return null;
+  }
+}
+async function buildSkillContentView(options, item) {
+  const local = await loadLocalSkillMarkdown(options, item.install.spec);
+  if (local) {
+    const split = splitMarkdownFrontmatter(local.raw);
+    return {
+      type: "skill",
+      slug: item.slug,
+      name: item.name,
+      install: item.install,
+      source: local.source,
+      raw: local.raw,
+      metadataRaw: split.metadataRaw,
+      bodyRaw: split.bodyRaw
+    };
+  }
+  if (item.install.kind === "git") {
+    const remote = await loadGitSkillMarkdownFromSpec(item.install.spec);
+    if (remote) {
+      const split = splitMarkdownFrontmatter(remote.raw);
+      return {
+        type: "skill",
+        slug: item.slug,
+        name: item.name,
+        install: item.install,
+        source: "git",
+        raw: remote.raw,
+        metadataRaw: split.metadataRaw,
+        bodyRaw: split.bodyRaw,
+        sourceUrl: remote.sourceUrl
+      };
+    }
+  }
+  return null;
+}
+async function buildPluginContentView(item) {
+  if (item.install.kind === "npm") {
+    const npm = await loadPluginReadmeFromNpm(item.install.spec);
+    if (npm) {
+      return {
+        type: "plugin",
+        slug: item.slug,
+        name: item.name,
+        install: item.install,
+        source: "npm",
+        raw: npm.readme,
+        bodyRaw: npm.readme,
+        metadataRaw: npm.metadataRaw,
+        sourceUrl: npm.sourceUrl
+      };
+    }
+  }
+  return {
+    type: "plugin",
+    slug: item.slug,
+    name: item.name,
+    install: item.install,
+    source: "remote",
+    bodyRaw: item.description || item.summary || "",
+    metadataRaw: JSON.stringify({
+      name: item.name,
+      author: item.author,
+      sourceRepo: item.sourceRepo,
+      homepage: item.homepage
+    }, null, 2)
+  };
+}
 async function fetchAllMarketplaceItems(params) {
   const allItems = [];
   let remotePage = 1;
@@ -1492,7 +1960,7 @@ function registerPluginMarketplaceRoutes(app, options, marketplaceBaseUrl) {
     if (!result.ok) {
       return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
     }
-    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplacePluginItem(item));
+    const filteredItems = result.data.items.map((item) => normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(item))).filter((item) => isSupportedMarketplacePluginItem(item));
     const pageSize = Math.min(100, toPositiveInt(query.pageSize, 20));
     const requestedPage = toPositiveInt(query.page, 1);
     const totalPages = filteredItems.length === 0 ? 0 : Math.ceil(filteredItems.length / pageSize);
@@ -1516,12 +1984,28 @@ function registerPluginMarketplaceRoutes(app, options, marketplaceBaseUrl) {
     if (!result.ok) {
       return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
     }
-    const sanitized = sanitizeMarketplaceItem(result.data);
+    const sanitized = normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(result.data));
     if (!isSupportedMarketplacePluginItem(sanitized)) {
       return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
     }
     return c.json(ok(sanitized));
   });
+  app.get("/api/marketplace/plugins/items/:slug/content", async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: `/api/v1/plugins/items/${slug}`
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const sanitized = normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(result.data));
+    if (!isSupportedMarketplacePluginItem(sanitized)) {
+      return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
+    }
+    const content = await buildPluginContentView(sanitized);
+    return c.json(ok(content));
+  });
   app.post("/api/marketplace/plugins/install", async (c) => {
     const body = await readJson(c.req.raw);
     if (!body.ok || !body.data || typeof body.data !== "object") {
@@ -1585,7 +2069,7 @@ function registerPluginMarketplaceRoutes(app, options, marketplaceBaseUrl) {
     if (!result.ok) {
       return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
     }
-    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplacePluginItem(item));
+    const filteredItems = result.data.items.map((item) => normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(item))).filter((item) => isSupportedMarketplacePluginItem(item));
     return c.json(ok({
       ...result.data,
       total: filteredItems.length,
@@ -1613,7 +2097,7 @@ function registerSkillMarketplaceRoutes(app, options, marketplaceBaseUrl) {
       return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
     }
     const knownSkillNames = collectKnownSkillNames(options);
-    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplaceSkillItem(item, knownSkillNames));
+    const filteredItems = result.data.items.map((item) => normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(item))).filter((item) => isSupportedMarketplaceSkillItem(item, knownSkillNames));
     const pageSize = Math.min(100, toPositiveInt(query.pageSize, 20));
     const requestedPage = toPositiveInt(query.page, 1);
     const totalPages = filteredItems.length === 0 ? 0 : Math.ceil(filteredItems.length / pageSize);
@@ -1638,12 +2122,32 @@ function registerSkillMarketplaceRoutes(app, options, marketplaceBaseUrl) {
       return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
     }
     const knownSkillNames = collectKnownSkillNames(options);
-    const sanitized = sanitizeMarketplaceItem(result.data);
+    const sanitized = normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(result.data));
     if (!isSupportedMarketplaceSkillItem(sanitized, knownSkillNames)) {
       return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
     }
     return c.json(ok(sanitized));
   });
+  app.get("/api/marketplace/skills/items/:slug/content", async (c) => {
+    const slug = encodeURIComponent(c.req.param("slug"));
+    const result = await fetchMarketplaceData({
+      baseUrl: marketplaceBaseUrl,
+      path: `/api/v1/skills/items/${slug}`
+    });
+    if (!result.ok) {
+      return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
+    }
+    const knownSkillNames = collectKnownSkillNames(options);
+    const sanitized = normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(result.data));
+    if (!isSupportedMarketplaceSkillItem(sanitized, knownSkillNames)) {
+      return c.json(err("NOT_FOUND", "marketplace item not supported by nextclaw"), 404);
+    }
+    const content = await buildSkillContentView(options, sanitized);
+    if (!content) {
+      return c.json(err("NOT_FOUND", "skill markdown content not found"), 404);
+    }
+    return c.json(ok(content));
+  });
   app.post("/api/marketplace/skills/install", async (c) => {
     const body = await readJson(c.req.raw);
     if (!body.ok || !body.data || typeof body.data !== "object") {
@@ -1708,7 +2212,7 @@ function registerSkillMarketplaceRoutes(app, options, marketplaceBaseUrl) {
       return c.json(err("MARKETPLACE_UNAVAILABLE", result.message), result.status);
     }
     const knownSkillNames = collectKnownSkillNames(options);
-    const filteredItems = result.data.items.map((item) => sanitizeMarketplaceItem(item)).filter((item) => isSupportedMarketplaceSkillItem(item, knownSkillNames));
+    const filteredItems = result.data.items.map((item) => normalizeMarketplaceItemForUi(sanitizeMarketplaceItem(item))).filter((item) => isSupportedMarketplaceSkillItem(item, knownSkillNames));
     return c.json(ok({
       ...result.data,
       total: filteredItems.length,
@@ -1775,6 +2279,33 @@ function createUiRouter(options) {
     options.publish({ type: "config.updated", payload: { path: `providers.${provider}` } });
     return c.json(ok(result));
   });
+  app.post("/api/config/providers", async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const result = createCustomProvider(
+      options.configPath,
+      body.data
+    );
+    options.publish({ type: "config.updated", payload: { path: `providers.${result.name}` } });
+    return c.json(ok({
+      name: result.name,
+      provider: result.provider
+    }));
+  });
+  app.delete("/api/config/providers/:provider", async (c) => {
+    const provider = c.req.param("provider");
+    const result = deleteCustomProvider(options.configPath, provider);
+    if (result === null) {
+      return c.json(err("NOT_FOUND", `custom provider not found: ${provider}`), 404);
+    }
+    options.publish({ type: "config.updated", payload: { path: `providers.${provider}` } });
+    return c.json(ok({
+      deleted: true,
+      provider
+    }));
+  });
   app.post("/api/config/providers/:provider/test", async (c) => {
     const provider = c.req.param("provider");
     const body = await readJson(c.req.raw);
@@ -2153,7 +2684,7 @@ function startUiServer(options) {
         join,
         getContent: async (path) => {
           try {
-            return await readFile(path);
+            return await readFile2(path);
           } catch {
             return null;
           }
@@ -2203,7 +2734,9 @@ export {
   buildConfigMeta,
   buildConfigSchemaView,
   buildConfigView,
+  createCustomProvider,
   createUiRouter,
+  deleteCustomProvider,
   deleteSession,
   executeConfigAction,
   getSessionHistory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.25",
+  "version": "0.5.27",
   "private": false,
   "description": "Nextclaw UI/API server.",
   "type": "module",
@@ -15,10 +15,10 @@
   ],
   "dependencies": {
     "@hono/node-server": "^1.13.3",
-    "@nextclaw/openclaw-compat": "^0.1.30",
+    "@nextclaw/openclaw-compat": "^0.1.32",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.39"
+    "@nextclaw/core": "^0.6.43"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",