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（keydsh-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
