規則配置

內容依原始規格呈現 · 查看 Markdown 來源 ↗需具備倉庫查看權限

最後更新: 2026-06-14
說明： 以下設定為伺服器端 config。經驗值（Exp）與學習時長（Learning Duration）在 A-40-C General Settings 畫面中配置，此處不重複。修改後需重啟服務或透過 config reload API 熱更新。

1. 學生默認密碼

帳號初始化細節僅供具備倉庫權限的協作者查閱，公開手冊不包含此部分。

---

2. Mastery 計算係數

⚠️ 考慮到學生可能難以達標，Mastery 計算的分母部分乘以一個係數以降低難度。

參數	預設值	說明
mastery_denominator_coefficient	0.9	Mastery % 公式中的分母係數

Mastery 計算公式：

Mastery % = (各 Box 數量 × 認知權重) / (已開放 Sessions 總單字數 × mastery_denominator_coefficient) × 100%

Mastery 上限嚴格限制為 100%。係數 0.9 使分母變小，Mastery 數值更容易提升。

數學示例：

• 已開放 50 個單字，加權得分為 36
• 分母 = 50 × 0.9 = 45
• Mastery = 36 / 45 × 100% = 80%（而非 36/50 = 72%）

---

3. Discovery Hub 題目抽取規則（原 A-40-A）

設定項	說明	類型
DH Listening Box Distribution	各 Box (B0-B7) 聽力題目抽取配比	JSON per Level
DH Reading Box Distribution	各 Box (B0-B7) 閱讀題目抽取配比	JSON per Level
DH Special Box Threshold	錯誤次數門檻，觸發 Special Box 優先抽題	integer (預設 2)
DH Box Priority	盒子抽題優先級順序	Array (固定: Special > B0 > B1-6)

4. Speak Studio 口說規則（原 A-40-B）

設定項	說明	類型
SS Speaking Box Distribution	各 Box 口說題型分佈 (S1/S2/S3)	JSON per Level
SS Voice Scoring Threshold	語音評分及格線	float (0-1)
SS Special Logic Threshold	發音強化門檻（錯 n 題即進入 Special）	integer (預設 2)

5. 萊特納盒子系統（Leitner System）

設定項	說明	類型
Leitner Cooldown Intervals	各 Box 冷卻時間	JSON per Box
Leitner Cognitive Weights	各 Box 認知權重係數	JSON per Box

認知階段定義：

• ⚪ Not Started: Box 0
• 🌱 Emerging: Box 1, 2
• 🌿 Developing: Box 3, 4
• 🌳 Proficient: Box 5, 6
• 🏆 Mastered: Box 7

6. Category/Level 結構（原 A-40-C）

設定項	說明	類型
Category/Level Structure	16 Levels × 各 Category (EK/ES/NH) 結構定義	JSON
Session Sort Logic	Session 排序與依賴規則	JSON
Point Rewards Config	DH/SS/TR 各模組積分配比	JSON (預設 DH:10pt, SS:15pt, TR:20pt)

---

7. Alert 閾值配置

以下閾值用於 T-01 Teacher Dashboard、T-21 Individual Student Detail、A-01 Admin Dashboard、A-03 Admin Message Center 的 Alert 觸發邏輯。

設定項	預設值	說明	關聯畫面
alert_1_active_rate_threshold	60%	Active Rate 低於此值觸發 Alert 1（⚠️ Warning）	T-01, A-01
alert_2_inactive_threshold	30%	完全未活躍學生比例高於此值觸發 Alert 2（🔴 Critical，覆蓋 Alert 1）	T-01, A-01
alert_3_mastery_threshold	30%	Session Mastery 低於此值觸發 Alert 3（🔴 Critical）。若低於 15%，升級為「緊急」並推送給 Admin	T-01, A-03
alert_4_trophy_fail_threshold	50%	Trophy Fail Rate 超過此值觸發 Alert 4（🔴 Critical）	T-01
alert_5_consecutive_inactive_days	14	連續未活躍天數，觸發 Alert 5	T-01, T-21
active_rate_window_days	7	Active Rate 計算窗口（天數）	T-01, A-01
alert_zone_active_rate_threshold	50%	Zone 級別 Active Rate 警告線（Admin Dashboard）	A-01
alert_class_active_rate_threshold	40%	Class 級別 Active Rate 警告線（Admin Dashboard）	A-01
alert_dau_drop_threshold	30%	DAU 較昨日下滑超過此值觸發 A-03 Academic DAU Drop 訊息	A-03
alert_error_spike_threshold	40%	全區平均 Error Rate 超過此值觸發 A-03 Academic Error Spike 訊息	A-03
alert_import_failure_notify	true	批量導入失敗時是否觸發 A-03 Import 訊息	A-03
alert_security_retention_days	90	A-03 Security 訊息保留天數（不可批量清除）	A-03

Alert 層級關係

Alert 1 (⚠️ Warning): Active Rate < 60%
    ↓ 若完全未活躍 > 30% 則升級為
Alert 2 (🔴 Critical): 覆蓋 Alert 1，優先級最高

Alert 3 (🔴 Critical): Session Mastery < 30%（獨立觸發，不與 Alert 1/2 互斥）
    ↓ 若 Mastery < 15% 升級為「緊急」並推送至 Admin

Alert 4 (🔴 Critical): Trophy Fail Rate > 50%（獨立觸發）

Alert 5 (🔴 Critical): 連續 14 天不活躍 — 學生級（獨立觸發）

A-03 Academic:
  DAU Drop: 較昨日下滑 > 30%
  Error Spike: 全區平均 Error Rate > 40%

---

8. Mode 機制配置

Mode 控制學生的複習範圍。每個 Mode 定義兩個參數：prev_session（從當前 Session 往前回溯幾個 Session）和 box_cap（只取 Box ≤ N 的詞）。詳細機制見 10-盒子系統.md。

{
  "mode_1": {
    "prev_session": 2,
    "box_cap": 2,
    "description": "起步：最近 2 個 Session，淺層盒子（Box 0-2）"
  },
  "mode_2": {
    "prev_session": 5,
    "box_cap": 3,
    "description": "擴展到 5 個 Session + 更深盒子（Box 0-3）"
  },
  "mode_3": {
    "prev_session": 8,
    "box_cap": 4,
    "description": "8 個 Session，Box 0-4"
  },
  "mode_4": {
    "prev_session": 11,
    "box_cap": 5,
    "description": "11 個 Session，Box 0-5"
  },
  "mode_5": {
    "prev_session": 16,
    "box_cap": 7,
    "description": "16 個 Session，全 Box 範圍（Box 0-7）"
  },
  "mode_6": {
    "prev_session": "all",
    "box_cap": 7,
    "description": "終極模式：回溯全部 Session（受限於 T-21 Session Start 邊界）"
  }
}

邊界規則

規則	說明
Session Start 邊界	回溯範圍不得低於 T-21 Individual Student Detail 設定的 Session Start
截斷不降級	若實際可用 Session 少於 prev_session，截斷至可用數，Mode 不降級
按學生獨立	每個學生維護自己的 Mode 狀態，不與他人連動

---

9. Active 行為定義

Active 的定義統一用於 T-01 Teacher Dashboard、T-21 Individual Student Detail、A-01 Admin Dashboard 的 Active Rate 計算。

設定項	預設值	說明
active_definition_days_per_week	2	一周內至少使用 App 的天數
active_definition_min_sessions	1	每次使用至少完成 1 次練習（DH 或 SS）
active_rate_window	7 days	Active Rate 計算窗口
inactive_no_usage_days	7	連續未使用天數即視為 inactive

Active 判定邏輯

學生在過去 7 天內：
  - 至少有 2 天打開 App
  - 且每次至少完成 1 次練習（DH 或 SS）
→ 判定為 Active

否則 → 判定為 Inactive

相關畫面

畫面	使用場景
T-01 Teacher Dashboard	班級 Active Rate KPI、Alert 1/2
T-21 Individual Student Detail	個別學生 Active 狀態
A-01 Admin Dashboard	Zone/School/Class 各級 Active Rate
A-03 Admin Message Center	觸發低 Active Rate 相關訊息

---

關聯文檔：

• Alert 閾值與觸發邏輯 → 03-App畫面-教師.md（T-01）、04-App畫面-管理員.md（A-01, A-03）
• Mode 機制詳情 → 10-盒子系統.md
• Active 定義 → 10-盒子系統.md（學生 Active 定義）
• 角色權限（誰能修改配置） → 06-角色與權限定義.md

---

10. Zuzu 收集系統配置

Zuzu 收集機制僅在學生端生效。以下參數控制 Mission 任務獎勵、抽卡價格、收集數量與漫畫觸發規則。

Daily Mission

設定項	預設值	說明
daily_mission_rounds	3	每日任務需完成回合數
daily_mission_min_questions	10	每回合最少題數
daily_mission_min_accuracy	0.70	每回合最低正確率
daily_mission_elalitte_reward	1	每日任務達成後獲得 Elalitte 數量

Weekly Mission

設定項	預設值	說明
weekly_mission_exp_target	840	每週任務 EXP 目標值
weekly_mission_elalitte_reward	3	每週任務達成後獲得 Elalitte 數量

抽卡（Gacha）

設定項	預設值	說明
gacha_discount_price	5	前 N 次抽卡優惠價（Elalitte）
gacha_full_price	10	標準抽卡價格（Elalitte）
gacha_discount_count	3	優惠次數上限（前 N 次半價）

Zuzu 收集 & 漫畫

設定項	預設值	說明
zuzu_total_count	40	Zuzu 總數
comic_trigger_milestones	[1, 10, 20, 30, 40]	觸發漫畫的收集里程碑
comic_page_min	3	每次漫畫最少頁數
comic_page_max	5	每次漫畫最多頁數

關聯畫面： S-07 Mission、S-08 Zuzu Pedia、S-10 Home（Elalitte 礦區）。詳細收集規則見 02-App畫面-學生.md。