适用版本:EESAST 小程序 1.2.0-dev + 真机联调修复 PR(#1 / #2 / #5)
更新日期:2026-10-21
目标:在开发者工具 与真机 上把登录态相关流程走通,补充自动化脚本覆盖不到的部分。
自动化脚本能覆盖语法、结构、绑定、签名与纯函数,但覆盖不到真实账号、真实数据、真实网络与渲染 。本清单就是那部分。
项
要求
微信开发者工具
Stable 最新版
基础库
≥ 2.10.0;推荐 ≥ 2.32.3
真机系统
iOS 与 Android 各至少 1 台(字体/安全区/键盘差异)
Node
≥ 18(仅用于跑校验脚本)
用开发者工具导入仓库根目录 (含 project.config.json,miniprogramRoot = miniprogram/)。
AppID:仓库里默认 touristappid;真机预览/上传前换成正式 AppID。
本地调试期勾选「不校验合法域名」;发布前必须关闭 并验证白名单生效。
project.private.config.json 已被 .gitignore 忽略,不要提交。
WSL 环境 :无需手动导入,执行 scripts/devtools.sh open(同步镜像到 D:\wechat-aaplet\eesast-applet 并调 CLI 启动工具打开项目),随后在工具栏点「真机调试」扫码;scripts/devtools.sh preview 可直接生成真机预览二维码。前置:工具 GUI 设置 → 安全设置 → 服务端口 已开启。
0.3 服务器域名白名单(小程序后台 → 开发管理 → 服务器域名)
request 合法域名
https://api.eesast.com(REST + GraphQL)
https://eesast-1255334966.cos.ap-beijing.myqcloud.com(COS 直传/签名)
https://static.eesast.com(静态图片)
downloadFile 合法域名
https://eesast-1255334966.cos.ap-beijing.myqcloud.com
https://static.eesast.com
角色
用途
需要的数据
未登录
公开浏览、登录/注册/找回
—
user(普通注册用户)
个人中心、清华认证入口、组队/评论权限边界
可登录账号
student(清华学生)
信息化平台、课程、导师、荣誉
有/无队伍各一个;有导师匹配;有荣誉申请
teacher
导师私信、角色闸门
有已通过的导师申请
counselor
角色闸门(应被信息化学生页拒绝)
可登录账号
赛事数据建议覆盖:THUAI (有 contest_time 的,如 THUAI7)、SOFT (第 9 届软件设计大赛)、RL 赛道、HARD (代码页应提示无代码提交流程)。
编号
入口
步骤
预期
A1
首页
打开小程序
轮播、部门横滑、赛事墙、快捷入口正常;图片来自 static.eesast.com
A2
赛事
切换状态筛选
筛选结果与「未开始/进行中/已结束」一致
A3
赛事详情
打开一个有节点的赛事
统计数字、简介、关键节点时间线 正常显示
A4
赛事公告
列表 → 详情
Markdown 正文正常;附件可获取下载链接
A5
资源
点「课程评测」
提示先登录,不发生跳转崩溃
A6
我的
打开
显示登录表单、注册/找回密码入口
编号
入口
步骤
预期
B1
我的
错误密码登录
提示「账号或密码错误」,不泄露账号是否存在
B2
注册
学生身份 → 邮箱验证 → 信息 → 密码
非 @mails.tsinghua.edu.cn 被拦;6 位验证码;学号 10 位;班级如「无76」
B3
找回密码
邮箱 → 验证码 → 新密码
密码强度校验生效;成功后可用新密码登录
B4
我的
退出登录
回到登录页;未登录仍可浏览公开内容
B5
任意登录页
手动使 token 过期(换设备登录/清缓存后重进)
请求 401 → 自动降级匿名,页面提示重新登录
B6
我的
清华邮箱认证(@tsinghua.edu.cn)
认证成功后角色升级,信息化 tab 可进入
B7
我的
注销账号
二次确认 + 验证码;成功后本地数据清空、回登录页
B8
我的
修改密码
旧密码错误被拒;成功后需重新登录
编号
入口
步骤
预期
C1
赛事列表
三个状态筛选 + 下拉刷新
列表与状态文案一致
C2
赛事详情
打开 THUAI7 / 第9届软件设计大赛
关键节点 显示 开始 ~ 结束 区间(THUAI7 应有 3 个节点)
C3
赛事公告
列表 → 详情 → 附件
按更新时间倒序;Markdown 渲染;附件可打开或复制链接
C4
组队
创建队伍
生成 8 位邀请码;创建后进入管理态;队名/简介可改
C5
组队
用邀请码加入
无效码提示;满员提示「队伍成员已满」(HTTP 551);重复加入有合理提示
C6
组队
队长移除成员 / 成员退出 / 队长解散
仅队长可移除/解散;二次确认;操作后列表刷新
C7
代码(THUAI)
上传 .cpp
代码列表出现新记录,编译状态 等待→编译中→成功(每 5s 轮询)
C8
代码(THUAI)
上传 .py / 删除代码 / 选择角色
.py 为「无需编译」;删除需确认;角色选择保存成功
C9
代码(SOFT)
未提交时提交链接;再次进入后更新
首次走「提交」,页面显示当前链接;再次提交走「更新」,不报错
C10
代码(SOFT)
终审代码 / DDL
终审链接独立保存;截止时间显示正确
C11
代码(RL)
提交历史链接
列表按时间显示,可复制
C12
对战记录
筛选/搜索/仅我的 → 下载回放
回放链接形如 .../{赛事名}/arena/{room_id}/playback.thuaipb
C13
对战记录
进行中/已结束对局
「下载回放」只在已结束 对局出现
编号
入口
步骤
预期
D1
信息化
用 user / teacher / counselor 打开
显示「需要清华学生身份」,不出现「信息加载失败」
D2
门户公告
切换 5 个分类 → 详情 → 附件
分类切换正确;附件可获取链接
D3
导师
导师列表
可申请/已满状态;积极分子导师有标记
D4
导师
提交申请 → 修改陈述 → 撤销
陈述必填;修改成功;撤销后列表更新
D5
导师
谈话记录上传
仅新生(in_freshman)显示导师谈话卡片;上传后列表刷新
D6
导师
旧系统记录(显示「旧系统」)下载
能下载 (回退 chat_record/{申请id}/)
D7
导师
积极分子谈话记录
仅 is_member 显示该卡片
D8
导师交流
联系人 → 进入聊天 → 发送
8s 轮询更新;自己/对方消息左右区分;返回列表正常
D9
荣誉
切换荣誉类型
成绩单/申请表/材料链接按类型显示;阶段与时间表正确
D10
荣誉
提交/编辑/删除
附件 ≤ 20MB;提交后状态「审核中」;重复申请有提示
编号
入口
步骤
预期
E1
课程列表
搜索/类型筛选
结果正确,无卡顿
E2
课程详情
查看评分
六维均分与我的评分正确
E3
课程详情
新增/更新/删除评分
有 0 分项时不允许提交;删除需确认
E4
课程详情
发布一条评论
立即出现在列表并标「待审核」 (刷新后仍在)
E5
课程详情
点「回复」→ 输入 → 发布
输入区标题变为「回复 xxx」;回复缩进 显示在父评论下
E6
课程详情
对回复点赞/收藏
操作有效,数字变化(回复上的操作不能失效)
E7
课程详情
编辑/删除自己的评论(含回复)
只有自己的评论显示编辑/删除;他人评论无入口
E8
SAST Weekly
打开列表 → 点击文章
mp.weixin.qq.com 公众号文章尝试在小程序内打开;加载失败可复制链接
编号
入口
步骤
预期
F1
我的
查看资料
用户名/姓名/学号/院系/班级/清华邮箱正确
F2
我的 → 编辑
修改班级/院系/姓名
保存成功;重进后回显(接口字段为 className)
F3
我的
更换头像
上传成功;列表/重进后仍显示(COS avatar/{uuid}/)
F4
我的
清华认证
仅 user 显示入口;成功后角色升级
F5
我的
修改密码
校验旧密码;成功后旧密码失效
F6
我的
退出 / 注销
本地 token、资料缓存清理
修复
对应用例
判定标准
赛事时间线字段修正
C2
赛事详情能打开,时间线显示起止区间(不再「赛事加载失败」)
SOFT/RL 代码数组取值
C9 / C11
未提交时能提交;已提交时显示当前链接并可更新
导师页角色闸门
D1
teacher/counselor 看到「需要清华学生身份」,无报错弹窗
导师谈话记录条件展示
D5 / D7
非新生不显示导师谈话卡片;非积极分子不显示积极分子卡片
旧系统谈话记录下载
D6
显示「旧系统」的记录可下载
对战回放 COS 路径
C12 / C13
链接含 /arena/{room_id}/playback.thuaipb;仅已结束对局显示入口
课程评论可见性与楼中楼
E4–E7
待审核评论可见;回复缩进;回复上的点赞/编辑/删除可用
状态码
含义
常见位置
401
token 失效 / 验证码错误
任意接口;登录、改密、注销
403
角色无权限 / 不在队伍中
信息化、组队、代码
404
资源不存在
公告/附件/回放
409
重复(荣誉申请、编译中)
荣誉、代码编译
429
频率限制
导师申请
450 / 451
参数缺失 / 角色不符
荣誉接口
551
队伍成员已满
组队加入
-1
网络失败(wx.request fail)
断网、域名未配置
真机上如果所有请求都失败,优先检查:服务器域名白名单 、HTTPS 证书、以及手机网络是否被校园网客户端隔离。
用例
结果
设备 / 基础库
截图
备注
C2
✅ / ❌
iPhone 14 / 3.4.10
链接
提 Bug 时请附 :页面路径、账号角色、复现步骤、预期/实际、网络类型、截图或录屏、控制台错误。
node scripts/test_structure.cjs # 页面/导航/事件处理器/组件路径
node scripts/test_wxml_balance.cjs # WXML 标签闭合
node scripts/test_bindings.cjs # WXML ↔ JS 绑定一致性
node scripts/test_utils.cjs # SHA1/JWT/Markdown
node scripts/test_cos_signature.cjs # COS 签名(有 SDK 时与官方实现逐字节比对)
CI(.github/workflows/ci.yml)会在每次 push / PR 自动执行以上检查。