前言¶
DeepSeek Harness（DSH）采用插件化架构。在模型选择与参数配置这一高频操作中，该插件通过接管 model 插槽，提供了模型切换、推理强度调节、收藏夹管理以及供应商排序功能。它允许用户在同一个面板中完成搜索、筛选、收藏和参数调节，并具备按模型记忆档位的能力。
核心功能¶
面板集成了四个主要操作区域：
1. 搜索模型：支持快速定位可用模型。
2. 按供应商切换：左侧供应商栏支持按提供方筛选。
3. 收藏常用模型：左侧星标栏支持收藏操作。
4. 调节思考强度：底部滑杆可调节推理等级。
其中，思考强度的档位按模型各自记忆。切换模型后，该模型的记忆档位会自动恢复，无需重复设置。
安装与启用¶
- 到 Releases 下载最新的
kewen-dsh-model-controls-<版本>.tgz。 - 在 DSH 插件页的安装入口填写该文件的绝对路径，例如
/Users/你的用户名/Downloads/kewen-dsh-model-controls-0.2.0.tgz。 - 按宿主提示重载。插件应列在已安装中，名称为 DSH 模型控制器；详情页提供配置、启用/禁用和卸载入口。
自行构建安装包：
npm ci --ignore-scripts
npm run verify
npm pack
插件声明 dsh.bundle.patch，由官方管理器处理依赖、profile bundle 和加载，无需手工添加插入项。安装后通过优先级接管官方 model 插槽，禁用后由官方选择器接回。安装前请确保没有同时保留旧的绝对路径插入项，以免重复加载。
配置与 Magpie 集成¶
标准 Magpie 接入无需填写任何设置。插件会检测活动的 DeepSeek API Key 供应商：当凭据引用为 MAGPIE_API_KEY 且请求地址为回环主机（127.0.0.1、localhost 或 ::1）的 /v1 接口时，自动识别为 Magpie。
在 已安装 → DSH 模型控制器 中可配置 备用 Magpie 接口地址，用于自定义接入未被自动识别的情况。留空则使用自动识别。
注意：显示身份仅改变模型入口、提供方栏及收藏夹的名称与图标，不修改实际请求路由。若把 Harness 的 deepseek-official 请求地址改到 Magpie，模型目录的真实提供方 ID 仍是 deepseek-official。
数据与兼容性¶
客户端偏好存储在 localStorage 中，键名包括 dsh003.model-picker.model-efforts、dsh003.model-picker.favorites 和 dsh003.model-picker.provider-order。
- 卸载插件不会自动删除上述偏好数据，重装后偏好依然存在。
- 数据仅属于当前客户端 origin，不会跨应用或设备同步。
- 版本号必须是三段 semver。四段版本号（如
0.2.3.1）可能导致后续更新报错。
构建依赖使用公开发布的 DSH 0.1.7-rc.2 类型包及 Cordis 4.0.4。
总结¶
该插件在模型选择器的基础上增加了收藏、排序和按模型记忆的推理强度调节功能，适合需要频繁切换模型并精细控制推理参数的使用场景。
