dsh-zen-spoof
DeepSeek Harness 插件：为 OpenCode Zen 免费模型补上官方客户端头，缓解伪 429 限流
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:mikey-666/dsh-zen-spoof#b8ea706517da969b9bb5fae568b6f057ea5eedc9Zen Spoof 以 dsh-zen-spoof 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 里直连 OpenCode Zen 免费模型的适配器插件。
Zen 的免费档只对 OpenCode 官方客户端开放。服务端通过以下 HTTP headers 判断请求来源：
| Header | 值 |
|---|---|
User-Agent | opencode/<版本号> |
x-opencode-client | cli |
x-opencode-session | ses_<随机ID> |
x-opencode-request | msg_<随机ID> |
x-opencode-project | global |
缺少或格式不对会被拒绝（400: MissingSessionID）。
dsh 内置的 dsh-llm-pi-ai 适配器理论上支持注入这些 headers，但有一个缺陷：
pi-ai 的
requestHeaders()用attributionHeaders()（固定返回user-agent: deepseek-harness/...） 覆盖用户自定义的User-Agent，导致 opencode 检测永远失败，headers 永远不被注入。 虽然 dsh 安装器会在本地打zen-useragent:patched-v2补丁修复此问题，但：
- 该补丁不在 npm 包内，随安装器版本而异
- dsh 升级后可能丢失
本插件的方案：直接注册为 opencode provider，完全绕过 pi-ai，自行控制所有请求 headers。
不依赖任何补丁，任何 dsh 版本均可使用。
# npm
dsh plugin --profile web add dsh-zen-spoof
# GitHub
dsh plugin --profile web add github:mikey-666/dsh-zen-spoof
插件注册为 opencode provider，与 pi-ai 的同名路由冲突。
安装后必须编辑 settings.yaml，注释掉 opencode provider：
llm-pi-ai:
providers:
# opencode: 已由 dsh-zen-spoof 插件接管
opencode-go:
# ... 你的其他 provider 配置保持不变 ...
settings.yaml 位置：
| 系统 | 典型路径 |
|---|---|
| Windows | <dsh安装目录>\.dsh\settings.yaml |
| macOS / Linux | ~/.dsh/settings.yaml |
可在 dsh web UI「设置」页查看，或执行 dsh config 查找。
跳过此步会报 DUPLICATE_ADAPTER 错误。
dsh web
在会话里选 provider: opencode，模型挑任意免费 ID：
| 模型 ID | 说明 |
|---|---|
mimo-v2.5-free | MiMo V2.5（默认） |
deepseek-v4-flash-free | DeepSeek V4 Flash |
ling-3.0-flash-free | Ling 3.0 Flash |
nemotron-3-ultra-free | Nemotron 3 Ultra |
模型自动发现：插件启动时自动调用 Zen API 获取最新免费模型列表，上表仅供参考。
API Key 自动复用 dsh 凭据库中 OPENCODE_API_KEY 的值，无需额外配置。
| 字段 | 默认值 | 说明 |
|---|---|---|
apiKey | 空 | 留空则自动读取 dsh 凭据库 |
apiKeyRef | OPENCODE_API_KEY | 凭据引用名 |
baseURL | https://opencode.ai/zen/v1 | 网关地址 |
providers | ["opencode"] | 注册的路由名 |
spoofClient | cli | x-opencode-client 值 |
project | dsh | x-opencode-project 值 |
userAgent | opencode/1.18.30 | User-Agent，须含版本号 |
enableAutoFallback | true | 受限时自动换模型 |
maxFallbackAttempts | 5 | 单次最多换几个 |
initialBackoffMs | 1000 | 退避起点 |
maxBackoffMs | 30000 | 退避上限 |
timeoutMs | 120000 | 空闲超时（ms），0 不限 |
通过 cordis 配置覆盖时须重述全部键。
reasoning_effort 给 Zen API，解析 reasoning_content 字段并在 dsh UI 中显示思考过程Retry-After 支持dsh plugin --profile web remove dsh-zen-spoof
卸载后在 settings.yaml 中恢复 opencode provider 配置（如需恢复 pi-ai 路由）。
ctx.llm.registerAdapter(["opencode"], adapter) 注册路由settings.yaml 中 opencode 已被注释，pi-ai 不会注册同名路由，无冲突User-Agent: opencode/1.18.30（触发服务端免费档白名单）x-opencode-session: ses_<稳定ID>（per-conversation，用于服务端分桶）x-opencode-request: msg_<随机ID>（per-request，用于追踪）x-opencode-client: cli + x-opencode-project: dshfetch() 发送到 Zen 网关，完全绕过 pi-ai 的 header 处理链reasoning_content 转为 reasoning-delta chunk，content 转为 text-delta chunk，与 dsh 的 BlockAssembler 协议完全对齐伪装客户端头属于灰色手段，官方随时可能收紧策略。 有社区报告称官方会标记非官方客户端的流量，介意请使用小号 Key 或切换付费模型。