dsh-better-reasoning-effort-fish

原作者与授权（请先读）

署名与改动范围的完整说明见 NOTICE.md。再分发时请保留原作者署名。

解决什么问题

llm-pi-ai 适配器原生支持每模型声明 reasoningEfforts（思考强度）与 input（输入模态），但官方「模型」页编辑卡刻意不暴露这两个字段。结果：第三方模型在 Composer 里没有思考档位选择器，只有官方 DeepSeek API 能设思考强度，手工声明的模型被当作纯文本，想配置只能手写 settings.yaml 块。

本插件把这两份配置能力搬回 UI：在官方模型编辑卡内直接编辑，加一键自动适配（内置模型知识库 + 线协议推断）。

本版（本 Fork）相对上游的改动：让出官方模型能力面板的 settings.models.provider-card 席位，避免与 dsh-web 的模型能力插件冲突。 详见兼容与边界。

效果

安装

需要 DeepSeek Harness 0.1.5-alpha.1 或更高（按 peerDependencies 范围），当前对照 0.2.0-rc.2 编译与门禁。Node 要求 ^22.19.0 || >=24。

从 npm 安装（推荐）：

# 桌面版
dsh plugin --profile desktop add dsh-better-reasoning-effort-fish

# Web 版
dsh plugin --profile web add dsh-better-reasoning-effort-fish

DSH 内置 pnpm 的 minimum-release-age 为 24 小时：版本发布后一天内的安装会解析到「足够旧的最新版」。写明版本号可立刻安装，例如 dsh-better-reasoning-effort-fish@0.5.8。

release 页面同时附带打包好的 tarball，这条路线跳过 registry 与发布冷静期。tarball 是成品，pnpm 不执行任何脚本，也不需要构建授权。URL 指向单一版本，升级时替换它即可：

dsh plugin --profile web add \
  https://github.com/Fish-under-sea/dsh-better-reasoning-effort-fish/releases/download/v<version>/dsh-better-reasoning-effort-fish-<version>.tgz

从 GitHub 源码安装，用于开发与审查而非日常安装。pnpm 要跑 prepare 钩子构建 lib/，且只在 allowBuilds 存在对应条目后才放行。安装器会打印确切的键，该键包含解析到的 commit：把它加进 profile 的 pnpm-workspace.yaml 后重新执行 add。新 commit 会改变这个键，因此每次发版都要重新授权：

dsh plugin --profile web add github:Fish-under-sea/dsh-better-reasoning-effort-fish

链接本地检出（改源码用）：

npm install && npm run build
dsh plugin --profile desktop add link:/path/to/dsh-better-reasoning-effort-fish
dsh plugin --profile web add link:/path/to/dsh-better-reasoning-effort-fish

安装后重启 DSH 并强制刷新浏览器。

使用

1. 在官方「模型」页配置第三方供应商（API Key 等）。
2. 展开某个模型行：官方容量字段下方是编辑块。
   • 勾选档位（off / minimal / low / medium / high / xhigh / max），填线上取值（如给 high 填 ultra，Composer 选 High 时网关收到 ultra）；
   • 在「输入模态」区勾选图片输入，声明模型接受什么；
   • 点「自动适配」填推荐档位与模态 —— 参考容量以只读提示出现，可自行照抄进官方输入框；
   • 改动即时进入待写入，点卡片自身的保存时一并落盘；取消（或刷新）则与卡片字段一起丢弃。
3. 协议兼容时，底部会出现「端点兼容」分区 —— openai-completions 上设思考预算字段 / vLLM 优先级，openai-responses 上设 max_output_tokens 的处理方式。
4. 请求头：展开提供商卡片，编辑块上方就是请求头区域（掩码显示、随卡片保存），可填 user-agent 等自定义请求头。
5. 全不勾 + 保存 = 取消声明（回到继承）；只勾 off + 保存 = 禁用推理（false）；模态行「清除声明」+ 保存 = 回到继承提供方默认。

声明后的模型在 Composer 里立即可选思考强度；声明了图片输入的模型可以端到端传附件。

配置

host 侧接受以下可选配置项（写入 settings.yaml 的插件 config 块）：

示例：

- insert:
    - id: dsh-better-reasoning-effort-fish
      name: dsh-better-reasoning-effort-fish
      config:
        autofill: true
        modalityAutofill: true
        probeTimeoutMs: 15000
        bootRetryDelaysMs: [1000, 2000, 4000, 8000, 16000, 30000]
        defaultGuard: true

兼容与边界

本 Fork 只做一处修复：请求头编辑器不再占用官方 settings.models.provider-card 席位，改挂官方卡片自身的编辑器容器。

原因是官方该席位为 keyed slot —— 注册表对同一 (key, priority) 只接受一个条目，第二个注册直接抛错。dsh-web 全家桶的 @linxin666/dsh-client-ui-model-capabilities（模型能力面板）注册的正是同一个 llm-pi-ai key、同一个默认优先级 0。两者都占时只有一个能注册成功，另一个的整块界面静默消失。因 dsh-web 走异步壳行加载，实际被挤掉的是模型能力面板（每模型思考强度 / 图片输入）。

改动落在 src/client/injection/provider-card.ts（新增）、src/client/index.ts（不再注册席位）与 src/client/injection/models-page.ts（接入页面扫描）。回归防护见 tests/client.spec.tsx 与 tests/provider-card.spec.tsx。

两者的插件 id、host 路由前缀（/dsh-better-reasoning-effort-fish/*）与包名都已分开，可在同一 profile 并存；实际使用建议只装一个，避免同一份设置被两套 UI 同时编辑。

Composer 滑块改编自 HanaAyane 的 dsh-reasoning-effort（MIT）。如果用过上游那个插件，请先移除以免同一席位出现两个档位控件：

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

已知限制

• 注入依赖官方「模型」页的 DOM（aria-label / class）；官方升级可能让注入暂停直至适配 —— 期间官方页不受影响。
• 自动适配探测路由只应答回环与 IP 字面量 host，且从不跟随重定向 —— 只在 30x 后面列模型的网关拿不到端点证据，自动适配回退到知识库与协议推断。
• reasoningEfforts 声明是建议 —— 端点真正接受什么以它的文档为准，请在 UI 里微调。
• 端点兼容开关刻意永不自动填充：它们描述的是网关行为而非模型能力。
• 模态词汇跟随 pi-ai 核心（当前 text / image）；更宽的网关支持（PDF / 音频 / 视频）在核心词汇扩充前声明不了，这是设计使然。
• 命名启发式的模态建议（视觉风味 id）刻意标注低置信度，使用前请核对。
• 自建中转：对没有官方 host 认领的路由，自动填充会钉 supportsDeveloperRole: false；显式值永不被覆盖。
• 强制思考模型（无 off 的梯子，如 GLM-5.3）：无档位调用自动落厂商默认档而不是发 thinking: disabled —— 设 defaultGuard: false 可恢复原行为。
• headers 中的凭据在磁盘上不脱敏：只读视图会掩码，但设置文档仍明文保存 —— 请当 API key 对待。
• 请求头区域依赖官方卡片的编辑器容器：官方若改变该结构，请求头区域会停止出现 —— 绝不弄坏官方页面。这也是本版相对上游的取舍：不再使用官方席位，换来与 dsh-web 插件共存。
• 同一时间只应有一个 user-agent 改写器：同类 header 插件落在同一层，后写者赢；插件会检测并提示已知同类，但不覆盖未知情况。
• 请求层接管依赖官方适配器每请求新建 SDK 客户端 —— 有端到端测试守护该边界，变化时会响亮地失败而不是静默失效。

更多兼容性细节见 docs/compatibility-notes.md，支持的模型列表见 docs/supported-models.md。

开发与测试

npm run typecheck   # tsc 严格检查
npm test            # vitest：知识库 / 推断 / 自动填充 / DOM 注入 / 写入
npm run build       # lib/*.js + lib/client.js

测试由 vitest 驱动，需先 npm install 安装依赖（全新 clone 不含 node_modules），再 npm test 运行；构建用 npm run build（lib/ 为构建产物，已被 gitignore，clone 里不含）。

本机在 DSH 文件沙箱下开发时，vitest 与 esbuild 需要额外处理（沙箱禁止子进程管道）—— 完整命令见 FORK.md。

与聚合包的关系

本包是独立仓库（https://github.com/Fish-under-sea/dsh-better-reasoning-effort-fish），不在 dsh-fish 单仓内；但它是聚合包 @fish-under-sea/dsh-fish 的成员之一，可与聚合包内其他插件一起安装。

许可

MIT，著作权归原作者 HaoyueQin；本版新增代码同样以 MIT 发布，再分发请保留 LICENSE 与 NOTICE.md。