本站解析 xai-org/x-algorithm 开源仓库，源码基线是 commit 2e2295b（2026-11-06）。每条结论都附 文件:行号 源码锚点，读者可以自己核对。本站不是 xAI 官方文档。
不读代码的读者，从 推荐系统工作原理 开始。工程师从 系统架构总览 开始。上游最近改了什么，见 上游变化记录。
这套系统由两条路径组成
- 请求路径：用户打开 For You 时实时运行。home-mixer 从多个来源取候选帖子并过滤，用 Phoenix 预测各种行为的概率，由 vm-ranker 加权求和排序，再经 可见性过滤 检查后返回。
- 标签路径：在后台持续运行。内容理解模型和规则给帖子、账号打标签。可见性过滤读取这些标签，决定一条帖子对某位用户是正常展示、加提示、加遮罩还是不展示。
白话导览（不含代码）
- 推荐系统工作原理：一条帖子进入 For You 的七个步骤
- 核心组件速览：每组组件做什么
- 术语速查表：全站术语的统一定义
- 常见疑问 FAQ
- 选帖过程：打分之后如何选出最终的帖子
- 运营迷思 vs 源码真相
- 发帖指南：从算法机制反推发帖做法
- 限流与 shadowban：哪些标签让帖子不推给非关注者
- 新号与冷启动
- 算法用了你的哪些数据
- 开源版 vs 线上算法
技术文档
总览
编排 · home-mixer
- 流水线框架
- home-mixer 编排层：gRPC 服务、流水线与全部候选源
- 过滤流水线：21 个预打分过滤器与选后过滤器
- 选择与成型
- 广告混排
候选源
打分与重排
- 打分与排序：权重数值、作者多样性、站外降权、新作者扶持
- vm-ranker 重排服务
ML · Phoenix
- Phoenix 召回
- Phoenix 排序
- Phoenix 训练：损失函数、合成数据与本地训练
- 召回索引 rankall
- 候选隔离注意力掩码
- Transformer 骨架
- 哈希嵌入
内容理解
标签与可见性
- 可见性过滤
- 打标签规则：scarecrow 与 botmaker
- 账号信号：agatha、bdsm、user-cred-v2
- 处置服务
- Under the Hood：用户能看到自己的哪些标签
实体参考
内容来源
本站初版派生自 cclank/x-algorithm-wiki，它基于 2026-05-15 的源码 0bfc279。2026-11-06 起，全部页面按 2e2295b 重新核对和改写。