dsh-model-block-picker

English | 中文

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

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

---

效果

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

• ① 全局搜索 —— 直接在顶部输入 v3 / sonnet / r1，跨全部 17 个来源聚合匹配；回车选中首项。
• ② 按来源分块 —— 每个渠道一张卡片，标出「N 个模型」与「进入 →」。
• ③「当前」标记 —— 正在使用的来源高亮描边 + 右上角黑标。
• ④ 推理强度 —— 当前模型支持 reasoning 时，浮层底部保留 Reasoning Effort 选择器。

触发按钮本身与同排的截图 / 麦克风图标保持同一设计语言（黑底 + 主题 off-white 描边与文字）：

---

功能

• 按来源分块：DeepSeek 账号、DeepSeek API，以及 CodeBuddy / Qoder / TRAE 等第三方渠道，各自成为一张卡片；卡片上显示来源名、模型数量，当前所用来源带「当前」标记。
• 两级下钻：点卡片 → 进入该渠道内只含它自己模型的列表；顶部 ← 所有来源 或 Esc 返回。
• 全局搜索：直接输入 v3 / sonnet / r1 等关键词即可跨所有来源聚合匹配，回车选中首项；清空即回到分块视图。
• 推理强度保留：当前模型支持 reasoning 时，浮层底部出现强度选择器（默认 / low / medium / high…）。
• 主题自适应：浅色、深色均用 DSH 主题 token；深色下触发按钮为黑底 + 主题 off-white 描边/文字，与同排麦克风、截图图标同一设计语言。

安装

从本机目录安装（开发 / 自用）

在 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 诊断路由）
├── client.js             # 浏览器半边：React 组件 + 样式 + 插槽注册
├── LICENSE
└── README.md

诊断

排障时会用到：

• 宿主侧日志前缀 [dsh-model-block-picker]（DSH 日志里搜这个）。
• 浏览器端各生命周期节点会打到 /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 官方 → 其余按名称排；如需自定义顺序改 client.js 里的分组排序逻辑。

许可

MIT