浏览器演示使用模拟数据，不连接真实教学或 AI 服务。学生端建议横屏，教师端支持自适应。
# 学翼 P0 双端原型使用说明与功能清单
## 打开方式
双击 [总入口](index.html)，选择学生端或教师端。也可分别打开：
- [学生端](学生端/index.html)：黑白横屏墨水屏布局，建议 1280 像素以上宽度；窄屏可横向滚动。
- [教师端](教师端/index.html)：自适应 Web，支持桌面、平板和手机。
- [学生登录界面](学生端/index.html#login)、[教师登录界面](教师端/index.html#login)：可直接查看登录、找回密码等入口。
所有 HTML、CSS、JavaScript 均为本地文件，不依赖 CDN，不需要构建或安装依赖。原型默认进入演示账号，退出登录后可以体验登录表单。
双端数据使用同一浏览器的本地存储。若需要同时体验“教师发布—学生收到”“学生提交—教师复核”的流程，建议从**同一个本地 HTTP 地址**打开两个端；直接使用 file 地址时，跨页面本地存储行为取决于浏览器。可以用编辑器的静态预览服务，或在本目录用已有 Python 启动：
```text
python -m http.server 8080 --bind 127.0.0.1
```
然后打开 http://127.0.0.1:8080/ 。学生和教师应使用同一个主机、端口与浏览器；不同浏览器或隐身窗口不共享演示数据。
## 演示边界
这是界面与流程原型，不是 Android 应用或真实教学后台：
- 客观题按示例规则计算；主观识别和评分使用明确标注的模拟数据，不调用外部 AI。
- 图书的 PDF、EPUB、文本页展示示例排版与相应控制，不解析真实电子书文件。
- 图片上传、画布书写、笔记、草稿、书签、组卷、任务、反馈、复核记录和 CSV/JSON 导出可本地操作。
- 题目模板导入展示固定的“通过行 / 错误行 / 确认导入”样例，不解析所选 CSV。
- 微信通知、真实密码修改、设备系统权限、离线整本书下载不连接真实服务。下载状态是演示缓存标记。
- 班级分组、偏好设置、手机号找回、权限申请等提供表单及反馈；并不改变学校真实组织或设备设置。
- 首页和报告的部分统计为示例数据；新任务、笔记、复核结果和完成状态会反映本地操作。
- 平台、学校、家长三个端不属于本次原型交付。教师端展示相关授权边界，但不提供其完整管理界面。
原型没有任何真实账号密码。登录页预填的是虚构演示值；教师验证码演示为 123456。
## 学生端页面及按钮
| 页面 | P0 可见功能与按钮 |
|---|---|
| 登录 | 学校编号、学号、密码、隐私同意、登录、忘记密码、隐私说明 |
| 我的书桌 | 待办、作业进度、阅读时长、笔记数量、开始作答、作业详情、继续阅读 |
| 作业中心 | 全部及各状态筛选、搜索清除、同步、详情、作答、评阅进度、反馈和订正 |
| 作答 | 单选、多选、判断、填空、简答、数学解答、作文、组合题；答题卡、前后题、保存、退出 |
| 手写作答 | 细/粗笔、橡皮、撤销、恢复、清空、保存原笔迹、预览、模拟识别与文字确认 |
| 图片作答 | 上传、图片预览、所属题号及答题区确认、模拟识别、修正确认、删除图片 |
| 提交确认 | 作答数量、漏答检查、空白提交确认、离线阻断、提交回执、版本说明 |
| 评阅进度 | 接收、识别、评分、复核状态；刷新、异常场景、重试、提交历史 |
| 评阅反馈 | 正式得分、逐题答案、教师反馈、评分依据、解析、已读、报告、订正新版本 |
| 错题本 | 筛选搜索、详情解析、重新作答、掌握标记、错因笔记 |
| 阅读任务 | 范围、截止、要求、阅读状态、开始阅读、详情、读后反馈 |
| 图书馆 | 分类搜索、简介授权、加入书架、阅读、下载或禁止缓存提示 |
| 我的书架 | 未读/在读/已读、阅读进度、移出提示、下载、缓存清理 |
| 阅读器 | PDF/EPUB/文本示例页、目录、前后页、跳页、字号、行距、缩放、位置保存 |
| 阅读批注 | 书签添加删除、示例段落划线、文字批注、手写批注、笔记定位和导出 |
| 读后反馈 | 要求、阅读过程、草稿、提交、待确认、教师反馈 |
| 我的笔记 | 新建编辑删除、原文定位、读物筛选、搜索、手写预览、文字导出 |
| 学习记录 | 正式结果、知识点示例、任务/自主阅读口径、任务状态、导出 |
| 消息通知 | 查看、任务跳转、已读未读、全部已读 |
| 个人设置 | 资料、密码表单、监护人说明、在线离线、同步、横屏全屏、模拟全刷、手写偏好 |
| 帮助与数据 | 通知偏好、下载管理、存储备份、隐私、意见反馈、退出、重置演示 |
## 教师端页面及按钮
| 页面 | P0 可见功能与按钮 |
|---|---|
| 登录 | 学校、账号、密码、验证码示例、找回、隐私同意、登录 |
| 教学工作台 | 待办、提交与阅读统计、复核入口、最近作业、阅读任务、快捷录入上传 |
| 我的班级 | 授课班级、名单、搜索、学生详情、分组表单、班级设置、任教范围、加入申请、重置密码申请、名单导出 |
| 学生详情 | 作业、阅读、笔记、提醒、答案查看、复核、点评 |
| 题库选题 | 题型/来源/关键词筛选、题目详情、标准答案、解析、来源、授权、难度、加入试题篮 |
| 题目录入编辑 | 学科、题型、选项、分值、知识点、标准答案、解析、细则、难度、新版本与审核状态 |
| 模板导入 | 下载 CSV 模板、选文件、示例预检、错误行说明、错误报告导出、确认样例导入 |
| 审核与纠错 | 审核进度、模拟平台审核通过、题目纠错、反馈处理入口 |
| 评分细则 | 满分、合法答案、得分点、扣分规则、复核策略、多选/填空规则说明 |
| 作业设计 | 名称、题篮、题序、分值、换题移除、继续选题、预览、草稿、发布设置 |
| 作业发布 | 班级、全班/部分学生、起止时间、补交、订正、答案解析、主观复核、确认发布 |
| 作业管理 | 状态搜索、概况、复核、复制、草稿、撤销任务、重新评阅、历史、导出 |
| 作业概况 | 提交人数、复核覆盖、异常、未交名单、提醒、截止设置、逐题失分点、导出 |
| 评阅复核 | 切换作业、按学生/题、原始答案、识别修正、评分证据、分项建议、确认分与原因、逐题保存、批量确认 |
| 复核异常 | 放大原件、批注、退回、人工接管、失败重试、历史、新评阅版本 |
| 结果发布 | 仅发布已确认答卷、学生正式反馈、错题更新、撤回、保留历史 |
| 阅读资源 | 搜索格式状态、上传、预览、编辑、授权期限、可见范围、下载权限、审核发布、下架、删除引用检查 |
| 阅读任务 | 指定读物、章节/页范围、班级、部分学生、截止、读后要求、任务预览与发布、修订 |
| 阅读完成情况 | 完成人数、有效时长、笔记、反馈、未完成提醒、教师评价、退回补充、确认完成、报告导出 |
| 学情报告 | 班级/时间查询、统计口径、正式成绩/待复核、失分点、阅读汇总、CSV 导出 |
| 消息与反馈 | 班级通知、消息查看已读、学生问题、教师回复、处理状态 |
| 个人设置 | 资料密码、身份与权限、教材学科、教学默认策略、通知、日志、备份、隐私、退出、重置 |
## 需求编号覆盖
依据 [需求分析和架构设计](../需求分析/需求分析和架构设计.md)：
- HW-01—HW-06：教师题库、模板、审核状态、选题组卷、发布与评分细则。
- HW-07—HW-11：学生正式反馈、订正、错题、学生记录、教师作业和报告。
- HW-12、HW-13：家长、学校、平台专属界面未制作；只在本次两端展示权限说明和相关统计口径。
- RD-01：教师资源、审核状态和授权。
- RD-02—RD-06：学生图书馆、书架、阅读器、批注、笔记。
- RD-07—RD-08：教师发布、学生读后反馈、教师评价与确认。
- RD-09：学生离线场景、笔记草稿与同步、下载权限提示。
- RD-10：学生记录及教师阅读汇总；家长/学校界面未制作。
- P0 共用：两端登录、个人设置、权限提示、消息、反馈、版本、日志、备份及恢复初始演示数据。
## 推荐演示路线
1. 教师端：题库选题 → 加入试题篮 → 作业设计 → 发布设置 → 确认发布。
2. 学生端：作业中心 → 作答 → 手写/图片确认 → 检查提交 → 评阅进度。
3. 教师端：评阅复核 → 逐题或批量确认 → 发布已确认结果。
4. 学生端：查看正式反馈 → 订正 → 错题本 → 学习记录。
5. 教师端：阅读资源 → 布置任务。
6. 学生端：阅读中心 → 阅读器 → 书签/批注 → 读后反馈。
7. 教师端：阅读完成情况 → 教师评价 → 确认完成。
8. 学生端：查看教师反馈和笔记；设置中模拟离线、联网同步。
“恢复初始演示数据”会清除当前浏览器的双端演示修改；不涉及真实平台数据。
## 浏览器验证记录
当前版本已验证：
- 27 个主要业务页面的渲染；另有两端登录及对应弹窗界面。
- 学生端 73、教师端 92 种主要页面按钮动作均有处理入口。
- 作业 5 种题型作答、提交回执、教师批量复核发布、学生查看正式反馈。
- 阅读翻页、书签、文字笔记刷新恢复、画布手写批注、读后反馈与教师确认。
- 教师新作业和阅读任务发布后，学生端能在同源浏览器看到。
- 离线同步提示、恢复联网同步。
- 教师端 390 像素宽度的主要页面不出现整页横向溢出，宽表格在容器内滚动。
- HTML 直接通过本地 file 地址打开，可加载脚本与样式。
以上验证针对桌面 Chromium 的原型，不代表 Android 安装、博阅 SDK、真实模型、真实 PDF/EPUB 引擎、微信审核或生产部署通过。
## 文件结构
```text
原型演示/
├── index.html
├── 使用说明与功能清单.md
├── 公共资源/
│ ├── common.css
│ └── common.js
├── 学生端/
│ ├── index.html
│ ├── app.js
│ ├── style.css
│ └── 首页预览.png
└── 教师端/
├── index.html
├── app.js
├── style.css
├── 首页预览.png
└── 手机预览.png
```