@lobehub/chat 0.63.2 → 0.64.0

package/src/features/PluginDevModal/ManifestForm.tsx

@@ -0,0 +1,96 @@
+import { pluginManifestSchema } from '@lobehub/chat-plugin-sdk';
+import { Form, FormItemProps, Input, Tooltip } from '@lobehub/ui';
+import { FormInstance, Radio } from 'antd';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+const ManifestForm = memo<{ form: FormInstance; mode: 'url' | 'local' }>(({ form, mode }) => {
+  const { t } = useTranslation('plugin');
+
+  const isUrl = mode === 'url';
+
+  const configItem: FormItemProps[] = isUrl
+    ? [
+        {
+          children: <Input placeholder={'http://localhost/manifest.json'} />,
+          desc: t('dev.meta.manifest.desc'),
+          hasFeedback: true,
+          label: t('dev.meta.manifest.label'),
+          name: 'manifest',
+          required: true,
+          rules: [
+            { required: true },
+            {
+              message: t('dev.meta.manifest.urlError'),
+              pattern: /^https?:\/\/.*/,
+            },
+            {
+              message: t('dev.meta.manifest.invalid'),
+              validator: async (_, value) => {
+                const res = await fetch(value);
+                if (!res.ok) return true;
+
+                const json = await res.json();
+                pluginManifestSchema.parse(json);
+              },
+            },
+          ],
+        },
+      ]
+    : // TODO: 后续做成本地配置模式
+      [
+        {
+          children: <Input placeholder={'searchEngine'} />,
+          desc: t('dev.meta.identifier.desc'),
+          label: t('dev.meta.identifier.label'),
+          name: 'name',
+          required: true,
+        },
+
+        {
+          children: <Input placeholder={t('dev.meta.description.placeholder')} />,
+          desc: t('dev.meta.description.desc'),
+          label: t('dev.meta.description.label'),
+          name: 'description',
+          required: true,
+        },
+        {
+          children: <Input placeholder={'searchEngine'} />,
+          desc: t('dev.meta.identifier.desc'),
+          label: t('dev.meta.identifier.label'),
+          name: 'identifier',
+          required: true,
+        },
+      ];
+
+  return (
+    <Form
+      form={form}
+      items={[
+        {
+          children: configItem,
+          extra: (
+            <Radio.Group
+              onChange={(v) => {
+                form.setFieldValue('manifestMode', v.target.value);
+              }}
+              size={'small'}
+              value={mode}
+            >
+              <Radio.Button value={'url'}>{t('dev.manifest.mode.url')}</Radio.Button>
+              <Tooltip title={t('dev.manifest.mode.local-tooltip')}>
+                <Radio.Button disabled value={'local'}>
+                  {t('dev.manifest.mode.local')}
+                </Radio.Button>
+              </Tooltip>
+            </Radio.Group>
+          ),
+          title: t('dev.tabs.manifest'),
+        },
+      ]}
+      layout={isUrl ? 'vertical' : undefined}
+    />
+  );
+});
+
+export default ManifestForm;

package/src/features/PluginDevModal/MetaForm.tsx

@@ -0,0 +1,90 @@
+import { Form, FormItemProps, Input } from '@lobehub/ui';
+import { FormInstance } from 'antd';
+import { memo, useEffect } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import EmojiPicker from '@/components/EmojiPicker';
+import { pluginSelectors, usePluginStore } from '@/store/plugin';
+
+const MetaForm = memo<{ form: FormInstance }>(({ form }) => {
+  const { t } = useTranslation('plugin');
+  const [plugins] = usePluginStore((s) => [pluginSelectors.pluginList(s).map((i) => i.identifier)]);
+
+  useEffect(() => {
+    if (usePluginStore.getState().newDevPlugin) {
+      form.setFieldsValue(usePluginStore.getState().newDevPlugin);
+    }
+  }, []);
+
+  const configItem: FormItemProps[] = [
+    {
+      children: <Input placeholder={'searchEngine'} />,
+      desc: t('dev.meta.identifier.desc'),
+      label: t('dev.meta.identifier.label'),
+      name: 'identifier',
+      rules: [
+        { required: true },
+        {
+          message: t('dev.meta.identifier.pattenErrorMessage'),
+          pattern: /^[\w-]+$/,
+        },
+        {
+          message: t('dev.meta.identifier.errorDuplicate'),
+          validator: async (_, value) => {
+            if (plugins.includes(value)) {
+              throw new Error('Duplicate');
+            }
+          },
+        },
+      ],
+    },
+    {
+      children: <Input placeholder={t('dev.meta.title.placeholder')} />,
+      desc: t('dev.meta.title.desc'),
+      label: t('dev.meta.title.label'),
+      name: ['meta', 'title'],
+      rules: [{ required: true }],
+    },
+    {
+      children: <Input placeholder={t('dev.meta.description.placeholder')} />,
+      desc: t('dev.meta.description.desc'),
+      label: t('dev.meta.description.label'),
+      name: ['meta', 'description'],
+    },
+    {
+      children: <Input placeholder={'LobeHub'} />,
+      desc: t('dev.meta.author.desc'),
+      label: t('dev.meta.author.label'),
+      name: 'author',
+    },
+    {
+      children: <Input placeholder={'https://www.lobehub.com'} />,
+      desc: t('dev.meta.homepage.desc'),
+      label: t('dev.meta.homepage.label'),
+      name: 'homepage',
+    },
+    {
+      children: <EmojiPicker defaultAvatar={'🧩'} />,
+      desc: t('dev.meta.avatar.desc'),
+      label: t('dev.meta.avatar.label'),
+      name: ['meta', 'avatar'],
+    },
+  ];
+
+  return (
+    <Form
+      form={form}
+      items={[
+        {
+          children: configItem,
+          title: t('dev.metaConfig'),
+        },
+      ]}
+      validateMessages={{
+        required: () => t('dev.meta.formFieldRequired'),
+      }}
+    />
+  );
+});
+
+export default MetaForm;

package/src/features/PluginDevModal/PluginPreview.tsx

@@ -0,0 +1,36 @@
+import { Avatar, Form } from '@lobehub/ui';
+import { Card, Switch, Tag } from 'antd';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Flexbox } from 'react-layout-kit';
+
+import { pluginHelpers, usePluginStore } from '@/store/plugin';
+
+const PluginPreview = memo(() => {
+  const { t } = useTranslation('plugin');
+  const meta = usePluginStore((s) => s.newDevPlugin);
+
+  const items = {
+    avatar: <Avatar avatar={pluginHelpers.getPluginAvatar(meta?.meta) || '🧩'} />,
+    children: <Switch disabled />,
+    desc: pluginHelpers.getPluginDesc(meta?.meta),
+    label: (
+      <Flexbox align={'center'} gap={8} horizontal>
+        {pluginHelpers.getPluginTitle(meta?.meta) ?? t('dev.preview.title')}
+        <Tag bordered={false} color={'gold'}>
+          {t('list.item.local.title', { ns: 'plugin' })}
+        </Tag>
+      </Flexbox>
+    ),
+    minWidth: undefined,
+    tag: !!meta?.identifier ? meta?.identifier : 'id',
+  };
+
+  return (
+    <Card size={'small'} title={t('dev.preview.card')}>
+      <Form.Item {...items} colon={false} style={{ marginBottom: 0 }} />
+    </Card>
+  );
+});
+
+export default PluginPreview;

package/src/features/PluginDevModal/index.tsx

@@ -0,0 +1,153 @@
+import { Icon } from '@lobehub/ui';
+import { App, Button, ConfigProvider, Form, Modal, Popconfirm } from 'antd';
+import { createStyles, useTheme } from 'antd-style';
+import { LucideBlocks } from 'lucide-react';
+import { lighten } from 'polished';
+import { memo, useEffect } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Flexbox } from 'react-layout-kit';
+
+import { DevPlugin } from '@/store/plugin/initialState';
+
+import ManifestForm from './ManifestForm';
+import MetaForm from './MetaForm';
+import PluginPreview from './PluginPreview';
+
+const useStyles = createStyles(({ css, token, prefixCls }) => ({
+  content: css`
+    .${prefixCls}-modal-content {
+      border: 1px solid ${token.colorSplit};
+      border-radius: 12px;
+    }
+  `,
+  root: css`
+    backdrop-filter: blur(5px);
+  `,
+}));
+
+interface DevModalProps {
+  onDelete?: () => void;
+  onOpenChange: (open: boolean) => void;
+  onSave?: (value: DevPlugin) => void;
+  onValueChange?: (value: Partial<DevPlugin>) => void;
+  open?: boolean;
+  showDelete?: boolean;
+  value?: DevPlugin;
+}
+
+const DevModal = memo<DevModalProps>(
+  ({ open, showDelete, value, onValueChange, onSave, onOpenChange, onDelete }) => {
+    const { t } = useTranslation('plugin');
+
+    const [form] = Form.useForm();
+    const theme = useTheme();
+
+    const { styles } = useStyles();
+
+    const { message } = App.useApp();
+
+    useEffect(() => {
+      form.setFieldsValue(value);
+    }, []);
+
+    const footer = (
+      <Flexbox horizontal justify={'space-between'} style={{ marginTop: 24 }}>
+        {showDelete ? (
+          <Popconfirm
+            okButtonProps={{
+              danger: true,
+              type: 'primary',
+            }}
+            onConfirm={() => {
+              onDelete?.();
+              message.success(t('dev.deleteSuccess'));
+            }}
+            placement={'topLeft'}
+            title={t('dev.confirmDeleteDevPlugin')}
+          >
+            <Button danger>{t('delete', { ns: 'common' })}</Button>
+          </Popconfirm>
+        ) : (
+          <div />
+        )}
+
+        <Flexbox horizontal>
+          <Button
+            onClick={() => {
+              onOpenChange(false);
+            }}
+          >
+            {t('cancel', { ns: 'common' })}
+          </Button>
+          <Button
+            onClick={() => {
+              form.submit();
+            }}
+            type={'primary'}
+          >
+            {t('dev.save')}
+          </Button>
+        </Flexbox>
+      </Flexbox>
+    );
+    return (
+      <Form.Provider
+        onFormChange={() => {
+          onValueChange?.(form.getFieldsValue());
+        }}
+        onFormFinish={(_, info) => {
+          onSave?.(info.values as DevPlugin);
+          message.success(t('dev.saveSuccess'));
+          onOpenChange(false);
+        }}
+      >
+        <ConfigProvider
+          theme={{
+            token: {
+              colorBgElevated: lighten(0.005, theme.colorBgContainer),
+            },
+          }}
+        >
+          <Modal
+            centered
+            closable
+            footer={footer}
+            maskClosable
+            okText={t('dev.save')}
+            onCancel={() => {
+              onOpenChange(false);
+            }}
+            onOk={() => {
+              form.submit();
+            }}
+            open={open}
+            style={{ height: 750 }}
+            title={
+              <Flexbox gap={8} horizontal>
+                <Icon icon={LucideBlocks} />
+                {t('dev.title')}
+              </Flexbox>
+            }
+            width={700}
+            wrapClassName={styles.root}
+          >
+            <Flexbox gap={12}>
+              {t('dev.modalDesc')}
+              {/*<Tabs*/}
+              {/*  items={[*/}
+              {/*    { children: <MetaForm />, key: 'meta', label: t('dev.tabs.meta') },*/}
+              {/*    { children: <ManifestForm />, key: 'manifest', label: t('dev.tabs.manifest') },*/}
+              {/*  ]}*/}
+              {/*/>*/}
+              <PluginPreview />
+              <ManifestForm form={form} mode={'url'} />
+              <MetaForm form={form} />
+            </Flexbox>
+          </Modal>
+        </ConfigProvider>
+      </Form.Provider>
+    );
+  },
+);
+
+export default DevModal;

package/src/locales/default/error.ts

@@ -37,6 +37,8 @@ export default {
       '很抱歉，该插件请求的入参校验未通过，请检查入参与 Api 描述信息是否匹配',
     [PluginErrorType.PluginSettingsInvalid]:
       '该插件需要正确配置后才可以使用，请检查你的配置是否正确',
+    [PluginErrorType.PluginServerError]:
+      '插件服务端请求返回出错，请检查根据下面的报错信息检查你的插件描述文件、插件配置或服务端实现',
 
     [ChatErrorType.InvalidAccessCode]:
       '密码不正确或为空，请输入正确的访问密码，或者添加自定义 OpenAI API Key',

package/src/locales/default/plugin.ts

@@ -4,15 +4,91 @@ export default {
     function_call: '函数调用',
     response: '返回结果',
   },
+  dev: {
+    confirmDeleteDevPlugin: '即将删除该本地插件，删除后将无法找回，是否删除该插件？',
+    deleteSuccess: '插件删除成功',
+    manifest: {
+      identifier: {
+        desc: '插件的唯一标识',
+        label: '标识符',
+      },
+      mode: {
+        'local': '可视化配置',
+        'local-tooltip': '暂时不支持可视化配置',
+        'url': '在线链接',
+      },
+      name: {
+        desc: '插件标题',
+        label: '标题',
+        placeholder: '搜索引擎',
+      },
+    },
+    meta: {
+      author: {
+        desc: '插件的作者',
+        label: '作者',
+      },
+      avatar: {
+        desc: '插件的图标，可以使用 Emoji，也可以使用 URL',
+        label: '图标',
+      },
+      description: {
+        desc: '插件描述',
+        label: '描述',
+        placeholder: '查询搜索引擎获取信息',
+      },
+      formFieldRequired: '该字段为必填项',
+      homepage: {
+        desc: '插件的首页',
+        label: '首页',
+      },
+      identifier: {
+        desc: '插件的唯一标识，仅支持英文字符、数字、破折号 - 、下划线 _',
+        errorDuplicate: '标识符和已有插件重复，请修改标识符',
+        label: '标识符',
+        pattenErrorMessage: '只能输入英文字符、数字 、- 和_ 这两个符号',
+      },
+      manifest: {
+        desc: 'LobeChat 将会通过该链接安装插件',
+        invalid: '输入的 manifest 链接无效，或 manifest 不符合规范',
+        label: '插件描述文件 Url 地址',
+        urlError: '请输入一个有效的网址',
+      },
+      title: {
+        desc: '插件标题',
+        label: '标题',
+        placeholder: '搜索引擎',
+      },
+    },
+    metaConfig: '插件元信息配置',
+    modalDesc: '添加自定义插件后，可用于插件开发验证，也可直接在会话中使用。插件开发文档请参考',
+    preview: {
+      card: '预览插件展示效果',
+      desc: '预览插件描述',
+      title: '插件名称预览',
+    },
+    save: '保存',
+    saveSuccess: '插件设置保存成功',
+    tabs: {
+      manifest: '功能描述清单 (Manifest)',
+      meta: '插件元信息',
+    },
+
+    title: '添加自定义插件',
+  },
+  list: {
+    item: {
+      'local.config': '配置',
+      'local.title': '本地',
+    },
+  },
+
   loading: {
     content: '数据获取中...',
     plugin: '插件运行中...',
   },
   pluginList: '插件列表',
   plugins: {
-    realtimeWeather: '实时天气预报',
-    searchEngine: '搜索引擎',
     unknown: '插件检测中...',
-    websiteCrawler: '网页内容提取',
   },
 };

package/src/locales/default/setting.ts

@@ -1,3 +1,4 @@
+
 export default {
   danger: {
     clear: {
@@ -128,6 +129,8 @@ export default {
     },
   },
   settingPlugin: {
+    add: '添加',
+    addTooltip: '添加自定义插件',
     config: '{{id}} 插件配置',
     title: '插件列表',
   },

package/src/pages/chat/features/Conversation/ChatList/Error/index.tsx

@@ -18,7 +18,8 @@ export const renderErrorMessage: RenderErrorMessage = (error, message: ChatMessa
     case PluginErrorType.PluginManifestInvalid:
     case PluginErrorType.PluginManifestNotFound:
     case PluginErrorType.PluginApiNotFound:
-    case PluginErrorType.PluginApiParamsError: {
+    case PluginErrorType.PluginApiParamsError:
+    case PluginErrorType.PluginServerError: {
       return <PluginError content={(error as any).body} id={message.id} />;
     }
     case PluginErrorType.PluginSettingsInvalid: {

package/src/pages/chat/features/Conversation/ChatList/Plugins/FunctionCall.tsx

@@ -6,7 +6,7 @@ import { memo, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { Flexbox } from 'react-layout-kit';
 
-import { pluginSelectors, usePluginStore } from '@/store/plugin';
+import { pluginHelpers, pluginSelectors, usePluginStore } from '@/store/plugin';
 
 import PluginResult from './PluginResultRender';
 import { useStyles } from './style';
@@ -27,8 +27,11 @@ const FunctionCall = memo<FunctionCallProps>(
 
     const item = usePluginStore(pluginSelectors.getPluginMetaById(id));
 
-    const avatar = item?.meta.avatar ? (
-      <Avatar avatar={item?.meta.avatar} size={32} />
+    const pluginAvatar = pluginHelpers.getPluginAvatar(item?.meta);
+    const pluginTitle = pluginHelpers.getPluginTitle(item?.meta);
+
+    const avatar = pluginAvatar ? (
+      <Avatar avatar={pluginAvatar} size={32} />
     ) : (
       <Icon icon={LucideToyBrick} />
     );
@@ -54,7 +57,7 @@ const FunctionCall = memo<FunctionCallProps>(
           ) : (
             avatar
           )}
-          {t(`plugins.${id}` as any, { ns: 'plugin' })}
+          {pluginTitle ?? t('plugins.unknown')}
           <Icon icon={open ? LucideChevronUp : LucideChevronDown} />
         </Flexbox>
         {open && (

package/src/pages/chat/features/Conversation/ChatList/Plugins/PluginMessage.tsx

@@ -12,41 +12,35 @@ export interface FunctionMessageProps extends ChatMessage {
   loading?: boolean;
 }
 
-const PluginMessage = memo<FunctionMessageProps>(
-  ({
-    content,
-    // loading,
-    name,
-  }) => {
-    const { t } = useTranslation('plugin');
-
-    const manifest = usePluginStore((s) => s.pluginManifestMap[name || '']);
-    let isJSON = true;
-    try {
-      JSON.parse(content);
-    } catch {
-      isJSON = false;
-    }
-
-    // if (!loading)
-
-    if (!isJSON) {
-      return (
-        <Flexbox gap={8} horizontal>
-          <div>
-            <Loading3QuartersOutlined spin />
-          </div>
-          {t('loading.content')}
-        </Flexbox>
-      );
-    }
-
-    if (!manifest?.ui?.url) return;
+const PluginMessage = memo<FunctionMessageProps>(({ content, name }) => {
+  const { t } = useTranslation('plugin');
 
+  const manifest = usePluginStore((s) => s.pluginManifestMap[name || '']);
+  let isJSON = true;
+  try {
+    JSON.parse(content);
+  } catch {
+    isJSON = false;
+  }
+
+  // if (!loading)
+
+  if (!isJSON) {
     return (
-      <CustomRender content={JSON.parse(content)} name={name || 'unknown'} url={manifest.ui?.url} />
+      <Flexbox gap={8} horizontal>
+        <div>
+          <Loading3QuartersOutlined spin />
+        </div>
+        {t('loading.content')}
+      </Flexbox>
     );
-  },
-);
+  }
+
+  if (!manifest?.ui?.url) return;
+
+  return (
+    <CustomRender content={JSON.parse(content)} name={name || 'unknown'} url={manifest.ui?.url} />
+  );
+});
 
 export default PluginMessage;

package/src/services/plugin.ts

@@ -1,6 +1,6 @@
 import { PluginRequestPayload, createHeadersWithPluginSettings } from '@lobehub/chat-plugin-sdk';
 
-import { usePluginStore } from '@/store/plugin';
+import { pluginSelectors, usePluginStore } from '@/store/plugin';
 import { getMessageError } from '@/utils/fetch';
 
 import { URLS } from './url';
@@ -17,10 +17,13 @@ export const fetchPlugin = async (
   params: PluginRequestPayload,
   options?: FetchChatModelOptions,
 ) => {
-  const settings = usePluginStore.getState().pluginsSettings?.[params.identifier];
+  const s = usePluginStore.getState();
+
+  const settings = pluginSelectors.getPluginSettingsById(params.identifier)(s);
+  const manifest = pluginSelectors.getPluginManifestById(params.identifier)(s);
 
   const res = await fetch(URLS.plugins, {
-    body: JSON.stringify(params),
+    body: JSON.stringify({ ...params, manifest }),
     headers: createHeadersWithPluginSettings(settings),
     method: 'POST',
     signal: options?.signal,