dsh-oauth-login

中文 | English

把 ChatGPT、Claude、Grok、Copilot、OpenRouter、Kimi 的订阅登录接到 DeepSeek Harness。适配器和 Pi Agent 的 /login 是同一套，授权文件只写 DSH 自己的 $DSH_HOME/.dsh-oauth-auth.json。

已经付了厂商订阅、不想在 Harness 里再贴一把 API key，就用这个。官方 codex login、Claude Code、grok CLI、Pi Agent 的 ~/.pi/agent/auth.json，这里不读也不写。

长什么样

下面几张都是本仓库装进 dsh web 之后，打开 设置 → OAuth 登录 拍的。不是设计稿。

设置页里的语言跟着 Harness，这台机器当时是中文。

点 GitHub Copilot 的「登录」。插件向 GitHub 要 device code，卡片变成「正在等待授权」，并给出 github.com/login/device。官方 CLI 的登录文件不会被创建。

Grok 那张绿点是写进 $DSH_HOME/.dsh-oauth-auth.json 的占位授权，用来拍「已登录 / 退出」。不是真的 xAI 会话，文件内容没有出现在任何截图里。

命令行读的也是 DSH 这份 store，不是官方 CLI 的登录文件。status 不打印 token。Codex 未登录时退出码是 1。ls 用来确认 ~/.pi、~/.codex、~/.claude 没被碰过。

安装

需要 Node 22.19+，以及能跑起来的 DeepSeek Harness。

npx @deepseek-ai/dsh web

另开一个终端，在 Harness 旁边装这个插件。file: 前缀必须留着。

git clone https://github.com/aa2246740/dsh-oauth-login.git
dsh plugin --profile web add file:./dsh-oauth-login

写成 ./dsh-oauth-login 会被装成符号链接。本插件把 DSH 运行时当成 peer dependency，必须用 file: 拷进 profile，Node 才能从那边解析依赖。

重启 dsh web。打开 设置 → OAuth 登录。对话里选 pi-… 路由。

dsh plugin --profile web exec dsh-oauth-login login openai-codex
dsh plugin --profile web exec dsh-oauth-login login xai
dsh plugin --profile web exec dsh-oauth-login status

旧版 DSH 的 .pi-login-auth.json 只在下次写入时迁到新文件名，不会当成 Pi Agent 的登录文件。

支持哪些登录

设置页	Harness 路由	Pi provider
ChatGPT Codex	pi-openai-codex	openai-codex
Claude Pro/Max	pi-anthropic	anthropic
xAI Grok	pi-xai	xai
GitHub Copilot	pi-github-copilot	github-copilot
OpenRouter	pi-openrouter	openrouter
Kimi For Coding	pi-kimi-coding	kimi-coding

Radius 没做。它要自己配网关。

登录文件在哪

凭据只写 $DSH_HOME/.dsh-oauth-auth.json，权限是当前用户可读写。不要把这份文件、回调 URL、授权码或 token 贴到公开 Issue。私下报告见 SECURITY.md。

厂商自己的搜索和出图

官方 DSH 会注册 web_search，再经 ctx.web 打出去，默认又用 DEEPSEEK_API_KEY 走一轮 DeepSeek Messages。OAuth 账号自己的 hosted tool 就被盖住了。

在这些路由上，插件会从模型可见 schema 里拿掉 DSH 的 web_search / web_fetch，改挂厂商自己的工具。

路由	Hosted tools
pi-xai	web_search、x_search、image_generation
pi-openai-codex	web_search、image_generation
pi-anthropic	web_search_20250305

Copilot、OpenRouter、Kimi 不动，没有一份能稳定挂上的 hosted tool。DeepSeek 官方对话也不改。

这些工具走的是该厂商的订阅 / tool 额度，不再要 Exa、Perplexity 或 DeepSeek Search。服务端搜索痕迹不会再当成 DSH 工具去跑。Grok 搜索 hop 里的空 Think，以及正文开始之后才冒出来的旁白 Think，会从流里丢掉。托管出图写入附件库，显示在助手那一轮。

Hosted tools 是这一次请求的能力。只有调用方带了 tools 列表，插件才会去做去重和注入。自动审批、标题生成这类不带 tools 的纯文本调用保持纯文本。

要继续用 DSH 自己的搜索：

- id: llm-oauth-login
  name: dsh-oauth-login
  config:
    nativeTools: false

nativeImage: false 只留搜索，去掉出图。

模型失败时

插件不另写一套重试。Chat 用官方 dsh-llm-retry 和官方 LlmError 码。插件只在原文后面补一句说明，不改 code。

码	通常是什么	怎么做
RATE_LIMIT	请求限流或高峰。很多 HTTP 429 落在这里。	等完默认五次自动重试，再发一条。
QUOTA	套餐、用量窗、余额。	再试也补不回来，去查厂商套餐。
TIMEOUT / TRANSPORT	空闲断流或网络。	本轮结束后再发一条。
SERVER	对端 5xx / 部分 overloaded。	和其他暂时故障一样。
AUTH / MISSING_CREDENTIAL	没登录或授权被拒。	设置 → OAuth 登录。Chat 有时把 AUTH 显示成 “API key is invalid”。

429 不等于繁忙，也不等于没钱。官方按厂商原文分类：像额度用尽就标 QUOTA，其余 429 标 RATE_LIMIT。5 小时 / 周限额只有原文说得像 usage-limit / quota 时才会进 QUOTA。

RC8 默认对暂时故障自动重试五次，然后本轮结束。Continue 失败或输入框卡住，开新对话。

要加大次数而不改插件代码，给 llm-oauth-login 行加配置：

- id: llm-oauth-login
  name: dsh-oauth-login
  config:
    retryPolicy:
      mode: normal
      maxRetries: 7
      backoff:
        initialDelayMs: 1000
        maxDelayMs: 30000
        jitterRatio: 0.1

mode: always 会把每一种失败都重试到成功或取消，可能烧额度。Creator Mode / 宿主模型的超时走你在对话里选的那条路由，不是这个插件。

代理

OAuth 和订阅模型请求按这个顺序选路：进程继承的 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY，插件自己的 DSH_OAUTH_PROXY，已开启且能连上的 macOS 系统代理，本机常见端口上通过 HTTP CONNECT 验证的代理，最后才直连。

本机候选端口只有通过不含凭据的 CONNECT 探测后才会用。插件不写国家、地区、语言。要指定代理，用 DSH_OAUTH_PROXY=http://127.0.0.1:45678 启动 DSH。代理改完之后重启 dsh web。

许可

Apache-2.0。这是社区插件，和 DeepSeek、Pi Agent 以及上面这些 OAuth 厂商都没有隶属关系。