🎓 零安装 · 零配置 · 像发微信一样录数据 给完全没用过 AI 的班主任老师设计的班务管理工具
一个专为班主任老师设计的 WorkBuddy 技能。帮你在日常教学中：
- 📝 录入成绩：发"张三数学95分"自动入库
- 🏆 记录表现：发"表扬李四主动帮助同学"自动记录
- ⏰ 考勤打卡：发"王五今天迟到15分钟"自动记录
- 🏅 获奖荣誉：发"李四获区级三好学生"自动记录
- 📊 生成报告：一句话生成六板块综合评价
- 🔍 多维查询：按学生/科目/时间自由查
- 📤 数据导出：一键导出 CSV/Excel 备份
在 WorkBuddy 技能管理 → 导入 class-teacher.zip
直接说你要记录的：
张三期中考试数学95分、语文88分
AI 自动建库、建表、解析、确认、存入数据库。
查张三的成绩
生成张三的综合评价报告
| 命令 | 功能 |
|---|---|
班务记 |
快速录入模式 |
班务查 |
查询模式 |
班务报 |
生成报告 |
班务帮 |
显示帮助 |
班务撤 |
撤销最近一条 |
班务出 |
导出数据 |
录入成绩 |
单条成绩录入 |
录表现 |
单条表现录入 |
录考勤 |
单条考勤录入 |
录获奖 |
单条获奖录入 |
直接说大白话也能识别：
- 成绩：
张三数学95 - 表现：
表扬李四主动帮助同学 - 考勤：
王五迟到了 - 获奖：
李四得了区级三好学生
💡 新手建议：先用自然语言，等熟练后再用精准命令。
| 表名 | 存储内容 |
|---|---|
| students | 学生基本档案（学号、姓名、性别、班级、家长） |
| exam_scores | 考试成绩（各科、排名、趋势） |
| daily_records | 日常表现（表扬、批评、行为） |
| attendance | 考勤记录（出勤、迟到、请假、旷课） |
| awards | 获奖荣誉（竞赛、称号） |
- 本地 SQLite：
~/.workbuddy/data/class_teacher.db - 零依赖：Python 标准库，无需安装
- 完全离线：数据不离开你的电脑
- 可选升级：可同步到飞书多维表格（云端协作）
tests/
├── test_db_manager.py # 数据库 CRUD（16 测试）
├── test_parse_input.py # 自然语言解析（19 测试）
├── test_query_helper.py # 查询助手（13 测试）
├── test_generate_report.py # 报告生成（12 测试）
├── test_friendly_errors.py # 友好兜底（7 测试）
└── test_triggers.py # 触发器规范（20 测试）
运行测试：
cd class-teacher
python3 -m pytest tests/class-teacher/
├── SKILL.md # WorkBuddy 主入口
├── README.md # 项目门面（本文件）
├── INSTALL.md # 详细安装指南
├── USAGE.md # 详细使用指南
├── CHANGELOG.md # 版本变更日志
├── LICENSE # MIT 开源协议
├── SECURITY.md # 安全与隐私承诺
├── assets/ # 资源文件
│ ├── schema.sql # 数据库结构
│ ├── table_defs.json # 字段定义（含飞书映射）
│ ├── config.json # 配置
│ └── report_md_template.md
├── scripts/ # Python 脚本
│ ├── db_manager.py # SQLite 数据库管理
│ ├── parse_input.py # 自然语言解析
│ ├── query_helper.py # 查询助手
│ ├── generate_report.py # 报告生成
│ └── export_utils.py # 数据导出
├── references/ # 参考文档
│ ├── sql_reference.md # SQL 查询参考
│ ├── troubleshooting.md # 排错指南
│ └── feishu_cli_guide.md
├── tests/ # 单元测试（pytest）
└── 分享给其他班主任.md # 零技术门槛分享指南
最快方式：
- WorkBuddy → 技能管理 → 导出
class-teacher.zip - 微信发给同事
- 同事 → WorkBuddy → 技能管理 → 导入 zip
- 直接使用，零安装配置！
详细步骤见 分享给其他班主任.md
MIT License — 自由使用、修改、分发
- 在 WorkBuddy 中直接反馈
- 提交 Issue 到 GitHub 仓库
- 联系开发团队
版本：v2.1.0 更新日期：2026-06-24 目标用户：零基础班主任老师 数据存储：本地 SQLite（默认）/ 飞书（可选）