@nextclaw/server 0.5.24 → 0.5.26

package/dist/index.d.ts

@@ -387,12 +387,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 +402,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;
@@ -610,4 +635,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 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 };

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",
@@ -60,22 +61,12 @@ var PREFERRED_PROVIDER_ORDER_INDEX = new Map(
   PREFERRED_PROVIDER_ORDER.map((name, index) => [name, index])
 );
 var DOCS_BASE_URL = "https://docs.nextclaw.io";
-var CHANNEL_DEFAULT_TUTORIAL_URL = `${DOCS_BASE_URL}/guide/channels`;
 var CHANNEL_TUTORIAL_URLS = {
-  telegram: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  whatsapp: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  discord: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
   feishu: {
     default: `${DOCS_BASE_URL}/guide/tutorials/feishu`,
     en: `${DOCS_BASE_URL}/en/guide/tutorials/feishu`,
     zh: `${DOCS_BASE_URL}/zh/guide/tutorials/feishu`
-  },
-  mochat: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  dingtalk: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  wecom: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  email: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  slack: { default: CHANNEL_DEFAULT_TUTORIAL_URL },
-  qq: { default: CHANNEL_DEFAULT_TUTORIAL_URL }
+  }
 };
 function matchesExtraSensitivePath(path) {
   if (path === "session" || path.startsWith("session.")) {
@@ -378,8 +369,8 @@ function buildConfigMeta(config) {
     return left.name.localeCompare(right.name);
   });
   const channels = Object.keys(config.channels).map((name) => {
-    const tutorialUrls = CHANNEL_TUTORIAL_URLS[name] ?? { default: CHANNEL_DEFAULT_TUTORIAL_URL };
-    const tutorialUrl = tutorialUrls.default ?? tutorialUrls.en ?? tutorialUrls.zh;
+    const tutorialUrls = CHANNEL_TUTORIAL_URLS[name];
+    const tutorialUrl = tutorialUrls?.default ?? tutorialUrls?.en ?? tutorialUrls?.zh;
     return {
       name,
       displayName: name,
@@ -1297,6 +1288,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;
@@ -1324,6 +1450,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;
@@ -1502,7 +1814,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);
@@ -1526,12 +1838,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") {
@@ -1595,7 +1923,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,
@@ -1623,7 +1951,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);
@@ -1648,12 +1976,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") {
@@ -1718,7 +2066,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,
@@ -2163,7 +2511,7 @@ function startUiServer(options) {
         join,
         getContent: async (path) => {
           try {
-            return await readFile(path);
+            return await readFile2(path);
           } catch {
             return null;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/server",
-  "version": "0.5.24",
+  "version": "0.5.26",
   "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.31",
     "hono": "^4.6.2",
     "ws": "^8.18.0",
-    "@nextclaw/core": "^0.6.39"
+    "@nextclaw/core": "^0.6.42"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",