一款面向 K12 教师 / 家教 / 辅导机构 的微信小程序:结构化录入课堂信息,一键生成规范、暖心的学生课后反馈,并配套学生库、反馈模板、历史记录管理。基于 微信云开发(云函数 + 云数据库),原生小程序组件化实现,可扩展、可离线降级。
目标用户:每天都在给家长、学生写课后反馈,但希望更省时、更规范、更有温度的教师。 一句话价值:把"凭感觉写反馈"变成"结构化录入,模板化产出,沉淀成资产"。
- 结构化课堂录入:学生姓名、上课日期与时段、学段(小学/初中/高中)、年级、科目,再到教学模块(教材同步 / 专题突破 / 题型集训),可细化到教材版本·章节·知识点、课堂重点、易错点、作业类型,颗粒度足够生成高质量反馈。
- 一键生成规范反馈:四段式输出 —— 1 上课内容 2 课程反馈 3 课后作业 + 老师寄语;根据"掌握情况 / 课堂状态 / 作业情况"等维度自动匹配语气与建议。
- 模板引擎:内置多套反馈模板,支持自定义变量(
{学生姓名}、{学科}、{掌握情况}...),可新建、复制、设默认;生成时按"手动选择 > 教学块默认 > 全局默认"优先级取模板。 - 离线降级 + 云端增强:前端内置本地模板生成器,无网络也能用;开通云开发后由云函数
generateFeedback生成并落库,跨设备可查。 - 学生库:学生名单 + 班级管理 + 个性化标签(基础薄弱 / 思维灵活 / 进步明显...)+ 备注,写反馈时直接选中。
- 历史记录:按学生 / 科目搜索、复制、删除、导出为文本,方便回看与沉淀。
- 设置中心:教师身份、默认语气(温和鼓励 / 客观专业 / 严谨细致 / 亲切口语)、默认长度、自动加学习建议 / 家长沟通话术 / 下节课重点开关、默认称呼,以及数据隐私(留存期、隐藏敏感项)等。
┌────────────────────────────────────────────────────────┐
│ 微信小程序(原生 WXML / WXSS / JS) │
│ ├─ pages/index 首页 · 结构化录入 + 生成反馈 │
│ ├─ pages/templates 反馈模板管理(内置 + 自定义) │
│ ├─ pages/students 学生库(名单 / 班级 / 标签) │
│ ├─ pages/records 历史记录(搜索 / 复制 / 导出) │
│ ├─ pages/settings 设置中心(偏好 / 隐私 / 关于) │
│ ├─ pages/help 帮助页 │
│ ├─ components 自定义组件(result-panel / tag-...) │
│ └─ utils/storage.js 本地存储统一封装 │
└────────────────────────────────────────────────────────┘
│ 本地:wx.setStorageSync(设置/学生/模板/记录)
│ 云端:wx.cloud.callFunction
┌────────────────▼────────────────────────────────────────┐
│ 微信云开发 CloudBase │
│ ├─ 云函数 generateFeedback 生成反馈 + 写入 feedbacks │
│ ├─ 云函数 getFeedbacks 按 openid 隔离分页查询 │
│ └─ 云数据库集合 feedbacks │
└─────────────────────────────────────────────────────────┘
设计取舍:反馈生成采用结构化模板 + 规则匹配(而非在线大模型),保证在无网络、零 API 成本下稳定可用,也让生成的反馈风格可控、可复现。后续可无缝接入 LLM 升级为更个性化的生成。
| 层 | 技术 |
|---|---|
| 前端 | 微信小程序原生(WXML / WXSS / JavaScript),WXS 计算辅助 |
| 后端 | 微信云开发 CloudBase(云函数 + 云数据库),wx-server-sdk |
| 存储 | wx.setStorageSync(本地)+ 云数据库 feedbacks(云端) |
| 视觉 | 竹青 / 薄荷绿主题(主色 #2D7D7B / 深 #14796F / 亮 #4FB8A6) |
| 构建 | 微信开发者工具(project.config.json 已配置 cloudfunctionRoot) |
post-class-feedback-assistant/
├── app.js # 应用入口(默认学段/年级/模块数据)
├── app.json # 页面路由 + tabBar + 全局窗口
├── app.wxss # 全局样式
├── project.config.json # 开发者工具配置(含 cloudfunctionRoot)
├── sitemap.json
├── pages/ # 页面
│ ├── index/ # 首页:结构化录入 + 选择模板 + 生成反馈
│ └── ... # templates / students / records / settings / help
├── components/ # 自定义组件
│ ├── result-panel/ # 反馈结果展示面板
│ └── tag-selector/ # 标签选择器
├── cloudfunctions/ # 云函数
│ ├── generateFeedback/ # 生成反馈并写入集合
│ └── getFeedbacks/ # 查询反馈历史(按用户隔离 + 分页)
├── utils/ # 工具
│ ├── storage.js # 本地存储封装(get/set/remove/genId)
│ └── util.js # 日期格式化 / 去 HTML / 节流
└── images/ # tabBar 图标
- 用 微信开发者工具「导入项目」,选择本目录;
project.config.json中的appid为touristappid(测试号);如已有小程序,替换为你自己的 AppID;- 直接编译运行。默认走本地模板生成器,离线即可体验完整录入与生成流程。
- 开通微信小程序云开发,创建环境;
- 在
app.js的onLaunch中打开wx.cloud.init并填入环境 ID; - 在开发者工具中,对
cloudfunctions/generateFeedback与cloudfunctions/getFeedbacks分别右键「上传并部署:云端安装依赖」(wx-server-sdk依赖会自动安装,无需入库); - 在云数据库创建集合
feedbacks(权限建议"仅创建者可读写")。
云函数内部使用
cloud.DYNAMIC_CURRENT_ENV定位环境,并按openid隔离数据,天然满足"每位老师只看自己的记录"。
录入(学生/科目/模块/表现维度)
│
▼
选取模板(手动 > 教学块默认 > 全局默认 > 内置)
│
▼
生成结构化反馈 1 上课内容 2 课程反馈 3 课后作业 ⭐老师寄语
│
▼
保存:本地记录(records) + 云端(generateFeedback → feedbacks)
- 接入 LLM,结合学生画像生成更个性化的反馈与学习建议;
- 课堂板书拍照 OCR 自动识别内容;
- 反馈一键导出为 PDF / 长图片,方便分享家长群;
- 家长端与教师端打通,反馈直达家长。
说明:为保证学生隐私,仓库内未附带任何包含真实学生信息的演示截图与本地数据。