# huya-score

**Repository Path**: freeFile/huya-score

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-28
- **Last Updated**: 2025-12-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 麻将计分小程序

一个简单易用的麻将计分小程序，支持扫码快速加入计分，每次结束后能看到总的记分情况。

## 功能特点

1. **扫码加入**：通过二维码快速邀请好友加入计分
2. **实时计分**：每局结束后实时更新分数
3. **分数平衡验证**：确保每局分数总和为0，避免计分错误
4. **历史记录**：查看历史游戏记录和个人数据
5. **多模式支持**：支持普通模式和台板模式

## 项目结构

```
huya-score/
├── app.js              # 小程序入口文件
├── app.json            # 小程序全局配置
├── app.wxss            # 小程序全局样式
├── pages/              # 页面目录
│   ├── index/          # 首页
│   ├── invite/         # 邀请页面
│   ├── scoring/        # 计分页面
│   ├── records/        # 记录页面
│   └── mine/           # 我的页面
├── images/             # 图片资源目录
└── README.md           # 项目说明文档
```

## 开发说明

### 环境要求

- 微信开发者工具
- 微信小程序基础库 2.2.3 或以上

### 启动项目

1. 克隆项目到本地
2. 使用微信开发者工具打开项目
3. 配置云开发环境（可选）
4. 运行项目

### 主要页面说明

1. **首页**：显示用户信息，提供邀请好友入口
2. **邀请页面**：生成二维码，管理参与者，开始计分
3. **计分页面**：每局麻将的计分界面，支持分数调整和确认
4. **记录页面**：查看历史记录，支持按时间筛选
5. **我的页面**：个人中心，提供会员、数据等功能入口

## 使用流程

1. 打开小程序，进入首页
2. 点击"邀请好友扫一扫参与计分"
3. 生成二维码，好友扫码加入
4. 点击"开始计分"进入计分页面
5. 每局结束后输入各方分数，点击"确认本局"
6. 游戏结束后点击"结束游戏"，查看最终得分
7. 在"记录"页面查看历史记录

## 技术栈

- 微信小程序原生开发
- 云开发（可选）

## 注意事项

1. 确保每局分数总和为0，否则无法确认本局
2. 扫码功能需要配置云开发环境或后端服务
3. 历史记录默认保存在本地存储中

## 后续优化

1. 接入云开发，实现数据持久化
2. 添加更多游戏模式和规则
3. 优化UI设计，提升用户体验
4. 添加数据统计和分析功能
5. 支持分享游戏结果到微信

## 许可证

MIT