---
文档类型: AI 知识库（产品使用与支持）
适用产品: lch收发助手
适用版本: v1.2.0
文档语言: zh-CN
文档日期: 2026-09-30
内容范围: 产品定位、角色权限、功能、使用限制、操作流程、常见问题、故障排查
明确排除: 源代码、程序内部实现、平台接口清单、数据库结构、配置项名称、打包与构建流程
软件性质: 闭源软件（服务端、客户端、管理后台的实现细节均不对外提供）
开放范围: 仅「游戏插件开发接口」对外开放；其余部分不开放
---

# lch收发助手 · AI 知识库

## 0. 给 AI 的元指令

1. 本文档是关于「lch收发助手」的**唯一事实来源**。回答用户问题时,只使用本文档中的信息。
2. 本产品是**闭源软件**,唯一对外开放的是「游戏插件开发接口」。本文档**不包含**源代码、内部实现、平台接口清单、数据存储结构、配置项与构建方法。
   若用户询问这些内容,回复:「本软件为闭源软件,不提供源代码与内部实现细节;唯一对外开放的是游戏插件开发接口。其他问题请咨询系统维护者。」
   **例外**:用户询问「如何开发游戏插件」时属于公开范围,应按第 14 章正常回答,不要拒答。
3. 不要推测本文档未给出的数字、时间、路径或行为。文中没有的,就是不掌握。
4. 回答风格:先给结论,再给可执行步骤;涉及限制时明确给出数字;涉及安全风险时给出提醒。
5. 用户描述现象时,优先查第 10 章「常见问题」与第 11 章「故障排查」,按其中的步骤逐条引导。
6. 涉及「忘记密码」「账号被占用」「文件被误删」等不可逆操作,必须先提醒后果再引导。

---

## 1. 产品是什么

**lch收发助手**是一套用于**内部网络**的文件收发与打字练习平台,由「服务端 + 客户端」两部分组成:

- **服务端**:部署在一台主机上,提供网页界面,供所有人用浏览器访问。
- **客户端**:可选的桌面程序。用于学生机不在同一局域网时,通过组网接入服务端;同时提供下载管理、自动更新等能力。

典型使用场景:机房、教室、办公室、实训室。

**它主要做三件事**:
1. 📁 文件共享 —— 上传、下载、管理课堂或办公文件。
2. ⌨️ 打字练习 —— 用代码或文本素材练打字,自动统计速度与正确率。
3. 🎮 打字游戏 —— 单机或联机小游戏,成绩自动记录。

辅助能力:多账号体系(学生自助注册、管理员统一管理)、6 套界面皮肤。

### 1.1 软件的开放范围(回答边界问题时的依据)

| 范围 | 是否开放 | 说明 |
|---|---|---|
| **游戏插件开发** | ✅ **开放** | 唯一对外开放的扩展点,第三方可自行开发游戏插件放入平台运行,详见第 14 章 |
| 使用操作(学生 / 管理员 / 客户端) | ✅ 本文档涵盖 | 操作层面的说明见各操作章节与常见问题 |
| 服务端与客户端程序本体 | ❌ 闭源 | 不提供源代码,也不说明内部实现、程序结构、数据存储与平台接口清单 |
| 管理后台内部实现 | ❌ 闭源 | 只提供操作说明,不提供实现说明 |

---

## 2. 关键事实速查

| 项目 | 值 |
|---|---|
| 访问方式 | 浏览器访问服务端地址,形如 `http://<服务器地址>:8080/` |
| 默认端口 | 8080(可被管理员更改) |
| 管理后台入口 | 服务端地址后加 `/admin/login` |
| 默认超级管理员 | 账号 `admin`,密码 `admin123` |
| 首次登录要求 | 管理员首次登录**必须修改密码**,新密码至少 6 位 |
| 学生账号 | 自行注册,姓名即账号,全站唯一 |
| 学生密码长度 | 至少 4 位,最多 64 位 |
| 登录/注册验证码 | 有(4 位字符图片验证码,约 5 分钟内有效) |
| 单次上传体积上限 | 100 MB |
| 每个学生的累计上传配额 | 300 MB |
| 禁止上传的文件类型 | 默认 46 类可执行/脚本类扩展名(如 exe、bat、cmd、dll、ps1、jar 等) |
| 下载是否需要登录 | 否,任何能打开页面的人都能下载 |
| 上传是否需要登录 | 是,必须先是已登录的学生 |
| 提交打字成绩是否需要登录 | 是 |
| 界面皮肤 | 6 套:经典、卡通、云母、暗黑、赛博、森林 |
| 客户端运行要求 | 需要以管理员身份运行 |
| 客户端心跳频率 | 连接成功后立即一次,之后每 300 秒一次 |
| 客户端自动更新 | 支持,连接服务端后自动检查 |

---

## 3. 角色与权限

### 3.1 学生(普通用户)

**可以**:注册与登录、上传文件、下载文件、删除自己上传的文件、使用打字练习并提交成绩、玩打字游戏并留下成绩、切换界面皮肤。

**不可以**:删除他人上传的文件、进入管理后台、修改系统设置、管理游戏。

### 3.2 管理员

**可以**:管理学生账号(查看、重置密码、删除)、管理文件(查看、下载、删除任何人的文件)、查看与导出打字成绩、管理游戏(启用/停用/查看成绩)、配置上传黑名单与网络限速、管理其他管理员。

**分为两级**:
- **超级管理员**:能新增、删除管理员账号。
- **普通管理员**:只能修改自己的密码,不能增删管理员。

### 3.3 匿名访客

**可以**:浏览文件列表、下载文件、查看「关于」页面。

**不可以**:上传、提交成绩,这些操作会提示需要先登录。

---

## 4. 功能清单

### 4.1 文件共享

- 支持拖拽上传、选择单个/多个文件上传、**选择整个文件夹**上传(会保留文件夹层级并合并为文件名的一部分)。
- 自动跳过重复选择的文件;同名文件落盘时自动追加序号,不会互相覆盖。
- 上传过程显示进度、速度与预计剩余时间。
- 文件列表显示文件类型图标、大小、上传者。
- 下载带下载次数统计。
- 上传者可自行删除自己的文件。
- 管理员可删除任意文件(会同时删除服务器上的实体文件)。
- 可对上传与下载分别设置**限速**(单位 KB/s,设为 0 表示不限速)。

### 4.2 打字练习

- **三种素材来源**:平台内置的默认文本、老师放入的模板文件、学生自己从本机选择的代码或文本文件(支持 cpp、c、txt、js、py、java 等)。
- 可切换「要打注释 / 不打注释」;空行与行首缩进会自动跳过,减少无效输入。
- 屏幕上有**虚拟键盘**高亮当前该按的键,下方有**手指提示**告诉该用哪根手指;键盘可隐藏。
- 实时显示四项指标:用时、速度(字符/分钟)、正确率、输错率。
- 输入过程有音效反馈(按键、错误、完成)。
- 练习结束后可提交成绩,记录进入系统供老师查看。

### 4.3 打字游戏

- 游戏以「插件」形式存在,由管理员放入或移除;后台可启用/停用。
- 支持单机游戏与**联机游戏**;联机游戏通常需要输入相同的房间号进入同一局。
- 成绩自动记录,可在游戏内查看,也可由管理员在后台查看。
- **第三方可以自行开发游戏**:游戏开发接口是本产品唯一对外开放的扩展点,概要见第 14 章。

### 4.4 界面与体验

- 6 套皮肤一键切换,选择会被浏览器记住。
- 后台提供统计仪表盘、学生管理、文件管理、成绩管理、游戏管理、系统设置等页面。

---

## 5. 使用限制与规则(必须准确引用)

| 规则 | 说明 |
|---|---|
| 姓名规则 | 即账号,全站唯一;汉字最多 5 个或英文最多 10 个字符;只能包含中英文、数字、下划线 |
| 学生密码 | 至少 4 位,最多 64 位 |
| 管理员新密码 | 首次改密至少 6 位,需两次输入一致 |
| 单次上传体积 | 不超过 100 MB(超出会被服务端拒绝) |
| 累计上传配额 | 每名学生 300 MB;超额时上传会被拒绝 |
| 配额释放 | 删除自己上传的文件后,配额立即释放 |
| 危险文件拦截 | 按扩展名判断,默认拦截 46 类可执行/脚本类文件;命中时整批上传被拒绝并提示文件名 |
| 黑名单可调整 | 管理员可在后台修改;若清空则恢复为系统默认的 46 类 |
| 打字模板 | 若下拉框为空,说明平台尚未放入模板文件,可改用内置文本或自行选择本地文件 |

> ⚠️ 提醒 AI:「配额已满」与「文件类型被禁止」是两个不同的原因,回复时必须区分,不要混为一谈。

---

## 6. 学生操作流程

### 6.1 首次使用(注册)

1. 用浏览器打开老师提供的服务端地址;或打开客户端程序,点击「开始连接」。
2. 点击页面上的登录按钮,切换到「注册」页签。
3. 填写:姓名(即账号)、密码(至少 4 位)、再次确认密码、图片验证码。
4. 提交后自动登录。

### 6.2 日常登录

1. 打开页面,点登录,输入姓名与密码、验证码即可。
2. 忘记了密码:自己无法找回,需联系老师(管理员)重置。

### 6.3 上传文件

1. 进入「上传」页面。
2. 把文件拖入虚线区域,或点击按钮选择文件;也可以选择一整个文件夹。
3. 在列表中确认要上传的内容,移除不需要的。
4. 点击开始上传,等待进度完成。
5. 若提示「空间已满」,先到首页删除自己以前的文件再重试。

### 6.4 下载文件

1. 首页即为文件列表。
2. 点击文件条目即可下载。
3. 若使用客户端,点击下载会弹出保存对话框(默认保存到系统的「下载」文件夹),并在左侧下载管理面板显示进度。

### 6.5 打字练习

1. 进入「打字」页面,选择素材(下拉框模板 / 本地文件)。
2. 按需切换「是否打注释」「是否显示键盘」。
3. 照屏幕上的文本输入,跟着高亮键盘与手指提示。
4. 完成后在弹出的成绩框中确认提交。

### 6.6 玩打字游戏

1. 进入「游戏」页面,选择一个游戏卡片。
2. 联机游戏输入相同的房间号即可与同学同场。
3. 成绩自动记录。

### 6.7 切换皮肤

点击页面右上角的 🎨 图标,选择:经典 / 卡通 / 云母 / 暗黑 / 赛博 / 森林。

---

## 7. 管理员操作流程

### 7.1 首次登录

1. 打开服务端地址后加 `/admin/login`。
2. 使用默认账号 `admin` 与默认密码 `admin123` 登录(需填验证码)。
3. 系统**强制要求修改密码**:新密码至少 6 位,两次输入一致。
4. 改密后进入后台。默认密码被修改后不再显示。

### 7.2 后台能做的事

| 功能 | 说明 |
|---|---|
| 仪表盘 | 查看学生数、文件数、成绩数、启用中的游戏数、管理员数,以及最近的打字成绩 |
| 学生管理 | 查看全部学生与其登录情况;重置密码;删除账号 |
| 文件管理 | 查看所有上传文件(含大小、上传者、下载次数);下载;删除 |
| 打字成绩 | 查看成绩明细;导出为 CSV 表格;删除记录 |
| 游戏管理 | 重新扫描游戏目录、启用/停用游戏、预览游戏、查看某个游戏的成绩榜 |
| 管理员 | 新增/删除管理员、修改密码(增删仅限超级管理员) |
| 设置 | 配置禁止上传的文件类型、配置上传与下载限速 |

### 7.3 常用管理动作

- **新增游戏**:把游戏文件夹放入平台的游戏目录,然后在后台点「重新扫描」,或重启服务;确认游戏处于「启用」状态后学生即可看到。
- **调整上传限制**:在设置中修改被禁止的文件扩展名列表;清空即恢复默认的 46 类。
- **限制网速**:在设置中填写上传/下载限速值(KB/s),填 0 表示不限速;对大文件传输效果明显。
- **重置学生密码**:在学生管理中对该学生执行重置,新密码至少 4 位。

### 7.4 安全提醒(应向管理员强调)

1. 首次部署后**立即修改超级管理员默认密码**。
2. 组网密码存在默认值,**必须改成自定义的强密码**。
3. 不要将服务端直接暴露到公网,本产品面向内部网络设计。
4. 上传的文件类型黑名单只是按扩展名拦截,不能替代杀毒软件。
5. 服务器上的密钥文件与数据库文件属于敏感数据,不应外传。

---

## 8. 客户端(桌面程序)说明

### 8.1 定位

客户端用于**学生机与服务端不在同一局域网**时,自动完成组网并打开服务端页面;同时提供本地下载管理与自动更新。

### 8.2 界面构成

| 区域 | 内容 |
|---|---|
| 顶栏 | 版本号、设备标识、主机名、连接状态;按钮:用户协议、检查更新、上报日志、退出 |
| 左侧面板 | 下载管理:下载进度、状态、打开文件夹、清空 |
| 右侧区域 | 内嵌的服务端网页(未连接时显示占位提示与「开始连接」按钮) |
| 底部 | 状态栏与实时时钟 |

### 8.3 行为特性

- **必须整目录分发**:客户端文件夹里的运行库、组网程序、驱动与自带浏览器运行时缺一不可,不能只拷贝单个可执行文件。
- **需要管理员权限运行**:否则会请求提权。
- **用户协议**:首次使用需滚动阅读到底部才能同意;不同意则退出程序。同意状态会被记住。
- **自动更新**:连接服务端后自动比对文件并静默更新;也可手动点「检查更新」。更新后会自动重启。
- **日志上报**:可把最近的运行日志上传到服务端,便于维护者排查问题。
- **心跳**:连接成功后立即上报一次设备信息,之后每 300 秒一次;管理端可据此看到设备的主机名、使用者、操作系统与上下线时间。
- **中文文件名下载问题**:客户端下载文件名含中文的文件时**可能失败**,这是已知缺陷;临时办法是改用浏览器下载。

### 8.4 客户端故障的典型表现

| 现象 | 常见原因 |
|---|---|
| 窗口打开了但页面空白 | 客户端文件夹缺少自带的浏览器运行时,分发时未整目录拷贝 |
| 一直停在「正在连接」 | 配置缺失或组网未连通:网络名/密码/中继节点/端口不全、组网程序或驱动文件缺失、未以管理员身份运行、服务端主机名被改动、中继地址不可达;自动发现最多需要约 45 秒 |
| 提示协议需要同意 | 首次使用未滚到底部点击同意 |

---

## 9. 网络与连接概念

| 概念 | 通俗解释 |
|---|---|
| 服务端地址 | 老师和学生访问的网址,由「服务器地址 + 端口」组成 |
| 端口 | 默认 8080;若被占用或另有安排,管理员可更改,更改后所有人都要用新端口 |
| 组网 | 让不在同一局域网的学生机也能访问服务端的技术;由客户端自动完成 |
| 网络名 + 网络密码 | 组网的「房间名与门禁密码」;服务端与客户端必须完全一致才能互通 |
| 中继节点 | 当两端无法直连时,借助公网上的中转服务器打通连接 |
| 虚拟 IP | 组网后自动分配给每台设备的内部地址,学生无需关心 |
| 公钥指纹 | 客户端界面上显示的一串字符,用于确认「连上的是自己的服务器」而不是冒充者 |

---

## 10. 常见问题与标准答复

> 每条给出「标准答复」,AI 可直接改写后输出。

### Q1 端口被占用、服务起不来怎么办?
**答复**:换一个端口重新启动即可(在启动器的端口输入框中修改)。改端口后需要同步通知学生,并把客户端的端口配置一并更新。

### Q2 同一局域网的其他电脑打不开网页?
**答复**:依次检查三件事:① 服务是否已启动并在监听;② 服务器防火墙是否放行了该端口;③ 客户端或配置文件里填的服务器地址是否误写成了 `127.0.0.1`(那是本机地址,别的电脑连不上)。

### Q3 杀毒软件报毒、文件被删?
**答复**:这类程序被打包后常被误判。请把**整个程序目录**加入杀毒软件的信任区/白名单,不要只添加单个可执行文件。

### Q4 忘记管理员密码了?
**答复**:优先用另一个超级管理员账号在后台重置密码。若没有任何可用管理员账号,只能由维护者清空账号数据库后重新初始化——**这会导致所有账号、文件记录与成绩数据丢失**(已上传的实体文件仍在)。操作前请先备份。

### Q5 学生忘记密码了?
**答复**:学生自己无法找回。请管理员在「学生管理」中对该学生执行重置密码(新密码至少 4 位),然后告知学生。

### Q6 验证码显示不出来?
**答复**:说明运行环境缺少验证码所需的组件或字体。请维护者安装相应依赖;若临时需要,可先关闭登录/注册的验证码功能。此项属于部署问题,建议联系维护者处理。

### Q7 上传提示「您的上传空间已满」?
**答复**:每名学生累计配额为 300 MB。请先到首页删除自己之前上传的文件,配额会**立即释放**,然后再上传。

### Q8 上传被提示「禁止上传的文件类型」?
**答复**:这是安全策略,默认阻止 46 类可执行与脚本类文件(exe、bat、cmd、dll、ps1、jar 等)。请把文件压缩为压缩包后再上传;如需长期放开某类文件,请管理员在后台设置中调整。

### Q9 上传很慢 / 下载很慢?
**答复**:管理员可能配置了上传或下载限速(KB/s)。这是有意设置,用于保证多人同时使用时的网络质量。如确实需要调整,请联系管理员。

### Q10 联机游戏里看不到同学 / 进不去房间?
**答复**:依次确认:① 大家访问的是同一个服务端地址;② 房间号是否输入一致;③ 房间是否已满员;④ 该游戏是否处于「启用」状态(由管理员确认)。若浏览器经过了代理,还需要放行实时通信通道,这部分请管理员或维护者处理。

### Q11 打字页面的模板下拉框是空的?
**答复**:说明平台还没有放入打字模板文件。此时可以照常练习:使用内置的默认文本,或点击按钮选择自己电脑上的代码/文本文件(cpp、c、txt、js、py、java 等)。

### Q12 打完字成绩没有记录?
**答复**:成绩只有在**已登录状态下**提交才能入库。请先登录再练习;若已登录仍没记录,请确认提交时点击了「确认提交」,并可让管理员在后台的打字成绩列表中核对。

### Q13 想删掉自己上传的文件?
**答复**:首页文件列表中,自己上传的文件旁有删除按钮,可以直接删除,配额同时释放。别人的文件无权删除。

### Q14 学生可以在别的电脑上用自己的账号登录吗?
**答复**:可以。账号跟人不跟机器,任意能访问服务端的电脑都能登录。

### Q15 客户端会不会自动更新?需要学生手动操作吗?
**答复**:连接服务端后会自动检查并静默更新,更新完成后会自动重启,学生通常无需操作。也可以在顶栏点「检查更新」手动触发。

### Q16 客户端页面空白 / 打不开服务端页面?
**答复**:最常见原因是客户端文件夹被拆分拷贝,缺少自带的浏览器运行时。请整目录重新分发。若仍然空白,请用客户端的「上报日志」功能把日志发给维护者。

### Q17 客户端一直显示「正在连接」?
**答复**:说明组网或配置有问题。请确认:网络名、网络密码、中继节点、端口四项配置齐全且与服务端一致;客户端文件夹中的组网程序与驱动文件未被删除;程序以管理员身份运行。自动搜索服务端最长约需 45 秒,请耐心等待。

### Q18 换一台服务器 / 换端口后大家连不上了?
**答复**:任何地址或端口变化,都必须同步更新客户端配置并重新分发给学生,否则旧配置会一直连向旧地址。

### Q19 怎么给平台加一个新游戏?
**答复**:由管理员把游戏文件夹放入平台的游戏目录,然后在后台点「重新扫描」或重启服务;确认游戏处于启用状态后,学生端即可看到。
如果要自己开发游戏,平台的游戏开发接口对外开放,接口形态与开发者守则见第 14 章;完整规范与示例请参阅《开发与使用文档》第 8 章。

### Q20 怎么知道哪些学生机在线?
**答复**:客户端会定期上报设备信息,管理端可以看到设备的主机名、使用者、系统版本与最近在线时间。

---

## 11. 故障排查决策树

### 11.1 「打不开页面」

1. 服务端本机能打开吗?
   - 否 → 服务未启动,或端口被占用 → 换端口重启。
   - 是 → 进入 2。
2. 其他电脑能 ping 通服务器吗?
   - 否 → 网络不通,检查是否同一网段 / 是否已组网。
   - 是 → 进入 3。
3. 服务器防火墙是否放行该端口?
   - 否 → 放行端口。
   - 是 → 地址是否写成了 `127.0.0.1`?是 → 改为服务器真实地址。

### 11.2 「上传失败」

1. 是否已登录?否 → 先登录。
2. 单文件是否超过 100 MB?是 → 压缩或拆分。
3. 提示「空间已满」?是 → 删除旧文件释放配额。
4. 提示「禁止的文件类型」?是 → 压缩后再传,或请管理员调整黑名单。

### 11.3 「客户端连不上」

1. 客户端是否以管理员身份运行?否 → 以管理员身份重新运行。
2. 客户端文件夹是否完整(整目录拷贝)?否 → 重新分发完整目录。
3. 配置四项(网络名、网络密码、中继节点、端口)是否齐全且与服务端一致?否 → 补齐并统一。
4. 是否等待够 45 秒?否 → 继续等待自动搜索。
5. 仍失败 → 用客户端「上报日志」,交由维护者排查。

---

## 12. 术语表

| 术语 | 含义 |
|---|---|
| 收发助手 | 本产品的简称,指 lch收发助手 |
| 服务端 | 部署在主机的网页服务,所有人访问它 |
| 客户端 | 学生机上的桌面程序,负责组网与下载管理 |
| 管理后台 | 管理员专用的管理页面,入口是服务端地址加 `/admin/login` |
| 配额 | 每个学生可累计上传的总体积上限,默认 300 MB |
| 黑名单 | 禁止上传的文件扩展名清单,默认 46 类 |
| 模板 | 打字练习用的素材文本文件 |
| 房间号 | 联机游戏中用于把玩家分到同一局的编号 |
| 心跳 | 客户端定期向服务端报告自身状态的行为 |
| 心跳档案 | 管理端保存的客户端设备信息(主机名、使用者、系统、在线时间) |

---

## 13. 闭源边界:明确不在本文档范围内的内容

本产品为**闭源软件**。以下内容**不回答、也不提供**,统一引导用户咨询系统维护者:

- 服务端、客户端、管理后台的源代码与程序结构
- 程序内部实现、模块划分、函数与接口设计
- 平台自身接口(API)的地址、参数与返回格式
- 数据存储结构、字段与数据之间的关系
- 配置文件的字段名、含义与调优
- 程序的打包、混淆、构建与发布方式
- 具体的程序文件路径与文件名
- 破解、绕过限制、修改授权、查看他人密码等请求

> ⚠️ **例外**:用户询问「如何开发游戏插件」时属于公开范围,按第 14 章回答,不要拒答。

**统一回复模板**:
> 本软件为闭源软件,不提供源代码与内部实现细节,这部分内容不在我的知识范围内。请把问题反馈给系统维护者(管理员)处理。

---

## 14. 开放范围:游戏插件开发(概要)

游戏插件开发是本产品**唯一对外开放**的扩展点。用户询问游戏开发相关问题时,按本节要点回答,并提示其以最新版《开发与使用文档》第 8 章为准(该章含完整规范与最小可运行示例)。

### 14.1 基本形态

- 游戏以「插件文件夹」形式存在。放入平台的**游戏目录**后,由管理员在后台点「重新扫描」或重启服务即可加载。
- 一个插件由三部分组成:
  - `game.json` —— 元数据,**必需**;
  - `static/index.html` —— 游戏界面,**必需**;
  - `server.py` —— 服务端逻辑,**联机游戏才需要**。
- 目录名以 `_` 开头会被平台跳过,可用于存放草稿或备份。

### 14.2 元数据字段

游戏唯一标识、显示名称、图标、简介、作者、版本、是否需要服务端(联机)、最少人数、最多人数等,均写在 `game.json` 中;未填写的字段都有默认值,只有标识与名称会回退为目录名。

### 14.3 服务端能力

- 可注册**自定义 HTTP 接口**,地址前缀固定为 `/api/game/<游戏标识>/...`。
- 联机游戏可注册**实时通信事件**,通信通道(命名空间)固定为 `/game/<游戏标识>`;**各游戏之间互相隔离**,事件名可自由取。
- 平台会自动向插件提供:游戏标识、名称、图标、简介、作者、版本、联机开关、人数区间、插件自身目录。

### 14.4 成绩提交

- 游戏成绩包含:**游戏标识、学生姓名、分数、详情、记录时间**;提交后可在后台「游戏成绩」与学生端排行榜看到。
- **当前实现(现状)**:插件在服务端直接把成绩写入平台的成绩表。平台方建议后续封装为**官方 SDK 接口**(例如一个提交函数),让插件不再关心底层存储。
- 提醒开发者:除成绩外,**不要**读写平台的其他数据。

### 14.5 前端约定

- 插件页面由平台以 **iframe** 方式载入,无需自己实现导航栏与登录框。
- **学生姓名**可从父页面的 `#studentWelcome` 元素读取;取不到时应使用兜底名称(如「同学」)。
- 平台支持 6 套皮肤,插件页面建议同时适配浅色与深色环境。

### 14.6 开发者守则

| 允许 | 不允许 |
|---|---|
| 自行编写插件的前后端页面 | 访问平台内部的账号、文件、配置等数据 |
| 注册自己的接口与实时通信事件 | 读写平台程序目录中的任何文件 |
| 提交成绩到平台成绩系统 | 依赖本文档未公开的内部结构 |
| 读取当前登录学生的姓名 | 长时间阻塞服务端主流程 |
|  | 绕过登录鉴权或伪造学生身份 |

### 14.7 回答时的注意事项

1. 可以说明**接口形态与字段**,但**不要展开平台自身的实现细节**。
2. 涉及具体代码写法时,引导用户参阅最新版《开发与使用文档》第 8 章。
3. 明确告知:公开接口**不承诺永久不变**,长期维护的插件应只使用公开接口。
4. 后台加载失败、静态页面 404、实时通信连不上等报错,可按「插件未按要求放置 / 元数据格式错误 / 未开启联机开关」三个方向引导排查。

---

*本文档由产品使用信息整理而成,不含源代码相关内容。面向开发者的《开发与使用文档》(含游戏开发指南)另行提供。*