点名器（Rollcall）

一个简单易用的网页点名工具，支持名单管理、随机抽取、已点人数统计、已点名单保存与导出，适合教师、活动主持人等场景。

在线体验：点名器在线页面

功能简介

• 名单录入：支持手动输入和从 GitHub 仓库导入 CSV（当前读取仓库根目录下的 CSV 文件）。
• 名单清洗：输入框失焦后自动清除空行，并按行解析姓名（支持换行/逗号/分号分隔，自动去重）。
• 随机点名：点击“开始滚动”随机抽取未点名单，点击“停止”即选中当前姓名。
• 进度统计：实时显示总人数、剩余人数和已点人数，方便核对点名进度。
• 已点名单管理：按点名顺序展示已点名单，支持手动移除、复制、导出、清除，并实时更新按钮可用状态。
• 本地持久化：待点名单、已点名单、主题和当前名单名会保存在浏览器 localStorage。
• 名单命名：导入 CSV 时自动使用文件名作为名单名；手动输入时自动生成中文名单名（如“手动名单-30人”）并随人数变化更新。
• 创建 PR：可将已点名单直接提交到 GitHub 仓库并自动创建 Pull Request，默认标题和文件名会带上当前名单名。
• 界面布局：桌面端采用双栏布局，长名单在区域内滚动，保存提示保持轻量展示。
• 主题切换：支持白天/夜间模式，自动适配系统主题。

使用方法

1. 打开在线页面：点名器在线页面。
2. 录入名单：可手动输入/粘贴姓名（建议每行一个），或点击“从 GitHub 导入”并输入 owner/repo 选择 CSV 文件。
3. 点击“开始滚动”，再点击“停止”抽取一名；可重复直到名单结束。
4. 使用“手动标记”可快速将选中姓名移入已点名单。
5. 在“已点名单”标题旁查看已点人数；已点名单可“复制 / 导出 / 创建 PR / 清除”，需要重置时可使用“清空名单”。

补充：如需本地离线使用，也可直接打开 index.html。

创建 PR 说明

1. 在“已点名单”区域点击“创建 PR”。
2. 填写目标仓库、文件路径和 PAT（个人访问令牌）。
3. 默认会自动生成文件路径（包含当前名单名 + 时间戳）、PR 标题（包含当前名单名 + 日期）和分支名（按日期生成）。
4. 点击“创建 PR”后，工具会在目标仓库创建/使用分支、提交名单文件并发起 PR。

提示：私有仓库通常需要 repo 权限，公开仓库通常需要 public_repo 权限；PAT 仅在当前会话内使用，不会保存到 localStorage。

二次部署（可选）

如果你是维护者或需要自定义版本，可自行 Fork 后重新部署到 GitHub Pages：

1. Fork 本仓库到你自己的账号。
2. 在仓库设置中启用 Pages，选择分支和发布目录。
3. 完成部署后，用你自己的 Pages 链接访问。

文件结构

• index.html：页面结构与各功能入口（导入、点名、已点名单、PR 模态框等）。
• script.js：核心交互逻辑（点名、计数、存储、CSV 导入、PR 创建、名单命名等）。
• styles.css：页面样式与主题。
• image/：项目截图等资源。
• LICENSE：Apache License 2.0。

许可协议

Apache License 2.0。欢迎自由使用、修改和分发，但请遵守相关条款。

AI 使用说明

本项目在开发过程中使用了 AI 辅助（包括代码生成、重构建议与文档优化），并在迭代中持续调整。当前代码与文档已包含多轮 AI 协作结果，同时由维护者进行审阅、验证与取舍。

说明：AI 参与不代表功能天然正确，仍建议在实际使用前结合你的场景进行验证。

---

如有建议或问题，欢迎提交 Issue。