@lobehub/lobehub 2.0.0-next.291 → 2.0.0-next.293

package/src/libs/swr/index.ts

@@ -1,23 +1,13 @@
 import useSWR, { type SWRHook } from 'swr';
-import useSWRMutation from 'swr/mutation';
 
 /**
- * This type of request method is relatively flexible data, which will be triggered on the first time
+ * This type of request method is for relatively flexible data, which will be triggered on the first time.
  *
  * Refresh rules have two types:
- *
- * - when the user refocuses, it will be refreshed outside the 5mins interval.
- * - can be combined with refreshXXX methods to refresh data
+ * - When the user refocuses, it will be refreshed outside the 5mins interval.
+ * - Can be combined with refreshXXX methods to refresh data.
  *
  * Suitable for messages, topics, sessions, and other data that users will interact with on the client.
- *
- * 这一类请求方法是相对灵活的数据，会在请求时触发
- *
- * 刷新规则有两种：
- * - 当用户重新聚焦时，在 5mins 间隔外会重新刷新一次
- * - 可以搭配 refreshXXX 这样的方法刷新数据
- *
- * 适用于 messages、topics、sessions 等用户会在客户端交互的数据
  */
 // @ts-ignore
 export const useClientDataSWR: SWRHook = (key, fetch, config) =>
@@ -47,11 +37,8 @@ export const useClientDataSWR: SWRHook = (key, fetch, config) =>
   });
 
 /**
- * This type of request method is relatively "dead" request mode, which will only be triggered on the first request.
- * it suitable for first time request like `initUserState`
-
- * 这一类请求方法是相对"死"的请求模式，只会在第一次请求时触发。
- * 适用于第一次请求，例如 `initUserState`
+ * This type of request method is a relatively "static" request mode, which will only be triggered on the first request.
+ * Suitable for first time requests like `initUserState`.
  */
 // @ts-ignore
 export const useOnlyFetchOnceSWR: SWRHook = (key, fetch, config) =>
@@ -63,18 +50,27 @@ export const useOnlyFetchOnceSWR: SWRHook = (key, fetch, config) =>
   });
 
 /**
- * 这一类请求方法用于做操作触发，必须使用 mutate 来触发请求操作，好处是自带了 loading / error 状态。
- * 可以很简单地完成 loading / error 态的交互处理，同时，相同 swr key 的请求会自动共享 loading 态（例如新建助理按钮和右上角的 + 号）
- * 非常适用于新建等操作。
+ * This type of request method is for action triggers. Must use mutate to trigger the request.
+ * Benefits: built-in loading/error states, easy to handle loading/error UI interactions.
+ * Components with the same SWR key will automatically share loading state (e.g., create agent button and the + button in header).
+ * Very suitable for create operations.
  *
- * 使用 useSWRMutation 而非 useSWR，因为 useSWR 即使设置了 revalidateOnMount: false，
- * 在缓存为空时仍会自动调用 fetcher。而 useSWRMutation 只会在手动调用 trigger 时执行。
+ * Uses fallbackData as empty object so SWR thinks initial data exists.
+ * Combined with revalidateOnMount: false, this prevents auto-fetch on mount.
  */
-export const useActionSWR = <T>(key: string | any[], fetcher: () => Promise<T>, config?: any) => {
-  const { trigger, isMutating, ...rest } = useSWRMutation(key, fetcher, config);
-  // Return with legacy property names for backward compatibility
-  return { ...rest, isValidating: isMutating, mutate: trigger };
-};
+// @ts-ignore
+export const useActionSWR: SWRHook = (key, fetch, config) =>
+  useSWR(key, fetch, {
+    // Use empty object as fallback to prevent auto-fetch when cache is empty
+    // Combined with revalidateOnMount: false, SWR won't call fetcher on mount
+    fallbackData: {},
+    refreshWhenHidden: false,
+    refreshWhenOffline: false,
+    revalidateOnFocus: false,
+    revalidateOnMount: false,
+    revalidateOnReconnect: false,
+    ...config,
+  });
 
 export interface SWRRefreshParams<T, A = (...args: any[]) => any> {
   action: A;
@@ -85,8 +81,8 @@ export type SWRefreshMethod<T> = <A extends (...args: any[]) => Promise<any>>(
   params?: SWRRefreshParams<T, A>,
 ) => ReturnType<A>;
 
-// 导出带自动同步功能的 hook
+// Export hook with auto-sync functionality
 export { useClientDataSWRWithSync } from './useClientDataSWRWithSync';
 
-// 导出 scoped mutate（用于自定义 cache provider 场景）
+// Export scoped mutate (for custom cache provider scenarios)
 export { mutate, setScopedMutate } from './mutate';

package/src/server/services/desktopRelease/index.test.ts

@@ -0,0 +1,65 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  type DesktopDownloadType,
+  resolveDesktopDownload,
+  resolveDesktopDownloadFromUrls,
+} from './index';
+
+const mockRelease = {
+  assets: [
+    {
+      browser_download_url: 'https://example.com/LobeHub-2.0.0-arm64.dmg',
+      name: 'LobeHub-2.0.0-arm64.dmg',
+    },
+    {
+      browser_download_url: 'https://example.com/LobeHub-2.0.0-x64.dmg',
+      name: 'LobeHub-2.0.0-x64.dmg',
+    },
+    {
+      browser_download_url: 'https://example.com/LobeHub-2.0.0-setup.exe',
+      name: 'LobeHub-2.0.0-setup.exe',
+    },
+    {
+      browser_download_url: 'https://example.com/LobeHub-2.0.0.AppImage',
+      name: 'LobeHub-2.0.0.AppImage',
+    },
+  ],
+  published_at: '2026-01-01T00:00:00.000Z',
+  tag_name: 'v2.0.0',
+};
+
+describe('desktopRelease', () => {
+  it.each([
+    ['mac-arm', 'LobeHub-2.0.0-arm64.dmg'],
+    ['mac-intel', 'LobeHub-2.0.0-x64.dmg'],
+    ['windows', 'LobeHub-2.0.0-setup.exe'],
+    ['linux', 'LobeHub-2.0.0.AppImage'],
+  ] as Array<[DesktopDownloadType, string]>)(
+    'resolveDesktopDownload(%s)',
+    (type, expectedAssetName) => {
+      const resolved = resolveDesktopDownload(mockRelease as any, type);
+      expect(resolved?.assetName).toBe(expectedAssetName);
+      expect(resolved?.version).toBe('2.0.0');
+      expect(resolved?.tag).toBe('v2.0.0');
+      expect(resolved?.type).toBe(type);
+      expect(resolved?.url).toContain(expectedAssetName);
+    },
+  );
+
+  it('resolveDesktopDownloadFromUrls should match basename', () => {
+    const resolved = resolveDesktopDownloadFromUrls({
+      publishedAt: '2026-01-01T00:00:00.000Z',
+      tag: 'v2.0.0',
+      type: 'windows',
+      urls: [
+        'https://releases.example.com/stable/2.0.0/LobeHub-2.0.0-setup.exe?download=1',
+        'https://releases.example.com/stable/2.0.0/LobeHub-2.0.0-x64.dmg',
+      ],
+      version: '2.0.0',
+    });
+
+    expect(resolved?.assetName).toBe('LobeHub-2.0.0-setup.exe');
+    expect(resolved?.url).toContain('setup.exe');
+  });
+});

package/src/server/services/desktopRelease/index.ts

@@ -0,0 +1,208 @@
+import urlJoin from 'url-join';
+import { parse } from 'yaml';
+
+import { FetchCacheTag } from '@/const/cacheControl';
+
+export type DesktopDownloadType = 'linux' | 'mac-arm' | 'mac-intel' | 'windows';
+
+export interface DesktopDownloadInfo {
+  assetName: string;
+  publishedAt?: string;
+  tag: string;
+  type: DesktopDownloadType;
+  url: string;
+  version: string;
+}
+
+type GithubReleaseAsset = {
+  browser_download_url: string;
+  name: string;
+};
+
+type GithubRelease = {
+  assets: GithubReleaseAsset[];
+  published_at?: string;
+  tag_name: string;
+};
+
+type UpdateServerManifestFile = {
+  url: string;
+};
+
+type UpdateServerManifest = {
+  files?: UpdateServerManifestFile[];
+  path?: string;
+  releaseDate?: string;
+  version?: string;
+};
+
+const getBasename = (pathname: string) => {
+  const cleaned = pathname.split('?')[0] || '';
+  const lastSlash = cleaned.lastIndexOf('/');
+  return lastSlash >= 0 ? cleaned.slice(lastSlash + 1) : cleaned;
+};
+
+const isAbsoluteUrl = (value: string) => /^https?:\/\//i.test(value);
+
+const buildTypeMatchers = (type: DesktopDownloadType) => {
+  switch (type) {
+    case 'mac-arm': {
+      return [/-arm64\.dmg$/i, /-arm64-mac\.zip$/i, /-arm64\.zip$/i, /\.dmg$/i, /\.zip$/i];
+    }
+    case 'mac-intel': {
+      return [/-x64\.dmg$/i, /-x64-mac\.zip$/i, /-x64\.zip$/i, /\.dmg$/i, /\.zip$/i];
+    }
+    case 'windows': {
+      return [/-setup\.exe$/i, /\.exe$/i];
+    }
+    case 'linux': {
+      return [/\.appimage$/i, /\.deb$/i, /\.rpm$/i, /\.snap$/i, /\.tar\.gz$/i];
+    }
+  }
+};
+
+export const resolveDesktopDownloadFromUrls = (options: {
+  publishedAt?: string;
+  tag: string;
+  type: DesktopDownloadType;
+  urls: string[];
+  version: string;
+}): DesktopDownloadInfo | null => {
+  const matchers = buildTypeMatchers(options.type);
+
+  const matchedUrl = matchers
+    .map((matcher) => options.urls.find((url) => matcher.test(getBasename(url))))
+    .find(Boolean);
+
+  if (!matchedUrl) return null;
+
+  return {
+    assetName: getBasename(matchedUrl),
+    publishedAt: options.publishedAt,
+    tag: options.tag,
+    type: options.type,
+    url: matchedUrl,
+    version: options.version,
+  };
+};
+
+export const resolveDesktopDownload = (
+  release: GithubRelease,
+  type: DesktopDownloadType,
+): DesktopDownloadInfo | null => {
+  const tag = release.tag_name;
+  const version = tag.replace(/^v/i, '');
+  const matchers = buildTypeMatchers(type);
+
+  const matchedAsset = matchers
+    .map((matcher) => release.assets.find((asset) => matcher.test(asset.name)))
+    .find(Boolean);
+
+  if (!matchedAsset) return null;
+
+  return {
+    assetName: matchedAsset.name,
+    publishedAt: release.published_at,
+    tag,
+    type,
+    url: matchedAsset.browser_download_url,
+    version,
+  };
+};
+
+export const getLatestDesktopReleaseFromGithub = async (options?: {
+  owner?: string;
+  repo?: string;
+  token?: string;
+}): Promise<GithubRelease> => {
+  const owner = options?.owner || 'lobehub';
+  const repo = options?.repo || 'lobe-chat';
+  const token = options?.token || process.env.GITHUB_TOKEN;
+
+  const res = await fetch(`https://api.github.com/repos/${owner}/${repo}/releases/latest`, {
+    headers: {
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      'Accept': 'application/vnd.github+json',
+      'User-Agent': 'lobehub-server',
+    },
+    next: { revalidate: 300, tags: [FetchCacheTag.DesktopRelease] },
+  });
+
+  if (!res.ok) {
+    const text = await res.text().catch(() => '');
+    throw new Error(`GitHub releases/latest request failed: ${res.status} ${text}`.trim());
+  }
+
+  return (await res.json()) as GithubRelease;
+};
+
+const fetchUpdateServerManifest = async (
+  baseUrl: string,
+  manifestName: string,
+): Promise<UpdateServerManifest> => {
+  const res = await fetch(urlJoin(baseUrl, manifestName), {
+    next: { revalidate: 300, tags: [FetchCacheTag.DesktopRelease] },
+  });
+
+  if (!res.ok) {
+    const text = await res.text().catch(() => '');
+    throw new Error(`Update server manifest request failed: ${res.status} ${text}`.trim());
+  }
+
+  const text = await res.text();
+  return (parse(text) || {}) as UpdateServerManifest;
+};
+
+const normalizeManifestUrls = (baseUrl: string, manifest: UpdateServerManifest) => {
+  const urls: string[] = [];
+
+  for (const file of manifest.files || []) {
+    if (!file?.url) continue;
+    urls.push(isAbsoluteUrl(file.url) ? file.url : urlJoin(baseUrl, file.url));
+  }
+
+  if (manifest.path) {
+    urls.push(isAbsoluteUrl(manifest.path) ? manifest.path : urlJoin(baseUrl, manifest.path));
+  }
+
+  return urls;
+};
+
+export const getStableDesktopReleaseInfoFromUpdateServer = async (options?: {
+  baseUrl?: string;
+}): Promise<{ publishedAt?: string; tag: string; urls: string[]; version: string } | null> => {
+  const baseUrl =
+    options?.baseUrl || process.env.DESKTOP_UPDATE_SERVER_URL || process.env.UPDATE_SERVER_URL;
+  if (!baseUrl) return null;
+
+  const [mac, win, linux] = await Promise.all([
+    fetchUpdateServerManifest(baseUrl, 'stable-mac.yml').catch(() => null),
+    fetchUpdateServerManifest(baseUrl, 'stable.yml').catch(() => null),
+    fetchUpdateServerManifest(baseUrl, 'stable-linux.yml').catch(() => null),
+  ]);
+
+  const manifests = [mac, win, linux].filter(Boolean) as UpdateServerManifest[];
+  const version = manifests.map((m) => m.version).find(Boolean) || '';
+  if (!version) return null;
+
+  const tag = `v${version.replace(/^v/i, '')}`;
+  const publishedAt = manifests.map((m) => m.releaseDate).find(Boolean);
+
+  const urls = [
+    ...(mac ? normalizeManifestUrls(baseUrl, mac) : []),
+    ...(win ? normalizeManifestUrls(baseUrl, win) : []),
+    ...(linux ? normalizeManifestUrls(baseUrl, linux) : []),
+  ];
+
+  return { publishedAt, tag, urls, version: version.replace(/^v/i, '') };
+};
+
+export const resolveDesktopDownloadFromUpdateServer = async (options: {
+  baseUrl?: string;
+  type: DesktopDownloadType;
+}): Promise<DesktopDownloadInfo | null> => {
+  const info = await getStableDesktopReleaseInfoFromUpdateServer({ baseUrl: options.baseUrl });
+  if (!info) return null;
+
+  return resolveDesktopDownloadFromUrls({ ...info, type: options.type });
+};

package/src/store/aiInfra/slices/aiProvider/action.ts

@@ -29,7 +29,6 @@ import {
   type UpdateAiProviderParams,
 } from '@/types/aiProvider';
 
-
 export type ProviderModelListItem = {
   abilities: ModelAbilities;
   approximatePricePerImage?: number;
@@ -77,10 +76,10 @@ export const normalizeImageModel = async (
   const fallbackParametersPromise = model.parameters
     ? Promise.resolve<ModelParamsSchema | undefined>(model.parameters)
     : getModelPropertyWithFallback<ModelParamsSchema | undefined>(
-      model.id,
-      'parameters',
-      model.providerId,
-    );
+        model.id,
+        'parameters',
+        model.providerId,
+      );
 
   const modelWithPricing = model as AIImageModelCard;
   const fallbackPricingPromise = modelWithPricing.pricing
@@ -321,23 +320,23 @@ export const createAiProviderSlice: StateCreator<
           aiProviderDetailMap:
             currentDetailConfig && Object.keys(detailUpdates).length > 0
               ? {
-                ...state.aiProviderDetailMap,
-                [id]: {
-                  ...currentDetailConfig,
-                  ...detailUpdates,
-                },
-              }
+                  ...state.aiProviderDetailMap,
+                  [id]: {
+                    ...currentDetailConfig,
+                    ...detailUpdates,
+                  },
+                }
               : state.aiProviderDetailMap,
           // Update runtime config for selectors
           aiProviderRuntimeConfig:
             currentRuntimeConfig && Object.keys(updates).length > 0
               ? {
-                ...state.aiProviderRuntimeConfig,
-                [id]: {
-                  ...currentRuntimeConfig,
-                  ...updates,
-                },
-              }
+                  ...state.aiProviderRuntimeConfig,
+                  [id]: {
+                    ...currentRuntimeConfig,
+                    ...updates,
+                  },
+                }
               : state.aiProviderRuntimeConfig,
         };
       },

package/src/store/chat/slices/portal/action.test.ts

@@ -203,7 +203,6 @@ describe('chatDockSlice', () => {
     });
   });
 
-
   describe('closeToolUI', () => {
     it('should pop ToolUI view from stack', () => {
       const { result } = renderHook(() => useChatStore());
@@ -267,5 +266,4 @@ describe('chatDockSlice', () => {
       expect(result.current.showPortal).toBe(true);
     });
   });
-
 });

package/src/store/chat/slices/portal/action.ts

@@ -42,71 +42,57 @@ export const chatPortalSlice: StateCreator<
   [],
   ChatPortalAction
 > = (set, get) => ({
-
-
   clearPortalStack: () => {
     set({ portalStack: [], showPortal: false }, false, 'clearPortalStack');
   },
 
-
-closeArtifact: () => {
+  closeArtifact: () => {
     const { portalStack } = get();
     if (getCurrentViewType(portalStack) === PortalViewType.Artifact) {
       get().popPortalView();
     }
   },
 
-
-closeDocument: () => {
+  closeDocument: () => {
     const { portalStack } = get();
     if (getCurrentViewType(portalStack) === PortalViewType.Document) {
       get().popPortalView();
     }
   },
 
-
-closeFilePreview: () => {
+  closeFilePreview: () => {
     const { portalStack } = get();
     if (getCurrentViewType(portalStack) === PortalViewType.FilePreview) {
       get().popPortalView();
     }
   },
 
-
-closeMessageDetail: () => {
+  closeMessageDetail: () => {
     const { portalStack } = get();
     if (getCurrentViewType(portalStack) === PortalViewType.MessageDetail) {
       get().popPortalView();
     }
   },
 
-
-closeNotebook: () => {
+  closeNotebook: () => {
     const { portalStack } = get();
     if (getCurrentViewType(portalStack) === PortalViewType.Notebook) {
       get().popPortalView();
     }
   },
 
-
-
-
-closeToolUI: () => {
+  closeToolUI: () => {
     const { portalStack } = get();
     if (getCurrentViewType(portalStack) === PortalViewType.ToolUI) {
       get().popPortalView();
     }
   },
 
-
-
-goBack: () => {
+  goBack: () => {
     get().popPortalView();
   },
 
-
-
-goHome: () => {
+  goHome: () => {
     set(
       {
         portalStack: [{ type: PortalViewType.Home }],
@@ -117,45 +103,32 @@ goHome: () => {
     );
   },
 
-
-
-// ============== Convenience Methods (using stack operations) ==============
-openArtifact: (artifact) => {
+  // ============== Convenience Methods (using stack operations) ==============
+  openArtifact: (artifact) => {
     get().pushPortalView({ artifact, type: PortalViewType.Artifact });
   },
 
-
-
-
-openDocument: (documentId) => {
+  openDocument: (documentId) => {
     get().pushPortalView({ documentId, type: PortalViewType.Document });
   },
 
-
-
-
-openFilePreview: (file) => {
+  openFilePreview: (file) => {
     get().pushPortalView({ file, type: PortalViewType.FilePreview });
   },
 
-
-
-openMessageDetail: (messageId) => {
+  openMessageDetail: (messageId) => {
     get().pushPortalView({ messageId, type: PortalViewType.MessageDetail });
   },
 
-
-openNotebook: () => {
+  openNotebook: () => {
     get().pushPortalView({ type: PortalViewType.Notebook });
   },
 
-
-openToolUI: (messageId, identifier) => {
+  openToolUI: (messageId, identifier) => {
     get().pushPortalView({ identifier, messageId, type: PortalViewType.ToolUI });
   },
 
-
-popPortalView: () => {
+  popPortalView: () => {
     const { portalStack } = get();
 
     if (portalStack.length <= 1) {
@@ -167,7 +140,7 @@ popPortalView: () => {
   },
 
   // ============== Core Stack Operations ==============
-pushPortalView: (view) => {
+  pushPortalView: (view) => {
     const { portalStack } = get();
     const top = portalStack.at(-1);
 

package/src/store/chat/slices/thread/action.test.ts

@@ -150,7 +150,10 @@ describe('thread action', () => {
       expect(result.current.threadStartMessageId).toBe('message-id');
       expect(result.current.portalThreadId).toBeUndefined();
       expect(result.current.startToForkThread).toBe(true);
-      expect(pushPortalViewSpy).toHaveBeenCalledWith({ type: 'thread', startMessageId: 'message-id' });
+      expect(pushPortalViewSpy).toHaveBeenCalledWith({
+        type: 'thread',
+        startMessageId: 'message-id',
+      });
     });
   });
 

package/src/store/chat/slices/thread/action.ts

@@ -2,7 +2,12 @@
 // Disable the auto sort key eslint rule to make the code more logic and readable
 import { LOADING_FLAT } from '@lobechat/const';
 import { chainSummaryTitle } from '@lobechat/prompts';
-import { type CreateMessageParams, type IThreadType, type ThreadItem, type UIChatMessage } from '@lobechat/types';
+import {
+  type CreateMessageParams,
+  type IThreadType,
+  type ThreadItem,
+  type UIChatMessage,
+} from '@lobechat/types';
 import isEqual from 'fast-deep-equal';
 import type { SWRResponse } from 'swr';
 import { type StateCreator } from 'zustand/vanilla';

package/src/components/FunctionModal/createModalHooks.ts

@@ -1,48 +0,0 @@
-import { App } from 'antd';
-import { type ModalFuncProps } from 'antd/es/modal/interface';
-import { type MutableRefObject, type ReactNode, type RefObject, useRef } from 'react';
-
-import { closeIcon, styles } from './style';
-
-interface CreateModalProps extends ModalFuncProps {
-  content: ReactNode;
-}
-
-interface ModalInstance {
-  destroy: (...args: any[]) => void;
-}
-
-type PropsFunc<T = undefined> = (
-  instance: MutableRefObject<ModalInstance | undefined>,
-  props?: T,
-) => CreateModalProps;
-
-const createModal = <T>(params: CreateModalProps | PropsFunc<T>) => {
-  const useModal = () => {
-    const { modal } = App.useApp();
-    const instanceRef = useRef<ModalInstance>(null);
-
-    const open = (outProps?: T) => {
-      const props =
-        typeof params === 'function'
-          ? params(instanceRef as RefObject<ModalInstance>, outProps)
-          : params;
-
-      instanceRef.current = modal.confirm({
-        className: styles.content,
-        closable: true,
-        closeIcon,
-        footer: false,
-        icon: null,
-        wrapClassName: styles.wrap,
-        ...props,
-      });
-    };
-
-    return { open };
-  };
-
-  return useModal;
-};
-
-export { createModal };

package/src/components/FunctionModal/index.ts

@@ -1 +0,0 @@
-export * from './createModalHooks';