学习通 Cookie 不能从浏览器里复制粘贴到本页。请切换到「账号」标签,用手机号+密码登录,成功后服务端会把 Cookie 写入 cookies.json。
若登录过期:可点下方「手动续期 Cookie」(需已登录过);仍失败请重新在「账号」里登录。
首次使用或提示「无效 token」:先到「配置」保存后端地址,再点下面「获取 API Token」。
需先在「配置」里填好后端地址并获取 API Token,否则会 401。
若「同步课程」报错,点同步诊断查看 phase / message(与正式同步同一路径,但固定 HTTP 200 返回 JSON)。
aid 再签到。
本后端用同款数据源:GET /chaoxing/activities(超星 student/activelist)。
下面先填好 courseId / classId(可从「课程」页点选带入),点拉取活动列表,再点某条活动即可自动填入 activeId,无需复制数字。
先在「配置」里获取 API Token,且后端地址与小程序 API_BASE_URL 指向同一台服务。下列仅显示学习通登录名(一般为手机号);未绑学习通时尚无手机号,会显示「未绑学习通」。
用于「签到配置」里定位解析地址、位置签到写详细地址。保存在服务端 backend/map_keys.json,保存后立即生效。
若此处留空,仍可使用服务器环境变量 AMAP_WEB_KEY、BAIDU_MAP_AK(优先级:下面填写 > 环境变量)。
高德须使用控制台里 「Web 服务」类型的 Key(逆地理用 restapi.amap.com)。不要用「JS API」「Android/iOS SDK」专用 Key,否则能保存但解析会失败。
保存若报错:401「无效 token」→ 先到本页下方点「从服务器获取 Token」;500「无法写入…」→ 检查服务端对 backend 目录是否有写权限(勿把整个项目放在只读盘或受保护目录)。
若提示 Not Found / 404:多为网关只转发了 /chaoxing/ 而未转发 /admin/;本页已改为请求 /chaoxing/sign/map-keys,请更新后端到含该接口的版本并重启。
修改导航栏标题、首页横幅文案;可上传多张图片,首页以轮播展示;无图时显示黄色底+文字。
签到成功不再扣金币,改为按签到次数阶梯奖励;并可配置每日领取、新用户赠送、首页轮播公告。
填 0 表示不赠送。每个学习通分账钱包仅第一次成功绑定邀请码时叠加对应天数的畅享(限时 VIP);改绑、再次填写邀请码不再赠送。已是永久畅享的不叠加天数但仍记「已领过」。
卡密与钱包使用 SQLAlchemy 2 + SQLite,默认文件为后端目录下 app_data.sqlite3(旧版曾误写在 app/app_data.sqlite3,启动时若新库无卡密而旧库有,会自动迁移)。首次启动若库为空,会从 redeem_codes.json / wallet_users.json 导入一次。coins=加金币;unlimited=畅享(签到不扣金币),畅享天数填 0 表示永久;填任意正整数(如 3、14、90)为限时天数,7/30 仅为示例;可叠加续期。maxUses=0 表示不限总次数。环境变量 SIGNIN_SQLITE_PATH 可指定数据库文件路径。删卡密若遇 HTTP 405,多为反代/网关拦截某条 URL,管理台会自动换路径重试。
本批生成条数可自行填写;会记住你上次用的数字。服务端单次上限由环境变量 REDEEM_BATCH_MAX 控制(默认 5000)。
仅管理员在此配置发件服务器与授权码。用户在小程序「通知配置」中自行开启通知并填写收件邮箱;签到成功后会按用户设置发邮件。下方「测试收件」仅用于点「发送测试」。