# 前端抽奖机插件

**Repository Path**: chenkk0613/lottery

## Basic Information

- **Project Name**: 前端抽奖机插件
- **Description**: 纯前端抽奖机插件，支持数字抽奖和姓名抽奖，数据存储在浏览器本地
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LotteryPlugin - 前端抽奖机插件

纯前端实现的抽奖机插件，支持数字抽奖和姓名抽奖，所有数据存储在浏览器本地存储中。

## 在线体验

- 介绍页：[lottery-demo.html](./lottery-demo.html)
- 数字抽奖：[lottery/number.html](./lottery/number.html)
- 姓名抽奖：[lottery/name.html](./lottery/name.html)

## 功能特性

### 数字抽奖
- 自定义号码范围（起始号码 - 结束号码）
- 支持排除指定范围内的号码
- 空格键快速切换排除名单启用/禁用

### 姓名抽奖
- 手动输入姓名列表（支持逗号或换行分隔）
- Excel 文件导入（支持 .xlsx/.xls 格式）
- 支持设置降低中奖概率名单（中奖概率降至 10%）
- 提供 Excel 模板下载

### 通用功能
- **本地存储**：所有数据保存在浏览器 localStorage 中，刷新页面不丢失
- **自定义外观**：支持上传背景图片，自定义页面文字
- **快捷键支持**：可自定义所有操作的快捷键
- **数据导出**：未中奖名单支持导出为 Excel 文件
- **连续抽奖**：支持一键连续抽取 5 个

## 快捷键说明

| 快捷键 | 功能 |
|--------|------|
| Tab | 开始/停止抽奖 |
| Enter | 连续抽取 5 个 |
| Space | 切换排除/降低概率名单 |
| Backspace | 清空中奖名单 |
| T | 导出未中奖名单 |
| F | 打开/关闭设置面板 |

> 所有快捷键都可以在设置面板中自定义

## 使用说明

### 数字抽奖

1. 打开数字抽奖页面
2. 按 `F` 键打开设置面板
3. 设置起始号码和结束号码
4. 可选：设置排除范围
5. 关闭设置面板，按 `Tab` 开始抽奖

### 姓名抽奖

1. 打开姓名抽奖页面
2. 按 `F` 键打开设置面板
3. 在"名单设置"标签页中：
   - 手动输入姓名（逗号或换行分隔）
   - 或点击"导入 Excel"按钮导入名单
   - 或点击"下载模板"获取 Excel 模板
4. 可选：设置降低概率名单
5. 关闭设置面板，按 `Tab` 开始抽奖

### Excel 模板格式

```
姓名
张三
李四
王五
...
```

第一列为表头"姓名"，从第二行开始填写参与抽奖的人员姓名。

## 浏览器兼容性

- Chrome 80+
- Firefox 75+
- Edge 80+
- Safari 13+

## 技术栈

- 纯 HTML5 + CSS3 + JavaScript
- [SheetJS](https://sheetjs.com/) - Excel 文件读写
- LocalStorage - 本地数据存储

## 开源协议

MIT License

## 仓库地址

- Gitee: https://gitee.com/chenkk0613/lottery

---

**注意**：本插件为纯前端实现，所有数据存储在浏览器本地。如需在不同设备间同步数据，请手动导出/导入 Excel 文件。