配置

界面

设置 → 请求头 区块：三层编辑器（global / providers / models），改动即落盘，并自动同步到 llm-pi-ai.providers..headers（真实通道）：

global 写进所有 llm-pi-ai provider；providers 按路由写；
清空某层会把之前同步的头移除（你在 llm-pi-ai 里手写的其它头不受影响）。

也就是说，界面配的 User-Agent 会经 pi-ai 的 openai SDK 真实发到请求里（syncToProviders: true 默认开）。

YAML 直写（高级）

dsh-llm-headers:            # 命名空间：UI 读写这里（fetch 层通道 + 同步源）
  syncToProviders: true     # 表变更自动同步到 llm-pi-ai 真实通道（默认 true）
  global:
    x-edge: proxy-1
  providers:
    acme-gateway:
      x-company: acme
  models:                   # key 必须是 "provider/model"
    acme-gateway/gpt-5:
      x-model-trace: t1
  hosts:                    # 目标主机后缀；空 = 除 .local 外全部（回环放行）
    - api.deepseek.com
  fill: false               # false=覆盖同名头（默认）；true=保留适配器头

说明：llm-pi-ai.providers..headers 也可直接手写（真实通道，见「原理」），界面配置与手写互为等价通道（界面同步只增删自己写过的头）。

字段	类型	说明
`global`	`Record`	所有请求注入（同步时写进所有 llm-pi-ai provider）
`providers`	`Record>`	按 provider 路由注入（同步时写进对应路由）
`models`	`Record>`	按模型注入（最细粒度，仅 fetch 层通道）
`hosts`	`string[]`	目标主机后缀；空 = 除 `.local` 外全部（回环放行）
`fill`	`boolean`	默认 `false`（覆盖同名头）；`true` 保留适配器头
`syncToProviders`	`boolean`	三层表变更是否同步进 `llm-pi-ai.providers.*.headers` 真实通道；默认 `true`

dsh-llm-headers

安装

说明文档

配置

界面

YAML 直写（高级）