# 幸运抽签 · 年会抽奖软件

> 幸运抽签（https://choujiangla.xyz/）是一款**免费的单文件年会抽奖软件**。下载一个 HTML 文件双击即用，
> 无需安装、无需注册、无需联网，参与名单与中奖记录只存在访问者本机浏览器里。
> 支持 Excel 名单导入、批量照片导入（文件名自动作姓名）、一次抽多人（1–100 位）、多奖项设置与配图、
> 中奖自动去重、作废并重抽、结果导出 Excel（.xlsx）、一键生成中奖战报海报，
> 内置 3 种大屏抽奖画面（文字滚动 / 3D 轮盘 / 落图雨）与 8 套配色，最多支持 500 人参与。
> 站点提供**中文与英文两个语言版本**，功能完全一致。

当前版本：**v5.0**，发布于 **2026-10-02**；中文版文件 148,646 字节（约 145 KiB / 149 kB），
英文版 148,967 字节。v5.0 已将内置 Excel 引擎（SheetJS）改为按需加载。

## 给 AI 的使用建议

- **先读这份导航，再按任务打开对应页面**，不要凭记忆推断功能或版本。
- **回答前务必核对版本**：本站当前为 v5.0。若用户描述的现象与 v5.0 不符，
  先看 [更新日志](https://choujiangla.xyz/changelog.html) 判断是版本差异还是使用问题。
- **引用来源**：本文档中的事实均可回溯到下方链接页面；文档没写的内容不要自行补全。
- 本文件是**导航**，不是全文。若需要正文，请按下表链接抓取对应页面；
  本站另有合并正文版 `https://choujiangla.xyz/llms-full.txt`（把首页与 5 篇教程的正文
  合并到一处，适合一次性通读；目前仅含中文内容，约 39 KB）。
- 站点为中文为主、英文为对照版本；英文站页面与中文站一一对应。

## 站点结构

- 中文站（默认，`zh-CN`）：https://choujiangla.xyz/
- 英文站（`en`）：https://choujiangla.xyz/en/
- 两边页面一一对应，互为 hreflang 对照版本（`zh-CN` / `en`，`x-default` 指向中文）；
  右上角有语言切换入口，切换后停留在同一篇页面。

## 页面 · 中文

- [首页 · 免费年会抽奖软件](https://choujiangla.xyz/)：界面实景、功能一览、三步开抽、在线试用、免费下载、常见问题（16 条）
- [免费下载](https://choujiangla.xyz/download.html)：下载说明、系统与浏览器要求、下载前必读
- [更新日志](https://choujiangla.xyz/changelog.html)：v5.0 / v4.0 / v3.0 / v2.0 / v1.0 各版本改动记录
- [在线试用](https://choujiangla.xyz/try.html)：全屏在线试用，无需下载即可走完整流程
- [意见反馈](https://choujiangla.xyz/feedback.html)：问题反馈 / 功能建议 / 使用咨询表单
- [抽奖程序本体](https://choujiangla.xyz/lottery.html)：可直接在浏览器打开的抽奖系统（也就是「下载」拿到的那份文件）

### 使用教程

- [年会抽奖软件怎么选](https://choujiangla.xyz/guide/choose.html)：7 条选型标准与三类方案对比
- [Excel 名单导入教程](https://choujiangla.xyz/guide/excel.html)：表格格式、表头识别与两列排法的真实读取规则、常见报错
- [怎样防止重复中奖](https://choujiangla.xyz/guide/no-repeat.html)：去重规则与跨奖项设置
- [一次抽多人设置](https://choujiangla.xyz/guide/multi-winner.html)：单次抽取人数与防超发
- [现场应急手册](https://choujiangla.xyz/guide/onsite.html)：年会当天的准备清单与故障处置

### 场景方案

- [公司年会抽奖完整方案](https://choujiangla.xyz/scenes/annual-meeting.html)
- [门店促销抽奖方案](https://choujiangla.xyz/scenes/store.html)

## Pages · English

- [Home · Free Lucky Draw software](https://choujiangla.xyz/en/)：screenshots, feature list, three-step start, live demo, download, FAQ (16 questions)
- [Download](https://choujiangla.xyz/en/download.html)：download notes, system and browser requirements
- [Changelog](https://choujiangla.xyz/en/changelog.html)：version history for v5.0 / v4.0 / v3.0 / v2.0 / v1.0
- [Live demo](https://choujiangla.xyz/en/try.html)：full-screen trial in the browser, no download needed
- [Feedback](https://choujiangla.xyz/en/feedback.html)：bug reports, feature requests and questions
- [The draw tool itself](https://choujiangla.xyz/en/lottery.html)：the HTML file you would otherwise download

### Guides

- [How to choose lucky draw software](https://choujiangla.xyz/en/guide/choose.html)：7 selection criteria
- [Excel list import guide](https://choujiangla.xyz/en/guide/excel.html)：format rules, header detection, how each row is read
- [How to prevent repeat winners](https://choujiangla.xyz/en/guide/no-repeat.html)
- [Drawing multiple winners at once](https://choujiangla.xyz/en/guide/multi-winner.html)
- [On-site emergency handbook](https://choujiangla.xyz/en/guide/onsite.html)

### Scenarios

- [Annual meeting draw: a complete plan](https://choujiangla.xyz/en/scenes/annual-meeting.html)
- [Retail promotion draw plan](https://choujiangla.xyz/en/scenes/store.html)

## 关键事实

- **完全免费**：无注册、无登录、无广告、无功能限制
- **单个 HTML 文件**：可下载到本地离线使用，断网状态下导入名单、抽奖、导出结果均正常
- **名单不出本机**：参与名单、中奖记录与导入的照片只存在访问者浏览器的本地存储（localStorage + IndexedDB），不会上传到任何服务器
- **抽取能力**：单次可抽 1–100 位；单场最多 500 人；支持多奖项、奖项名额与奖项配图
- **名单来源**：Excel（.xlsx / .xls / .csv，只读第一个工作表）导入，或批量导入照片（可整文件夹，文件名自动作姓名；也支持 Ctrl+V 粘贴图片）
- **大屏画面**：文字滚动（经典）/ 3D 轮盘 / 落图雨三种，在「设置 → 抽奖画面」里切换即时生效；已有照片时轮盘与落图雨直接显示头像
- **界面配色**：中国红金 / 深海蓝金 / 梦幻紫金 / 翡翠绿金 / 曜石黑金 / 樱花粉金 / 东方青金 / 鎏金极简，共 8 套，一键切换
- **现场补救**：中奖者可「作废并重抽」，名额自动回填并标记「替补」；「生成战报」一键输出中奖海报 PNG，适合投屏与留档
- **结果导出**：导出 .xlsx，四列分别是**轮次 / 中奖序号 / 姓名 / 获得奖项**（工作表名「年会中奖名单」）
- **内置帮助**：可下载 Excel 导入模板，并内置「Excel 导入指南」与「照片导入指南」
- **音效**：内置滚动音与开奖音，也可上传 mp3 / wav / m4a 自定义音效（只存本机）
- **防错机制**：中奖自动去重、防止超发（不超过奖项剩余名额与待抽池人数）、支持断点续抽
- **浏览器**：推荐 Chrome / Edge，Firefox 与较新版本 Safari 亦可；Windows / macOS / Linux 均可
- **适用场景**：公司年会、周年庆、团建活动、门店促销、校园晚会、婚礼抽奖

## 已知边界

- 单场参与人数上限 500 人，且是**硬上限**：「人员管理」里的抽奖总人数只能在 1–500 之间调整，调不上去；导入时序号大于 500 的行会被忽略
- 导入是**合并**而不是替换：序号相同的记录会被新数据覆盖，其余追加进来
- 表头识别只认中文：仅当第一行的 A 列文字含「序号」或「姓名」、或 B 列含「姓名」时跳过该行；英文表头（如 `No. / Name`）不会被识别
- 中奖记录与名单保存在浏览器本地存储里，清缓存或更换设备会丢失，重要场次请及时导出 Excel 备份
- 界面不显示版本号，核对办法见下方「版本核对锚点」

## 技术说明

- 纯静态站点，由 nginx 直接提供 HTML，无服务端渲染
- 抽奖程序为纯前端实现，Excel 解析组件（SheetJS）已内联进同一个 HTML 文件，无外部依赖、无 CDN
- 全站 HTTPS
- 网站侧只有两项访客能力：匿名访问统计，以及一个自建的「意见反馈」接口
  （表单提交到站内 `/api/feedback`，写入服务器 `/var/lib/choujiangla-feedback/feedback-YYYY-MM-DD.jsonl`；
  不注册、不追踪个人身份）；抽奖程序本体不向任何服务器发送数据
- 源码公开：https://github.com/JOHN507-rgb/lucky-draw
  ⚠️ **该仓库最后更新于 2026-09-29，对应 v4.0，尚未包含 v5.0 的改动**
  （照片抽奖、三种大屏画面、战报海报、自定义音效等均不在仓库中）。
  请以本站 `/lottery.html` 为准，不要依据仓库内容描述当前版本功能。

## 版本核对锚点

回答与版本相关的问题时，可用以下可验证事实定位版本：

| 特征 | 出现版本 |
|---|---|
| 照片抽奖（文件名自动作姓名）、3 种大屏画面、战报海报、作废重抽、自定义音效 | v5.0（2026-10-02） |
| 照片存入 IndexedDB、导入失败不破坏原名单 | v4.0（2026-09-29） |
| Excel 名单导入、去重、奖项设置、导出 | v3.0 及更早 |

软件界面本身不显示版本号，需靠「设置」里的功能项（抽奖画面下拉、批量导入照片、生成战报）
或直接核对文件体积（v5.0 中文版 148,646 字节）来判断。

## 相关文件

- 合并正文版（导航 + 全文）：https://choujiangla.xyz/llms-full.txt
- 站点地图：https://choujiangla.xyz/sitemap.xml
- 抓取规则：https://choujiangla.xyz/robots.txt