超星学习通自动签到终极指南：告别繁琐手动操作

超星学习通自动签到终极指南：告别繁琐手动操作

【免费下载链接】chaoxing-sign-cli超星学习通签到：支持普通签到、拍照签到、手势签到、位置签到、二维码签到，支持自动监测、QQ机器人签到与推送。项目地址: https://gitcode.com/gh_mirrors/ch/chaoxing-sign-cli

还在为每天手动签到而烦恼吗？超星学习通自动签到工具帮你彻底解放双手！这个基于Node.js开发的命令行工具，支持普通签到、拍照签到、手势签到、位置签到、二维码签到等全功能，还能实现多用户管理和自动监测。无论你是Windows、MacOS还是Linux用户，甚至是安卓手机用户，都能轻松部署使用。

📱 为什么你需要自动签到工具？

想象一下这样的场景：早上8点有课，你还在床上挣扎起床，却突然想起今天有拍照签到。手忙脚乱地打开手机，找角度、调光线、上传照片……整个过程至少浪费5分钟。而使用自动签到工具，这一切都可以在后台自动完成，你甚至可以在睡梦中完成签到。

3个必须使用自动签到的理由

1. 时间效率最大化：一次配置，长期受益，每天节省5-10分钟签到时间
2. 避免忘记签到：自动监测功能24小时守护，再也不会因为忘记签到而扣分
3. 多设备兼容：支持电脑、手机、服务器部署，随时随地都能签到

🚀 快速入门：5分钟完成部署

准备工作：环境搭建

首先克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/ch/chaoxing-sign-cli cd chaoxing-sign-cli pnpm install

安卓手机用户特别指南

如果你使用安卓手机，可以通过Termux来运行Node.js程序：

1. 从F-droid商店安装Termux
2. 打开Termux并更新系统：apt-get update && apt-get upgrade
3. 安装Node.js和Git：pkg install nodejs git
4. 开启corepack并安装pnpm：corepack enable && corepack prepare pnpm@latest --activate

注意：安卓环境下需要先移除turbo依赖：pnpm remove turbo，然后运行pnpm install即可正常安装其他依赖。

基础运行方式

进入项目目录后，根据你的需求选择运行方式：

# 开发模式（前后端同时运行） pnpm dev # 构建项目 pnpm build # 手动签到 pnpm start # 启动后端接口 pnpm serve # 启动监听模式（自动签到） pnpm monitor

📸 拍照签到配置全攻略

拍照签到是最常用的功能之一，配置正确才能确保签到成功。

本地图片配置方法

1. 准备标准照片：使用手机拍摄清晰的正面半身照
2. 格式要求：保存为JPG或PNG格式，分辨率建议600x300以上
3. 命名规范：将照片重命名为0.jpg或0.png
4. 文件大小：确保文件大小超过100KB，避免压缩导致模糊

云盘配置（推荐）

如果你需要在多设备间同步签到照片，云盘配置是最佳选择：

1. 登录超星云盘：https://pan-yz.chaoxing.com
2. 在根目录创建专用文件夹（可选）
3. 上传准备好的0.jpg或0.png照片
4. 重要：保持照片"仅自己可见"权限，确保隐私安全

多设备同步方案

🎯 各种签到类型配置详解

二维码签到配置

二维码签到需要提前准备二维码信息：

1. 请朋友帮忙拍摄二维码照片
2. 识别二维码获取字符串
3. 复制其中的enc参数值（如1D0A628CK317F44CCC378M5KD92）
4. 在工具询问时填入该值

小技巧：如果使用Web界面版本，可以直接上传图片自动解析，无需手动复制enc参数。

位置签到配置

位置签到需要经纬度和详细地址：

1. 访问百度拾取坐标系统获取经纬度
2. 点击地图位置，经纬度会显示在网页右上方
3. 复制经纬度值（如113.123456,34.567890）
4. 准备详细地址（如：河南省郑州市中原区华中师范大学附属郑州万科城小学）

手势签到和普通签到

这两种签到类型无需特殊配置，直接运行即可自动完成。

🤖 监听模式：真正的全自动签到

监听模式是工具的核心功能，可以实现真正的无人值守签到。

开启监听模式

# 进入server目录 cd apps/server # 启动监听模式 pnpm monitor

推送通知配置

监听模式支持多种推送方式：

• QQ机器人：配置go-cqhttp实现QQ消息推送
• 邮件推送：配置SMTP服务器发送邮件通知
• pushplus推送：使用第三方推送服务

二维码识别增强

如需发送二维码让机器人识别并签到，需要在env.json中配置腾讯云OCR的SecretId和SecretKey。

最佳实践：每次开启监听2-4小时即可，不建议长时间挂机运行。

🏗️ 高级部署方案

Docker一键部署

如果你希望将工具部署到服务器上，Docker是最简单的方式：

docker pull ghcr.io/cxorz/chaoxing-sign-cli:latest docker run -d -p 80:80 -p 5000:5000 ghcr.io/cxorz/chaoxing-sign-cli

部署完成后，通过服务器IP即可访问Web界面。

Web界面版本

除了命令行版本，项目还提供了完整的Web界面：

• 前端界面：查看 前端配置
• 后端服务：查看 服务端配置

Web版本提供了更友好的操作界面，特别适合不熟悉命令行的用户。

⚠️ 常见问题排查指南

签到失败原因分析

性能优化建议

1. 课程管理：将已结束的课程移入其他文件夹，减少根目录课程数量
2. 签到范围：工具只对2小时以内的活动签到，避免资源浪费
3. 多活动处理：同时有多个有效签到活动时，只签最新发布的

🎓 学生实战案例分享

案例一：小王的学期签到计划

小王是计算机专业大三学生，本学期有6门课程需要使用超星学习通。他按照以下方案配置：

1. 周一至周五：开启监听模式，覆盖上午8点到下午6点
2. 周末：关闭监听，节省资源
3. 照片库：准备了5张不同角度的照片，每周轮换使用
4. 推送通知：配置QQ机器人，签到成功即时通知

结果：整个学期签到率100%，从未因忘记签到而扣分。

案例二：李老师的助教管理方案

李老师担任3个班级的助教，需要管理90名学生的签到情况：

1. 批量配置：使用storage.json中的multiUser参数管理多个账号
2. 统一照片：为所有账号配置统一的签到照片
3. 定时任务：设置每天定时运行签到脚本
4. 日志监控：定期检查签到日志，确保系统正常运行

🔧 进阶技巧与优化

照片轮换策略

创建photo_rotate目录并放入多张命名为1.jpg、2.jpg...的照片，在storage.json中配置：

{ "photo": { "rotate": true, "directory": "photo_rotate" } }

建议准备5张以上不同角度、不同服装的照片，每周自动轮换，降低被识别风险。

定时同步配置

通过crontab设置每天凌晨自动从云盘同步最新照片：

# 每天凌晨3点自动同步 0 3 * * * cd /path/to/chaoxing-sign-cli && pnpm sync --photo >> ~/.chaoxing/logs/sync.log 2>&1

网络优化建议

校园网环境下，建议使用手机热点进行云盘同步。校园网的防火墙经常会阻断API请求，导致同步失败。

📝 使用须知与注意事项

资源节约策略

为了节约系统资源，工具只对2小时以内的活动进行签到。如果同时有多个有效签到活动，只签到最新发布的那一个。建议定期清理已结束的课程，将其移入其他文件夹，这样可以显著提高活动检测速度。

安全提示

1. 账号安全：不要将Cookie等敏感信息分享给他人
2. 照片隐私：签到照片建议使用不包含个人敏感信息的图片
3. 合规使用：确保使用方式符合学校相关规定

维护建议

项目目前处于维护阶段，如果你遇到问题：

1. 仔细阅读相关文档和配置说明
2. 检查issue区是否有类似问题和解决方案
3. 如需提交代码贡献，请先发起issue讨论，然后新建功能分支进行开发

🎉 开始你的自动签到之旅

现在你已经掌握了超星学习通自动签到工具的全部使用技巧。无论是简单的命令行使用，还是复杂的服务器部署，都能轻松应对。

记住，自动化工具的真正价值在于让你有更多时间专注于学习本身，而不是每天重复机械的签到操作。花30分钟配置一次，换来整个学期甚至整个大学阶段的签到自由，这绝对是值得的投资。

开始配置吧，让科技为你的学习生活带来更多便利！

【免费下载链接】chaoxing-sign-cli超星学习通签到：支持普通签到、拍照签到、手势签到、位置签到、二维码签到，支持自动监测、QQ机器人签到与推送。项目地址: https://gitcode.com/gh_mirrors/ch/chaoxing-sign-cli