@lobehub/chat 1.109.0 → 1.110.0

package/packages/types/src/plugins/protocol.ts

@@ -0,0 +1,166 @@
+/**
+ * 协议来源类型
+ */
+export enum ProtocolSource {
+  /** 社区贡献 */
+  COMMUNITY = 'community',
+  /** 开发者自定义 */
+  DEVELOPER = 'developer',
+  /** GitHub 官方 */
+  GITHUB_OFFICIAL = 'github_official',
+  /** 官方LobeHub市场 */
+  OFFICIAL = 'official',
+  /** 第三方市场 */
+  THIRD_PARTY = 'third_party',
+}
+
+/**
+ * MCP Schema - stdio 配置类型
+ */
+export interface McpStdioConfig {
+  args?: string[];
+  command: string;
+  env?: Record<string, string>;
+  type: 'stdio';
+}
+
+/**
+ * MCP Schema - http 配置类型
+ */
+export interface McpHttpConfig {
+  headers?: Record<string, string>;
+  type: 'http';
+  url: string;
+}
+
+/**
+ * MCP Schema 配置类型
+ */
+export type McpConfig = McpStdioConfig | McpHttpConfig;
+
+/**
+ * MCP Schema 对象
+ * 符合 RFC 0001 定义
+ */
+export interface McpSchema {
+  /** 插件作者 */
+  author: string;
+  /** 插件配置 */
+  config: McpConfig;
+  /** 插件描述 */
+  description: string;
+  /** 插件主页 */
+  homepage?: string;
+  /** 插件图标 */
+  icon?: string;
+  /** 插件唯一标识符，必须与URL中的id参数匹配 */
+  identifier: string;
+  /** 插件名称 */
+  name: string;
+  /** 插件版本 (semver) */
+  version: string;
+}
+
+/**
+ * RFC 0001 协议参数
+ * lobehub://plugin/install?id=xxx&schema=xxx&marketId=xxx&meta_*=xxx
+ */
+export interface McpInstallProtocolParamsRFC {
+  /** 可选的 UI 显示元数据，以 meta_ 为前缀 */
+  [key: `meta_${string}`]: string | undefined;
+  /** 插件的唯一标识符 */
+  id: string;
+  /** 提供该插件的 Marketplace 的唯一标识符 */
+  marketId?: string;
+  /** Base64URL 编码的 MCP Schema 对象 */
+  schema: string;
+  /** 插件类型，对于 MCP 固定为 'mcp' */
+  type: 'mcp';
+}
+
+/**
+ * 协议URL解析结果
+ */
+export interface ProtocolUrlParsed {
+  /** 操作类型 (如: 'install') */
+  action: 'install' | 'configure' | 'update';
+  /** 解析后的参数 */
+  params: {
+    id: string;
+    marketId?: string;
+    type: string;
+  };
+  /** MCP Schema 对象 */
+  schema: McpSchema;
+  /** 协议来源 */
+  source: ProtocolSource;
+  /** 插件类型 (如: 'mcp') */
+  type: 'mcp' | 'plugin';
+  /** URL类型 (如: 'plugin') */
+  urlType: string;
+}
+
+/**
+ * 安装确认弹窗信息
+ */
+export interface InstallConfirmationInfo {
+  dependencies?: string[];
+  permissions?: {
+    filesystem?: boolean;
+    network?: boolean;
+    system?: boolean;
+  };
+  pluginInfo: {
+    author?: string;
+    description: string;
+    homepage?: string;
+    icon?: string;
+    identifier: string;
+    name: string;
+    version: string;
+  };
+  source: {
+    platform?: {
+      name: string;
+      url?: string;
+    };
+    type: ProtocolSource;
+    verified: boolean; // 是否为验证来源
+  };
+}
+
+/**
+ * 协议处理器接口
+ */
+export interface ProtocolHandler {
+  /**
+   * 处理协议URL
+   */
+  handle(
+    parsed: ProtocolUrlParsed,
+  ): Promise<{ error?: string; success: boolean; targetWindow?: string }>;
+
+  /**
+   * 支持的操作
+   */
+  readonly supportedActions: string[];
+
+  /**
+   * 协议类型
+   */
+  readonly type: string;
+}
+
+/**
+ * 协议路由配置
+ */
+export interface ProtocolRouteConfig {
+  /** 操作类型 */
+  action: string;
+  /** 目标路径（相对于窗口base路径） */
+  targetPath?: string;
+  /** 目标窗口 */
+  targetWindow: 'chat' | 'settings';
+  /** 协议类型 */
+  type: string;
+}

package/src/app/[variants]/(main)/chat/_layout/Desktop/index.tsx

@@ -1,7 +1,9 @@
 import { Suspense } from 'react';
 import { Flexbox } from 'react-layout-kit';
 
+import { isDesktop } from '@/const/version';
 import InitClientDB from '@/features/InitClientDB';
+import ProtocolUrlHandler from '@/features/ProtocolUrlHandler';
 
 import { LayoutProps } from '../type';
 import RegisterHotkeys from './RegisterHotkeys';
@@ -20,13 +22,14 @@ const Layout = ({ children, session }: LayoutProps) => {
         <SessionPanel>{session}</SessionPanel>
         <Workspace>{children}</Workspace>
       </Flexbox>
-      <InitClientDB bottom={60} />
+      {!isDesktop && <InitClientDB bottom={60} />}
       {/* ↓ cloud slot ↓ */}
 
       {/* ↑ cloud slot ↑ */}
       <Suspense>
         <RegisterHotkeys />
       </Suspense>
+      {isDesktop && <ProtocolUrlHandler />}
     </>
   );
 };

package/src/app/[variants]/(main)/discover/(detail)/mcp/[slug]/features/Sidebar/ActionButton/index.tsx

@@ -22,6 +22,7 @@ const useStyles = createStyles(({ css }) => ({
 }));
 
 const ActionButton = memo(() => {
+  const { t } = useTranslation(['discover', 'plugin']);
   const { identifier } = useDetailContext();
   const { styles } = useStyles();
   const [isLoading, setIsLoading] = useState(false);
@@ -32,8 +33,6 @@ const ActionButton = memo(() => {
     s.uninstallMCPPlugin,
   ]);
 
-  const { t } = useTranslation(['discover', 'plugin']);
-
   const installPlugin = async () => {
     if (!identifier) return;
     setIsLoading(true);

package/src/components/KeyValueEditor/index.tsx

@@ -3,7 +3,7 @@ import { Button } from 'antd';
 import { createStyles } from 'antd-style';
 import fastDeepEqual from 'fast-deep-equal';
 import { LucidePlus, LucideTrash } from 'lucide-react';
-import { memo, useEffect, useRef, useState } from 'react';
+import { CSSProperties, memo, useEffect, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { Flexbox } from 'react-layout-kit';
 import { v4 as uuidv4 } from 'uuid';
@@ -44,6 +44,7 @@ export interface KeyValueEditorProps {
   duplicateKeyErrorText?: string;
   keyPlaceholder?: string;
   onChange?: (value: Record<string, string>) => void;
+  style?: CSSProperties;
   value?: Record<string, string>;
   valuePlaceholder?: string;
 }
@@ -57,6 +58,7 @@ const KeyValueEditor = memo<KeyValueEditorProps>(
     addButtonText,
     duplicateKeyErrorText,
     deleteTooltip,
+    style,
   }) => {
     const { styles } = useStyles();
     const { t } = useTranslation('components');
@@ -125,7 +127,7 @@ const KeyValueEditor = memo<KeyValueEditorProps>(
     const duplicateKeys = getDuplicateKeys(items);
 
     return (
-      <div className={styles.container}>
+      <div className={styles.container} style={style}>
         <Flexbox className={styles.title} gap={8} horizontal>
           <Flexbox flex={1}>{keyPlaceholder || t('KeyValueEditor.keyPlaceholder')}</Flexbox>
           <Flexbox flex={2}>{valuePlaceholder || t('KeyValueEditor.valuePlaceholder')}</Flexbox>