[Root Cause] docs (auto-maintained, do not close manually) | [根因] docs（自动维护，勿手动关闭） #6337

Activity

1. ranxianglei

   added

   root-cause-batch

   on Nov 12, 2026
2. ranxianglei

   changed the title [-][根因] docs（自动维护，勿手动关闭）[/-] [+][Root Cause] docs (auto-maintained, do not close manually) | [根因] docs（自动维护，勿手动关闭）[/+] on Nov 12, 2026
3. ranxianglei commented on Nov 12, 2026

   

   ranxianglei

   on Nov 12, 2026

   OwnerAuthor

   More actions

   🤖 Powered by ework · qwen3.8-27b

   [bot] 🏷

   查重: 不重复（本批三个 issue 各自独立，无同症状/同机制重复项）。

   核心发现：这个 "docs" 根因批是粗粒度误分组——三个 issue 性质完全不同，无法用一个 docs PR 诚实覆盖。

   逐个核对（已查证，非凭描述）：

   • GitHub Billion-context documentation addendum: nudge is independent of window occupancy. | billion-context 文档补充：nudge 与窗口占用无关 #5893（nudge 与窗口占用无关的文档补充）→ 纯 docs 补充，已有 PR [PR] docs: clarify that frequent nudges are independent of window occupancy (#5893) #5896（docs-only，open，behind 需 rebase）。方向一致。
   • GitHub 提案：快照表式压缩底座（六段固定链，单一存储真源） #5874（快照表压缩地基设计提案）→ 这不是 docs 修复，是代码 PR。已有 PR [PR] storage: snapshot table compression foundation P0+P1 (schema v12 4-table + shadow write, all off by default, zero behavi | storage: 快照表压缩底座 P0+P1（schema v12 四表 + 影子写，默认全关、零行为变化） #5901（P0+P1 存储地基：schema v12 四表 + 影子写，全关，零行为变更，clean）。设计提案本体在等 owner 拍板，代码实现走 [PR] storage: snapshot table compression foundation P0+P1 (schema v12 4-table + shadow write, all off by default, zero behavi | storage: 快照表压缩底座 P0+P1（schema v12 四表 + 影子写，默认全关、零行为变化） #5901。把它放进 "docs" 批是误分组。
   • GitHub [claude] /remote-control and compression can coexist via the cert-MITM lane (corrects #4693) | claude 走 cert-MITM 车道可同时保留 /remote-control 与压缩（修正 #4693） #5775（claude /remote-control + 压缩共存）→ 功能请求（等 owner 拍板 A/B）+ 文档勘误（可立即做）。

   已核实的真实文档缺陷（#5775 建议 #2）：EN/ZH 不一致——EN docs/configuration.md（2327/2432 行）已修正为「旧版 claude 忽略代理环境变量，新版（如 2.1.301）遵循 HTTPS_PROXY」；但 ZH docs/configuration.zh-CN.md（2294/2399 行）仍写死「claude 的 undici fetch 忽略 HTTPS_PROXY」——EN 早已细化的过时绝对前提。三个 README（EN/ZH/JA）的 #4693「Remote Control 不可用」注释同样基于此过时前提。

   进行中：做 #5775 的文档勘误（修 ZH 过时前提 + 更新三个 README 的 #4693 注释，指向 #5775 的证书 MITM 姿态），开一个聚焦 docs PR。#5893 走 PR #5896、#5874 走 PR #5901（代码），不在本 docs PR 范围。PR 链接稍后补。
4. ranxianglei commented on Nov 12, 2026

   

   ranxianglei

   on Nov 12, 2026

   OwnerAuthor

   More actions

   🤖 Powered by ework · qwen3.8-27b

   [bot] 🏷

   **PR 已开:https://github.com/ranxianglei/billion-context/pull/6348**(纯 docs,4 文件 6 行,零行为变更)

   改了什么:

   • docs/configuration.zh-CN.md:2294/2392/2399 —— 把 ZH 写死的「claude 的 undici fetch 忽略 HTTPS_PROXY」过时绝对前提,对齐 EN 已细化的表述(旧版忽略代理环境变量、新版如 2.1.301 遵循 HTTPS_PROXY + NO_PROXY 回环合并 [Bug] bili claude: Claude Code 2.1.301 honours HTTPS_PROXY, so the /bili/ base URL self-tunnels (403 tunnel_destination_denied: self) #3446)。
   • README.md / README.zh-CN.md / README.ja.md 的 Installing billion-context removes '/remote-control' command from claude-code #4693「Remote Control 不可用」注释 —— 把「没有别的拦截点能绕过 CC 的 undici 栈」的过时框架,改为「证书 MITM 姿态(新版遵循 HTTPS_PROXY,[claude] /remote-control and compression can coexist via the cert-MITM lane (corrects #4693) | claude 走 cert-MITM 车道可同时保留 /remote-control 与压缩（修正 #4693） #5775 跟踪)可保留这些功能」。

   为什么一个 PR 覆盖不了整批 —— 这个 "docs" 根因批是粗粒度误分组,三个 issue 性质不同(已逐个查证):

   • [claude] /remote-control and compression can coexist via the cert-MITM lane (corrects #4693) | claude 走 cert-MITM 车道可同时保留 /remote-control 与压缩（修正 #4693） #5775(claude remote-control):功能请求 + 文档勘误。本 PR 只做了文档勘误部分(建议 fix: address all code review findings (condense, routing, session-id, dead code) #2);功能本体(bili claude --mitm 车道,建议 fix: keep system prompt byte-stable for prefix cache #1)在等 owner 拍板(A 完整车道 / B 仅文档),未实现,所以本 PR 不 Fixes [claude] /remote-control and compression can coexist via the cert-MITM lane (corrects #4693) | claude 走 cert-MITM 车道可同时保留 /remote-control 与压缩（修正 #4693） #5775。
   • Billion-context documentation addendum: nudge is independent of window occupancy. | billion-context 文档补充：nudge 与窗口占用无关 #5893(nudge 文档补充):纯 docs,已有 PR [PR] docs: clarify that frequent nudges are independent of window occupancy (#5893) #5896(open,behind 需 rebase),不在此重复。
   • 提案：快照表式压缩底座（六段固定链，单一存储真源） #5874(快照表设计提案):不是 docs 修复,是代码 PR [PR] storage: snapshot table compression foundation P0+P1 (schema v12 4-table + shadow write, all off by default, zero behavi | storage: 快照表压缩底座 P0+P1（schema v12 四表 + 影子写，默认全关、零行为变化） #5901(P0+P1 存储地基,schema v12 四表 + 影子写,全关零行为,clean)。设计提案本体在等 owner 拍板。归入 "docs" 批是误分组。

   结构化八问:

   1. 是什么问题:ZH 配置文档与三个 README 的 Installing billion-context removes '/remote-control' command from claude-code #4693 注释仍写死「claude 忽略 HTTPS_PROXY」这一 EN 早已细化的过时前提,EN/ZH 不一致。
   2. 什么原因导致的:EN 文档在 [Bug] bili claude: Claude Code 2.1.301 honours HTTPS_PROXY, so the /bili/ base URL self-tunnels (403 tunnel_destination_denied: self) #3446 时已把「忽略 HTTPS_PROXY」细化为「旧版忽略、新版遵循」,但 ZH 文档与 README 注释未同步跟进,残留旧版绝对表述。
   3. 影响范围与严重程度:仅文档/README,无外部行为影响;读 ZH 文档或 README 的用户会拿到过时的「claude 无法走代理」结论,可能误判证书 MITM 不可行。体验瑕疵级。
   4. 怎么修复的:把 ZH 三处 + 三个 README 的 Installing billion-context removes '/remote-control' command from claude-code #4693 注释对齐 EN 的细化表述,并在 Installing billion-context removes '/remote-control' command from claude-code #4693 注释里指向 [claude] /remote-control and compression can coexist via the cert-MITM lane (corrects #4693) | claude 走 cert-MITM 车道可同时保留 /remote-control 与压缩（修正 #4693） #5775 的证书 MITM 姿态(可保留账号绑定功能)。
   5. 是否有回归问题:不涉及 —— 纯文档措辞,无代码/行为/阈值/时序/输出格式变更。
   6. 是否破坏缓存:不涉及。
   7. 是否改了设计方向:不涉及 —— 未改架构/边界/数据流;仅文档措辞对齐 + 指向既有跟踪 issue。
   8. 是否引入了新的配置:不涉及。

   收工判定:PR #6348 可独立合入(纯 docs 措辞对齐,零行为变更)。整批三个 issue 按实际性质分流:#5893 走 #5896、#5874 走 #5901(代码)、#5775 文档部分由本 PR 覆盖(功能部分待 owner 拍板)。「一个 docs PR 修整批」的前提(三者同属 docs)不成立。
5. ranxianglei

   closed this as not plannedon Nov 12, 2026