dsh-model-fold

dsh-model-fold

模型选择菜单按来源（provider）展开分类 —— 给 DeepSeek Harness 的模型选择菜单加分组导航能力。

English: group the model menu by provider — the menu lists sources first, and each source's models open either in a slide-in side panel (default) or inline below the title. Double-click a source title to switch modes.

功能总览 · At a glance（中英对照 / Bilingual）

导航模式 · Navigation modes

中文	English
菜单只列模型来源（provider），每个来源带 ▸ 箭头与模型数	The menu lists sources (providers) first, each with a ▸ arrow and model count
panel 模式（默认）：点来源从右侧滑出子面板，列出该来源全部模型	Panel mode (default): clicking a source slides in a side panel with all of its models
inline 模式：点来源在标题下方折叠/展开该组模型	Inline mode: clicking a source folds/expands its models right below the title
双击任意来源标题即可切换两种模式，选择即时生效并记住	Double-click any source title to switch modes; the choice applies instantly and is remembered
模式与折叠状态跨菜单打开持久化（localStorage）	Mode & fold state persist across menu opens (localStorage)

选择与视觉 · Selection & visuals

中文	English
正在使用的模型所在来源组标注 (当前·N) 模型名（加粗 + 品牌色徽标）	The active model's source group is labelled (当前·N) model — bold + brand-colour badge
子面板内选中模型保留 ✓ 标记	The selected model keeps its ✓ mark inside the side panel
子面板样式自适应主题（背景/文字/圆角/选中色取自原菜单计算样式）	Side panel adapts to the theme (bg/text/radius/selected colours read from the real menu)

生态与隐私 · Ecosystem & privacy

中文	English
纯 DOM 增强：不移动、不删除任何 React 管理的节点，与其他插件兼容	DOM-only enhancement: never moves or removes React-managed nodes, compatible with other plugins
选择通过程序化点击原菜单真实按钮完成	Selections are made by programmatically clicking the real menu buttons
零网络请求，全部逻辑在本地 DOM 完成	Zero network requests — everything runs locally

---

功能（v0.4.0，双模式）

• panel 模式（默认）：菜单只列来源（▸ 箭头 + 来源名 + 模型数），点击来源从 右侧滑出子面板列出该来源的全部模型；点面板里的模型即完成选择。
• 当前选择一眼可见：正在使用的模型所在来源组标注 (当前·N) 模型名 （加粗 + 品牌色徽标），无需打开子面板就知道用的哪个来源、哪个模型； 子面板内选中项保留 ✓。
• inline 模式：点击来源在下方折叠/展开该组模型（v0.2.0 行为），状态跨菜单记忆。
• 双击任意来源标题在两种模式间切换，选择即时生效并记住。
• 子面板样式自适应主题（背景/文字/圆角/选中色均取自原菜单计算样式）。
• 只做 DOM 增强：面板是插件自建 DOM，选择通过程序化点击原菜单真实按钮完成， 不移动、不删除任何 React 管理的节点，与其他插件兼容。

两种模式的交互细节见 docs/modes.md，版本历史见 CHANGELOG.md。

回滚 / 模式说明

v0.3.0 起为双模式：默认 panel（右侧子面板），双击任意来源标题可切换为 inline （下方列表展开）模式；inline 模式下折叠状态跨菜单记忆。若需要回到 v0.2.0 （单 inline 模式）版本，可从 GitHub Releases 获取历史版本。

安装

在 DSH profile 中安装（依赖 dsh.bundle 自声明，无需手动改 cordis.patch.yml）：

dsh plugin --profile desktop add ./dsh-model-fold-<version>.tgz

或把目录复制到 profile 的 node_modules 并在 profile package.json 的 dsh.profile.bundles 中加入 dsh-model-fold。

原理

目标 DOM 是 @deepseek-ai/dsh-client-ui-model-selection 渲染、portal 到 body 的 div[role="menu"]：其中每个来源是一个 section[role="group"]，首子 div 为分组标题。 插件用 MutationObserver 捕获菜单出现，在标题元素上追加自定义 data 属性与点击事件 （React 不管理这些内容），用 CSS :has() 依据 data 属性隐藏组内模型项——不移动、 不删除任何 React 管理的节点，因此不破坏原组件的渲染与状态。

FAQ

• 装完没效果？ 需要重启 DSH：客户端 bundle 在宿主启动时加载进浏览器， 改动/新装后必须重启才生效。
• /model 命令弹窗里有分组折叠吗？ 没有。本插件增强的是 composer 的模型 菜单（div[role="menu"] 结构）；/model 弹窗是另一套 UI 表面，暂不涉及。
• 双击切换模式会丢折叠状态吗？ 不会。inline 模式的展开/折叠记忆独立保存； panel 模式下所有来源保持收起、由子面板展示。
• 会上传任何数据吗？ 不会。插件没有任何网络请求，全部逻辑在本地 DOM 完成。

License

MIT