Skip to content

Stale Item Cleanup: Transitional Feature Flag Ledger + Decommissioned Module Inventory + Remote Branch Hygiene (suitable for ework) | 陈年件清理:过渡开关台账 + 退役模块盘点 + 远端分支卫生(适合 ework) #3249

Closed

Description

@ranxianglei

来源:2026-10-15 机器/仓库陈年清理(已手工做掉一批,见文末)。本 issue 把仓库侧的陈年件收敛成台账+清理计划,交给 ework 执行;机器侧纪律见下。

仓库侧(ework 可做)

1. 过渡开关/盖子台账(先立账,再逐个定生命周期)

现在散落着若干「临时盖子 / opt-in 开关」,没有统一台账,没人知道哪些已到期:

每项台账字段:引入 PR / 引入原因 / 解除条件 / 状态。只立账不删,删除逐项拍板。

2. 退役模块盘点

3. 远端分支卫生

  • 已合并 PR 的远端 2026-10-* 分支批量删除(约 15+ 条,GitHub 已有 auto-delete head 的 PR 但手工推过的分支不在其列);
  • 本地 worktree 残留(git worktree prune 一次)。

机器侧(本次已做,记录供重复使用)

2026-10-15 手工清理:11 个陈年 bili 进程(各时代,全部零活跃连接才杀)/ /tmp 清 2.2GB / master-wt worktree 421MB / 20 个已合并本地分支 / index.db 旧归档。保留:本会话 lane、dsh web 车道、用户 10-14 新起的两个 lane。不做自动化(杀进程需要人眼判断连接归属,自动化风险大于收益),只在每次大版本装机后人工过一遍。

验收

Activity

  1. ranxianglei commented on Oct 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    查重:不重复。 检索过 open+closed issue/PR(关键词:台账/LIFECYCLE/环境变量清理/退役/persona-anchor/孪生):无同类在途条目。相关但不同的追踪项——#2926(threads-lane 盖子 tracking)、#2989(persona-anchor 孪生化)、#3248(增量车道)——都是本 issue 台账要登记的条目本身,不是重复立项。

    开工计划(按 issue 三段走):

    1. 开关台账:grep 全量 process.env.BILI_*,逐项溯源引入 PR/原因/解除条件,落 LIFECYCLE.md(独立文档,CONFIGURATION.md 挂指针),另加一个 CI 检查脚本「源码里出现但台账没登记的新 BILI_*」→ 红。只立账不删。
    2. 退役模块盘点:persona-anchor.ts 的 import 面、fold-reconcile.ts legacy 路径、全仓 TODO(#NNNN)/deprecated 标记清点,结果写进同一份 LIFECYCLE.md 的「退役待办」节(删除动作仍逐项拍板,不在本 PR 动)。
    3. 远端分支卫生:直接执行(非代码变更)。规模比 issue 预估大:origin 上共 1754 个 head,其中 2026-10-* 有 656 个;且绝大多数合并是 squash-merge(git 层 --merged 判定为 0),所以我会用 GitHub PR 数据(head ref → merged/open)逐一定性,只删「PR 已 merged」或「commit 已全部进 master」的分支,open PR 的 head 一律保留。本地 git worktree prune 一次(只清目录已消失的残留,不动其他会话的活 worktree)。

    台账与盘点进一个 PR(Closes #3249 的前两项验收);分支删除是仓库运维动作,做完在本线程报告清单。开始干活。

  2. ranxianglei commented on Oct 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    仓库侧三段全部做完,代码交付在 PR #3256:https://github.com/ranxianglei/billion-context/pull/3256(查重结论见本 issue 首条回复:不重复,#2926/#2989/#3248 是台账引用的跟踪项)。

    1. 是什么问题:仓库里散落着若干「临时盖子/opt-in 开关」没有统一台账,没人知道哪些已到期;退役模块和远端分支的陈年件也没有收敛。
    2. 什么原因导致的:开关逐个随事故/实验引入(#1706、#2671、#2884…),引入时没有「解除条件」字段,到期与否全靠记忆;分支卫生靠 GitHub auto-delete 只覆盖 UI 创建的分支,手工推过的不在其列。
    3. 影响范围与严重程度:纯治理问题,无运行时影响。风险面是「盖子悄悄过期」——典型如 BILI_STREAM_STALL_MS 已退役但代码还在读它发警告;BILI_ANTHROPIC_THREADS_INJECT 的盖子其实还没落 master(在开放 PR #2888 上),台账里已按此记录。
    4. 怎么修复的:① 新文档 LIFECYCLE.md——§1 过渡开关台账 26 行(每项:引入 PR / 原因 / 解除条件 / 状态)、§2 src/ 实际读取的 126 个 BILI_* 全量登记、§3 非环境标识符清单、§4 退役模块盘点、§5 卫生记录;② 零依赖守卫 scripts/lifecycle-ledger-guard.mjs + ci.yml 新 job:src/ 读到而台账没登记的 BILI_* 直接红(stale 只 notice,与 config-surface-guard 同姿态);③ 远端分支卫生已执行:删 origin 已合并分支 1394 条(1386 已合并 PR head + 8 无 PR 记录但完全并入 master),删除前核对 open PR head 交集为空,之后 origin 剩 361 head(全部未并入);git worktree prune 清掉失效登记。只立账不删,每个开关的去留等你逐项拍板。
    5. 是否有回归问题:无——PR 只动文档/脚本/CI,运行时行为零变化;唯一新增行为是新 CI 门禁本身(漏登新变量会红,这是目的)。守卫首跑抓到两个真实漏登(BILI_MITM、BILI_SESSION_GC 两个总开关),说明门禁有牙。
    6. 是否破坏缓存:不涉及。
    7. 是否改了设计方向:不涉及;补了一条边界:reference/env-vars.md 明确「旋钮能不能存在」归 env-vars 纪律管、「已有旋钮生命周期」归 LIFECYCLE.md 管。
    8. 是否引入了新的配置:无新增旋钮/env/config;只把既有变量登记成文。

    盘点中发现的几个事实(供拍板参考):

    验收状态:项 1 ✅(台账+CI)、项 3 ✅(已合并分支清零)、项 2 仍 gated 在 #2989(§4 跟踪)。判定:PR #3256 可合;issue 待 #2989 完成后关。

  3. ranxianglei commented on Oct 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    PR #3256 首跑 CI:lifecycle-ledger-guard ✅ 一次通过(docs-sync / docs-coverage / config-surface-guard 全绿)。unused-exports 红是我新脚本的三个 helper 多写了 export(文件内部用,无外部导入)——已在 40ecabdf0 去掉重推,本地该门禁已干净。其余长测试 lane 继续跑。

  4. ranxianglei commented on Oct 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    CI 全绿,可以合了。 PR #3256 首跑唯一红的是 test (windows-latest, 22, 2) shard:tests/issue1452-socket-hardening.test.ts:405「retired stall guard」断言 first chunk should have flowed through,耗时 63s 的真实 socket 时序测试。与本 PR 无关(diff 零 src/ 零 tests/),同代码 rerun-failed-jobs 后同一 job 转绿 ⇒ 偶发时序 flake。已按纪律立项 #3259(带来源标记 + 失败签名 + 查重声明),不塞进本 PR。

    收工状态:

  5. changed the title [-]陈年件清理:过渡开关台账 + 退役模块盘点 + 远端分支卫生(适合 ework)[/-] [+]Stale Item Cleanup: Transitional Feature Flag Ledger + Decommissioned Module Inventory + Remote Branch Hygiene (suitable for ework) | 陈年件清理:过渡开关台账 + 退役模块盘点 + 远端分支卫生(适合 ework)[/+] on Oct 16, 2026
  6. added
    其他改动范围:内核之外的主机侧接线(src/agent 适配器、server 路由、注入拦截)/范围兜底/客户端标签
    on Oct 18, 2026
  7. added 6 commits that reference this issue on Oct 23, 2026
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

    p3其他改动范围:内核之外的主机侧接线(src/agent 适配器、server 路由、注入拦截)/范围兜底/客户端标签重构

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions