dsh-reasoning-effort README

The project's README from github.com/HanaAyane/dsh-reasoning-effort. As one markdown file: README.md.

dsh-reasoning-effort 为 DeepSeek Harness 提供 Codex 风格的模型与推理强度滑块

dsh-reasoning-effort

把 Codex 风格的“模型 + 推理强度”控件直接带进 DeepSeek Harness。

English · 最新发行版 · 反馈问题

v0.7.1 DSH RC MIT License

在 DSH 输入框下方切换模型、拖动推理强度,并让八帧“大肥鱼”随拖动加速。档位来自当前模型,选择结果与 /model 命令保持同步。

推理强度选择器在 DeepSeek Harness 深色和浅色主题中的真实效果

安装与更新 · 版本支持 · 外观设置 · 常见问题

版本支持政策

本插件仅针对相对稳定的 DSH RC 版本进行适配、测试和问题修复,不单独维护 alpha 版本。alpha 阶段的客户端 API、依赖结构和插件加载机制可能频繁发生破坏性变更;持续兼容多个过渡版本会增加维护成本,也难以保证可靠性。

建议使用发行说明中注明的 RC 版本。如需继续使用 alpha,请自行进行临时适配。RC 仍属于候选发布版本,不代表所有历史或未来 RC 都自动兼容。

项目 当前说明
插件发行版 v0.7.1
本次修复目标 DSH 0.1.2-rc.1,Web Profile
验证范围 类型检查、国际化检查和构建通过;浏览器实测待完成
alpha 版本 不单独适配,请自行临时修复或切换至目标 RC

安装与更新

1. 安装固定发行版

在你启动 DSH 时使用的终端环境执行:

dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#v0.7.1
dsh --profile web --dump-config

确认输出中出现 name: dsh-reasoning-effort。已有安装也使用同一条 add 命令更新。开发体验可将 #v0.7.1 换成 #main,但主分支可能包含未发布改动。

让 Agent 帮你安装:复制这段提示词
请为 DeepSeek Harness 的 web Profile 安装 dsh-reasoning-effort v0.7.1。
只执行下面两条命令,不要修改其他 Profile:
dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#v0.7.1
dsh --profile web --dump-config
确认配置中出现 dsh-reasoning-effort 后告诉我结果。
不要关闭或重启正在运行的 DSH;提醒我手动重启 Web Host 并刷新页面。

2. 重启并刷新

插件在 Web Host 启动时载入。安装完成后,手动重启 DSH Web Host,再刷新页面。

3. 选择模型与强度

打开一个会话,点击输入框下方的模型入口。拖动滑块或点击轨道,释放后吸附到最近的有效档位;点击下方模型行可展开模型列表。

档位从哪里来

滑块读取当前模型在 DSH 模型目录中公开的 reasoning.efforts。档数、名称和顺序由模型与路由决定,并非固定三档,也不保证不同端点提供相同档位。

模型公开至少两档时显示滑块;不足两档时显示提示。插件提交目录中的档位值,由 DSH 校验和发送,不会绕过模型或部署的能力限制。

档位指引(自定义 provider)

DSH 内置路由的档位来自 pi-ai 目录,插件完全只读、绝不修改。只有你在 settings.yaml 的 llm-pi-ai 里自己声明的模型,插件才会给指引:

  1. 打开模型菜单。若当前模型是你自定义声明、且目录读不到档位(或声明与知识库不符),菜单里会出现 查看档位声明指引;
  2. 面板展示建议档位(知识库命中时,如 GLM-5.2 的 minimal/low/medium/high)、一段可直接复制的完整条目 YAML(含 - id: 行,原有 name 等字段自动保留)以及 settings.yaml 的路径;
  3. 复制后用其整体替换 settings.yaml 里对应的 - id: 条目(不要复制出第二个 llm-pi-ai: 根)并保存。DSH 会自动加载;若未生效,重启 Web Host 并刷新页面。

知识库未收录的模型会得到带注释的通用模板,按端点文档填值即可。遇到"端点因 developer 角色拒绝请求"之类的情况,面板会直接给出警告与替代建议(例如阿里云百炼端点建议改用内置 zai 路由)。

高级配置:扩展插件知识库

内置知识库目前收录 GLM-5.2(minimal/low/medium/high)与 Kimi K3(low/high/max)。要补充其他模型,在 settings.yaml 里追加到插件自己的命名空间即可,条目优先于内置:

dsh-reasoning-effort:
  entries:
    - id: my-model
      provider: "*"          # provider 路由名,* 通配
      model: "my-model-id"   # 模型 id,* 通配
      note: 说明文字
      efforts:               # 档位名 → 端点实际接受的取值
        low: "low"
        high: "high"
        max: "max"
      compat:                # 仅 openai-completions 路由需要
        thinkingFormat: "openai"
        supportsReasoningEffort: true

注意:插件只提供片段,不会替你修改任何配置;内置目录里的档位集合(即使只有一档)也不会被标记——那是上游的刻意数据。

大肥鱼滑块

插件默认启用八帧奔跑小人作为滑块按钮。若想换回纯白按钮:

  1. 打开 设置 → 通用设置。
  2. 找到“外观”下方的 大肥鱼滑块。
  3. 关闭开关,再回到模型入口。
DeepSeek Harness 通用设置中的推理强度滑块和大肥鱼滑块开关

大肥鱼只替换按钮外观,不改变档位吸附、键盘控制、辐射特效或模型选择。拖动时动画会自动加速;系统启用“减少动态效果”后会停留在稳定帧。

同一页面中的 推理强度滑块 总开关可以临时关闭整个增强控件。关闭后无需卸载,DSH 原生模型选择器会立即恢复。两个开关都只保存在当前浏览器。

常见问题

安装后看不到滑块

请依次确认:

  1. 使用发行说明中的目标 RC 与对应插件版本;0.7.1 包含 DSH 0.1.2-rc.1 的模型控件注入修复。
  2. 安装后已经重启 DSH Web Host。
  3. 设置 → 通用设置 → 推理强度滑块 处于启用状态。
  4. 当前模型在 DSH 模型目录中公开了至少两档推理强度(未声明的模型见下一条),且部署没有关闭 thinking。

模型没有声明档位怎么办

先查看模型菜单中的 查看档位声明指引。若需要手动配置,请根据当前模型和端点文档填写 settings.yaml 中对应模型的 reasoningEfforts 与 compat,不要直接套用其他模型的档位或上下文参数。

知识库只提供参考;实际支持的取值以端点能力为准。保存后若未生效,重启 Web Host 并刷新页面。

RC 版本仍有问题,如何反馈

请在 Issue 中附上 DSH 版本、插件版本、客户端类型(Web 或桌面封装)、复现步骤,以及相关控制台报错。报告前请隐去令牌和凭据。

如何确认插件已经载入

运行:

dsh --profile web --dump-config

配置中应当出现 name: dsh-reasoning-effort。

如何卸载

dsh plugin --profile web remove dsh-reasoning-effort

卸载后重启 DSH Web Host,原生模型选择器会自动恢复。

开发与构建

pnpm install
pnpm run check
pnpm pack

开发环境使用 Node.js 22.19+(同时满足目标 DSH 的要求)和 [email protected]。pnpm run check 会进行 TypeScript 与国际化校验,并重建 Host 入口、浏览器模块及类型声明。完整交互与颜色约定见 design/visual-spec.md,安全问题请按照 SECURITY.md 报告。

许可证

MIT © HanaAyane

dsh-reasoning-effort (HanaAyane/dsh-reasoning-effort)

Searching Database…

What is this?It is a plugin for DeepSeek Harness (DSH) that brings a Codex-style model-and-reasoning-effort slider into the chat input area, complete with an animated 8-frame running 'fat fish' icon that speeds up as you drag.
Is this a standalone app or a plugin for something else?It's a DSH plugin (dsh-plugin), not a standalone application; it injects UI into DSH's Web Host and mirrors theme, language and the '/model' command.
What do I need besides a running DSH instance?To build or develop the plugin you need Node.js 22.19+ and [email protected]; to just use it you need a DSH Web Host install matched to the targeted RC release.
Does it work with any DSH build, including alpha?No. The plugin is only adapted, tested and fixed against relatively stable DSH RC releases; alpha builds change their client API too often and are not maintained, so you may need to patch it yourself for alpha.
Will the slider show up for every model I pick?Only if the model publishes at least two reasoning-effort levels in the DSH model directory; if it exposes fewer than two, the plugin shows a hint instead of a slider.
What is the 'fat fish' animation exactly?It's an optional 8-frame running-fish icon that replaces the plain slider button and accelerates as you drag it; you can switch back to a plain white button in Settings, and it respects the OS 'reduce motion' preference.
Can I add reasoning-effort support for a custom model provider?Yes. For models you declare yourself in settings.yaml under llm-pi-ai, the plugin offers a 'view effort declaration guide' panel with a ready-to-copy YAML snippet and suggested levels, backed by a built-in knowledge base that currently covers GLM-5.2 and Kimi K3.
Does the plugin edit settings.yaml for me?No, it only gives you a copyable configuration snippet; you paste and save it yourself, then restart the Web Host for DSH to pick it up.
Can I disable it without uninstalling?Yes, a master 'Reasoning Effort Slider' toggle in Settings → General instantly restores DSH's native model selector, and both appearance toggles are stored only in the current browser.
Creator
HanaAyane
Size
8.8 MB
Stars
227
Age
2mo
Commits · 90 Days