ujiacrystal

This README is the one indexed from the repository at its latest ref, not from the tag for this version.

# U+ crystal

用于自动辅助**U+平台**学习的工具

## Features
- 全自动学习：每两秒自动查看一次学习状态
- 多账号学习
- 支持多种学习方式：普通学习直接秒，密码学习会根据常数`DEADLINE`的设置，决定在结束前几秒再学习
- 支持定时学习（注意，需要自己修改`DEADLINE`后重新编译）
- Web实时查看学习状态
- 账号自动认证

## Installation
#### Dependencies
> 目前仅支持Linux部署，其他平台请自行使用crystal语言环境编译
1. 确保Nodejs可用
   ```bash
   node --version
   ```
2. 确保 **Crystal** 语言环境正常，**shards** 包管理正常
3. 确保 本机/服务器 的端口`18888`打开
#### Install
1. 克隆仓库  
   ```bash
   git clone https://github.com/RetiredGuitar64/ujia-signer-by-crystal.git
   ```
2. 编译可执行文件
   ```bash
   shards build --release
   ```
   可执行文件会输出至项目目录的`bin`文件夹中
3. 获取账号token
   运行程序，并加入`-u`参数：
   ```bash
   ./bin/ujiacrystal -u
   ```
   按照提示输入手机号和密码，等待token获取
     
   > 这一步只要能获取到token就可以

   token应当为48位字符，并且请确认token校验通过后再使用

4. 将可执行文件移动至想要运行的机器，可以是公网服务器或linux本机
5. 创建账号配置文件（必须）
   在可执行文件的同目录下，创建文件 `accounts.txt`

   > 文件名不能错

   并写入账号配置，账号为一行一个，格式如下
   ```txt
   账号名称 | 刚刚获取到的token
   ```
   举例：
   ```txt
   Bob | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   ```
   - 支持写入多个账号，但是需要是同一个班级
6. 直接`./ujiacrystal`运行主程序

#### 注意
> 不使用的时候不要让程序一直跑，放假了就关掉，避免服务端监测到流量异常  

> 默认会秒杀普通学习，密码学习默认会在剩下10s的时候开始学习  

> 批量学习默认开启，可以直接批量添加账号

#### Web 显示学习状态
- 默认端口`18888`，直接访问 `your_ip:18888` 即可实时查看学习状态
- 若为普通学习，会显示密码为 `200`
- 若为密码学习，会直接显示密码
  
## Contributors

- [RetiredGuitar64](https://github.com/RetiredGuitar64) - creator and maintainer

## License / 授权协议

本项目采用 **PolyForm Noncommercial License 1.0.0** 授权。

你可以在**非商业**目的下使用、学习、研究、测试、修改和分发本项目。

使用、复制、修改、分发、部署或以其他方式访问本项目代码或Release文件，即表示你已经阅读、理解并同意遵守 **PolyForm Noncommercial License 1.0.0** 以及本项目提供的 `Required Notice`。

未经作者明确书面许可，任何个人或组织不得将本项目、本项目的修改版本或基于本项目的衍生作品用于商业用途，包括但不限于：

- 收费提供服务；
- 商业化部署；
- 销售、出租、收费部署或商业分发，无论是否开源；
- 作为商业产品的一部分；
- 用于盈利性组织的业务场景；
- 以本项目为基础进行二次包装、推广或销售。

如需商业授权、合作、定制开发或其他许可，请联系作者。

License: PolyForm Noncommercial License 1.0.0

Required Notice: Copyright (c) 2026 RetiredGuitar64. All rights reserved.