前言¶
DeepSeek Harness(DSH)在 0.2.0-rc.2 引入了推理强度选择器,但该功能默认仅对内置的 DeepSeek 模型生效。通过 llm-pi-ai 配置的第三方网关模型(如 OpenCode Go、GOAT、Volcengine Ark 等)无法在界面上选择推理档位。此外,OpenCode Go 网关严格要求在 HTTP 请求头中携带 x-opencode-session,否则会返回 400: MissingSessionID 错误。
这是什么¶
dsh-reasoning-options 是一个 DeepSeek Harness 插件,由用户 Scorp1o117 维护。它通过扫描 llm-pi-ai 命名空间,为未声明推理档位的模型自动补全推理强度选择器,并自动为 OpenCode Go 提供商注入必需的路由请求头。
核心功能¶
- 自动补齐推理档位:为所有 pi-ai 模型添加推理强度选择器,支持从 off 到 max 七个档位。
- 自动注入路由头:检测 OpenCode Go 网关,自动注入
x-opencode-session请求头。 - 原生集成:写入通过 DSH 的原生 settings API 进行,直接持久化到 Profile patch。
- 幂等与序列化:操作是幂等的,序列化执行,避免文件锁冲突。
安装与启用¶
通过命令行安装到 Web 配置文件:
dsh plugin --profile web add dsh-reasoning-options
安装后,在 DSH 界面中进入 Plugins -> Installed -> dsh-reasoning-options 进行配置。
典型用法¶
插件提供配置页面,主要包含以下设置:
* enabled:控制是否自动补齐配置,默认为 true。
* autoSessionHeader:控制是否自动注入 OpenCode Session 头,默认为 true。
* sessionHeaderValue:注入的 Session 值,默认为 'dsh-session'。
* pollIntervalMs:兜底轮询扫描间隔,默认为 30000 毫秒。
适用场景与注意¶
- 适用场景:正在使用
llm-pi-ai配置第三方网关,需要统一管理推理档位,或者正在使用 OpenCode Go 需要自动处理 Session 头的用户。 - 权限说明:插件通过 DSH 进程权限读取和修改
llm-pi-ai命名空间,安装前建议检查源码与许可证。 - 配置机制:插件采用数组全量替换机制,每次写入会重写完整的模型列表。手动编辑
cordis.patch.yml后,无需重启 dsh,等待下一次轮询即可生效。 - 兼容性:需要 DSH 0.2.0-rc.2 及更高版本。
结尾¶
该插件解决了第三方网关在 DSH 中的配置缺失问题,通过原生接口确保了配置的持久化和热加载。更多详情与源码请参考下方链接。
- 目录页: SkillHub 目录
- GitHub: Scorp1o117/dsh-reasoning-options