概览
dsh-plugin-zen-useragent
源码级技术说明让 provider 配置的 headers（如 User-Agent）真正到达 pi-ai 的 API 请求，自动补全 opencode 身份头、接入用户 opencode 客户端数据库里的真实会话 ID（x-opencode-session 账号已知会话，v6 起运行时自动跟随最新会话、无需重启），并在 v7 起用客户端保存的 OAuth 令牌（st_…）覆盖 provider 那把会过期的 sk- key（令牌不可用时显式省略 Authorization，走免费档匿名路径），同时向 OpenCode Zen 网关发送的请求 body.tools 里补上网关必需的 bash 工具 —— 把请求识别为 opencode 客户端而不是 deepseek-harness，修复 OpenCode ZEN 免费模型 429（FreeUsageLimitError）、400（MissingSessionID/MissingHeader）、401（api_key_expired）、403（Generation.FreeTierError / FreeTierError）收起技术说明
让 provider 配置的 headers（如 User-Agent）真正到达 pi-ai 的 API 请求，自动补全 opencode 身份头、接入用户 opencode 客户端数据库里的真实会话 ID（x-opencode-session 账号已知会话，v6 起运行时自动跟随最新会话、无需重启），并在 v7 起用客户端保存的 OAuth 令牌（st_…）覆盖 provider 那把会过期的 sk- key（令牌不可用时显式省略 Authorization，走免费档匿名路径），同时向 OpenCode Zen 网关发送的请求 body.tools 里补上网关必需的 bash 工具 —— 把请求识别为 opencode 客户端而不是 deepseek-harness，修复 OpenCode ZEN 免费模型 429（FreeUsageLimitError）、400（MissingSessionID/MissingHeader）、401（api_key_expired）、403（Generation.FreeTierError / FreeTierError）
README / ZH
插件文档
目录摘要
让 provider 配置的 headers（如 User-Agent）真正到达 pi-ai 的 API 请求，自动补全 opencode 身份头、接入用户 opencode 客户端数据库里的真实会话 ID（x-opencode-session 账号已知会话，v6 起运行时自动跟随最新会话、无需重启），并在 v7 起用客户端保存的 OAuth 令牌（st_…）覆盖 provider 那把会过期的 sk- key（令牌不可用时显式省略 Authorization，走免费档匿名路径），同时向 OpenCode Zen 网关发送的请求 body.tools 里补上网关必需的 bash 工具 —— 把请求识别为 opencode 客户端而不是 deepseek-harness，修复 OpenCode ZEN 免费模型 429（FreeUsageLimitError）、400（MissingSessionID/MissingHeader）、401（api_key_expired）、403（Generation.FreeTierError / FreeTierError）
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 README