jiujiezongheti/zen-useragent

README 摘要

dsh-plugin-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 . 修复 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. 确保 settings.yaml （ $DSH HOME/settings.yaml ）里 opencodezen provider 配置了 请求头（DSH Web 的 Models 页面可直接编辑不保存的部分）： 2. 重启 DSH Web： dsh web （安装插件后必须重启才会加载新的 bundle 层）。 3. 启动时终端会打印一行确认： 若输出 READONLY: ... 或 WRITE FAILED: ... ，说明安装目录不可写，修复未 生效（补丁失败不会中断启动，会回退为原生行为）——修复权限或改用本地安装。 验证 重启后切到 opencode 免费模型…

分类