說明 Uedu 平台討論區如何透過加權積分制、Emoji 加分與懲罰機制、BERT 品質評估及線性成績映射，自動計算學生的討論參與成績。
Uedu 的討論區評分系統（Forum Scoring）透過加權積分制自動計算學生在課程討論區的參與成績。系統綜合考量發文類型（主題文、留言、回覆）、教師與 AI 的 Emoji 回饋，以及 BERT 語意品質評估，最終以線性映射產生成績分數。
教師可針對每門課程自訂計分參數（積分權重、門檻、滿分值），也可透過 Emoji 機制即時表達對個別貼文的肯定或懲罰。整個評分流程由排程任務（Cron Job）每小時自動重新計算，確保成績即時更新。
每位學生的基礎積分（total_points）由三種發文行為累計而成，每種行為對應可設定的積分值：
| 行為 | 參數名稱 | 預設值 | 說明 |
|---|---|---|---|
| 發起主題 | pts_thread | 3 | 在討論區建立新的討論主題 |
| 留言 | pts_comment | 2 | 在他人主題下發表留言 |
| 回覆 | pts_reply | 1 | 回覆他人的留言 |
基礎積分公式：
total_points = (threads × pts_thread) + (comments × pts_comment) + (replies × pts_reply) + emoji_bonus
以下身分的使用者不計入評分：
這些特權使用者的 Emoji 行為會影響學生積分（見第 3 節），但自身的發文不參與評分。
教師可選擇將哪些討論版（boards）納入評分範圍，未被選擇的版面之發文不計入積分。此設定以課程為單位。
特權使用者（教師、助教、AI）可透過在學生貼文上按 Emoji 來給予額外積分：
| Emoji | 名稱 | 可使用者 | 效果 |
|---|---|---|---|
| 👍 | thumbsup | 教師、助教、AI | 加分（每次 +1 bonus） |
| 🎊 | confetti | 教師、助教 | 加分（每次 +1 bonus） |
| 🚀 | rocket | 教師、助教 | 加分（每次 +1 bonus） |
每位學生的 Emoji 加分總和受 bonus_max 上限限制（預設為 10），超過上限的加分不再累計。
| Emoji | 名稱 | 可使用者 | 效果 |
|---|---|---|---|
| 😴 | zzz | 教師、助教、AI | 該篇貼文的積分歸零（0 分） |
當一篇貼文被標記 zzz emoji 時，該貼文的基礎積分與所有加分 Emoji 均不計入，整篇以 0 分計算。
為避免 Emoji 加分過度膨脹，系統設有 bonus_max 參數（可由教師設定）。一位學生在整個課程中所獲得的 Emoji bonus 總和不會超過此上限。
當 AI 自動對學生貼文按下 Emoji（如 👍 或 😴）時，教師可能不同意 AI 的判斷。系統提供 Eyes（👀） Emoji 作為教師覆核機制：
例如：AI 對某篇淺層回覆按了 😴（歸零），但教師認為該回覆有價值。教師只需按一個 👀，AI 的 😴 即被忽略，該貼文恢復正常計分。
系統整合 BERT 語意品質評估，透過外部 API（https://aptel-api.uedu.tw/webhook）對學生貼文進行自動品質分析。
BERT 模型評估貼文的語意品質，主要考量內容的深度、相關性與原創性。評估結果作為 AI 自動給予 Emoji 的依據，但最終的積分仍以 Emoji 機制為準。
學生的最終成績由總積分（total_points）透過線性映射轉換為成績分數。教師可設定兩個關鍵參數：
| 參數 | 說明 | 預設值 |
|---|---|---|
threshold | 達到滿分所需的最低積分 | 20 |
full_score_value | 滿分分數 | 100 |
計算公式：
score = (total_points ≥ threshold) ? full_score_value : (total_points / threshold) × full_score_value
total_points ≥ threshold 時，成績 = full_score_value（滿分）total_points < threshold 時，成績 = total_points / threshold × full_score_value（線性遞增）假設 threshold = 20，full_score_value = 100：
| 學生 | 主題 | 留言 | 回覆 | Emoji bonus | total_points | 成績 |
|---|---|---|---|---|---|---|
| A | 3 | 5 | 4 | 5 | 28 | 100（滿分） |
| B | 1 | 3 | 2 | 2 | 13 | 65 |
| C | 0 | 1 | 1 | 0 | 3 | 15 |
討論區成績由排程任務（cron_forum_scoring.py）每小時自動重新計算：
此批次機制確保即使教師在非即時的情境下修改 Emoji 或調整參數，成績也會在下一個小時自動反映。
學生的討論區參與成績由 Uedu 平台的 Forum Scoring 模組自動計算。系統採用加權積分制，依據發文類型（主題文、留言、回覆）賦予不同積分權重。教師、助教與 AI 可透過 Emoji 機制（👍 加分、🎊 / 🚀 加分、😴 懲罰歸零）對個別貼文給予回饋，加分總和受上限（bonus_max）限制。AI 的 Emoji 回饋基於 BERT 語意品質評估（aptel-api.uedu.tw），教師可透過 👀 Emoji 覆核 AI 判斷。最終成績以線性映射計算：當總積分達到門檻（threshold）即為滿分，未達門檻則按比例換算。成績由排程任務每小時自動重新計算。各項計分參數（積分權重、門檻、滿分值、加分上限）均可按課程自訂。詳細方法論說明見 https://uedu.tw/doc/forum-scoring。
建議同時提供：