Skip to content

Commit a7c1f70

Browse files
committed
fix(panel): 引导请求在飞时,视图标签也不许把弹层带走(#386 评审)
CodeRabbit 第五轮 #4453639221:四个视图标签只调 setView、没有 disabled, 点一下就离开 memory,而 .mneme-xtools 整块(连同 BootstrapDialog)挂在 view === "memory" 之下——请求还在写库、界面已经没了。 - 标签加 disabled: bootstrapBusy;onClick 从 setView 改走 leaveMemory, 函数里再判一次(第二道锁,免得将来换一种可点的实现就绕过去)。 - 同一个出口还有一条不显眼的:记忆视图里那个实体 chip 走 openGraphFor 把 view 切到 entity,同样会卸掉弹层。这条是变异自证抓出来的——四个 变异体里只有它活下来,说明先前只锁了标签、漏了这条真实旁路。 - 回到 memory 的两条路径(jumpToMemory / browseWithFilter)不拦。 测试:disabled: bootstrapBusy 计数 6 → 7(四处菜单项 + ⋯ + 标签那处 一处覆盖四个),并新增三条断言锁住 leaveMemory 与 openGraphFor 的守卫。 变异自证 4/4 KILLED。
1 parent 2a1278b commit a7c1f70

3 files changed

Lines changed: 42 additions & 6 deletions

File tree

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,9 @@
1212
- **评审修掉的七处**(CodeRabbit 第二轮):① 摘要只填三个数时,「其余 {file} 个只能改配置文件」与展开后的清单对不上——`undefaulted`(`dreamProvider` / `dreamModel`)既不在「面板能改」里、也不在「只能改文件」里,现在三类各报一个数、都由服务端算好;② 引导成功路径仍 `setBusy(false)`,900ms 提示期间按钮重新可点,且定时器句柄没人保存、第二次提交的结果会写进已卸载的组件——改成不复位 + 句柄进 `useRef` 并在卸载时 `clearTimeout`;③ 请求在飞时目录输入框仍可改,回来的提示贴在改后的输入框旁却对应上一个目录——`disabled: busy`;④ 「⋯」在请求进行中会把弹层连同在飞的请求一起卸掉,绕过弹层自己那两道锁——父组件持有 `bootstrapBusy`,忙碌时不关;⑤ 引导成功只递增 `reloadKey`,而搜索态走的那条 effect 依赖里没有它,搜索词不变就永远看不到新导入的行——补进依赖;⑥ `bootstrapFromDirectory` 自己又 `dir.trim()` 一次,把协议层「回传原串、交给 fs 报错」的承诺变成了空话(`" /repo "` 被静默读成 `"/repo"`)——只 trim 判空、路径原样交给 `statSync`,并补一条用例锁住「带空格的路径必须报 `dir-not-found`」;⑦ `bootstrapReply` 的 `catch` 里裸调 `warn`,宿主 logger 自己坏掉会从 `catch` 里再抛、请求一个字节都回不去(#410 那类现场)——按 `share-http.js` 的 `warnSafely` 收进层里,而不是在每个调用面上各兜一次。
1313
- **评审修掉的另外三处**(CodeRabbit 第三轮):⑧ 忙碌状态只在 `useEffect` 里上报,而 effect 要等这次渲染提交后才跑——中间那一拍父组件的 `bootstrapBusy` 还是 `false`,此时点「⋯」仍会把弹层卸掉,请求的成功或失败就再没有地方显示,改成 `setBusy(true)` 之后**同步**调 `onBusyChange(true)`;⑨ 刷新(`onImported()`)排在 900ms 关闭定时器里,而切视图会卸载弹层并把 `timerRef` 清掉,刷新随之取消——库已经写进去了、列表却还是旧的,改成同步刷新、只把关闭留在定时器里;⑩ 会挂弹层的那五个菜单项(新建 / 导入 / 引导 / 分享 / 接收)在引导请求在飞时仍可点,这些弹层共用同一个绝对定位锚点,后渲染的会盖住引导弹层那句「新建几条、并入几条」——一律 `disabled: bootstrapBusy`,而两个导出项不挂弹层、不带这个禁用。
1414
- **评审修掉的又两处**(CodeRabbit 第四轮):⑪ 引导请求在飞时,Esc / 背板 / ✕ 三条关闭路径照旧能把整个记忆库弹层关掉,而 `MemoryExplorer` 与引导弹层是一起卸载的、POST 还在飞——回来那句「新建几条、并入几条」再没有地方显示,库写进去了用户却以为没成功;忙碌标志因此一路抬到 `MemoryOverlay`,三条路径都看它(✕ 用 `aria-disabled` 而不是真的 `disabled`:真禁用会把焦点从按钮上拿走,而 #178 的 Tab 环拿它当入口)。⑫ 上一轮「导出项不挂弹层所以照旧可点」这个判断是错的:可点的是菜单项本身,但菜单与引导弹层共用同一个绝对定位锚点、同一层 `z-index`,弹层排在菜单之后渲染,会把菜单顶上那两项导出盖住——于是「⋯」在忙碌时整个不给开,不存在「可点但被遮住」。这也把 ④⑩ 两条锁得更死:菜单开不了,就没有任何路径能在请求中途卸掉引导弹层。
15+
- **评审修掉的再两处**(CodeRabbit 第五轮):⑬ 引导请求在飞时,四个视图标签(记忆 / 实体 / 状态 / 设置)照旧可点,点一下就离开 `memory`,而 `.mneme-xtools` 整块(连同里面的 `BootstrapDialog`)是挂在 `view === "memory"` 之下的——请求还在写库、界面已经没了,那句「新建几条、并入几条」再没有地方显示。标签加 `disabled: bootstrapBusy`,onClick 也从 `setView` 改走 `leaveMemory`(函数里再判一次,免得将来换个可点的实现就绕过去)。同一条出口还有一个不显眼的:记忆视图里那个实体 chip 走 `openGraphFor` 把 view 切到 `entity`,同样会把弹层卸掉——这条是变异自证抓出来的,四个变异体里只有它活下来,说明我先前只锁了标签、漏了这条真实旁路。
1516
- **顺带**:`src/api-standalone.js` 的 `POST /bootstrap` 原本自己重复了一遍 `JSON.parse` + 三段校验 + `.catch`,现改为共用 `src/bootstrap-http.js` 的三个函数——按 #411 的纪律,两张皮只许剩鉴权与路径不同。
16-
- **验证**:新增 `test/config-keys-routes.test.js`(15 条:policy/鉴权/坏 JSON/顺序锁/真实目录导入/不回值/三桶划分/两处点名键/坏 logger 下仍回 500)+ `test/client.test.js` 两条面板锁(菜单项、弹层挂载与忙碌时不关、请求形状、四种错误码、输入框与定时器、摘要三类数字、搜索 effect 的依赖、11 个 i18n 键中英各在、卡片挂载位置;以及三条关闭路径各自的忙碌守卫、转发函数必须同步且身份稳定、忙碌标志不许进那个抢焦点的 effect 依赖)。变异自证逐条 KILLED——含把 `/bootstrap` 的 policy 改成 open、把 `schemaLeafKeys` 换回解析结果、把 `undefaulted` 折进 `panelEditable`、把能力判定挪到 dir 校验之前、删掉菜单项、把取数失败渲染成空表、「卡片写了但没挂上」,评审各轮修复逐条反向改回去(去掉 share 项的 `disabled: bootstrapBusy`、去掉同步上报、把 `onImported()` 挪进关闭定时器、Esc/背板/✕ 三处各自不守、`⋯` 不禁用、外层不接忙碌标志、把忙碌标志列进焦点 effect 的依赖、把转发函数从 `useCallback` 降级成每渲染新建),全部 KILLED。全量 2698 tests / 2697 pass / 0 fail / 1 skipped,`check-sync` 85 文件一致。
17+
- **验证**:新增 `test/config-keys-routes.test.js`(15 条:policy/鉴权/坏 JSON/顺序锁/真实目录导入/不回值/三桶划分/两处点名键/坏 logger 下仍回 500)+ `test/client.test.js` 两条面板锁(菜单项、弹层挂载与忙碌时不关、请求形状、四种错误码、输入框与定时器、摘要三类数字、搜索 effect 的依赖、11 个 i18n 键中英各在、卡片挂载位置;以及三条关闭路径各自的忙碌守卫、转发函数必须同步且身份稳定、忙碌标志不许进那个抢焦点的 effect 依赖)。变异自证逐条 KILLED——含把 `/bootstrap` 的 policy 改成 open、把 `schemaLeafKeys` 换回解析结果、把 `undefaulted` 折进 `panelEditable`、把能力判定挪到 dir 校验之前、删掉菜单项、把取数失败渲染成空表、「卡片写了但没挂上」,评审各轮修复逐条反向改回去(去掉 share 项的 `disabled: bootstrapBusy`、去掉同步上报、把 `onImported()` 挪进关闭定时器、Esc/背板/✕ 三处各自不守、`⋯` 不禁用、外层不接忙碌标志、把忙碌标志列进焦点 effect 的依赖、把转发函数从 `useCallback` 降级成每渲染新建、视图标签去掉 `disabled`、标签 onClick 直连 `setView`、`leaveMemory` 去掉忙碌判断、`openGraphFor` 去掉忙碌判断),全部 KILLED。全量 2698 tests / 2697 pass / 0 fail / 1 skipped,`check-sync` 85 文件一致。
1718

1819
## [0.10.1] - 2026-11-03
1920

‎dsh-mneme/lib/client.js‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8032,7 +8032,18 @@ window.__ModuleLoader__.load({
80328032
setSelectedId(target.id);
80338033
};
80348034

8035+
// 引导请求在飞时不许离开记忆视图(评审 #4453639221):`.mneme-xtools` 整块挂在
8036+
// `view === "memory"` 之下,BootstrapDialog 就在里面。任何离开这个视图的动作都会
8037+
// 连它一起卸载——请求还在飞、界面已经没了,那句「新建几条、并入几条」就再没有
8038+
// 地方显示。这里只拦「离开」的路径:jumpToMemory / browseWithFilter 是回到
8039+
// memory,不拦。
8040+
const leaveMemory = (key) => {
8041+
if (bootstrapBusy) return;
8042+
setView(key);
8043+
};
8044+
80358045
const openGraphFor = (name) => {
8046+
if (bootstrapBusy) return;
80368047
setGraphFocus(name || "");
80378048
setView("entity");
80388049
};
@@ -8061,9 +8072,14 @@ window.__ModuleLoader__.load({
80618072
h("button", {
80628073
key: s.key,
80638074
type: "button",
8075+
// 引导请求在飞时四个视图标签一律禁用(评审 #4453639221):离开 memory
8076+
// 会把整个 `.mneme-xtools` 连同里面的 BootstrapDialog 卸掉。onClick 仍
8077+
// 走 leaveMemory 而不是 setView——disabled 只是第一道,第二道在函数里,
8078+
// 免得将来有人给标签换一种可点的实现就绕过去了。
8079+
disabled: bootstrapBusy,
80648080
className: view === s.key ? "mneme-vtab mneme-active" : "mneme-vtab",
80658081
"aria-pressed": String(view === s.key),
8066-
onClick: () => setView(s.key)
8082+
onClick: () => leaveMemory(s.key)
80678083
},
80688084
h(Icon, { name: s.key === "memory" ? "database" : s.key === "entity" ? "waypoints" : s.key === "status" ? "activity" : "settings", size: 14, className: "mneme-vtabico" }),
80698085
s.label

‎dsh-mneme/test/client.test.js‎

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2750,12 +2750,31 @@ test("panel exposes the bootstrap entry and the config-key coverage card (issue
27502750
"the forwarder must set both levels synchronously and keep a stable identity"
27512751
);
27522752
// 会挂弹层的菜单项在忙碌时必须禁用(评审 #4452539738):新建 / 导入 / 引导 / 分享 /
2753-
// 接收共五处,加上「⋯」按钮自己(见下)。数个数而不是逐个锁字符串——少一处就等于
2754-
// 留了一条绕过弹层的路,而这条路的代价是用户看不到自己那次引导的结果。
2753+
// 接收共五处,加上「⋯」按钮自己(见下),再加上四个视图标签(评审 #4453639221,
2754+
// 源码里那一处在 `.map` 里,一处覆盖四个)。数个数而不是逐个锁字符串——少一处就
2755+
// 等于留了一条绕过弹层的路,而这条路的代价是用户看不到自己那次引导的结果。
27552756
assert.equal(
27562757
clientSource.split("disabled: bootstrapBusy").length - 1,
2757-
6,
2758-
"every dialog-mounting menu item plus the overflow toggle must be disabled while bootstrap is busy"
2758+
7,
2759+
"every dialog-mounting menu item, the overflow toggle and the view tabs must be disabled while bootstrap is busy"
2760+
);
2761+
// 视图标签离开 memory 会连 `.mneme-xtools` 与其中的 BootstrapDialog 一起卸载
2762+
// (评审 #4453639221)。两道锁都要有:`disabled` 是第一道,onClick 走 leaveMemory
2763+
// 是第二道——将来有人给标签换一种可点的实现时,函数里的判断还在。
2764+
assert.ok(
2765+
/disabled: bootstrapBusy,[\s\S]{0,300}?onClick: \(\) => leaveMemory\(s\.key\)/.test(clientSource),
2766+
"view tabs must route through leaveMemory, not setView directly"
2767+
);
2768+
assert.ok(
2769+
/const leaveMemory = \(key\) => \{[\s\S]{0,120}?if \(bootstrapBusy\) return;[\s\S]{0,80}?setView\(key\);/.test(clientSource),
2770+
"leaveMemory must refuse to switch views while a bootstrap request is in flight"
2771+
);
2772+
// 视图标签不是唯一的出口:记忆视图里那个实体 chip(`openGraphFor`)也把 view 切到
2773+
// "entity",同样会把 BootstrapDialog 一起卸掉。这条是变异自证抓出来的——四个变异体
2774+
// 里只有它活下来,说明我先前只锁了标签、漏了这条真实的旁路。
2775+
assert.ok(
2776+
/const openGraphFor = \(name\) => \{[\s\S]{0,120}?if \(bootstrapBusy\) return;/.test(clientSource),
2777+
"the entity chip's graph jump must also refuse to leave memory while bootstrap is busy"
27592778
);
27602779
// 「⋯」按钮自己也要禁用(评审 #4453225585):菜单与引导弹层共用同一个绝对定位锚点、
27612780
// 同一层 z-index,弹层排在菜单之后渲染,会把菜单顶上那两项导出盖住——它们没有

0 commit comments

Comments
 (0)