文章抽奖

概述

文章抽奖功能允许内容创作者直接在文章中组织赠品和抽奖活动。这个强大的互动工具可以帮助你建立社区、奖励忠实读者并提高内容互动率。

核心功能

灵活的参与条件

设置自定义的抽奖参与要求：

• 点赞要求：参与者必须点赞文章
• 评论要求：参与者必须留下评论
• 关注要求：参与者必须关注你（即将推出）
• 积分消耗：可选择要求消耗积分参与
• 组合要求：根据需要组合多个条件

多种开奖模式

选择如何以及何时抽取中奖者：

定时开奖

• 设置特定的日期和时间自动开奖
• 系统在预定时间自动抽取中奖者
• 适合限时促销活动
• 自动通过邮件通知中奖者

手动开奖

• 在你准备好时抽取中奖者
• 完全控制开奖时机
• 适合灵活的活动策划
• 从管理面板一键开奖

人数开奖

• 达到目标参与人数时自动开奖
• 适合"前X名参与者"风格的抽奖
• 无需手动监控参与情况
• 参与者即时获得反馈

评论中奖模式

当要求评论时，选择如何从评论中抽取中奖者：

随机模式

• 从所有评论的参与者中随机抽取中奖者
• 每位参与者概率相等
• 公平且不可预测的抽取
• 评论抽奖的默认模式

楼层模式

• 根据特定评论楼层号抽取中奖者
• 示例：第5楼、第10楼、第88楼、第99楼中奖
• 传统论坛风格抽奖
• 非常适合制造期待感
• 必须指定与中奖者数量匹配的确切楼层号

富文本奖品描述

创建吸引人的奖品描述：

• 富文本编辑器：使用 Markdown 编写格式化描述
• 图片：添加奖品照片吸引参与者
• 多位中奖者：为单次抽奖选择多位中奖者
• 详细信息：包含条款、条件和奖品详情

显示选项

选择抽奖显示位置：

• 顶部位置：显示在文章开头
• 底部位置：显示在文章结尾
• 战略性放置以获得最大可见度

创建抽奖

前提条件

• 必须有一篇处于编辑模式的已发布文章
• 文章必须存在才能创建抽奖
• 只有文章作者可以创建抽奖

详细步骤

1. 打开你的文章

   • 在控制台导航到你的文章
   • 点击进入编辑模式
   • 如果是新文章，请先保存

2. 访问抽奖配置

   • 点击编辑器工具栏中的设置图标（⚙️）
   • 从下拉菜单中选择"文章抽奖"
   • 抽奖配置对话框将打开

3. 配置奖品信息

   • 输入吸引人的奖品标题（必填）
   • 使用 Markdown 编写详细的奖品描述（必填）
   • 可选择上传或粘贴奖品图片 URL
   • 可选择添加奖品内容（兑换码等）
   • 设置中奖者数量

4. 设置参与要求

   • 如果参与者必须点赞文章，则切换"点赞文章"
   • 如果参与者必须评论，则切换"评论"
   • 如果要求评论，选择评论中奖模式：
     • 随机：从所有评论者中随机抽取中奖者
     • 楼层：指定具体评论楼层号（例如：5, 10, 88）
   • 设置积分成本（0 表示免费抽奖）
   • 注意：必须选择至少一个要求（点赞或评论）

5. 选择开奖模式

   • 定时开奖：选择自动开奖的日期和时间
   • 手动开奖：在你方便的时候手动开奖
   • 人数开奖：设置自动开奖的目标参与人数

6. 配置显示选项

   • 选择"顶部"将抽奖显示在文章开头
   • 选择"底部"将抽奖显示在文章结尾
   • 切换"默认展开"以控制初始显示状态

7. 创建抽奖

   • 仔细检查所有设置
   • 确保文章设置为公开（抽奖必需）
   • 点击"创建抽奖"按钮
   • 抽奖现在已激活并对读者可见

参与抽奖

对于读者

1. 找到带抽奖的文章

   • 在文章中寻找抽奖显示框
   • 检查文章顶部或底部

2. 查看要求

   • 阅读奖品描述和参与要求
   • 检查需要执行哪些操作（点赞、评论、积分）
   • 查看截止时间或参与人数进度

3. 满足要求

   • 如果需要，点赞文章
   • 如果需要，留下评论
   • 如果设置了成本，确保你有足够的积分

4. 加入抽奖

   • 点击"参与"或"加入抽奖"按钮
   • 在对话框中确认参与
   • 如果适用，积分将被扣除

5. 等待结果

   • 对于定时抽奖：等到开奖时间
   • 对于手动抽奖：等待作者开奖
   • 对于人数抽奖：达到目标人数时开奖

6. 中奖通知

   • 中奖者会收到邮件通知
   • 检查你的电子邮件收件箱
   • 中奖者名单会显示在文章上

参与规则

• 需要登录：必须登录才能参与
• 每人一次：每个用户每次抽奖只能参与一次
• 验证：系统在允许参与前会验证所有要求
• 积分扣除：参与时立即扣除积分
• 不可退款：如果未中奖，积分成本不予退还

管理抽奖

查看参与者

1. 打开你有活动抽奖的文章
2. 访问抽奖管理面板
3. 查看所有参与者列表
4. 查看参与者详情和验证状态

手动开奖

对于手动开奖模式：

1. 打开抽奖管理面板
2. 点击"开始抽奖"按钮
3. 系统随机选择中奖者
4. 自动通过邮件通知中奖者

更新抽奖

你可以更新某些抽奖设置：

• 奖品描述和图片
• 参与要求
• 开奖模式和设置
• 显示位置

注意：开奖完成后无法更改

取消抽奖

如果需要，你可以取消活动中的抽奖：

1. 打开抽奖管理面板
2. 点击"取消抽奖"按钮
3. 确认取消
4. 抽奖状态更改为已取消
5. 已消耗的积分不予退还

中奖者选择过程

随机选择算法

• 使用加密安全的随机数生成
• Fisher-Yates 洗牌算法确保公平性
• 所有符合条件的参与者概率相等
• 无法被操纵或预测

资格验证

开奖前，系统会验证：

• 用户仍满足所有要求
• 点赞状态是当前的
• 评论存在且有效
• 积分扣除成功

中奖者通知

中奖者通过邮件通知：

• 祝贺消息
• 奖品详情和描述
• 领取奖品的说明
• 奖品分发的联系信息

抽奖显示

活动中的抽奖显示

当抽奖活动时，访客会看到：

• 奖品标题和描述
• 奖品图片（如果提供）
• 带图标的参与要求
• 当前参与人数
• 剩余时间（定时模式）
• 进度条（人数模式）
• "参与"按钮

已完成的抽奖显示

开奖完成后：

• 奖品信息
• 带头像的中奖者名单
• 总参与人数
• 开奖完成日期

对于非参与者

• 可以查看抽奖详情
• 无法看到参与者列表
• 如果抽奖仍活跃可以加入

积分系统集成

积分成本

• 设置积分成本从 0（免费）到任意金额
• 参与时扣除积分
• 必须有足够的积分才能参与
• 积分立即消耗

退款政策

• 未中奖者不予退款
• 已消耗的积分不可退还
• 建议设置合理的成本

免费抽奖

• 将积分成本设置为 0
• 所有登录用户都可以参与
• 仍需满足其他要求（点赞、评论）

自动开奖系统

定时开奖

• GitHub Actions cron 作业每 5 分钟运行一次
• 检查过期的定时抽奖
• 自动执行开奖
• 向中奖者发送邮件通知
• 将抽奖状态更新为"已开奖"

系统要求

• 必须设置 APP_URL 环境变量
• 必须配置 CRON_SECRET
• 邮件服务必须可用
• 数据库连接必须活跃

最佳实践

创建有效的抽奖

1. 清晰的奖品描述：明确说明中奖者会得到什么
2. 合理的要求：不要让参与变得太困难
3. 公平的积分成本：考虑受众的积分可用性
4. 适当的中奖者数量：匹配奖品数量与参与者期望
5. 战略性时机：在高互动时段安排开奖

提升参与度

1. 吸引人的奖品：提供有价值或有趣的奖品
2. 广泛分享：在社交媒体上推广你的抽奖
3. 清晰的说明：让要求易于理解
4. 互动评论：回应参与者的评论
5. 建立期待：在开奖前营造兴奋感

管理中奖者

1. 及时联系：迅速联系中奖者
2. 清晰的说明：解释如何领取奖品
3. 设置截止日期：给中奖者一个领取的时间框架
4. 备选中奖者：如果中奖者没有回应，制定备用计划
5. 公开宣布：分享中奖者公告以建立信任

故障排除

无法创建抽奖

• 确保你处于现有文章的编辑模式
• 验证你是文章作者
• 检查文章是否已发布
• 尝试刷新页面

参与按钮被禁用

• 验证你已登录
• 检查是否已经参与过
• 确保你满足所有要求（点赞、评论）
• 验证你有足够的积分

中奖者未收到通知

• 检查邮件服务配置
• 验证中奖者电子邮件地址有效
• 检查垃圾邮件文件夹
• 查看 cron 作业执行日志

未自动开奖

• 验证预定时间在未来
• 检查 GitHub Actions 工作流已启用
• 确保 CRON_SECRET 设置正确
• 预定时间后至少等待 5 分钟

安全和公平性

防欺诈措施

• 数据库约束强制每个用户一次参与
• 记录 IP 地址用于审计
• 参与前验证要求
• 中奖者选择使用安全随机数生成

数据隐私

• 参与者信息是私密的
• 只有文章作者可以查看参与者列表
• 开奖后中奖者名单是公开的
• 电子邮件地址受保护

公平竞争

• 不能参与自己的抽奖
• 参与开始后不能更改要求
• 随机选择不能被影响
• 所有参与者机会均等（同一抽奖内）

限制

当前限制

• 关注要求尚未实现
• 参与者加入后无法编辑奖品
• 取消抽奖不提供部分退款
• 最大参与者数受数据库性能限制

配额限制

• 免费计划：无限抽奖
• Pro 计划：无限抽奖
• 终身计划：无限抽奖

未来增强

计划中的改进：

• 实现关注要求
• 快速设置的抽奖模板
• 高级分析和统计
• 导出参与者列表
• 批量联系中奖者工具
• 集成更多通知渠道
• 抽奖复制功能

常见问题

问：我可以为同一篇文章运行多个抽奖吗？ 答：目前支持每篇文章一个活动抽奖。

问：如果没有人参与会怎么样？ 答：开奖不会进行。你可以取消或延长抽奖。

问：创建后我可以更改中奖者数量吗？ 答：可以，但只能在任何参与者加入之前。

问：如果抽奖被取消，积分会退还吗？ 答：不会，积分一旦消耗就不可退还。

问：如何选择中奖者？ 答：使用 Fisher-Yates 算法进行加密安全的随机选择。

问：我可以手动通知中奖者吗？ 答：可以，但会自动发送邮件。你也可以单独联系他们。

问：如果中奖者没有回应怎么办？ 答：你需要手动联系他们或选择备选中奖者。

问：参与者可以看到其他人加入了吗？ 答：不可以，参与者列表只对文章作者可见。

支持

如果你遇到问题或有疑问：

• 首先查看本文档
• 查看故障排除部分
• 通过电子邮件联系支持
• 在 GitHub issues 页面报告错误