@lynn123411/dsh-model-submenu 0.3.5 → 0.3.11

package/DETAILS.md

@@ -20,9 +20,67 @@ dsh plugin --profile web add @lynn123411/dsh-model-submenu
 
 这条行同时承载两个半边：宿主半边在那条行下注册插件本体，浏览器半边由 Web shell 按 root loader 的 enabled entry 依据 `dsh.client` 声明服务 `lib/client.js`。行不写 `config`——写了当场抛，免得拼错的行静默什么都不注册。
 
-客户端半边声明的服务（`dsh.client.inject`）：`@deepseek-ai/dsh-api-remotes`、`@deepseek-ai/dsh-client-locale`、`@deepseek-ai/dsh-client-ui-model-selection`、`@deepseek-ai/dsh-client-ui-settings`、`@deepseek-ai/dsh-client-ui-slots`。少声明一个不会报错，只会让插件在页面里消失。
+客户端半边声明的服务（`dsh.client.inject`）：`@deepseek-ai/dsh-api-remotes`、`@deepseek-ai/dsh-client-locale`、`@deepseek-ai/dsh-client-ui-conversation`、`@deepseek-ai/dsh-client-ui-model-selection`、`@deepseek-ai/dsh-client-ui-settings`、`@deepseek-ai/dsh-client-ui-slots`。少声明一个不会报错，只会让插件在页面里消失。
 
-客户端半边读的 cordis 服务（源码 `src/client/index.ts` 的 `inject`）与上表是两层声明，缺一层整条 loader entry 静默变 failed：`configForms` 提供设置页那份共享缓存，`remote` 与 `remote.llm` 回答每个供应商的设置在哪个命名空间，`remote.session` 与 `modelDirectories` 供模型目录，`sessions` 判断子代理会话，`slots` 与 `locale` 各自是本插件的座位与文案。
+客户端半边读的 cordis 服务（源码 `src/client/index.ts` 的 `inject`）与上表是两层声明，缺一层整条 loader entry 静默变 failed：`configForms` 提供设置页那份共享缓存，`remote` 与 `remote.llm` 回答每个供应商的设置在哪个命名空间，`remote.session` 与 `modelDirectories` 供模型目录，`sessions` 判断子代理会话，`slots` 与 `locale` 各自是本插件的贡献与文案。
+
+## 三处贡献与一个 store
+
+宿主渲染模型菜单是 `{open && createPortal(...)}`：菜单一关，整棵子树卸载。所以本插件拆成三处贡献，前两处之间用一个插件自己的 store 传递「哪个会话要开弹窗」：
+
+| 贡献 | 槽位 | 职责 |
+| --- | --- | --- |
+| `ModelMenuBridge` | `conversation.input.model.options`（list，`id: model-menu-bridge`） | 渲染一个隐藏标记；在根菜单打开期间于菜单面板上装捕获阶段的点击监听：命中第一格就拦下、调宿主的 `dismiss()`、写 store；命中第二格就拦下下钻——点标签切回 provider default，点别处把焦点交给滑块；同时把 `EffortSlider` 挂进第二格 |
+| `ModelPickerHost` | `conversation.input.overlay`（list，`id: model-picker`） | 常驻；store 指向本会话时渲染弹窗、收藏、思考等级记忆与提交 |
+| `EffortTint` | `conversation.input.overlay`（list，`id: model-effort-tint`） | 常驻；把输入框触发器上的档位文字染成当前档位的颜色。它必须常驻，因为那处文字在菜单之外 |
+
+`picker-state.ts` 的 store 只有 `open` / `close` / `getSnapshot` / `subscribe` 四个动作，重复 open 同一会话不重复通知。这一形态与宿主自己的 `ui-commands`（`PopupSelectController` + `PopupSelectView`）一致。
+
+## 为什么是改道，不是接管座位
+
+根菜单的前两格（模型、推理等级）由宿主 `ui-model-selection` 的 `ModelSelect` 自己画，点击写死在组件里，槽位没有给这两格留注入点。要改这两格，只有两条路，而其中一条走不通：
+
+- **接管 `conversation.input.model`**：`renderSlot` 的授权按注册项发放（`entry.children`），而 `conversation.input.model.options` 这个子槽已经被宿主的注册声明，再声明一次当场抛 `already declared`。所以一旦以 `priority: -100` 盖住宿主座位，本插件拿不到 `renderSlot`，`ui-agent-team` 的团队协作开关整行消失。
+- **改道这两格**：不动座位，只在根菜单打开期间（这条贡献的挂载期）于菜单面板 `[data-menu-material]` 上装捕获阶段的监听，认面板的直接 `role="menuitem"` 子元素为宿主的两格。捕获阶段拦在面板上，事件到不了 React 根容器的冒泡监听，宿主写死的下钻不会执行。
+
+这条路的代价是依赖宿主根菜单的 DOM 形状，所以认不出来时**什么都不做**：点击退回宿主原来的下钻，插件其余部分照常工作。宿主升版后按 `docs/rules/kernel-upgrade.md` 的顺序复核这一条契约。
+
+## 推理等级那一行的 DOM 契约
+
+滑块要嵌进宿主自己画的那一行，所以这一行有四处约定，全部实测自 0.2.2-rc.2：
+
+| 认什么 | 怎么认 |
+| --- | --- |
+| 菜单面板 | 标记 span 的 `closest('[data-menu-material]')` |
+| 两格 | `panel.querySelectorAll(':scope > button[role="menuitem"]')`：`[0]` 模型格、`[1]` 推理等级格。槽位输出在各自的 `[data-slot]` 包裹层里，别的插件往 options 槽加行不会混进这个列表 |
+| 标签 | `span[class*='cellLabel']`（哈希前缀随构建变，局部名不变） |
+| 档位文字 | `span[class*='cellValue']` |
+| 箭头 | `svg[class*='cellChevron']` |
+| 触发器上的档位文字 | 从 `closest('[data-composer-card]')` 往下找 `[data-slot="conversation.input.model"] button[aria-haspopup="menu"] span[class*="triggerEffort"]` |
+
+挂上滑块时对宿主那一行做三处内联样式改动，改前存原值、卸载时写回：
+
+| 节点 | 改动 | 效果 |
+| --- | --- | --- |
+| `cellValue` | `display: none` | 档位文字在输入框下面已经有一份，这一行不再重复 |
+| `cellChevron` | `display: none` | 去掉已经不存在下钻的箭头 |
+| 滑块根节点 | `flex: 1 1 auto`、`min-width: 96px` | 落在标签右边，铺满整条空档 |
+
+模型只声明一档（或没有档位）时整条链不启用，宿主那一行原样保留。滑块本身是 `role="slider"` 的独立焦点节点，键盘左右/上下/Home/End 逐档调整；它与宿主那一行同排，因此技术上属于 `<button role="menuitem">` 里的交互子元素——宿主没给这一行留注入点，同线插件 `Microqian2th/dsh-codex-effort-slider` 也采用同一形态。
+
+## 滑块的三种状态
+
+| 状态 | 轨道 | 旋钮 |
+| --- | --- | --- |
+| Off | 空——填充只有旋钮那么大，完全藏在旋钮底下 | 实心白 |
+| 中间档 | 该档的纯色，右端圆弧落在旋钮底下 | 实心白 |
+| 最高档 | 整条蓝→紫渐变，铺到轨道尽头 | 实心白 |
+| provider default | 空 | 空心环，停在模型声明的默认档（没声明就停最左） |
+| 拖动中 | 跟着指针连续移动 | 实心白，松手吸附到最近一档并提交 |
+
+轨道高 16px、旋钮直径 20px：旋钮比轨道大一圈，两端因此露出轨道自己的圆角，旋钮不会被误读成轨道的端帽。填充是「轨道形状裁到旋钮」——右端圆弧取轨道的半径、圆心落在旋钮底下，所以色块是钻进旋钮而不是在它旁边直切一刀；最高档的填充宽度正好铺满整条轨道。
+
+拖动时旋钮跟的是指针的连续位置（`fractionAt`），不是一档一格：档位取离指针最近的那个刻度（`detentAt`），所以旋钮在两档之间也能停在任意位置，只有跨过中点才换档。松手时旋钮用 160ms 的缓出滑到那个刻度上再提交；拖动期间这条过渡关掉（`data-dragging`），否则旋钮会落后于指针。`prefers-reduced-motion` 下过渡一律关掉。provider default 不是档位：`effortChoices` 只返回模型声明的真实等级，默认态由 `state.current.reasoningEffort === undefined` 判定，点标签提交 `reasoningEffort: undefined` 切回去。颜色由 `level-color.ts` 的 `levelColor(index, count)` 给出：`0` 是中性灰，其余档位把「Off 以上」均匀铺在蓝→紫的斜坡上，最高档固定取紫端并用整条渐变填充。
 
 ## 开发副本
 
@@ -45,8 +103,8 @@ cd plugins/dsh-model-submenu && pnpm check
 
 `check` = `typecheck` + `build`（tsdown）+ `smoke` + `test` + `assert:lib-untracked`。
 
-- `scripts/smoke-client.mjs` 按 Web shell 的方式装载构建产物 `lib/client.js`（`window.__ModuleLoader__.load` 桩件），喂假 cordis 服务，断言导出身份、`inject` 表逐字相等、产物里走的是共享的 `MenuSurface` 与 `Modal`、以 `priority: -100` 接管 `conversation.input.model` 座位、字典键集中英对齐、元信息取数确实问过设置镜像与供应商目录，以及「设置没答案时答未知而不猜」。末尾那段用真 `SlotCore` 钉住宿主的子座位契约，测的是宿主行为。
-- `scripts/test-favorites.mjs`：收藏表的键名、读写、坏值降级、跨供应商靠前排序。`scripts/test-facts.mjs`：设置值到上下文窗口与图片输入的映射、两类适配器的字段差异、缺字段整段略去。`scripts/test-commit.mjs`：点模型立即提交、思考等级关菜单才提交、已选中的模型不重复提交。`scripts/test-rows.mjs`：目录拍平、标签页派生、搜索的两把钥匙。`scripts/test-render.mjs`：用真 react 把菜单与弹窗画进 jsdom，锁住点模型立即提交、思考等级关菜单才提交、收藏靠前、星标不可点只做标记、加载与失败各占一行、写入失败留在菜单或弹窗。
+- `scripts/smoke-client.mjs` 按 Web shell 的方式装载构建产物 `lib/client.js`（`window.__ModuleLoader__.load` 桩件），喂假 cordis 服务，断言导出身份、`inject` 表逐字相等、三处贡献各自的 list `id`（`model-menu-bridge`、`model-picker`、`model-effort-tint`）、前两处共用同一个 store、着色那条读同一个目录、产物里走的是共享的 `Modal`、产物里带着认宿主菜单面板（`data-menu-material`）、两格（`:scope > button[role=`）、档位文字（`span[class*='cellValue']`）与触发器档位文字（`span[class*="triggerEffort"]`）的四段选择器、滑块以 `role="slider"` 暴露给辅助技术、字典键集中英对齐且带着滑块那三条文案、元信息取数确实问过设置镜像与供应商目录，以及「设置没答案时答未知而不猜」。末尾 7 条是 store 自身的契约：起始关闭、open 发布目标、重复 open 不通知、第二次 open 替换目标、close 清空、退订后静默。
+- `scripts/test-favorites.mjs`：收藏表的键名、读写、坏值降级、跨供应商靠前排序。`scripts/test-facts.mjs`：设置值到上下文窗口与图片输入的映射、两类适配器的字段差异、缺字段整段略去。`scripts/test-commit.mjs`：点模型立即提交、已选中的模型不重复提交、记住的档位不在可选档里时不强塞。`scripts/test-rows.mjs`：目录拍平、标签页派生、搜索的两把钥匙。`scripts/test-slider.mjs`：滑块几何与配色——档位到轨道比例、拖动位置是连续比例而不是逐档跳、比例换回最近一档且跨过中点才变、指针到最近档、两端夹取、单档与零宽轨道的退路、填充圆弧始终藏在旋钮底下且末档铺满轨道、Off 的中性灰、蓝到紫的两端、只有最高档用渐变。`scripts/test-render.mjs`：用真 react 把菜单桥、触发器着色与弹窗画进 jsdom，40 条用例锁住「点宿主第一格 → 关菜单 → store → 弹窗」这条链、宿主那两格的下钻确实没执行、点标签切回默认、点滑块以外的位置把焦点交给滑块、刻度数与旋钮位置、数值与箭头隐藏、Off 灰/中间纯色/最高档渐变、触发器档位文字跟着变色且默认态交还宿主颜色、默认态空轨道与空心旋钮、拖动松手才提交一次、按下与松手同任务也不丢提交、末档与进行中不提交、被拒走宿主提示、单档与无档位不挂滑块、卸载后样式写回，以及弹窗侧的收藏置顶、星标独立、提交与拒绝、思考等级记忆、加载与失败、会话不可选时整块不渲染。
 - `lib/` 是构建镜像，`assert:lib-untracked` 判它没被 git 跟踪。
 
 要肉眼确认页面上的形态，用仓库的 `node tools/verify-client.mjs dsh-model-submenu --needle '<你新写的类名或文案>'`。

package/README.md

@@ -1,23 +1,24 @@
 # @lynn123411/dsh-model-submenu
 
-把输入框旁的模型选择器换成两层：一层只列当前供应商的模型与思考等级，一层弹窗列全部供应商的模型，可搜、可收藏。
+输入框模型菜单的两处增强：第一行「模型」直接打开列出所有供应商模型的弹窗，第二行「推理等级」变成一条可拖动的滑块。
 
 ## 功能
 
-- **小菜单只列当前供应商的模型**：顶部一行灰色供应商名，下面按供应商目录排模型；已收藏的排前面并带金色实心星，当前模型带勾选。点模型立即切换并关闭菜单。
-- **思考等级就地切换**：一行分段按钮，模型配了几档就显示几档，放不下时这一行横向滚动；点一下只改选中态，菜单关闭时才写入，没有改动就不写。模型不提供思考等级时整行隐藏。
-- **弹窗列全部模型**：顶部搜索框（模型名与供应商名都搜）、每个有模型的供应商一个标签页、每行下面一行元信息（供应商、上下文窗口、思考、图片输入）。点模型立即切换；星标只切换收藏，不选中、不关弹窗。
-- **收藏按目录顺序靠前**：收藏表存在浏览器本地，整台浏览器共用一张；目录里消失的模型保留收藏，回来时还在。
-- **目录角标照常显示**：模型目录给模型声明角标时，触发器与两处列表都按目录给的文案与色调画出来，与宿主座位一致。
-- **失败与加载都有交代**：加载中一行文字、加载失败一行文字带「重新加载」、提交被拒弹出与内置同款的提示气泡；点模型被拒时小菜单保持打开，关闭菜单时被拒则界面回退到提交前。
+- **第一行就是入口**：菜单里的「模型」点下去直接打开弹窗，不再只列当前供应商；顶部搜索框同时搜模型名与供应商名，每个有模型的供应商一个标签页。
+- **第二行是滑块**：推理等级不再下钻到档位列表，拖动时旋钮跟着指针走、松手吸附到最近一档并切换，键盘左右键逐档调整；轨道上的刻度点数就是该模型可选的档位数，旋钮比轨道大一圈。
+- **档位有颜色**：Off 是灰色，往上从蓝走到紫，只有最高档的填充是渐变；输入框触发器上的档位文字跟着同一套颜色走。
+- **默认档位是一个状态**：点最左边的「推理等级」四个字切回 provider default——轨道空着、旋钮是空心环，不会被误认成最低档；再拖一下滑块就回到明确档位。
+- **收藏靠前**：每行右侧一个星标，点它只切换收藏、不切换模型；收藏表存在浏览器本地，整台浏览器共用一张，收藏的模型排在列表前面。
+- **记住每个模型的思考等级**：在弹窗里选中某个模型时，恢复这台浏览器上次为它选的思考等级；该模型不提供那一档时退回它的默认档。
+- **元信息一行说清**：模型名下面一行写供应商、上下文窗口、是否支持思考、是否支持图片输入。
+- **失败与加载都有交代**：加载中一行文字、加载失败一行文字带「重新加载」、提交被拒弹出提示气泡并留在弹窗里，好让用户换一个。
 
 ## 特性
 
-- **两层各管一件事**：小菜单只服务当前供应商的常用模型与思考等级，换供应商、跨供应商找模型都走「更多模型…」打开的弹窗；宿主自带的 `/model` 命令保持原样。
-- **紧凑态照宿主**：输入框放不下一行时只剩图标，跟随宿主给 `conversation.input.model` 的两个显示变量。
-- **定位与进行中反馈照宿主**：菜单定位用宿主的 `useAnchoredPosition`，随 visualViewport、移动键盘与桌面边框自动避让；提交中触发器显示进行中的状态点，弹窗在移动端不自动聚焦搜索框。
+- **不改宿主菜单，只改那两格的用途**：触发器、菜单面板、标签与档位文字仍由宿主渲染；本插件经 `conversation.input.model.options` 在根菜单打开期间接管两格的点击，并把滑块挂进第二格，不自绘触发器与菜单。宿主菜单的形状认不出来时它什么都不做，两格退回宿主原来的下钻；模型只声明一档时不挂滑块，那一行原样保留。
+- **弹窗住在常驻浮层**：菜单在点击后立刻卸载，所以开合请求经插件自己的 store 交给 `conversation.input.overlay` 里的常驻视图，弹窗不随菜单一起消失。触发器上的档位文字在菜单之外，由同一条浮层里的另一处贡献着色。
 - **元信息只写有把握的**：上下文窗口与图片输入读宿主设置页那份共享缓存（`ctx.configForms.describe()`）：上下文窗口只认模型自己声明的值，图片输入在模型没写时按该供应商的默认模态判断；判不出来的与明确不支持的都整段略去，既不写「未知」也不写「不支持」。工具调用在宿主里没有对应字段，一律不写。
-- **接管内置座位**：以 `priority: -100` 占据 `conversation.input.model`，外观沿用内置弹层与 `--dsw-*` 主题变量。座位下的 `conversation.input.model.label` 子座位归声明它的注册项所有，接管方不能再声明它，因此第三方往该子座位写的名称/角标扩展在接管期间不会显示；形态与装配见 [DETAILS.md](./DETAILS.md)。
+- **外观沿用宿主**：弹窗用宿主的 `Modal`，滑块与弹窗的行只写内容与间距，配色取 `--dsw-*` 主题变量。装配与自检清单见 [DETAILS.md](./DETAILS.md)。
 
 ## 安装