jiujiezongheti/zen-useragent
> A DeepSeek Harness (DSH) plugin that lets provider-configured request headers > (e.g. User-Agent) reach the pi-ai API requests, fixing the OpenCode ZEN > free model 429 FreeUsageLimitError by identifying requests as the opencode > client instead of deepseek-harness.
catalog 简介 / catalog descriptioncatalog description：—
安装Install
dsh plugin --profile web add dsh-plugin-zen-useragent把 jiujiezongheti/zen-useragent 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-plugin-zen-useragent
A DeepSeek Harness (DSH) plugin that lets provider-configured request headers (e.g.
User-Agent) reach thepi-aiAPI requests, fixing the OpenCode ZEN free model429 FreeUsageLimitErrorby identifying requests as the opencode client instead ofdeepseek-harness.
修复 DSH 中 OpenCode ZEN 免费模型 429 FreeUsageLimitError: Rate limit exceeded 问题的插件。
原理
原生 @deepseek-ai/dsh-llm-pi-ai 的 requestHeaders() 会把与 attribution headers
冲突的自定义请求头（如 User-Agent）过滤掉，实际发给 API 的 always 是
user-agent: deepseek-harness/0.1.0-rc.6 (+https://github.com/deepseek-ai/deepseek-harness)。
OpenCode ZEN（https://opencode.ai/zen/v1）按客户端标识限流：请求头不是
opencode/... 就被当作未知客户端 → 返回 429。同一把 API Key 在 OpenCode TUI 里
正常，在 DSH 里 429，就是这个原因。
本插件通过 cordis.patch.yml 禁用原生 llm-pi-ai 入口，并插入一个指向插件
包装模块的新入口。包装模块在加载原模块之前给 requestHeaders 打补丁，让配置的
headers 覆盖 attribution，然后原样转发原模块导出。补丁幂等、每次启动自动执行，
DSH 升级后自动重新打补丁，修复不会失效。
安装
# 1. 安装 pnpm（如已有可跳过）
npm install -g pnpm
# 2. 安装插件到 web profile（推荐：从 GitHub 源）
dsh plugin --profile web add github:jiujiezongheti/zen-useragent
# 或从 npm 安装
dsh plugin --profile web add dsh-plugin-zen-useragent
启用
确保
settings.yaml（$DSH_HOME/settings.yaml）里 opencodezen provider 配置了 请求头（DSH Web 的 Models 页面可直接编辑不保存的部分）：llm-pi-ai: providers: opencodezen: displayName: opencode apiKeyEnv: OPENCODEZEN_API_KEY api: openai-completions baseURL: https://opencode.ai/zen/v1 headers: { User-Agent: opencode/1.18.18, Referer: https://opencode.ai } models: [...]重启 DSH Web：
dsh web（安装插件后必须重启才会加载新的 bundle 层）。启动时终端会打印一行确认：
[dsh-plugin-zen-useragent] patched: C:\...\dsh-llm-pi-ai\lib\index.js若输出
READONLY: ...或WRITE FAILED: ...，说明安装目录不可写，修复未 生效（补丁失败不会中断启动，会回退为原生行为）——修复权限或改用本地安装。
验证
重启后切到 opencode 免费模型发一条消息，如不再 429 即成功。
终端日志出现 already patched 表示此前已被补丁，无需重复操作。
卸载
dsh plugin --profile web remove dsh-plugin-zen-useragent
卸载后需要重启 DSH，且被补丁的文件会保留（无害：只是允许自定义请求头覆盖
attribution）。如需彻底还原，可删除 requestHeaders 里的补丁标记行并重启，
或重装最新版 DSH。
备注
- 补丁只影响「provider 显式配置了同名请求头」的情况；未配置 headers 的 provider 行为与原生完全一致。
- 若 DSH 升级后函数结构变化导致"无法识别"，插件会打印
SKIPPED: unrecognized requestHeaders shape并保持不破坏新代码 —— 此时升级本插件即可。 - 补丁可靠性措施：
requestHeaders的定位按花括号配平执行（跳过字符串、模板字符串与注释里 的括号），函数体内出现行首闭合的嵌套对象也不会被截断写坏；- 替换结果写盘前做三重校验（旧特征行已消失、标记已存在、函数唯一），任一不满足
即拒绝写盘（打印
SKIPPED:）; - 落盘采用原子写（同目录临时文件 + rename，Windows 上 rename 被占用时回退 直接写），并发启动的进程不会读到写了一半的文件；
- 目标只读或写入失败时打印
READONLY:/WRITE FAILED:并跳过，不会中断 DSH 启动，请求回退为原生行为。
- 补丁算法在
lib/patch-core.js（纯函数），单测见test/patch-core.test.mjs， 运行node test/patch-core.test.mjs。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…