forked from opc-2026-shuzhi-w1/track-26
面向融合教育资源教师的个别化课堂适配与家校沟通助手
- Python 100%
| .forgejo/workflows | ||
| cases | ||
| demo | ||
| tests | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| PR_BODY.md | ||
| prototype.py | ||
| README.md | ||
| rongke.py | ||
| SPECS.md | ||
| SUBMISSION.md | ||
| submissions.json | ||
| SUBMISSIONS.md | ||
| W1_SUMMARY.md | ||
| W2_PROTOTYPE.md | ||
| web_demo.py | ||
融课 Copilot
融课 Copilot 是 SynNovator OPC 大赛的本地原型仓库。
当前工作重点已经从 W1 方案说明 进入 W2 原型验证。
这个项目聚焦一个非常具体的课堂问题： 普通学校里的资源教师和班主任，往往已经知道某个学生需要个别化支持，但缺少一种快速、可复用、能落地到当天课堂里的改课工作流。
项目定位
一句话概括： 一个面向融合教育支持教师的 AI Copilot，把“课前适配、课中观察、课后家校沟通”串成一个闭环。
当前边界：
- 仅聚焦教师侧工作流
- 不做医疗或心理诊断
- 不替代教师判断
- 不扩展到学校行政管理
W2 目标
W2 不再只是描述想法，而是要证明核心流程可以端到端跑通。
当前仓库包含两个本地原型入口：
- CLI 原型：把案例 JSON 生成成 Markdown 输出
- 浏览器演示：直接在本地编辑案例并查看生成结果
当前闭环能力：
- 读取学生支持画像、课堂信息和一次观察记录
- 生成短周期支持目标
- 生成课堂适配建议
- 生成结构化观察模板
- 生成家校沟通草稿
- 生成周度总结草稿
- 同步导出可复核的 Markdown 和结果包 JSON
- 支持批量跑多个案例并自动汇总 W2 证据摘要
快速开始
生成 Markdown 产物：
python prototype.py cases/demo_case.json --output artifacts/demo_output.md
同时导出 W2 演示证据包：
python prototype.py cases/demo_case.json --output artifacts/demo_output.md --json-output artifacts/demo_output.json
批量生成多个案例的结果与总报告：
python prototype.py --cases-dir cases --batch-output-dir artifacts/batch
启动本地浏览器演示：
python web_demo.py --port 8000
然后打开 http://127.0.0.1:8000。
测试
python -m unittest discover -s tests -p "test_*.py"
仓库结构
- SPECS.md：W1 完整方案
- W1_SUMMARY.md：W1 简版摘要
- W2_PROTOTYPE.md：W2 范围与验收映射
- rongke.py：共享原型流程逻辑
- prototype.py：CLI 入口
- web_demo.py：本地演示服务
- cases/demo_case.json：示例输入
- cases/math_case.json：第二课堂案例
- demo/index.html：本地中文界面
- tests/test_prototype.py：回归测试
当前本地优先策略
- 先在本地补齐和打磨原型
- 先验证可读性、运行稳定性和演示流程
- 确认无误后再推送到大赛端
这轮新增优化
- 浏览器演示界面统一为中文
- 增加案例必填项校验，减少空跑
- 支持恢复示例、清空输入
- 支持下载 Markdown 和结果 JSON
- CLI 支持直接导出完整结果包 JSON，便于留存 W2 验收证据
- CLI 支持批量运行案例目录并自动生成 W2 摘要报告
- CLI 与本地服务提示语同步改为中文
下一步
- 继续补更多课堂案例
- 对照 W2 评测点补强演示说明
- 本地确认稳定后再推进比赛端同步