前言¶
在 DSH Web 中,如果已经在 Models 页面添加了自定义 Provider 和模型,后续还需要关心两个配置:模型支持哪些推理等级,Provider 使用哪种思考格式。
gao-gao-zai/dsh-custom-reasoning 是 gao-gao-zai 维护的 DSH 插件,用于为自定义 pi-ai 模型配置推理等级和思考格式。它会在 DSH Web 的 Settings 页面增加一个“思考等级”区域,让配置入口集中到一个页面里。
下面介绍它的核心能力、安装方式、典型用法,以及需要留意的限制。
这是什么¶
一句话定位:为 DeepSeek Harness(DSH)的自定义 pi-ai 模型配置推理等级和思考格式。
它解决的主要问题是:当你有多个自定义 pi-ai Provider 和模型时,需要在一处查看、调整并批量设置每个模型可用的推理等级,同时为每个 Provider 选择对应的思考格式。
插件许可证为 MIT。DSH 社区目录是独立站点,与 DeepSeek、幻方无官方从属关系。
核心功能¶
插件提供以下能力:
- 为每个自定义模型配置多个推理等级:
offminimallowmediumhighxhighmax- 为每个 Provider 配置思考格式:
- 自动检测
openaideepseekopenroutertogetherzaiqwenstring-thinkingant-ling- 在 DSH Web Settings 页面增加“思考等级”区域。
- 配置保存后,对话中的模型选择器会将模型支持的推理等级作为单选项展示。
- 修改后自动保存,无需手动提交。
- 支持按住鼠标拖动,快速勾选或取消多个推理等级。
- 支持复制一个模型的等级配置,并点击或拖动粘贴到其他模型。
- 保存时使用 Settings revision,避免静默覆盖并发修改。
安装与启用¶
前置条件:
- 已安装并可以运行 DSH Web。
- 已在 DSH 的 Models 页面添加至少一个自定义 Provider 和模型。
- 自定义模型配置由
llm-pi-aiSettings namespace 管理。
README 中的装配步骤如下:
git clone https://github.com/gao-gao-zai/dsh-custom-reasoning.git
cd dsh-custom-reasoning
dsh plugin --profile web add .
其中,核心装配命令是:
dsh plugin --profile web add .
装配完成后,按提示重启 DSH,并刷新页面。
典型用法¶
先确认当前 DSH Web 可以访问,并且 Models 页面里已有至少一个自定义 Provider 和模型。
1、打开 DSH Web。
2、进入 Settings。
3、打开“思考等级”区域。
4、为每个 Provider 选择合适的思考格式。
5、勾选每个模型支持的推理等级。
6、等待界面显示“已保存”。
每个模型至少保留一个推理等级,界面不会允许取消最后一个选项。
复制等级配置¶
如果你希望把同一个推理等级配置应用到多个模型,可以使用复制配置:
1、点击“复制配置”。
2、点击一个模型的任意等级标签,将该模型设为模板。
3、点击目标模型,或按住鼠标拖过多个目标模型。
4、按 Esc 或点击“取消复制”退出复制模式。
复制操作只复制模型的 reasoningEfforts,不会修改 Provider 的思考格式。
保存与限制¶
插件保存配置时需要注意以下几点:
- 只管理自定义
pi-aiProvider,不管理 DSH 内置模型。 - 推理等级和思考格式选项目前由插件内的固定列表提供。
- 修改后等待
800 ms再保存,以合并连续操作。 - Provider 思考格式写入
providers.<provider>.compat。 - 模型推理等级写回对应 Provider 的
models数组。 - 保存模型等级时会写回所属 Provider 的完整
models数组。 - 保存请求携带
expectedRevision,服务端配置已变化时不会直接覆盖。 - 并发修改由 revision 检查保护,但冲突后需要刷新页面重新加载最新配置。
- 保存失败时,页面会显示 API 返回的错误。
- 插件不会在本地存储 Provider 凭证或模型密钥。
- 当前包只包含可加载的 JavaScript 文件,没有独立构建脚本和自动化测试。
适用场景与注意¶
这个插件适合使用 DSH Web、已经添加自定义 pi-ai Provider 和模型,并且希望集中管理推理等级与思考格式的场景。
安装前建议检查源码与 MIT 许可证。插件会执行 DSH Settings 相关写入操作,并且以当前 dsh 进程权限运行,因此不建议在来源不明或未完成审阅的环境里直接使用。
如果团队里有多人同时修改同一份 DSH 配置,需要留意 revision 冲突;发生冲突时,刷新页面重新加载最新配置后再继续修改。
结尾¶
gao-gao-zai/dsh-custom-reasoning 的价值比较集中:把自定义 pi-ai 模型的推理等级和 Provider 思考格式放到 DSH Web Settings 里统一管理,并提供拖拽勾选和复制配置这类批量操作。
相关链接:
- GitHub:
https://github.com/gao-gao-zai/dsh-custom-reasoning - 目录页线索地址:
https://www.skillhub.cn/plugins/gao-gao-zai/dsh-custom-reasoning
目录页线索地址来自插件线索,未包含在已抓取资料中,访问前可先核对。