diff --git a/README.md b/README.md index 978b378..fa8b7a2 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,99 @@ -# a13rollcall -第六代A13引擎驱动的课堂点名程序 +a13rollcall | 第六代A13引擎·专治课堂摸鱼的全能点名神器 +🔥 终结课堂摸鱼玄学!公平公开的随机点名,专治各种侥幸心理 +一款零广告、零付费、零套路的纯纯免费课堂工具!基于Python自研打造,搭载第六代A13超强随机引擎,告别人工点名的纠结偏心,用算法说了算! +不管是年轻老师上课抽查、随机点名、课堂抽背,还是日常值日排班,一键搞定,丝滑又省心,直接拉满课堂压迫感与趣味性✨ +📊 项目速览 +纯Python原生开发 | 本地离线运行 | 模块化极简架构 | 无任何冗余捆绑 + +--- +💬 为什么要做这个工具?(全员共鸣版) +盘点课堂两大永恒痛点,谁懂啊! +✅ 老师视角:每次点名全靠直觉,点多了怕偏心,不点又怕学生摆烂,选择困难直接犯,点名十分钟,讲课五分钟; +✅ 学生视角:上课主打一个沉浸式摸鱼,总赌自己是“天选幸运儿”,永远不会被点名抽查! +为了打破这种双向尴尬,a13rollcall V6.2重磅上线! +不看人情、不凭直觉、只信算法!人人概率均等,抽查全凭天意,彻底治好老师点名纠结症,击碎学生摸鱼侥幸心! + +--- +✨ 炸裂核心亮点(年轻人专属适配) +🎲 第六代A13自研随机引擎|告别伪随机摆烂 +碾压市面上老旧的鸡肋随机程序!迭代优化专属抽签算法,拒绝定点重复、拒绝扎堆点名、拒绝长期透明,每个同学被选中的概率极致均衡,真正实现“公平开盲盒”,没有暗箱操作,全是真实运气! +📚 点名+抽背双模式|一机搞定全课堂场景 +全能百搭工具,不用来回切换多个软件: +- 随机点名模式:课堂提问、作业抽查、值日分配、小组选人,万物皆可抽! +- 随机抽背模式:课文背诵、知识点抽查、习题提问,专治上课走神、背书摆烂! +⚙️ 专业模块化架构|颜值实力双在线 +绝非网上随便堆砌的垃圾代码!采用分层解耦架构,各司其职、简洁清爽、可随意二次修改,新手能看懂,大佬能魔改: +- 🚀 引擎层:draw_engine.py —— A13核心算法,随机性能拉满 +- 📊 数据层:data_manager.py —— 智能解析清洗名单、题库数据 +- ⚙️ 配置层:config_manager.py —— 个性化参数自由自定义 +- 🧙 交互层:wizard_launcher.py —— 傻瓜式向导,小白零门槛上手 +- 🎯 入口层:main.py —— 全局程序核心调度 +💻 极致轻量化|低配电脑也能丝滑起飞 +纯Python标准库开发,零第三方依赖、无需繁琐安装,不用联网、不用更新、不占内存,老旧办公电脑、轻薄本都能秒启动,拒绝卡顿闪退! +🎨 超高自由度|全场景自定义适配 +没有死板固定参数!支持自定义班级名单、自定义抽背题库、自定义单次抽取人数、自定义去重规则,小学/初中/高中/培训机构全场景通吃,想怎么用就怎么改! + +--- +📂 项目文件结构|清晰极简不杂乱 +a13rollcall/ +├── main.py # 主程序入口|一键极速启动 +├── wizard_launcher.py # 新手向导|交互式傻瓜操作 +├── config_manager.py # 配置中心|个性化规则自定义 +├── data_manager.py # 数据处理|名单题库智能校验 +├── draw_engine.py # A13第六代核心|超强随机算法 +├── students.txt # 自定义班级学生名单 +├── texts.txt # 自定义课堂抽背题库 +└── README.md # 项目说明文档 + +--- +🛠️ 极速上手|小白也能一秒玩转 +一、运行环境 +仅需 Python 3.8+,绿色纯净,无任何附加要求! +二、部署步骤 +1. 克隆项目到本地 +git clone https://github.com/a13zhy/a13rollcall.git +cd a13rollcall +2. 自定义专属数据 +- students.txt:一行一个学生姓名,杜绝空行、多余空格,避免抽取bug +- texts.txt:一行一个题目/知识点,按需更新抽背内容 +三、双启动模式|按需任选 +✅ 老手极速模式(直接开跑) +python main.py +✅ 小白向导模式(手把手教) +python wizard_launcher.py + +--- +⚙️ 高阶玩法|解锁自定义新姿势 +通过 config_manager.py 轻松解锁个性化设置,玩出专属风格: +- 开启去重抽取:避免同一个人连续“中奖”,主打一个雨露均沾 +- 调整单次抽取人数:单人抽查、多人批量点名自由切换 +- 自定义输出样式、提示文案,适配自己的使用习惯 +- 自动过滤空数据、无效内容,杜绝程序翻车 + +--- +💡 私藏玩法技巧|老用户都在用 +- 纯点名模式:清空 texts.txt,程序自动关闭抽背功能,专注课堂提问 +- 全员速查模式:关闭去重规则,适合随堂快速全员抽查,高效不拖沓 +- 避坑小Tips:所有文本文件统一使用UTF-8编码,杜绝中文乱码;名单不要留空行,避免无效抽取 +- 懒人终极方案:直接下载Release打包版本,不用装Python,双击就能用! + +--- +📈 版本迭代日志|持续进化升级 +V6.0 最新稳定版(2026.08.27) +- 重磅升级第六代A13随机引擎,概率分配更公平、更合理 +- 全面重构代码结构,极简整洁,可读性、可维护性拉满 +- 新增新手交互式向导,零基础用户也能轻松上手 +- 优化数据校验机制,自动剔除无效冗余数据 +- 全平台适配升级,运行稳定性大幅提升,告别闪退bug + +--- +🙋 开发者碎碎念 +不搞花里胡哨的鸡肋功能,只做真正实用、纯粹干净的课堂工具。 +不用会员、不用氪金、不用看广告,免费开源永久可用。 +用算法代替主观判断,让课堂点名公平透明,既解放老师,也督促学生认真听课~ + +--- +📄 开源许可 +本项目为免费开源学习工具,仅用于教育教学场景学习、使用与二次优化,禁止商业售卖、篡改打包盈利。 +👨‍💻 开发者 +a13zhy