diff --git a/README.md b/README.md
index 994644f25fa06fdd9d539e23bb2f5c75a096aebb..5ebe2119b5add93b2023cdd7656fb0df999d43d4 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,84 @@
-
-
-
-
-
-Waddle2.0
-
-
+# Waddle2.0
-让 CoCo 没有难做的控件
+
-[](https://gitee.com/cocotais/waddle/stargazers) [](https://gitee.com/cocotais/waddle/members)
-
+Waddle 是由 Cocotais 基于 [Boxy](https://gitee.com/cocotais/boxy) 2.0 开发的 CoCo 自定义控件图形化编辑器。
-
+## 简介
-### 简介
+Waddle 是一个图形化编辑器,用于简化 CoCo 控件的开发过程。它基于 Boxy 框架,提供直观的界面和强大的功能,使开发者能够轻松创建和管理控件。
-Waddle 是由 Cocotais 基于 [Boxy](https://gitee.com/cocotais/boxy)2.0 开发的 CoCo 自定义控件 图形化编辑器
+## 使用
-### 使用
+- 稳定版访问地址:https://waddle.cocotais.cn
-- 稳定版:https://waddle.cocotais.cn
+## 主要功能
+
+- **图形化编辑**:通过拖放操作,轻松设计和编辑控件。
+- **代码空间**:集成代码编辑功能,实时预览和调试。
+- **工具箱**:提供丰富的控件和组件,方便快速构建。
+- **主题支持**:支持多种主题切换,提供个性化体验。
+- **搜索功能**:快速查找和定位控件或代码片段。
+- **预览与调试**:支持控件的实时预览和调试功能。
+
+## 技术栈
+
+- React
+- Boxy 框架
+- JavaScript
+- HTML / CSS
+
+## 目录结构
+
+```
+├── public/ # 静态资源目录
+├── src/ # 源代码目录
+│ ├── blocks/ # 控件定义模块
+│ ├── codespace/ # 代码编辑器相关代码
+│ ├── dialog/ # 对话框组件
+│ ├── dropdown/ # 下拉菜单组件
+│ ├── generators/ # 代码生成器
+│ ├── icon/ # 图标资源
+│ ├── screenshot/ # 截图功能组件
+│ ├── theme/ # 主题配置
+│ ├── toolbox/ # 工具箱组件
+│ ├── trashcan/ # 废纸篓功能组件
+│ ├── utils/ # 工具类
+│ ├── workspace/ # 工作区组件
+│ └── zoomBox/ # 缩放功能组件
+├── .eslintignore # ESLint 忽略配置
+├── .eslintrc.cjs # ESLint 配置文件
+├── .gitignore # Git 忽略配置
+├── .prettierignore # Prettier 忽略配置
+├── .prettierrc.js # Prettier 配置文件
+├── .stylelintrc.js # Stylelint 配置文件
+├── LICENSE # 项目许可证
+├── README.md # 项目说明文档
+├── favicon.ico # 网站图标
+├── index.html # 入口 HTML 文件
+├── package.json # 项目依赖及脚本配置
+├── pnpm-lock.yaml # pnpm 依赖锁定文件
+├── src/App.vue # Vue 主应用组件
+├── src/main.js # 应用入口文件
+├── src/theme/theme.less # 主题样式表
+├── src/toolbox/toolbox.json # 工具箱配置文件
+├── src/tutorials/ # 教程文件
+├── src/utils/ # 工具类函数
+└── vite.config.mjs # Vite 构建配置文件
+```
+
+## 贡献
+
+如果你有兴趣为 Waddle 做出贡献,请查看 [贡献指南](CONTRIBUTING.md)。
+
+## 许可证
+
+本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。
+
+## 相关项目
+
+- [Boxy](https://gitee.com/cocotais/boxy):Waddle 依赖的可视化开发框架。
+
+如需进一步了解,请访问我们的 [Gitee 项目页面](https://gitee.com/cocotais/waddle)。
\ No newline at end of file