Add teacher-managed classroom rosters

README.md

@@ -20,10 +20,11 @@ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-
 
 課程與名單管理：
 
-- 學生先選現有課程，再從該課程名單選名字；新生可自行輸入新名字加入。
+- 教師先在控制台建立班級與學生名單，可用逗號一次加入多人。
+- 學生選班級後自行輸入姓名；只有與後台名單相符才能進入，學生頁不會顯示全班名單。
 - 教師可選現有課程，也可用教師密碼建立新課程代碼。新課程會寫回此 Space，因此建立時會觸發一次重新建置。
 - 教師可從課程刪除學生及其教室內進度；已經發布到首頁 Demo 的作品不會連帶刪除。
-- 學生名單與尚未發布的草稿保存在 Space 執行期間；每週正式提交發布後才會成為此 repository 內的長期作品。
+- 班級與學生名單會寫回 Space repository 長期保存；尚未發布的草稿仍保存在 Space 執行期間。
 - 學生端 Python 會逐段顯示輸出；程式執行到 `input()` 時，Console 才出現輸入列並等待送出。
 - 內容管理後台可修改 18 週課程資料與每週套版，也可新增、改名、編輯或刪除公開 Demo 專題。所有儲存都會寫回此 Space。
 

classroom_data/classes.json

@@ -1,14 +1,17 @@
 [
   {
     "code": "L6A",
-    "name": "2026 Fall 進階專題"
+    "name": "2026 Fall 進階專題",
+    "students": []
   },
   {
     "code": "L6Sat",
-    "name": "L6Sat"
+    "name": "L6Sat",
+    "students": []
   },
   {
     "code": "dsad",
-    "name": "dasdasda"
+    "name": "dasdasda",
+    "students": []
   }
 ]

classroom_service.py

@@ -11,10 +11,12 @@ ROOT=Path(__file__).resolve().parent; STATIC=ROOT/"classroom_static"; DATA=ROOT/
 RUNTIME=Path(os.getenv("CLASSROOM_DATA_DIR","/tmp/telearn_classroom")); DB=RUNTIME/"classroom.sqlite3"
 PASSWORD=os.getenv("CLASSROOM_TEACHER_PASSWORD",""); REPO=os.getenv("CLASSROOM_DEMO_REPO",os.getenv("SPACE_ID","Telearn/Project_Demo")).strip(); DEMO_CLASS=os.getenv("CLASSROOM_DEMO_CLASS","2026Fall進階專題"); TOKEN=os.getenv("HF_TOKEN","").strip()
 ALLOWED={".py",".json",".txt",".csv",".md",".toml",".yaml",".yml"}; ID_RE=re.compile(r"[^0-9A-Za-z_\-一-鿿]")
-router=APIRouter(); lock=threading.Lock(); students={}; teachers={}; live={}; logger=logging.getLogger(__name__)
+router=APIRouter(); lock=threading.Lock(); persist_lock=threading.Lock(); students={}; teachers={}; live={}; logger=logging.getLogger(__name__)
 
 class TeacherRequest(BaseModel): class_code:str; week_id:str; password:str
 class CourseCreate(BaseModel): class_code:str; course_name:str=""; password:str
+class StudentCreate(BaseModel): class_code:str; display_names:list[str]; password:str
+class StudentLogin(BaseModel): class_code:str; display_name:str
 class StudentDelete(BaseModel): class_code:str; student_id:str; password:str
 def clean(v,fallback="item",limit=48): return ID_RE.sub("",str(v).strip())[:limit] or fallback
 def clean_label(v,fallback="",limit=80): return re.sub(r"[\x00-\x1f\x7f]", "", str(v).strip())[:limit] or fallback
@@ -38,6 +40,10 @@ def init_db():
         for item in json.loads((DATA/"classes.json").read_text(encoding="utf-8")):
             code=clean(item.get("code"),"L6A")
             c.execute("""INSERT INTO classroom_courses VALUES(?,?,?) ON CONFLICT(class_code) DO UPDATE SET course_name=excluded.course_name""",(code,clean_label(item.get("name"),code),now()))
+            for student in item.get("students",[]):
+                name=clean_label(student.get("display_name") or student.get("name"),"")
+                student_id=clean(student.get("student_id") or name,"")
+                if name and student_id:c.execute("INSERT OR IGNORE INTO classroom_members VALUES(?,?,?,?)",(code,student_id,name,now()))
 def empty(c,s,n,w): return {"class_code":c,"student_id":s,"display_name":n,"week_id":w,"project_name":"Python專案","files":{"main.py":"# 在這裡寫 Python\n"},"final_files":None,"active_file":"main.py","output":"","status":"idle","needs_help":False,"updated_at":now(),"submitted_at":None,"connected":True}
 def from_row(r,connected=False): return {"class_code":r[0],"student_id":r[1],"display_name":r[2],"week_id":r[3],"project_name":r[4],"files":json.loads(r[5]),"final_files":json.loads(r[6]) if r[6] else None,"active_file":r[7],"output":r[8],"status":r[9],"needs_help":bool(r[10]),"updated_at":r[11],"submitted_at":r[12],"connected":connected}
 SELECT="SELECT class_code,student_id,display_name,week_id,project_name,draft_files,final_files,active_file,output,status,needs_help,updated_at,submitted_at FROM classroom_projects"
@@ -57,6 +63,14 @@ def catalog():
     by_class={code:[] for code,_ in courses}
     for code,student_id,name in members:by_class.setdefault(code,[]).append({"student_id":student_id,"display_name":name})
     return {"courses":[{"class_code":code,"course_name":name,"students":by_class.get(code,[])} for code,name in courses]}
+def public_catalog():return {"courses":[{"class_code":x["class_code"],"course_name":x["course_name"]} for x in catalog()["courses"]]}
+def find_member(class_code,display_name="",student_id=""):
+    with lock,sqlite3.connect(DB) as db:rows=db.execute("SELECT student_id,display_name FROM classroom_members WHERE class_code=?",(class_code,)).fetchall()
+    wanted=clean_label(display_name,"").casefold()
+    for member_id,name in rows:
+        if student_id and member_id==student_id and (not wanted or name.casefold()==wanted):return {"student_id":member_id,"display_name":name}
+        if not student_id and wanted and name.casefold()==wanted:return {"student_id":member_id,"display_name":name}
+    return None
 def snapshot(c,w):
     with lock,sqlite3.connect(DB) as db:rows=db.execute(SELECT+" WHERE class_code=? AND week_id=?",(c,w)).fetchall()
     found={r[1]:from_row(r) for r in rows}
@@ -97,6 +111,18 @@ def hf_failure_message(exc):
     else:reason=f"連線到 Hugging Face 時發生 {type(exc).__name__}"
     suffix=f"HTTP {status}：{detail}" if status else detail
     return f"課程已可使用，但尚未永久寫入 Space。{reason}。詳情：{suffix}"
+def persist_catalog(message):
+    if not TOKEN:return "名單已可使用，但尚未永久寫入 Space；請設定 HF_TOKEN。"
+    try:
+        from huggingface_hub import CommitOperationAdd,HfApi
+        payload=[]
+        for course in catalog()["courses"]:payload.append({"code":course["class_code"],"name":course["course_name"],"students":course["students"]})
+        content=(json.dumps(payload,ensure_ascii=False,indent=2)+"\n").encode()
+        with persist_lock:HfApi(token=TOKEN).create_commit(repo_id=REPO,repo_type="space",operations=[CommitOperationAdd(path_in_repo="classroom_data/classes.json",path_or_fileobj=content)],commit_message=message)
+        return ""
+    except Exception as exc:
+        logger.exception("Could not persist classroom roster to %s",REPO)
+        return hf_failure_message(exc)
 def finals(c,w):return [x for x in snapshot(c,w) if x.get("final_files")]
 def make_zip(c,w):
     b=io.BytesIO()
@@ -113,7 +139,12 @@ def teacher_page():return FileResponse(STATIC/"teacher.html")
 @router.get("/api/classroom/course")
 def course():return JSONResponse(json.loads((DATA/"course.json").read_text(encoding="utf-8")))
 @router.get("/api/classroom/classes")
-def classes():return catalog()
+def classes():return public_catalog()
+@router.post("/api/classroom/student-login")
+def student_login(req:StudentLogin):
+    member=find_member(clean(req.class_code,""),clean_label(req.display_name,""))
+    if not member:raise HTTPException(403,"姓名不在這個班級的名單中，請確認輸入或請老師新增名單。")
+    return member
 @router.post("/api/classroom/classes")
 def create_class(req:CourseCreate):
     check_password(req.password); code=clean(req.class_code,""); name=clean_label(req.course_name,code)
@@ -122,18 +153,25 @@ def create_class(req:CourseCreate):
         existing=db.execute("SELECT course_name FROM classroom_courses WHERE class_code=?",(code,)).fetchone()
         if existing:name=existing[0]
         else:db.execute("INSERT INTO classroom_courses VALUES(?,?,?)",(code,name,now()))
-        rows=db.execute("SELECT class_code,course_name FROM classroom_courses ORDER BY course_name,class_code").fetchall()
-    warning=""
-    if TOKEN:
-        try:
-            from huggingface_hub import CommitOperationAdd,HfApi
-            payload=json.dumps([{"code":c,"name":n} for c,n in rows],ensure_ascii=False,indent=2)+"\n"
-            HfApi(token=TOKEN).create_commit(repo_id=REPO,repo_type="space",operations=[CommitOperationAdd(path_in_repo="classroom_data/classes.json",path_or_fileobj=payload.encode())],commit_message=f"Add classroom course {code}")
-        except Exception as exc:
-            logger.exception("Could not persist classroom course catalog to %s",REPO)
-            warning=hf_failure_message(exc)
-    else:warning="課程已可使用，但尚未永久寫入 Space；請設定 HF_TOKEN。"
+    warning=persist_catalog(f"Add classroom course {code}")
     return {"ok":True,"class_code":code,"course_name":name,"already_exists":bool(existing),"warning":warning}
+@router.post("/api/classroom/students")
+async def create_students(req:StudentCreate):
+    check_password(req.password); code=clean(req.class_code,"")
+    with lock,sqlite3.connect(DB) as db:
+        if not db.execute("SELECT 1 FROM classroom_courses WHERE class_code=?",(code,)).fetchone():raise HTTPException(404,"找不到這個班級")
+        existing=db.execute("SELECT student_id,display_name FROM classroom_members WHERE class_code=?",(code,)).fetchall();used={row[0] for row in existing};names={row[1].casefold() for row in existing};created=[]
+        for raw_name in req.display_names[:40]:
+            name=clean_label(raw_name,"")
+            if not name or name.casefold() in names:continue
+            base=clean(name,"student");student_id=base;number=2
+            while student_id in used:student_id=f"{base[:42]}-{number}";number+=1
+            db.execute("INSERT INTO classroom_members VALUES(?,?,?,?)",(code,student_id,name,now()));used.add(student_id);names.add(name.casefold());created.append({"student_id":student_id,"display_name":name})
+    if not created:raise HTTPException(400,"請輸入尚未在名單中的學生姓名")
+    warning=persist_catalog(f"Add {len(created)} classroom students to {code}")
+    for class_code,week_id in list(teachers):
+        if class_code==code:await broadcast(code,week_id)
+    return {"ok":True,"created":created,"warning":warning}
 @router.delete("/api/classroom/students")
 async def delete_student(req:StudentDelete):
     check_password(req.password); code=clean(req.class_code,"L6A"); student_id=clean(req.student_id,"student")
@@ -145,9 +183,10 @@ async def delete_student(req:StudentDelete):
     with lock,sqlite3.connect(DB) as db:
         db.execute("DELETE FROM classroom_projects WHERE class_code=? AND student_id=?",(code,student_id))
         db.execute("DELETE FROM classroom_members WHERE class_code=? AND student_id=?",(code,student_id))
+    warning=persist_catalog(f"Remove classroom student {student_id} from {code}")
     for class_code,week_id in list(teachers):
         if class_code==code:await broadcast(code,week_id)
-    return {"ok":True}
+    return {"ok":True,"warning":warning}
 @router.get("/api/classroom/template/{week_id}")
 def template(week_id):return {"week_id":week_id,"files":template_files(week_id)}
 @router.get("/api/classroom/progress")
@@ -180,7 +219,10 @@ def publish(req:TeacherRequest):
 
 @router.websocket("/ws/classroom/student")
 async def student_ws(ws:WebSocket):
-    c=clean(ws.query_params.get("class_code"),"L6A");s=clean(ws.query_params.get("student_id"),"student");n=clean(ws.query_params.get("display_name"),s);w=clean(ws.query_params.get("week_id"),"week02");key=(c,s,w);await ws.accept()
+    c=clean(ws.query_params.get("class_code"),"L6A");s=clean(ws.query_params.get("student_id"),"student");requested_name=clean_label(ws.query_params.get("display_name"),"");w=clean(ws.query_params.get("week_id"),"week02");await ws.accept()
+    member=find_member(c,requested_name,s)
+    if not member:await ws.close(code=4404,reason="not on roster");return
+    n=member["display_name"];key=(c,s,w)
     old=students.get(key)
     if old and old is not ws:
         try:await old.close(code=4001)

classroom_static/classroom.css

@@ -280,8 +280,11 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
 .form-error { min-height: 1.25rem; margin: 0; color: var(--danger); font-size: .875rem; }
 
 .teacher-layout { min-height:0;flex:1;overflow:hidden;display:grid;grid-template-columns:minmax(360px,43%) minmax(480px,57%); }
-.roster-panel { min-height:0;display:grid;grid-template-rows:52px auto 42px minmax(0,1fr);overflow:hidden;border-right:1px solid var(--line);background:var(--surface); }
+.roster-panel { min-height:0;display:grid;grid-template-rows:52px auto auto 42px minmax(0,1fr);overflow:hidden;border-right:1px solid var(--line);background:var(--surface); }
 .teacher-detail { min-width:0;min-height:0;overflow:hidden;background:var(--shell); }
+.roster-add { display:flex;gap:var(--space-sm);padding:var(--space-md) var(--space-lg);border-bottom:1px solid var(--line);background:var(--surface-subtle); }
+.roster-add .text-field { min-width:0;min-height:36px; }
+.roster-add .btn { flex:none; }
 .filter-bar { display: flex; gap: var(--space-sm); padding: var(--space-md) var(--space-lg); border-bottom: 1px solid var(--line); overflow-x: auto; }
 .roster-list { min-height:0;overflow:auto; }
 .roster-header, .student-row {
@@ -347,6 +350,7 @@ dialog::backdrop { background: oklch(0.16 0.04 255 / .72); }
   .roster-header, .student-row { grid-template-columns: minmax(120px, 1fr) 90px 70px; }
   .roster-header > :nth-child(3), .student-row > :nth-child(3) { display: none; }
   .detail-header { padding-inline: var(--space-lg); }
+  .roster-add { padding-inline:var(--space-md); }
 }
 
 @media (prefers-reduced-motion: reduce) {

classroom_static/student.html

@@ -1,10 +1,10 @@
-<!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light"><title>Python 專案教室｜學生工作區</title><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.css"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/theme/material-darker.min.css"><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-4"></head><body>
+<!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light"><title>Python 專案教室｜學生工作區</title><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.css"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/theme/material-darker.min.css"><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-5"></head><body>
 <header class="app-header"><div class="brand"><div class="brand-mark">Py</div><div class="brand-copy"><strong>Python 專案教室</strong><span id="studentIdentity">尚未進入教室</span></div></div><div class="header-actions"><div class="connection-state"><i class="status-dot" id="connectionDot"></i><span id="connectionText">未連線</span></div><button class="btn help compact" id="helpButton">請老師協助</button><button class="btn secondary compact" id="identityButton">更換身分</button></div></header>
 <section class="project-bar"><div class="project-context"><label for="weekSelect">週次</label><select id="weekSelect"></select><label for="projectName">專案</label><input id="projectName" maxlength="36" value="Python專案"></div><div class="project-actions"><button class="copy-button" id="templateButton">匯入本週套版</button><button class="copy-button" id="progressButton">選擇舊進度</button><button class="copy-button" id="importButton">匯入 .py / ZIP</button><button class="copy-button" id="exportButton">匯出專案</button><button class="btn compact" id="submitButton">提交本週版本</button><input id="fileImport" type="file" accept=".py,.zip" hidden></div></section>
 <nav class="mobile-tabs" role="tablist"><button class="mobile-tab" data-panel="referencePanel">專案／語法</button><button class="mobile-tab" data-panel="editorPanel" aria-selected="true">程式</button><button class="mobile-tab" data-panel="consolePanel">執行結果</button></nav>
 <main class="student-layout"><aside class="panel reference-panel" id="referencePanel"><div class="side-tabs"><button class="side-tab active" data-side="filesView">專案檔案</button><button class="side-tab" data-side="syntaxView">語法查詢</button></div><section class="side-view" id="filesView"><div class="panel-heading"><h1>檔案夾</h1><button class="copy-button" id="newFileButton">+新增</button></div><div class="file-list" id="fileList"></div><p class="side-note">入口固定為 <code>main.py</code>，可用 <code>import</code> 引入其他 Python 檔。</p></section><section class="side-view" id="syntaxView" hidden><div class="panel-heading"><h1>Python 語法查詢</h1><span id="snippetCount">0 項</span></div><div class="search-wrap"><label class="field-label" for="syntaxSearch">輸入語法或用途</label><input class="text-field" id="syntaxSearch" type="search" placeholder="迴圈、字典、JSON"><div class="chip-row" id="categoryFilters"></div></div><div class="snippet-list" id="snippetList"></div></section></aside>
 <section class="panel editor-panel mobile-active" id="editorPanel"><div class="panel-heading dark"><span class="file-name" id="activeFileLabel">main.py</span><div class="editor-toolbar"><button class="btn stop compact" id="stopButton" disabled>停止</button><button class="btn compact" id="runButton" disabled>載入 Python…</button></div></div><div class="editor-host"><textarea id="codeEditor" aria-label="程式碼"></textarea></div></section>
 <aside class="panel console-panel" id="consolePanel"><div class="panel-heading"><h2>互動式 Console</h2><button class="copy-button" id="clearOutputButton">清除</button></div><div class="console-body"><div class="console-stream"><pre class="console-output" id="consoleOutput">Python 執行環境載入中…</pre><form class="console-input-row" id="consoleInputForm" hidden><span aria-hidden="true">›</span><label class="sr-only" for="consoleInput">Python 程式要求輸入</label><input id="consoleInput" autocomplete="off" placeholder="輸入後按 Enter"><button class="btn compact" type="submit">送出</button></form></div><p class="console-hint">執行 <code>main.py</code>；遇到 <code>input()</code> 時會在這裡詢問。</p><div class="console-status"><i class="status-dot" id="runStatusDot"></i><span id="runStatusText">準備環境</span><span>·</span><span id="saveStatus">尚未同步</span><span>·</span><span id="submitStatus">本週尚未提交</span></div></div></aside></main>
-<dialog id="identityDialog"><form class="dialog-content form-stack" id="identityForm"><div><h1>進入程式教室</h1><p>先選課程，再選自己的名字。名單上沒有時可新增。</p></div><div><label class="field-label" for="classCode">課程</label><select class="text-field" id="classCode" required></select></div><div><label class="field-label" for="studentChoice">學生</label><select class="text-field" id="studentChoice" required></select></div><div id="newStudentFields" hidden><label class="field-label" for="displayName">新學生名稱</label><input class="text-field" id="displayName" placeholder="12_Alex"><p class="field-help">建議使用座號與英文名，方便老師辨識。</p></div><p class="form-error" id="identityError"></p><button class="btn" type="submit">進入教室</button></form></dialog>
+<dialog id="identityDialog"><form class="dialog-content form-stack" id="identityForm"><div><h1>進入程式教室</h1><p>選擇班級並輸入自己在名單上的姓名。</p></div><div><label class="field-label" for="classCode">課程</label><select class="text-field" id="classCode" required></select></div><div><label class="field-label" for="displayName">姓名</label><input class="text-field" id="displayName" autocomplete="name" placeholder="請輸入名單上的姓名" required><p class="field-help">姓名必須與老師建立的名單一致。</p></div><p class="form-error" id="identityError" role="alert"></p><button class="btn" type="submit">進入教室</button></form></dialog>
 <dialog id="progressDialog"><div class="dialog-content"><h2>選擇正式進度</h2><p>匯入後會成為目前週次的工作副本。</p><div class="progress-list" id="progressList"></div><button class="btn secondary dialog-close">關閉</button></div></dialog><div class="toast" id="toast"></div>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/mode/python/python.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js"></script><script src="/classroom-assets/student.js?v=2026fall-4"></script></body></html>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/codemirror.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.65.16/mode/python/python.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.10.1/jszip.min.js"></script><script src="/classroom-assets/student.js?v=2026fall-5"></script></body></html>

classroom_static/student.js

@@ -1,7 +1,7 @@
 const SNIPPETS=[["基礎","輸入與輸出",'name = input("名字：")\nprint("你好", name)'],["判斷","if / elif / else",'if score >= 90:\n    print("A")\nelse:\n    print("繼續加油")'],["迴圈","for 與 range",'for number in range(1, 6):\n    print(number)'],["迴圈","while",'while True:\n    choice = input("選擇：")\n    if choice == "q":\n        break'],["資料","list",'items = []\nitems.append("線索")\nfor item in items:\n    print(item)'],["資料","dict",'student = {"name": "Alex"}\nprint(student.get("team", "未分組"))'],["函式","def / return",'def add(a, b):\n    return a + b'],["檔案","引入自己的模組",'from clues import find_clue'],["檔案","讀取 JSON",'import json\nwith open("data.json", encoding="utf-8") as file:\n    data = json.load(file)'],["錯誤","try / except",'try:\n    age = int(input("年齡："))\nexcept ValueError:\n    print("請輸入整數")']].map(([category,title,code])=>({category,title,code}));
-const $=id=>document.getElementById(id),E={};["identityDialog","identityForm","identityError","classCode","studentChoice","newStudentFields","displayName","studentIdentity","identityButton","connectionDot","connectionText","helpButton","weekSelect","projectName","templateButton","progressButton","importButton","exportButton","submitButton","fileImport","fileList","newFileButton","activeFileLabel","syntaxSearch","categoryFilters","snippetList","snippetCount","runButton","stopButton","consoleInputForm","consoleInput","consoleOutput","clearOutputButton","runStatusDot","runStatusText","saveStatus","submitStatus","toast","progressDialog","progressList"].forEach(id=>E[id]=$(id));
+const $=id=>document.getElementById(id),E={};["identityDialog","identityForm","identityError","classCode","displayName","studentIdentity","identityButton","connectionDot","connectionText","helpButton","weekSelect","projectName","templateButton","progressButton","importButton","exportButton","submitButton","fileImport","fileList","newFileButton","activeFileLabel","syntaxSearch","categoryFilters","snippetList","snippetCount","runButton","stopButton","consoleInputForm","consoleInput","consoleOutput","clearOutputButton","runStatusDot","runStatusText","saveStatus","submitStatus","toast","progressDialog","progressList"].forEach(id=>E[id]=$(id));
 const editor=CodeMirror.fromTextArea($("codeEditor"),{mode:"python",theme:"material-darker",lineNumbers:true,indentUnit:4,tabSize:4,extraKeys:{Tab:cm=>cm.replaceSelection("    ")}});
-let studentId=localStorage.getItem("classroom_student_id")||crypto.randomUUID(),catalog={courses:[]};localStorage.setItem("classroom_student_id",studentId);
+let studentId=localStorage.getItem("classroom_student_id")||"",catalog={courses:[]};
 let course,files={"main.py":"# 在這裡寫 Python\n"},activeFile="main.py",socket,worker,workerReady=false,running=false,needsHelp=false,submittedAt=null,output="",suppress=false,timer,reconnect,category="全部",inputBuffer,inputControl,inputBytes,stdoutDecoder=new TextDecoder(),stderrDecoder=new TextDecoder();
 const clean=v=>String(v||"").trim().replace(/[^0-9A-Za-z_\-一-鿿]/g,"").slice(0,48),week=()=>E.weekSelect.value||"week02",key=()=>`classroom_project_${localStorage.getItem("classroom_code")}_${week()}`;
 function toast(t){E.toast.textContent=t;E.toast.classList.add("visible");setTimeout(()=>E.toast.classList.remove("visible"),1900)}
@@ -12,16 +12,14 @@ function sync(){saveLocal();E.saveStatus.textContent="同步中";clearTimeout(ti
 function openFile(path){if(!(path in files))return;if(activeFile in files&&!suppress)files[activeFile]=editor.getValue();activeFile=path;suppress=true;editor.setValue(files[path]);suppress=false;E.activeFileLabel.textContent=path;editor.setOption("mode",path.endsWith(".py")?"python":"text");renderFiles()}
 function setProject(next,name,preferred="main.py"){files=Object.fromEntries(Object.entries(next||{}).filter(([p,v])=>typeof v==="string"&&!p.includes("..")));files["main.py"]??="# 專案入口\n";E.projectName.value=name||"Python專案";const firstFile=files[preferred]?preferred:"main.py";activeFile="";openFile(firstFile);sync()}
 function renderFiles(){E.fileList.innerHTML=Object.keys(files).sort((a,b)=>a==="main.py"?-1:b==="main.py"?1:a.localeCompare(b)).map(p=>`<div class="file-row ${p===activeFile?"selected":""}"><button data-open="${esc(p)}">◇ ${esc(p)}</button>${p!=="main.py"?`<button class="file-remove" data-remove="${esc(p)}">×</button>`:""}</div>`).join("");E.fileList.querySelectorAll("[data-open]").forEach(b=>b.onclick=()=>openFile(b.dataset.open));E.fileList.querySelectorAll("[data-remove]").forEach(b=>b.onclick=()=>{if(confirm(`刪除 ${b.dataset.remove}？`)){delete files[b.dataset.remove];if(activeFile===b.dataset.remove)activeFile="main.py";openFile(activeFile);sync()}})}
-function connect(){clearTimeout(reconnect);const previous=socket;if(previous){previous.onclose=null;previous.close()}const c=clean(localStorage.getItem("classroom_code")),n=clean(localStorage.getItem("classroom_name"));if(!c||!n){E.identityDialog.showModal();return}E.studentIdentity.textContent=`${c} · ${n}`;E.connectionText.textContent="連線中";const scheme=location.protocol==="https:"?"wss":"ws",q=new URLSearchParams({class_code:c,student_id:studentId,display_name:n,week_id:week()}),current=new WebSocket(`${scheme}://${location.host}/ws/classroom/student?${q}`);socket=current;current.onopen=()=>{E.connectionDot.className="status-dot online";E.connectionText.textContent="已連線"};current.onmessage=e=>{const m=JSON.parse(e.data);if(m.type==="restore"){const local=JSON.parse(localStorage.getItem(key())||"null"),s=m.state,src=local||{files:s.files,activeFile:s.active_file,projectName:s.project_name,output:s.output};output=src.output||"";E.consoleOutput.textContent=output||"尚無執行結果。";submittedAt=s.submitted_at;needsHelp=!!s.needs_help;renderState();setProject(src.files,src.projectName,src.activeFile);send({type:"output",output})}if(m.type==="help_ack"){needsHelp=false;renderState();toast("老師已看到你的協助請求")}if(["ack","pong"].includes(m.type)){if(typeof m.needs_help==="boolean"){const seen=needsHelp&&!m.needs_help;needsHelp=m.needs_help;if(seen)toast("老師已看到你的協助請求")}if(m.submitted_at)submittedAt=m.submitted_at;renderState();if(m.type==="ack")E.saveStatus.textContent="已同步"}};current.onclose=async e=>{if(socket!==current)return;E.connectionDot.className="status-dot error";E.connectionText.textContent="已離線";E.saveStatus.textContent="保存在此裝置";if(e.code===4004){localStorage.removeItem("classroom_student_id");localStorage.removeItem("classroom_name");studentId=crypto.randomUUID();localStorage.setItem("classroom_student_id",studentId);await loadCatalog();toast("老師已將這個學生從名單移除");E.identityDialog.showModal();return}reconnect=setTimeout(connect,2500)}}
+function connect(){clearTimeout(reconnect);const previous=socket;if(previous){previous.onclose=null;previous.close()}const c=clean(localStorage.getItem("classroom_code")),n=localStorage.getItem("classroom_name")?.trim();if(!c||!n||!studentId){E.identityDialog.showModal();return}E.studentIdentity.textContent=`${c} · ${n}`;E.connectionText.textContent="連線中";const scheme=location.protocol==="https:"?"wss":"ws",q=new URLSearchParams({class_code:c,student_id:studentId,display_name:n,week_id:week()}),current=new WebSocket(`${scheme}://${location.host}/ws/classroom/student?${q}`);socket=current;current.onopen=()=>{E.connectionDot.className="status-dot online";E.connectionText.textContent="已連線"};current.onmessage=e=>{const m=JSON.parse(e.data);if(m.type==="restore"){const local=JSON.parse(localStorage.getItem(key())||"null"),s=m.state,src=local||{files:s.files,activeFile:s.active_file,projectName:s.project_name,output:s.output};output=src.output||"";E.consoleOutput.textContent=output||"尚無執行結果。";submittedAt=s.submitted_at;needsHelp=!!s.needs_help;renderState();setProject(src.files,src.projectName,src.activeFile);send({type:"output",output})}if(m.type==="help_ack"){needsHelp=false;renderState();toast("老師已看到你的協助請求")}if(["ack","pong"].includes(m.type)){if(typeof m.needs_help==="boolean"){const seen=needsHelp&&!m.needs_help;needsHelp=m.needs_help;if(seen)toast("老師已看到你的協助請求")}if(m.submitted_at)submittedAt=m.submitted_at;renderState();if(m.type==="ack")E.saveStatus.textContent="已同步"}};current.onclose=async e=>{if(socket!==current)return;E.connectionDot.className="status-dot error";E.connectionText.textContent="已離線";E.saveStatus.textContent="保存在此裝置";if(e.code===4004||e.code===4404){localStorage.removeItem("classroom_student_id");localStorage.removeItem("classroom_name");studentId="";await loadCatalog();E.identityError.textContent=e.code===4004?"老師已將你從名單移除。":"姓名與班級名單不符，請重新輸入。";E.identityDialog.showModal();return}reconnect=setTimeout(connect,2500)}}
 function renderState(){E.helpButton.classList.toggle("active",needsHelp);E.helpButton.textContent=needsHelp?"取消請求協助":"請老師協助";E.submitStatus.textContent=submittedAt?`已提交 ${new Date(submittedAt).toLocaleTimeString("zh-TW",{hour:"2-digit",minute:"2-digit"})}`:"本週尚未提交"}
 function initWorker(){worker?.terminate();workerReady=false;running=false;E.consoleInputForm.hidden=true;E.runButton.disabled=true;E.runButton.textContent="載入 Python…";if(!crossOriginIsolated||typeof SharedArrayBuffer==="undefined"){append("瀏覽器未啟用互動式 Python。請重新整理，並使用最新版 Chrome、Edge 或 Safari。\n");runState("error","環境不支援");return}inputBuffer=new SharedArrayBuffer(16392);inputControl=new Int32Array(inputBuffer,0,2);inputBytes=new Uint8Array(inputBuffer,8);worker=new Worker("/classroom-assets/py-worker.js?v=2026fall-4");worker.onmessage=e=>{const m=e.data;if(m.type==="ready"){workerReady=true;E.runButton.disabled=false;E.runButton.textContent="執行";runState("online","準備完成")}else if(m.type==="stream"){const decoder=m.channel==="stderr"?stderrDecoder:stdoutDecoder;append(decoder.decode(m.bytes,{stream:true}))}else if(m.type==="input_request"){E.consoleInputForm.hidden=false;E.consoleInput.value="";E.runStatusText.textContent="等待輸入";E.consoleInput.focus()}else if(m.type==="done"){E.consoleInputForm.hidden=true;runState("success","執行成功")}else if(m.type==="python_error"){E.consoleInputForm.hidden=true;if(m.text)append(`${m.text}\n`);runState("error","程式錯誤")}else if(m.type==="load_error"){append(`Python 載入失敗：${m.text}\n`);runState("error","載入失敗")}};worker.onerror=e=>{append(`Python 執行器錯誤：${e.message}\n`);runState("error","執行器錯誤")}}
 function runState(s,t){running=s==="running";E.runStatusDot.className=`status-dot ${s}`;E.runStatusText.textContent=t;E.runButton.disabled=!workerReady||running;E.stopButton.disabled=!running;send({type:"status",status:s==="online"?"idle":s})}
 function append(t){output=(output+t).slice(-40000);E.consoleOutput.textContent=output;E.consoleOutput.scrollTop=E.consoleOutput.scrollHeight;saveLocal();send({type:"output",output})}
 function renderSyntax(){const cats=["全部",...new Set(SNIPPETS.map(s=>s.category))];E.categoryFilters.innerHTML=cats.map(c=>`<button class="chip" data-cat="${c}" aria-pressed="${c===category}">${c}</button>`).join("");E.categoryFilters.querySelectorAll("button").forEach(b=>b.onclick=()=>{category=b.dataset.cat;renderSyntax()});const q=E.syntaxSearch.value.toLowerCase(),list=SNIPPETS.filter(s=>(category==="全部"||s.category===category)&&(`${s.title} ${s.code}`.toLowerCase().includes(q)));E.snippetCount.textContent=`${list.length} 項`;E.snippetList.innerHTML=list.map(s=>`<article class="snippet-item"><div class="snippet-title"><strong>${s.title}</strong><span>${s.category}</span></div><pre>${esc(s.code)}</pre><button class="copy-button" data-copy="${SNIPPETS.indexOf(s)}">複製範例</button></article>`).join("")||'<div class="snippet-empty">找不到符合的語法。</div>';E.snippetList.querySelectorAll("[data-copy]").forEach(b=>b.onclick=async()=>{const s=SNIPPETS[+b.dataset.copy];await navigator.clipboard.writeText(s.code);toast(`已複製：${s.title}`)})}
-async function loadCatalog(){catalog=await(await fetch("/api/classroom/classes")).json();const saved=localStorage.getItem("classroom_code");E.classCode.innerHTML=catalog.courses.map(c=>`<option value="${esc(c.class_code)}">${esc(c.course_name)}｜${esc(c.class_code)}</option>`).join("");E.classCode.value=catalog.courses.some(c=>c.class_code===saved)?saved:(catalog.courses[0]?.class_code||"");renderStudentChoices()}
-function renderStudentChoices(){const selectedCourse=catalog.courses.find(c=>c.class_code===E.classCode.value),members=selectedCourse?.students||[],savedId=localStorage.getItem("classroom_student_id");E.studentChoice.innerHTML=members.map(s=>`<option value="${esc(s.student_id)}" data-name="${esc(s.display_name)}">${esc(s.display_name)}</option>`).join("")+`<option value="__new__">＋ 輸入新名字</option>`;E.studentChoice.value=members.some(s=>s.student_id===savedId)?savedId:"__new__";toggleNewStudent()}
-function toggleNewStudent(){const adding=E.studentChoice.value==="__new__";E.newStudentFields.hidden=!adding;E.displayName.required=adding;if(adding)E.displayName.value=localStorage.getItem("classroom_name")||""}
-E.classCode.onchange=renderStudentChoices;E.studentChoice.onchange=toggleNewStudent;E.identityForm.onsubmit=e=>{e.preventDefault();const c=clean(E.classCode.value),adding=E.studentChoice.value==="__new__",option=E.studentChoice.selectedOptions[0],n=clean(adding?E.displayName.value:option?.dataset.name);if(!c||!n){E.identityError.textContent="請選擇學生或輸入新名字";return}studentId=adding?crypto.randomUUID():E.studentChoice.value;localStorage.setItem("classroom_student_id",studentId);localStorage.setItem("classroom_code",c);localStorage.setItem("classroom_name",n);E.identityError.textContent="";E.identityDialog.close();connect()};E.identityButton.onclick=async()=>{await loadCatalog();E.identityDialog.showModal()};E.weekSelect.onchange=()=>{localStorage.setItem("classroom_week",week());submittedAt=null;connect()};E.projectName.oninput=sync;
+async function loadCatalog(){catalog=await(await fetch("/api/classroom/classes")).json();const saved=localStorage.getItem("classroom_code");E.classCode.innerHTML=catalog.courses.map(c=>`<option value="${esc(c.class_code)}">${esc(c.course_name)}｜${esc(c.class_code)}</option>`).join("");E.classCode.value=catalog.courses.some(c=>c.class_code===saved)?saved:(catalog.courses[0]?.class_code||"");E.displayName.value=localStorage.getItem("classroom_name")||""}
+E.identityForm.onsubmit=async e=>{e.preventDefault();const c=clean(E.classCode.value),n=E.displayName.value.trim(),button=E.identityForm.querySelector("button[type=submit]");if(!c||!n){E.identityError.textContent="請選擇課程並輸入姓名";return}button.disabled=true;button.textContent="驗證名單中…";E.identityError.textContent="";try{const response=await fetch("/api/classroom/student-login",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({class_code:c,display_name:n})});const data=await response.json();if(!response.ok)throw Error(data.detail||"無法驗證名單");studentId=data.student_id;localStorage.setItem("classroom_student_id",studentId);localStorage.setItem("classroom_code",c);localStorage.setItem("classroom_name",data.display_name);E.identityDialog.close();connect()}catch(error){E.identityError.textContent=error.message}finally{button.disabled=false;button.textContent="進入教室"}};E.identityButton.onclick=async()=>{await loadCatalog();E.identityDialog.showModal()};E.weekSelect.onchange=()=>{localStorage.setItem("classroom_week",week());submittedAt=null;connect()};E.projectName.oninput=sync;
 E.newFileButton.onclick=()=>{const p=(prompt("新檔名（例如 clues.py）：")||"").trim();if(!/^[\w\-\u4e00-\u9fff/]+\.(py|json|txt|csv|md)$/.test(p)||p.includes(".."))return toast("檔名不合規格");if(p in files)return toast("檔案已存在");files[p]=p.endsWith(".py")?"# 新的 Python 模組\n":"";openFile(p);sync()};
 E.templateButton.onclick=async()=>{if(!confirm("匯入套版會取代目前內容，繼續？"))return;const r=await fetch(`/api/classroom/template/${week()}`);if(!r.ok)return toast("這週尚未發布套版");const d=await r.json(),w=course.weeks.find(x=>x.id===week());setProject(d.files,w?.project);toast("已匯入本週套版")};
 E.progressButton.onclick=async()=>{const q=new URLSearchParams({class_code:localStorage.getItem("classroom_code")||"",student_id:studentId,display_name:localStorage.getItem("classroom_name")||""}),r=await fetch(`/api/classroom/progress?${q}`),d=await r.json();E.progressList.innerHTML=d.progress.length?d.progress.map((p,i)=>`<button class="progress-item" data-i="${i}"><strong>${esc(p.week_id)}｜${esc(p.project_name)}</strong><span>${p.source==="published"?"已發布 ":""}${new Date(p.submitted_at).toLocaleString("zh-TW")}</span></button>`).join(""):'<p>還沒有正式版本。</p>';E.progressList.querySelectorAll("[data-i]").forEach(b=>b.onclick=()=>{const p=d.progress[+b.dataset.i];setProject(p.files,p.project_name);E.progressDialog.close()});E.progressDialog.showModal()};document.querySelectorAll(".dialog-close").forEach(b=>b.onclick=()=>b.closest("dialog").close());

classroom_static/teacher.html

@@ -1,6 +1,19 @@
-<!doctype html><html lang="zh-Hant"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Python 專案教室｜教師控制台</title><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-4"></head><body>
+<!doctype html>
+<html lang="zh-Hant">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Python 專案教室｜教師控制台</title><link rel="stylesheet" href="/classroom-assets/classroom.css?v=2026fall-5"></head>
+<body>
 <header class="app-header"><div class="brand"><div class="brand-mark">Py</div><div class="brand-copy"><strong>全班專案控制台</strong><span id="classLabel">尚未進入班級</span></div></div><div class="header-actions"><div class="connection-state"><i id="connectionDot" class="status-dot"></i><span id="connectionText">未連線</span></div><a class="btn secondary compact header-link" href="/admin">內容管理</a><button class="btn secondary compact" id="loginButton">切換班級</button></div></header>
 <section class="project-bar"><div class="project-context"><label for="teacherWeek">週次</label><select id="teacherWeek"></select><span id="submissionSummary" class="submission-summary">等待學生</span></div><div class="project-actions"><button class="copy-button" id="downloadButton">下載全班 ZIP</button><button class="btn compact" id="publishButton">結算並發布 Demo</button></div></section>
-<main class="teacher-layout"><section class="roster-panel"><div class="panel-heading"><h1>學生狀態</h1><span id="studentTotal">0 人</span></div><div class="filter-bar" id="teacherFilters"><button class="chip" data-filter="all" aria-pressed="true">全部</button><button class="chip" data-filter="submitted">已提交</button><button class="chip" data-filter="help">需要協助</button><button class="chip" data-filter="error">錯誤</button></div><div class="roster-header"><span>學生</span><span>狀態</span><span>檔案</span><span>提交</span></div><div class="roster-list" id="rosterList"></div></section>
-<section class="teacher-detail" id="teacherDetail"><div class="detail-empty" id="detailEmpty">選擇一位學生查看多檔案專案。</div><div class="detail-view" id="detailView" hidden><header class="detail-header"><div><h1 id="selectedStudentName"></h1><p class="detail-meta" id="selectedStudentMeta"></p></div><div class="detail-actions"><button class="copy-button" id="ackHelpButton" hidden>標記已查看</button><button class="copy-button" id="copyCodeButton">複製檔案</button><button class="copy-button danger-action" id="deleteStudentButton">刪除學生</button></div></header><div class="teacher-project"><nav class="teacher-file-tabs" id="teacherFiles"></nav><div class="detail-split"><section class="read-only-pane"><div class="pane-label"><span id="teacherActiveFile">main.py</span><span id="lineCount">0 行</span></div><pre class="code-readonly" id="studentCode"></pre></section><section class="read-only-pane"><div class="pane-label"><span>Console</span><span id="outputState"></span></div><pre class="output-readonly" id="studentOutput"></pre></section></div></div></div></section></main>
-<dialog id="loginDialog"><form class="dialog-content form-stack" id="loginForm"><div><h1>進入教師控制台</h1><p>選取現有課程，或建立新的課程代碼。</p></div><div><label class="field-label" for="classCode">課程</label><select class="text-field" id="classCode" required></select></div><div id="newClassFields" hidden><label class="field-label" for="newClassCode">新課程代碼</label><input class="text-field" id="newClassCode" placeholder="L6B"><label class="field-label secondary-label" for="newClassName">課程名稱</label><input class="text-field" id="newClassName" placeholder="進階專題 B 班"></div><div><label class="field-label" for="teacherPassword">教師密碼</label><input class="text-field" id="teacherPassword" type="password" required></div><p class="form-error" id="loginError"></p><button class="btn" type="submit">開始監看</button></form></dialog><dialog id="publishDialog"><div class="dialog-content"><h2>結算並發布</h2><p id="publishMessage"></p><div class="publish-actions"><button class="btn secondary" id="cancelPublish">取消</button><button class="btn" id="confirmPublish">確認發布</button></div></div></dialog><div class="toast" id="toast"></div><script src="/classroom-assets/teacher.js?v=2026fall-6"></script></body></html>
+<main class="teacher-layout">
+  <section class="roster-panel">
+    <div class="panel-heading"><h1>學生狀態</h1><span id="studentTotal">0 人</span></div>
+    <form class="roster-add" id="rosterAddForm"><label class="sr-only" for="studentNames">新增學生姓名</label><input class="text-field" id="studentNames" placeholder="輸入姓名；多人可用逗號分開" autocomplete="off"><button class="btn compact" id="addStudentsButton" type="submit">加入名單</button></form>
+    <div class="filter-bar" id="teacherFilters"><button class="chip" data-filter="all" aria-pressed="true">全部</button><button class="chip" data-filter="submitted">已提交</button><button class="chip" data-filter="help">需要協助</button><button class="chip" data-filter="error">錯誤</button></div>
+    <div class="roster-header"><span>學生</span><span>狀態</span><span>檔案</span><span>提交</span></div><div class="roster-list" id="rosterList"></div>
+  </section>
+  <section class="teacher-detail" id="teacherDetail"><div class="detail-empty" id="detailEmpty">選擇一位學生查看多檔案專案。</div><div class="detail-view" id="detailView" hidden><header class="detail-header"><div><h1 id="selectedStudentName"></h1><p class="detail-meta" id="selectedStudentMeta"></p></div><div class="detail-actions"><button class="copy-button" id="ackHelpButton" hidden>標記已查看</button><button class="copy-button" id="copyCodeButton">複製檔案</button><button class="copy-button danger-action" id="deleteStudentButton">刪除學生</button></div></header><div class="teacher-project"><nav class="teacher-file-tabs" id="teacherFiles"></nav><div class="detail-split"><section class="read-only-pane"><div class="pane-label"><span id="teacherActiveFile">main.py</span><span id="lineCount">0 行</span></div><pre class="code-readonly" id="studentCode"></pre></section><section class="read-only-pane"><div class="pane-label"><span>Console</span><span id="outputState"></span></div><pre class="output-readonly" id="studentOutput"></pre></section></div></div></div></section>
+</main>
+<dialog id="loginDialog"><form class="dialog-content form-stack" id="loginForm"><div><h1>進入教師控制台</h1><p>選取現有課程，或建立新的課程代碼。</p></div><div><label class="field-label" for="classCode">課程</label><select class="text-field" id="classCode" required></select></div><div id="newClassFields" hidden><label class="field-label" for="newClassCode">新課程代碼</label><input class="text-field" id="newClassCode" placeholder="L6B"><label class="field-label secondary-label" for="newClassName">課程名稱</label><input class="text-field" id="newClassName" placeholder="進階專題 B 班"></div><div><label class="field-label" for="teacherPassword">教師密碼</label><input class="text-field" id="teacherPassword" type="password" required></div><p class="form-error" id="loginError"></p><button class="btn" type="submit">開始監看</button></form></dialog>
+<dialog id="publishDialog"><div class="dialog-content"><h2>結算並發布</h2><p id="publishMessage"></p><div class="publish-actions"><button class="btn secondary" id="cancelPublish">取消</button><button class="btn" id="confirmPublish">確認發布</button></div></div></dialog><div class="toast" id="toast"></div><script src="/classroom-assets/teacher.js?v=2026fall-7"></script>
+</body>
+</html>

classroom_static/teacher.js

@@ -6,6 +6,7 @@ const E = {};
   "teacherFilters", "rosterList", "detailEmpty", "detailView", "selectedStudentName",
   "selectedStudentMeta", "teacherFiles", "teacherActiveFile", "lineCount", "studentCode",
   "studentOutput", "outputState", "ackHelpButton", "copyCodeButton", "deleteStudentButton",
+  "rosterAddForm", "studentNames", "addStudentsButton",
   "loginDialog", "loginForm", "classCode", "newClassFields", "newClassCode", "newClassName",
   "teacherPassword", "loginError", "publishDialog", "publishMessage", "cancelPublish",
   "confirmPublish", "toast"
@@ -48,7 +49,7 @@ function show() {
   E.rosterList.innerHTML = list.length ? list.map(student => {
     const [dot, label] = status(student);
     return `<button class="student-row ${student.student_id === selected ? "selected" : ""}" data-id="${student.student_id}"><span class="student-name">${esc(student.display_name)}</span><span class="status-label"><i class="status-dot ${dot}"></i>${label}</span><span class="time-label">${Object.keys(student.files || {}).length} 檔</span><span class="help-label">${student.submitted_at ? "已交" : "—"}</span></button>`;
-  }).join("") : '<div class="empty-roster">這個課程尚無學生。</div>';
+  }).join("") : '<div class="empty-roster">這個班級尚無學生。請用上方欄位建立名單。</div>';
   E.rosterList.querySelectorAll("[data-id]").forEach(button => button.onclick = () => {
     selected = button.dataset.id;
     file = "main.py";
@@ -197,6 +198,19 @@ E.teacherFilters.querySelectorAll("[data-filter]").forEach(button => button.oncl
   show();
 });
 E.ackHelpButton.onclick = () => { if (selected) socket.send(JSON.stringify({ type: "ack_help", student_id: selected })); };
+E.rosterAddForm.onsubmit = async event => {
+  event.preventDefault();
+  const names = E.studentNames.value.split(/[,，\n]+/).map(name => name.trim()).filter(Boolean);
+  if (!names.length) return toast("請輸入學生姓名");
+  E.addStudentsButton.disabled = true;
+  E.addStudentsButton.textContent = "加入中…";
+  try {
+    const data = await (await request("/api/classroom/students", "POST", { display_names: names })).json();
+    E.studentNames.value = "";
+    toast(data.warning || `已加入 ${data.created.length} 位學生`);
+  } catch (error) { toast(error.message); }
+  finally { E.addStudentsButton.disabled = false; E.addStudentsButton.textContent = "加入名單"; }
+};
 E.copyCodeButton.onclick = async () => {
   const student = students.find(item => item.student_id === selected);
   if (student) { await navigator.clipboard.writeText(student.files[file] || ""); toast("已複製檔案"); }
@@ -205,11 +219,11 @@ E.deleteStudentButton.onclick = async () => {
   const student = students.find(item => item.student_id === selected);
   if (!student || !confirm(`從 ${credentials.classCode} 刪除學生「${student.display_name}」與其教室進度？\n\n已發布到 Demo 的作品不會被刪除。`)) return;
   try {
-    await request("/api/classroom/students", "DELETE", { student_id: student.student_id });
+    const data = await (await request("/api/classroom/students", "DELETE", { student_id: student.student_id })).json();
     students = students.filter(item => item.student_id !== student.student_id);
     selected = null;
     show();
-    toast("已從課程名單刪除學生");
+    toast(data.warning || "已從課程名單刪除學生");
   } catch (error) { toast(error.message); }
 };
 E.downloadButton.onclick = async () => {

templates/index.html

@@ -18,7 +18,6 @@
                 <span class="brand-name">Telearn 得能教育</span>
             </a>
             <div class="nav-links">
-                <a href="/classroom" class="nav-link">Python 專案教室</a>
                 <a href="https://telearn.best/course-map/" target="_blank" class="nav-link">常態班課程</a>
                 <a href="https://telearn.best/contact/" target="_blank" class="nav-link">聯絡我們</a>
             </div>

tests/test_classroom.py

@@ -90,7 +90,9 @@ class ClassroomServiceTests(unittest.TestCase):
             request = classroom.StudentDelete(
                 class_code="L6A", student_id="student-1", password="teacher-test"
             )
-            self.assertEqual(asyncio.run(classroom.delete_student(request)), {"ok": True})
+            result = asyncio.run(classroom.delete_student(request))
+            self.assertTrue(result["ok"])
+            self.assertIn("warning", result)
         finally:
             classroom.PASSWORD = old_password
         course = next(item for item in classroom.catalog()["courses"] if item["class_code"] == "L6A")
@@ -116,6 +118,37 @@ class ClassroomServiceTests(unittest.TestCase):
         course = next(item for item in classroom.catalog()["courses"] if item["class_code"] == "L6B")
         self.assertEqual(course["course_name"], "週六進階班")
 
+    def test_teacher_creates_roster_and_student_types_matching_name(self):
+        old_password, old_token = classroom.PASSWORD, classroom.TOKEN
+        try:
+            classroom.PASSWORD = "teacher-test"
+            classroom.TOKEN = ""
+            request = classroom.StudentCreate(
+                class_code="L6A",
+                display_names=["12 Alex", "王小明", "12 Alex"],
+                password="teacher-test",
+            )
+            result = asyncio.run(classroom.create_students(request))
+        finally:
+            classroom.PASSWORD, classroom.TOKEN = old_password, old_token
+
+        self.assertEqual([item["display_name"] for item in result["created"]], ["12 Alex", "王小明"])
+        matched = classroom.student_login(
+            classroom.StudentLogin(class_code="L6A", display_name="12 alex")
+        )
+        self.assertEqual(matched["display_name"], "12 Alex")
+        with self.assertRaises(Exception):
+            classroom.student_login(
+                classroom.StudentLogin(class_code="L6A", display_name="不在名單")
+            )
+
+    def test_public_course_catalog_does_not_expose_student_names(self):
+        state = classroom.empty("L6A", "student-1", "Alex", "week02")
+        classroom.save(state)
+        public = classroom.public_catalog()
+        self.assertNotIn("students", public["courses"][0])
+        self.assertNotIn("Alex", json.dumps(public, ensure_ascii=False))
+
     def test_hf_failure_message_distinguishes_authentication_and_permission(self):
         unauthorized = RuntimeError("token hf_should_never_leak was rejected")
         unauthorized.response = SimpleNamespace(status_code=401)