前言¶
在 DeepSeek Harness（DSH）的 web 客户端里，换模型和调推理等级往往走默认下拉：provider 一多、模型一长，就要反复点开列表。若你还希望把「常用」和「某 provider 全量」分开看，原生座位不一定顺手。dsh-gear-grid-model 是社区插件，把输入框旁的模型座位换成 Gear Grid（2D Cosmic Shifter） 风格：28px 药丸触发器 + 星野弹窗，在同一界面里完成模型与思考强度选择；模型列表不另建数据源，直接读 ctx.modelDirectories，与 /model 命令、原生座位同源。
下面按定位、能力、安装与用法说明；事实以 GitHub 仓库 README 为准。
这是什么¶
dsh-gear-grid-model（npm 包名）由维护者 Hana-ame 发布，分类属于 模型推理，面向 DSH web 客户端的纯浏览器端 UI 插件。宿主侧 index.js 的 apply() 为空，行为集中在 client.js；通过 package.json 的 dsh.bundle.patch（cordis.patch.yml）与 dsh.client 自声明注入 web bundle，由客户端模块扫描器拾取。原生模型座位仍留在 DOM 树中但隐藏，避免影响其它依赖，本插件只做显示层替换。
核心功能¶
Gear Grid 座位与星野弹窗¶
输入框模型座位变为药丸触发器，展示当前模型、思考强度与箭头；点击后弹出全屏宇宙弹窗（标题为「GEAR GRID · 选择模型」），带闪烁星野背景。
「常用」、provider tab 与搜索¶
- 「常用」tab：仅显示手动收藏（☆ 或键盘
F）的模型，按 provider 分组；未收藏时有引导文案。 - provider tab：每个 provider 一个 tab（如 SenseNova · Key Pool、SiliconFlow · Key Pool、DeepSeek 等），展示该 provider 下全部可用模型。
- 搜索：按
/聚焦搜索框，按模型名或 id 跨 provider 过滤，结果仍按 provider 分块。
药丸即「模型 + 推理强度」¶
每个模型一颗药丸：名称、思考强度分段（适配器声明了 efforts 的模型才有 Off/Low/High/Max 等分段）、收藏星。点分段可同时设定模型与推理等级；Enter 或点击完成选择。
键盘与视觉¶
方向键 ← → ↑ ↓ 移动焦点，Enter 选择，F 收藏，/ 聚焦搜索，Esc 关闭。样式仅使用 DSH 主题令牌（--dsw-*），宇宙色相由 color-mix 派生，随明暗主题变化。provider 组头 8px 色点可改色：9 个预设、原生取色器、「自动」回退，偏好写入 localStorage。
v1.1 可复用组件¶
自 v1.1.0 起，客户端 bundle 额外导出 GearGridPicker、ensureGearGridStyles 等，供其它插件嵌入同一选择器；调用方自行管触发器与弹窗开关，拿不到导出时应回退普通下拉（README 中有 require 与 jsx 示例）。
安装与启用¶
要求：已安装 DeepSeek Harness（dsh），并使用 web profile。安装命令来自 README 原文：
# 从 npm 安装（发布后）
dsh plugin --profile web add dsh-gear-grid-model
本地开发可用 link 方式编辑 ~/.dsh/profiles/web/package.json 后执行 dsh --profile web（路径以你本机为准）。装完后需 重启 dsh。
插件以当前 dsh 进程权限运行；安装前建议浏览 GitHub 源码 与 MIT 许可证（见仓库 LICENSE），确认符合你的安全与合规要求。
典型用法¶
- 打开：点输入框旁药丸触发器（显示当前模型）。
- 浏览：「常用」看收藏；点 provider tab 看该 provider 全量模型；按
/聚焦搜索并按名称过滤。 - 收藏：鼠标悬停点 ☆，或焦点在模型上按
F。 - 选择：方向键移动焦点，
Enter或点药丸/强度分段，一次定好模型与推理等级。 - 关闭：
Esc或点击遮罩外区域。
适用场景与注意¶
适合经常在 web 客户端切换 provider、模型与推理强度，且希望「常用」与全量列表分开管理的 DSH 用户。不适合非 web 客户端：本插件 dsh.client.platform 仅为 web。
数据完全依赖运行时 ctx.modelDirectories；若宿主未加载模型目录，界面与原生 /model 行为一致地受同一数据源约束。社区目录页 SkillHub · dsh-gear-grid-model 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-gear-grid-model 用 Gear Grid 交互替换默认模型下拉，在星野弹窗里完成模型与推理强度的一次性选择，并复用 DSH 原生模型目录。进一步了解可访问目录页与仓库：
- 目录页：https://www.skillhub.cn/plugins/Hana-ame/dsh-gear-grid-model
- GitHub：https://github.com/Hana-ame/dsh-gear-grid-model
