# 数独游戏小程序

**Repository Path**: tiamstar/sudoku-game-mini-program

## Basic Information

- **Project Name**: 数独游戏小程序
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-03-25
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数独微信小程序

一个功能完整、界面美观的数独游戏微信小程序。

## 功能特点

- 三种难度模式（简单、中等、困难）
- 实时冲突检测
- 提示系统
- 计时和计分系统
- 排行榜功能
- 深色模式支持
- 多主题颜色切换
- 音效和震动反馈
- 自动保存游戏进度

## 技术栈

- 微信小程序原生框架
- WXML + WXSS + JavaScript
- 自定义组件
- 本地存储
- 微信云开发

## 项目结构

```
├── pages/                # 页面文件
│   ├── index/           # 首页
│   ├── game/            # 游戏页
│   ├── ranking/         # 排行榜
│   └── settings/        # 设置页
├── components/          # 自定义组件
│   ├── sudoku-board/    # 数独棋盘
│   ├── number-keypad/   # 数字键盘
│   └── game-timer/      # 游戏计时器
├── utils/              # 工具类
│   ├── sudoku.js       # 数独生成算法
│   ├── theme.js        # 主题管理
│   └── feedback.js     # 反馈系统
├── images/             # 图片资源
├── sounds/             # 音效资源
└── styles/             # 全局样式
```

## 开发环境

- 微信开发者工具
- Node.js 12.0+
- npm 6.0+

## 安装和运行

1. 克隆项目
```bash
git clone https://gitee.com/tiamstar/sudoku-game-mini-program.git
```

2. 安装依赖
```bash
npm install
```

3. 在微信开发者工具中导入项目
- 打开微信开发者工具
- 选择"导入项目"
- 选择项目目录
- 填入你的小程序 AppID

4. 运行项目
- 在微信开发者工具中点击"编译"

## 配置说明

1. 在 `project.config.json` 中配置你的小程序 AppID
2. 在 `app.js` 中配置云开发环境（如果需要）
3. 在 `utils/theme.js` 中可以自定义主题颜色

## 使用说明

1. 游戏规则
   - 在9x9的格子中填入1-9的数字
   - 每行、每列、每个3x3宫格中的数字不能重复
   - 初始数字不能修改

2. 操作方式
   - 点击空白格子激活输入
   - 使用数字键盘输入数字
   - 长按格子显示候选数字
   - 点击提示按钮获取帮助

3. 计分规则
   - 基础分 = 1000 × 难度系数
   - 难度系数：简单1.0、中等1.5、困难2.0
   - 时间惩罚：每秒扣2分

## 贡献指南

1. Fork 项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 版本历史

- v1.0.0 (2024-03-xx)
  - 初始版本发布
  - 实现基本游戏功能
  - 添加排行榜系统
  - 支持深色模式

## 许可证

MIT License

## 联系方式

- 邮箱：lff203828@outlook.com

## 致谢

感谢所有为这个项目做出贡献的开发者！