前言¶

在 DeepSeek Harness（DSH）里跑智能体时，模型目录往往同时挂着多种端点与能力声明；若宿主只提供原生下拉，切换模型和调整「思考强度」会分散在不同配置里，和当前会话的选模入口也对不齐。社区插件 @missher/dsh-reasoning-effort（维护者 Missher12，分类：客户端）把模型选择与按目录声明映射的思考深度滑块收进对话模型入口，并在自定义模型缺档或声明不符时给出可复制的配置指引。本文基于其 GitHub README（版本 0.7.6）与 SkillHub 目录页说明安装与用法；该包未发布同名 npm，安装以 Releases 的 tarball 为准。

这是什么¶

@missher/dsh-reasoning-effort 是 Missher12 维护的独立 DSH 客户端插件：在会话侧选择模型、调节思考深度，界面上的阶梯档位与模型在目录里声明的 reasoning.efforts 对齐；选择失败会回退。包内包含当前源码、可安装 bundle 与文档；桌面端入口与其他 Missher 插件见 Missher-DeepseekHarness-Desktop。插件基于 HanaAyane 的上游 dsh-reasoning-effort 定制，保留 MIT 许可证（见仓库 LICENSE、FORK.md）。

核心功能¶

模型与思考深度¶

• 在对话模型入口选择模型并调整思考深度；滑块显示的阶梯映射到模型实际声明的档位，选择失败会回退。至少两个可用档位时才显示滑块。
• 滑块读取模型目录的 reasoning.efforts。最高支持档位、默认档位与当前会话选中档位含义不同；显示为 Ultra 或最高点阵不会产生额外能力。降低再提高模型配置上限不会丢失草稿中已有映射；稀疏档位保留端点实际值，无法识别映射时保持自动模式。

界面与主题¶

• 单层卡片、白色滑块和最高档点阵；保持已选定的八行粒子设计、渐变配色，支持深浅主题与中英文。颜色仅在「设置 → 通用设置 → 思考滑块配色」调整。减少动态效果时显示稳定帧，页面隐藏时暂停粒子。
• 自定义模型缺失档位或声明与内置参考不符时，显示配置片段及「复制给 Agent」。标题保持完整，复制按钮同宽同高，正文独立滚动，操作区保持可见；极矮窗口将正文与操作一起滚动。窗口缩放时跟随宿主布局重新定位。

可选：模型行内设置¶

模型行内设置需要宿主扩展：配套 Missher Desktop 的 Models 模块声明 settings.models.model-fields 后，思考模式和最高档位显示在文本/图片模型卡片右侧，共用该卡片的保存操作。插件本身不增加文本/图片能力，也不另存模型目录；缺失该声明时滑块仍可用，声明到达或撤销时同步注册和清理。

宿主要求与验证范围¶

按实际接口判断兼容性：需要模型目录、会话选模、Slots、Locale 和设置服务。Host 必须提供 settings.describe、settings.prepareDocument、llm.resolveModelInfo；缺失时插件会给出具体诊断。DSH peer 为 *；Cordis ^4.0.4 || ^4.0.5-alpha.1，Schemastery ^3.18.4 || ^3.18.5-alpha.1，React ^18.2.0；开发 SDK 0.2.0-rc.2。

README 中 0.7.6 的验证范围包括：官方 npm DSH 0.2.1-alpha.5 / Cordis 4.0.5 下的隔离 Web profile（Loader、请求校验、客户端加载与卸载、浏览器侧滑块与配色等，使用合成模型数据）；以及 Missher 社区扩展 0.2.0-rc.2 / 0.2.1-alpha.2 下的 Host 启动与字节检查（不等同于原版官方发行包认证）。macOS、Windows 原生桌面等本次未新增原生验收；详细边界见仓库 VERIFICATION.md。上述验证未向真实模型端点发起推理请求。

安装与启用¶

本插件通过 GitHub Releases 的构建后 tarball 分发，未发布同名 npm 包。安装前请核对目标版本资产及同次发布的 SHA256 校验文件；以下示例固定为 0.7.6。

桌面端：在「插件 → 添加插件」填写固定地址，核对版本、启用状态和加载错误，再按宿主提示重新加载或重启。Desktop 配置由桌面插件管理器维护，不要用独立 CLI 的 web profile 代替。

https://github.com/Missher12/Missher-DSH-Reasoning-Effort/releases/download/v0.7.6/missher-dsh-reasoning-effort-0.7.6.tgz

独立 Web/CLI profile：已安装 DSH CLI 的用户可执行：

dsh plugin --profile web add https://github.com/Missher12/Missher-DSH-Reasoning-Effort/releases/download/v0.7.6/missher-dsh-reasoning-effort-0.7.6.tgz
dsh --profile web --dump-config

将 web 换成你实际使用的 profile。配置中应出现 id: reasoning-effort、name: '@missher/dsh-reasoning-effort'；仅出现在配置中不代表 Loader 已激活。随后启动或重启该 profile，在对话模型入口检查滑块。不要同时启用旧上游包与本定制包，它们共用相同的指引通道和设置键。更新前保留旧 tarball 与当前 profile 配置。

典型用法与模型配置¶

临时关闭滑块入口¶

在「设置 → 通用设置 → 推理强度滑块」关闭开关，可临时恢复原生模型选择器；该开关只控制滑块入口。停用整个插件请在插件管理器禁用对应 Bundle。

自定义模型补全档位¶

自定义模型缺失声明时，打开「查看档位声明指引」，按当前配置文件路径与端点文档编辑 llm-pi-ai 的对应模型条目，例如：

reasoningEfforts:
  low: "<端点接受的较低强度值>"
  high: "<端点接受的较高强度值>"

未列出的档位不要声明为可选。reasoningEfforts: false 表示不提供可选强度档位，不能保证端点内部完全不思考。对既有目录模型的单项覆盖使用 modelOverrides；不要用非空 models 列表无意替换整个提供方目录。仅在端点文档或具体错误支持时添加 compat（如 thinkingFormat、supportsReasoningEffort 等）。滑块出现只说明目录与界面识别成功；请求参数是否被服务端接受仍需自行验证。

「复制给 Agent」会把当前模型标识、配置路径、诊断与建议片段放入剪贴板，不会自动调用其他 Agent 或提交修改。可通过插件配置 entries 补充知识条目，详见仓库 src/client/agent-tutorial.zh.md 与 src/index.ts 中的 Host 配置定义。

卸载¶

桌面端在插件管理器卸载 @missher/dsh-reasoning-effort。Web/CLI profile：

dsh plugin --profile web remove @missher/dsh-reasoning-effort

插件没有聊天或学习数据库；卸载不主动删除宿主会话、凭据或模型声明。停用后重启可恢复原生入口；自定义 entries 与 profile 覆盖请在卸载前自行备份。

适用场景与注意¶

适合谁：需要在 DSH 对话入口统一选模、按模型声明调节思考深度，并希望在声明缺失时拿到可复制配置片段的客户端用户；若使用 Missher Desktop 且 Models 模块已声明 settings.models.model-fields，可在模型卡片行内一并编辑思考相关字段。

安装前：插件在 DSH 进程权限下运行，安装前应阅读仓库源码、LICENSE 与 SECURITY.md，并从 Releases 核对 tarball 与 SHA256。SkillHub 目录（Missher-DSH-Reasoning-Effort）是社区收录页，与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。

反馈与源码：问题与功能请求见 GitHub Issues；完整说明与英文版见 仓库 README。