Skip to content

[bug] docs-sync CI red on master: CONFIGURATION.md carries a pluginLaneServerHistory line the config-docs generator no longer emits #4530

Closed

Description

@ranxianglei

来源: #2411 分析 PR #2415 CI(rebase 到 c81c17d 后刷绿验证)时发现

查重: 无(open/closed 全搜 docs-sync / gen-config-docs / artifact drift,无匹配;#2411 线程里 ezjbc 已口头标记此现象为 master 侧待修项,但无独立 issue)。

现象

根因(本地复现 + 定位)

node tools/gen-config-docs.mjs generate 在纯 master(worktree @ c81c17d)上产出确定 diff:CONFIGURATION.md 与 CONFIGURATION.zh-CN.md 各删一行——

-| `rollout.features.pluginLaneServerHistory` | boolean \| number | 0 (off) | BILI_ROLLOUT_PLUGIN_LANE_SERVER_HISTORY | Plugin-lane server-owned history (#4491): ... |

而 grep -rn pluginLaneServerHistory website/config-reference/ = 零命中:该行的种子条目不存在。即 #4491(plugin-lane server history)的文档行进入了提交的 CONFIGURATION.md,但其 seed 从未加入(或加入后被移除)→ 生成器输出与提交文档永久失配 → docs-sync 对每个 PR 恒红。

影响

  • 所有 PR 的 docs-sync 门禁恒红(非本行变更引起),合并前必须人工归因放行;持续掩盖真实漂移信号。

建议修复(二选一,需 #4491 作者/owner 确认意图)

  1. 补 seed(若 Plugin lanes: pin identity to client msgids, render outbound from the server-owned history | 插件车道服务端正史:消息身份钉在客户端 id 上,出站前缀由正史渲染 #4491 需要该配置被文档化——推荐,功能已在代码里且用户可见):在 website/config-reference/ 对应 yaml 加 rollout.features.pluginLaneServerHistory 条目(类型 boolean | number、默认 0、env BILI_ROLLOUT_PLUGIN_LANE_SERVER_HISTORY),再生成。
  2. 删陈旧行(若该功能暂不文档化):直接跑 generate 提交结果(两文件各 -1 行)。

两种都是几行级修复。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions