QiE2035/dsh-llm-headers

dsh-llm-headers

为 DeepSeek Harness 的自定义 LLM API 请求注入 HTTP Headers（典型用途：改写 user-agent，例如网关要求 UA 带指定品牌字样）。

原理

DeepSeek Harness 的 LLM 适配器（dsh-llm-deepseek、dsh-llm-pi-ai）都通过全局 fetch 发出模型请求。本插件在加载时包装 globalThis.fetch：仅对 URL 匹配 urlPatterns 的请求，把配置的 headers 逐项 set() 上去（覆盖同名头，包括适配器的强制 attribution user-agent —— 即部署者白标替换场景），其余请求原样透传。提供商无关，一次配置同时作用于所有 LLM provider。

配置不写死：插件把 Config schema 注册为 llm-headers 用户配置命名空间，Web UI 的 settings 页面会自动渲染该命名空间的编辑表单，修改保存后下一个请求即生效（live 热重载，无需重启）。

安装

作为 bundle（发布形态）

把本目录作为一个包安装进 profile：

dsh plugin --profile <name> add /path/to/llm-headers

dsh 会追加 llm-headers 到 profile 的 bundle 层，默认配置下插件处于惰性状态（headers 为空），不会改写任何请求。

本地源码加载（开发形态）

在任一 cordis.yml（或 patch overlay）里按路径引用源码，仅用于开发调试：

- insert:
    - id: llm-headers
      name: /absolute/path/to/llm-headers/src/index.ts

配置

- id: llm-headers
  name: dsh-llm-headers
  config:
    headers:
      user-agent: opencode/1.0
    urlPatterns:
      - /chat/completions

通过 Web UI 配置

安装到含 Web 界面的 profile 后：

1. 打开 Web UI → Settings（设置）页面；
2. 「插件」→「插件配置」应看到本插件的 LLM 请求头卡片（服务端注册已就绪）；
3. 填写 headers 与 urlPatterns 保存，写入 user-settings 文档并实时生效（applies: live）。

UI 保存的值优先级高于 cordis.yml 中的 config（作为 base 层）。

通过 settings.yaml 配置（备用）

llm-headers:
  headers:
    user-agent: opencode/1.0
  urlPatterns:
    - /chat/completions

保存即热重载（applies: live），无需重启。

开发

依赖全部来自 npm registry（@deepseek-ai/cordis、@deepseek-ai/schemastery、@deepseek-ai/dsh-settings 及构建工具），克隆后直接安装即可；其余 @deepseek-ai/* 包（宿主侧的适配器、settings provider 等）由 DeepSeek Harness 安装提供，本插件不直接依赖。

pnpm install         # 同时安装 lefthook pre-commit 钩子（lint + 空白检查）
pnpm typecheck       # tsc --noEmit
pnpm test            # vitest：fetch 代理行为矩阵 + 客户端逻辑/RPC/集成
pnpm test:coverage   # v8 覆盖率门禁：src 逐文件 100%，CI 以此为准
pnpm lint            # oxlint + stylistic/sonarjs，规则集与 deepseek-harness 一致（无分号、单引号）
pnpm lint:fix        # 全仓自动修复
pnpm duplication     # jscpd 重复检测
pnpm hygiene         # build + knip + publint 发布前检查
pnpm build           # tsdown 产出 lib/（ESM + 类型声明）
pnpm test:e2e        # 自动化冒烟（需 DEEPSEEK_API_KEY，见下文）