来源: ranxianglei/billion-context#2148 (https://github.com/ranxianglei/billion-context/issues/2148) PR #2151 (https://github.com/ranxianglei/billion-context/pull/2151) 的 CI 失败分析时发现 ## 现象(可确定性复现) 在任何 sessions 目录从未被创建过的干净环境(全新安装 / 全新 CI runner)中,`/__bili/overview` 与 `/__bili/sessions` 返回 **500**: ``` [error] [acp-web] overview failed: Error: ENOENT: no such file or directory, scandir '<HOME>/.local/share/billion-context/sessions' ``` 复现:把 HOME 指向空目录后跑 `node --import tsx --test tests/advisory-endpoint-parity.test.ts` → 与 CI 完全同错;HOME 已有 sessions 目录 → 通过。CI 证据:master @ 4af31e0a 与 PR #2151 @ 77191de8 四个 test lane(ubuntu/windows × node22/24)全部挂在同一测试(#2153 的 parity test):`/__bili/overview answers 200` → 实际 500。 ## 根因 - `walkSessionFiles`(src/web/sessions-data.ts:198)对顶层 readdir 失败**有意抛出**(doc comment:让调用方区分「无数据」与「不可读」); - 但唯一调用方 `refreshIndex` 的 catch(src/web/sessions-data.ts:317–320)**没有做这个区分**:`if (!byFile) throw error;` —— 干净环境的第一次刷新没有旧索引,ENOENT 被原样上抛 → `mergedSummaries` reject → `buildOverview` / `buildSessionList` / `buildSessionPage` 全 reject → 端点 500; - sessions 目录只在首次 persist 时创建(persist.ts),启动时不建 → 全新安装(尚无任何已存会话)必然踩中。 引入自 e0ef92a16(#1939 系「bound web admin session loading」);#2153 的 parity test 首次在 fresh runner 上打 `/__bili/overview`,CI 随即变红。 ## 影响 1. 全新安装的 web dashboard 在首个会话落盘前,overview/sessions 端点 500(用户看到错误横幅); 2. CI 四个 test lane 持续红,master 与所有新 PR 都被这个红挡住(与各自 diff 无关)。 ## 修复(PR #2151 内独立 commit) `refreshIndex` catch 按 errno 区分:**ENOENT → 空索引**(byFile/byId 置新 Map,即 doc comment 本意要区分的「无数据」态);其余错误(EACCES 等)保持现状——无旧索引 fail-fast 抛出、有旧索引 warn + 继续服务旧索引。已有目录的正常路径零变化;parity test 在 fresh/既有两种环境都确定性通过。
Activity
fix(web): first contact with a missing sessions dir is no data, not a…
ranxianglei commentedon Oct 5, 2026
[bot] 🏷 已修复并验证 — 修复已作为独立 commit
6abecdd7c落在 PR #2151 分支上(按 issue 指定的方式),CI 全绿。过程说明:本会话独立完成了根因复核与修复实现(与 issue 方案一致),推送时发现并行 agent 会话已把等价修复推到了同一分支(
6abecdd7c,loop guard:一个 issue 一个 PR,不重复提交)。我改为对已落地的 commit 做完整独立验证,未推重复 commit。两处实现的差异见第 4 条。结构化七问:
/__bili/overview与/__bili/sessions在首个会话落盘前返回 500,用户看到错误横幅。walkSessionFiles(src/web/sessions-data.ts:198)对顶层 readdir 失败有意抛出,doc comment 明确要求调用方区分「无数据」与「不可读」;但唯一调用方refreshIndex的 catch 没有做这个区分——干净环境第一次刷新没有旧索引(byFile === null),ENOENT 被if (!byFile) throw error原样上抛,buildOverview/buildSessionList/buildSessionPage全部 reject → 端点 500。sessions 目录只在首次 persist 时创建、启动时不建,所以全新安装必然踩中。引入自 e0ef92a(fix: bound web admin session loading (paged list, summary index, lazy detail) #1939 系)。refreshIndexcatch 按 errno 在决策点分流(不是在上游过滤症状):ENOENT → byFile/byId 置新 Map(即 doc comment 本意的「无数据」态),端点返回空视图;其余错误(EACCES 等)保持原行为。新增确定性回归测试tests/issue2181-web-missing-sessions-dir.test.ts(目录不存在 → overview/list 解析为空而非 reject,二次调用幂等),并把 管理页面全量加载历史会话时触发堆 OOM:需要有界分页、摘要统计与详情懒加载 #1937 的 breakage 测试重钉到新契约(首触缺失目录:reject → 解析为空,注释中明示行为变更)。walkSessionFilesdoc comment 早已声明的契约。验证证据(均在本机对新 head
6abecdd7c执行):tests/advisory-endpoint-parity.test.ts在 fresh HOME 下修复前 500、修复后通过;populated HOME 同样通过(两环境确定性绿);web-sessions(14)+ 新回归测试(1)+upstream-alerts(8,另一条打/__bili/overview的路径)= 22/22;npm run typecheck干净;6abecdd7c全部 lane success,包括此前持续红的四个 test lane(ubuntu/windows × node22/24)。收工判定:修复完整、CI 全绿,等 PR #2151 人工合并即可(合并后
Fixes #2181自动关闭本 issue)。ranxianglei commentedon Oct 5, 2026
和这个重复吗 #2180 另外冲突
ranxianglei commentedon Oct 5, 2026
[bot] 🏷 重复判定:是,#2181 与 #2180 重复(同一 bug、同一根因、同一端点、同一文件
src/web/sessions-data.ts)。差异只在深度与方向:#2180 更早立项(源自 PR #2175 的 CI 红),OP 把它定性为 #1937「never silent empty」契约的细化并给出了你拍板的方案(pristine 门控);#2181 的 OP 则给了更简单的无条件首触 ENOENT→空索引。#2180 已关闭,其修复 PR #2182 已合入 master(merge 4e10ade:ef404a85bpristine→空视图 +0d30cec07data root 消失后仍 serve stale 快照)。冲突:确认并已解决。 本轮早前(还不知道 #2180/#2182 存在时)我把一个同 bug 的修复 commit
6abecdd7c推到了 PR #2151 分支上,它和已合入的 #2182 改的是同一批行(refreshIndexcatch + #1937 钉死测试),所以 #2151 变成mergeable_state: dirty。处置:6abecdd7c从 fix(update): bound dsh owner-channel refresh retries + surface frozen-profile state (#2148) #2151 分支上摘除(该修复已被合入的 fix: web — pristine install serves empty index instead of 500 (#2180) #2182 取代,不再需要);6b4b3f587,fix(update): bound dsh owner-channel refresh retries + surface frozen-profile state (#2148) #2151 现在mergeable: true(状态 blocked = 只剩等 CI),范围回归纯 [update] dsh profile copy self-update fails forever when the dsh host CLI itself is broken (frozen version, log-only warning) #2148。一处语义差异需要你知悉(有意保留 master 版本):#2182 合入的方案与 #2181 OP 的字面修法在边界上不同——显式
BILI_SESSIONS_DIR指向不存在的路径、或 data root 存在但 sessions 子目录缺失时,#2182 维持 loudly reject(500)(你的 sketch:显式覆盖缺失更像 typo,应该响);而 #2181 OP 的简单修法则会返回空。按 #2180「owner decision」的定位,以已合入的 #2182 为准,我这边不再另行调整。本 issue 不再产生任何 PR(loop guard 满足:唯一产物就是那个已被摘除的重复 commit)。请帮忙把 #2181 按重复关闭并打
重复标签指向 #2180——我这套工具只能读 issue 和发评论,没有关闭权限。