← 返回应用 Back to app 平台测试指南 — 学生助理版

平台测试指南 — 学生助理版

平台测试指南 — 学生助理版

日期: 2026-08-13 · 平台: preFeedbackRehearse (Vercel frontend + Railway backend) 中国大陆访问: https://prefeedback-rehearse-sigma.vercel.app/journey 国际访问: https://prefeedbackrehearse-production.up.railway.app/journey 目的: 两名学生助理在课程期间端到端测试平台。 联系人: Simon Wang (simonwang@hkbu.edu.hk) — 报告问题时请提供会话参考号（右上角 #ABC123）。

1. 平台功能简介

学生用英语完成医学国际会议口头汇报的全流程训练：

登录 → 我的任务 → （可选）学习微课 → 上传PPT和讲稿 → AI反馈 → 修改并重新上传 → 录音排练（录音+转写）→ Q&A模拟 → 任务小结

💡 重要提示：为获得最佳体验（特别是录音时的实时转写功能），请使用 Google Chrome 或 Microsoft Edge 浏览器。Firefox 和 Safari 不支持实时转写。

2. 已开发功能清单（逐项测试）

2.1 登录与注册

功能 状态 测试方法
学号/密码注册 ✅ 用学号（如 2026123456）+ 密码（≥8位，避免常见密码）注册
邮箱注册 ✅ 用真实邮箱 + 密码注册
全数字学号 ✅ 用全数字学号（如 2026123456）注册 — 应能成功
登录 ✅ 用学号或邮箱登录
退出 ✅ 点击”Log out 退出” → 返回登录页
测试账号 ✅ 一键点击”使用测试账号 / 使用测试账号”（共享账号，仅用于演示）
会话参考号 ✅ 登录后右上角显示 #ABC123；点击可复制完整ID

2.2 任务管理

功能 状态 测试方法
创建任务 ✅ 点击”开始新的汇报 / Start a new presentation”
单一活动任务 ✅ 同一时间只能有一个任务；已有任务时”开始新的”按钮隐藏
任务阶段 ✅ 进度显示：setup → learn → upload → feedback → versions → delivery → qa → summary
URL哈希路由 ✅ 每个页面有稳定哈希（#login, #home, #setup, #upload, #feedback, #versions, #delivery, #qa, #summary）— 可收藏

2.3 知情同意与任务设置

功能 状态 测试方法
数据知情同意 ✅ 阅读说明，勾选/取消录音保留，点击”同意并继续”
4个设置问题 ✅ 任务类型（研究汇报/病例报告/综述/方法学/其他）、研究领域（中医/临床/实验/护理/药理/公卫/其他）、是否有草稿、补充说明
示例材料 ✅ 点击”用示例材料体验 / Try with demo materials” — 自动填充设置 + 加载示例幻灯片和讲稿

2.4 微课学习（V01–V08）

功能 状态 测试方法
学习页面 ✅ 点击”从学习开始 / Start with lessons” — 列出8个视频及检测题
课程播放器 ✅ 点击视频 → 播放MP4 → 3道检测题（单选，中英双语）
检测题流程 ✅ 作答 → 查看解释 → 下一题 → 完成
V01–V08内容 ✅ V01（中文整体结构）、V02–V08（英语各部分课程）

2.5 上传与AI反馈

功能 状态 测试方法
PPTX/PDF上传 ✅ 上传 .pptx 或 .pdf（最大50MB）
讲稿粘贴 ✅ 直接粘贴文本到讲稿框
讲稿文件上传 ✅ 上传 .txt 或 .md 文件（Word .doc/.docx 会提示改为粘贴）
示例材料 ✅ 点击”用示例材料体验” — 加载示例幻灯片和讲稿
获取反馈 ✅ 点击”获取反馈 / Get feedback” — 显示实时进度（上传 → 读取 → 评价 → 生成）
分层反馈 ✅ 反馈按 必须先修改 / 重要修改 / 进一步优化（默认折叠）分层
反馈深链接 ✅ 每个问题按关键词自动链接到对应微课视频（Review V05 → /lesson/v05），无匹配时回退“全部微课”
教师评论 🟡 占位 区域已预留（尚未实现）

2.6 修改与版本管理

功能 状态 测试方法
版本历史 ✅ V1、V2、V3… 不覆盖旧版本
部分更新 ✅ 只更新PPT / 只更新讲稿 / 两者都更新（未更新部分自动沿用）
问题回应 ✅ 每个问题：已修改 / 本轮未处理 / 不适用或不采纳（+原因）
提交修订稿 ✅ 点击”提交修订稿并再次检查 / Submit revision and recheck”
版本对比 🟡 部分 平台重新检查新文件（状态：已解决/仍未解决/重新出现/新增问题）— 基础版本已实现

2.7 录音排练

功能 状态 测试方法
录音 ✅ 点击”开始录音 / Start recording” — 5分钟计时
实时转写 ✅ Web Speech API 实时转写（仅 Chrome/Edge）
麦克风测试 ✅ 点击”测试麦克风 / Test microphone” — 显示音量百分比
幻灯片预览 ✅ 加载当前版本的幻灯片；用 Prev/Next 或方向键翻页
幻灯片时间戳 ✅ 每次翻页记录时间戳，用于转写对齐
转写确认 ✅ 录音后检查/编辑转写 → “确认转写并获取反馈”
排练反馈 ✅ 双轨反馈（内容 + 表达），含语速和填充词统计
录音尝试 ✅ 多次尝试保存（不覆盖）；可标记为代表录音；“查看转写”可打开任意一次历史转写并“载入转写框”恢复
对比尝试 🟡 部分 基础对比已实现（仅限同版本同范围）

2.8 Q&A模拟

功能 状态 测试方法
问题生成 ✅ 从当前幻灯片+讲稿生成3–5个问题
练习/真实模式 ✅ 选择难度
语音/文字回答 ✅ 录音或打字回答；纯标点回答（如「？」「～」）会被明确拦截并提示重新回答
逐题指导 ✅ 按4个维度反馈（直接回答/有依据/控制长度/承认边界）+ 建议结构
重答/下一题 ✅ 可重答或进入下一题

2.9 小结与调试

功能 状态 测试方法
任务小结 ✅ 显示完成进度+ 完成质量评价（完成度/内容质量/表达质量/问答表现）+ 版本、问题、录音、Q&A
行为日志 ✅ 每个操作记录到 behavior_events（通过 /debug.html 查询）
会话参考号 ✅ 右上角 #ABC123；点击复制完整ID
错误信息 ✅ 包含会话参考号 + 上下文（文件大小、阶段等）

3. 测试场景（逐项执行）

场景A：正常流程（30分钟）

  1. 注册：用你自己的学号或邮箱（不要用共享测试账号）
  2. 创建任务 → 知情同意 → 设置（选”研究汇报” + “临床”）
  3. 用示例材料 → 点击”获取反馈” → 等待分层反馈
  4. 查看反馈 → 点击视频链接（如”Review V05”）→ 观看 → 返回
  5. 修改 → 回应2–3个问题（已修改/本轮未处理/不适用）→ 上传新版本
  6. 录音排练 → 测试麦克风 → 录音30秒 → 检查实时转写 → 确认 → 获取反馈
  7. Q&A → 回答2个问题（打字或语音）→ 查看指导
  8. 任务小结 → 查看任务小结
  9. 退出 → 重新登录 → 确认任务仍在

场景B：错误处理（15分钟）

  1. 上传Word文件（.docx）作为讲稿 → 应显示清晰错误（请粘贴文本）
  2. 上传大文件（>50MB PPTX）→ 应显示文件大小错误
  3. 不上传任何内容 → 应显示”请先上传幻灯片或粘贴讲稿”
  4. 选择”综述”或”方法学” 作为任务类型 → 反馈应正常工作（回归测试）
  5. 使用Firefox或Safari → 实时转写应显示浏览器警告
  6. 阻止麦克风 → 应显示清晰的麦克风被阻止信息
  7. 记录会话参考号（#ABC123）并查看 /debug.html 中的行为日志

场景C：微课学习（15分钟）

  1. 从学习开始 → 确认列出8个视频
  2. 播放V01（中文整体结构）→ 确认视频播放
  3. 播放V02 → 回答3道检测题 → 确认显示解释
  4. 播放V08 → 确认作答前不显示中文（按规范）
  5. 返回任务 → 确认进度已保存

场景D：多用户（10分钟）

  1. 两名助理各自注册不同账号
  2. 同时创建任务 → 确认互不干扰
  3. 同时上传 → 确认反馈独立
  4. 查看 /debug.html → 确认各用户事件分开记录

4. 问题报告格式

每个问题请包含： 1. 会话参考号（右上角 #ABC123） 2. 操作步骤（一步一步） 3. 预期结果 vs 实际结果 4. 截图（如有） 5. 浏览器和系统（如 Chrome 120, macOS 14）

发送至：simonwanghkteacher+test@gmail.com，抄送 simonwang@hkbu.edu.hk。报告会自动处理，一般 24 小时内回复；每份报告会存档并展示在测试日志页（/log.html）。

5. 已知限制（请勿报告）

限制 原因
实时转写仅支持 Chrome/Edge Web Speech API 限制（Firefox/Safari 不支持）
讲稿上传不支持 Word .doc/.docx 请直接粘贴文本
教师评论为占位符 尚未实现
版本对比为基础版 完整状态（已解决/仍未解决/…）后续实现
对比尝试为基础版 仅限同版本同范围
无服务器端转写 Railway 未配置 STT 密钥；浏览器处理
测试账号为共享 test2026 为公共账号；真实测试请用自己的账号

6. 快速参考

项目 链接 / 路径
主应用（中国大陆） https://prefeedback-rehearse-sigma.vercel.app/journey
主应用（国际） https://prefeedbackrehearse-production.up.railway.app/journey
健康检查 https://prefeedback-rehearse-sigma.vercel.app/api/healthz
调试页面 https://prefeedback-rehearse-sigma.vercel.app/debug.html
测试日志 https://prefeedback-rehearse-sigma.vercel.app/log.html
课程播放器 https://prefeedback-rehearse-sigma.vercel.app/lesson/v02 （v01–v08）
测试账号 学号 test2026 / 密码 Kt7!pQ2vR9wZx4m
GitHub https://github.com/tesolchina/preFeedbackRehearse
Railway https://railway.com/project/3089f89e-fd91-4fae-951a-8225017676f5

7. E2E测试套件（开发者用）

平台有 Playwright E2E 测试套件（9个测试，全部通过）：

cd preFeedbackRehearse
CLERK_SECRET_KEY=sk_test_… npx playwright test

覆盖：登录/注册、完整流程、微课+播放器、录音+Q&A、退出、全数字学号、邮箱注册、URL哈希路由+幻灯片预览、行为事件。