開源專案
xai-org/x-algorithm avatar
xai-org/x-algorithm

x-algorithm:從 README 讀懂流程與限制

為 X 上的 For You feed 提供支援的演算法。 **注意:** 轉換器實作是從 xAI 的 Grok-1 開源版本移植而來,適用於推薦系統用例。

33,186 個 Star5,383 個 ForkRustApache-2.0
GitHub

秒懂

它是什麼?
整理 xai-org/x-algorithm 的實際用途、操作路徑、架構線索與採用前檢查。
適合誰用?
適合願意依 xai-org/x-algorithm 的 README 建立小型案例、檢查具體輸入輸出並承擔相依條件的人;不適合把文件中的能力當成未經驗證的效能或相容性承諾。採用前請執行專案明示的命令,記錄版本、設定、產物與錯誤,再按 Apache-2.0 檢查使用方式。
可以商用嗎?
可以。Apache-2.0 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫最近一次提交在 4 天前。
用什麼語言寫的?
主要是 Rust(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月14日)與我們的分析,不構成法律意見。

開源專案深度解析

For You 的候選從哪裡來

該倉庫包含為X上的For You feed提供支援的核心推薦系統。系統從兩個來源拉取貼文:使用者關注的帳戶中的網路內內容,以及通過基於ML的檢索發現的網路外內容。兩者通過基於Grok的transformer模型進行組合和排序。README指出,transformer實現是從xAI的Grok-1開源版本移植而來,並針對推薦系統用例進行了調整。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 本節編號1,只根據 README 與素材可確認的內容,未列出的版本相容性、效能和安全保證均視為未說明。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 先記錄首次啟動的終端輸出與返回碼;這次只改變一個條件,觀察輸出、日誌與程序狀態的差異,並把結果寫入xai-org-x-algorithm-deep-analysis的測試紀錄。這個專案的輸入格式、執行環境、檔案位置、程序狀態、錯誤訊息、輸出內容與授權條件都要分開記錄,才能判斷文件描述是否適用於目前案例。

Home Mixer 請求路徑

架構以稱為Home Mixer的編排層為中心,它組裝For You feed。它執行查詢水合、從Thunder和Phoenix的候選來源、候選水合、過濾、評分、選擇和後選擇過濾。README包含一個圖,顯示從請求到排名響應的流程。Home Mixer暴露了一個名為ScoredPostsService的gRPC端點,為給定使用者返回排序後的貼文。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 本節編號2,只根據 README 與素材可確認的內容,未列出的版本相容性、效能和安全保證均視為未說明。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 再比對設定檔中的鍵名和實際產物;這次只改變一個條件,觀察輸出、日誌與程序狀態的差異,並把結果寫入xai-org-x-algorithm-deep-analysis的測試紀錄。這個專案的輸入格式、執行環境、檔案位置、程序狀態、錯誤訊息、輸出內容與授權條件都要分開記錄,才能判斷文件描述是否適用於目前案例。

Phoenix 如何形成分數

Home Mixer是構建在CandidatePipeline框架上的編排層。Thunder是一個記憶體貼文儲存,它從Kafka消費貼文建立和刪除事件,維護每個使用者的原始貼文、回覆或轉發以及視訊貼文的儲存,並裁剪超過保留期的貼文。Phoenix是ML元件,具有兩個功能:通過雙塔模型進行檢索,該模型將使用者和候選特徵編碼為嵌入,並通過點積相似度進行搜尋;以及通過transformer進行排序,該transformer預測參與機率,同時遮罩注意力以防止候選相互關注。candidate-pipeline crate定義了Source、Hydrator、Filter、Scorer、Selector和SideEffect的可重用trait。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 本節編號3,只根據 README 與素材可確認的內容,未列出的版本相容性、效能和安全保證均視為未說明。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 接著用最小輸入重跑並保留錯誤訊息;這次只改變一個條件,觀察輸出、日誌與程序狀態的差異,並把結果寫入xai-org-x-algorithm-deep-analysis的測試紀錄。這個專案的輸入格式、執行環境、檔案位置、程序狀態、錯誤訊息、輸出內容與授權條件都要分開記錄,才能判斷文件描述是否適用於目前案例。

可見性過濾與標籤系統

管道階段包括查詢水合、候選來源、候選水合、評分前過濾、評分、選擇和後選擇處理。評分前過濾器刪除重複項、過舊的貼文、檢視者自己的貼文、來自被阻止或靜音帳戶的貼文、包含被靜音關鍵詞的貼文、先前檢視或提供過的貼文,以及不符合訂閱資格的內容。後選擇過濾器包括對已刪除、垃圾郵件、暴力或血腥內容的可見性檢查,以及對同一對話執行緒的多個分支的去重。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 本節編號4,只根據 README 與素材可確認的內容,未列出的版本相容性、效能和安全保證均視為未說明。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 若涉及網路則分開記錄請求路徑與回應;這次只改變一個條件,觀察輸出、日誌與程序狀態的差異,並把結果寫入xai-org-x-algorithm-deep-analysis的測試紀錄。這個專案的輸入格式、執行環境、檔案位置、程序狀態、錯誤訊息、輸出內容與授權條件都要分開記錄,才能判斷文件描述是否適用於目前案例。

透明度工具能看什麼

Phoenix transformer預測一系列參與型別的機率:喜歡、回覆、轉發、引用、點選、個人資料點選、視訊觀看、照片展開、分享、停留、關注作者、不感興趣、阻止作者、靜音作者和舉報。加權評分器將這些組合成最終得分,即每個動作的權重乘以機率之和。喜歡和轉發等積極動作獲得正權重;阻止和靜音等消極動作獲得負權重。作者多樣性評分器衰減重複作者得分以促進feed多樣性,OON評分器調整網路外內容的得分。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 本節編號5,只根據 README 與素材可確認的內容,未列出的版本相容性、效能和安全保證均視為未說明。

公開程式碼的判讀邊界

README列出了一些設計決策。系統不使用手工設計的特徵;transformer從使用者參與序列中學習相關性。在排序期間,候選不能相互關注,只能關注使用者上下文,這使得分保持一致且可快取。嵌入使用多個雜湊函式計算。模型預測多個動作,而不是單個相關性得分。candidate-pipeline架構將管道執行和監控與業務邏輯分離,在可能的情況下並行執行獨立階段,並允許輕鬆新增新的來源、水合器、過濾器和評分器。

在 xai-org/x-algorithm 中,`thunder/`、`phoenix/`、`simclusters/`、`visibility-filtering/` 與 `home-mixer/` 是可直接追查的記號。權重作用於預測機率或連續值,不是原始互動次數。 本節編號6,只根據 README 與素材可確認的內容,未列出的版本相容性、效能和安全保證均視為未說明。

編輯結論

適合願意依 xai-org/x-algorithm 的 README 建立小型案例、檢查具體輸入輸出並承擔相依條件的人;不適合把文件中的能力當成未經驗證的效能或相容性承諾。採用前請執行專案明示的命令,記錄版本、設定、產物與錯誤,再按 Apache-2.0 檢查使用方式。

官方來源

  1. Official README
  2. Project repository
社群筆記

社群筆記