dsh-client-ui-model-seat

dsh plugin --profile web add dsh-client-ui-model-seat

dsh-client-ui-model-seat

[English](README.md) · 中文

dsh 输入区的「模型 + 思考强度」控件。它由两个插件合并而来 —— 两者都替换同一个座位，

装在一起必然打架：

• dsh-client-ui-gpt-helper —— 外壳：token 驱动的配色、粒子思考滑块、外观面板、

i18n 词典，以及按会话接线的那一层。

• dsh-model-provider-prefix —— 卡片骨架：provider 列与 model 列并排，悬停决定右列

显示哪个 provider，加载失败的 provider 变成一条重试行。

用它取代任何一个原插件，而不是与它们并存：

dsh plugin remove dsh-client-ui-gpt-helper

dsh plugin remove dsh-model-provider-prefix

维护这个仓库：代码地图、让卡片保持稳定的那几条不变量、测试矩阵、真机验证配方都在

MAINTENANCE.md。

每个版本的改动见 CHANGELOG.md。

适用场景 / Who it is for:

你是…… · 这个插件给你

需要在模型旁边看见 provider 的人 · 一个触发器显示 provider/model，一张卡片带两列。

provider 列表很长的人 · 悬停左列即可；右列换内容，卡片不动。

会调思考强度的人 · 独立的强度触发器 + 粒子滑块；轨道动效常开。

同时装着两个原插件的人 · 一个座位，而不是两个装不到一起的。

依赖 dsh >= 0.2.1-rc.2（engines.dsh）。纯客户端：不发起网络请求、不读凭证、

没有宿主模块。

它做什么

界面 · 行为

模型触发器 · provider/model 一串字（斜杠两侧无间距），加一个箭头。点开是 provider + 模型双列卡片；再点一次关闭。若同一行里已经有别人在报 provider —— dsh-providers-hub 的 JetHub 徽标就挂在座位旁边的 conversation.input.right 槽里 —— 触发器收起自己的前缀、只显示模型名，供应商只出现一次。

强度触发器 · 当前思考档位（Max、Medium……）。点开是粒子滑块；只有当前模型声明了思考档位时才渲染。

provider 列 · 会话目录里的全部 provider 与各自模型数，当前 provider 打勾，加载失败的变成重试行。

模型列 · 列头显示指针所在 provider；列内有一个 30 px 搜索框。悬停左列只换右列，卡片本身不动。

搜索 · 输入时跨全部 provider 搜索，并在每行标出所属 provider。打字过程中卡片保持双列形状 —— 会变形的卡片正是这个插件要消掉的尺寸闪动。

思考滑块 · 沿用外壳的粒子滑块，跑在当前模型的档位阶梯上，支持方向键 / Home / End。

思考面板头部 · 左边是当前档位（点它回到双列卡片），中间那个闪电一下跳到最高思考强度、再按回到开启前那一档，右边是复位按钮 —— 恢复当前模型的默认档位。

外观面板 · Ctrl+Shift+Alt+G。明暗两侧各自的颜色 token、配色库、JSON 导入导出、重置、把一侧套到另一侧、实时预览。

几何：双列布局卡片宽 416 px，思考面板宽 300 px，都夹在视口内；两种布局各留自己的

下限 —— 双列是 8 个模型行即 333 px，思考面板 96 px，卡片不会矮过自身内容，

上限都是 420 px，上方空间更宽裕时卡片翻到触发器之上。

这次合并必须解决的闪动

上游那张卡片以下边缘为锚点、按内容定高度，而内容又由指针下的那一行决定。

当一个 provider 的模型多到卡片装不下时，这三件事闭成一个环：

1. 卡片撑高到装下模型列表，上边缘因此上移；

2. 指针本来在某个 provider 行上，行被推走了 —— 指针现在落在别的行上（或卡片外面），

于是右列换内容或清空；

3. 卡片缩回去，指针又回到原来那行，环重新开始 —— 在旧包上实测 900 ms 内高度翻转 27 次。

合并后的卡片把「框」变成只依赖锚点与布局的函数，环就断了：

• frame(anchor, layout, natural, floor) 是纯函数：把宽高夹进视口，上方更宽裕时翻到触发器之上。
• 自然高度在卡片还隐藏时（data-ready="false"）按 (布局, 状态, 档位数) 只测一次，之后在这个

键不变期间冻结。

• 两列各自内部滚动（scrollbar-gutter: stable），所以再长的模型列表也不改变卡片外高。
• box-sizing: border-box 让内联高度等于测到的高度。
• floor 是卡片当前已有的高度：同一次摆放里后来的重新测量只能把卡片撑大，不会缩到指针底下。

换锚点（尺寸变化、滚动）时 floor 归零重来。

• 搜索词不改变布局，所以打字永远不会改变卡片尺寸。

重新测量只发生在：打开、切换面板、锚点移动（滚动/改窗）、状态变化 —— 悬停时从不测量。

配置

所有面向用户的设置都在外观面板里改，没有 profile 配置键。状态存在一条 localStorage 记录里：

Key · 形状

dsh-client-ui-model-seat:config:v1 · { version: 3, hotkey, paused, crossApply, slots: { light: { scheme }, dark: { scheme } }, schemes: { name: { name, colors } }, sides: { light, dark } }

paused: true 会关掉全部自定义颜色（面板总开关）；slots[side].scheme 指定某一侧启用的配色，

sides[side] 存这一侧逐个 token 的微调（优先级高于配色本身，所以手改的值不会被悄悄吞掉），

crossApply 让一侧的颜色套到两侧。

外壳插件写下的记录（dsh-client-ui-gpt-helper:config:v1）不读：schema 已经变了，

一次半截静默迁移比回到默认值更糟。这条记录在加载时、storage 事件时、窗口重新获得焦点时读取。

dsh-client-ui-model-seat:fast:v1 不再读也不再写：轨道动效常开，旧键原样留着 —— 回滚到 0.1.2 时它的锁定状态还在。

DOM 契约

给 CSS 和测试用的稳定钩子：

元素 · 属性

根 · [data-model-seat="root"]，另有 data-build

触发器 · [data-model-seat="model-trigger"]、[data-model-seat="effort-trigger"]

卡片 · [data-model-seat="menu"]，带 data-pane、data-layout、data-ready、data-flipped、data-ultra

两列 · .ms-col[data-col="providers"]、.ms-col[data-col="models"]

列头 · .ms-colHead，分隔线 .ms-sep

搜索 · .ms-search（在模型列内）

行 · .ms-row[data-kind="provider"\ · model\ · retry"]，data-active、data-current，计数 .ms-count，注记 .ms-rowNote

滑块 · [data-model-seat="thinking-slider"]

颜色面板 · [data-model-seat="config-panel"]，背景 [data-model-seat="config-backdrop"]

兜底 · [data-model-seat="fallback"] —— 错误边界渲染的内容

这就是全部契约：自 0.1.1 起不再输出 data-gpt-helper 或 data-dsh-pm-*。针对任一上游插件

写的 CSS 不再匹配，这正是目的 —— 外壳插件留下的 [data-gpt-helper] 规则本来会把这张卡片

重新涂一遍。npm run validate 会在这两个前缀回来时失败。

安装

dsh plugin add dsh-client-ui-model-seat@0.2.2 # 从 registry（写死版本，见下）

dsh plugin add dsh-client-ui-model-seat # 从 registry（裸包名）

dsh plugin add github:HimA6652/dsh-client-ui-model-seat # 从源码

dsh plugin add link:/absolute/path/to/dsh-client-ui-model-seat # 本地检出

两个通道发布的是同一份文件树。npm 页面是

npmjs.com/package/dsh-client-ui-model-seat，

首次发布是 0.1.2，当前版本是 0.2.2。

裸包名会装到旧版本：pnpm 11 默认有 minimumReleaseAge（1440 分钟）的供应链闸门，裸包名会解析成「满 24 小时的最新版」而不是 latest——实测 2026-10-29 发完 0.2.1 之后 pnpm add dsh-client-ui-model-seat 装到的是 0.1.2。这不是一次性事故而是机制：0.2.2 发出去的当天，满一天的最新版仍然是 0.2.1，裸包名就解析到 0.2.1。要立刻装到最新，把版本写死（@0.2.2，pnpm 会把它记进 profile 的 minimumReleaseAgeExclude）；或者等一天再装。

插件的 bundle 只往 profile 里插一行（id: model-seat），并以 priority: -2 注册它的座位，

所以残留的任一原插件（-1）或内置控件（0）会被遮蔽，而不是撞在一起。

desktop profile 不能用普通 CLI 改 —— 它会回答

profile "desktop" is managed exclusively by the Electron application。改用 desktop host CLI

（见 MAINTENANCE.md 的「安装、升级、回滚」）。

截图是生成的不是手裁的：npm run shots 把真实 bundle 渲染在 harness 上、喂一套演示 provider，

然后按 2x 裁出 PNG。

在真实 dsh 上验证

npm run e2e 跑的是夹具页面。要在真实 dsh web 应用里验同一份 bundle 又不动自己的数据，

给它一个一次性的 DSH_HOME：

SEAT_HOME=C:/Users/you/AppData/Local/Temp/seat-live-home

mkdir -p "$SEAT_HOME" && cp ~/.dsh/.credentials.yaml "$SEAT_HOME/"

export DSH_HOME=$SEAT_HOME

DSH=<checkout>/node_modules/@deepseek-ai/dsh/lib/bin.js

node "$DSH" --profile seatc

…(truncated)