东南大学「学生素质讲座」预约系统的第三方客户端：Wails 3 + Vue 3 + TypeScript，界面基于 shadcn-vue（Tailwind CSS v4，黑白配色）。一份 Go 代码编出全部平台：
- 桌面版：Windows
seuszjz.exe（单文件、双击即用、无控制台窗口）、macOS.app/.dmg（Apple Silicon + Intel 通用二进制）、Linux AppImage / deb / rpm。 - 移动版：Android APK / AAB、iOS 模拟器包。
- 服务器版：
-tags server构建的纯 HTTP 服务（无 GTK / WebView 依赖），打包成 Docker 镜像后用浏览器访问。
前端资源与验证码模型全部内嵌进可执行文件，运行时不依赖 Python、onnxruntime、CUDA，也不需要显卡。登录态、账号、密码、会话 Cookie 只存在浏览器的 localStorage 里，程序不会在运行的机器上生成任何配置或会话文件，所有请求直连学校系统。
学校已明确禁止使用脚本预约讲座。本工具仅用于个人学习与研究，请勿用于代抢、售卖脚本等违规用途；一经查实，学校将限制预约权限并依规处置，使用本软件视为已经知晓。
本仓库的全部代码与文档均由 DeepSeek V4.1 Flash 在 DSH（DeepSeek Harness）中完成，DSH 未安装任何额外插件。 需求由作者提出，实现、调试与文档撰写由模型完成；仓库内所有说明统一使用中文。
项目以 MIT 许可证开源、永久免费、无广告、不收集任何数据。首次启动会弹出免责声明，勾选「我已认真阅读」后才会进入程序；确认结果会记录在本地，之后不再打扰。
- 统一身份认证登录：CAS 账号密码 → aTrust 网关 → ehall 讲座系统，三步全自动；密码可用 RSA 公钥加密后提交，登录进度实时回显。
- 校园网 / 校外自适应：先匿名探测一次，判断要不要经过
vpn.seu.edu.cn的 aTrust 网关；也可在设置页手动锁定「校园网 / 校外」。只有网络不可达才切换路径，密码错误这类业务失败不会做无谓重试。 - 免登录 / 自动登录：登录成功后把账号、密码（AES-GCM 混淆）与会话 Cookie 写入
localStorage（键名seuszjz.state.v1）；Cookie 失效时用保存的密码静默重登一次。 - 讲座列表：实时同步，显示状态（可预约 / 未开放 / 已满 / 已结束 / 已预约 / 已打卡 / 已违约）、容量、时间地点主讲人，支持关键字搜索与状态筛选，并按预约窗口倒计时。
- 预约 / 取消：弹窗展示验证码，可手输或让内置模型一键识别；「验证码错误」自动换一张，「操作频繁」提示稍后再试。
- 我的预约：预约码、打卡状态、预约时间一目了然，未结束的预约可直接取消，并根据已预约讲座统计毕业要求完成情况。
- 通知公告：列表 + 展开正文，置顶公告高亮。
- 自动抢座：选定目标讲座后轮询列表，开放瞬间自动取验证码并提交；支持自动识别 / 人工输入两条路径、限流冷却、完整运行日志，成功后窗口闪烁提醒。
- 更新检查：登录后静默读取 GitHub 上的最新正式发布版本，只提示、不自动下载；有更新时左下角出现提示，点开可看版本对比、变更摘要与发布页链接（
https://github.com/only9464/seuszjz/releases/latest）。 - 设置：账号、记住密码、自动登录、验证码自动识别、网络环境、深浅色主题、抢座默认参数、清除本地登录信息。
- 纯 Go 验证码识别：基于 only9464/ddddocr-go 做前向推理，不依赖 Python / onnxruntime / cgo，单次识别约 100~150 ms。
| 用途 | 依赖 |
|---|---|
| 运行桌面版 | Windows 10/11（WebView2 运行时，Win11 自带）/ macOS 12+ / Linux（GTK4 + WebKitGTK 6.0） |
| 运行移动版 | Android 7.0（API 21+）/ iOS 15+（模拟器包） |
| 运行服务器版 | 任意支持 Docker 的系统 |
| 通用构建 | Go 1.26+、Node.js 20+、wails3 CLI v3.0.0-beta.34、npm；task 可选 |
| Windows 桌面版 | 无额外依赖（纯 Go 交叉编译，CGO 关闭，ARCH=amd64|arm64 都行） |
| macOS 桌面版 | macOS + Xcode 命令行工具；非 macOS 主机走 Docker 交叉镜像 |
| Linux 桌面版 | libgtk-4-dev、libwebkitgtk-6.0-dev（Ubuntu/Debian：sudo apt install） |
| iOS | macOS + Xcode（xcrun）；真机分发还需要开发者证书与描述文件 |
| Android | JDK 17+、Android SDK 35、NDK（ANDROID_NDK_HOME）；Gradle 由 wrapper 自带 |
从 Releases 下载对应平台的包：
| 平台 | 拿到的文件 | 怎么用 |
|---|---|---|
| Windows | seuszjz.exe / seuszjz-windows-amd64.exe |
双击运行；无控制台窗口，首次启动会提示免责声明 |
| macOS | seuszjz-macos-universal.dmg / .zip |
打开 dmg 把 app 拖进「应用程序」；未签名，首次需右键「打开」 |
| Linux | seuszjz_*_amd64.deb、*.rpm、*.AppImage、seuszjz-linux-amd64.tar.gz |
用包管理器安装，或 chmod +x 后直接跑 AppImage；需要 GTK4 + WebKitGTK 6.0 |
| Android | seuszjz-android.apk |
允许「安装未知来源应用」后安装 |
| iOS | seuszjz-ios-simulator.zip |
解压后用 xcrun simctl install booted seuszjz.app 装进模拟器 |
Windows 首次启动若白屏，装一下 WebView2 Evergreen Bootstrapper（Win11 自带）。
一份代码，wails3 task 按平台分发（wails3 task <名字> 与系统里的 task <名字> 等价）：
wails3 dev # 开发模式：Vite 热更新 + Go 自动重编
wails3 task build # 当前系统的桌面版 → bin/
wails3 task package # 当前系统的分发包| 平台 | 构建 | 打包 / 分发 |
|---|---|---|
| Windows | wails3 task windows:build [ARCH=amd64|arm64] |
windows:package（绿色 zip） |
| macOS | wails3 task darwin:build / darwin:build:universal |
darwin:package（.app）、darwin:package:universal:all（.app + dmg + zip） |
| Linux | wails3 task linux:build |
linux:package（AppImage + deb + rpm） |
| iOS | wails3 task ios:package（模拟器，ad-hoc 签名） |
ios:package:ipa（真机，需要证书） |
| Android | wails3 task android:build |
android:package（release APK）、android:bundle（AAB）、*:fat（多架构） |
| 服务器版 | wails3 task build:server |
build:docker → seuszjz:latest |
几个约定：
- 版本号只在发布时决定：本地
wails3 task build构建出来的程序固定显示dev（exe 属性为0.0.0.0）， 仓库里不再跟着 tag 改版本号；要出正式版本用APP_VERSION=<版本> wails3 task windows:build。 - Windows 桌面版与服务器版是纯 Go（CGO 关闭），可以随意交叉编译；Linux/macOS 桌面版需要 CGO，在 Windows 上编它们会走
wails3 task setup:docker准备的交叉镜像（build/docker/Dockerfile.cross）。 - 辅助任务：
vet/test（server标签的静态检查与单测）、generate:icons、update:build-assets（改完build/config.yml后重新生成各平台构建资源）、clean、doctor。
main.go用go:embed内嵌frontend/dist，所以直接go build前要先有前端产物：cd frontend && npm ci && npm run build（wails3 task build会自动按顺序做）。
校外访问 ehall 必须先过 vpn.seu.edu.cn 的 aTrust 网关；校园网本来就在内网，那个网关通常用不上，所以登录路径是可选的（设置页「账号 → 网络环境」）：
| 模式 | 行为 |
|---|---|
| 自动识别（默认） | 先匿名请求一次 https://ehall.seu.edu.cn/：校外会被网关 302 到 vpn.seu.edu.cn/controller/v1/public/verify，据此判断要不要过网关 |
| 校园网 | 只走直连：CAS → ehall，完全不碰 vpn.seu.edu.cn |
| 校外 | 先过 aTrust 网关，再访问 ehall |
两条路互为兜底，但只有「网络不可达」（DNS 失败、拨号超时、连接被拒）才换路；密码错误、票据为空这类业务失败直接报错，不做无谓重试。直连尝试另有 15 秒预算，判错了也不会让人干等。
两点副作用：校园网直连时拿不到网关的 onlineInfo，用户名会退化成学号；切换网络环境后旧会话可能失效，但网络不通不会清掉本地登录信息（日志里是 网络不可用, 保留本地会话），恢复网络后可以继续用。实际走的路径会体现在登录进度和日志里（网络探测结果: campus / offcampus）。
服务器版用 -tags server 编译：Wails 把窗口实现换成空壳（Center / Flash / Focus 等都是空操作），改为只跑 HTTP 服务，因此 main.go 里没有任何「服务器模式」分支，同一份代码两种构建即可。前端页面、/wails/runtime 绑定调用、WebSocket 事件在普通浏览器里都能用，所以镜像里不需要 GTK / WebKitGTK。
wails3 task build:server # 本机平台的纯 HTTP 二进制 → bin/seuszjz-server
wails3 task build:docker # Docker 镜像，默认 seuszjz:latest
wails3 task run:docker # 构建并运行，浏览器打开 http://127.0.0.1:8080/官方镜像在 GHCR，大陆网络可以用南京大学镜像站 ghcr.nju.edu.cn：
docker run -d --name seuszjz -p 8080:8080 ghcr.nju.edu.cn/only9464/seuszjz:latest
# 只想本机访问：
docker run -d --rm -p 127.0.0.1:8080:8080 ghcr.nju.edu.cn/only9464/seuszjz:latest| 环境变量 | 默认值 | 说明 |
|---|---|---|
WAILS_SERVER_HOST |
localhost（镜像内 0.0.0.0） |
监听地址 |
WAILS_SERVER_PORT |
8080 |
监听端口 |
账号与会话都在浏览器 localStorage 里，服务器上不需要挂卷；容器重建后只要浏览器站点数据还在，就仍然免登录。
服务器模式下没有额外认证，能访问端口的人就能用你的登录态预约 / 取消。请只在本机或内网使用；公网部署务必加一层带认证的反向代理。
- 学号、密码（混淆后）、会话 Cookie 只存在浏览器
localStorage；Go 端只在内存里持有它们，不会在运行程序的机器上创建配置文件。桌面版的存储由 WebView2 的用户数据目录（%APPDATA%\seuszjz\webview）承载，服务器版由你自己的浏览器承载。 - 密码用 AES-GCM 混淆后才写入，但密钥编译在程序里，只能防「一眼看到明文」，不是安全边界：能读到那份 localStorage 的人同样能拿到 Cookie。
- 不保存手机号，也不保存短信验证码：当学校要求二次验证（陌生设备）时，验证码只在这一次登录请求里用一次——用学校下发的 RSA 公钥加密后直接提交给认证服务器，程序既不写入日志、也不进内存快照/
localStorage，界面输入框在提交成功后立刻清空。手机号本身程序不接触（发码接口只传学号，由学校自己发到已绑定的号码）。 - 清除方式：设置页「本地登录信息 → 清除」，或删掉浏览器的站点数据。
- 所有业务请求直连学校系统，不经过任何第三方服务器；本工具不收集任何数据。
- 唯一的对外请求是「检查更新」：只读 GitHub 的
releases/latest（版本号与变更列表），不发任何账号信息，也不会自动下载文件。 - 从旧版本升级：如果
%APPDATA%\seuszjz\（或SEUSZJZ_DATA_DIR指定的目录）里还有config.json/session.json，首次启动会自动导入一次并转存进 localStorage，不会删除旧文件，可自行清理。
识别用 only9464/ddddocr-go：纯 Go 的 ddddocr 移植，权重（20.4 MB 主干 + 分类头）用 go:embed 内嵌在依赖库里，图片解码、Lanczos 缩放、conv/BiLSTM 前向与 CTC 去重都在库内完成。internal/ocr 只是一层薄适配：
rec, err := digits.New() // 权重进程内只加载一次
text, err := rec.Recognize(jpeg) // 入参是图片原始字节所以仓库里没有 weights.bin，也不需要 Python 导出模型。换字符集只需改子包：digits（空白 + 0-9，当前用法）、alnum（字母数字）、full（完整字符集，权重 33 MB）。
依赖里有一条必须保留的 replace：
require github.com/only9464/ddddocr-go v0.0.1
replace github.com/only9464/ddddocr-go => github.com/only9464/ddddocr v0.0.1
上游 go.mod 声明的 module 路径是 .../ddddocr-go，而仓库地址是 .../ddddocr，不加 replace 会报 module declares its path as ... but was required as ...。同样地，不要在任何脚本或 Dockerfile 里批量删除 replace。
模型来自 ddddocr（MIT 许可）。go test ./internal/ocr -v 会用 testdata/ 里的真实验证码跑端到端、并发与超时用例。
main.go 入口：注册服务、创建窗口（服务器构建下是空壳）、注入事件
service.go 服务层：会话 / 讲座 / 抢座三组 API + 远端请求串行化
service_types.go 前后端共享的数据结构（TS 绑定由此生成）
update.go 更新检查：读 GitHub 最新正式发布，按「变更」小节挑条目
internal/seu/ 讲座系统协议客户端（CAS 登录、aTrust 网关、ehall 接口）
internal/store/ 账号与会话的内存快照（序列化成 JSON 交给前端存 localStorage）
internal/ocr/ 验证码识别适配层（内部用 ddddocr-go）
internal/grab/ 自动抢座引擎（状态机 + 轮询 + 验证码通道）
frontend/ Vue 3 界面（shadcn-vue + Tailwind v4，src/components/ui 为组件库）
src/assets/seu-logo.svg 是官方校标矢量图，界面与程序图标都用它
build/ Wails 构建配置：config.yml 元信息 + 各平台 Taskfile 与打包资源
windows/ darwin/ linux/ ios/ android/ docker/ 各是一个平台
scripts/ 逆向阶段的两个 Python 原始脚本（仅供对照，不参与构建）
.github/ CI：ci.yml 全平台编译检查，release.yml 打 tag 自动发版
前端调用 Go 的 TypeScript 绑定由 wails3 generate bindings 生成到 frontend/bindings/，构建时自动刷新。
界面左上角、登录页、窗口图标与 favicon 使用的都是东南大学官方校标。程序图标与 favicon 由 frontend/src/assets/seu-logo.svg（彩色校标，来自学校视觉识别系统的矢量素材）渲染导出：build/appicon.png（1024×1024）、frontend/public/favicon.png（128×128）、build/windows/icon.ico 与 build/darwin/icons.icns（wails3 generate icons 生成）。校标版权归东南大学所有，这里只作为本工具的标识使用，如与学校的视觉识别规范冲突，以学校规范为准。
两套工作流：
| 工作流 | 触发 | 做什么 |
|---|---|---|
.github/workflows/ci.yml |
push 到 main、PR、手动 |
全平台编译检查：Windows（amd64/arm64）、macOS 通用二进制、Linux 桌面版 + deb、Linux 服务版（amd64/arm64）、Android APK、iOS 模拟器包、Docker 镜像启动自检；外加 go vet + go test |
.github/workflows/release.yml |
打 v* tag、手动 |
同上全部平台出正式产物 → 汇总校验和 → 创建 Release，并把 linux/amd64 + linux/arm64 镜像推到 GHCR |
发版：
# 推荐：打 tag 推送，版本号取自 tag
git tag v0.0.4
git push origin v0.0.4也可以在 Actions 页面手动运行「发布」：填写版本号会构建并创建 Release；版本号留空只构建产物、不发布（版本号记为 0.0.0-dev-<短提交号>）。Release 标题只用版本号（如 v0.0.4）。
Release 里的产物：
| 产物 | 平台 | 说明 |
|---|---|---|
seuszjz.exe / seuszjz-windows-amd64.exe |
Windows | 桌面版 x64，双击运行，无控制台窗口 |
seuszjz-windows-arm64.exe |
Windows | 桌面版 ARM64 |
seuszjz-server-windows-{amd64,arm64}.exe |
Windows | 服务版，命令行运行后浏览器访问 |
seuszjz-macos-universal.zip / .dmg |
macOS | 通用二进制（Apple Silicon + Intel），ad-hoc 签名 |
seuszjz-server-darwin-{amd64,arm64}.tar.gz |
macOS | 服务版 |
seuszjz-linux-amd64.tar.gz、seuszjz_*_amd64.deb、*.rpm、.AppImage |
Linux | 桌面版（需要 GTK4 + WebKitGTK 6.0；AppImage 失败不阻断发布） |
seuszjz-server-linux-{amd64,arm64}.tar.gz |
Linux | 服务版（静态二进制，无图形依赖） |
seuszjz-android.apk / .aab |
Android | APK 未配置 ANDROID_KEYSTORE_* secret 时用 debug 签名，可安装、不能上架 |
seuszjz-ios-simulator.zip |
iOS | 模拟器包（ad-hoc 签名）；真机/上架需自己签名 |
SHA256SUMS.txt |
— | 以上文件的 SHA-256 |
Docker 镜像（两个架构打在一个 manifest 里，大陆可用 ghcr.nju.edu.cn 镜像）：
docker run -d -p 8080:8080 ghcr.nju.edu.cn/only9464/seuszjz:latest版本号只维护一处：.github/scripts/set-version.py <版本> 会改写 build/config.yml、build/windows/info.json（exe 属性，四段式）、build/darwin|ios 的 Info.plist、build/linux/nfpm/nfpm.yaml、service.go 的 var Version 与前端 package.json / package-lock.json（Android 的 versionName / versionCode 由 Gradle 直接读 build/config.yml）。Go 侧的 main.Version 再由构建参数 APP_VERSION 通过 -ldflags "-X main.Version=..." 覆盖（Dockerfile 里是 --build-arg APP_VERSION=...）。本地模拟发布构建：
APP_VERSION=0.0.4 wails3 task windows:build # Windows 桌面版
APP_VERSION=0.0.4 wails3 task darwin:package # macOS .app
APP_VERSION=0.0.4 wails3 task linux:package # Linux deb/rpm/AppImage
APP_VERSION=0.0.4 wails3 task android:package # Android APK
APP_VERSION=0.0.4 wails3 task build:server # 服务器版三条与仓库设置有关的提醒：
- Actions 的默认工作流权限是只读，工作流里已经自带
permissions: contents: write / packages: write，不需要额外改仓库设置。 - 第一次推送镜像后，GHCR 上的包默认是 private，需要在仓库右侧 Packages 里把它改成 public，否则别人拉取要先登录。
- 想给 Android 出正式签名包，往仓库里加
ANDROID_KEYSTORE_FILE/ANDROID_KEYSTORE_PASSWORD/ANDROID_KEY_ALIAS/ANDROID_KEY_PASSWORD四个 secret（keystore 文件建议 base64 后写进 workflow 再解码）；没配就走 debug 签名。
- 打不开 / 白屏：确认已安装 WebView2 运行时（Win11 自带，Win10 需装 Evergreen Bootstrapper）。
- 首次启动弹窗关不掉：那是免责声明，勾选「我已认真阅读以上内容，并承诺本人所有行为产生的后果自行承担」后才能继续；确认一次即可。
- 提示「验证码错误」：验证码约 1 分钟有效，取图后请尽快提交；识别错了点图片换一张。
- 提示「操作频繁」：学校系统有限流，等冷却时间结束再试，不要连续点击。
- 左下角提示「发现新版本」但打不开页面：校园网访问 GitHub 常常不通，可以用镜像站或挂代理后手动打开发布页；本程序不会自动下载更新。
- 换电脑后要重新登录：正常，登录态只存在浏览器本地，不会跟着程序走。
- Linux 上启动报缺库：装
libgtk-4-1与libwebkitgtk-6.0-4（打包的 deb/rpm 已把它们列为依赖）。
scripts/seu_lecture_proto.py 与 scripts/grab.py 是本项目协议实现的原始逆向成果，Go 端 internal/seu、internal/grab 是它们的移植版本。保留它们只为对照协议细节（CAS 表单、aTrust 跳转、验证码接口），不参与构建与运行，也不需要安装 Python 依赖。
- 提 issue 请说明系统版本、复现步骤与日志（日志里若含 Cookie / 学号请先打码）。
- 提交代码前请跑
go vet -tags server ./... && go test -tags server ./...与cd frontend && npm run build；go build ./...需要先构建过前端（见上）。 - 改完之后不用自己把所有平台都编一遍：PR 会自动跑
ci.yml里的全平台编译检查。 - 请不要把任何真实的账号、Cookie、验证码图片或包含个人信息的截图提交进仓库。
MIT。验证码模型权重来自 ddddocr（MIT），Wails 与 shadcn-vue 分别遵循各自许可证。
本项目仅用于个人预约讲座的自动化尝试，与东南大学官方无关。请遵守学校相关规定，不要用于抢票、代约等违规用途；使用本工具产生的一切后果由使用者自行承担。