dsh-coding-subscription-oauth

dsh plugin --profile web add dsh-coding-subscription-oauth

<!-- banner -->

<div align="center">

🔐 dsh-coding-subscription-oauth

v0.8.7 · 原名 dsh-grok-build

面向 DeepSeek Harness 的编码订阅 OAuth 插件。 把 SuperGrok / X Premium（Grok Build）、ChatGPT Plus/Pro（Codex）、Kimi Code、Claude Pro/Max 和 Google Antigravity 接到 DSH——不必再开一份按量 API-key，也不要把 token 粘贴进聊天。



[English](README.md) · [中文版](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Português (BR)](README.pt-BR.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md)

</div>

---

升级： 按 [INSTALL.md](INSTALL.md) 的版本化步骤操作。0.8.0 新增可选 OpenCode Go 兼容（本地网关粘性 x-opencode-session）；继续将共享 dispatcher runtime 固定为 dsh-coding-oauth-core@0.1.2 与 undici@7.29.0，并将 Gateway key 的 reveal/rotate 限制为 loopback 访问；无需迁移配置、凭据、数据或路由。Grok Imagine 保留显式 pinned dispatcher。0.6.2 及之后版本已包含严格 Cordis 注入启动修复并正式支持 DSH 0.1.1-rc.2；保留 profile、配置和凭据文件，更新后再重启一次现有 DSH Web 进程。

---

项目更名

最初只做 Grok Build，仓库名是 dsh-grok-build。现在覆盖 SuperGrok / Grok Build、ChatGPT Plus Codex、Kimi Code、Claude Code 和 Google Antigravity，因此改为现名。

· 请用这个 · 仍然可用

npm（推荐） · 当前版本 0.8.7：dsh plugin --profile web add dsh-coding-subscription-oauth@0.8.7 · 没有发布过旧 npm 包

GitHub / 开发安装 · dsh-coding-subscription-oauth · 旧仓库 dsh-grok-build 已删除

CLI · dsh-coding-oauth · dsh-grok-build

Cordis 插件 id · llm-grok-build-oauth · 不变

设置页 HTTP API · /plugins/dsh-grok-build/* · 不变

凭据文件 · $DSH_HOME/.grok-build-auth.json 及其他 *-oauth-auth.json · 不变

✨ 特性

• 🧳 自带订阅 —— SuperGrok、ChatGPT Plus/Pro、Kimi Code、Claude Pro/Max，不必另开按量 API-key。
• 🔑 本地 OAuth，不用贴 key —— 在设置页或 CLI 完成授权；access/refresh token 不进聊天、日志和 HTTP 状态。
• 🧩 一个插件，五大供应商 —— Grok Build（cli-chat-proxy.grok.com）、Codex、Kimi Code、Claude Code 与 Google Antigravity。
• 🛡️ 安全设计 —— 凭据文件均为 owner-only 0600、原子写、跨进程文件锁。
• ⚙️ 动态目录 —— 选择器只列出已登录路由并标注 (OAuth)，含 grok-4.6 的 xhigh。
• 🌐 代理感知 —— 只代理审核过的订阅域名；Kimi 中国流量默认直连。
• 📥 手动 CLI 拉取 —— 设置页只读发现白名单内的官方 Grok/Codex/Kimi/Claude CLI OAuth 文件；预览并确认覆盖后，单向拉取一份副本。
• 🗂️ 分栏设置页 —— Accounts、Gateway、Capabilities、About；远程主机优先设备码登录并弱化 CLI 缺失提示；已登录供应商卡片默认收起，展开后再编辑。
• 🎛️ 可选能力默认关闭 —— Codex 搜索、用量/配额、图像生成/编辑、Fast、Grok Imagine 打开后立即生效。另有默认关闭的开关，允许非 Codex 模型路由调用 Codex 图像工具，同时保留 Codex 登录、会话和附件归属检查。
• 🔌 可选本地 API 网关 —— 默认关闭的 loopback OpenAI/Anthropic 兼容服务，支持复制 base URL 和 Bearer key，只给你自己的工具用，不是公网中继。
• OpenCode Go — 在账户与模型连接独立供应商 coding-opencode-go（与 DSH 原生 opencode-go 隔离），即可在 DSH 对话而无需开启网关。外部工具使用 coding-opencode-go/<model-id>（过渡期仍接受旧前缀 opencode-go/<model-id>）与对应协议，并发送稳定会话标识。若仍有旧版插件配置写在 opencode-go，请在账户卡片中迁移。

本插件解决的接入问题

下面这些搜索词和 DSH 报错，通常就是会搜到这个仓库的原因。

你搜到 / 看到的 · 实际坏在哪 · 本插件怎么处理

SuperGrok / X Premium 接入 DSH、「Grok Build 和 api.x.ai 不是一路」 · 内置 xai 路由是按量 API。编码订阅走 cli-chat-proxy.grok.com · 独立 grok-build 路由 + 官方 CLI 指纹头（X-XAI-Token-Auth、x-grok-client-identifier、x-grok-client-version），避免静默 403

本轮运行失败 API key is invalid / AUTH · GUI 把所有 AUTH 都显示成这句。常见原因是 OAuth access token 到期（Kimi 约 15 分钟） · 过期前 5 分钟主动刷新；遇到 401 先作废本地 token，刷新后再重试该 step

第二轮 Codex / Kimi 报 INVALID_REPLAY_STATE · replay state 仍带着 pi-ai 原生 provider id · 保持 Harness route id，并修复历史被污染的 replay

grok-4.6 没有 xhigh / Extra High Effort · 线上 GET /v1/models-v2 已返回含 xhigh 的 reasoning_efforts；套用 grok-4.5 模板会被 pi-ai 藏掉 · 解析 live reasoning_efforts。4.6 有 xhigh，4.5 仍是 low/medium/high

Kimi Code 401，或请求变成 Anthropic x-api-key · OAuth token 被当成 Anthropic key 发出 · api.kimi.com/coding 只走 Authorization: Bearer

没登录的 Grok / Codex / Claude 仍出现在模型选择器 · 所有已注册路由都被列出来 · 未认证路由模型列表为空；已登录名称带 (OAuth)

远程 / 无头 DSH 没法浏览器登录 · PKCE 回不到本机 localhost · Grok/Codex/Kimi 走设备码；Claude 可粘贴完整 localhost 回调 URL

开了代理 Grok 通了、国内 Kimi 挂了 · 全局 HTTPS_PROXY 一刀切 · 白名单代理；Kimi 默认直连（proxyKimi: true 才走代理）。auth.kimi.com ≠ api.moonshot.cn

想在 DSH 用 ChatGPT Plus / Claude Pro，又不想再买 API · 另开 OpenAI / Anthropic API-key · codex-oauth / claude-code-oauth 本地 OAuth，与现有 openai / kimi-coding API-key 路由共存

OpenCode Go: MissingSessionID · Missing stable conversation ID · DSH: use Accounts & Models; external tools: provide x-opencode-session. See [migration](docs/repair-candidate.md).

支持的供应商

供应商 · 路由 · 认证 · 与现有 API-key 路由共存

xAI Grok Build · grok-build · SuperGrok / X Premium OAuth · xai

OpenAI Codex · codex-oauth · 可选 codex-oauth-fast · ChatGPT Plus/Pro OAuth · openai

Kimi Code · kimi-code-oauth · Kimi Code OAuth · kimi-coding

Claude Code · claude-code-oauth · Claude Pro/Max OAuth · —

Google Antigravity · agy · dsh-agy Google OAuth · —

Grok Build 的 device 登录、动态 /v1/models-v2 目录与 Responses 流式推理已在实机上验证。Codex/Kimi/Claude 复用 @earendil-works/pi-ai 的 provider-native OAuth/刷新协议，不重新实现各供应商流程。

🚀 快速开始

# 1. 安装当前 npm 发布版到 web profile
dsh plugin --profile web add dsh-coding-subscription-oauth@0.8.7

# 2. 可选 —— Google Antigravity（固定审核过的版本）
dsh plugin --profile web add dsh-agy@0.1.2

# 3. 使用本机实际配置的进程管理器重启现有 DSH Web 进程
# 官方 `dsh web` 是启动 web profile 的 CLI 别名，不是服务单元名。

然后打开 设置 → 编码 OAuth 登录任一供应商即可。选择器会自动列出已认证的模型。

📚 目录

• [项目更名](#项目更名)
• [特性](#-特性)
• [本插件解决的接入问题](#本插件解决的接入问题)
• [支持的供应商](#支持的供应商)
• [快速开始](#-快速开始)
• [安装](#安装)
• [设置页](#设置页)
• [可选能力](#可选能力)
• [本地 API 网关](#本地-api-网关)
• [CLI](#cli)
• [Kimi 中国说明](#kimi-中国说明)
• [网络代理](#网络代理)
• [弹性重试](#弹性重试)
• [凭据](#凭据)
• [架构](#架构)
• [技术方案](#技术方案)
• [合规](#合规)
• [文档](#文档)
• [相关项目](#相关项目)
• [贡献](#贡献)
• [许可证](#许可证)

安装

安装门禁通过 engines.dsh >=0.1.1-rc.2 <0.3.0 接受 DeepSeek Harness（覆盖 0.2.1-rc.2）。构建/冒烟仍锁定已验证 BOM 0.1.1-rc.2。0.1.5-rc.1、0.2.1-rc.2 等未验证候选仅记在 `compatibil

…(truncated)