dsh-model-menu-search

给 DeepSeek Harness WebUI 的模型下拉菜单加一个实时搜索框。点开输入框右下角的模型胶囊后，菜单顶部会出现一个输入框，直接打字就能过滤模型，不用再用鼠标滚。

用法

1. 点输入框右下角的模型胶囊（带 ▼ 的那个按钮）。
2. 菜单顶部出现搜索框，直接打字：

键盘：↓ ↑ 在可见的模型行之间移动，Enter 直接选中，Esc 先清空输入框、再按一次关闭菜单。

为什么 DSH 更新也不容易坏

这是专门针对"插件被 DSH 版本更新搞挂"设计的：

1. 不抢 slot、不改共享服务。 不注册 conversation.input.model 座位，不包装 modelDirectories / directory.select。宿主内部服务改名、改签名都不影响这里。
2. 只用 ARIA 语义属性定位。 靠 role="menu" / role="group" / role="menuitemradio"，不依赖任何哈希类名（DSH 的 CSS Module 类名形如 IecIca_menu，每次构建都变）。并且有三层退化策略，最坏情况下从模型行反推容器。
3. 零 import、零 peer 依赖。 不 require 任何 @deepseek-ai/* 包，所以不会因为核心包版本漂移（rc.7 → rc.8 → 0.1.5-rc.2 …）而崩。
4. 绝不抛错。 每一步都有 try/catch，失败只 console.warn，不会把一个纯装饰插件变成"整棵插件树失败、窗口打不开"的故障源。
5. 保证可见。 原生菜单是 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 匹配、空状态、清空、键盘导航、以及"没有菜单时不抛错"。