參考資料
術語對照
中文用語、英文術語與 API 欄位的對照表
本文件的行文使用中文術語，程式碼中的欄位名、列舉值、scope 與錯誤代碼則一律維持英文原樣。本頁為兩者的對照。
| 中文 | 英文 | id 前綴 | 說明 |
|---|
| 組織 | Organization | org_ | 貴組織於本服務中的帳戶，所有資源均屬於一個組織 |
| 題目 | Question | q_ | 題庫資源 |
| 題組 | Question group | q_ | nested 題型：共用題幹底下掛子題，最多三層，整棵樹共用一個版本 |
| 末端子題 | Gradeable leaf | — | 題組中實際被批閱的一層。提交以末端子題為單位送出作答，而非以題組 |
| 空格 | Blank | — | 填充題中的一格。題幹中為 blank 節點，設定於 scoring.blanks[] |
| 評分標準 | Rubric | rub_ | 題目給分方式的定義 |
| 考試 | Exam | exam_ | 有序的題目版本集合，學生提交的基本單位 |
| 學生名冊 | Roster | ros_ | student_ref 至姓名的對照清單 |
| 提交 | Submission | sub_ | 一位學生對一份考試的完整作答集合 |
| 作答 | Response | resp_ | 提交中對單一批閱對象的作答 |
| 批閱結果 | Evaluation | eval_ | 單筆作答的評分與評語，逐版本累積 |
| API 金鑰 | API Key | ak_ | API 操作的憑證 |
| Webhook 端點 | Webhook | wh_ | 事件遞送的目的地 |
| Webhook 簽章密鑰 | Webhook secret | whsk_ | 密鑰的識別碼（非祕密），祕密值本身以 whsec_ 開頭 |
| 事件 | Event | evt_ | Webhook 遞送的物件識別碼 |
| 遞送紀錄 | Delivery | del_ | 一個事件對一個端點的遞送紀錄 |
| 使用者 | User | user_ | Studio 的人員帳號 |
| 中文 | 英文 | 意義 |
|---|
| 識別碼 | id | 指認一個資源，由伺服器指派，帶有固定前綴 |
| 版本 | version | 版本化內容的一次不可變修訂 |
| 版本化參照 | versioned ref | "{id}:{version}" 字串，例如 "q_abc:2"。只存在於版本化內容（題目、評分標準） |
版本化參照中使用 :latest 的表示法僅於寫入時有效，且會在當下解析為明確版本。
| 中文 | 英文 | 出現於 |
|---|
| 待處理 | pending | 提交、作答 |
| 處理中 | processing | 提交、作答 |
| 已完成 | completed | 提交、作答 |
| 失敗 | failed | 提交、作答（終態的失敗標記為 failed，而非 error） |
| 使用中 | active | 考試、題目、評分標準、金鑰、Webhook |
| 已封存 | archived | 考試、題目、評分標準 |
| 已停用 | disabled | 金鑰、Webhook |
批閱判定（批閱結果的 outcome）：
| 中文 | 英文 | 分數 |
|---|
| 正常批閱 | graded | 依實際評分 |
| 空白 | blank | 0 |
| 敏感內容 | sensitive_content | 0 |
批閱方式（批閱結果的 method）：
| 中文 | 英文 | 適用於 |
|---|
| 標準批閱 | rubric_grading | short_answer、composition |
| 逐格判定 | blank_grading | fill_in_blank |
| 完全比對 | exact_match | 填充題單格（blanks[].method） |
兩種評分法在文件中以評量領域慣用的中文稱呼：
| 評分法 | API 欄位 | 分項的稱呼 | 分項與總分的關係 |
|---|
| 分析式評分 Analytic | dimensions | 向度 Dimension | 構成總分，加總等於總分 |
| 整體式評分 Holistic | criteria | 準則 Criterion | 描述作答，與總分無算術關係 |
| 中文 | 英文 | 說明 |
|---|
| 級距 | levels | 一個向度或準則的分數帶。向度的級距以 score（絕對）或 ratio（比例）表達其價值，準則的級距只能用 ratio |
| 權重 | weight | 比例級距下，該向度佔題目滿分的比例，各向度加總為 1.00；準則不接受此欄位 |
| 計分規則 | penalties | 批閱過程中觸發的計分規則，僅記錄種類，不記錄幅度 |
| 中文 | 英文 | 說明 |
|---|
| Studio | Studio | 供人員使用的操作介面 |
| 客戶端 | client | 呼叫本 API 的整合系統 |
| 冪等鍵 | idempotency key | 唯一識別一個邏輯操作的客戶端字串。單筆建立時置於 Idempotency-Key 標頭，批次建立時置於每筆項目的 idempotency_key 欄位 |
| 內容文件 | content document | ProseMirror JSON，作答與題幹共用的結構 |
| 覆核 | revise / revision | 人工修正評分，產生新的批閱結果版本 |
| 加強驗證 | step-up authentication | 在 Studio 中執行高風險管理操作時所要求的重新驗證身分，有效期 15 分鐘 |
| 中文 | 欄位 | 說明 |
|---|
| 檢閱建議 | review_suggested | 布林值，true 代表本服務建議由人再檢視一次。屬於建議而非狀態，不影響批閱結果生效 |
| 批閱政策版本 | grader_revision | 不透明字串，指名產生該次批閱的模型、提示詞與計分設定。請只做相等比較，不要解析 |
| 版本建立者 | graded_by | 該批閱結果版本由誰產生，前綴標明類型："ai"、user_…、ak_…、"norma_ops" |
| 前一版分數 | previous_score | 只出現在覆核的回應中，供確認畫面比對用，不屬於儲存的批閱結果 |
| 中文 | 欄位 | 說明 |
|---|
| 事件序號 | sequence | 同一個資源的事件流水號，自 1 起遞增。遞送順序不保證，請以它重建順序 |
| 去重鍵 | event_id／idempotency_key | 重試時保持不變，用於辨識重複遞送。請勿改用內容雜湊或 X-Norma-Delivery-Id |