easyai-plugin-dev-kit/README.md
2025-08-30 15:00:30 +08:00

3.3 KiB
Raw Blame History

EasyAI 远程组件项目

项目介绍

本项目支持以插件的方式为EasyAI平台提供远程组件服务以实现对EasyAI平台前端组件库进行扩展实现自定义组件以满足业务需求。

功能描述

  • 支持扩展绘画组件库
  • 支持扩展首页组件库
  • 支持应用引导组件库

组件开发

项目启动

  1. 安装依赖
pnpm install
  1. 启动项目
pnpm dev
  1. 访问地址:http://localhost:3201
  2. 组件目录components
  3. 维护组件信息目录manifest
  4. 组件调试入口: app.vue
  5. EasyAI平台全局注入的数据和方法: types/common.ts
    1. 注入的素材库数据GlobalInjectMaterials
      • mock数据composables/mock/material.data.ts
      • 在组件中使用components/RecommendedImages.vue
        const { materials: materialList } =
            inject<GlobalInjectMaterials>(GlobalInjectKeyConst.AllMaterials, {
            materials: ref<IImageSource>([]),
            }) || {};
        
    2. 注入的上传文件方法GlobalInjectUploadFileToOSS
      • 在组件中使用components/drawPanne/ImageUpload.vue
        const { useUtilsUploadFileToOSS } = inject<GlobalInjectUploadFileToOSS>(
            GlobalInjectKeyConst.UploadFileToOSS,
            {
             useUtilsUploadFileToOSS: async (file: File | Blob, filename?: string) => "",
            },
         );
        

示例组件 (图片上传组件)

  1. 组件位置components/drawPanne/ImageUpload.vue
    正常的nuxt(vue3)项目组件开发直接在components文件夹下创建即可
  2. 维护组件信息文件manifest/ImageUpload.ts
    需要参照IComponentMateInfo类型约束文件进行定义
export default {
    name: "DrawImageUpload", // 组件名称
    path: "./components/drawPanne/ImageUpload.vue", // 组件路径
    scenes: ComponentSceneConst.DrawPanne, // 组件场景
    description: "A image upload component", // 组件描述
    data: { // 组件数据
        paramName: "upload_image_path", // 参数名称
        label: "图片上传", // 组件标签
        icon: "icon-park:upload-picture", // 组件图标
        group: ComponentGroupConst.IMAGE, // 组件分组
        isRefComponent: true, // 是否为引用组件 (引用组件,在执行绘画的时候会执行参数赋值操作)
    },
} satisfies IComponentMateInfo;
  1. 组件调试入口app.vue
<template>
  <div class="remote-ui">
    <!--    调试对象-->
    <DrawPanneImageUpload />
  </div>
</template>
<script lang="ts" setup>
import {
  GlobalInjectKeyConst,
  type GlobalInjectMaterials,
} from "~/types/common";
import { MockMaterials } from "~/composables/mock/material.data";

const materialData = ref(MockMaterials);
/**
 * EasyAI平台已全局注入素材库库信息这里使用mock数据用于调试
 */
provide<GlobalInjectMaterials>(GlobalInjectKeyConst.AllMaterials, {
  materials: materialData,
  refreshMaterials: async () => [],
});
</script>

部署

  1. 打包
pnpm build
  1. 启动项目
pnpm serve
  1. 访问
http://localhost:3200

使用

  • 维护 EasyAI 远程组件项目 远程组件管理