dsh-ua-headers

一个 DSH 插件：自定义所选模型调用时的 User-Agent，并加入自定义请求头；设置页里提供控制面板。

功能

• 自定义 UA：匹配到的模型请求会替换 User-Agent；留空则保留 DSH 默认 UA。
• 加入请求头：以 JSON 对象配置任意 HTTP 请求头（如 X-Trace-Id、Authorization-Override 等），会合并进模型请求。
• 按模型匹配：支持 * 全部模型、精确模型 ID、deepseek-* 前缀匹配、*pro 后缀匹配。
• 自动检测供应商与模型：设置页会通过 ctx.llm 检测当前已注册供应商及其可用模型，勾选即可，无需手输模型 ID。
• 设置页控制面板：在 Web 设置面板中新增“UA 与请求头”页面，可视化编辑并保存。
• 配置持久化到 $DSH_HOME/storages/dsh-ua-headers.json。

安装

从 GitHub 安装（源码）

dsh plugin --profile web add github:fplj-fplj/dsh-ua-headers

从 npm 安装（推荐 / 可被 DSH Market 收录）

dsh plugin --profile web add dsh-ua-headers

安装后重启 DSH Desktop / Web 服务。插件清单已通过 cordis.patch.yml 插入，无需手动改 cordis.yml。

DSH Market

本插件已发布到 npm，并提交到 DSH 1024Store / deepseek1024.com。在 DSH 设置 → 插件市场中搜索 dsh-ua-headers 即可找到。

使用

1. 打开 DSH 设置（左下角齿轮）。
2. 进入「UA 与请求头」页面。
3. 打开“启用自定义 UA 与请求头”。
4. 填写 User-Agent；留空则不改写 DSH 默认 UA。
5. 设置模型匹配：
   • 勾选「全部模型」使用 *；
   • 或直接从「当前已有供应商与模型」列表中勾选实际模型；
   • 也可以手动输入规则，例如 deepseek-v4-pro, deepseek-v4-flash 或 deepseek-*。
6. 填写请求头 JSON，例如：

{
  "X-Trace-Id": "my-trace-id",
  "X-Request-Source": "dsh"
}

7. 保存。下一次匹配的模型调用即生效。

说明

• 插件在 Host 进程 patch globalThis.fetch，拦截 OpenAI 兼容的 /chat/completions（及 /responses）POST 请求，读取请求体中的 model 字段并与配置匹配。
• 只有匹配到的模型请求会改写 UA / 合并请求头，其他 HTTP 请求不受影响。
• 自定义请求头会覆盖同名请求头；未出现过的请求头会新增。
• 请求头名称必须是合法 HTTP token，值不能包含换行或 NUL。