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