顏色與醒目標示
primary：主要保留峰或主要保留化合物。
secondary：次要保留峰或次要保留化合物。
same_name_diff_rt_group = yes：同名但 RT 不同，且目前保留為獨立峰。
merged：此列已合併到其他主峰。
background：背景峰、污染峰或不納入分析的列。
review：待人工確認。
needs_manual_review = yes：此列需要人工檢查。
mode_limited / stop_excluded / not_in_final：因模式限制、STOP 或人工決策而暫不納入 final。
*_peak_count >= 2：同一 sample 的同一最終化合物由 2 個以上 peak 構成。
total_peak_count：只有在低於輸入分析樣品數的 1/4 時才會醒目標示。
mode
full_mode：同一 sample 的 peak 與 library 候選完整可對位，可進完整主流程。
html_only_mode：只有 library / HTML 候選層，只做名稱候選整理與 Area% 觀察，不做最終命名。
csv_only_mode：只有 peak table / CSV，只做 RT、area、height、pct 比較，不做最終命名。
suggested_status
primary：系統建議的主要保留峰。
secondary：系統建議保留，但屬次要或非主要共識峰。
review：系統不敢自動定案，需要人工確認。
background：疑似背景峰 / 汙染峰 / artifact。
final_status
primary：最終主要保留化合物。
secondary：最終保留，但屬次要峰或次要版本。
review：人工仍未解決，不進最終完成版。
background：最終判定為背景 / 汙染，不進最終完成版。
merged：已合併到其他 final_cluster_id，本列不再單獨進 Final Summary。
not_in_final / mode_limited / stop_excluded：不納入最終完成版的特殊狀態。
manual_action
accept_suggested：接受系統建議。
keep_original_top1：採用 top1 原名。
force_name：人工強制指定名稱。
keep_separate：保留為獨立峰。
mark_secondary：人工降為 secondary。
mark_background：人工標示為 background。
split_cluster：從 cluster 中選部分 member peaks 拆成新的 child cluster。
undecided：暫不決定。
merge_action
keep_separate：同名不同 RT 保留獨立，不合併。
merge_to_primary：同名不同 RT 的非主峰合併到主峰。
primary_keep：該群為該名稱主峰，不會被別人合併。
conflict_level
low：名稱 / CAS 衝突低，系統較能自動建議。
high：名稱 / CAS 衝突高，需人工特別檢查。
基本欄位
sample：樣品名稱。
peak_no：該樣品內的 peak 編號。
peak_id：單一 peak 的唯一識別碼；Peak Override 以此為主鍵。
rt_ref：單一 peak 的原始 RT。
rt_mean：同一 RT cluster 內各 peak 彙整後的代表 RT。
qual：library 比對品質分數。
candidate_rank：候選順位；1、2、3 通常分別對應 top1、top2、top3。
命名與同名不同 RT
original_name：匯入時保留的原始名稱。
suggested_name：系統在 RT-first 規則下產生的建議顯示名稱。
chosen_base_name：標準化後的基礎名稱；若同名不同 RT 需保留獨立峰，後續可能再加上 (RT)。
final_name / display_name：套用人工決策、merge 決策與 Peak Override 後，最終真正顯示的名稱。
canonical_rule_basis：本群建議名稱採用的標準化依據；常見值如 name_first 或 cas_first。
same_name_diff_rt_group：同名但 RT 不同的群組標記；yes 時會以紫色提示。
primary_for_name：同名不同 RT 群組內，哪一個 cluster 被判為該名稱的主要保留峰；常見值為 yes / no / not_set。
other_same_name_rts / other_same_name_clusters：列出其他同名 RT 與 cluster，供人工判斷要保留獨立還是合併。
name_changed_any：該列名稱是否已相對原始名稱發生變動。
Final 追蹤欄位
cluster_id：RT 分群後的內部 cluster 編號。
final_cluster_id：最終完成版的內部唯一 ID；Final Clean Detail / Final Summary 以此彙整。
merged_into_final_cluster_id：若本列已併入主峰，這裡顯示被併入的 final_cluster_id。
included_in_final：是否進 Final Clean Detail / Final Summary；常見值如 yes / no，若為合併列也可能顯示合併狀態。
included_in_final_pct_denominator：是否納入最終百分比分母。
excluded_from_summary_reason：未進 Final Summary 的直接原因說明。
審核 / 風險 / 解析
needs_manual_review：此列因衝突、同名不同 RT 或 HTML/CSV 警示而需要人工確認。
html_csv_mismatch：HTML / CSV 對位結果；yes = 有警示，stop = 嚴重不一致，no = 無警示。
background_class：背景判定來源；常見值如 background / artifact / candidate / unknown。
parser_status：單一檔案解析結果；常見值如 parsed / empty / parse_error / unsupported / auxiliary_pdf。
候選與來源欄位
top1_name / top2_name / top3_name：保留的前三個候選名稱；應與對應 CAS / Qual / library 欄位一起閱讀。
top1_cas / top2_cas / top3_cas：前三候選對應的 CAS。
top1_qual / top2_qual / top3_qual：前三候選對應的 Qual。
top1_library / top2_library / top3_library：前三候選對應的 library 來源。
top_candidates：前三候選的原始結構化資料。
all_original_names / all_cas：同一 RT cluster 內彙整出的全部原始名稱 / CAS。
source_cluster_ids / source_peak_ids / source_rts：Final Clean Detail / Final Summary 回溯來源時使用的 cluster、peak 與 RT 清單。
sample_presence：該 final compound 出現在多少個樣品中。
Final Clean Detail / Final Summary 欄位
final_area：最終保留後的面積；若有 merge，會將子峰面積併入主峰。
final_height：最終保留後的峰高。
recalculated_pct：依最終保留化合物重新計算後的百分比。
*_peak_count：某一 sample 中，該 final compound 由多少個 peak 組成。
total_peak_count：該 final compound 在全部樣品中累計由多少個 peak 組成。
Peak Override
Peak Override 是針對單一 peak_id 的覆寫層，不影響全域規則，也不必先拆 cluster 才能使用。
override_name：只覆寫單一 peak 的最終名稱。
override_status：只覆寫單一 peak 的最終狀態。
include_final / include_denominator：只針對單一 peak 覆寫是否納入 final 與分母。
peak_override_applied：最終結果是否真的套用了 Peak Override。
note：Peak Override 的人工備註。
優先序：Peak Override > Manual Review（cluster） > Auto suggestion。