思考强度配置 cyberlieflife/dsh-model-thinking

dsh-model-thinking

DSH Web GUI 插件：为 自定义模型（OpenAI-compatible 的 llm-pi-ai 提供方）增加思考强度（thinking intensity / reasoning effort）配置。

官方设置页的「模型」卡片刻意不提供 reasoning-effort 控件（它属于按模型的能力），本插件把这一层配置做成独立的设置分区：

- 按提供方：默认思考强度（providers..reasoning）——请求未显式选择级别时自动生效；
- 按模型：思考能力开关（reasoningEfforts：false 关闭 / 级别表启用）、思考强度级别及其线格式（wire spelling）、推理分派兼容（compat.thinkingFormat / supportsReasoningEffort）。

所有写入都落在既有 llm-pi-ai 用户设置段（settings.mutate 路径操作 + revision 围栏），不改动 DSH 源码。配置后：

- 会话 composer 的模型选择器会为这些模型显示思考强度级别（adapter 通过 resolveModelInfo 暴露）；
- 未选择级别时使用提供方默认强度（adapter 的 defaultEffort 物化路径）。

界面

设置面板 → 「思考强度」（位于「模型」与「插件」分区之间）：

┌ 提供方卡片 ─────────────────────────────┐ │ Jasper [jasper] [未保存] [用户已配置] │ 默认思考强度: [高] │ ┌ 模型行 ───────────────────────────┐ │ │ │ DeepSeek-V4-Flash [思考能力: 启用思考] │ │ │ 思考强度级别: │ │ │ │ ☑ 关闭 [线格式留空] ☐ 最低 ☑ 高 [high] │ │ │ 推理分派兼容: thinkingFormat [继承] │ │ │ │ supportsReasoningEffort [继承] │ │ └───────────────────────────────────┘ │ └────────────────────────────────────────┘
[放弃] [保存]

思考强度级别

off / minimal / low / medium / high / xhigh / max（pi-ai ModelThinkingLevel）。每个勾选的级别可以填写独立的线格式值（发给端点的参数，默认等于级别名；off 留空 = 不发送该参数）。启用思考时至少要有一个非 off 级别。

安装（web profile）

1. 构建（需要 node >= 20 + pnpm）
pnpm install
pnpm build # 产出 lib/（node 半 + client 半）

2. 挂载到 web profile —— 一条命令：
pnpm add 到 profile + 自动加入 dsh.profile.bundles（因本包声明了 dsh.bundle.patch）
dsh plugin --profile web add link:

3. 重启 dsh web 并硬刷新浏览器（Ctrl+Shift+R）

等价的手工步骤：在 ~/.dsh/profiles/web/package.json 的 dependencies 加 "dsh-model-thinking": "link:"，把 dsh-model-thinking 追加到 dsh.profile.bundles，然后在 profile 目录 pnpm install。bundle 层会自动应用本包的 cordis.patch.yml（插入 model-thinking 插件行），浏览器端经 dsh.client 声明加载 /plugins/dsh-model-thinking/client.js。

卸载：dsh plugin --profile web rm dsh-model-thinking（或手工移除依赖 + bundles 条目 + pnpm install）。
从 GitHub 安装

dsh plugin --profile web add github:cyberlieflife/dsh-model-thinking

包的 prepare 脚本会在安装时自动构建（本机需 node >= 20 + pnpm）。pnpm 默认会拦截依赖的构建脚本：如果安装时提示 build script 被忽略，在 profile 目录的 pnpm-workspace.yaml 的 allowBuilds 下按提示加入对应键（如 dsh-model-thinking: true），然后重跑上面的命令。

数据形态（写入 ~/.dsh/settings.yaml 的 llm-pi-ai 段）

llm-pi-ai:
providers:
jasper:
reasoning: high # 默认思考强度 models:
- id: deepseek-v4-flash
reasoningEfforts:
off: null # off 不发送参数 high: high compat: thinkingFormat: deepseek # 端点期望的思考参数格式 supportsReasoningEffort: true # 端点接受 reasoning_effort

这些字段本就是 dsh-llm-pi-ai 适配器理解的配置（PiAiProviderProfile / PiAiModelProfile），写错会被适配器的设置校验拒绝（页面显示保存失败原因），不会留下坏配置。

开发

- pnpm typecheck —— tsc 全量检查
- pnpm test —— ops 构建器单元测试（vitest，node 环境）
- pnpm build —— tsc 出类型 + tsdown 出 lib（node 半 ESM；client 半 CJS closure，经 window.__ModuleLoader__.load 注册，react/cordis 走平台模块表）

结构

src/
index.ts # host 半（占位 apply；浏览器面在 ./client） invariant.ts client/ index.tsx # client 半入口：locale + settings.section 注册 locales.ts # zh / en 词典 model-thinking.ts # 纯模型：级别/线格式/draft/ops 构建器 controller.ts # 控制器：describe -> draft -> mutate（revision 围栏） thinking-section.tsx # 设置分区 UI section.module.css # 自包含样式 tests/ ops.spec.ts

设计约束

- 不修改 DSH 源码；只经 cordis.patch.yml + profile 机制挂载；
- client bundle 纯度门：禁止 value-import 其他 @deepseek-ai/* 包（类型导入被擦除不触发）；
- 写入用路径操作而非重建整个 providers 子树，避免丢弃页面未编辑的字段（headers/retryPolicy 等）；
- 并发修改冲突（settings-conflict）时重新加载并提示，不覆盖他人的写入。

许可

MIT