Skip to content

Commit 14a48d2

Browse files
committed
feat(panel): move the memory library onto the host's own panel seats
The library used to have exactly one full entry point: a sidebar.footer.action slot that opened a createPortal overlay centred on the viewport. That overlay is not a host panel — it sits in the middle of the screen without joining the host's layout or navigation state, so Escape handling, the focus ring and the backdrop click all had to be reimplemented, while it still looked like a new window in screenshots. The host already declares a pair of seats for this: sidebar.panellist (list, the sidebar panel list) and main (keyed, the centre column). PanelRow handles the click itself by calling layout.selectPanel(id), so the plugin only hands over a glyph and a page — no second button, no aria plumbing, and no close affordance (every host path back to a session goes through selectPanel(null)). main's key must match the sidebar id verbatim: the host looks the entry up by options.key and throws layout.selectPanel: main panel "..." is not registered when they differ. Older hosts keep the footer.action fallback, but the choice is a real one. slots.inject alone cannot decide it — it neither throws nor calls back for an undeclared slot, it just waits — so hostHasPanelSeat() asks slots.spec() explicitly and mountFooterSeat() checks it before registering. The panellist disposer mounts the fallback again, otherwise a host that retracts the seat would be left with no entry at all, and only that path can ever notice. The semantic colour layer grows a fifth root: .mneme-paneliglyph lives inside the host's span.panelGlyph, outside the .mneme-x subtree, and the conflict badge on it needs --mneme-danger. contrast.test.js pins that selector exactly, which is the point — a new render root must not slip past the AA audit. The new test boots the real seat block against a fake ctx and asserts what mounts, not which strings exist: seat-only on a new host, one footer on an old one, and the fallback coming back (with main torn down) when the seat goes away. Removing any of the three guards turns it red.
1 parent e9e5b42 commit 14a48d2

4 files changed

Lines changed: 272 additions & 28 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+
- **记忆库从「侧栏 footer 挤一个入口 + 居中浮层」改成宿主原生面板位:侧栏一颗图标进 `sidebar.panellist`,正文落 `main` 整页(参照 dsh-baleen,用户 2026-11-04 提的)**:此前唯一的完整入口是 `sidebar.footer.action`,点开是一个 `createPortal` 到 `document.body` 的居中浮层——它不是宿主的面板,占着屏幕中央却不参与宿主的布局与导航状态,Esc/焦点环/背板点击都得自己实现一遍,而截图里它看起来又很像「一个新窗口」。宿主早就给了成对的座位:`sidebar.panellist`(侧栏面板列表,list 槽)与 `main`(正文区,keyed 槽),侧栏一行的点击由宿主 `PanelRow` 自己调 `layout.selectPanel(id)`,插件只交一颗图标和一片内容。**main 的 `key` 必须与侧栏的 `id` 逐字相同**(两者都取 `dsh-mneme`)——宿主按 `options.key` 在 keyed 槽里找 entry,对不上会抛 `layout.selectPanel: main panel "…" is not registered`;这条不是防御性写作,是宿主 `layout.js` 里真会抛的那一行。
6+
7+
- **模板块只交「图标」和「页面」,不自己造按钮、不做关闭**:宿主 `PanelRow` 已经渲染了 `button` + `aria-label` + `Tooltip` + `aria-current` + active 高亮,插件再套一层按钮就是两颗可聚焦元素(Tab 停两次、读屏报两次),而 `onClick` 还得自己去 `selectPanel`——那是宿主自己的活。回到会话也不由我们提供:宿主所有「打开会话」的路径都走 `selectPanel(null)`(`workspace.js` 的 `openSession` / `openWorkspaceSession` 都是 `replaceMain(…, "reveal")`),baleen 的面板同样没有返回按钮。`main` 槽只给出 `min-width:0; overflow:hidden` 的容器,注册者必须自己铺满 `100%` 并自管滚动,所以外层新增 `.mneme-panel`。
8+
- **老宿主回落是真的条件回落,不是「两个都装」**:只用 `slots.inject` 判断不了——它对未声明的槽**不抛错也不立即回调**(内部 `specDynamic(key) === undefined` 时静默等待声明),所以新宿主上照样会跑、老宿主上则永远 pending。改法是把「问宿主有没有这套座位」收成一个 `hostHasPanelSeat()`(`slots.spec("sidebar.panellist") !== undefined`),再让 `mountFooterSeat()` 在装之前查一次;两条 `inject` 各自在回调里调它,**谁先声明谁赢,同一时刻至多一份在册**。回落还必须能被装回来:panellist 座位的 disposer 里显式 `mountFooterSeat()`,否则那台宿主在座位被撤(宿主折叠该槽 / 换形态)之后会停在「没有任何入口」的状态——这条路径只有它自己会触发,没有别的代码来救。
9+
- **语义色层的根从四个变五个**:`.mneme-paneliglyph` 必须一起挂上 `--mneme-*`,否则那颗冲突红点吃不到 `--mneme-danger`。它长在宿主的 `span.panelGlyph` 里、不在 `.mneme-x` 子树内,靠继承拿不到;而 `test/contrast.test.js` 的四根精确锁正是为这一类「新加的渲染根悄悄绕过 AA 审计」立的,所以改的是选择器本身而不是新加一条规则。
10+
- **回归锁补的是「装/卸真的按条件跑」,不是「代码里有这两段字符串」**:用文件里真实的座位代码块起一个假 `ctx`(`spec` 可切换、`register` 记账、`inject` 只登记不自动点火——宿主本来也只在槽已声明时才点火)跑三个场景:新宿主上只该有 panellist + main 且 footer 不装;老宿主上只该有一份 footer;座位消失后 footer 必须自己装回来、且 main 要跟着卸。三个变异体逐个变红:删掉座位消失时的 `mountFooterSeat()` → 红在「回落要能装回来」;去掉装之前的 `hostHasPanelSeat()` 抑制 → 红在「新宿主不该有 footer」;卸载时只卸 glyph 不卸 main → 红在「main 要跟着卸」。另有一条纯结构锁:glyph 组件体内不许出现 `h("button"`、整个 bundle 不许出现 `ctx.layout.selectPanel`(真需要时才加,届时得同时把 layout 放进可选注入)。
11+
- **验证**:`npm test` 2715 tests / 2714 pass / 0 fail / 1 skipped;`check-sync` 85 文件一致(本改动只碰 `lib/client.js`,该文件无 `src/` 对应物、不进 sync)。**已知未覆盖**:本机被加载的那两份安装(`profiles/web` 的 symlink 指向主树、`profiles/desktop` 是 0.10.0 实体副本)都还没有这次改动,真机观感(铺满后的页头、窄容器下的布局、badge 位置)未经实际渲染验证——接手的人要先更新被加载的那棵树并重启宿主才看得到。
12+
513
- **存量 quality_score 回填(#560 的收尾):一次性迁移撤回旧重复度度量留下的 repetitive 误判**:上一条只改了判据,管的只是**新写入**——`evaluateMemoryQuality` 全仓只有 `src/service.js` 写路径一处调用,更新路径不重算 `quality_score`,所以库里那批标签与扣分原封不动。本机 12,827 条里有 1,476 条带 `repetitive`,其中 729 条还是归档态。这条迁移在 `createStore` 打开库时跑,跑过就登记,不再跑第二次。
614

715
- **口径是「手术式撤销」,不是「整列重算」**:整列重算会顺手把判据没变、但当年没跑到评分的行重新裁一遍——实测会新命中 90 条 `meta`、98 条 `self_referential`,那是双向改写,越过了「只撤除被修掉的那个误判」的范围。所以只取带 `repetitive` 的行,且**用新度量复算仍然不重复**才动;新度量下依旧 > 0.7 的是真重复,标签有效,原样保留。本机 1,476 条在新度量下**全部**不再命中(旧度量里它们的命中和内容无关,只和长度有关),所以这条迁移在本机是全量撤销。

‎dsh-mneme/lib/client.js‎

Lines changed: 96 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2022,10 +2022,12 @@ window.__ModuleLoader__.load({
20222022
// / -warning / -success / -warn / --dsw-alias-border),
20232023
// 于是长年吃的是写在 fallback 里的硬编码色。这里按宿主真实 token 现算一组
20242024
// 面板自有语义色:混色基准全是宿主 token,宿主换肤时跟着走,不引入新字面量。
2025-
// 必须挂四个根——面板不只长在 .mneme-x 下:记忆库 sheet portal 到 body
2025+
// 必须挂满五个根——面板不只长在 .mneme-x 下:记忆库 sheet portal 到 body
20262026
// (.mneme-overlay)、侧边栏入口在宿主插槽(.mneme-triggerwrap)、顶部入口
2027-
// portal 到宿主侧边栏(.mneme-topentry)。
2028-
".mneme-x,.mneme-overlay,.mneme-triggerwrap,.mneme-topentry{" +
2027+
// portal 到宿主侧边栏(.mneme-topentry)。第五个根是宿主内整页面板
2028+
// (.mneme-panel)配套的侧栏图标容器:那颗图标长在宿主的 panelGlyph 里,
2029+
// 不在 .mneme-x 的子树里,而它右上角的未处理冲突 badge 要吃 --mneme-danger。
2030+
".mneme-x,.mneme-overlay,.mneme-triggerwrap,.mneme-topentry,.mneme-paneliglyph{" +
20292031
"--mneme-fg-dim:color-mix(in srgb,var(--dsw-alias-label-primary) 60%,transparent);" +
20302032
"--mneme-graphic-dim:color-mix(in srgb,var(--dsw-alias-label-primary) 50%,transparent);" +
20312033
"--mneme-accent:color-mix(in srgb,var(--dsw-alias-state-business-primary) 85%,var(--dsw-alias-label-primary));" +
@@ -2218,6 +2220,15 @@ window.__ModuleLoader__.load({
22182220
".mneme-set-cmddesc{font-size:12px;line-height:17px;color:var(--mneme-fg-dim);margin-top:1px;word-break:break-word}",
22192221
// --- settings sub-view ---
22202222
".mneme-set{flex:1;min-height:0;overflow-y:auto;padding:8px 24px 48px;box-sizing:border-box}",
2223+
// --- 宿主中列整页面板(sidebar.panellist + main 成对座位)---
2224+
// 宿主把 main 槽渲染在三列 grid 的中列里,那一层只给了 min-width:0 与
2225+
// overflow:hidden,没有任何尺寸约束——注册者必须自己铺满并自管滚动,
2226+
// 否则内容会撑破中列(右栏打开时中列更窄,宽度还会变)。
2227+
".mneme-panel{box-sizing:border-box;flex:1;min-width:0;min-height:0;width:100%;height:100%;display:flex;flex-direction:column;overflow:hidden;background:var(--dsw-alias-bg-layer-1)}",
2228+
// 侧栏图标容器:badge 用绝对定位挂在它上面。宿主 panelRow 没有
2229+
// overflow:hidden,所以 -3px 的偏移不会被裁;这里的 position:relative
2230+
// 只提供定位上下文,不接管尺寸(由宿主的 panelGlyph 决定)。
2231+
".mneme-paneliglyph{position:relative;display:inline-flex;align-items:center;justify-content:center}",
22212232
// --- 记忆库页面:居中 sheet,非全屏 ---
22222233
// 从对话直接打开一页记忆库:背板压暗 + 居中圆角卡片(上限 1180×880),
22232234
// 对话仍留在背板之后,任何状态下(含新会话 hero、无 tab 环)都可用。
@@ -8593,6 +8604,33 @@ window.__ModuleLoader__.load({
85938604
return h("span", { className: "mneme-entrybadge", "aria-hidden": "true" },
85948605
pending > 99 ? "99+" : String(pending));
85958606
}
8607+
// --- 宿主内整页面板(新版宿主):侧栏图标 + 中列整页 ---
8608+
// 首选承载方式:记忆库直接长在宿主中列里,与会话平级,不再叠一层背板
8609+
// 浮层。老宿主没声明 sidebar.panellist 时退回 footer.action + 浮层(见 apply)。
8610+
function SidebarPanelGlyph({ size }) {
8611+
// 红点复用模块级单例:图标与回落按钮共享同一个计数、同一条 60s 兜底轮询。
8612+
const pending = useConflictBadgeCount();
8613+
// 宿主 PanelRow 已经自带 button / aria-label / Tooltip / active 高亮,
8614+
// 这里只交一颗图形——再造一层按钮会套出两颗可聚焦元素,Tab 要停两次,
8615+
// 而且 host 的 selectPanel 也轮不到我们调。
8616+
return h("span", { className: "mneme-paneliglyph" },
8617+
renderMnemeMark({ size: size || 18 }),
8618+
h(ConflictBadge, { pending })
8619+
);
8620+
}
8621+
8622+
function MnemeMainPanel({ t }) {
8623+
// 进面板 = 用户准备处理冻结冲突:重取一次红点计数。理由与浮层时代
8624+
// openLibrary 里那次重取相同——裁决走别的路径或后台刚写过库时,计数
8625+
// 不该等 60s 兜底轮询才对齐。
8626+
useEffect(() => { conflictBadgeCount.refresh(); }, []);
8627+
// 不自带「回到会话」按钮:宿主的 openSession / 新建会话都会
8628+
// selectPanel(null),用户点侧栏任何会话行就回得去(baleen 同样不做)。
8629+
return h("div", { className: "mneme-panel" },
8630+
h(MemoryExplorer, { t })
8631+
);
8632+
}
8633+
85968634
function SidebarFallbackTrigger({ wide, t }) {
85978635
const pending = useConflictBadgeCount();
85988636
// #295 评审:.mneme-trigger 自身 overflow:hidden 且无定位上下文,badge
@@ -9853,13 +9891,26 @@ window.__ModuleLoader__.load({
98539891
const t = ctx.locale.bind(NS);
98549892
ctx.effect(() => ctx.locale.register(NS, dictionaries), "dsh-mneme: dictionaries");
98559893

9856-
// 记忆库唯一入口:sidebar.footer.action 注册作为锚点与回退;真实按钮
9857-
// 由 SidebarTopEntry portal 到侧边栏工作区上方。overlay 从这个常驻
9858-
// 插槽挂载(portal 到 body),会话切换不影响它的开关状态。
9859-
// v0.7.15 起不再注册 conversation.view tab——对话内嵌的面板被悬浮
9860-
// 输入框遮挡、挤压会话布局,sheet 页是更舒服的承载方式。
9861-
ctx.slots.inject("sidebar.footer.action", () => {
9862-
return ctx.slots.register({
9894+
// --- 入口座位 ---
9895+
// 两套宿主形态,二选一,靠宿主是否声明了 sidebar.panellist 判定:
9896+
// · 宿主内整页面板(首选):sidebar.panellist 出图标、main 出中列整页。
9897+
// 图标长在宿主自己的面板列表里(PanelRow 自己处理点击与 aria-current),
9898+
// 插件只管渲染一颗 glyph,不自己造按钮、不自己调 selectPanel。
9899+
// · 老宿主回落:没有这两个座位时,footer.action 出按钮 + 居中 sheet,
9900+
// 并保留 SidebarTopEntry 的 DOM portal(尽量把入口放到面板列表位置)。
9901+
// 两套都挂同一个模块级 overlay 状态,但不会同时装:panellist 一旦出现就
9902+
// 先把回落拆掉,否则侧栏会冒出两个记忆入口。
9903+
// 判定 + 装载都收在两个闭包里:谁都可以问「宿主有没有这套座位」,
9904+
// 也都可以在条件变化后重装回落——但同一时刻至多一份注册在册。
9905+
const hostHasPanelSeat = () => typeof ctx.slots.spec === "function"
9906+
&& ctx.slots.spec("sidebar.panellist") !== undefined;
9907+
let footerSeat = null;
9908+
const dropFooterSeat = () => {
9909+
if (footerSeat) { footerSeat(); footerSeat = null; }
9910+
};
9911+
const mountFooterSeat = () => {
9912+
if (footerSeat || hostHasPanelSeat()) return;
9913+
footerSeat = ctx.slots.register({
98639914
name: "sidebar.footer.action",
98649915
id: "dsh-mneme",
98659916
order: 0,
@@ -9872,6 +9923,41 @@ window.__ModuleLoader__.load({
98729923
}),
98739924
h(MemoryOverlay, { t })
98749925
));
9926+
};
9927+
9928+
ctx.slots.inject("sidebar.panellist", () => {
9929+
dropFooterSeat();
9930+
const disposeGlyph = ctx.slots.register({
9931+
name: "sidebar.panellist",
9932+
id: "dsh-mneme",
9933+
// 排在宿主自己的面板之后(baleen 占 45):记忆是高频入口,但排在
9934+
// 已有面板之后不抢位。order 只影响列表排序,不影响可发现性。
9935+
order: 60,
9936+
label: () => t("memory.panel.open")
9937+
}, (props) => h(SidebarPanelGlyph, { size: props && props.size }));
9938+
// main 的 key 必须与上面侧栏的 id 逐字相同:宿主点面板行时调
9939+
// layout.selectPanel(id),它按 options.key 在 main 槽里找 entry,
9940+
// 对不上直接抛 "main panel ... is not registered"。
9941+
const disposeMain = ctx.slots.register({
9942+
name: "main",
9943+
key: "dsh-mneme"
9944+
}, () => h(MnemeMainPanel, { t }));
9945+
return () => {
9946+
disposeGlyph();
9947+
disposeMain();
9948+
// 座位被撤(宿主折叠该槽 / 换宿主形态)时把回落装回去:两条路径都
9949+
// 只靠各自的 inject 触发,谁不动谁就永远停在「没有入口」的状态。
9950+
mountFooterSeat();
9951+
};
9952+
});
9953+
9954+
// 老宿主回落:footer.action 这一格既能当锚点(SidebarTopEntry 靠它挂
9955+
// portal)也能当兜底按钮,新宿主上则整格不注册——否则侧栏两颗记忆入口。
9956+
ctx.slots.inject("sidebar.footer.action", () => {
9957+
mountFooterSeat();
9958+
return () => {
9959+
dropFooterSeat();
9960+
};
98759961
});
98769962

98779963
// --- better-sidebar 生态 tab(可选软依赖)---

0 commit comments

Comments
 (0)