可见性过滤（Visibility Filtering）

这一页回答什么

• visibility-filtering/（下称 VF，即可见性过滤服务）对一条帖子和一位查看者给出哪几种裁定，每种裁定在内部对应哪些动作。
• 规则清单定义在哪里、按什么顺序执行；For You 用哪两个“安全级别”（safety level，即一张规则清单的名称），各含哪些规则。
• 规则读取哪些输入：帖子标签、账号标签、拉黑/静音/关注关系、受保护/封禁/停用状态、订阅、查看者设置与国家。
• VF 怎样实现“只在站外推荐中丢弃、对关注者放行”的规则。
• 国家下架与法律下架（takedown）怎样生效。
• home-mixer 怎样调用 VF，又怎样使用返回结果。

标签的来源见 打标签规则、账号级信号、处置与标签聚合。

核心结论

1. 排序和可见性是两套系统。 排序决定帖子的先后，VF 决定帖子能否出现。VF 读取标签和关系，不读取模型预测分。
2. 对外有四种裁定，内部有七种动作。 README 列出 ALLOW / NOTICE / INTERSTITIAL / DROP 四种裁定。它们对应内部 Verdict 的三个分支：Withheld（Drop、Tombstone）、Fosnr（SoftIntervention、Appealable，即 NOTICE）、Shown。Shown 有三个“槽位”，分别可放标签遮罩、媒体遮罩和互动限制（visibility-filtering/models/verdict.rs:20-29、visibility-filtering/rules/action_kind.rs:4-13）。
3. README 提到的 rules/registry.rs 在 2e2295b 中不存在。 规则定义在 rules/author_rules.rs 与 rules/tweet_rules.rs 中。各安全级别的规则清单在 rules/levels.rs 中。
4. For You 用两个安全级别。 站内候选用 TimelineHome。站外候选、祖先帖、被引用帖用 TimelineHomeRecommendations（home-mixer/candidate_hydrators/vf_candidate_hydrator.rs:70-106）。后者是前者的超集，测试代码强制检查这一点（visibility-filtering/rules/levels.rs:492-498）。
5. VF 先跑账号规则，后跑帖子规则；第一个“扣留”裁定结束评估。 VF 把每张清单按动作严重度稳定排序，Drop 排在遮罩之前（visibility-filtering/rules/engine.rs:38、engine.rs:104-108、engine.rs:560-569）。
6. “只对站外生效”有两层实现。 第一层是安全级别：站外专属规则只在 TimelineHomeRecommendations 中。第二层是规则的 audience（生效对象）：NonFollowers 规则对关注者不生效（visibility-filtering/rules/rule_spec/engine.rs:76）。
7. 作者本人总能看到自己的帖子。 绝大多数丢弃规则的 audience 是 NonAuthors 或 NonFollowers，两者都排除作者本人（visibility-filtering/rules/rule_spec/rule.rs:100-115）。
8. home-mixer 只剔除 Drop 一类。 home-mixer 剔除 Drop、Tombstone、NotEvaluated，保留 Interstitial 等其他结果（home-mixer/filters/vf_filter.rs:22-27）。filter_tweets 接口把 NOTICE 压成 Allow（visibility-filtering/treatment.rs:608-640）。

四种裁定与内部动作

依据：严重度与落点见 visibility-filtering/rules/action_kind.rs:56-132；映射见 visibility-filtering/treatment.rs:608-640。

FOSNR 通常解读为 “Freedom of Speech, Not Reach”（言论自由，不保证触达），源码未给出全称。Under the Hood 对 FOSNR 标签的说明是“帖子的可发现性仅限作者主页，所有人都能看到受限说明”（under-the-hood/strato/lib/underTheHoodLabels.strato:75-98）。Appealable 只对作者本人生效。它同时禁用一组操作，包括点赞、回复、转发、引用等，共 13 项（visibility-filtering/rules/tweet_rules.rs:89-139）。

规则的写法与执行顺序

一条规则由四个字段组成：id、audience、when（条件）、action（动作）。示例：

// visibility-filtering/rules/author_rules.rs:239-244
pub(super) const DO_NOT_AMPLIFY_USER_LABEL_DROP_UNSPECIFIED: UserRule = Rule {
    id: RuleId::DoNotAmplifyUserLabel,
    audience: NonFollowers,
    when: all![AuthorHasLabel(AuthorLabel::DoNotAmplify)],
    action: drop_post(DropAs::UnspecifiedReason),
};

audience 有四种取值（visibility-filtering/rules/rule_spec/rule.rs:100-115）：

执行顺序如下：

flowchart TD
    A["账号规则清单 user"] --> B{"命中 Drop 或 Tombstone?"}
    B -- "是" --> W["Withheld: 结束评估"]
    B -- "否" --> C["帖子规则清单 post"]
    C --> D{"命中扣留或 FOSNR?"}
    D -- "扣留" --> W
    D -- "FOSNR" --> F["Fosnr: 结束评估"]
    D -- "否" --> E["填槽: 标签遮罩 / 媒体遮罩 / 互动限制"]
    E --> S["Shown"]

• VF 先跑账号规则，再跑帖子规则（visibility-filtering/rules/engine.rs:560-569）。
• VF 把每张清单按动作严重度降序稳定排序；同一动作内的规则保持列出顺序（visibility-filtering/rules/engine.rs:38）。
• 出现终结裁定（Withheld 或 Fosnr）后，VF 不再执行后面的规则（visibility-filtering/rules/engine.rs:104-108）。
• 遮罩类动作只“填槽”，不结束评估。同一槽位已被填时，VF 忽略后来的动作（visibility-filtering/rules/engine.rs:196-258）。
• 数据源失败时，规则结果为 Unknown。如果评估依赖“必需”数据源，VF 返回 Partial（visibility-filtering/rules/engine.rs:144-177）。

规则的输入

For You 的两个安全级别

TimelineHome 与 TimelineHomeRecommendations 的规则清单在 visibility-filtering/rules/levels.rs:298-361。下表按类别整理。“站外专属”指规则只出现在 TimelineHomeRecommendations 中。

账号规则（user 清单）

站外账号规则的分组常量：NSFW 组见 levels.rs:322-330，OON_AUTHOR_LABEL_DROPS 见 levels.rs:65-72。

NotGraduated、AgathaSpamTopUser、EngagementSpammer、BlinkWorst、DownrankSpamReply 五种账号标签只出现在通知类级别中（levels.rs:89-100），不出现在 For You 的两个级别中。

帖子规则（post 清单，两级共有）

清单分组：FOSNR_DROPS levels.rs:102-107、TAKEDOWN_DROPS levels.rs:109-112、AGE_GATING_DROPS levels.rs:114-124、EXCLUSIVE_CONTENT_DROPS levels.rs:126-131、HOME_BLURS levels.rs:133-140。

帖子规则（只在 TimelineHomeRecommendations）

分组：OON_POST_DROPS levels.rs:147-152；站外帖子规则整体 levels.rs:348-359。

2e2295b 中，BRAZIL_ELECTION_LEGAL_DROP 仍在 VF 规则清单中。上游在 10-26 移除的是 home-mixer 的 Brazil2026ElectionFilter，不是这条 VF 规则。

例子：只在站外推荐中丢弃、对关注者放行

例 1：账号标签 DoNotAmplify。

• 规则 DO_NOT_AMPLIFY_USER_LABEL_DROP_UNSPECIFIED 只在 TimelineHomeRecommendations 的账号清单中（levels.rs:65-72、levels.rs:331）。
• 它的 audience 是 NonFollowers（author_rules.rs:239-244）。
• 结果：关注者在 For You 的站内部分照常看到帖子；非关注者在推荐中看不到；作者本人不受影响。

例 2：帖子标签 SPAM_HIGH_RECALL。

• 规则 SPAM_HIGH_RECALL_DROP_UNDESIRABLE 的 audience 是 NonAuthors（tweet_rules.rs:944-949），且只在站外级别中（levels.rs:147-152）。
• 站内候选走 TimelineHome。该级别不含这条规则，所以关注者能看到帖子。
• 例外：VF 一律按站外级别评估被引用帖与祖先帖（vf_candidate_hydrator.rs:76-81）。被引用帖带 SPAM_HIGH_RECALL 时，AncillaryVFFilter 会连带剔除引用它的站内帖（vf_candidate_hydrator.rs:155-160）。

例 3：FOSNR_ABUSE_INSULTS。在 For You 两个级别中，它只在站外级别作为 Drop 出现（levels.rs:359）。在 TimelineHomeHydration 级别中，它拆成两条规则：对非关注者 Drop，对关注者 SoftIntervention（tweet_rules.rs:176-199）。

国家下架与法律下架（takedown）

1. tweet entity service 合并帖子的下架原因列表 takedown_reasons：帖子自身的原因加上作者账号级的原因（takedowns/tweet-entity-service/TakedownReasonsTransform.scala:52-69）。它只查询 hasTakedown 为真的帖子（同文件 :52-55）。
2. Gizmoduck 读取账号时，先删掉“不执行”的账号级下架。这些下架包括：国家码为 xy（全球版权）的 LegalRequest / UnspecifiedReason，国家码为 xx/xy 的 BystanderReport，以及全部 Dmca（takedowns/gizmoduck/RedactUnenforcedTakedownsFilter.scala:68-78）。该过滤器挂在读过滤链的末尾（takedowns/gizmoduck/ReadFilters.scala:37）。
3. VF 用请求国家做判断（visibility-filtering/models/tweet.rs:74-139）：
   • LegalRequest(cc) 与 UnspecifiedReason(cc) 归入“法律下架”；Dmca 映射为 xy。
   • BystanderReport(cc)（第三方举报，确认违反当地法律）归入“当地法律下架”，国家码为 xx/xy 的除外。
   • 国家码等于请求国家，或为 xx/xy（全球）时，即为命中。
4. 命中后，LEGAL_TAKEDOWN_DROP / LOCAL_LAWS_TAKEDOWN_DROP 丢弃帖子，作者本人不受影响（tweet_rules.rs:244-256）。两个 For You 级别都包含这两条规则（levels.rs:310、levels.rs:343）。
5. VF 单独判断媒体地理限制，满足任一条件即命中：允许列表非空且不含请求国家；拒绝列表含请求国家（visibility-filtering/models/tweet.rs:92-98）。

请求国家来自 home-mixer 传入的 request_country_code（visibility-filtering-client/vf_client.rs:596-598）。

home-mixer 怎样调用 VF 并使用结果

flowchart LR
    SEL["TopK 选出的候选"] --> H["VFCandidateHydrator"]
    H -- "站内 id + 被转发原帖" --> L1["TimelineHome"]
    H -- "站外 id + 祖先帖 + 被引用帖" --> L2["TimelineHomeRecommendations"]
    L1 --> M["合并结果"]
    L2 --> M
    M --> F1["VFFilter: 剔除 Drop / Tombstone / NotEvaluated"]
    F1 --> F2["AncillaryVFFilter: 祖先、引用或被转发帖被丢弃时连带剔除"]

• 位置：VF 水合器是选后水合器（post-selection hydrator，在 TopK 选择之后运行），两个过滤器是选后过滤器（home-mixer/candidate_pipeline/phoenix_candidate_pipeline.rs:485-513）。只有进入 TopK 的候选才会查询 VF。
• 客户端：参数 EnableXaiVfClient 开源默认为 true，此时 home-mixer 调用 Rust VF；否则回退到 Strato 旧接口（vf_candidate_hydrator.rs:60-65、home-mixer/params/param.rs:1350-1355）。
• 批量与超时：每批 50 条，默认超时 400 ms（visibility-filtering-client/vf_client.rs:249-251）。
• 合并：同一 id 在两个级别都有结果时，站内结果覆盖站外结果（vf_candidate_hydrator.rs:108-110）。
• 剔除口径：Drop、Tombstone、NotEvaluated 被剔除；Allow、Interstitial、Avoid、Downrank 被保留（home-mixer/filters/vf_filter.rs:22-27）。
• 失败行为（依据代码推断）：
  • 响应中缺少某条帖子的结果时，客户端填入 NotEvaluated，该帖子被剔除。这是“失败即关闭”（vf_client.rs:547-565）。
  • 整批 RPC 失败时，客户端对每条返回错误（vf_client.rs:567-580）。水合器对该候选返回 Err（vf_candidate_hydrator.rs:119-121），框架不更新字段（candidate-pipeline/hydrator.rs:63-69），visibility_action 保持为空，VFFilter 保留该候选。这是“失败即放行”。
• 连带剔除：祖先帖（已墓碑化的除外）、被引用帖、被转发原帖中任一被判 Drop 或 Tombstone 时，候选本身被剔除（vf_candidate_hydrator.rs:140-170）。
• Interstitial 帖子留在信息流中。仓库中没有绘制遮罩的代码（上游 README Labeling Path 第 5 段）。
• “关注”时间线（按时间倒序）全部使用 TimelineHome（home-mixer/candidate_hydrators/vf_following_candidate_hydrator.rs:11）。

其他过滤器见 过滤流水线。

设计决策

源码锚点

• visibility-filtering/models/verdict.rs:20-29 —— Verdict 三分支
• visibility-filtering/rules/action_kind.rs:56-132 —— 七种动作的严重度与落点
• visibility-filtering/rules/levels.rs:298-361 —— For You 两个级别的规则清单
• visibility-filtering/rules/author_rules.rs:155-244 —— 站外账号标签规则
• visibility-filtering/rules/tweet_rules.rs:884-959 —— 站外帖子规则
• visibility-filtering/rules/engine.rs:38、:84-142 —— 排序与折叠
• visibility-filtering/rules/rule_spec/rule.rs:100-115 —— audience
• visibility-filtering/models/tweet.rs:74-139 —— 下架与国家判断
• visibility-filtering/treatment.rs:608-640 —— 裁定到接口动作的映射
• takedowns/tweet-entity-service/TakedownReasonsTransform.scala:52-69 —— 合并帖子与账号下架原因
• home-mixer/candidate_hydrators/vf_candidate_hydrator.rs:52-170 —— 分级调用与连带剔除
• home-mixer/filters/vf_filter.rs:22-27 —— 剔除口径

相关页面

• 过滤流水线 —— home-mixer 全部过滤器
• 打标签规则 —— scarecrow 与 botmaker 如何写入标签
• 账号级信号 —— agatha、bdsm、user-cred-v2
• 处置与标签聚合 —— abuse-enforcement-service、safety-label-user-agg
• Under the Hood 透明度报告 —— 用户能看到哪些标签
• Grox 分类器、媒体模型 —— 帖子标签的模型来源
• 限流与 shadowban —— 白话版