dsh-fetch-header-rewrite —— 可配置的请求头改写插件（User-Agent 等）

[MwumLi]

简介

dsh-fetch-header-rewrite 是一个 dsh（DeepSeek Harness）的 cordis 插件：通过 patch globalThis.fetch，改写 dsh 所有 provider 请求的 HTTP 请求头（如 User-Agent、任意自定义头）。一份配置对全部 provider 路由生效，与具体适配器无关。

为什么需要

• 白标/公司网关常按 User-Agent 做白名单：实测某网关对 dsh 默认 UA 返回 403 this User-Agent is not allowed by configured policy，把 UA 改为 opencode/0.2.1 后返回 200。
• dsh 当前把 attribution UA 硬编码、无法配置（llm-pi-ai 还会剥离 profile headers 中的 user-agent）。
• 本插件不改 dsh 源码即可覆盖该场景，并可用于注入任意请求头。

相关讨论

• [Bug] HTTP 403 授权拒绝被归类为 AUTH，UI 显示 "API key is invalid"，原始错误不可见：[Bug] HTTP 403 授权拒绝被归类为 AUTH，UI 显示 "API key is invalid"，原始错误不可见 #3222
• [Feature] 支持统一配置白标 User-Agent（appIdentity），对所有 provider 生效：[Feature] 支持统一配置白标 User-Agent（appIdentity），对所有 provider 生效 #3225

本插件是上述 Bug 场景的临时 workaround：在官方 appIdentity 功能落地前，用它给网关配置允许的 User-Agent（或任意请求头）。若官方提供统一配置能力，届时按需移除本插件，改用官方方案即可。

特性

• 任意请求头（大小写不敏感覆盖），不限于 User-Agent
• 全局 headers 作用于所有请求；可选 rules 按序匹配、首个命中即停、命中规则与全局合并（同名规则胜出）
• match 支持 URL 前缀，或 /pattern/flags 正则（对完整 URL 做 test，如 /^https://corp\.example/i）
• 零默认值：未配置时插件 no-op，不修改任何请求；包内不内置任何 URL 或头值
• 无效规则启动时警告并跳过，其余规则照常生效
• verbose 日志自动脱敏 authorization/cookie 等凭据头
• 纯 JS、零构建、零运行时依赖（仅声明可选 peer @deepseek-ai/cordis）

安装

# npm 发布版
dsh plugin --profile web add dsh-fetch-header-rewrite

# 或直接从 GitHub 安装
dsh plugin --profile web add github:MwumLi/dsh-fetch-header-rewrite

在 profile 的 cordis.patch.yml 挂载：

- insert:
    - id: dsh-fetch-header-rewrite
      name: dsh-fetch-header-rewrite

配置示例

改所有请求的 User-Agent：

- insert:
    - id: dsh-fetch-header-rewrite
      name: dsh-fetch-header-rewrite
      config:
        headers:
          user-agent: opencode/0.2.1

全局默认 + 按规则精确控制：

      config:
        headers:                 # 全局默认：所有请求
          user-agent: opencode/0.2.1
        rules:                   # 按序，首个命中即停；命中与全局合并
          - match: https://api.example.com
            headers:
              x-tenant: acme
          - match: /^https://corp\.example/i
            headers:
              x-region: cn
        verbose: false           # true 时打印改写日志（凭据头脱敏）

链接

• 源码：https://github.com/MwumLi/dsh-fetch-header-rewrite
• npm：https://www.npmjs.com/package/dsh-fetch-header-rewrite
• 本地开发与调试方式见仓库 README（node --test、file: 挂载、verbose 调试）

已知局限

• 依赖 adapter 通过全局 fetch 发请求（当前 DeepSeek adapter 与 pi-ai 均是）；未来若某 adapter 改用自定义 dispatcher 则不在覆盖范围
• 匹配目标是完整请求 URL；规则"首个命中即停"，宽泛规则请放在后面
• 属于 workaround；根治方向是 dsh 官方支持可配置的应用身份（app identity），关注 [Feature] 支持统一配置白标 User-Agent（appIdentity），对所有 provider 生效 #3225

[nigiwen]

不能单个控制？