我是学霸 — AI 辅助学习系统

Overview

Deploy and customize the "我是学霸" (I Am a Top Student) learning system. This skill provides the complete project files, teacher prompt rules, and setup guides needed to run a local AI-assisted learning platform for children.

The system includes:
- Browser Dashboard (dashboard.html) — Visual progress tracking, review tasks, topic graphs
- Data API (data_api.py) — Flask backend for data read/write
- AI Teacher Prompts (teachers/*.md) — Subject-specific persona prompts controlling how the AI tutors
- Ebbinghaus Review — Automatic spaced repetition scheduling (1-2-4-7-15-30 days)

When to Use

• Setting up the learning system for the first time
• Adding a new subject/teacher to the system
• Writing or editing AI teacher prompts
• Checking learning progress or review schedules
• Conducting diagnostic assessments
• Customizing teaching rules or subject positioning

Quick Start

To set up the system from the bundled assets:

1. Copy all files from assets/ to a new project directory
2. Create the Windows launcher: run create_launcher.bat (see script below) or manually create 启动看板.bat
3. Install Python dependencies: pip install flask flask-cors
4. Double-click 启动看板.bat (Windows) or run python data_api.py
5. Open browser to http://localhost:5177/
6. Start learning via the dashboard

For detailed setup instructions, load references/setup-guide.md.

File Structure

assets/
├── dashboard.html              # Visual learning dashboard
├── data_api.py                 # Flask API server
├── README.md                   # Project readme
├── 系统搭建指南.md              # Detailed setup guide
├── teachers/
│   ├── math.md                 # Math teacher prompt
│   ├── chinese.md              # Chinese teacher prompt
│   ├── english.md              # English teacher prompt
│   └── science.md              # Science teacher prompt
├── system/
│   ├── teacher-prompt-rules.md # Rules for writing teacher prompts
│   └── teacher-prompt-template.md # Blank template for new subjects
├── records/                    # Learning records (per subject)
│   ├── math/
│   ├── chinese/
│   ├── english/
│   └── science/
└── review/                     # Review scheduling data
    ├── next-review.json
    ├── errors-review.json
    └── schedule.md

> Note: 启动看板.bat (Windows one-click launcher) is not bundled because some platforms block .bat uploads. Create it during initialization using the script below.

Initialization Script

When helping a user initialize the project, create the Windows launcher 启动看板.bat in the project folder with this content:

@echo off
chcp 65001 >nul
cd /d "%~dp0"
start "" "http://localhost:5177/"
python data_api.py
pause

For Mac/Linux users, create a shell script start.sh instead:

#!/bin/bash
cd "$(dirname "$0")"
python data_api.py &
sleep 2
open "http://localhost:5177/"

Adding a New Subject

To add a new subject (e.g., history, art):

1. Load assets/system/teacher-prompt-rules.md for the full specification
2. Copy assets/system/teacher-prompt-template.md as the starting point
3. Fill in all 9 required modules following the rules
4. Save as assets/teachers/<subject>.md
5. Create assets/records/<subject>/ directory with mastered.md and errors.md
6. Register the subject in dashboard.html

Subject Positioning Types

Each subject must choose one positioning type:

Global Constraints

All teacher prompts must respect these prohibitions:

Resources

references/setup-guide.md

Complete installation and usage guide. Load this when helping a user set up the system for the first time.

assets/system/teacher-prompt-rules.md

The rule specification for writing teacher prompts. Load this when the user wants to add or edit a subject's teacher prompt.

assets/system/teacher-prompt-template.md

A blank template with placeholders for each of the 9 required modules. Copy this to create a new teacher prompt.

assets/teachers/*.md

Existing teacher prompts (math, chinese, english, science) that serve as examples.