Skip to content
ddcccchPublic

About

XinCT —— 二课 / 校园跑 / 俱乐部 / 网课自动化的桌面客户端(Electron):多成员管理、校园跑按成员开关、异常分组日志、雨课堂/智慧树自动刷课。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

XinCT

多成员的校园自动化桌面客户端(Electron)。把二课、校园跑、俱乐部、网课这几件重复劳动交给程序,一个人管多个成员,谁跑谁不跑各自说了算。

功能

二课:报名、签到、签退。签到 / 签退成功的记录不限条数——按日期区间检索,可选今天 / 7 天 / 30 天 / 90 天预设,结果区带滚轮,再多也不会撑爆页面。

校园跑:每次 4–5 km,里程随机且避开整百米、末位整十和连号,轨迹沿校区地图随机游走生成,逐点带时间戳。每位成员可单独关闭,关掉的人不会收到任何跑步任务。

俱乐部:按校区筛选(航空港 / 龙泉),校区列表从云端拉取,支持签到与签退。

网课:雨课堂、智慧树、知到三个平台,用原生 Electron runner 驱动,不需要 Python 环境。每个成员、每个平台一个独立登录窗口(独立 partition),登录后抓会话 cookie 保存,后续自动续播、自动下一节。播放器在 iframe 里也能逐帧探测;弹题、滑块这类挡路的会自动处理。也可以切到油猴脚本接管模式。

多成员:每人一套配置、一套登录态、一套任务状态。任务状态按「平台 + 成员」分格保存,雨课堂在跑的时候切到智慧树,按钮显示的是智慧树自己的状态,不会串台。

异常单独成册:二课签到 / 校园跑 / 俱乐部 / 课程平台 / 系统 五组独立记录。异常进异常日志,正常流程的日志不进前端。

界面

主面板按模块分栏,按钮只留图标(悬停有说明),能点就是能用,不写废话。窗口支持最小化 / 最大化 / 退至后台,托盘有退出菜单;后台播放显式关掉了 Electron 的 backgroundThrottling,最小化或被遮挡时页面计时器不降频。

目录

desktop/1ct/            渲染层(index.html / shell.js / shell.css / members.js / ek-stats.js)
desktop/1ct/platform-*  课程平台 runner:native(Electron 驱动)与 runtime(任务生命周期、登录窗口)
desktop/1ct/userscript-preload.cjs   油猴脚本注入垫片(GM_* API)
desktop/automation.js   二课 / 校园跑 / 俱乐部调度引擎
desktop/anomaly.js      异常分组与过滤
desktop/result-store.js 结果存储
desktop/score-policy.js 二课积分策略
tools/                  打包、便携版 zip、单文件 EXE 升级器
third_party/vendor/     第三方脚本与参考实现(各自带 LICENSE 与 SOURCE.md)

构建

desktop/install_1ct.py 负责把渲染层与主进程补丁打进 app.asar。--source 指向程序本体(exe、resources/、dll),--archive 指向要打补丁的原始 app.asar:

python desktop/install_1ct.py --source <程序本体目录> \
  --archive <原始 app.asar> build --force
python desktop/install_1ct.py --source <程序本体目录> --dest <输出目录> \
  --archive <原始 app.asar> verify --require-launcher

build 会打印产物哈希与 input_drift(必须为空),verify 校验目录结构、主程序隔离与启动器,成功时退出码为 0。

发行

# 便携版 zip
python tools/package_release_xinct.py --src dist/XinCT-145 --version 1.3

# 单文件 EXE 升级器(WinForms 界面,双击即用,自动查找本机安装位置)
python tools/build_updater_exe.py --src dist/XinCT-145 --version 1.3

升级器只认 XinCT.exe 与历史版本的 1CT.exe 这两种主程序名,并且要求同目录存在 resources\app.asar;dist\、work\、third_party\ 下的目录一律跳过。覆盖前备份到 <安装目录>\.backup\<时间戳>\,失败自动回滚。

测试

for f in desktop/test-*.cjs; do node "$f"; done
python -m pytest tests -q

数据目录

%APPDATA%\XinCT:配置、成员、登录态、任务历史。使用独立 userData 与独立单实例锁,可以和其它副本同时运行。首次启动会把旧目录整棵复制过来,迁移按「复制到暂存目录 → 写来源标记 → 原子 rename」推进,失败时目标保持为空、源数据不动。

第三方

项目 许可 用途
Niuwh/yuketang-jiaoben GPL-3.0 雨课堂油猴脚本(vendored,可切换接管)
huanweide/zhihuishu-helper MIT 智慧树油猴脚本(自带可视化面板)
CXRunfree/Autovisor MIT 智慧树自动化参考实现
LetMeFly666/YuketangAutoPlayer LGPL-2.1 雨课堂自动化参考实现

说明

仅用于本人已授权账号的自动化;课程、考勤、里程的真实性由使用者自己负责,请遵守所在学校的规定。

About

XinCT —— 二课 / 校园跑 / 俱乐部 / 网课自动化的桌面客户端(Electron):多成员管理、校园跑按成员开关、异常分组日志、雨课堂/智慧树自动刷课。

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages