nolo-cli 0.1.26 → 0.1.30

package/server/html/ssrPreload.ts

@@ -0,0 +1,247 @@
+// packages/server/html/ssrPreload.ts
+// 职责：根据当前请求路径预取 SSR 数据，并返回页面级 SEO 覆盖信息。
+
+import { createAppStore } from "../../app/store";
+import serverDb, { ensureServerDbOpen } from "../../database/server/db";
+import { upsertSSREntity } from "../../database/dbSlice";
+import { fetchPublicAgents } from "../../ai/agent/server/fetchPublicAgents";
+import { setSSRPublicAgents } from "../../ai/agent/agentSlice";
+import { fetchCommunityShares } from "../../share/server/fetchCommunityShares";
+import { setSSRCommunityShares } from "../../share/shareSlice";
+import { isTombstoneRecord } from "../../database/tombstones";
+import { readSharedTablePreview } from "../../share/server/readSharedTable";
+import { resolveSharePaidAccess } from "../../share/paidAccess";
+import { DESKTOP_RELEASE_MANIFEST_DB_KEY } from "../../app/constants/desktopReleaseManifest";
+import { readDesktopReleaseManifest } from "./desktopReleaseManifest.server";
+import { noloAgentId } from "../../core/init";
+
+const HOME_PUBLIC_AGENTS_CACHE_TTL_MS = 15 * 1000;
+let cachedHomePublicAgents:
+  | {
+      key: string;
+      data: Awaited<ReturnType<typeof fetchPublicAgents>>;
+      cachedAt: number;
+    }
+  | null = null;
+let cachedHomeDefaultAgent:
+  | {
+      data: any;
+      cachedAt: number;
+    }
+  | null = null;
+
+const readHomePublicAgents = async (args: { imageOutputOnly: boolean }) => {
+  const key = args.imageOutputOnly ? "visual-output" : "default";
+  const now = Date.now();
+  if (
+    cachedHomePublicAgents?.key === key &&
+    now - cachedHomePublicAgents.cachedAt < HOME_PUBLIC_AGENTS_CACHE_TTL_MS
+  ) {
+    return cachedHomePublicAgents.data;
+  }
+
+  const data = await fetchPublicAgents({
+    limit: 9,
+    sortBy: "recommended",
+    imageOutputOnly: args.imageOutputOnly,
+    summary: true,
+  });
+  cachedHomePublicAgents = { key, data, cachedAt: now };
+  return data;
+};
+
+const SENSITIVE_AGENT_SSR_FIELDS = new Set([
+  "apiKey",
+  "KEY",
+  "apiKeyHeader",
+  "apiKeyFromAgentKey",
+  "customProviderUrl",
+]);
+
+const redactAgentForSSR = (agentData: any) => {
+  if (!agentData || typeof agentData !== "object") return null;
+  const safeAgent: Record<string, unknown> = { ...agentData };
+  for (const field of SENSITIVE_AGENT_SSR_FIELDS) {
+    delete safeAgent[field];
+  }
+  safeAgent.__ssrPreviewOnly = true;
+  return safeAgent;
+};
+
+const readHomeDefaultAgent = async () => {
+  const now = Date.now();
+  if (
+    cachedHomeDefaultAgent &&
+    now - cachedHomeDefaultAgent.cachedAt < HOME_PUBLIC_AGENTS_CACHE_TTL_MS
+  ) {
+    return cachedHomeDefaultAgent.data;
+  }
+
+  await ensureServerDbOpen();
+  const agentData = await serverDb.get(noloAgentId).catch(() => null);
+  if (!agentData || isTombstoneRecord(agentData) || !agentData.isPublic) {
+    cachedHomeDefaultAgent = { data: null, cachedAt: now };
+    return null;
+  }
+
+  const safeAgent = redactAgentForSSR(agentData);
+  cachedHomeDefaultAgent = { data: safeAgent, cachedAt: now };
+  return safeAgent;
+};
+
+const redactPaidShareForSSR = (shareData: any) => {
+  if (resolveSharePaidAccess(shareData).mode !== "product") {
+    return shareData;
+  }
+
+  return {
+    ...shareData,
+    data: {},
+    meta: {
+      ...(shareData?.meta ?? {}),
+      previewLocked: true,
+      requiresPurchase: true,
+    },
+  };
+};
+
+export interface SeoData {
+  lang: string;
+  title: string;
+  description: string;
+  url: string;
+  image?: string;
+}
+
+/**
+ * 根据路径预取页面数据到 store，并返回页面级 SEO 字段（覆盖默认值）。
+ * 所有预取失败均只 warn，不影响 SSR 主流程。
+ */
+export async function preloadSSRData(
+  store: ReturnType<typeof createAppStore>,
+  url: URL,
+  seoData: SeoData
+): Promise<SeoData> {
+  const { pathname } = url;
+
+  if (pathname === "/downloads") {
+    try {
+      const manifest = await readDesktopReleaseManifest();
+      if (manifest) {
+        store.dispatch(
+          upsertSSREntity({
+            dbKey: DESKTOP_RELEASE_MANIFEST_DB_KEY,
+            type: DESKTOP_RELEASE_MANIFEST_DB_KEY,
+            data: manifest,
+          }),
+        );
+      }
+    } catch (e) {
+      console.warn("SSR preload desktop release manifest failed:", e);
+    }
+    return seoData;
+  }
+
+  // 首页：AI 广场 Agent 列表
+  if (pathname === "/") {
+    try {
+      const imageOutputOnly = url.searchParams.get("visualOutput") === "1";
+      const res = await readHomePublicAgents({ imageOutputOnly });
+      store.dispatch(setSSRPublicAgents(res.data || []));
+    } catch (e) {
+      console.warn("SSR preload home public agents failed:", e);
+    }
+    try {
+      const defaultAgent = await readHomeDefaultAgent();
+      if (defaultAgent) {
+        store.dispatch(upsertSSREntity({ ...defaultAgent, dbKey: noloAgentId }));
+      }
+    } catch (e) {
+      console.warn("SSR preload home default agent failed:", e);
+    }
+    return seoData;
+  }
+
+  // Agent 详情页：/agent-xxx 或 /cybot-xxx
+  const agentPathMatch = pathname.match(/^\/((?:agent|cybot)-[^/]+)$/);
+  if (agentPathMatch) {
+    const agentKey = agentPathMatch[1];
+    try {
+      await ensureServerDbOpen();
+      let agentData: any = null;
+      let resolvedKey = agentKey;
+      try { agentData = await serverDb.get(agentKey); } catch (_) {}
+      if (!agentData && agentKey.startsWith("agent-")) {
+        resolvedKey = agentKey.replace("agent-", "cybot-");
+        try { agentData = await serverDb.get(resolvedKey); } catch (_) {}
+      }
+      if (agentData && !isTombstoneRecord(agentData)) {
+        store.dispatch(upsertSSREntity({ ...agentData, dbKey: resolvedKey }));
+        if (agentData.name) {
+          return {
+            ...seoData,
+            title: `${agentData.name} | Nolo.Chat`,
+            description:
+              agentData.greeting ||
+              agentData.prompt?.slice(0, 150) ||
+              seoData.description,
+          };
+        }
+      }
+    } catch (e) {
+      console.warn("SSR preload agent page failed:", e);
+    }
+    return seoData;
+  }
+
+  // 社区分享列表页：/share/community
+  if (pathname === "/share/community") {
+    try {
+      const sharesRes = await fetchCommunityShares({ limit: 30 });
+      store.dispatch(setSSRCommunityShares(sharesRes));
+    } catch (e) {
+      console.warn("SSR preload community shares failed:", e);
+    }
+    return seoData;
+  }
+
+  // 分享详情页：/share/:token（持有链接即可访问，不限 community）
+  const sharePathMatch = pathname.match(/^\/share\/([^/]+)$/);
+  if (sharePathMatch) {
+    const shareToken = sharePathMatch[1];
+    const dbKey = `share-${shareToken}`;
+    try {
+      await ensureServerDbOpen();
+      const shareData = await serverDb.get(dbKey).catch(() => null);
+      if (shareData && !isTombstoneRecord(shareData)) {
+        let safeShareData = redactPaidShareForSSR(shareData);
+        if (safeShareData.type === "table" && safeShareData.data?.mode === "live") {
+          const tablePreview = await readSharedTablePreview(shareToken, {
+            currentOrigin: url.origin,
+          });
+          if (tablePreview) {
+            safeShareData = {
+              ...safeShareData,
+              data: {
+                ...(safeShareData.data ?? {}),
+                tablePreview,
+              },
+            };
+          }
+        }
+        store.dispatch(upsertSSREntity({ ...safeShareData, dbKey }));
+        const meta = safeShareData.meta;
+        return {
+          ...seoData,
+          title: meta?.title ? `${meta.title} | Nolo.Chat` : seoData.title,
+          description: meta?.description || seoData.description,
+          ...(meta?.coverImage ? { image: meta.coverImage } : {}),
+        };
+      }
+    } catch (e) {
+      console.warn("SSR preload share detail failed:", e);
+    }
+  }
+
+  return seoData;
+}

package/server/html/template.ts

@@ -0,0 +1,275 @@
+// src/server/html/template.js
+
+import {
+  DEFAULT_THEME_NAME,
+  MODE_COLORS,
+  SPACE,
+  THEME_COLORS,
+  THEME_NAME_ALIASES,
+} from "../../app/theme/theme.config";
+
+/**
+ * 生成包含完整SEO优化的HTML文档起始部分。
+ * @param {object} seo - SEO相关的属性
+ * @param {string} seo.lang - 页面语言 (e.g., "zh-CN", "en")
+ * @param {string} seo.title - 页面标题
+ * @param {string} seo.description - 页面描述
+ * @param {string} [seo.url] - 页面规范URL，用于 canonical / og:url
+ * @param {string} [seo.image] - 页面 OG 图片 URL
+ * @param {string} bootstrapCss - Bootstrap CSS文件的路径。
+ * @param {string} scriptNonce - CSP nonce，用于允许当前请求的内联脚本执行。
+ * @returns {string} HTML字符串。
+ */
+export const htmlStart = (
+  {
+    lang,
+    title,
+    description,
+    url = "https://nolo.chat",
+    image = "https://nolo.chat/public/nolo-og-card-zh.jpg",
+  }: {
+    lang: string;
+    title: string;
+    description: string;
+    url?: string;
+    image?: string;
+  },
+  bootstrapCss: string,
+  scriptNonce: string
+) => {
+  const escapeHtml = (value: unknown) =>
+    String(value ?? "")
+      .replaceAll("&", "&")
+      .replaceAll("<", "&lt;")
+      .replaceAll(">", "&gt;")
+      .replaceAll('"', "&quot;")
+      .replaceAll("'", "&#39;");
+
+  const serializeJsonForScript = (value: unknown) =>
+    JSON.stringify(value)
+      .replaceAll("<", "\\u003c")
+      .replaceAll(">", "\\u003e")
+      .replaceAll("&", "\\u0026");
+
+  const safeLang = escapeHtml(lang);
+  const safeTitle = escapeHtml(title);
+  const safeDescription = escapeHtml(description);
+  const safeUrl = escapeHtml(url);
+  const safeImage = escapeHtml(image);
+  const safeBootstrapCss = escapeHtml(bootstrapCss);
+  const safeScriptNonce = escapeHtml(scriptNonce);
+  const themeBootstrapData = serializeJsonForScript({
+    defaultThemeName: DEFAULT_THEME_NAME,
+    themeColors: THEME_COLORS,
+    themeAliases: THEME_NAME_ALIASES,
+    modeColors: MODE_COLORS,
+    compactSpace: SPACE,
+  });
+
+  const structuredData = serializeJsonForScript({
+    "@context": "https://schema.org",
+    "@type": "SoftwareApplication",
+    name: "Nolo.Chat",
+    applicationCategory: "ProductivityApplication",
+    operatingSystem: "Web",
+    description: String(description ?? ""),
+    offers: {
+      "@type": "Offer",
+      price: "0",
+      priceCurrency: "USD",
+    },
+    creator: {
+      "@type": "Organization",
+      name: "Nolo.Chat",
+      url: "https://nolo.chat",
+    },
+  });
+
+  return `
+  <!DOCTYPE html>
+  <html lang="${safeLang}">
+  <head>
+    <meta charSet="UTF-8" />
+    <title>${safeTitle}</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover" />
+    <meta name="description" content="${safeDescription}" />
+    <meta name="keywords" content="AI, Agent, 自定义Agent, 智能助理, AI聊天, 代码生成, 文件上传, nolo, nolo.chat" />
+    <meta name="author" content="Nolo.Chat Team" />
+    <link rel="canonical" href="${safeUrl}" />
+
+    <link rel="icon" href="/public/favicon.svg" type="image/svg+xml" />
+
+    <meta property="og:title" content="${safeTitle}" />
+    <meta property="og:description" content="${safeDescription}" />
+    <meta property="og:url" content="${safeUrl}" />
+    <meta property="og:site_name" content="Nolo.Chat" />
+    <meta property="og:image" content="${safeImage}" />
+    <meta property="og:type" content="website" />
+
+    <meta name="robots" content="index, follow" />
+    <meta name="theme-color" content="#1677ff" />
+
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content="${safeTitle}" />
+    <meta name="twitter:description" content="${safeDescription}" />
+    <meta name="twitter:image" content="${safeImage}" />
+    <meta name="twitter:site" content="@nolodotchat" />
+
+    <script nonce="${safeScriptNonce}" type="application/ld+json">
+      ${structuredData}
+    </script>
+
+    <script nonce="${safeScriptNonce}">
+      (function(){try{
+        var t=localStorage.getItem('nolo-theme-mode');
+        if(!t||t==='system')t=window.matchMedia('(prefers-color-scheme:dark)').matches?'dark':'light';
+        document.documentElement.setAttribute('data-theme',t);
+        var d=localStorage.getItem('nolo-density');
+        if(d==='compact'||d==='spacious')document.documentElement.setAttribute('data-density',d);
+        var themeData=${themeBootstrapData};
+        var themeName=localStorage.getItem('nolo-theme-name');
+        var themeExplicit=localStorage.getItem('nolo-theme-name-explicit')==='1';
+        var isDark=t==='dark';
+        function hexToRgbString(value){
+          if(typeof value!=='string') return null;
+          var normalized=value.trim().replace(/^#/,'');
+          var safe=normalized.length===3
+            ? normalized.split('').map(function(char){return char+char;}).join('')
+            : normalized;
+          if(!/^[0-9a-fA-F]{6}$/.test(safe)) return null;
+          var intValue=parseInt(safe,16);
+          var r=(intValue>>16)&255;
+          var g=(intValue>>8)&255;
+          var b=intValue&255;
+          return r+', '+g+', '+b;
+        }
+        function alphaColor(hex,alpha,fallback){
+          var rgb=hexToRgbString(hex);
+          return rgb?'rgba('+rgb+', '+alpha+')':fallback;
+        }
+        function generateCssVariables(obj,prefix){
+          return Object.entries(obj).flatMap(function(entry){
+            var key=entry[0];
+            var value=entry[1];
+            var name=prefix?prefix+'-'+key:key;
+            if(typeof value==='object'&&value!==null&&!Array.isArray(value)){
+              return generateCssVariables(value,name);
+            }
+            return value!=null?['--'+name+':'+value+';']:[];
+          });
+        }
+        function generateCssString(theme){
+          return ':root { '+generateCssVariables(theme).join(' ')+' }';
+        }
+        function resolveThemeName(value){
+          if(typeof value!=='string') return themeData.defaultThemeName;
+          var canonicalName=themeData.themeAliases[value]||value;
+          if(!(canonicalName in themeData.themeColors)) return themeData.defaultThemeName;
+          if(themeExplicit||canonicalName===themeData.defaultThemeName||canonicalName!=='neutral') return canonicalName;
+          return themeData.defaultThemeName;
+        }
+        function buildThemeCss(name,isDarkMode,density){
+          var mode=isDarkMode?'dark':'light';
+          var validThemeName=resolveThemeName(name);
+          var baseColors=themeData.modeColors[mode];
+          var themeColors=themeData.themeColors[validThemeName][mode];
+          var c=Object.assign({},baseColors,themeColors);
+          var compact=density==='compact';
+          var space=compact
+            ? themeData.compactSpace
+            : {0:'0',1:'5px',2:'10px',3:'14px',4:'20px',5:'24px',6:'30px',7:'34px',8:'40px',10:'50px',12:'60px',14:'70px',16:'80px',20:'100px',24:'120px'};
+          return generateCssString({
+            sidebarWidth:'320px',
+            headerHeight:'56px',
+            sidebarItemHeight:compact?'36px':'40px',
+            sidebarIconSize:compact?'18px':'20px',
+            sidebarItemGap:compact?'2px':'4px',
+            space:space,
+            fontSize:{
+              xs:compact?'11px':'12px',
+              sm:compact?'12px':'13px',
+              base:compact?'14px':'15px',
+              md:compact?'14px':'15.5px',
+              lg:compact?'16px':'17.5px',
+              xl:compact?'20px':'22px',
+              '2xl':compact?'24px':'26px',
+            },
+            leading:{
+              tight:compact?'1.3':'1.4',
+              normal:compact?'1.45':'1.6',
+              relaxed:compact?'1.6':'1.75',
+            },
+            control:{
+              xs:compact?'24px':'28px',
+              sm:compact?'28px':'32px',
+              md:compact?'36px':'40px',
+              lg:compact?'40px':'46px',
+              xl:compact?'48px':'56px',
+            },
+            radius:{
+              sm:compact?'4px':'6px',
+              md:compact?'8px':'10px',
+              lg:compact?'12px':'14px',
+              xl:compact?'16px':'20px',
+            },
+            ...c,
+            borderSubtle:c.borderLight,
+            borderFaint:alphaColor(c.border,isDarkMode?0.22:0.35,c.borderLight),
+            borderStrong:c.borderHover,
+            surface:c.backgroundSecondary,
+            surfaceElevated:c.backgroundTertiary,
+            surfaceCanvas:c.background,
+            surfaceSidebar:isDarkMode?c.backgroundSecondary:c.background,
+            surfacePanel:c.backgroundSecondary,
+            surfaceCard:c.messageBackground,
+            surfaceRaised:isDarkMode?c.backgroundTertiary:c.backgroundSecondary,
+            surfaceInset:isDarkMode?c.backgroundSecondary:alphaColor(c.borderHover,0.05,c.codeBackground),
+            surfaceCode:c.codeBackground,
+            surfaceInteractive:c.backgroundTertiary,
+            surfaceInteractiveHover:c.backgroundHover,
+            textMuted:c.textSecondary,
+            textSubtle:c.textTertiary,
+            textHeading:c.textHeading||c.text,
+            borderMuted:alphaColor(c.borderHover,isDarkMode?0.3:0.24,c.borderLight),
+            accentSoft:alphaColor(c.primary,isDarkMode?0.18:0.1,c.primaryGhost),
+            shadow:c.shadowMedium,
+            shadow1:'0 1px 2px '+c.shadowLight,
+            shadow2:'0 8px 24px -12px '+c.shadowMedium,
+            shadow3:'0 18px 44px -24px '+c.shadowHeavy,
+            primaryBorder:c.borderAccent||c.primary,
+            primaryBgStrong:alphaColor(c.primary,isDarkMode?0.18:0.1,c.primaryGhost),
+            success:c.success,
+            warning:c.warning,
+            info:c.info,
+            successGhost:alphaColor(c.success,isDarkMode?0.2:0.12,'rgba(16, 185, 129, 0.12)'),
+            warningGhost:alphaColor(c.warning,isDarkMode?0.2:0.12,'rgba(245, 158, 11, 0.12)'),
+            infoGhost:alphaColor(c.info,isDarkMode?0.2:0.12,'rgba(59, 130, 246, 0.12)'),
+            errorGhost:alphaColor(c.error,isDarkMode?0.2:0.12,'rgba(239, 68, 68, 0.12)'),
+            primaryRgb:hexToRgbString(c.primary)||'59, 130, 246',
+            focusRing:alphaColor(c.primary,isDarkMode?0.3:0.22,c.primaryGhost),
+          });
+        }
+        if(themeName==='neutral'&&!themeExplicit){
+          localStorage.removeItem('nolo-theme-name');
+        }
+        var css=buildThemeCss(themeName,isDark,d||'compact');
+        if(css){var s=document.createElement('style');s.id='global-theme-variables';s.textContent=css;document.head.appendChild(s);}
+      }catch(e){}})();
+    </script>
+    
+    <link rel="stylesheet" href="${safeBootstrapCss}">
+    <script nonce="${safeScriptNonce}">
+      function $U(h, s) {
+        document.getElementById(h)?.remove();
+        document.getElementById(h.replace('ST', 'SR'))?.remove();
+      }
+    </script>
+  </head>
+  <body>
+`;
+};
+
+export const htmlEnd = `
+  </body>
+</html>
+`;

package/server/httpCompression.ts

@@ -0,0 +1,102 @@
+import { isProduction } from "../app/utils/env";
+
+const MIN_COMPRESS_SIZE = 1024;
+const COMPRESSIBLE_TYPES = [
+  /^text\//i,
+  /^application\/(javascript|json|xml|xhtml\+xml)(?:;|$)/i,
+  /^image\/svg\+xml(?:;|$)/i,
+];
+
+const appendVary = (headers: Headers, value: string) => {
+  const current = headers.get("Vary");
+  if (!current) {
+    headers.set("Vary", value);
+    return;
+  }
+
+  const normalized = current
+    .split(",")
+    .map((part) => part.trim().toLowerCase())
+    .filter(Boolean);
+
+  if (!normalized.includes(value.toLowerCase())) {
+    headers.set("Vary", `${current}, ${value}`);
+  }
+};
+
+const getAcceptedEncodings = (request: Request) =>
+  new Set(
+    (request.headers.get("accept-encoding") ?? "")
+      .toLowerCase()
+      .split(",")
+      .map((part) => part.trim().split(";")[0])
+      .filter(Boolean)
+  );
+
+const selectCompression = (request: Request) => {
+  const accepted = getAcceptedEncodings(request);
+  if (accepted.has("br")) {
+    return { streamFormat: "brotli", contentEncoding: "br" } as const;
+  }
+  if (accepted.has("gzip")) {
+    return { streamFormat: "gzip", contentEncoding: "gzip" } as const;
+  }
+  return null;
+};
+
+const isCompressibleContentType = (contentType: string | null) =>
+  !!contentType &&
+  COMPRESSIBLE_TYPES.some((pattern) => pattern.test(contentType));
+
+type CompressionOptions = {
+  enabled?: boolean;
+};
+
+export const maybeCompressResponse = (
+  request: Request,
+  response: Response,
+  options: CompressionOptions = {}
+) => {
+  const enabled = options.enabled ?? isProduction;
+  if (!enabled || typeof CompressionStream === "undefined") {
+    return response;
+  }
+
+  if (response.status < 200 || response.status >= 300) {
+    return response;
+  }
+
+  const contentType = response.headers.get("content-type");
+  const contentLengthHeader = response.headers.get("content-length");
+  const contentLength = contentLengthHeader ? Number(contentLengthHeader) : null;
+  const compression = selectCompression(request);
+
+  if (
+    response.headers.has("content-encoding") ||
+    response.headers.has("content-range") ||
+    !compression ||
+    !isCompressibleContentType(contentType) ||
+    (contentLength !== null && Number.isFinite(contentLength) && contentLength < MIN_COMPRESS_SIZE)
+  ) {
+    return response;
+  }
+
+  const headers = new Headers(response.headers);
+  appendVary(headers, "Accept-Encoding");
+  headers.set("content-encoding", compression.contentEncoding);
+  headers.delete("content-length");
+
+  if (request.method === "HEAD" || !response.body) {
+    return new Response(null, {
+      status: response.status,
+      statusText: response.statusText,
+      headers,
+    });
+  }
+
+  return new Response(response.body.pipeThrough(new CompressionStream(compression.streamFormat)), {
+    status: response.status,
+    statusText: response.statusText,
+    headers,
+  });
+};