超星学习通签到

有一个基于[具体实现]的命令行签到工具，在此基础之上，利用.js、UI 以及 Koa 将其扩展成了 Web 项目。

功能包括普通签到，还有拍照签到，以及手势签到，同时有位置签到，包含签到码签到，也有二维码签到，能多用户储存凭据，并且可通过 IM 协议自动签到。

环境

可在任意运行 > v18.14 的平台签到，、、 ...

安卓手机上可以用 来运行程序，查看教程 。

查看苹果手机的部分，可通过这种方式来使用，此方式也适用于其他。

部署

将仓库克隆到本地

使用 git 命令克隆指定的仓库，仓库地址为 https://github.com/cxOrz/chaoxing-sign-cli.git 。具体操作为执行 git clone 命令，将该仓库克隆到本地。

进入项目文件夹，并安装依赖

cd chaoxing-sign-cli
pnpm install

运行

命令解释

根目录下：

apps/ 目录下：

apps/web 目录下：

基本使用方式

进入 apps/ 目录下，执行以下步骤：

构建代码

pnpm build

构建完毕后，在接下来的运行过程中，直到下次更改代码之前，无需再次进行构建，能够直接运行。

pnpm start

使用须知

为节约资源，仅对 2 小时以内的活动进行签到。若存在多个有效签到活动，那就只签到最新发布的那个。把即将结束的课程移到其他文件夹，这样减少根目录中的课程，就能提升活动检测的速度。

二维码签到

在运行之前需要做些准备。首先找一位挚友，然后拍一张二维码的照片，接着识别二维码，从而得到一个字符串，再复制其中的 enc 参数值，比如 。在询问时需要填入该值。若使用 UI 仓库的项目（查看高级），就可以直接选择图片并自动解析得到 enc 参数。如果遇到 10s 变换的二维码，可参考 #178 。

位置签到

输入经纬度和详细地址时需根据运行时的提示进行。经纬度可通过百度拾取坐标系统获取。点击某位置后，经纬度会出现在网页右上方。将其复制后，在询问时填入即可。详细地址的样例为：河南省郑州市中原区华中师范大学附属郑州万科城小学，此地址会显示在教师端。

拍照签到

需要准备一张用于提交的照片。通过浏览器访问超星云盘： ，在其根目录处上传你准备好的照片，照片命名为 0.jpg 或 0.png 。倘若使用 UI 仓库的项目（查看高级），那么就无需上传云盘，可直接选择图片来提交签到。

普通签到&手势签到&签到码签到

没有需要准备的，直接运行即可。

监听模式

支持开启QQ机器人、邮件推送、推送；

根据 go- 文档，需要配置正向、号以及密码，然后运行 go- 程序，这样就能运行监听模式并启用该选项。

若要发送二维码让机器人识别并签到，那么就需要配置 env.json 的相关内容，之后将利用腾讯云 OCR 来进行识别和处理。

监听模式每次启用 2 - 4 小时较为合适，且最好不要一直挂着不关。

高级

可以通过手动签到的方式使用简单的 pnpm 。也能够将其部署到服务器上，进而使用网页版本。不要忘记，这本身是一个 Web 项目。

一键运行

在根目录下执行 pnpm dev ，这样就会运行前后端服务，并且会在浏览器弹出项目的首页，需要注意的是这是处于开发模式的。

方案二：用提供的 镜像，运行后可通过 IP 访问。

从 ghcr.io 仓库中拉取名为 cxorz/chaoxing-sign-cli 的镜像，并且要拉取最新版本，即 latest 版本。
使用 docker 运行容器，设置为后台运行 -d ，将主机的 80 端口映射到容器的 80 端口 -p 80:80 ，将主机的 5000 端口映射到容器的 5000 端口 -p 5000:5000 ，并指定要运行的镜像为 ghcr.io/cxorz/chaoxing-sign-cli

出现问题？先仔细阅读相关说明，若仍无法解决请发

展示

演示地址： （海外服务器较慢，功能阉割仅供演示UI）

贡献须知

作者精力有限，从 2023 年 6 月 10 日开始，本项目会进入维护阶段，欢迎热心的同学们贡献代码。

发起 pr 之前要先发起进行讨论，接着新建一个分支，这个分支以提供的功能命名，然后在这个分支上完成你的代码，最后就可以提交 pr 了。

必要条件：