Skip to content

[PR] docs(website): add the missing bili sessions / bili storage gc rows to the Commands section - #4565

Closed
ranxianglei wants to merge 5 commits into
masterfrom
2026-10-24_docs-sessions-storage-cmds
Closed

ranxianglei wants to merge 5 commits into
masterfrom
2026-10-24_docs-sessions-storage-cmds

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

/docs/ 的 Commands 一节漏了 2026-10-20 随 #3928 上线的两条命令:bili sessions ls|rm|archive|restore <id> 和 bili storage gc [--days N] [--dry-run]。参数参考表有 CI coverage 守卫不会漂,手写命令区没有守卫——这处已漂。补两个 dt/dd + main.js EN/ZH 字典各两条 cmd.* 文案(措辞取自 cli.ts HELP 原文)。node --check main.js 通过。小问题直接修级别,单独成 PR 仅为与 #4561 的功能改动分离 scope。

Closes #4562

…o the Commands section (#3928 shipped them on 2026-10-20, the page never caught up)
@github-actions

github-actions Bot commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-24_docs-sessions-storage-cmds (d505f9f)

Latest build — install this exact version

npm install -g billion-context@0.0.6177-pr.4565.7420751

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Recent builds (commit → version)

commit version build
d505f9f billion-context@0.0.6177-pr.4565.7420751 build
302adfd billion-context@0.0.6091-pr.4565.5cb5582 build
fb5a37d billion-context@0.0.5994-pr.4565.68a1ed9 build
34c1fc1 billion-context@0.0.5512-pr.4565.5d5ec4e build

Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr4565.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei ranxianglei changed the title docs(website): add the missing bili sessions / bili storage gc rows to the Commands section [PR] docs(website): add the missing bili sessions / bili storage gc rows to the Commands section Oct 24, 2026
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

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

查重:不重复。 本 PR 就是 #4562(Commands 一节漏两条命令)的修复,检索 open/closed issue 与 PR 无其他条目覆盖此缺口。

标签: pr + scope/docs + p3(文档补漏、非缺陷;不涉及客户端车道;轻微缺口)。已打好。

代码与 CI 都审过(不只读描述)。结论先行:diff 干净、无回归、可合;head 上的红全部是存量问题,证据见下。

Diff 审查(主关)

  • 总 diff 6 行、2 个文件:website/docs/index.html 的 Commands 一节加两条 dt/dd(紧接 bili export 之后,位置合适);website/main.js 的 EN/ZH 字典各加 cmd.sessions / cmd.storage。
  • 措辞对照 src/cli.ts 的 HELP 原文核对:一致。sessions 行用 [id],与 cli.ts 的 usage 头一致(issue 正文写的是 <id>,PR 的写法更准)。
  • 两个新 i18n key 各恰好出现两次(EN+ZH),均被 HTML 的 data-i18n 引用,无孤儿/重复 key;node --check main.js 通过。
  • 小观察:bili storage gc 的 dt 未列 --vacuum full|incremental——与 /docs/ command section is missing the bili sessions / bili storage gc shipped on Oct 20. | /docs/ 命令区漏了 10-20 上线的 bili sessions / bili storage gc #4562 定的范围一致(参数参考表有 CI 守卫、覆盖全部 flag),可接受。

回归审查(整体关)

  • 触碰路径的既有行为清单:website Commands 区渲染 + i18n 字典查找。逐项判定:纯新增,既有行未动、字典结构未动、无语义漂移;不碰任何运行时路径,缓存/重试/时序不受影响。

CI 判定(关键证据)

八问

  1. 是什么问题:网站 Commands 一节漏了随 CLI surface for storage maintenance: bili sessions ls/rm/archive/restore + bili storage gc (re-scoped from #3860) #3928 上线的 bili sessions … 和 bili storage gc 两条命令,手写命令区与 cli.ts 漂移。
  2. 什么原因导致的:参数参考表有 CI coverage 守卫所以不漂,手写 dt/dd 区没有守卫机制,CLI surface for storage maintenance: bili sessions ls/rm/archive/restore + bili storage gc (re-scoped from #3860) #3928 上线时没人同步这处——流程缺口,不是代码缺陷。
  3. 影响范围与严重程度:仅文档缺口;照 Commands 一节查命令的用户看不到这两条命令;无功能影响,体验瑕疵级(p3)。
  4. 怎么修复的:直接补齐两条 dt/dd + 四条 i18n 文案,措辞取自 cli.ts HELP 原文。
  5. 是否有回归问题:无。纯新增静态页面文本,既有行为清单逐项核过(见上)。
  6. 是否破坏缓存:不涉及(静态站点文本,无运行时路径)。
  7. 是否改了设计方向:不涉及。
  8. 是否引入了新的配置:不涉及。

判定:可合。 内容干净最小、无回归;head 上的 8 个红 shard 是 base 时点的存量问题(证据如上),master 自身现已全绿。建议 rebase 到当前 master 后合并(或直接合由 GitHub 生成 merge commit,两种都不影响 master 绿)。合并操作由 owner 执行。

另发现一项(已按规则处置,不阻塞本 PR):master 的 pages deploy job 持续红(GitHub Pages 从未启用,#3189 的自动启用被 revert 后 workflow 悬空)→ 已单独立项 #4598,止血选项供拍板。

ci-check added 4 commits October 26, 2026 10:18
master window commits 293ae65/de5e03659 bumped kernel/package.json to
0.0.165 without regenerating the lockfiles; lock-sync re-resolution then
rewrites the stale recorded versions (root 0.0.163, kernel 0.0.164) and
fails. Pure recorded-version sync via npm install --package-lock-only;
no dependency or semantic change.
@ranxianglei

Copy link
Copy Markdown
Owner Author

(ai: sglang-gpu0/qwen3.8-27b)
本 PR 的全部内容已随合集 PR #5918 合入 master(2026-11-08),此 PR 重复,关闭。

@ranxianglei ranxianglei closed this Nov 8, 2026
Louie0806 pushed a commit to Louie0806/billion-context that referenced this pull request Nov 8, 2026
@github-actions github-actions Bot mentioned this pull request Nov 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

1 participant