dsh-model-probe：DeepSeek Harness 模型能力声明审计插件

前言¶

在 DeepSeek Harness (DSH) 中配置模型能力（如 maxTokens、contextWindow）时，如果声明值超过端点实际限制，或者声明值错误，往往不会报错，而是导致请求静默失败（如 HTTP 400）。dsh-model-probe 插件通过直接探测端点行为，修正这些声明错误。

插件简介¶

该插件由用户 xiaomao49 维护，是一个 DeepSeek Harness 插件。它通过向端点发送探测请求，测量模型实际接受的能力范围，并与本地声明的配置进行比对，仅重写证据证明错误的字段。

核心功能¶

• 实测与修正：不依赖静态知识库，而是直接测量端点实际接受的内容。
• 审计现有值：与只填充缺失值的插件不同，它会检查字段是否已有值，并验证这些值是否正确。
• 检查范围：支持检查 contextWindow、maxTokens、reasoningEfforts、input（图像支持）四个字段。
• 双协议支持：支持 openai-completions 和 anthropic-messages 两种协议。
• 自包含：纯 JavaScript 实现，无构建步骤，无运行时依赖。

安装与启用¶

安装前需确认 DSH 实际启动的 Profile 名称。如果安装到错误的 Profile，插件不会被加载。

1. 确认 Profile 名称：
   • DSH Desktop: 检查 profile-selection/state.json 中的 active 字段（通常是 "desktop"）。
   • CLI / Web: 使用 dsh --profile <name> 指定的名称（默认为 web）。
2. 安装插件：

    dsh plugin --profile web add dsh-model-probe

3. 验证安装：

    dsh --profile web --dump-config | grep model-probe

输出中包含 `id: model-probe` 表示已生效。

4. 重启：需完全退出并重启 DSH 以完成热挂载。

典型用法¶

通过设置页面¶

在 DSH 界面中进入 设置 -> 模型配置实测。

1. 为对应的 Provider 开启 允许探测。
2. 执行扫描或确认应用修改。

通过 Agent Tools¶

在 Agent 场景下，可以使用以下工具：

• model_probe_status：查看探测状态。
• model_probe_scan：执行扫描。
• model_probe_apply：应用修正。

注意事项¶

• Profile 限制：必须安装到 DSH 实际启动的 Profile（如 DSH Desktop 的 desktop），否则不会生效。
• 重启要求：配置生效需要完全重启 DSH。
• 旧版本兼容性：0.1.2 及更早版本存在 Peer Dependency 警告（信息性，不影响运行），且在所有请求失败时无法正确报告错误，建议使用最新版本。

总结¶

dsh-model-probe 解决了模型声明能力与实际端点不一致导致的静默失败问题，特别适合需要精准控制模型上下文和 Token 限制的场景。插件通过自包含的纯 JS 实现，提供了设置页和 Agent 工具两种使用方式。

目录页
GitHub 仓库