模型推理强度配置 xurunxin/dsh-llm-model-tuning

dsh-llm-model-tuning

CI

为 DeepSeek Harness Settings → Models 页面上的每个自定义提供方卡片添加一个按模型配置的 reasoning-effort（推理强度）和 multimodal input（多模态输入）编辑器。

需要 dsh 0.1.7 或更高版本。 此卡片通过 configForms 服务写入设置；旧的 settingsScope 服务已在 0.1.7 中移除。参见要求。

随附的提供方编辑器有意不提供推理控制：effort 是按模型的能力，而同一个提供方下的各个模型对此意见不一，因此提供方级别的控制只能被设置为其中某些模型会拒绝的值。本插件改为采用按模型的粒度——它列出该路由自身的模型条目，并编辑每个条目上的两个字段：

| 字段 | 含义 |
| reasoningEfforts | 该模型提供哪些 effort 级别，以及每个级别发送时的线上拼写。false 声明一个非推理模型；缺省则继承已安装的目录。 |
| input | 该模型接受哪些请求模态（text、image）。缺省则继承已安装的目录。 |

它还会编辑路由级别的 defaultInput 回退值，正是这一点让一个提供目录未描述的视觉模型的网关变得可用。

这两个字段都会写入 llm-pi-ai 设置区段，因此更改无需重启即可在下一个请求中生效——适配器按请求解析配置文件。

为什么这是一个客户端插件

整个贡献就是 settings.models.provider-card 座位上的一个卡片，以提供方行自身的设置命名空间为键。由于每个可配置的 pi-ai 路由都声明了 settingsNs: 'llm-pi-ai'，在该键下的单次注册即可接收每个自定义提供方卡片——无论是已保存的行还是添加提供方的草稿——而 Models 区段对此插件一无所知。

宿主部分有意留空。它存在只是为了让配置文件行解析到一个真实的包，这正是让 @deepseek-ai/dsh-client-modules 扫描 dsh.client 声明并将 lib/client.js 提供到浏览器启动图中的原因。

安装

使用插件管理器安装该 bundle，将其指向此目录：

plugin_manager action: install_bundle target:

它会自行执行包安装和 bundle 选择——添加依赖、将其链接到活动配置文件的 node_modules 中，并将该包追加到 dsh.profile.bundles，因为它声明了 dsh.bundle.patch。不要手动编辑配置文件的 package.json 或 cordis.patch.yml，也不要在配置文件目录中运行包管理器。

安装是指向此目录的符号链接，因此之后在此处的编辑无需重新安装即可被拾取。新安装的 bundle 可以通过 HMR 激活；被替换的 bundle 需要重启配置文件才能加载新的 JavaScript 模块代。
要求

- dsh 0.1.7 或更新版本。 此卡片通过 configForms 服务读写设置。旧的 settingsScope 服务已在 0.1.7 中移除，仍然注入它的卡片永远不会激活——该行只会永远等待。test/bundle-contract.mjs 会防止这种回归。
- 必须组合 llm-pi-ai 适配器，因为它拥有此卡片所编辑的设置命名空间。该卡片通过 configForms.whileServed 跟随它，因此没有该适配器的部署不会显示此卡片的任何痕迹，而不是一个死面板。

此卡片对你的文档做了什么

- 编辑面。 该卡片读取并写入 llm-pi-ai 部分的用户层。仅在组合基础中声明的路由会从解析后的值中读取，因此它仍然可以被调整；写入它才会将其具体化到用户层中。
- 按路径寻址的写入。 每次编辑都以针对已存储部分的 settings.mutate 路径操作形式进行，因此卡片从未渲染过的字段无法被删除。命名空间修订版本会防止过期卡片与并发更改发生冲突。
- models 与 modelOverrides。 models 列表会替换已安装的目录，而 modelOverrides 会重塑它。适配器拒绝同时使用两者，因此卡片会编辑配置文件已经使用的那个，并在两者都不存在时提供添加 modelOverrides 条目的选项。models 列表是一个数组——而设置路径操作遍历器拒绝向下遍历数组——因此该数组会作为一个值写入；modelOverrides 字典则逐字段寻址。
- 文本会被保留。 input 和 defaultInput 会替换模态列表，而不是扩展它，因此仅声明图像会悄悄丢弃文本，并留下一个 harness 无法再与之对话的模型。因此文本始终会被保留，而清除最后一个可选模态会移除该字段，以便适配器自己的默认值来应答。
- 拒绝会在本地被命名。 ConfigFormController.mutate 报告的是 Host 是否接受了写入，而不是它拒绝了哪个字段。因此，卡片会复现适配器自己的 reasoningEfforts 规则（每个级别都需要一个线上拼写；只有 off 可以为空；至少需要一个 off 之外的级别），以便拒绝时能指出字段名，并且它仍会将 Host 的拒绝报告为失败，而不是成功。

测试

npm test

四个套件，全部离线，无需安装依赖：

| 套件 | 它证明了什么 |
| test/harness.mjs | 卡片自身的行为，通过其真实输入驱动，针对一个忠实的设置操作模拟器。包括一个拒绝绝不会被报告为成功的案例，以及一个证明当 Host 不提供该命名空间时不会注册任何内容的案例。 |
| test/integration.mjs | 卡片写入的确切部分会被真实的 llm-pi-ai Config schema 接受。 |
| test/conformance.mjs | 文档形状，以及卡片复现的拒绝，都会针对同一个真实 schema 进行检查。 |
| test/bundle-contract.mjs | 该 bundle 满足加载器的注册协议，且不依赖模块基线之外的任何内容。 |

这两个经过 schema 校验的测试套件需要安装 @deepseek-ai/dsh-llm-pi-ai 才能进行比对。test/dsh-adapter.mjs 会从 DSH_PROFILE_DIR、DSH_HOME 或通常的 ~/.dsh/profiles 布局中查找一个；当找不到任何一个时，它们会打印一条带标签的 SKIP 并以 0 退出，而不是失败，因此没有 DSH 安装的贡献者仍然能得到一次绿色的运行结果。设置 DSH_PI_AI_DIR 可指向非标准布局。

conformance.mjs 中最后的断言是有意设计为信息性的：真实 schema 接受思考级别的空 wire 值，因为只有适配器的解析步骤会拒绝它。这证实了卡片自身的校验是承重的，而非冗余的。

限制

- 该卡片仅编辑 reasoningEfforts、input 和 defaultInput。容量、兼容性开关和凭据仍由随附的编辑器和 settings.yaml 管理。
- 超出 schema 所接受的七个级别（off、minimal、low、medium、high、xhigh、max）之外的级别在写入时会被保留，但不会提供用于编辑。
- 设置存储在用户的 settings.yaml 中；该卡片自身不保存任何状态。