从课程助手示例到自己的教育应用

1. 项目简介

本项目面向具有 Python 基础的学生，提供可运行的教育应用参考案例、操作指南、Agent 协作提示词和个人项目工作区。跟着教程，你将会学习到有关API、提示词、知识库等的实战经验，并最终可以完成一个属于自己的应用开发！

2. 学习目标

运行课程助手示例。 按照指南完成环境与模型配置，运行 LLM 课程助手，体验提问、追问和查看资料来源。
修改并观察效果。 修改课程资料或回答要求，用同一问题复测，比较修改前后的结果，说明发生了什么变化。
借助 Agent 开发自己的应用。 使用 WorkBuddy，按照 Research → Design → Build → Test 四个步骤完成开发：先分析真实教育需求，明确服务对象、问题依据和预期目标；再设计核心功能、页面布局、使用流程及 AI 的作用；然后实现应用，至少接入大模型 API；最后实际测试效果，依据结果迭代优化。

3. 实现路线与操作入口

按下面顺序学习。每一步的具体命令、操作位置和完成检查都在对应指南中。

阶段	你要做什么	操作指南	完成标志
1. 运行参考案例	配置环境和模型，启动并体验 LLM 课程助手	快速启动；环境问题查前置环境配置	能登录、提问并核对来源
2. 修改并观察	改资料或回答要求，用同题比较；可选用 WorkBuddy 改页面与功能	二次开发	留下修改内容、前后结果和自己的判断
3. 自主开发	用 WorkBuddy 完成 Research、Design、Build、Test	自主项目任务与指南；工具操作查Agent 操作指南	有回应真实教育问题的应用、真实 API 调用和一次改进对比
4. 整理与共创	整理代码、运行说明、设计与测试反思，提交 PR	自主项目交付步骤；共创说明	他人能独立运行，材料与实际结果一致

自主项目的四个开发步骤如下：

步骤	关键问题	主要产物
Research：需求研究	谁在什么教学或学习情境下遇到什么问题？依据是什么？希望怎样改善？	`项目设计.md` 中的问题需求分析
Design：方案设计	哪些功能回应需求？页面如何组织、用户如何操作、AI 做什么？	`项目设计.md` 中的方案、页面布局、使用流程与验收标准
Build：应用开发	如何用 WorkBuddy 把方案变成可运行应用并接入大模型 API？	应用代码、依赖、配置和启动说明
Test：测试与迭代	实际使用是否达到目标？哪里不足？修改后是否改善？	测试证据、前后对比及 `测试与反思.md`

4. 参考案例：LLM Learning Assistant

案例是一个基于课程资料回答问题的学习助手，支持知识问答、资料来源展示和多轮追问，采用横屏工作台：左侧切换功能，中间学习问答，右侧核对来源与反馈。登录时可选择学生、教师或助教角色；学生可在“改造实验室”编辑自己的资料副本、更换模型并调整回答要求，保存后同题复测。案例也提供实验提交、人工求助、教师与助教审阅及课程知识库维护。学生先体验问答即可，教学管理功能可选学。

默认知识库是大学大模型课程资料。案例采用 Python 标准库、HTML/JavaScript、SQLite 和本地 Markdown 检索，通过兼容 OpenAI 格式的 API 调用模型，应用自身不要求 GPU。课程模型服务的获取与配置见前置环境配置。

课程助手横屏问答工作台

上图来自新版页面的本地隔离走查，使用测试账号和模拟接口展示交互，不作为真实模型效果的证据。功能、架构、源码入口和更多操作截图见参考案例详解；案例测试与评测见案例验证（可选）；自己的应用按自主项目指南完成 Test 与交付。

自主开发的完整界面案例可参考 Optics Inquiry Lab · 光迹凸透镜探究室：将 PhET 实验、画面内导师、探究任务与笔记组合在同一页面，附效果图和独立快速启动。该案例已通过 Atria-Dawn-Preview 真实问答验证，教学效果仍待课堂实测，具体状态见案例说明。

5. 在哪里操作

前两阶段在仓库根目录运行和修改参考案例；自主项目在 my project/ 独立开发，避免混用代码、账号和运行数据。初始化、测试记录和交付脚本都从仓库根目录执行。首次打包生成 examples/<项目英文名>/ 后，后续共创修订以该目录为准。具体切换步骤见自主项目指南。

llm-learning-assistant/
├── README.md             # 总体介绍与学习路线
├── docs/
│   ├── 00-前置环境配置.md
│   ├── 01-项目实现.md      # 快速启动、参考案例详解与可选验证
│   ├── 02-二次开发.md      # 修改资料、回答要求、页面与功能
│   ├── 03-自主项目任务与指南.md  # Research → Design → Build → Test 与交付
│   ├── 04-Agent操作指南.md # WorkBuddy 连接、自检与协作提示
│   └── images/            # 指南中的截图
├── app/                  # LLM 课程助手参考案例代码
├── knowledge/            # 参考案例默认课程资料
├── tests/                # 参考案例测试、评测与工作流回归
├── my project/           # 自己的应用、设计、提示词和测试反思
├── scripts/              # 自主项目初始化、测试留档与交付工具
├── examples/             # 跨学科参考资料与共创作品
└── outputs/              # 参考案例本地运行数据，不提交 Git

个人工作区的使用方法见 my project/README.md，脚本参数见 scripts/README.md。原始会话、令牌和真实学生记录不进入共创材料。

6. 来源与许可

参考案例代码改编自 Full Link Development of Large Models 的课程应用示例，采用木兰宽松许可证第 2 版。仓库课程资料是可替换的教学示例，四年级声音资料供跨学科选读，不参与默认检索。