dsh-better-model-selector

给 DSH 的模型选择器补上三样东西：每个模型只给官方那几档推理等级、一行「上下文长度」，和一行「视觉」。

自定义网关（中转站、自建反代）里的模型，DSH 不知道该怎么给档位：要么一套五档全给，要么干脆没有。 但 sol 只认 low/medium/high/xhigh，deepseek 只有 high/max，gpt 系列有的四个有的两个。 这个插件按 DSH 自带的官方模型目录逐模型对齐，一档不多给。

上下文窗口则默认一个字都不改——中转站报的窗口常常比实际能给的大，写大了直接 400。 真要放大，在模型面板里现点一下，只影响当前这个模型，随时能退回默认。

视觉同理：官方目录对不上的网关模型，DSH 一律按纯文本处理，图片会被丢掉。 网关后端其实认图的话，在面板里把「视觉」点成「支持」即可。

装完是什么样

打开对话栏的模型选择器，根面板从两行变四行：

模型          gpt-6.1-sol      ›
推理等级      high             ›
上下文长度    默认              ›     ← 插件加的
视觉          默认              ›     ← 插件加的

点「上下文长度」或「视觉」都是整页替换，和点「推理等级」的手感一致（不是在面板上再叠一层浮层）：

默认   ✓
262K
524K
1M
2.1M

选项	含义
默认	不写任何配置，用 DSH 自己的默认窗口
262K / 524K / 1M / 2.1M	把这个模型的窗口设成这个值
更小的值	不列——比 DSH 默认还小，调了没意义

「视觉」页是三项，写的是模型条目的 input：

选项	写入	含义
默认	删掉 input	交回 DSH：官方目录认得这个模型就用官方的，否则按 provider 的 defaultInput（缺省纯文本）
支持	input: [text, image]	图片照常发给模型
不支持	input: [text]	明确纯文本，图片不发

几条使用上的约定：

• 选中立即生效，不用重启，下一次请求就按新配置算。
• 只改当前这一个模型。同一个网关下的其他模型不动；只有 maxTokens 超过你选的窗口时，它才会跟着降下来。
• 按 Esc 退一级：选项页回到根面板，再按一次才关面板。

安装

cd ~/.dsh/profiles/desktop
pnpm add git+https://github.com/Asaiuta/dsh-better-model-selector.git
# 然后在 package.json 的 dsh.profile.bundles 里加上 "dsh-better-model-selector"
# 重启 DSH

本地改代码调试时换成 pnpm add link:/path/to/dsh-better-model-selector。 想锁版本就在地址后面加 tag：pnpm add git+https://github.com/Asaiuta/dsh-better-model-selector.git#v0.2.0。

本插件没有发布到 npm：dsh-better-model-selector 这个名字在 npm 上已经属于另一个 同领域但实现不同的插件（Khellendros97/dsh-better-model-selector）， 所以只从 GitHub 装。

装好之后日志里会有这么几行，可以拿来确认它在干活：

[better-selector] 官方目录已加载：1650 条（…/app.asar (43 个 provider 数据文件)）
[better-selector] 目标配置: …\profiles\desktop\cordis.patch.yml / 档位: catalog / 容量: off
[better-selector] 已更新 34 个模型（启动），备份 cordis.patch.yml.bak-better-selector-…
[better-selector] 官方不给档位的模型 3 个，配置保持原样: ziyong/MiniMax-M3, …

配置

在 cordis.patch.yml 里给插件加 config，全都可以省略：

- id: better-selector
  config:
    mode: catalog        # 档位：catalog（默认，按官方重写）| fill（只补缺失）
    capacity: off        # 容量：off（默认，一个字段都不写）| fill（只补缺失）| catalog（按官方重写）
    demote: false        # 官方判定「无档位」时是否写 reasoningEfforts: false
    patchPath: null      # 不填则按 DSH_HOME/profiles/<profile> 推导
    backup: true
    watch: true          # 监听配置变化后自动同步

日常用默认值就行。只有想让插件顺手把官方窗口也写进配置时才动 capacity——多数网关撑不住官方报的数。

档位是怎么定的

数据来自 DSH 自带的官方模型目录（就在安装目录里），不是插件自己维护的表格。 DSH 升级时这份目录一起更新，所以新模型发布后不用等插件发版，重启一次就跟上了。

• 官方给过哪几档就写哪几档，不推断、不补档、不倍增。
• 「官方给过哪几档」按 DSH 自己的读法算：官方表里没写的 low / medium / high 是"支持"、 没写的 off 是"能关"，写了 null 才是不支持。所以 Claude 官方那张只写了 xhigh / max 的表， 写进配置是 off + low…max 六档，不是两档。
• 同一个模型官方目录里有多条通道记录时，取票数最多的那套档位；平局取交集，交集为空就不动。
• 名字对不上时依次试：原 id → 去掉前缀后缀（[free]、z-ai/、-coding、-reversed）→ 同族借用 → 都不中就保持原样，日志点名。
• 运行期零网络请求，数据全在本机。

常见问题

档位还是不对？ 先确认 DSH 重启过（配置和插件都只在启动时读一次）。其次看网关是否真的支持—— 插件只保证"官方目录里这个模型有哪几档"，管不了中转站后端认不认。

第三行的值显示「默认」，但实际窗口不是 262K？ 「默认」的意思是"这个模型没写过窗口配置"， 具体数值由 DSH 的 defaultContextWindow 决定，插件不写死也不显示它。「视觉」的「默认」同理： 插件只知道你没写过 input，至于最后算出来认不认图，取决于官方目录和 defaultInput。

新加的两行是灰字、点不动？ 两种情况：这个模型不在用户配置层（上层 models 数组里没有它的条目）， 或者整份设置是只读的。悬停会显示具体原因。插件不会画一个点不动的控件骗你。

想看它到底改了哪些行？ 日志里的 [better-selector] 前缀，或者手工跑一遍只看不写：

node bin/sync.mjs --patch <cordis.patch.yml> --dry-run --explain

每一行末尾会标出来源是 exact / normalized / family。

已知限制

• 官方口径不等于网关能力。网关把 gpt-5.6-sol 接到只认 high 的后端，官方范围就会偏宽； 官方报 1M、实际只给 256K 更常见。插件不探测端点（设计如此），所以窗口默认不动，交给你手选。
• 「视觉」也不探测网关。后端不收图却点了「支持」，带图的请求会被网关打回（常见是 400）。
• 同族借用是推断。claude-opus-5-5-thinking-max 这种官方没有的变体会借同代 Claude 的档位； 不想要就删掉那一行，或者用 mode: fill 让它不再被改写。
• minimal 只在官方明写时才有。它没写时各协议发的值不一样（Claude / GPT 发 low）， 配置里只能写一个值，所以不补。
• 只处理块序列写法的 models。models: [] 这种 flow 写法直接跳过并报错，不猜。
• compat 一律不动。档位范围对了，但网关若还需要 thinkingFormat / supportsReasoningEffort，仍要你自己配。

卸载

从 bundles 里删掉名字、pnpm remove dsh-better-model-selector、重启。

插件写进 cordis.patch.yml 的档位、窗口和 input 会留在原地（删掉它们，档位就回到"要么五档要么没有"的状态）。 改之前它自己备份了最近 5 份，文件名形如 cordis.patch.yml.bak-better-selector-2026-11-03_10-42-45，想还原直接拷回去。

开发

npm test                                        # 契约测试
DSH_ASAR_PATH=<...>/resources/app.asar npm test # 额外跑数据源冒烟测试

实现细节、宿主的接口边界、踩过的坑都记在 DEVELOPMENT.md。

---

MIT License