unhardcoded
信任物件

追蹤紀錄與重現

追蹤紀錄的 schema 結構、重現機制如何復現決策過程,以及一致性保障說明。

追蹤紀錄 schema

每次補全請求都帶有一條追蹤紀錄:一份結構化、可重現的記錄,說明模型是如何被選定的。它是證明物件——哪些候選模型被納入考量、每個模型通過或遭到排除的原因、最終使用了哪個,以及如何重現該決策。

decision_trace
deepseek-v4-flashrejected · cmp bench_intelligence ge 0.5
minimax-m2.7rejected · cmp bench_intelligence ge 0.5
deepseek-v4-proranked #1 · chosen
glm-5.1ranked #2 · cascade
gpt-5.5ranked #3 · cascade
deepseek-v4-prodecision_path · attempted · 412 ms
policy_fingerprint 301140696-1054914287 · sigma-pol/v2
policy_fingerprint
正規化策略的輕量快取鍵,格式為兩條十進位數字通道,如 301140696-1054914287;相同的項(term)共享同一指紋(fingerprint)。完整身份識別是主機端對規範編碼的 sha256
chosen
處理本次呼叫之模型的 { model_family, served_model_id, price_in, price_out }
ranked[]
依選取順序排列的通過候選模型:{ provider, model_family, served_model_id, tier, price_out, score }。排序最前的即為最終選定模型,其餘為備援串聯(cascade)。
rejected[]
每個遭過濾排除的候選模型及其排除規則:{ model_family, reason },例如 cmp bench_intelligence ge 0.5
decision_path[]
有序的嘗試記錄:{ event, provider_id, attempt, latency_ms, error_kind? }。每次備援跳轉都以 attempted 項目記錄於此。
total_latency_ms
路由加推理的總耗時。工作流程則返回 flow_fingerprintflow_nodes[],每個節點各含一條追蹤紀錄。

重現。身份識別是策略規範編碼的 sha256,因此給定追蹤紀錄與目錄快照,相同的策略與輸入在主機端或本地端均可復現相同的決策。

一致性

策略應在任何執行環境下具有相同的語義。規範編碼、sha256 身份識別、參考直譯器,以及一組共享的黃金向量共同保障了這一點。

same policy = same inputs = same catalog = same seed = same result。語義僅使用正確捨入的算術,因此符合規範的主機可重現黃金向量(tests/golden/sigma_pol_v2.json,位於 engine 儲存庫),逐位元復現每一個決策。相同的項編碼為相同的位元組,因此跨主機共享同一個 sha256 身份識別。

← 返回文件