# dice-12

**Repository Path**: thiswind/dice-12

## Basic Information

- **Project Name**: dice-12
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 掷骰子 - 十二面体骰子APP

一款简约有趣的12面骰子掷骰子工具，主打"遇事不决，掷个骰子"的使用场景，界面简洁可爱。

## 功能介绍

- 🎲 **12面骰子**：点击按钮掷骰子，随机生成1-12之间的点数
- ✨ **流畅动画**：数字快速滚动效果，1~2秒后随机停止
- 🎨 **精美界面**：完全按照Material Design 3规范设计，紫色系主题
- 📱 **多平台支持**：支持Android、iOS和Web平台

## 界面展示

![应用界面](images/app_screenshot.png)

## 开发技术

- **框架**：Flutter 3.38.5
- **设计规范**：Material Design 3 (M3)
- **语言**：Dart 3.10.4

## 安装与运行

### 环境要求

- Flutter SDK >= 3.38.0
- Dart SDK >= 3.10.0
- Android Studio / Visual Studio Code
- Android/iOS模拟器或真机

### 步骤

1. **克隆代码**
```bash
git clone <repository-url>
cd zhi_tou_zI
```

2. **安装依赖**
```bash
flutter pub get
```

3. **运行应用**

在Android模拟器/真机上运行：
```bash
flutter run
```

在iOS模拟器/真机上运行：
```bash
flutter run -d ios
```

在Web浏览器中运行：
```bash
flutter run -d chrome --web-port 8080
```

4. **构建应用**

构建Android APK：
```bash
flutter build apk
```

构建iOS应用：
```bash
flutter build ios
```

构建Web应用：
```bash
flutter build web
```

## 项目结构

```
zhi_tou_zI/
├── lib/
│   └── main.dart              # 主应用代码
├── android/                   # Android平台代码
├── ios/                       # iOS平台代码
├── web/                       # Web平台代码
├── images/                    # 应用截图和资源
├── pubspec.yaml               # 项目配置和依赖
└── README.md                  # 项目说明文档
```

## 使用说明

1. 打开应用后，界面显示当前点数（初始为1）
2. 点击下方紫色FAB按钮开始掷骰子
3. 数字会快速滚动变化，1~2秒后随机停在某个点数
4. 滚动过程中点击按钮无效，防止重复触发

## 特色亮点

- ✅ 完全按照Figma设计稿像素级还原
- ✅ 流畅的数字滚动动画效果
- ✅ 优雅的紫色系配色方案
- ✅ 低功耗设计，不使用复杂动画
- ✅ 完善的防抖处理机制
- ✅ 支持多平台运行

## 后续规划

- [ ] 支持自定义骰子面数
- [ ] 添加历史记录功能
- [ ] 支持多种主题配色
- [ ] 添加音效反馈

## License

MIT License