🎉 Initial commit

examples/README.md

@@ -0,0 +1,117 @@
+# PixelNebula 示例
+
+[英文版](README_EN.md) | 中文版
+
+## 示例文件
+
+这个目录包含了多个示例，展示了如何使用 PixelNebula 库的各种功能。每个示例都是独立的，你可以单独运行它们来了解特定的功能。
+
+| 文件名 | 描述 |
+|--------|------|
+| [01_basic_usage.go](01_basic_usage.go) | 演示基本的头像生成，包括常规头像和无环境头像 |
+| [02_styles_and_themes.go](02_styles_and_themes.go) | 展示如何使用不同的样式和主题 |
+| [03_custom_theme_and_style.go](03_custom_theme_and_style.go) | 演示如何创建和使用自定义主题和样式 |
+| [04_all_animations.go](04_all_animations.go) | 展示所有支持的动画效果 |
+| [05_svg_builder_chain.go](05_svg_builder_chain.go) | 演示如何使用链式API生成SVG |
+| [06_cache_system.go](06_cache_system.go) | 展示缓存系统的功能，包括默认缓存、自定义缓存和监控 |
+| [07_format_conversion.go](07_format_conversion.go) | 展示如何将SVG转换为其他格式 |
+| [08_random_avatar_generator.go](08_random_avatar_generator.go) | 交互式的随机头像生成器，支持多种样式、主题和输出格式 |
+
+## 如何运行示例
+
+确保您已正确安装 Go 环境并设置了 GOPATH。然后，按照以下步骤运行示例：
+
+### 运行单个示例
+
+```bash
+# 例如，运行基本用法示例
+go run 01_basic_usage.go
+```
+
+### 运行所有示例
+
+```bash
+for file in *_*.go; do
+  echo "🚀 运行示例: $file"
+  go run $file
+  echo "------------------------"
+done
+```
+
+## 示例说明
+
+### 01_basic_usage.go
+
+这个示例展示了 PixelNebula 的基本功能，包括：
+
+- 创建一个基本的头像
+- 生成一个无环境的头像
+- 处理错误和保存文件
+
+### 02_styles_and_themes.go
+
+这个示例展示了如何使用不同的样式和主题：
+
+- 使用预定义的样式生成头像
+- 应用不同的主题
+- 组合样式和主题
+
+### 03_custom_theme_and_style.go
+
+这个示例展示了如何创建和使用自定义主题和样式：
+
+- 创建自定义颜色主题
+- 定义自定义样式
+- 组合自定义主题和样式
+
+### 04_all_animations.go
+
+这个示例展示了所有支持的动画效果：
+
+- 旋转动画
+- 渐变动画
+- 淡入淡出效果
+- 变换动画
+- 颜色变换
+- 弹跳效果
+- 波浪动画
+- 闪烁效果
+- 路径动画
+
+### 05_svg_builder_chain.go
+
+这个示例展示了如何使用链式API：
+
+- 使用链式调用创建简单的SVG
+- 添加动画效果
+- 直接保存到文件
+- 转换为Base64
+
+### 06_cache_system.go
+
+这个示例展示了缓存系统的功能：
+
+- 使用默认缓存
+- 配置自定义缓存
+- 监控缓存性能
+- 使用压缩缓存
+
+### 07_format_conversion.go
+
+这个示例展示了格式转换功能：
+
+- 转换为Base64
+- 其他格式暂未找到完美解决方案，欢迎 PR
+
+### 08_random_avatar_generator.go
+
+这个示例是一个交互式的随机头像生成器：
+
+- 随机生成不同样式和主题的头像
+
+## 提示
+
+- 每个示例文件顶部都有详细的注释，解释了该示例所展示的功能
+- 如果遇到任何问题，请检查文件中的错误处理部分
+- 生成的头像会保存在示例代码指定的位置
+- 有些示例可能需要创建目录来保存生成的文件