从装包到拖出滑块：dsh-reasoning-effort 四步落地
这篇只解决一件事：在自己机器上把滑块拖起来，并判断每一步成没成。四步都带命令、预期输出与判读方法，机制不展开。
前提先说清：插件不产生新的推理能力，只是把目录里已有的档位做成可拖控件。模型不公开档位，第三步必然卡住。
开跑前对齐三个前提
node -v dsh --version预期：Node 输出 v22.19 或更高（engines 写的是node >=22.19）；DSH 落在>=0.2.1-rc.2 <0.3.0。低于下限先升 DSH，别硬装——插件只适配 RC，不维护 alpha，版本不对通常表现为"装完毫无动静"。
第三个前提是 Profile：Web 用web，桌面端用desktop，互不相通，下面以 Web 为例。
第一步 装对包，作用域不能漏
npm 上有两个近似同名的包：带作用域的@ayanehana/dsh-reasoning-effort对应HanaAyane/dsh-reasoning-effort仓库；无作用域的dsh-reasoning-effort由其他维护者发布。少打@ayanehana/，装的就是别人的包。
dsh plugin --profile web add @ayanehana/dsh-reasoning-effort预期是一段 pnpm 日志，结尾提示插件已加入webProfile。判读：没有ERR_PNPM_开头的行即通过。最新为 0.9.0，若解析到 0.8.x 或更低，回头核对 DSH 版本。
从 GitHub 装过旧包，先卸
早期从仓库装的是无作用域名，与新包并存会重复加载，先执行：
dsh plugin --profile web remove dsh-reasoning-effort桌面端别敲这条，去「插件」页卸载。
第二步 重启宿主，让包真正被加载
装完不会热生效：Web 端重启 Web Host 进程，桌面端完全退出重开（只关窗口不算）。这步没做，第四步验证一定是空的。
桌面端不要用 CLI 装
webProfile 的插件不会出现在桌面端。桌面端是独立的desktopProfile，入口在应用内「插件 → 添加插件 → 包名或地址」，填包名而不是命令。用 CLI 改会被拒绝：
profile "desktop" is managed exclusively by the Electron application安装到此完成，但"装上了"离"能用了"还差两步。想先看同类工具的安装形态，可翻一遍 完整插件清单与汉化避坑指南，再回来继续。
第三步 打开开关，选到有至少两档的模型
先到设置 → 通用设置，确认「推理强度滑块」是开着的。
再选模型：必须在目录里公开至少两档，少于两档只给提示。档数、名称、顺序由模型与路由决定，不存在"标准三档"。
进入「推理等级」后，应看到带圆点刻度与档位名称的滑块。拖动后弹窗不关闭，可连续试几档；Esc 返回，点外部关闭。
判读方法：
- 看到带刻度的滑块 → 前三步都通了，进第四步做确认
- 只看到档位不足的提示 → 换一个公开多档的模型，或确认部署没关 thinking
- 什么都没有 → 回第二步，宿主多半没重启
第四步 用 dump-config 验证载入
前面看界面，这步看配置。
dsh --profile web --dump-config预期输出里出现插件条目：
plugins: - name: '@ayanehana/dsh-reasoning-effort'判读分三种：出现这一行 → 载入成功，界面仍无滑块则是开关或模型档位问题；完全没有 → 包没进这个 Profile 或宿主没重启；提示 Profile 不存在 → 装到了另一个 Profile。
注意dump-config只证明载入，不证明端点接受推理参数，两件事别混。
排错：四种典型症状
症状一 安装时报"没有匹配的版本"
多半不是本插件的问题：pnpm add会重新解析整个 Profile 依赖树，失败的可能是原本就有的其他依赖；镜像延迟也会让目标版本暂时不可用。日志里找ERR_PNPM_NO_MATCHING_VERSION：
%USERPROFILE%\.dsh\profiles\desktop\.plugin-manager\logs\<operation>\pnpm.logissue #24 就是换回默认 npm 源后成功的。先换源，再怀疑包。
症状二 自定义模型怎么都没有滑块
自己写在llm-pi-ai里的模型默认读不到档位：目录只报告适配器声明的能力，自定义条目没继承内置元数据。必须显式写reasoningEfforts，推荐走图形界面：设置 → 模型 → 编辑提供商 → 自定义设置 → 模型选项 › → 推理等级。插件只给片段，不改配置。
症状三 加了 compat 之后整条路由不可用
compat的坑在于不写反而对：不写时按端点地址推断，未识别的按标准 OpenAI，已识别厂商自动套该厂商格式；手写会覆盖这个判断，写错就是用错误声明替换正确默认。在不接受该字段的协议上粘贴（如anthropic-messages），路由会直接解析失败。遇到模型整个消失，先删compat。
症状四 滑块在，拖了却没感觉
滑块出现只证明目录读到了元数据，不证明端点接受参数，也不证明强度改变。要确认只能核对实际请求：字段名、档位值、响应里的推理行为是否对应。
卸载与版本回滚
dsh plugin --profile web remove @ayanehana/dsh-reasoning-effort桌面端同样在「插件」页卸载。降级对应：DSH 0.2.0 RC 用 v0.8.1，0.1.x 用 v0.7.3。插件 MIT 许可、248 星；本站「已验证」：dsh 0.2.1-rc.2 下安装成功，安全扫描 🟢 未发现敏感能力，需联网；周下载 559 含 CI 与镜像。
总结
四步的顺序不能换：装对作用域包、重启宿主、打开开关并选到多档模型、用dump-config收口；想对照同类插件的中文清单与安装形态见 DSH 插件中文清单。
适合与不适合
适合：已在用 DSH、模型公开两档以上、想快速切换强度的日常场景；第一次装 DSH 插件、需要可验证流程的新手；维护自定义端点、愿意补reasoningEfforts的开发者；要在 Web 与桌面端分别部署、想弄清 Profile 隔离的人。
不适合：模型只公开一档或压根不公开档位的人，第三步必然卡住；不愿意动 YAML、也不愿进设置逐项检查的人；把滑块当成"提升模型能力"开关的人，它只改请求参数。
标签：dsh-reasoning-effort、DeepSeek Harness、DSH 插件安装、推理强度
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
