前言¶
在 DeepSeek Harness（DSH）里写对话、调模型时，Composer 底部自带的模型菜单能完成切换，但推理力度（reasoning effort）若与菜单分离，或档位与适配器实际宣告不一致，切换时容易多一步确认，也不易扫一眼当前模型与力度。
社区插件 dsh-codex-model-picker（维护者 caidows）用一张叠在模型按钮上方的小卡片，同时展示当前模型和可拖动的力度滑条，交互上接近 Codex 的模型切换器。本文基于插件 GitHub README 与 package.json 整理功能、安装方式与使用注意点。
这是什么¶
dsh-codex-model-picker 是面向 DSH web 端 Composer 的客户端插件：用 Codex 风格的卡片替换出厂模型菜单——上方是推理力度、中间是当前模型、底部是可拖动档位滑条。
- 维护者：caidows
- 分类：模型推理
- 许可证：MIT（README）
- 包版本：
1.0.0（package.json） - 源码与说明：GitHub - caidows/dsh-codex-model-picker
- 社区目录：SkillHub 插件页
DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
以下能力均来自 README 功能列表。
Codex 风格卡片布局¶
卡片锚定在 Composer 模型按钮上方；空间不足时翻到按钮下方。颜色、圆角与阴影使用 DSH 主题 token，支持明暗主题。
可拖动推理力度滑条¶
滑条按模型适配器宣告的 reasoning.efforts 设置档位，常见包括 off、minimal、low、medium、high、xhigh、max（仅宣告存在的档位会出现）。拖动时拇指吸附到整档，带动画；力度标签在拖动过程中更新，而非仅在松手后。
不设提供商默认档位： 档位来自适配器宣告，不合成额外的 “default” 项。未存储力度的模型在可用时显示 medium，否则用宣告的默认值或中间档。
若模型宣告 Off，选中并确认后会发送 reasoningEffort: "off"；部分提供商（如 Codex）会映射为关闭推理。
模型列表¶
按提供商分组，展示当前选中、徽章、加载与错误状态，并支持键盘导航。界面支持中文与英文。
键盘操作¶
方向键逐档移动；Home / End 跳到两端；Escape 关闭卡片并将焦点归还。
环境要求¶
- DeepSeek Harness
0.2.2-rc.1或更新（README：conversation.input.model客户端插槽 API 在该版本线稳定）。 - 使用 web 配置（
dsh web或桌面应用中的 web 配置）。
package.json 中 engines.dsh 为 >=0.2.2-rc.1。
安装与启用¶
在 web 配置下执行官方安装命令：
dsh plugin --profile web add github:caidows/dsh-codex-model-picker
安装后刷新页面。插件在 conversation.input.model 上以优先级 -1 注册客户端插槽占用方，覆盖出厂模型选择器；禁用或移除插件后恢复原厂选择器，且不残留状态。
若从本地检出安装，将 dsh plugin add 指向插件包目录即可（README 说明，非 git clone 场景下的路径由你本地检出位置决定）。
典型用法¶
安装并刷新后，无需单独配置文件：在 Composer 底部点击模型入口，打开卡片即可：
- 在底部滑条上拖动或点选，设置当前会话的推理力度；档位范围取决于当前模型适配器宣告的 efforts。
- 在卡片内的模型列表中切换模型；选择与力度变更经
session.selectModel等与出厂选择器相同的会话模型目录逻辑，与界面其余部分保持同步。
插件通过 cordis.patch.yml 加载 client.js 客户端包，并读取与出厂选择器一致的按会话模型目录（ctx.modelDirectories.directoryFor(sessionId)）。
适用场景与注意¶
适合谁： 经常在 DSH web Composer 里切换模型、且需要与 Codex 类似「模型 + 力度」一体操作的开发者。
运行方式： 插件以当前 DSH 进程权限在浏览器端运行；安装前建议浏览 仓库源码 与 MIT 许可条款。
仅客户端 web： package.json 中 dsh.client.platform 为 web，且 immediately: true；不满足 0.2.2-rc.1 或没有 web 配置时，README 中的安装与覆盖行为可能不适用。
结尾¶
dsh-codex-model-picker 把 Composer 模型菜单换成带可拖动推理力度滑条的 Codex 风格卡片，并按适配器宣告的 efforts 显示档位，避免合成默认档。需要时在 web 配置执行上述 dsh plugin 命令，刷新页面即可使用。
