mc-lhz/dsh-add-headers-to-completions

dsh-llm-headers

给 DeepSeek Harness 的模型请求注入自定义 HTTP 请求头的 bundle 插件（软替换：独立设置区块，与官方 Models 页共存）。

它能做什么

• 向大模型请求注入自定义 HTTP 请求头，如 User-Agent、x-company、x-model-trace 等
• 支持全局、按 provider、按模型注入

安装

前置：Node ≥ 20（install.mjs 无需 pnpm；dsh plugin 方式需要 pnpm）。目标机的 %DSH_HOME%\profiles\web 需已存在（先成功启动过一次 dsh web）。

1.克隆仓库/下载ZIP包

git clone https://github.com/mc-lhz/dsh-add-headers-to-completions.git
cd dsh-add-headers-to-completions

2.安装

node ./install.mjs

3.重启 dsh web（浏览器硬刷新 Ctrl+F5 加载新客户端）

dsh web

若 dsh 命令未全局安装，用你平时的启动方式（如 harness 源码目录下的 node --import tsx/esm apps/cli/src/bin.ts --profile web）。

harness 补丁（必需，本地改动，升级 harness 后需重打）

为什么必需：补丁1（设置命名空间可见）：设置命名空间默认对插件不可见；补丁2：user-agent 是 harness attribution 的保留名（适配器会过滤部署 UA 再补 deepseek-harness/...）。这两个行为必须改源码。 不用手动改——复制下面两段提示词，分别粘贴给DeepSeek Harness或其他 AI 编码助手，它会在你的 harness 源码目录完成修改；提示词已带幂等与校验。 目标目录：harness 源码根目录（packages/... 所在层）。

【dsh-llm-headers 补丁 1/2 · 设置命名空间白名单】
目标文件：harness 源码根目录/packages/host/apiproxy/src/api-proxy.ts

请在该文件中做一处小修改（只改这一处，不得改动文件其它任何内容）：
把：
  const WEB_SETTINGS_NAMESPACES = [
    'agent-loop', 'shell', 'locale', 'permission', 'ui-conversation', 'ui-theme', 'web-search-deepseek',
  ] as const
替换为：
  const WEB_SETTINGS_NAMESPACES = [
    'agent-loop', 'shell', 'locale', 'permission', 'ui-conversation', 'ui-theme', 'web-search-deepseek',
    // dsh-llm-headers: user-installed plugin's own settings section (soft
    // replacement, coexists with the official Models page). The namespace is
    // registered by the plugin; this allowlist is the exposure gate for the
    // settings configuration clients.
    'dsh-llm-headers',
  ] as const

规则：若文件里已存在行 'dsh-llm-headers',（含注释）则说明已打过，直接报告“已打过，跳过”并结束；
替换前先确认锚文本完全匹配（含缩进）；完成后显示被替换位置的上下文供核对。
背景：缺它时，插件设置的 dsh-llm-headers 命名空间对设置页/GUI 不可见（回答 settings-not-exposed）。

【dsh-llm-headers 补丁 2/2 · 放开 user-agent 覆盖】
目标文件：harness 源码根目录/packages/llm/llm-pi-ai/src/adapter.ts

请把 requestHeaders 函数整体替换（函数签名保持不变）：
原函数：
  function requestHeaders(headers: Readonly<Record<string, string>> | undefined): Record<string, string> {
    const deployment = headers ?? {}
    const attribution = attributionHeaders()
    const reserved = new Set(Object.keys(attribution).map(name => name.toLowerCase()))
    const kept = Object.fromEntries(
      Object.entries(deployment).filter(([name]) => !reserved.has(name.toLowerCase())),
    )
    return { ...kept, ...attribution }
  }
替换为：
  function requestHeaders(headers: Readonly<Record<string, string>> | undefined): Record<string, string> {
    const deployment = headers ?? {}
    const attribution = attributionHeaders()
    const reserved = new Set(Object.keys(attribution).map(name => name.toLowerCase()))
    // 本地增强（dsh-llm-headers）：部署显式配置的 user-agent 允许胜出 ——
    // 这是本 build 唯一允许部署覆盖的 attribution 名；其余保留名仍以
    // Harness attribution 为准（过滤部署同名头、attribution 最后合并）。
    const deploymentHasUserAgent = Object.keys(deployment).some(name => name.toLowerCase() === 'user-agent')
    const kept = Object.fromEntries(
      Object.entries(deployment).filter(([name]) => {
        const lower = name.toLowerCase()
        return !reserved.has(lower) || lower === 'user-agent'
      }),
    )
    const keptAttribution = Object.fromEntries(
      Object.entries(attribution).filter(([name]) => {
        const lower = name.toLowerCase()
        return lower !== 'user-agent' || !deploymentHasUserAgent
      }),
    )
    return { ...kept, ...keptAttribution }
  }

规则：若文件里已存在注释行“本地增强（dsh-llm-headers）”则说明已打过，直接报告“已打过，跳过”并结束；
替换前先确认原函数文本完全匹配；完成后显示新函数头几行供核对。
背景：缺它时，部署在 llm-pi-ai.providers.*.headers 里配置的 User-Agent 会被过滤，
请求最终带上 deepseek-harness/<版本> 的 UA；打过之后显式配置的 UA 才能胜出。