前言¶
DeepSeek Harness 采用插件化架构，支持扩展功能。在进行模型推理开发时，开发者通常需要在多个提供商、多种模型规格之间快速切换。原生模型选择器的功能相对基础。dsh-model-palette 插件旨在提供一种全局、统一的模型选择与配置方案。
插件定位¶
dsh-model-palette 是一个用于 DeepSeek Harness 的全局提供者感知模型命令面板插件，同时也提供可选的 OpenRouter 媒体工具。
该插件由 Jensen-Yao 维护，采用 MIT 许可证。它不依赖特定的浏览器环境，旨在提升模型选型与配置的效率。
核心功能¶
全局命令面板¶
插件的核心交互方式是全局快捷键。在 Web UI 的任意位置按下 Alt+M，即可唤起一个独立的文档级对话框。该面板支持模糊搜索，可覆盖模型名称、ID、提供者名称及 ID。用户可以使用方向键导航，按回车键选择。
提供者过滤器与目录¶
界面左侧提供提供者过滤器侧边栏。侧边栏实时显示每个提供者下的模型数量，并包含视觉错误指示器。点击任意提供者可筛选模型，点击“All providers”可重置。在配置面板中，提供者以卡片网格形式展示，包含品牌图标、模型计数和协议徽章。
推理努力选择器¶
插件底部提供统一的推理努力选择器，支持 off 到 max 多个级别。如果当前模型未声明这些级别，选择后会在请求中动态添加 reasoningEfforts 声明。该功能支持针对每个模型或提供者进行自定义配置。
模型配置与模板¶
用户可以直接在 UI 中添加、编辑或删除提供者配置。插件内置模板库，支持 OpenAI 兼容、Responses、Anthropic 等协议，以及 OAuth 和 API Key 模板。配置项包括提供者 ID、显示名称、基础 URL、协议类型及凭证引用。
模型预设与在线刷新¶
插件捆绑了 469 个由厂商权威提供的模型预设，涵盖 OpenAI、Anthropic、Google、DeepSeek 等多家厂商。这些数据支持在线刷新，确保时效性。在应用预设时，面板会显示上下文窗口、输出限制和推理级别等信息。
OpenRouter 媒体工具（可选）¶
插件支持可选的 OpenRouter 媒体工具，包括图像和视频生成。用户可以在侧边栏配置视图中启用此功能。通过该工具，用户可以直接提交提示词生成图像或视频，无需将提示词发送至对话流中。
安全性¶
插件具备安全防护机制。API 密钥默认遮罩存储在 DSH 凭证服务中。凭证的显示仅允许在本地回环连接（127.0.0.1 或 localhost）下进行。插件对所有 API 请求实施 CSRF 保护，OpenRouter 凭证不会返回至浏览器端。
安装与启用¶
安装该插件需要执行以下命令：
dsh plugin --profile web add github:Jensen-Yao/dsh-model-palette#v0.12.0
安装完成后，需重启 dsh web 服务。
典型用法¶
- 唤起面板：重启后，在界面任意位置按下
Alt+M打开命令面板。 - 配置提供者：在侧边栏点击配置视图，选择模板创建新提供者。配置完成后，点击“Test connection”按钮验证运行时密钥，系统会自动发现并添加模型。
- 使用媒体工具：若需使用 OpenRouter 图像或视频生成功能，需在侧边栏配置视图中启用“OpenRouter Media Tools”。
注意事项¶
- 密钥安全：API 密钥存储在 DSH 服务中，且默认遮罩。无法通过跨站访问查看已存储的密钥。
- 付费限制：OpenRouter 媒体工具默认阻止付费生成。对于非免费模型，使用前需确认一次性费用。
- 循环回显限制：仅允许在本地回环地址下查看凭证，远程访问会被阻止。
总结¶
dsh-model-palette 为 DeepSeek Harness 提供了一个全局、可视化的模型管理与配置入口。它通过统一快捷键和丰富的配置选项，简化了多提供商模型的切换流程。相关文档与源码位于：GitHub。
