QuickForm

目录

  • 关于QuickForm
  • 使用指南
    • 入门教程:四步体验QuickForm
    • 工作分析:QuickForm为何如此神奇
    • 教学应用:QuickForm如何赋能教学
    • 应用进阶:数据分析和大屏显示
    • 正式应用:本地部署和QFLink
      • 1. QuickForm的本地部署
      • 2. 本地部署QuickForm教师版
        • 2.1 部署QuickForm教师版
      • 3. QF数据互联(QFLink)服务
        • 3.1 用户认证登录
        • 3.2 数据任务迁移
    • 复杂任务:多模态数据回收和高级任务设置
    • 应用技巧:让QuickForm发挥作用
  • 应用案例
  • 开源教程
  • 学习资料
QuickForm
  • 使用指南
  • 正式应用:本地部署和QFLink
  • 查看页面源码

正式应用:本地部署和QFLink

QuickForm用最简单的方式解决了数据存储和读取的问题,得到了广大教师的认可。但在教学中正式应用QuickForm,还要面临“流量”这一道难题。因为教学中带来的海量访问,是QuickForm服务器(演示地址:https://quickform.cn)难以承受的。因此,我们推荐大家本地部署教师版,或者借助QFLink功能,借用其他QuickForm系统的数据服务。

1. QuickForm的本地部署

QuickForm采用Python语言编写,支持多操作系统,能快速部署到自己的电脑上,学校的服务器上,然后在局域网中使用。当然,也可以像我们一样,购买云服务器,在公网上使用。

我们把QuickForm分为在线版、校园版和教师版。本地部署的QuickForm,指的的是校园版和教师版。其中,QuickForm教师版开源,校园版免费提供给项目合作的单位(学校)。要获得QuickForm校园版,首先需要与项目组签署一个合作协议。合作协议的核心内容为能定期提供优秀案例分享给更多老师。我们期望能找到志同道合的朋友。

合作介绍:https://mp.weixin.qq.com/s/JIJSxCsL-ImGNuS2UnoAZg

协议内容:QuickForm校园版合作协议(第2版)

如果你有意向加入项目组,请来信联系(xiezuoru@vip.qq.com)。

想加入QuickForm项目的意向表:https://wj.qq.com/s2/25715865/17b8/

2. 本地部署QuickForm教师版

本地部署QuickForm有很多理由,主要有以下几条:

1)来自海量访问的担忧。因为限于财力和能力,我们无法保证这个线上的QuickForm能服务很多教师。当用户一多,也许网站访问速度就会很慢,轻则影响体验,重则无法正常提供服务。因此我们期望老师们能部署自己的QuickForm,确保可以稳定、正常地使用。

2)来自学校规模的需求。有些学校的规模较大,而且在全校层面开展AI赋能教学,不仅仅信息科技一个学科。那么就很有必要自己部署一个QuickForm,就跟我校一样,以教研组为单位,不仅能确保服务稳定,还能促进内部交流。

3)来自网络环境的制约。有些学校可能平时上课的地方(机房)不能上公网。有些老师在陌生的环境临时上课,尤其是公开课,就很有必要在自己的电脑部署一个专属QuickForm。比如我的电脑就安装了一个,专供自己使用。

2.1 部署QuickForm教师版

QuickForm教师版是一个开源软件,适用于每一位教师。QuickForm采用Python代码编写,支持Windows、Linux、MacOS等系统。

2.1.1 推荐方案:智能体安装

强烈推荐用智能体(如豆包工作、WorkBuddy、Qclaw等)来下载并安装部署QuickForm。

你只需要跟智能体说:请下载QuickForm教师版,并安装。

2.1.2 传统方案:手动安装

老师们只要将QuickForm解压到本地电脑,然后运行bat文件即可。

第一步、下载软件

访问QuickForm的开源仓库,即可在“teacher(教师版)”中找到下载链接。

开源仓库1:https://gitee.com/wstlab/quickform

开源仓库2:https://github.com/wstlab/quickform

飞书下载:https://my.feishu.cn/drive/folder/Q0FUf5KnLlQHJRdqyprck8YTnre

第二步、安装服务

下载“纯代码”版,根据readme文件中的介绍,把库装好,运行“app.py”文件即可。

2.1.3 传统方案:一键安装包

也可以下载“一键安装包”或者“安装版”。这些版本已经内置了Python,直接运行“QuickForm启动器.bat“即可。

感谢南宫市红庙中心学校的陈亮老师,为QuickForm教师版2.0做了安装版。

2.1.4 安装QuickForm的更多方法

还有很多简单的方式使用Quickfom,如下载中鸣版Thonny、mPython之类内置QuickForm的Python编辑器。

1)中鸣版Thonny:内置QuickForm

中鸣版Thonny,内置了Python3.8、XEduHub与QuickForm。

地址:https://ai.zmrobo.com/libs

2)mPython:in7以下版本也能安装QuickForm

QuickForm“一键安装包”内置的是Python3.8,在Win7中不能运行。其实你只要安装Python3.7之前的版本,如3.65之类,就能流畅运行QuickForm教师版。当然,你也可以安装mPython的32位版本(mPython 0.6.0),然后打开并运行QuickForm存代码版的“app.py”文件。

地址:https://mpython.cn/software

盛思之后推出的mPython,将内置QuickForm。

注意:启动QuickForm后,你的电脑就成为一台Web服务器,通过局域网地址即可访问。当然,你也可以通过一些网络软件,将本地端口映射到公网上。或者可以申请一个云服务器部署,但前提是要确保安全。

3. QF数据互联(QFLink)服务

QF数据互联服务简称“QFLink”,用于QuickForm系列版本的数据互联,实现在线版和其他版本之间的联动。其用途主要有两点:用户认证登录和数据任务迁移。新版的校园版(2.0)和教师版(2.5),默认都支持了QFLink。

3.1 用户认证登录

QFLink提供了用户认证的功能,可以应用于QuickForm生态软件,让用户不需要在多个系统中重复注册。

用途1:教师版第一次登录

自教师版推出安装包、U盘版文件后,在本地部署QuickForm已经越来越容易。常常有老师问一些低级的问题,比如用户名和密码是什么?因为好多老师们不知道要打开“readme.md”文件,获取基本信息。

在教师版安装后第一次登录时,可以选择QFLink方式,用在线版的用户名和密码登录。登录后,默认管理账户就自动转为在线版的用户名,并且能直接使用“任务导入”功能,导入在线版的数据任务。不仅可以导入任务的名称、简介和附件(HTML),还可以自动导入数据。

QFLink的用户身份认证功能适合企业提供的QuickForm教师版的收费服务。因为QuickForm在线版没有办法提供稳定可靠的数据回收服务,老师们在上公开课之类重要工作的时候总是特别焦虑。于是,有企业开始提供收费的教师版服务了,其原理是提供一台虚拟服务器(虚拟机),内置了教师版服务。用户购买服务类似“开机”,几乎没有任何技术门槛。启动后,输入在线版的用户名和密码,导入数据任务直接使用了。数据回收工作完成后(比如公开课结束),导出或者备份数据,关闭服务,就完成了所有工作。

注:急需稳定的数据回收服务,又没有能力部署服务器的老师,可以访问OpenHydra网站购买一个教师版服务,以备不时之需。

OpenHydra网站:https://openhydra.net

用途2:校园版的“临时”服务

当校园版的管理员开启了QFLink用户登录服务,在线版的用户都可以临时“借用地盘”使用数据回收服务。其使用方法和教师版完全一致,即选择“QFLink登录”,再“导入任务”,完成后导出任务。

目前,温科高的校园版已经支持QFLink服务。很快的,中鸣人工智能教学平台,浙江省的官方AI教学平台都会相继推出支持QFLink服务的校园版QuickForm。敬请期待。

3.2 数据任务迁移

顾名思义,数据任务迁移是指把QuickForm的数据任务从某个版本迁移到另一个版本。自教师版2.0和校园版1.0开始,就提供了数据任务到导入和导出功能。而“数据任务迁移”则支持在线操作,更加便捷。

功能1:数据任务和系统分离

在QuickForm的理念中,数据任务是灵活的、独立的,类似一个Word、PPT文件,并没有“绑定”在某台服务器或者某个系统上。这样一来,即使在线版流量不足,即使网络服务出现问题,也可以随时转到其他服务器上使用。

功能2:智能替换API地址

数据任务和系统分离看起来很好,但实现起来并不容易。最大的困难在于API地址的变化。普通教师毕竟没有能力直接修改HTML的源码。为此,新版QuickForm都增加了“智能替换API地址”功能。当用户从在线版导入任务时,会自动将网页中的API地址更换为相对路径(可以不用理解这个名词)。这样一来,只要学生是通过教师版的服务器地址(扫码)访问的网页,不管IP地址怎么变换,都能正常提交数据,正常看大屏。再也不用担心老师们问,为什么在线版本正常,教师版用不了。只要你先把在线版的任务调试成功。

再次强调一下数据任务的最佳路径:基于在线版制作、调试 -> 教师版或者校园版导入使用。

上一页 下一页

© 版权所有 2025-2026 XEduPro.All Rights Reserved。

利用 Sphinx 构建,使用的 主题 由 Read the Docs 开发.