多成员的校园自动化桌面客户端(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-launcherbuild 会打印产物哈希与 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 | 雨课堂自动化参考实现 |
仅用于本人已授权账号的自动化;课程、考勤、里程的真实性由使用者自己负责,请遵守所在学校的规定。