镜像自地址
https://github.com/a13zhy/a13rollcall.git
已同步 2026-10-20 11:27:47 +08:00
Update README.md
这个提交包含在:
父节点
387e813bfc
当前提交
86ce04b422
194
README.md
194
README.md
@ -1,105 +1,145 @@
|
|||||||
a13rollcall | 第六代A13引擎·专治课堂摸鱼的全能点名神器
|
# a13rollcall
|
||||||
|
> 🎲 第六代A13引擎|专治课堂摸鱼的开源点名抽背神器
|
||||||
|
|
||||||
|
[](https://github.com/a13zhy/a13rollcall/stargazers)
|
||||||
|
[](https://github.com/a13zhy/a13rollcall/fork)
|
||||||
|
[](https://www.python.org/)
|
||||||
|
[](https://github.com/a13zhy/a13rollcall/releases)
|
||||||
|
[](#-开源许可)
|
||||||
|
|
||||||
🔥 终结课堂摸鱼玄学!公平公开的随机点名,专治各种侥幸心理
|
🔥 **告别人工点名精神内耗!离线本地运行|零广告|零氪金|无乱七八糟捆绑**
|
||||||
一款零广告、零付费、零套路的纯纯免费课堂工具!基于Python自研打造,搭载第六代A13超强随机引擎,告别人工点名的纠结偏心,用算法说了算!
|
|
||||||
|
|
||||||
|
上课点名全靠直觉?学生总赌自己是“天选摸鱼人”?
|
||||||
不管是年轻老师上课抽查、随机点名、课堂抽背,还是日常值日排班,一键搞定,丝滑又省心,直接拉满课堂压迫感与趣味性✨
|
交给**A13第六代随机引擎**,抽签全看运气,拒绝人情滤镜,开盲盒式点名,课堂氛围感直接拉满✨
|
||||||
📊 项目速览
|
|
||||||
|
|
||||||
|
|
||||||
纯Python原生开发 | 本地离线运行 | 模块化极简架构 | 无任何冗余捆绑
|
|
||||||
|
|
||||||
---
|
---
|
||||||
💬 为什么要做这个工具?(全员共鸣版)
|
|
||||||
盘点课堂两大永恒痛点,谁懂啊!
|
## 💥 谁懂啊!课堂两大永恒痛点
|
||||||
✅ 老师视角:每次点名全靠直觉,点多了怕偏心,不点又怕学生摆烂,选择困难直接犯,点名十分钟,讲课五分钟;
|
- 👨🏫 **老师侧:点名选择困难症**
|
||||||
✅ 学生视角:上课主打一个沉浸式摸鱼,总赌自己是“天选幸运儿”,永远不会被点名抽查!
|
纠结点谁,怕偏心、怕重复,点名半节课,讲课五分钟。
|
||||||
为了打破这种双向尴尬,a13rollcall V6.2重磅上线!
|
- 👩🎓 **学生侧:摸鱼侥幸心理**
|
||||||
不看人情、不凭直觉、只信算法!人人概率均等,抽查全凭天意,彻底治好老师点名纠结症,击碎学生摸鱼侥幸心!
|
低头神游,内心疯狂祈祷:千万别点我!
|
||||||
|
|
||||||
|
于是 `a13rollcall` 诞生!
|
||||||
|
> 不看心情,不凭印象,**算法说了算,人人机会均等**,击碎摸鱼幻想,拯救老师的选择困难。
|
||||||
|
|
||||||
---
|
---
|
||||||
✨ 炸裂核心亮点(年轻人专属适配)
|
|
||||||
🎲 第六代A13自研随机引擎|告别伪随机摆烂
|
## ✨ 项目亮点
|
||||||
碾压市面上老旧的鸡肋随机程序!迭代优化专属抽签算法,拒绝定点重复、拒绝扎堆点名、拒绝长期透明,每个同学被选中的概率极致均衡,真正实现“公平开盲盒”,没有暗箱操作,全是真实运气!
|
### 🎲 第六代 A13 自研随机引擎
|
||||||
📚 点名+抽背双模式|一机搞定全课堂场景
|
拒绝地摊伪随机!专门优化抽签逻辑:
|
||||||
全能百搭工具,不用来回切换多个软件:
|
- ❌ 杜绝同一个人连续“中奖”
|
||||||
- 随机点名模式:课堂提问、作业抽查、值日分配、小组选人,万物皆可抽!
|
- ❌ 拒绝扎堆点名、长期透明人
|
||||||
- 随机抽背模式:课文背诵、知识点抽查、习题提问,专治上课走神、背书摆烂!
|
- ✅ 概率分布均衡,真正公平开盲盒,没有暗箱操作
|
||||||
⚙️ 专业模块化架构|颜值实力双在线
|
|
||||||
绝非网上随便堆砌的垃圾代码!采用分层解耦架构,各司其职、简洁清爽、可随意二次修改,新手能看懂,大佬能魔改:
|
### 📚 点名 + 抽背 双模式一体
|
||||||
- 🚀 引擎层:draw_engine.py —— A13核心算法,随机性能拉满
|
一套程序搞定多种课堂场景,不用来回切软件:
|
||||||
- 📊 数据层:data_manager.py —— 智能解析清洗名单、题库数据
|
- **随机点名**:课堂提问、作业抽查、值日抽签、小组选人
|
||||||
- ⚙️ 配置层:config_manager.py —— 个性化参数自由自定义
|
- **随机抽背**:课文背诵、知识点默写、习题抽查,专治摆烂不背书
|
||||||
- 🧙 交互层:wizard_launcher.py —— 傻瓜式向导,小白零门槛上手
|
|
||||||
- 🎯 入口层:main.py —— 全局程序核心调度
|
### 🧱 模块化解耦架构,不是玩具堆砌代码
|
||||||
💻 极致轻量化|低配电脑也能丝滑起飞
|
结构清晰,新手看得懂,大佬随便魔改二次开发:
|
||||||
纯Python标准库开发,零第三方依赖、无需繁琐安装,不用联网、不用更新、不占内存,老旧办公电脑、轻薄本都能秒启动,拒绝卡顿闪退!
|
- `draw_engine.py` — A13核心抽签引擎
|
||||||
🎨 超高自由度|全场景自定义适配
|
- `data_manager.py` — 名单&题库读取、清洗校验
|
||||||
没有死板固定参数!支持自定义班级名单、自定义抽背题库、自定义单次抽取人数、自定义去重规则,小学/初中/高中/培训机构全场景通吃,想怎么用就怎么改!
|
- `config_manager.py` — 全局配置管理
|
||||||
|
- `wizard_launcher.py` — 交互式新手向导
|
||||||
|
- `main.py` — 主程序调度入口
|
||||||
|
|
||||||
|
### ⚡ 极致轻量化
|
||||||
|
纯 Python 标准库实现,**零第三方依赖**。
|
||||||
|
无需联网、不用安装一堆包,老办公电脑也能秒开,拒绝卡顿闪退。
|
||||||
|
|
||||||
|
### 🎛️ 自由度拉满
|
||||||
|
完全自定义:班级名单、抽背题库、单次抽取人数、去重开关,中小学/培训机构全部适配。
|
||||||
|
|
||||||
---
|
---
|
||||||
📂 项目文件结构|清晰极简不杂乱
|
|
||||||
|
## 📁 项目文件结构
|
||||||
|
```
|
||||||
a13rollcall/
|
a13rollcall/
|
||||||
├── main.py # 主程序入口|一键极速启动
|
├── main.py # 主程序入口|极速启动
|
||||||
├── wizard_launcher.py # 新手向导|交互式傻瓜操作
|
├── wizard_launcher.py # 新手向导|交互式傻瓜操作
|
||||||
├── config_manager.py # 配置中心|个性化规则自定义
|
├── config_manager.py # 配置中心|个性化规则
|
||||||
├── data_manager.py # 数据处理|名单题库智能校验
|
├── data_manager.py # 数据处理|名单题库校验
|
||||||
├── draw_engine.py # A13第六代核心|超强随机算法
|
├── draw_engine.py # A13第六代核心随机引擎
|
||||||
├── students.txt # 自定义班级学生名单
|
├── students.txt # 学生名单库(自行编辑)
|
||||||
├── texts.txt # 自定义课堂抽背题库
|
├── texts.txt # 抽背题目库(自行编辑)
|
||||||
└── README.md # 项目说明文档
|
└── README.md # 项目说明文档
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
🛠️ 极速上手|小白也能一秒玩转
|
|
||||||
一、运行环境
|
## 🚀 快速上手
|
||||||
仅需 Python 3.8+,绿色纯净,无任何附加要求!
|
|
||||||
二、部署步骤
|
### 环境要求
|
||||||
1. 克隆项目到本地
|
- Python `3.8` 及以上
|
||||||
|
> 无pip依赖,开箱即用。
|
||||||
|
|
||||||
|
### 1️⃣ 拉取项目
|
||||||
|
```bash
|
||||||
git clone https://github.com/a13zhy/a13rollcall.git
|
git clone https://github.com/a13zhy/a13rollcall.git
|
||||||
cd a13rollcall
|
cd a13rollcall
|
||||||
2. 自定义专属数据
|
```
|
||||||
- students.txt:一行一个学生姓名,杜绝空行、多余空格,避免抽取bug
|
|
||||||
- texts.txt:一行一个题目/知识点,按需更新抽背内容
|
### 2️⃣ 填入你的数据
|
||||||
三、双启动模式|按需任选
|
- `students.txt`:**一行一个姓名**,不要空行、多余空格,不然会抽中空气😂
|
||||||
✅ 老手极速模式(直接开跑)
|
- `texts.txt`:一行一道题目/背诵片段,按需填充。
|
||||||
|
|
||||||
|
### 3️⃣ 两种启动姿势
|
||||||
|
```bash
|
||||||
|
# 老玩家:直接冲主程序
|
||||||
python main.py
|
python main.py
|
||||||
✅ 小白向导模式(手把手教)
|
|
||||||
|
# 小白玩家:向导模式,一步步带你玩
|
||||||
python wizard_launcher.py
|
python wizard_launcher.py
|
||||||
|
```
|
||||||
|
|
||||||
|
> 📦 不想装Python?直接去 [Releases](https://github.com/a13zhy/a13rollcall/releases) 下载打包好的exe,双击直接跑。
|
||||||
|
|
||||||
---
|
---
|
||||||
⚙️ 高阶玩法|解锁自定义新姿势
|
|
||||||
通过 config_manager.py 轻松解锁个性化设置,玩出专属风格:
|
## ⚙️ 高阶玩法
|
||||||
- 开启去重抽取:避免同一个人连续“中奖”,主打一个雨露均沾
|
修改/通过程序配置中心开启能力:
|
||||||
- 调整单次抽取人数:单人抽查、多人批量点名自由切换
|
- ✅ 开启去重:避免同一个倒霉蛋连续被点名,雨露均沾
|
||||||
- 自定义输出样式、提示文案,适配自己的使用习惯
|
- ✅ 设置单次抽取人数:单人拷问 / 批量拷打自由切换
|
||||||
- 自动过滤空数据、无效内容,杜绝程序翻车
|
- ✅ 自定义输出提示文案,玩出你的风格
|
||||||
|
- ✅ 内置脏数据过滤,自动跳过空行垃圾内容,防止程序翻车
|
||||||
|
|
||||||
|
## 💡 老玩家私藏小技巧
|
||||||
|
1. **纯点名模式**:直接清空 `texts.txt`,自动关闭抽背,只玩点名。
|
||||||
|
2. **极速扫荡模式**:关闭去重,适合快速轮询全班。
|
||||||
|
3. ⚠️ 编码避坑:txt文件保存为 **UTF‑8**,防止中文乱码。
|
||||||
|
4. ❗不要留空行,不然会随机抽中“空气同学”。
|
||||||
|
|
||||||
---
|
---
|
||||||
💡 私藏玩法技巧|老用户都在用
|
|
||||||
- 纯点名模式:清空 texts.txt,程序自动关闭抽背功能,专注课堂提问
|
## 📜 更新日志
|
||||||
- 全员速查模式:关闭去重规则,适合随堂快速全员抽查,高效不拖沓
|
### V6.0 | 2026‑08‑27
|
||||||
- 避坑小Tips:所有文本文件统一使用UTF-8编码,杜绝中文乱码;名单不要留空行,避免无效抽取
|
- 🚀 升级 **第六代A13随机引擎**,概率分配更科学
|
||||||
- 懒人终极方案:直接下载Release打包版本,不用装Python,双击就能用!
|
- 🔨 整体重构代码,结构更整洁,可读性大幅提升
|
||||||
|
- 🧙 新增交互式向导启动,零基础友好
|
||||||
|
- 🛡️ 强化数据校验,自动过滤无效脏数据
|
||||||
|
- 🖥️ 全平台兼容性优化,降低闪退概率
|
||||||
|
|
||||||
---
|
---
|
||||||
📈 版本迭代日志|持续进化升级
|
|
||||||
V6.0 最新稳定版(2026.08.27)
|
## 💬 开发者碎碎念
|
||||||
- 重磅升级第六代A13随机引擎,概率分配更公平、更合理
|
> 不堆花里胡哨的无效功能,只做真正好用的课堂工具。
|
||||||
- 全面重构代码结构,极简整洁,可读性、可维护性拉满
|
> 无会员、无广告、永久免费开源。
|
||||||
- 新增新手交互式向导,零基础用户也能轻松上手
|
> 希望用算法代替主观偏心,少一点老师的纠结,多一点学生的听课压力(不是)。
|
||||||
- 优化数据校验机制,自动剔除无效冗余数据
|
|
||||||
- 全平台适配升级,运行稳定性大幅提升,告别闪退bug
|
欢迎 Star ⭐ 鼓励,有想法欢迎提 Issue / PR 一起折腾。
|
||||||
|
|
||||||
---
|
---
|
||||||
🙋 开发者碎碎念
|
|
||||||
不搞花里胡哨的鸡肋功能,只做真正实用、纯粹干净的课堂工具。
|
## 📄 开源许可
|
||||||
不用会员、不用氪金、不用看广告,免费开源永久可用。
|
本项目仅供教育学习、个人教学使用。
|
||||||
用算法代替主观判断,让课堂点名公平透明,既解放老师,也督促学生认真听课~
|
**禁止直接打包倒卖、二次封装用于商业盈利。**
|
||||||
|
|
||||||
|
## 👨💻 Author
|
||||||
|
**a13zhy**
|
||||||
|
|
||||||
---
|
---
|
||||||
📄 开源许可
|
|
||||||
本项目为免费开源学习工具,仅用于教育教学场景学习、使用与二次优化,禁止商业售卖、篡改打包盈利。
|
> 复制全部直接粘贴到你的仓库 `README.md`,完全符合 GitHub Markdown 渲染规范,徽章、代码块、链接全部可用。
|
||||||
👨💻 开发者
|
如果你需要,我可以再给你一段简短的**项目简介(仓库About描述)**,填到GitHub仓库主页。
|
||||||
a13zhy
|
|
||||||
|
|||||||
正在加载...
在新工单中引用
屏蔽一个用户