# luckgirl

**Repository Path**: hexm02/luckgirl

## Basic Information

- **Project Name**: luckgirl
- **Description**: 一个纯网页的抽奖小程序，可用于年会、集会等活动现场使用。
一次最多可以抽出15个人，可以显示头像，号码，姓名。
不需要联网，开箱即用，简单，安全。
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-20
- **Last Updated**: 2025-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# luckgirl

#### 介绍
一个纯网页的抽奖小程序，可用于年会、集会等活动现场使用。
一次最多可以抽出15个人，可以显示头像，号码，姓名。
不需要联网，开箱即用，简单，安全.

#### 软件架构
软件架构说明


#### 安装教程

1. 下载本程序到本地
2. 将抽奖人员名单按照格式添加到"人员名单.txt"文件中
   - 格式：姓名,工号,部门,头像文件名
   - 例如：张三,C001,技术部,C001_张三.jpg
3. 将对应的头像文件放入img目录下
   - 支持jpg/png格式的图片
   - 如果没有头像文件，将显示默认头像

#### 使用说明

1. 直接用浏览器打开index.html即可运行程序
2. 界面功能说明：
   - 显示/隐藏按钮：控制抽奖配置面板的显示
   - 人数输入框：设置本次要抽取的中奖人数（1-15人）
   - 开始/停止按钮：控制抽奖过程
   - 重置按钮：清空当前的中奖结果
3. 抽奖过程：
   - 设置本次抽奖人数
   - 点击开始按钮，程序开始随机展示候选人信息
   - 点击停止按钮，确定最终中奖人员
   - 中奖人员信息会自动保存，刷新页面不会丢失
4. 注意事项：
   - 程序支持离线运行，无需联网
   - 建议使用Chrome、Firefox等现代浏览器
   - 当中奖人数少于3人时，中奖者信息会居中显示

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)