DSH Plugins
返回列表
🧰

dsh-llm-pi-ai-headers

联网工具 更新于 2026.08.25

在终端中运行以下命令:

dsh plugin install xsluck/dsh-llm-pi-ai-headers

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 插件市场搜索 dsh-llm-pi-ai-headers,点击安装即可使用,源码仓库地址为 https://github.com/xsluck/dsh-llm-pi-ai-headers

插件介绍

使用 dsh 接入某些 LLM 提供商时,官方 llm-pi-ai 适配器会把 user-agent 当作 attribution 保留头直接过滤,导致 OpenCode Zen 免费层等场景下请求被 429/403 拒绝;而单一 API Key 的限流也让高吞吐用户捉襟见肘。dsh-llm-pi-ai-headers 针对这两个痛点,在完全保留官方适配器(SSE 解析、reasoning 回传、工具调用、上下文窗口判定)的前提下,提供按提供商注入自定义请求头和 Round-Robin 多 Key 轮换两项能力,并附带可编辑的重试策略面板。\n\n核心设计哲学是只补不替:官方适配器本体不被替换或禁用,插件仅通过 transformHeaders 钩子在最终请求头合并完成后把被过滤的 user-agent 补回,并按配置顺序循环注入多个 API Key 到指定请求头(默认 Authorization)。所有设置写入官方 llm-pi-ai.providers 命名空间,settings.yaml 手写与 UI 编辑完全等价,dsh 升级后无需重装。Key 轮询还附带健康度面板,显示每个 Key 的调用数、失败数和最后错误码,疑似失效的 Key 以红框高亮,修复或删除后统计自动清零。\n\n适合正在使用 dsh 并遇到 User-Agent 被过滤导致提供商拒绝请求、单 Key 限流需要轮换、或需要为特定提供商附加自定义请求头的用户。如果你目前依赖旧版手工 patch 方案,标准安装可以无缝迁移,并彻底摆脱 dsh 升级后重跑补丁的麻烦。

使用场景

  • 提供商拒绝非默认 User-Agent 导致 429/403,需要注入自定义请求头绕过限制
  • 单一 API Key 触发限流,需要多 Key 按 Round-Robin 自动轮换突破配额
  • 为特定提供商附加自定义认证头、追踪头或重试策略,同时保留官方适配器全部能力

适合人员

  • 使用 dsh 接入 LLM 提供商并遇到请求头被过滤或限流的用户
  • 持有多个同提供商 API Key、需要自动轮换以分散配额的开发者
  • 希望不替换官方适配器、仅做轻量增强且 dsh 升级后免重装的进阶用户