DeepSeek Harness 模型中心插件：双栏选择与能力卡

前言¶

DeepSeek Harness（DSH）以「一切皆插件」为理念，社区目录与官方渠道相互独立。在本地多模型或自建渠道场景下，输入框上的模型列表往往又长又平、信息密度不足。dsh-model-hub 插件针对这一痛点，提供双栏布局与悬浮能力卡，让模型选择与能力调整更直观。

插件定位¶

名称：dsh-model-hub
维护者：xfjsssq
分类：客户端
核心价值：把原生长列表替换为双栏选择器（左提供商 / 右模型）+ 悬浮能力卡，并支持在面板中管理提供商与模型；零构建、零 npm 依赖。

核心功能¶

双栏模型选择¶

左栏：提供商列表，支持拖拽排序 / 置顶，持久化；仅显示「有模型或已声明」的提供商。
右栏：当前提供商的模型列表。
跨提供商搜索：输入时按模型名或 ID 模糊匹配，当前提供商结果优先；清空后回到所选提供商。

悬浮能力卡¶

尺寸约 200px，跟随鼠标出现后「钉住」，可继续操作。
能力档位：上下文窗口（128K / 256K / 1000K）、输出档位（128K / 256K）、输入类型（文本 / 图片）、推理等级（关 / 低 / 中 / 高）。
非标准值会高亮并提示，例如设置页手打一千万时会提示「确认是否多打了 0」。

提供商与模型管理¶

左栏底部「＋添加模型提供商」：全屏表单（id / 显示名 / API 协议 / Base URL / Key 环境变量名）。
新增渠道默认为「待选模型」状态，草稿保存在插件自己的 prefs.json，不改动 DSH 配置；可删除。
模型列表右下角「刷新」按钮：询问端点模型列表 → 候选界面（可搜索、可勾选、全选 / 取消全选）→ 确定后原子落盘。
单个模型删除：hover 出现删除入口，二次确认；只剩最后一个时按钮置灰；删掉后刷新可加回。

可靠性与兼容性¶

能力改动写入模型配置后回读运行时确认；若未生效会报 NOT_EFFECTIVE 并回滚。
渲染失败时自动交回内置选择器并给出提示，不白屏。
支持亮 / 暗主题、prefers-reduced-motion 以及键盘操作（↑↓ / Enter / Esc / Tab）。

安装与启用¶

官方 CLI / GUI（推荐）¶

# 从 GitHub 安装
dsh plugin --profile desktop add github:xfjsssq/dsh-model-hub
dsh plugin --profile desktop add github:xfjsssq/dsh-model-hub#v0.1.0

# 本地目录（开发）
dsh plugin --profile desktop add "<本目录绝对路径>"

dsh 不在 PATH 时，可使用安装目录里的 CLI 或通过 GUI 添加插件。

效果生效时机¶

宿主侧 API（/model-hub/api/*）：安装后立即生效，无需重启宿主。
客户端 UI（输入框上的模型位）：刷新页面一次（桌面端 Ctrl+Shift+R）。
插件自身的宿主代码更新（升级版本后）：需要重启 DSH。

关闭插件（不卸载）¶

编辑 cordis.patch.yml，将 enabled 改为 false。宿主 API 停用、客户端条目不再注册，内置选择器自动恢复。

典型用法¶

点击输入框上的模型位：打开模型中心。
左栏点击或 ← / →：切换提供商。
搜索框输入：跨全部提供商按模型名 / ID 模糊匹配，结果按提供商分组。
↑ ↓ + Enter：键盘选模型（焦点留在搜索框）。
悬停模型行约 120ms：浮出能力卡。
能力卡点击档位 / 开关：写入模型配置 → 回读运行时确认 → 立即生效；若不匹配会显示 NOT_EFFECTIVE 并回滚。
能力卡点击推理等级：提交会话级 reasoningEffort；若非当前模型，一次点击同时切换模型并应用档位。
左栏拖拽 / 右键或行尾图钉：调整提供商顺序 / 置顶，立即持久化。

已知限制¶

/model 斜杠命令的弹窗仍为内置 UI；新 UI 仅接管输入框上的模型位。
DSH 不允许「没有模型的渠道」：新建渠道为草稿状态，勾选模型后才落盘；此前不会出现在 DSH 内置选择器中。
厂家目录自带的渠道，删掉模型后仍会列出（目录继续供模型），只是标记变为非声明态，删除入口消失。
强开上游不支持的视觉或推理档位，请求时可能报错；卡片有提示。
不支持 reasoningEfforts: false；要表达「不推理」请传 null。
提供商排序 / 置顶与草稿保存在 ~/.dsh/model-hub/prefs.json；能力值每次打开重新拉取。
升级插件后宿主侧需要重启 DSH（lib/host/* 不热重载）。

适用场景与注意事项¶

适合需要同时管理多个提供商、自定义上下文与输出档位、或需要直观能力预览的开发者。
插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证（MIT）。
新建渠道需通过插件面板勾选模型后落盘；在此之前不会出现在 DSH 内置选择器中。

结语¶

dsh-model-hub 在不改动宿主 UI 的前提下，通过双栏选择器与悬浮能力卡提升了模型选择的可用性，并通过回读确认与降级机制保障可靠性。适合需要精细管理模型能力与多渠道配置的场景。

目录页：https://www.skillhub.cn/plugins/xfjsssq/dsh-model-hub
GitHub：https://github.com/xfjsssq/dsh-model-hub