dsh-ua-headers

Ua Headers

Customize the User-Agent and additional request headers used when calling the selected model, with a control panel provided on the settings page.

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:fplj-fplj/dsh-ua-headers#d77ce37aeb23d0cdbe1b4e12ab6a81f69e869017

Compatibility and provenance

Ua Headers is published as dsh-ua-headers and currently resolves to version 1.0.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: github
Registry updated: 8/23/2026

Versions

1.0.0stable

8/23/2026

README

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 即可找到。

使用

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

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

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

说明

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

README

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 即可找到。

使用

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

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

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

说明

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

Ua Headers

Compatibility and provenance

Versions

Related plugins

Ua Headers

README

dsh-ua-headers

功能

安装

从 GitHub 安装（源码）

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

DSH Market

使用

说明

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

dsh-ua-headers

功能

安装

从 GitHub 安装（源码）

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

DSH Market

使用

说明