From 925c8ad6bced6fadba811e8541caa1afecc48a90 Mon Sep 17 00:00:00 2001
From: hxuanyu <2252193204@qq.com>
Date: Fri, 27 Jun 2025 10:24:02 +0800
Subject: [PATCH] =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E9=87=8D=E6=9E=84=EF=BC=8C?=
 =?UTF-8?q?=E5=A2=9E=E5=BC=BA=E6=89=A9=E5=B1=95=E6=80=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                     | 94 +++++++++++++++++--
 src/views/PreviewView.vue                     | 21 ++---
 .../clock/Config.vue}                         | 20 +---
 .../{ClockWidget.vue => clock/Widget.vue}     | 18 +---
 src/widgets/clock/index.ts                    | 11 +++
 src/widgets/clock/types.ts                    | 33 +++++++
 .../date/Config.vue}                          | 16 +---
 .../{DateWidget.vue => date/Widget.vue}       | 16 +---
 src/widgets/date/index.ts                     | 11 +++
 src/widgets/date/types.ts                     | 29 ++++++
 .../image/Config.vue}                         | 13 +--
 .../{ImageWidget.vue => image/Widget.vue}     | 13 +--
 src/widgets/image/index.ts                    | 11 +++
 src/widgets/image/types.ts                    | 23 +++++
 src/widgets/registry.ts                       | 86 +++--------------
 .../text/Config.vue}                          | 15 +--
 .../{TextWidget.vue => text/Widget.vue}       | 15 +--
 src/widgets/text/index.ts                     | 11 +++
 src/widgets/text/types.ts                     | 27 ++++++
 src/widgets/types.ts                          | 20 ++++
 20 files changed, 293 insertions(+), 210 deletions(-)
 rename src/{components/config/ClockConfig.vue => widgets/clock/Config.vue} (95%)
 rename src/widgets/{ClockWidget.vue => clock/Widget.vue} (90%)
 create mode 100644 src/widgets/clock/index.ts
 create mode 100644 src/widgets/clock/types.ts
 rename src/{components/config/DateConfig.vue => widgets/date/Config.vue} (95%)
 rename src/widgets/{DateWidget.vue => date/Widget.vue} (91%)
 create mode 100644 src/widgets/date/index.ts
 create mode 100644 src/widgets/date/types.ts
 rename src/{components/config/ImageConfig.vue => widgets/image/Config.vue} (94%)
 rename src/widgets/{ImageWidget.vue => image/Widget.vue} (89%)
 create mode 100644 src/widgets/image/index.ts
 create mode 100644 src/widgets/image/types.ts
 rename src/{components/config/TextConfig.vue => widgets/text/Config.vue} (95%)
 rename src/widgets/{TextWidget.vue => text/Widget.vue} (85%)
 create mode 100644 src/widgets/text/index.ts
 create mode 100644 src/widgets/text/types.ts
 create mode 100644 src/widgets/types.ts

diff --git a/README.md b/README.md
index 174ce55..1d271b4 100644
--- a/README.md
+++ b/README.md
@@ -83,12 +83,7 @@ npm run preview
 ```
 src/
 ├── assets/            # 静态资源
-├── components/        # 组件
-│   └── config/        # 小组件配置面板组件
-│       ├── ClockConfig.vue
-│       ├── DateConfig.vue
-│       ├── TextConfig.vue
-│       └── ImageConfig.vue
+├── components/        # 通用组件
 ├── router/            # 路由配置
 ├── utils/             # 工具函数
 │   └── configUtils.ts # 配置编码/解码工具
@@ -96,8 +91,91 @@ src/
 │   ├── HomeView.vue   # 主页
 │   ├── ConfigView.vue # 配置页面
 │   └── PreviewView.vue# 预览页面
-├── widgets/           # 小组件实现
-│   ├── registry.ts    # 小组件注册中心
+├── widgets/           # 小组件模块
+│   ├── clock/         # 时钟小组件模块
+│   │   ├── index.ts   # 模块导出
+│   │   ├── types.ts   # 类型定义
+│   │   ├── Widget.vue # 小组件组件
+│   │   └── Config.vue # 配置组件
+│   ├── date/          # 日期小组件模块
+│   ├── text/          # 文本小组件模块
+│   ├── image/         # 图片小组件模块
+│   └── registry.ts    # 小组件注册中心
+```
+
+## 小组件开发指南
+
+### 创建新小组件
+
+1. **创建小组件文件夹**：在 `src/widgets/` 下创建新的文件夹，如 `newwidget/`
+
+2. **创建必要文件**：
+   - `types.ts` - 定义配置接口和默认配置
+   - `Widget.vue` - 小组件显示组件
+   - `Config.vue` - 小组件配置组件
+   - `index.ts` - 模块导出文件
+
+3. **实现类型定义**（types.ts）：
+   ```typescript
+   // 小组件配置接口
+   export interface NewWidgetConfig {
+     // 配置属性定义
+   }
+   
+   // 默认配置
+   export const defaultConfig: NewWidgetConfig = {
+     // 默认值
+   };
+   ```
+
+4. **实现小组件组件**（Widget.vue）：
+   ```vue
+   <template>
+     <!-- 小组件UI -->
+   </template>
+   
+   <script setup lang="ts">
+   import type { NewWidgetConfig } from './types';
+   // 组件逻辑
+   </script>
+   ```
+
+5. **实现配置组件**（Config.vue）：
+   ```vue
+   <template>
+     <!-- 配置UI -->
+   </template>
+   
+   <script setup lang="ts">
+   import type { NewWidgetConfig } from './types';
+   // 配置逻辑
+   </script>
+   ```
+
+6. **导出模块**（index.ts）：
+   ```typescript
+   import Widget from './Widget.vue';
+   import Config from './Config.vue';
+   import { defaultConfig } from './types';
+   
+   export default {
+     label: '新小组件',
+     value: 'newwidget',
+     component: Widget,
+     configComponent: Config,
+     getDefaultConfig: () => defaultConfig
+   };
+   ```
+
+7. **注册小组件**：在 `registry.ts` 中导入并添加到 `widgets` 数组
+
+### 架构优势
+
+- **模块化设计**：每个小组件独立成模块，包含所有相关代码
+- **类型安全**：TypeScript 提供完整的类型检查和智能提示
+- **可扩展性**：添加新小组件无需修改核心逻辑，只需创建新模块并注册
+- **代码组织**：相关代码集中在同一文件夹，便于维护和理解
+- **零侵入**：新增小组件不会影响现有小组件和核心功能
 │   ├── ClockWidget.vue
 │   ├── DateWidget.vue
 │   ├── TextWidget.vue
diff --git a/src/views/PreviewView.vue b/src/views/PreviewView.vue
index 8076c2a..6dfe457 100644
--- a/src/views/PreviewView.vue
+++ b/src/views/PreviewView.vue
@@ -11,25 +11,18 @@
 <script setup lang="ts">
 import { ref, onMounted, computed } from 'vue';
 import { decodeConfig } from '../utils/configUtils';
+import { widgets } from '../widgets/registry';
 
-// 导入小组件组件
-import ClockWidget from '../widgets/ClockWidget.vue';
-import DateWidget from '../widgets/DateWidget.vue';
-import TextWidget from '../widgets/TextWidget.vue';
-import ImageWidget from '../widgets/ImageWidget.vue';
-
-// 小组件注册表
-const widgetRegistry = {
-  'clock': ClockWidget,
-  'date': DateWidget,
-  'text': TextWidget,
-  'image': ImageWidget
-};
+// 创建小组件注册表
+const widgetRegistry: Record<string, any> = {};
+widgets.forEach(widget => {
+  widgetRegistry[widget.value] = widget.component;
+});
 
 const widgetType = ref('');
 const widgetConfig = ref({});
 const widgetComponent = computed(() => {
-  return widgetRegistry[widgetType.value as keyof typeof widgetRegistry];
+  return widgetRegistry[widgetType.value];
 });
 
 onMounted(() => {
diff --git a/src/components/config/ClockConfig.vue b/src/widgets/clock/Config.vue
similarity index 95%
rename from src/components/config/ClockConfig.vue
rename to src/widgets/clock/Config.vue
index b26757c..acf850f 100644
--- a/src/components/config/ClockConfig.vue
+++ b/src/widgets/clock/Config.vue
@@ -99,6 +99,8 @@
         </el-form-item>
       </template>
       
+      <el-divider>预设样式</el-divider>
+      
       <el-form-item>
         <el-button-group>
           <el-button type="primary" @click="applyPreset('modern')">现代风格</el-button>
@@ -113,23 +115,7 @@
 
 <script setup lang="ts">
 import { ref, watch, onMounted } from 'vue';
-
-// 为配置定义 props 接口
-interface ClockConfig {
-  format: string;
-  color: string;
-  fontSize: number;
-  fontWeight: string;
-  fontFamily: string;
-  textShadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-  useGradient: boolean;
-  gradientColors: string[];
-  showSeconds: boolean;
-  showDate: boolean;
-  dateFormat: string;
-}
+import type { ClockConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/ClockWidget.vue b/src/widgets/clock/Widget.vue
similarity index 90%
rename from src/widgets/ClockWidget.vue
rename to src/widgets/clock/Widget.vue
index 427aefe..efb2fc6 100644
--- a/src/widgets/ClockWidget.vue
+++ b/src/widgets/clock/Widget.vue
@@ -8,23 +8,7 @@
 <script setup lang="ts">
 import { ref, computed, onMounted, onUnmounted, watch } from 'vue';
 import dayjs from 'dayjs';
-
-// Define props interface
-interface ClockConfig {
-  format: string;
-  color: string;
-  fontSize: number;
-  fontWeight: string;
-  fontFamily: string;
-  textShadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-  useGradient: boolean;
-  gradientColors: string[];
-  showSeconds: boolean;
-  showDate: boolean;
-  dateFormat: string;
-}
+import type { ClockConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/clock/index.ts b/src/widgets/clock/index.ts
new file mode 100644
index 0000000..ee5e6c6
--- /dev/null
+++ b/src/widgets/clock/index.ts
@@ -0,0 +1,11 @@
+import Widget from './Widget.vue';
+import Config from './Config.vue';
+import { defaultConfig } from './types';
+
+export default {
+  label: '时钟小组件',
+  value: 'clock',
+  component: Widget,
+  configComponent: Config,
+  getDefaultConfig: () => defaultConfig
+};
diff --git a/src/widgets/clock/types.ts b/src/widgets/clock/types.ts
new file mode 100644
index 0000000..342b6ae
--- /dev/null
+++ b/src/widgets/clock/types.ts
@@ -0,0 +1,33 @@
+// 时钟小组件配置接口
+export interface ClockConfig {
+  format: string;
+  color: string;
+  fontSize: number;
+  fontWeight: string;
+  fontFamily: string;
+  textShadow: boolean;
+  shadowColor: string;
+  shadowBlur: number;
+  useGradient: boolean;
+  gradientColors: string[];
+  showSeconds: boolean;
+  showDate: boolean;
+  dateFormat: string;
+}
+
+// 时钟小组件默认配置
+export const defaultConfig: ClockConfig = {
+  format: 'HH:mm:ss',
+  color: '#ffffff',
+  fontSize: 48,
+  fontWeight: 'normal',
+  fontFamily: 'Arial',
+  textShadow: false,
+  shadowColor: 'rgba(0,0,0,0.5)',
+  shadowBlur: 4,
+  useGradient: false,
+  gradientColors: ['#ff0000', '#0000ff'],
+  showSeconds: true,
+  showDate: false,
+  dateFormat: 'YYYY-MM-DD'
+};
diff --git a/src/components/config/DateConfig.vue b/src/widgets/date/Config.vue
similarity index 95%
rename from src/components/config/DateConfig.vue
rename to src/widgets/date/Config.vue
index c09f9a4..93024bc 100644
--- a/src/components/config/DateConfig.vue
+++ b/src/widgets/date/Config.vue
@@ -95,21 +95,7 @@
 
 <script setup lang="ts">
 import { ref, watch, onMounted } from 'vue';
-
-// Define props interface for config
-interface DateConfig {
-  format: string;
-  color: string;
-  fontSize: number;
-  fontWeight: string;
-  fontFamily: string;
-  textShadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-  useGradient: boolean;
-  gradientColors: string[];
-  showWeekday: boolean;
-}
+import type { DateConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/DateWidget.vue b/src/widgets/date/Widget.vue
similarity index 91%
rename from src/widgets/DateWidget.vue
rename to src/widgets/date/Widget.vue
index b91d988..92da062 100644
--- a/src/widgets/DateWidget.vue
+++ b/src/widgets/date/Widget.vue
@@ -7,21 +7,7 @@
 <script setup lang="ts">
 import { ref, computed, onMounted, onUnmounted, watch } from 'vue';
 import dayjs from 'dayjs';
-
-// Define props interface
-interface DateConfig {
-  format: string;
-  color: string;
-  fontSize: number;
-  fontWeight: string;
-  fontFamily: string;
-  textShadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-  useGradient: boolean;
-  gradientColors: string[];
-  showWeekday: boolean;
-}
+import type { DateConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/date/index.ts b/src/widgets/date/index.ts
new file mode 100644
index 0000000..d0e0291
--- /dev/null
+++ b/src/widgets/date/index.ts
@@ -0,0 +1,11 @@
+import Widget from './Widget.vue';
+import Config from './Config.vue';
+import { defaultConfig } from './types';
+
+export default {
+  label: '日期小组件',
+  value: 'date',
+  component: Widget,
+  configComponent: Config,
+  getDefaultConfig: () => defaultConfig
+};
diff --git a/src/widgets/date/types.ts b/src/widgets/date/types.ts
new file mode 100644
index 0000000..d61e608
--- /dev/null
+++ b/src/widgets/date/types.ts
@@ -0,0 +1,29 @@
+// 日期小组件配置接口
+export interface DateConfig {
+  format: string;
+  color: string;
+  fontSize: number;
+  fontWeight: string;
+  fontFamily: string;
+  textShadow: boolean;
+  shadowColor: string;
+  shadowBlur: number;
+  useGradient: boolean;
+  gradientColors: string[];
+  showWeekday: boolean;
+}
+
+// 日期小组件默认配置
+export const defaultConfig: DateConfig = {
+  format: 'YYYY-MM-DD',
+  color: '#ffffff',
+  fontSize: 32,
+  fontWeight: 'normal',
+  fontFamily: 'Arial',
+  textShadow: false,
+  shadowColor: 'rgba(0,0,0,0.5)',
+  shadowBlur: 4,
+  useGradient: false,
+  gradientColors: ['#ff0000', '#0000ff'],
+  showWeekday: true
+};
diff --git a/src/components/config/ImageConfig.vue b/src/widgets/image/Config.vue
similarity index 94%
rename from src/components/config/ImageConfig.vue
rename to src/widgets/image/Config.vue
index c524526..6500901 100644
--- a/src/components/config/ImageConfig.vue
+++ b/src/widgets/image/Config.vue
@@ -59,18 +59,7 @@
 
 <script setup lang="ts">
 import { ref, watch, onMounted } from 'vue';
-
-// Define props interface for config
-interface ImageConfig {
-  imageUrl: string;
-  width: number;
-  height: number;
-  opacity: number;
-  borderRadius: number;
-  shadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-}
+import type { ImageConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/ImageWidget.vue b/src/widgets/image/Widget.vue
similarity index 89%
rename from src/widgets/ImageWidget.vue
rename to src/widgets/image/Widget.vue
index 7643ae4..f930f72 100644
--- a/src/widgets/ImageWidget.vue
+++ b/src/widgets/image/Widget.vue
@@ -14,18 +14,7 @@
 
 <script setup lang="ts">
 import { computed } from 'vue';
-
-// Define props interface
-interface ImageConfig {
-  imageUrl: string;
-  width: number;
-  height: number;
-  opacity: number;
-  borderRadius: number;
-  shadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-}
+import type { ImageConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/image/index.ts b/src/widgets/image/index.ts
new file mode 100644
index 0000000..cde3e0d
--- /dev/null
+++ b/src/widgets/image/index.ts
@@ -0,0 +1,11 @@
+import Widget from './Widget.vue';
+import Config from './Config.vue';
+import { defaultConfig } from './types';
+
+export default {
+  label: '图片小组件',
+  value: 'image',
+  component: Widget,
+  configComponent: Config,
+  getDefaultConfig: () => defaultConfig
+};
diff --git a/src/widgets/image/types.ts b/src/widgets/image/types.ts
new file mode 100644
index 0000000..3173f36
--- /dev/null
+++ b/src/widgets/image/types.ts
@@ -0,0 +1,23 @@
+// 图片小组件配置接口
+export interface ImageConfig {
+  imageUrl: string;
+  width: number;
+  height: number;
+  opacity: number;
+  borderRadius: number;
+  shadow: boolean;
+  shadowColor: string;
+  shadowBlur: number;
+}
+
+// 图片小组件默认配置
+export const defaultConfig: ImageConfig = {
+  imageUrl: '',
+  width: 200,
+  height: 200,
+  opacity: 1,
+  borderRadius: 0,
+  shadow: false,
+  shadowColor: 'rgba(0,0,0,0.5)',
+  shadowBlur: 10
+};
diff --git a/src/widgets/registry.ts b/src/widgets/registry.ts
index 4fe467b..cb716b9 100644
--- a/src/widgets/registry.ts
+++ b/src/widgets/registry.ts
@@ -1,81 +1,23 @@
-// 小组件组件及其配置
-import ClockWidget from './ClockWidget.vue';
-import DateWidget from './DateWidget.vue';
-import TextWidget from './TextWidget.vue';
-import ImageWidget from './ImageWidget.vue';
-
-// 配置组件
-import ClockConfig from '../components/config/ClockConfig.vue';
-import DateConfig from '../components/config/DateConfig.vue';
-import TextConfig from '../components/config/TextConfig.vue';
-import ImageConfig from '../components/config/ImageConfig.vue';
+// 导入各个小组件模块
+import ClockWidget from './clock';
+import DateWidget from './date';
+import TextWidget from './text';
+import ImageWidget from './image';
 
 // 小组件注册表
 export const widgets = [
-  { label: '时钟小组件', value: 'clock', component: ClockWidget, configComponent: ClockConfig },
-  { label: '日期小组件', value: 'date', component: DateWidget, configComponent: DateConfig },
-  { label: '文本小组件', value: 'text', component: TextWidget, configComponent: TextConfig },
-  { label: '图片小组件', value: 'image', component: ImageWidget, configComponent: ImageConfig },
+  ClockWidget,
+  DateWidget,
+  TextWidget,
+  ImageWidget,
 ];
 
 // 获取小组件默认配置
 export const getDefaultConfig = (widgetType: string) => {
-  switch (widgetType) {
-    case 'clock':
-      return {
-        format: 'HH:mm:ss',
-        color: '#ffffff',
-        fontSize: 48,
-        fontWeight: 'normal',
-        fontFamily: 'Arial',
-        textShadow: false,
-        shadowColor: 'rgba(0,0,0,0.5)',
-        shadowBlur: 4,
-        useGradient: false,
-        gradientColors: ['#ff0000', '#0000ff'],
-        showSeconds: true,
-        showDate: false,
-        dateFormat: 'YYYY-MM-DD'
-      };
-    case 'date':
-      return {
-        format: 'YYYY-MM-DD',
-        color: '#ffffff',
-        fontSize: 32,
-        fontWeight: 'normal',
-        fontFamily: 'Arial',
-        textShadow: false,
-        shadowColor: 'rgba(0,0,0,0.5)',
-        shadowBlur: 4,
-        useGradient: false,
-        gradientColors: ['#ff0000', '#0000ff'],
-        showWeekday: true
-      };
-    case 'text':
-      return {
-        text: 'Sample Text',
-        color: '#ffffff',
-        fontSize: 32,
-        fontWeight: 'normal',
-        fontFamily: 'Arial',
-        textShadow: false,
-        shadowColor: 'rgba(0,0,0,0.5)',
-        shadowBlur: 4,
-        useGradient: false,
-        gradientColors: ['#ff0000', '#0000ff'],
-      };
-    case 'image':
-      return {
-        imageUrl: '',
-        width: 200,
-        height: 200,
-        opacity: 1,
-        borderRadius: 0,
-        shadow: false,
-        shadowColor: 'rgba(0,0,0,0.5)',
-        shadowBlur: 10
-      };
-    default:
-      return {};
+  for (const widget of widgets) {
+    if (widget.value === widgetType) {
+      return widget.getDefaultConfig();
+    }
   }
+  return {};
 };
diff --git a/src/components/config/TextConfig.vue b/src/widgets/text/Config.vue
similarity index 95%
rename from src/components/config/TextConfig.vue
rename to src/widgets/text/Config.vue
index 5643ce4..0980ff7 100644
--- a/src/components/config/TextConfig.vue
+++ b/src/widgets/text/Config.vue
@@ -85,20 +85,7 @@
 
 <script setup lang="ts">
 import { ref, watch, onMounted } from 'vue';
-
-// Define props interface for config
-interface TextConfig {
-  text: string;
-  color: string;
-  fontSize: number;
-  fontWeight: string;
-  fontFamily: string;
-  textShadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-  useGradient: boolean;
-  gradientColors: string[];
-}
+import type { TextConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/TextWidget.vue b/src/widgets/text/Widget.vue
similarity index 85%
rename from src/widgets/TextWidget.vue
rename to src/widgets/text/Widget.vue
index f54ad12..edd1af9 100644
--- a/src/widgets/TextWidget.vue
+++ b/src/widgets/text/Widget.vue
@@ -6,20 +6,7 @@
 
 <script setup lang="ts">
 import { computed } from 'vue';
-
-// Define props interface
-interface TextConfig {
-  text: string;
-  color: string;
-  fontSize: number;
-  fontWeight: string;
-  fontFamily: string;
-  textShadow: boolean;
-  shadowColor: string;
-  shadowBlur: number;
-  useGradient: boolean;
-  gradientColors: string[];
-}
+import type { TextConfig } from './types';
 
 // Define props with default values
 const props = withDefaults(defineProps<{
diff --git a/src/widgets/text/index.ts b/src/widgets/text/index.ts
new file mode 100644
index 0000000..7ccb65a
--- /dev/null
+++ b/src/widgets/text/index.ts
@@ -0,0 +1,11 @@
+import Widget from './Widget.vue';
+import Config from './Config.vue';
+import { defaultConfig } from './types';
+
+export default {
+  label: '文本小组件',
+  value: 'text',
+  component: Widget,
+  configComponent: Config,
+  getDefaultConfig: () => defaultConfig
+};
diff --git a/src/widgets/text/types.ts b/src/widgets/text/types.ts
new file mode 100644
index 0000000..d27846d
--- /dev/null
+++ b/src/widgets/text/types.ts
@@ -0,0 +1,27 @@
+// 文本小组件配置接口
+export interface TextConfig {
+  text: string;
+  color: string;
+  fontSize: number;
+  fontWeight: string;
+  fontFamily: string;
+  textShadow: boolean;
+  shadowColor: string;
+  shadowBlur: number;
+  useGradient: boolean;
+  gradientColors: string[];
+}
+
+// 文本小组件默认配置
+export const defaultConfig: TextConfig = {
+  text: 'Sample Text',
+  color: '#ffffff',
+  fontSize: 32,
+  fontWeight: 'normal',
+  fontFamily: 'Arial',
+  textShadow: false,
+  shadowColor: 'rgba(0,0,0,0.5)',
+  shadowBlur: 4,
+  useGradient: false,
+  gradientColors: ['#ff0000', '#0000ff']
+};
diff --git a/src/widgets/types.ts b/src/widgets/types.ts
new file mode 100644
index 0000000..daa4731
--- /dev/null
+++ b/src/widgets/types.ts
@@ -0,0 +1,20 @@
+import type { Component } from 'vue';
+
+// 基础小组件配置接口
+export interface BaseWidgetConfig {
+  [key: string]: any;
+}
+
+// 小组件注册信息接口
+export interface WidgetRegistration {
+  label: string;
+  value: string;
+  component: Component;
+  configComponent: Component;
+  getDefaultConfig: () => BaseWidgetConfig;
+}
+
+// 小组件模块导出接口
+export interface WidgetModule {
+  registration: WidgetRegistration;
+}