READMESource: main@9833f1da
dsh-model-menu-search
给 DeepSeek Harness WebUI 的模型下拉菜单加一个实时搜索框。点开输入框右下角的模型胶囊后,菜单顶部会出现一个输入框,直接打字就能过滤模型,不用再用鼠标滚。
用法
- 点输入框右下角的模型胶囊(带 ▼ 的那个按钮)。
- 菜单顶部出现搜索框,直接打字:
| 输入 | 效果 |
|---|---|
glm |
按名称子串过滤(大小写无关) |
glm53 |
归一化匹配:忽略 - _ . / 空格,命中 glm-5.3-prime |
dsr1 |
子序列/缩写匹配:命中 deepseek-reasoner-1 |
@bailian |
只看某个供应商(@ 前缀) |
@bailian qwen |
供应商 + 关键词组合 |
reasoner; 32b |
空格 / 逗号 / 分号 / 斜杠 / 竖线都当分隔符 |
键盘:↓ ↑ 在可见的模型行之间移动,Enter 直接选中,Esc 先清空输入框、再按一次关闭菜单。
为什么 DSH 更新也不容易坏
这是专门针对"插件被 DSH 版本更新搞挂"设计的:
- 不抢 slot、不改共享服务。 不注册
conversation.input.model座位,不包装modelDirectories/directory.select。宿主内部服务改名、改签名都不影响这里。 - 只用 ARIA 语义属性定位。 靠
role="menu"/role="group"/role="menuitemradio",不依赖任何哈希类名(DSH 的 CSS Module 类名形如IecIca_menu,每次构建都变)。并且有三层退化策略,最坏情况下从模型行反推容器。 - 零 import、零 peer 依赖。 不 require 任何
@deepseek-ai/*包,所以不会因为核心包版本漂移(rc.7 → rc.8 → 0.1.5-rc.2 …)而崩。 - 绝不抛错。 每一步都有 try/catch,失败只
console.warn,不会把一个纯装饰插件变成"整棵插件树失败、窗口打不开"的故障源。 - 保证可见。 原生菜单是
top = 触发按钮顶部 - 8 - 菜单高度定位、并夹在[12, 视口高-菜单高-12]。菜单比视口还高时top会变成负数,顶部(搜索框所在处)被顶出窗口。插件会把高度夹进视口并把top拉回 12px。
安装在哪儿
装在 desktop profile 里,用 link: 指向本目录(符号/联接而非拷贝):
- 依赖:
~/.dsh/profiles/desktop/package.json→"dsh-model-menu-search": "link:D:/workplace/dsh-model-menu-search" - 名单:同上文件的
dsh.profile.bundles里多一项dsh-model-menu-search - 模块:
~/.dsh/profiles/desktop/node_modules/dsh-model-menu-search→ 指向本目录的目录联接
好处:改本目录里的 lib/client.js 后,只要刷新页面(或重启 DSH)就生效,不需要重新安装、不会被插件市场升级覆盖——这和那些必须改 node_modules 打补丁的插件不一样。
更新日志
- 1.0.3 —— 修「推理档位那里出现多个搜索框」。
原生「推理档位 / 推理等级」面板的行也是
button[role="menuitemradio"],唯一区别是它没有title属性(模型行的title= 模型名)。我原来的识别条件只看 role,于是推理档位面板被当成了"可搜索的模型列表",那里面也被插了搜索框。 修法:① 识别判据加上title([role="menuitemradio"][title])——权限收紧到"只认模型行";② 每次扫描都会刷新"受管但不是模型列表"的菜单,搜索框被自动隐藏,所以切到推理档位时不会留在那儿;③ 硬不变量:每次插入前清掉所有不属于受管状态的搜索框节点,界面上永远只可能有一个;④ 只给有尺寸(可见)的菜单挂钩,隐藏残留不碰。 - 1.0.2 —— 真正修掉「每次打开列表要滚一下鼠标才有搜索框」。
1.0.1 猜的是几何原因,方向错了。真正的原因是触发时机:
· 菜单打开时里面常常还没有模型行(面板默认停在「模型 / 推理档位」两级入口,或者目录还在异步加载);
· 这一瞬间扫描找不到
menuitemradio,就判定"还没有模型菜单"放弃了; · 之后模型行才被渲染出来,而它们只是普通的div/section/button,被相关性判断当成无关节点忽略 → 不会重扫; · 只有scroll事件(我确实监听了)把扫描重新叫起来,搜索框才出现 —— 这就是"要滚一下"。 修法:① 相关性判断加上「变化发生在已知菜单内部」这条(mutation.target.closest('[role="menu"]'));② 只要 DOM 里有[role="menu"]但还没挂上,就排一个 200ms 兜底轮询(最长 5 秒,挂上即停);③ 每次扫描都刷新菜单结构(行来时自动显示搜索框,面板 root→模型 切换也能跟上);④ 加"抹掉→重建"的雪崩上限。 顺带修掉 1.0.1 里一个会被 catch 吞掉的ReferenceError(refreshNow未定义)——它使 1.0.1 的夹取逻辑其实一次都没跑到。 - 1.0.1 —— 夹取改成事件驱动:沉降期逐帧重扫 +
ResizeObserver+ 菜单style监听 + 被抹掉后自愈。(几何方向,非本症状主因,作为加固保留。) 控制台里__dshModelMenuSearch.version可以确认当前加载的是哪个版本。
卸载
# 1) 从 profile 的 package.json 里删掉依赖和 bundles 里的那一项
# 2) 删掉联接
Remove-Item "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-model-menu-search" -Force
排查
浏览器控制台(DSH 窗口里按 Ctrl+Shift+I → Console)里所有日志都带前缀 [dsh-model-menu-search]:
client plugin apply() running—— 浏览器半边已挂载observer installed; watching for the model menu—— 观察器已装attached {...}—— 搜索框已插入,并打印菜单/搜索框的几何信息(menuTop/wrapTop/visible)menu clamped into viewport {...}—— 菜单被夹进视口scan: no model menu in DOM yet—— 还没检测到菜单(正常,打开菜单后会自动挂上)- 任何以
... failed结尾的都是被 catch 住的异常,不会影响 DSH
控制台里还有手动诊断入口:
__dshModelMenuSearch.menus() // 当前识别到的菜单:[{cls, groups, items, hasBox}]
__dshModelMenuSearch.scan() // 立刻重扫一次,返回识别到的菜单数量
测试
node test/dom-smoke.mjs
用最小假 DOM 跑真实的 lib/client.js,覆盖:挂载、样式注入、菜单识别(故意用哈希类名)、搜索框插入位置、高度夹取、归一化/子序列/@provider 匹配、空状态、清空、键盘导航、以及"没有菜单时不抛错"。
No comments yet. Be the first to write one.