Skip to content

[PR] docs: Minor Documentation Fixes, Part 4 — 6 pure documentation/disclosure fixes bundled for review | docs: 文档小修合集第四辑 —— 6 件纯文档/披露类小修合并送审 - #5918

Merged
ranxianglei merged 6 commits into
masterfrom
2026-11-08_docs-small-patches-batch
Nov 8, 2026
Merged

ranxianglei merged 6 commits into
masterfrom
2026-11-08_docs-small-patches-batch

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

(ai: sglang-gpu0/qwen3.8-27b)

本 PR 把 6 件已评审、可直接合并的纯文档小修合并送审(每件一个 commit,按原 PR 标注出处)。全部来自 #3916 状态板的 ✅ 可合行,已逐件对最新 master(6df7ae1)重验。

内容(6 件,共 +22/−4 行,8 个文件)

commit 内容 原 PR 关联 issue 文件
claude 车道文档披露:base-URL 路由会使账号绑定功能(Remote Control 等)失效 + 安装时提示 #4709 Refs #4693 README×2、src/plugin-install.ts(安装输出文案)
omp advisor(第二模型后台流)会话隔离方法入档 #5568 Refs #5567 README×2
opencodex(ocx)作为上游网关的接法入档 #5829 — README×2
pi-claude-bridge 压缩状态不跨 reopen/resume 的机制披露 #3553 Refs #3429 CLIENTS×2
website 命令区补 bili sessions / bili storage gc 两行(en+zh) #4565 Closes #4562 website/docs/index.html、website/main.js
AGENTS.md 贡献清单注明 kernel 机械缺陷豁免条款(已合入的 #5819 的清单侧补充) #5822 — AGENTS.md(1 行)

处理说明

本地预检

合并后

@github-actions

github-actions Bot commented Nov 8, 2026

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-11-08_docs-small-patches-batch (6defe80)

Latest build — install this exact version

npm install -g billion-context@0.0.8585-pr.5918.0f68ea9

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
6defe80 billion-context@0.0.8585-pr.5918.0f68ea9 build

Download artifact

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

Install instructions are refreshed on each push.

@ranxianglei ranxianglei changed the title docs: 文档小修合集第四辑 —— 6 件纯文档/披露类小修合并送审 [PR] docs: Minor Documentation Fixes, Part 4 — 6 pure documentation/disclosure fixes bundled for review | docs: 文档小修合集第四辑 —— 6 件纯文档/披露类小修合并送审 Nov 8, 2026
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

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

查重: 不重复(有意合并送审,非误立) —— 本 PR 是 #3916 状态板 ✅ 可合行的整合载体,内容覆盖 6 个仍 open 的上游源 PR(#4709 / #5568 / #5829 / #3553 / #4565 / #5822)。方向上这是 owner 状态板驱动的收敛,不是并行重复立项;但有一个协调风险要提示:若任一源 PR 先被合并(尤其目前 dirty 状态的 #4709、#5822),本 PR 需要 rebase——内容相同不构成行为冲突,最坏是某 commit 变空 diff。建议本 PR 合并后由 owner 逐个关闭那 6 个源 PR(#5353 除外,它被 master ad66e2e35f(#5173)的注释取代,排除处理正确,我也已对 master 现文逐句核对过)。按 agent 政策我不自行关闭任何 PR。

标签: p3, pr, scope/docs(纯文档合集;沿用同类 docs PR 先例 5831/5823 的打法,多车道文档包不打单个 lane 标)

初审进行中,已逐 commit 读完全部 6 件(+22/−4,8 文件,与描述一致),并逐条独立核对了文档里的事实性断言:

CI(head 6defe80):46 项 check 中 44 项已绿(success/skipped),剩 2 个 test 分片 in_progress(ubuntu 22 shard 3、windows 22 shard 4),无失败项。等全绿后我按结构化八问给最终结论,如有问题会当场指出。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

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

CI 已全绿,审核完成。结论:可合并。 head 6defe80 的 47 项 check run 全部完成:35 success / 12 skipped(门控 e2e 车道,正常)/ 0 失败。注:GitHub 卡片当前仍显示 mergeable_state=blocked,但逐项 check 无一红——应是分支保护评审要求或状态计算滞后,合并时留意即可。

结构化八问

  1. 是什么问题:不是 bug,是 6 件纯文档/披露修复的合集送审——补齐 claude 车道「base-URL 路由致账号绑定功能(Remote Control)失效」披露、omp advisor 会话隔离方法、ocx 网关接法、pi-claude-bridge 压缩状态不跨 reopen/resume 的机制说明、website 命令区缺的 bili sessions / bili storage gc 两行、AGENTS.md 贡献清单漏掉的 kernel 机械缺陷豁免交叉引用。
  2. 什么原因导致的:各机制/命令早已落地(Installing billion-context removes '/remote-control' command from claude-code #4693/[Bug][omp] Identity cross-talk between advisor and main session, causing DEAD refs, fold drift, and repeated compaction | [Bug][omp] advisor 与主会话身份串扰,导致 DEAD refs、fold drift 和反复压缩(0.1.212) #5567/Pi + claude-bridge: native sends no model requests to proxy; launcher compress returns 404 #3429//docs/ command section is missing the bili sessions / bili storage gc shipped on Oct 20. | /docs/ 命令区漏了 10-20 上线的 bili sessions / bili storage gc #4562 等源 issue),但文档当时没跟上;本 PR 只补文档,不改任何运行时逻辑(唯一例外见第 5 问)。
  3. 影响范围与严重程度:纯文档 + 一句安装输出文案;零运行时行为影响;p3 级,无用户受损面。
  4. 怎么修复的:6 个独立 commit 各自对应一个已评审源 PR,逐件对最新 master(6df7ae15)重验后搬运;README claude 行冲突按并集解(Installing billion-context removes '/remote-control' command from claude-code #4693 段在前、Claude Code sub-agents of the same type share a single compaction lane: unrelated sessions bleed content into each other | Claude Code 同类型子代理共用一条压缩车道:无关会话互相串内容、折叠暂停;旧版共享父 id 的折叠块升级后仍残留在父会话 #5095 SubagentStart 句收尾,两句都保留,我已逐字核对);[PR] docs: align dshTimeContextPath comment with code fact (#5352 finding 2) #5353 排除——master ad66e2e35f(The "most recent user message" slot in the protected zone was preempted by a system-injected prompt, causing the just-is | 保护区「最近一条 user 消息」被系统注入提示抢占,导致刚下达的用户指令被压缩 #5173)已按同一意图且更精细地改过该注释,再合会覆盖新注释;原 PR 的 lockfile 版本漂移未带入(含 [PR] docs(website): add the missing bili sessions / bili storage gc rows to the Commands section #4565 的两个 lock 文件,我核过它的文件清单)。
  5. 是否有回归问题:审过的既有行为——README×2 / CLIENTS×2 / AGENTS.md / website 两文件全部为纯新增或段落内插入,插入点两侧的原有句子逐一比对保留完整;i18n 新键 cmd.sessions/cmd.storage 在 en/zh 字典与 HTML 引用两侧对称。唯一用户可见变更:src/plugin-install.ts claudeInstall() 返回值追加一句英文披露 → bili plugin install claude 的输出多一行(旧值:无此句 → 新值:追加 Remote Control 提示,原因:与其文档内容一致的安装时告知)。无 fail-fast→吞错、阈值/时序/格式漂移类高危模式。
  6. 是否破坏缓存:不涉及(未触碰任何运行时路径)。
  7. 是否改了设计方向:不涉及。
  8. 是否引入了新的配置:不涉及(无新 env/config/默认值)。

独立核实清单(非复读 issue 结论)

协调提醒(合并后待 owner 处置)

本 PR 合并后,以下 7 个上游 PR 由 owner 关闭(agent 不自行关):#4709、#5568、#5829、#3553、#4565(其全部内容已含入并 Closes #4562)、#5822、#5353(已被 master 取代)。反向风险同样提示:若其中任何一个先被合并,本 PR 需 rebase(内容相同,最坏某 commit 变空 diff,无行为冲突)。

判定:可合并(合并动作按政策由 owner 执行;我无法代合)。

@ranxianglei
ranxianglei merged commit 2c97e81 into master Nov 8, 2026
82 of 117 checks passed
Louie0806 added a commit to Louie0806/billion-context that referenced this pull request Nov 8, 2026
… and the docs patches

Upstream delta 6df7ae1..354e21e (11 files, 9 commits):
- bcce47b fix(dsh): await ACP tool registration before releasing activation (PR ranxianglei#4136, fixes ranxianglei#4134)
- 4913153 fix: native liveness log says re-attach when the probe can self-heal (PR ranxianglei#5828)
- 2c97e81 Merge pull request ranxianglei#5918 (docs small patches: kernel-boundary checklist,
  bili sessions / storage gc command rows, pi-claude-bridge reset disclosure,
  opencodex gateway, omp advisor isolation, claude base-URL routing disclosure)
- 354e21e Merge pull request ranxianglei#5921

Lane overlap is only website/docs/index.html and website/main.js, both generated
artifacts; the merge was automatic and the docs fixed point was re-verified on the
merged tree with `node tools/gen-config-docs.mjs generate` (zero diff).

kernel stayed at 0.0.187; the tree was rebuilt before measuring.
Post-merge spot-check: src/server/relay.ts:2070 still calls `pipePluginJson(toClient,
res, undefined, prepared.protocol, ...)`, src/storage/mysql.ts:77 still exports
`MYSQL_SCHEMA_VERSION`, and the six lane symbols are intact (stripDriftResidue 6,
isDraftDump 6, containsRenderTagText 21, mayStartDegenerateRenderTag 6,
DRIFT_BARE_MISMATCH 3, DRAFT_CLOSE_TAIL 3).

Gates: tsc 0, four guards 0, gen-config-docs fixed point.
Tests: issue5175 58/0, tag-echo 79/0, issue2190 32/0, golden-storage-render 5/0,
storage-engine-proofs 12/0, native-compact-terminal 1/0, issue4666 2/0,
issue3654-health-probe-three-state 1/0, dsh-native 75/0.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

1 participant