在 DeepSeek Harness (DSH) 的 Web 画布中,模型选择通常由单一的输入框承担。当管理多个模型或需要配置推理模式时,这种单一视图显得较为局促。dsh-model-accordion 插件通过引入折叠式的 Provider 结构,将模型选择器从单一的“座位”扩展为层级化的列表,使界面在保持整洁的同时提供了更丰富的配置选项。
插件定位¶
dsh-model-accordion 是一个 Web UI 插件,由维护者 lakabuji-arch 开发。它位于 DSH 的插件生态中,不涉及后端服务或模型目录的构建,仅负责增强 Web 界面的交互体验。
安装与启用¶
在 Web Profile 环境下安装该插件:
dsh plugin --profile web add dsh-model-accordion
安装完成后,请刷新 Web UI 以加载新组件。
功能说明¶
该插件主要实现了以下交互逻辑:
- Provider 折叠结构:默认状态下,Provider 分组是折叠的,只有点击才会展开查看具体模型。
- 推理模式读取:插件会读取每个模型在已解析的目录元数据中的推理模式(reasoning-effort)选项。内置了一张官方的推理模式表作为后备,具体优先级遵循:模型自身配置 > Provider 级别默认值 > 内置表。
- 数据流转:选定的模型和推理模式会通过 DSH 的共享 model-directory 服务发送给系统。
- UI 限制:弹窗高度受内部滚动区域限制,保证界面不会无限拉伸。
- 主题适配:使用 DSH 的语义主题 tokens 定义颜色,并支持浅色与深色模式的切换。
配置与用法¶
插件通过读取 DSH 的配置文件来获取模型元数据。你可以通过 settings.yaml 为特定模型声明推理模式。
例如,为某个未在官方表中定义的模型添加自定义推理阶梯:
providers:
my-relay:
api: openai-completions
baseURL: https://…
models:
- id: my-unknown-model
api: openai-completions
contextWindow: 200000
maxTokens: 32000
input: [text]
reasoningEfforts:
off: null # 允许用户关闭思考
low: low
high: high
max: max
插件会优先使用模型自身的 reasoningEfforts 配置。如果模型不支持用户选中的推理模式,该选项会被静默丢弃,系统将使用模型的默认值,而不会抛出错误。
注意事项¶
- 插件性质:这是一个 Web UI 插件,它不会添加 Host 服务、模型提供商、视觉后端或模型目录。Provider 的可用性以及图像会话的准入规则,仍由 DSH 及已安装的 Provider/Vision 插件控制。
- 兼容性:插件依赖 DSH Web 环境提供的官方模型选择包和模型目录服务。
- 语言限制:当前版本的状态提示和搜索框文本均为英文,完整的本地化集成计划在后续版本中发布。
- 权限:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证(MIT)。