liu19666/dsh-model-block-picker

dsh-model-block-picker

按来源分块的输入框模型选择器:先选来源渠道卡片,再下钻进该渠道选择模型,保留跨来源搜索与推理强度调节。

미분류cordisdeepseek-harnessdsh

dsh-model-block-picker

English | 中文

DeepSeek Harness (DSH) 插件 —— 按模型来源分块的输入框模型选择器。

把官方那个「所有模型拉成一条长列表」的选择器,换成先按来源渠道分块、再下钻进块内选模型的两级结构;搜索、推理强度(Reasoning Effort)、模型可用性等原有能力完全保留。

效果

点击输入框右下角的模型位,弹出的不再是长长的平铺列表,而是按来源分块的卡片网格:

  • ① 全局搜索 —— 直接在顶部输入 v3 / sonnet / r1,跨全部来源聚合匹配;回车选中首项。
  • ② 按来源分块 —— 每个渠道一张卡片,标出「N 个模型」与「进入 →」;按住卡片可拖动排序(一次可跨多张)。
  • ③「当前」标记 —— 正在使用的来源高亮描边 + 右上角蓝标。
  • ④ 推理强度彩色滑条 —— 可拖动的 Low → Max 渐变滑条,点击刻度文字可直达。
  • ⑤ 速度 / 输出详略 —— 当前模型支持时才出现,不支持则整行隐藏。
截图中的来源名称已做打码处理。

深色模式使用同一套主题 token,强调色为 --dsw-alias-link(#7aaaff),不再出现白底白字:

搜索框左侧的 ⚙ 打开显示设置:可按提供方整体开关、展开逐个开关模型,行内 ✎ 直接改名、模型行可拖动排序,顶部的「同步到全部界面」把新名字写进模型注册表:

触发按钮本身与同排的截图 / 麦克风图标保持同一设计语言(主题描边与文字):

功能

  • 按来源分块:DeepSeek 账号、DeepSeek API,以及 CodeBuddy / Qoder / TRAE 等第三方渠道,各自成为一张卡片;卡片上显示来源名、模型数量,当前所用来源带「当前」标记。
  • 两级下钻:点卡片 → 进入该渠道内只含它自己模型的列表;顶部 ← 所有来源 或 Esc 返回。
  • 全局搜索:直接输入 v3 / sonnet / r1 等关键词即可跨所有来源聚合匹配,回车选中首项;清空即回到分块视图。
  • 推理强度(彩色滑条):当前模型支持 reasoning 时,浮层底部出现一条可拖动的渐变色滑条(Low → Max 分档,带发光 thumb),点击刻度文字也能直接跳档;右侧显示当前档位,恢复模型默认 一键回到提供方推荐值。
  • 速度 / 输出详略自适应:订阅类提供方(如 ChatGPT 订阅)的模型若支持 speedMode / outputVerbosity,浮层底部会额外出现对应的分段控件;不支持的模型或提供方这两项自动隐藏,不会出现死开关。
  • 显示设置面板:搜索框左侧的圆形 ⚙ 按钮打开设置,可按提供方整体开关、也可展开逐个开关单个模型是否出现在选择器里;展开后每行还有 ✎ 改名入口,模型行可直接拖动排序;顶部显示已隐藏数量,底部一键恢复全部显示与默认顺序。
  • 来源重命名:点 ✎ 输入新名字即可把来源改成任意说法(例如把「ChatGPT subscription」写成「ChatGPT 订阅」)。名称写进模型注册表,所以分组面板、下钻列表和官方 /model 弹窗同时改名;保存在 DSH 状态目录的 aliases.json,适配器重新注册或下次启动后自动重放,设置面板顶部可手动「同步到全部界面」或「恢复默认」。
  • 拖拽排序(来源与模型):按住卡片拖动即可改变来源先后,一次能跨过好几张卡片,落点就是最终位置、中间卡片整体顺移(拖到相邻卡片上即两者互换);显示设置里展开来源后,模型行同样可拖、可跨多行,顺序按来源分别保存。拖动中卡片/行半透明,松手 260ms 内忽略点击,避免误进下钻。
  • 偏好持久化:顺序、隐藏来源、隐藏模型全部写入 localStorage(key dsh-model-block-picker.prefs.v1),刷新与重启后保持;不存在的来源会在下次自动清理。
  • 主题自适应:浅色、深色均用 DSH 主题 token,深色下强调色使用 --dsw-alias-link(#7aaaff)而非会反转成近白的 --dsw-alias-brand-primary。

安装

从本机目录安装(开发 / 自用)

在 DSH 会话里对 Agent 说:

帮我安装位于 `` 的插件

Agent 会执行 plugin_manager(action: 'install_bundle', target: '')。

安装后彻底退出 DSH 桌面端再重新打开(客户端 bundle 有启动基线缓存,仅刷新页面不一定加载新代码)。

卸载:plugin_manager(action: 'remove_bundle', target: 'dsh-model-block-picker'),回退到官方原生选择器。

它是怎么工作的

1. 覆盖官方选择器(Slot 影射)

输入框模型位是 DSH 公开的一个命名插槽:conversation.input.model(kind: "single",会话作用域)。

  • 官方实现注册在优先级 -10;
  • 动态安装的插件注册同名插槽时,系统分配更低的数值即更高优先级获胜;
  • 本插件显式注册 priority: -20,因此作为 winner 覆盖原生组件,卸载即自动回退。
注意:single 槽位要求同优先级唯一,所以必须用负数优先级,否则会抛
single slot already has a registration。

2. 复用官方数据服务(不重复造轮子)

不自己请求后端。通过 ctx.modelDirectories:

const directory = models.directoryFor(sessionId);
directory.store   // 快照:{ groups: [{ id, name, models: [...] }], current: { provider, model, reasoningEffort } }
directory.load()  // 拉取目录
directory.select({ provider, model, reasoningEffort })  // 提交选择

与 /model 命令弹窗共用同一份会话级目录,任一入口的切换另一入口立即可见。

3. 深色外观的白,来自主题而不是硬编码

早期版本手写 #1c1f23 之类的兜底色,在深色下不会反转,导致字和箭头变深灰。现在全部改用真实 token:

用途 · token · 深色取值 主文本 · --dsw-alias-label-primary · #f9fafb(off-white,非纯白) 边框 · --dsw-alias-border-l1 · #ffffff0f 背景 · --dsw-alias-bg-layer-1/2、--dsw-alias-bg-overlay · — 品牌色 · --dsw-alias-brand-primary · —

深色下额外用 body[data-ds-dark-theme] 把触发按钮设为 .5px 描边 + 该 token,与右侧截图插件 (color: var(--dsw-alias-label-primary) + fill:none stroke=currentColor stroke-width=1) 保持同一笔画重量。

踩坑记录:写 CSS 时别凭印象编变量名。DSH 里不存在
--dsw-alias-text-regular、--dsw-alias-border-subtle、--dsw-alias-surface-overlay、
--dsw-alias-primary 这些名字——它们会静默回落到你写的兜底值,浅色看着没事、深色就崩。
可用 cordis_inspect_query(platform: 'client', provider: 'Theme', method: 'listTokens') 查真实 token。

文件结构

dsh-model-block-picker/
├── package.json          # 清单:dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml      # Loader patch:把本包插进 profile 名单
├── index.js              # 宿主半边(/diag 诊断 + /aliases 改名持久化)
├── client.js             # 浏览器半边:React 组件 + 样式 + 插槽注册
├── CHANGELOG.md
├── LICENSE
└── README.md

诊断

排障时会用到:

  • 宿主侧日志前缀 [dsh-model-block-picker](DSH 日志里搜这个)。
  • 来源改名:GET /plugins/dsh-model-block-picker/aliases 返回 { ready, store, aliases, providers },其中

providers[].base 是注册表原名、name 是当前生效名,ready:false 说明模型服务还没起来。

  • 浏览器端各生命周期节点会打到 /plugins/dsh-model-block-picker/diag:

module-evaluated → apply-called → slot-inject-triggered → registered-success。 若停在 register-error,说明槽位/优先级冲突;停在 apply-error 多半是 inject 未声明就访问了服务。

另一个坑:客户端沙箱对服务访问有白名单。顶层 inject 声明了 ['slots','modelDirectories'],
就不能再直接读 ctx.sessions,否则抛 service "sessions" is not declared 并当场崩溃。

已知限制

  • 只替换输入框(composer)的模型位;/model 命令弹窗仍是官方样式(两者共用同一份数据,切换互通)。
  • 已寻址的 subagent 会话不提供模型选择(沿用官方约定)。
  • 来源分组顺序:默认 DeepSeek 账号 → DeepSeek 官方 → 其余按名称排;可直接在面板里拖动卡片自定义顺序,保存于 localStorage。
  • 速度 / 输出详略依赖提供方暴露能力:目前只有实现了 speedMode / outputVerbosity 偏好的提供方(如 dsh-codex-subscription 的 openai-codex)会被识别;其他提供方这两项不显示。
  • 来源改名是写进模型注册表的全局改动(官方 /model 弹窗等界面一并改名),保存在 DSH 状态目录

state/dsh-model-block-picker/aliases.json,跟随 DSH home 而不是浏览器 profile;卸载插件后不再重放。

  • 偏好(顺序、隐藏项)保存在浏览器 localStorage,因此按浏览器 profile 隔离,不随 DSH 账号同步。

许可

MIT