Skip to content

Commit 5d23058

Browse files
committed
fix(panel): 改库动作统一广播 mneme:store-changed,数据视图即时重取
此前跨组件失效只有 mneme:conflicts-changed 一个事件、三个状态侧监听者 (全是状态页小组件):记忆列表与冲突徽章只靠弹层回调、手动刷新与 30s 首页合并续命,实体页与归档工作台只有挂载时取一次——裁决完冲突要关面 板重开才能看到败者归档(用户 2026-11-06 反馈)。 新增 broadcastStoreChanged 助手,10 处改库动作成功路径统一发布:冲突 裁决、删除、编辑/归档/恢复(applyMemoryUpdate 一处按分支发一种)、工 作台恢复、导入×3、建条、整包撤销、回收确认模式。订阅方:MemoryExplorer (一个 reloadKey 带动列表/搜索/徽章)、EntityPanel(三层 effect 全挂 重取游标)、ConflictsQueue(参与记忆被删时联表侧会失真)、WorkbenchSection、 侧栏红点 hook 与两处 dream-status 消费者。各动作本地刷新保留,偶发重复 GET 换永远不陈旧;mneme:conflicts-changed 原样保留(裁决专属精准信号)。 回归锁:发布点 ledger(新增改库动作忘广播先红)+ 订阅方数量 + 裁决双 信号并存;onCreated 既有原样锁同步带上广播。
1 parent 0d612cb commit 5d23058

3 files changed

Lines changed: 131 additions & 11 deletions

File tree

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,14 @@
22

33
## [Unreleased]
44

5+
- **面板跨组件失效广播:改库动作后记忆列表/实体页/状态工作台即时重取,不再「关面板重开才看到变化」**(用户 2026-11-06 反馈:裁决完冲突要关掉插件面板才能看到败者归档落地)。
6+
7+
- **病灶不是没刷新,是没广播**:全面板此前唯一的跨组件失效机制是 `mneme:conflicts-changed`(一个派发点、三个状态侧监听者,全是状态页小组件);记忆列表与冲突徽章只靠弹层成功回调、手动刷新按钮与 30s 首页合并续命,实体页与归档工作台干脆只有挂载时取一次。tab 切换本就卸载重挂,所以症状集中在同一次打开的面板内。
8+
- **新增 `broadcastStoreChanged` 助手派发 `mneme:store-changed`**,10 处改库动作的成功路径统一发布:冲突裁决、删除、编辑/归档/恢复(applyMemoryUpdate 一处按分支发一种)、工作台恢复、导入×3、建条、整包撤销、回收确认模式。各动作自己的本地刷新(reloadKey / 列表过滤)保留——偶发的重复 GET 换「永远不陈旧」,划算。
9+
- **订阅方**:MemoryExplorer(一个 reloadKey 带动浏览列表、搜索、冲突徽章三份 effect)、EntityPanel(目录/图谱/属性三层全挂重取游标)、ConflictsQueue(参与记忆被删时联表侧会失真)、WorkbenchSection、侧栏红点 hook 与两处 dream-status 消费者(涉及冲突的记忆被删除/恢复同样改变 pending 集)。`mneme:conflicts-changed` 原样保留——它是裁决专属的精准信号,语义更窄,已有监听者不必搬家。
10+
- **回归锁**:`test/client.test.js` 新增一例锁事件名、发布点 ledger(新增改库动作忘了广播时先红)、订阅方数量与裁决双信号并存;onCreated 的既有原样锁同步带上广播。
11+
- **验证**:全量 `npm test` 2809 tests / 2808 pass / 0 fail / 1 skipped;test/client.test.js 100 例全绿(含新增锁);test/client-share.test.js 全绿。
12+
513
## [0.11.0] - 2026-11-05
614

715
- **修复 #573:宽态侧栏的记忆入口落在「更多」行下面,点开「更多」时被菜单盖住**:宿主 0.2.2 起把面板列表的「更多」行(`PanelMoreMenu`)也追加进同一个 `nav.panelList`,于是组尾不再是面板行——我们仍按「追加到末尾」落位,入口就排到了「更多」下面。

‎dsh-mneme/lib/client.js‎

Lines changed: 89 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -289,6 +289,19 @@ window.__ModuleLoader__.load({
289289
return fetch(path, { ...opts, headers });
290290
}
291291

292+
// 通用失效广播:任何改库动作(裁决/删除/编辑/归档/导入/接收/建条/回收…)
293+
// 成功后派发一次。此前跨组件失效只有 mneme:conflicts-changed 一个事件、
294+
// 三个状态侧监听者——记忆列表与冲突徽章、实体页、归档工作台全都不在名单里,
295+
// 用户裁决完冲突要关掉面板重开才能看到败者归档。数据视图一律订阅本事件
296+
// 立即重取;各动作自己的本地刷新(reloadKey / 列表过滤)保留,偶发的重复
297+
// GET 换「永远不陈旧」,划算。与 mneme:conflicts-changed 并存不合并:后者
298+
// 是裁决专属的精准信号,语义更窄,已有监听者不必搬家。
299+
function broadcastStoreChanged(reason) {
300+
try {
301+
window.dispatchEvent(new CustomEvent("mneme:store-changed", { detail: { reason: reason || "" } }));
302+
} catch { /* 非浏览器环境 */ }
303+
}
304+
292305
// ⚠️ 'betterSidebar' 绝不能进模块级 inject(issue #88 实锤):loader 对
293306
// inject 声明的服务是硬等待——未安装 better-sidebar 的环境里整个 entry
294307
// 永远 pending("1 entry did not activate" → Failed to load plugins)。
@@ -3032,6 +3045,9 @@ window.__ModuleLoader__.load({
30323045
const dragRef = useRef(null); // { id, moved }
30333046
const viewRef = useRef({ x: 0, y: 0, k: 1 }); // pan/zoom viewport, viewBox units
30343047
const [frame, setFrame] = useState(0); // re-render tick driven by the simulation
3048+
// 通用失效广播的重取游标:记忆行的增删改会连带实体属性/关联记忆/关系边,
3049+
// 目录与各层数据的 effect 依赖都带上它(见下方订阅 effect)。
3050+
const [dataTick, setDataTick] = useState(0);
30353051

30363052
useEffect(() => {
30373053
let cancelled = false;
@@ -3044,6 +3060,14 @@ window.__ModuleLoader__.load({
30443060
})
30453061
.catch(() => { if (!cancelled) { setEntities([]); setEntityTotal(null); } });
30463062
return () => { cancelled = true; };
3063+
}, [dataTick]);
3064+
3065+
// 通用失效广播订阅:实体抽取随写入发生,本页签对别处的改库(删除记忆、
3066+
// 裁决冲突、导入)无从感知——不订阅的话,切回来之前图谱一直是旧的。
3067+
useEffect(() => {
3068+
const onChanged = () => setDataTick((k) => k + 1);
3069+
window.addEventListener("mneme:store-changed", onChanged);
3070+
return () => window.removeEventListener("mneme:store-changed", onChanged);
30473071
}, []);
30483072

30493073
useEffect(() => {
@@ -3077,7 +3101,7 @@ window.__ModuleLoader__.load({
30773101
}
30783102
}, []);
30793103

3080-
useEffect(() => { load(entityName, depth); }, [load, entityName, depth]);
3104+
useEffect(() => { load(entityName, depth); }, [load, entityName, depth, dataTick]);
30813105

30823106
// Layer data for the selected entity: current attrs + related memories.
30833107
useEffect(() => {
@@ -3094,7 +3118,7 @@ window.__ModuleLoader__.load({
30943118
.then((j) => { if (!cancelled) setRelated(Array.isArray(j.items) ? j.items : []); })
30953119
.catch(() => {});
30963120
return () => { cancelled = true; };
3097-
}, [entityName]);
3121+
}, [entityName, dataTick]);
30983122

30993123
// issue #24 块4 复核面:只在展开时取,收起时不发请求。
31003124
const loadBoosted = useCallback(async () => {
@@ -5746,6 +5770,8 @@ window.__ModuleLoader__.load({
57465770
setResult(r.body);
57475771
setArmed(false);
57485772
setRunning(false);
5773+
// 回收确认模式真的删了行:主列表/实体页/工作台的计数都变了,广播重取。
5774+
broadcastStoreChanged("reclaim");
57495775
})
57505776
.catch(() => { setResultError(t("memory.status.maint.failed")); setRunning(false); });
57515777
};
@@ -6099,7 +6125,14 @@ window.__ModuleLoader__.load({
60996125
};
61006126
loadConflicts();
61016127
window.addEventListener("mneme:conflicts-changed", loadConflicts);
6102-
return () => { cancelled = true; window.removeEventListener("mneme:conflicts-changed", loadConflicts); };
6128+
// 通用失效广播:KPI 第 4 格的待确认计数不只随裁决变——涉及冲突的
6129+
// 记忆被删除/恢复也一样,两个事件都听,取数只有一次 GET。
6130+
window.addEventListener("mneme:store-changed", loadConflicts);
6131+
return () => {
6132+
cancelled = true;
6133+
window.removeEventListener("mneme:conflicts-changed", loadConflicts);
6134+
window.removeEventListener("mneme:store-changed", loadConflicts);
6135+
};
61036136
}, []);
61046137

61056138
const loading = !stats && !statsError;
@@ -6446,9 +6479,15 @@ window.__ModuleLoader__.load({
64466479
};
64476480
loadOnce();
64486481
// #295 评审:裁决完成后队列会广播 mneme:conflicts-changed,这里重取
6449-
// 计数,状态卡的「待确认冲突」不再停留旧值。
6482+
// 计数,状态卡的「待确认冲突」不再停留旧值。涉及冲突的记忆被删除/
6483+
// 恢复同样改变计数,通用失效广播一并听。
64506484
window.addEventListener("mneme:conflicts-changed", loadOnce);
6451-
return () => { cancelled = true; window.removeEventListener("mneme:conflicts-changed", loadOnce); };
6485+
window.addEventListener("mneme:store-changed", loadOnce);
6486+
return () => {
6487+
cancelled = true;
6488+
window.removeEventListener("mneme:conflicts-changed", loadOnce);
6489+
window.removeEventListener("mneme:store-changed", loadOnce);
6490+
};
64526491
}, []);
64536492
// #495:这张卡的标题是「最近巩固」,取数就该是巩固轮,而不是 runs[0]。
64546493
// organize 与巩固共用 dream_runs,一次 agent 主动整理会写两行(dryRun 报告 +
@@ -6602,6 +6641,14 @@ window.__ModuleLoader__.load({
66026641
.catch(() => { setItems([]); setLoadError(true); });
66036642
};
66046643
useEffect(() => { load(); }, []);
6644+
// 参与记忆在别处被删除/编辑时(通用失效广播),队列联表出的那一侧会失真
6645+
// ——重取,宁可多一次 GET 也不把「已失联」装成「还在」。
6646+
useEffect(() => {
6647+
const onChanged = () => load(true);
6648+
window.addEventListener("mneme:store-changed", onChanged);
6649+
return () => window.removeEventListener("mneme:store-changed", onChanged);
6650+
// eslint-disable-next-line react-hooks/exhaustive-deps
6651+
}, []);
66056652
// #177:空队列不再整块消失——空态教育卡要渲染(原 return null 已移除)。
66066653
if (!items) return null;
66076654
const resolve = (id, winner) => {
@@ -6622,6 +6669,10 @@ window.__ModuleLoader__.load({
66226669
// 读一次 dream-status,不广播的话状态卡停留在旧计数。同页两个组件
66236670
// 用一个 window 事件对齐(比提升状态到 StatusPanel 少动三处)。
66246671
try { window.dispatchEvent(new CustomEvent("mneme:conflicts-changed")); } catch { /* 非浏览器环境 */ }
6672+
// 裁决会归档败者、给胜者追加已否决注记——记忆列表、实体页、归档
6673+
// 工作台的数据全变了,走通用失效广播让它们立刻重取(用户反馈:
6674+
// 以前要关面板重开才能看到裁决落地)。
6675+
broadcastStoreChanged("conflict-resolve");
66256676
load(true);
66266677
})
66276678
.catch(() => {})
@@ -6789,6 +6840,13 @@ window.__ModuleLoader__.load({
67896840
return () => { cancelled = true; };
67906841
}, [wbReload]);
67916842
useEffect(() => { load(); }, [load]);
6843+
// 工作台三份列表(活动流/沉淀/归档)都读库:别处改库(裁决/删除/导入…)
6844+
// 广播过来就整组重取——此前只有本组件自己的恢复按钮会刷新它。
6845+
useEffect(() => {
6846+
const onChanged = () => setWbReload((k) => k + 1);
6847+
window.addEventListener("mneme:store-changed", onChanged);
6848+
return () => window.removeEventListener("mneme:store-changed", onChanged);
6849+
}, []);
67926850

67936851
const restore = (id) => {
67946852
setRestoring(id);
@@ -6801,6 +6859,8 @@ window.__ModuleLoader__.load({
68016859
.then(() => {
68026860
setArchived((cur) => (cur || []).filter((m) => m.id !== id));
68036861
setArchivedTotal((n) => Math.max(0, n - 1));
6862+
// 恢复让行回到主列表:记忆页与实体页不知道这次 /update,广播让它们重取。
6863+
broadcastStoreChanged("memory-restore");
68046864
})
68056865
.catch(() => {})
68066866
.finally(() => setRestoring(""));
@@ -8105,6 +8165,16 @@ window.__ModuleLoader__.load({
81058165
return () => { cancelled = true; };
81068166
}, [reloadKey]);
81078167

8168+
// 通用失效广播订阅:任何改库动作(裁决/删除/编辑/导入/恢复…)都让首页
8169+
// 与冲突徽章立刻重取。此前列表只靠弹层成功回调、手动刷新与 30s 首页合并
8170+
// 续命——裁决冲突后徽章与败者归档要关面板重开才更新(用户反馈的病灶)。
8171+
// reloadKey 同时驱动浏览列表、搜索与上面这份 pendingIds,一个游标全带上。
8172+
useEffect(() => {
8173+
const onChanged = () => setReloadKey((k) => k + 1);
8174+
window.addEventListener("mneme:store-changed", onChanged);
8175+
return () => window.removeEventListener("mneme:store-changed", onChanged);
8176+
}, []);
8177+
81088178
// One query string behind every browse-list fetch (initial page,
81098179
// loadMore, auto-refresh): the type filter, importance floor and time
81108180
// window always travel together, so counts and pagination stay
@@ -8301,6 +8371,8 @@ window.__ModuleLoader__.load({
83018371
setRemoteItems((cur) => (cur ? cur.filter((m) => m.id !== id) : cur));
83028372
setTotal((n) => Math.max(0, n - 1));
83038373
setSelectedId(null);
8374+
// 删除同样广播:冲突队列的联表侧、实体页的关联记忆都引用这条 id。
8375+
broadcastStoreChanged("memory-delete");
83048376
setToastMsg(t("memory.explorer.deleted"));
83058377
setTimeout(() => setToastMsg(""), 2500);
83068378
})
@@ -8313,7 +8385,10 @@ window.__ModuleLoader__.load({
83138385

83148386
// 编辑保存 / 归档的本地落账:替换或移除对应行;镜像由后端重渲染。
83158387
// 归档从所有视图移除(列表默认只看未归档),并清空选中。
8388+
// 调用点在服务端提交成功之后,所以这里同时是通用失效广播的发布点:
8389+
// 其它页签(实体/状态工作台/冲突队列)不知道这次 /update,不广播就陈旧。
83168390
const applyMemoryUpdate = (updated, { archived = false, restored = false } = {}) => {
8391+
broadcastStoreChanged(archived ? "memory-archive" : restored ? "memory-restore" : "memory-edit");
83178392
if (archived) {
83188393
setItems((cur) => cur.filter((m) => m.id !== updated.id));
83198394
setRemoteItems((cur) => (cur ? cur.filter((m) => m.id !== updated.id) : cur));
@@ -8488,26 +8563,26 @@ window.__ModuleLoader__.load({
84888563
importOpen && h(ImportDialog, {
84898564
t,
84908565
onClose: () => setImportOpen(false),
8491-
onImported: () => setReloadKey((k) => k + 1)
8566+
onImported: () => { setReloadKey((k) => k + 1); broadcastStoreChanged("import"); }
84928567
}),
84938568
bootstrapOpen && h(BootstrapDialog, {
84948569
t,
84958570
onClose: () => setBootstrapOpen(false),
84968571
onBusyChange: reportBootstrapBusy,
8497-
onImported: () => setReloadKey((k) => k + 1)
8572+
onImported: () => { setReloadKey((k) => k + 1); broadcastStoreChanged("import"); }
84988573
}),
84998574
shareOpen && h(ShareDialog, { t, onClose: () => setShareOpen(false) }),
85008575
receiveOpen && h(ReceiveDialog, {
85018576
t,
85028577
onClose: () => setReceiveOpen(false),
8503-
onImported: () => setReloadKey((k) => k + 1)
8578+
onImported: () => { setReloadKey((k) => k + 1); broadcastStoreChanged("import"); }
85048579
}),
85058580
createOpen && h(CreateDialog, {
85068581
t,
85078582
onClose: () => setCreateOpen(false),
85088583
// 新建后既刷新列表也选中新行:并入既有条目时 action 是 merged,
85098584
// 返回的 id 就是被并入那一行——两种情况都该把它滚进视野。
8510-
onCreated: (d) => { setReloadKey((k) => k + 1); if (d && d.id) setSelectedId(d.id); }
8585+
onCreated: (d) => { setReloadKey((k) => k + 1); broadcastStoreChanged("create"); if (d && d.id) setSelectedId(d.id); }
85118586
})
85128587
)
85138588
),
@@ -8753,6 +8828,7 @@ window.__ModuleLoader__.load({
87538828
// (toast 形状照详情抽屉里 restored 那一条的先例,不带行号免得漂)。
87548829
setSelectedId(null);
87558830
setReloadKey((k) => k + 1);
8831+
broadcastStoreChanged("pack-undo");
87568832
setToastMsg(t("memory.explorer.undoPackDone").replace("{n}", String(n)));
87578833
setTimeout(() => setToastMsg(""), 2500);
87588834
}
@@ -8839,9 +8915,13 @@ window.__ModuleLoader__.load({
88398915
const unsubscribe = conflictBadgeCount.subscribe(setPending);
88408916
const onChanged = () => { conflictBadgeCount.refresh(); };
88418917
window.addEventListener("mneme:conflicts-changed", onChanged);
8918+
// 涉及冲突的记忆在别处被删除/恢复时 pending 集同样会变——裁决广播
8919+
// 之外的第二条失效路径(此前只能等 60s 兜底轮询)。
8920+
window.addEventListener("mneme:store-changed", onChanged);
88428921
return () => {
88438922
unsubscribe();
88448923
window.removeEventListener("mneme:conflicts-changed", onChanged);
8924+
window.removeEventListener("mneme:store-changed", onChanged);
88458925
};
88468926
}, []);
88478927
return pending;

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

Lines changed: 34 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1539,6 +1539,38 @@ test("badge store: one poll for both entries, immediate publish after a refresh"
15391539
assert.equal(cleared, 1, "the timer must stop when the last subscriber leaves");
15401540
});
15411541

1542+
// 通用失效广播(mneme:store-changed):此前跨组件失效只有 mneme:conflicts-changed
1543+
// 一个事件、三个状态侧监听者,记忆列表与冲突徽章、实体页、归档工作台全都不在
1544+
// 名单里——裁决/删除之后要关面板重开才能看到落地(用户 2026-11-06 反馈)。
1545+
// 本用例锁四类回归:(a) 事件名不被改名;(b) 发布点数量——新增改库动作忘了广播
1546+
// 时这里先红(ledger 见断言消息);(c) 此前漏订的数据视图都订阅了;(d) 裁决
1547+
// 路径精准信号与通用信号并存,砍掉任何一个都会让现有监听者失去各自语义。
1548+
test("store-changed broadcast: every mutation publishes, missed views subscribe", () => {
1549+
assert.ok(
1550+
clientSource.includes('new CustomEvent("mneme:store-changed"'),
1551+
"the broadcast must dispatch an event literally named mneme:store-changed"
1552+
);
1553+
// 发布点 ledger(lookahead 排除 helper 定义形参那一处):conflict-resolve /
1554+
// memory-delete / memory-archive|restore|edit(applyMemoryUpdate 一处按分支发
1555+
// 一种)/ workbench restore / import×3 / create / pack-undo / reclaim = 10 处发布。
1556+
const dispatches = clientSource.match(/broadcastStoreChanged\((?!reason\b)/g) || [];
1557+
assert.equal(
1558+
dispatches.length, 10,
1559+
`every store-mutating action must publish exactly once (got ${dispatches.length}; ` +
1560+
"if you added a mutation, add its broadcast and bump this ledger)"
1561+
);
1562+
const subscribers = clientSource.match(/addEventListener\("mneme:store-changed"/g) || [];
1563+
assert.equal(
1564+
subscribers.length, 7,
1565+
`memory list, entities, workbench, conflict queue, badge hook and both dream-status consumers must subscribe (got ${subscribers.length})`
1566+
);
1567+
assert.ok(
1568+
clientSource.includes('broadcastStoreChanged("conflict-resolve")')
1569+
&& clientSource.includes('new CustomEvent("mneme:conflicts-changed")'),
1570+
"resolve must keep emitting the precise conflicts-changed signal alongside the generic one"
1571+
);
1572+
});
1573+
15421574
// --- issue #179:注入预览(状态页卡片 + /inject-preview 端点透传的旁路快照) ---
15431575
test("a11y+preview: inject preview card is wired on the status tab", () => {
15441576
assert.ok(clientSource.includes('"/api/dsh-mneme/inject-preview"'), "card must fetch the preview endpoint");
@@ -1666,8 +1698,8 @@ test("panel can create a memory by hand: menu entry wired to the dialog", () =>
16661698
// 弹层必须挂在树上并接上回调:onCreated 同时刷新列表与选中新行(并入既有条目时
16671699
// 返回的 id 是被并入那一行,也该滚进视野)。
16681700
assert.ok(/createOpen && h\(CreateDialog, \{/.test(clientSource), "the dialog must be mounted conditionally");
1669-
assert.ok(/onCreated: \(d\) => \{ setReloadKey\(\(k\) => k \+ 1\); if \(d && d\.id\) setSelectedId\(d\.id\); \}/.test(clientSource),
1670-
"creating must refresh the list and select the resulting row");
1701+
assert.ok(/onCreated: \(d\) => \{ setReloadKey\(\(k\) => k \+ 1\); broadcastStoreChanged\("create"\); if \(d && d\.id\) setSelectedId\(d\.id\); \}/.test(clientSource),
1702+
"creating must refresh the list, publish the invalidation broadcast and select the resulting row");
16711703
// 打后端的路由是 /create,不是 standalone 的 /memories:面板与工具必须走同一条
16721704
// saveWithDedupe 路径,否则「同标题并入」的提示在面板上会失灵。
16731705
assert.ok(clientSource.includes('apiFetch("/api/dsh-mneme/create"'),

0 commit comments

Comments
 (0)