

> 标签：#workbuddy #Node.js #课堂教学 #全栈开发 #教育信息化
>
> 全程与 WorkBuddy AI 助手协作开发，所有代码可运行、可测试、可复制迁移。本文不涉及任何真实学生信息与真实试题内容，示例均为虚构占位。

---

## 一、起点：一个真实的课堂痛点

我是一线教师。课堂上经常需要做随堂小测：讲完一个知识点，出几道题看看学生掌握情况。市面上的问卷类工具很好用，但在机房场景下有几个绕不开的问题：

1. **网络依赖**：机房网络时好时坏，外部 SaaS 一断网全班停摆；
2. **数据归属**：学生的作答明细存在别人服务器上，导出、留存、二次分析都不自由；
3. **题型限制**：填空想按空给分、简答想人工评分，通用工具要么不支持、要么收费；
4. **部署门槛**：学校内网环境装不了数据库、跑不了 Docker，最好"复制一个文件夹就能用"。

于是我想：能不能自己写一套**纯局域网、零第三方依赖、双击就能启动**的课堂小测系统？恰好我在用 WorkBuddy——一个能直接读写本地文件、运行命令、跑测试的 AI 助手，完全可以让它当"结对程序员"，我来提需求、验收，它来写代码、修 bug、跑回归。

9 月 17 日，项目启动。到 9 月 24 日，八天时间，系统在真实教学环境中稳定运行，覆盖一个年级 20 多个教学班。下面按"代际"复盘整个迭代过程。

---

## 二、技术选型：先给自己上枷锁

开工前定了三条铁律，回头看是整个项目最正确的决定：

- **零第三方依赖**：不装 npm 包、不装数据库。Node 原生 `http` 模块自建路由，数据用一个 JSON 文件持久化（写入时先写临时文件再原子重命名，损坏自动备份重建）。课堂数据量撑死几百条记录，JSON 完全够用，还省掉了所有"原生模块编译失败"的坑。
- **绿色部署**：服务监听 `0.0.0.0`，整个项目目录复制到任何一台电脑，双击 `start.bat` 就能跑；Node 运行时直接打包进目录，连"装 Node"这一步都省了。
- **测试先行**：每个功能落地必须带自动化测试，最后形成 10 组测试套件、800+ 条断言，改任何一行代码都能一键全量回归。

架构上就四块：`server.js`（路由 + 接口）、`lib/grade.js`（判分引擎）、`lib/store.js`（JSON 持久化）、`public/`（教师端与学生端页面，无框架原生 JS）。

---

## 三、迭代历程：六代演进

### 第 1 代：核心闭环（Day 1）

目标只有一个——跑通"教师出题 → 学生作答 → 自动判分 → 教师看板"的最小闭环。

- 教师端三种出题方式：手工录入、粘贴批量导入、按教材文本辅助出题；
- 学生端"学号 + 姓名"进入作答；
- 判分规则：单选/判断全等，多选全对才得分，填空做**归一化比对**（全角转半角、去标点、小写）后判分，`|` 分隔同一空的多个可接受答案；
- 教师端看板：提交进度、逐题正确率、未提交名单。

第一轮就修掉四个由自动化测试抓出的真实缺陷，最典型的一个是**批量导入时题干里的内联答案没有被剥离，会把答案直接泄给学生**——这类问题肉眼很难发现，测试的价值第一天就体现出来了。

### 第 2 代：真实课堂的磨砺（批量导入 + 鉴权 + 名册）

第一版给同事试用后，反馈集中而具体：

- **并排选项识别失败**：试卷里 `A. 选项一	B. 选项二`（Tab 分隔）排在一行，逐行解析会把整行塞进选项 A。修复方案是先做"并排选项判断"再做单选项行匹配——**判断顺序不能反**，否则正则先吃掉整行。
- **按钮点了没反应**：根因很隐蔽——部分环境会静默拦截原生 `confirm()` 弹窗，所有依赖它的交互全部静默失败。彻底弃用原生弹窗，自研一套 Promise 风格的确认/输入组件。
- **局域网与安全**：服务改监听 `0.0.0.0` 供全机房访问；教师端加口令登录（加盐哈希存储 + 定长时间安全比较），所有管理接口带令牌鉴权，学生端接口保持无门槛进入。
- **学生名册**：教师粘贴"学号 姓名"名单后，系统自动算未提交名单与提交率，学号做全角/半角与空白归一化，避免"看起来一样、字符串不一样"对不上号。

### 第 3 代：像样的"考试系统"（设置 + 看板 + 绿色版）

- **发布即开放**：砍掉"测验码"，改为"当前开放小测"单一状态，学生端打开页面自动看到正在进行的测验——机房里少一步就是少一分钟混乱。
- **试卷设置**：每份小测可独立配置练习/测验模式、自主交卷/限时交卷/教师统一收卷、答案是否可见。关键点是**答案可见性在服务端裁剪**，测验模式下前端根本拿不到答案数据；限时倒计时只用服务端时钟，超时由服务端兜底强制收卷。
- **按班分析**：看板支持班级维度汇总（应到/已交/平均分/及格率/未交名单），支持"一键收入名册"处理名单外作答。
- **绿色版运维**：踩了 Windows 批处理的一堆坑（中文注释导致 cmd 解码错位、隐藏窗口启动被各种拦截），最终用纯 Node 的"守护进程"方案落地：双击启动、关掉窗口服务不停、整个目录复制即迁移。还做了**开机自启**——一次机房断电重启后，我意识到"服务不常驻"在课堂场景是致命的。

### 第 4 代：题型与体验（段落说明 + 简答题 + 图片 + 预览）

- 新增**段落说明**题型：大题标题、阅读材料，不判分、不占题号、不计满分。这个需求牵出一类经典 bug——数组下标被当成题号传进渲染函数，导致段落说明"白占一号"、学生端题号从 2 开始。修复后确立了铁律：**题号必须按计分题连续编号，且只信一处"单一真相"**。
- 新增**简答题**：学生作答多行文本，教师端参考关键词自动判分或人工评分（见第 5 代）。
- 新增**图片插入**：题干/选项/解析支持上传与直接粘贴截图，方便出带图的题。
- 新增**卷面预览**：出题页一键按学生视角渲染整张卷面，未保存的改动也能预览；同时做题目完整性体检（缺题干/缺答案/选项不足统一标注）。
- 服务端加**代码指纹自检**：启动时记录代码哈希，前端能检测"服务端还是旧进程"并提醒重启。这一步是被真实事故逼出来的——加完新题型忘了重启服务，旧进程把简答题当成单选题校验，报出莫名其妙的错误。

### 第 5 代：判分精细化（这个系统真正的灵魂）

前四代解决"有没有"，第五代解决"判得对不对、公不公平"：

- **填空按空给分**：4 空 8 分的题，对 3 空 previously 得 0 分，改为每空 `分值 ÷ 空数`，对几空得几分；
- **逐空自定义分值**：出题时可逐空指定分值（之和等于题分）；
- **简答关键词加权**：参考答案支持 `关键词（N分）` 格式，命中几个累计几分，总分封顶为题目分值——避免"关键词分值之和超过题分"的漏洞；
- **简答容错匹配**：学生写"有唯一的标识"，关键词"唯一标识"中间夹了一个字，严格包含匹配会判 0。改为自适应容错（关键词越长允许夹字越多，**只许夹字不许换字**），并给师生两端逐个标注命中情况，判分透明可核对；
- **人工判分**：简答题不设参考答案时自动进入"待老师判分"状态，教师在学生卷面详情里逐题拖滑杆评分（0.5 分一档），保存后总分、学生成绩单、数据分析看板全部自动合并刷新；学生端状态位相应变为"正确 / 部分正确 / 错误 / ⏳ 待老师判分"四种。

配套做了一个很关键的机制：**判分规则版本号**。每次改动计分规则就 +1，服务启动时检测到版本变化自动重算全部历史成绩——学生答案一直保留着，分数只是派生值。老师不用担心"改了规则，上学期成绩全乱了"，也不会出现"新规则只对新提交生效"的双口径。

### 贯穿始终的：测试基建

八天里最值钱的不是某个功能，而是这套测试体系：

- 10 组测试套件（纯逻辑 110 项 / 试卷识别 27 项 / 启动器 81 项 / 启动重启 20 项 / DOM 引用一致性 / 未声明函数静态检查 / 接口端到端 249 项 / 页面断言 120 项 / **真实浏览器无头渲染 84 项** / 局域网可达性 34 项）；
- 没有浏览器自动化环境，就借助系统自带浏览器的无头模式做**真实渲染验证**：加载真实页面、模拟真实点击、断言真实结果；
- 每一轮迭代全量回归一次，八天累计抓出并修复 30+ 个真实缺陷，多数在到达用户手里之前就被拦下。

---

## 四、它现在能做什么

### 教师能做的

- 三种方式出题（手工 / 批量粘贴导入试卷 / 教材文本辅助），六种题型：单选、多选、判断、填空、简答、段落说明；
- 试卷设置：练习/测验模式、限时收卷、答案可见性、教师统一收卷；
- 学生名册管理（分班、批量导入、按班筛选）；
- 数据分析看板：提交进度、按班汇总、逐题正确率、填空逐空正确率、简答人工判分进度，一键导出；
- 卷面详情：点开任意学生逐题查看作答，人工评分滑杆就在题目下方，看着作答判分。

### 学生能做的

- 打开页面自动看到当前开放的测验，学号 + 姓名即可进入，无需注册、无需记码；
- 作答页题号清晰、答题卡可跳转、支持图片题；
- 练习模式交卷后立即看到成绩与逐题解析，填空题逐空标注得分，状态位一目了然（正确 / 部分正确 / 错误 / 待老师判分）；
- 部分得分实时体现——按空给分、加权判分，对几空得几分，不再"错一个字全题归零"。

### 实际效果

系统已在真实教学中连续使用：一个年级 20 多个教学班随堂测验常态化运行，数据文件稳定增长、无一次损坏或丢数据；机房断电重启后双击启动即恢复；历史成绩在判分规则升级后自动重算，无需手工修分。对教师最大的改变是：**随堂小测从"想做但麻烦"变成"想做就做"**——出题五分钟、发卷零成本、讲评时看板直接投屏。

---

## 五、几点可复用的经验

1. **约束催生简洁**。"零依赖"逼出来的 JSON 持久化 + 原生 http 路由，反而让系统在任何机器上都能一键跑起来——场景匹配比技术时髦重要。
2. **单一真相**。题号、满分、判分规则各自只允许一处定义，其余全部引用。这个项目里一半以上的 bug 都源于"两处各自算了一遍"。
3. **派生数据可重算**。只存学生原始作答，分数按当前规则实时推导 + 版本号触发重算。规则怎么改，历史数据都不会坏。
4. **AI 协作的正确姿势**。把 AI 当结对程序员而不是许愿机：每轮明确需求、要求它带测试交付、用真实浏览器验证前端行为；AI 最有价值的时刻不是写代码，而是**测试抓出连人都没意识到的缺陷**（比如"导入试卷会把内联答案泄给学生"）。
5. **服务端改动必须重启**。看似废话，却是本项目踩坑次数最多的一条，最后用"代码指纹自检 + 自动停旧启新"把它工程化掉了。

---

## 六、结语

这套系统不是什么宏大的工程：一个 JSON 文件、几个原生 JS 页面、八天业余时间。但它精确地解决了一个真实场景的问题，并且每一代演进都来自真实课堂的反馈。

工具的价值不在于复杂，而在于明天上课时你真的会打开它。

—— 完 ——

*（文中不包含任何真实试题、学生信息与部署地址；如需交流实现细节，欢迎评论区留言。）*

标签：#workbuddy #Node.js #课堂教学 #全栈开发 #教育信息化

# 我用 WorkBuddy 给课堂做了一套「零依赖」小测系统：从想法到落地的完整迭代记录

人工智能

基于WorkBuddy AI助手结对编程，八天打造纯局域网零依赖课堂小测系统。覆盖20+教学班，支持六种题型、按空给分、关键词加权判分，JSON持久化双击即用，800+断言护航30+缺陷修复。

数据分析

数据库

服务器

WorkBuddy 

Windows

路由

SaaS

JSON

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

# 我用 WorkBuddy 给课堂做了一套「零依赖」小测系统：从想法到落地的完整迭代记录-腾讯云开发者社区-腾讯云

# 我用 WorkBuddy 给课堂做了一套「零依赖」小测系统：从想法到落地的完整迭代记录

# 我用 WorkBuddy 给课堂做了一套「零依赖」小测系统：从想法到落地的完整迭代记录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐