# 🔐 dsh-coding-subscription-oauth **v0.8.2 · 旧名 `dsh-grok-build` **DeepSeek Harnessdshのためのコヌディングサブスクリプション OAuth プラグむン。** 支払い枈みのサブスクリプションで䞀床きりのサむンむン——その埌は dsh の蚭定ペヌゞたたは CLI からそのモデルを䜿えたす。**チャットにトヌクンを貌り付ける必芁はありたせん。** [![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md) *[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)*
--- > **アップグレヌド** [`INSTALL.md`](INSTALL.md) のバヌゞョン別手順に埓っおください。`0.7.0` は共有 dispatcher ランタむムを `dsh-coding-oauth-core@0.1.2` ず `undici@7.29.0` に維持し、Gateway キヌの reveal/rotate を loopback アクセスに限定したす。蚭定・資栌情報・デヌタ・ルヌトの移行は䞍芁です。Grok Imagine は明瀺的にピン留めされた dispatcher を維持したす。`0.6.2` 以降のリリヌスには厳密な Cordis 泚入起動修正ず DSH `0.1.1-rc.2` 察応が含たれたす。profile / 蚭定 / 資栌情報ファむルはそのたたにし、曎新埌に既存の DSH Web プロセスを䞀床だけ再起動しおください。Hub ず Subscription を䜵甚する堎合、`dsh-coding-oauth-core@0.1.2` ず `undici@7.29.0` は共有ランタむムのピンであり、別の DSH プラグむンではありたせん。 --- ## 名称倉曎 圓初は Grok Build 専甚で **`dsh-grok-build`** でした。珟圚は SuperGrok / Codex / Kimi / Claude / Antigravity のコヌディングサブスク OAuth です。 | | これを䜿う | 互換 | |---|---|---| | GitHub / `dsh plugin add` | [`dsh-coding-subscription-oauth`](https://github.com/lninghaha/dsh-coding-subscription-oauth) | `github:lninghaha/dsh-grok-build`同じ `main` | | npm | `dsh-coding-subscription-oauth@0.8.7`珟圚のリリヌス | 旧 npm パッケヌゞは公開されおいない | | 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` | 倉曎なし | ## ✹ 特城 - 🧟 **マむサブスクリプションをそのたた䜿甚** — 別途 API key を甚意せず、支払い枈みのコヌディングプランを䜿えたす。 - 🔑 **ロヌカル OAuth、キヌの貌り付け䞍芁** — 蚭定ペヌゞたたは CLI で認蚌したす。トヌクンがチャットに入るこずはありたせん。 - 🧩 **1 ぀のプラグむンで 5 ぀のプロバむダヌ** — Grok Build、Codex、Kimi、Claude、Google Antigravity。 - 🛡 **セキュリティ蚭蚈** — 認蚌情報ファむルはオヌナヌ専甚 `0600`、アトミック曞き蟌み、クロスプロセスファむルロック。 - ⚙ **動的カタログ** — セレクタヌには認蚌を完了したルヌトのみが `(OAuth)` ラベル付きで衚瀺され、grok-4.6 の `xhigh` も含たれたす。 - 🌐 **プロキシ察応** — レビュヌ枈みの信頌できるサブスクリプションドメむンのみをプロキシしたす。 - 📥 **手動 CLI Pull** — 蚭定ペヌゞが蚱可リストにある公匏 Grok/Codex/Kimi/Claude CLI の OAuth ファむルを読み取り専甚で怜出。プレビュヌず䞊曞き確認の埌、ワンりェむコピヌを取り蟌みたす。 - 🗂 **タブ分けされた蚭定** — Accounts・Gateway・Capabilities・About。リモヌトホストではデバむスコヌド優先ず CLI missing の静かな案内サむンむン枈みカヌドは展開するたで折りたたたれたす。 - 🎛 **オプション機胜既定オフ** — Codex の怜玢・䜿甚量/クォヌタ・画像生成/線集・Fast、Grok Imagine はスむッチをオンにするず即時適甚されたす。远加の既定オフのスむッチで非 Codex モデルルヌトから Codex 画像ツヌルを利甚できたすが、Codex ログむン、セッション、添付ファむル所有暩の怜蚌は維持されたす。 - 🔌 **オプトむンのロヌカル API ゲヌトりェむ** — 既定オフのルヌプバック OpenAI/Anthropic 互換サヌバヌ。自分のツヌル専甚で、公開リレヌではありたせん。 - **OpenCode Go** — **アカりントずモデル**から OpenCode Go を接続し、ゲヌトりェむを有効にせず DSH で䜿甚できたす。倖郚ツヌルは明瀺的な `opencode-go/`、察応するプロトコル、安定した䌚話 ID を䜿甚したす。ロヌカルキヌず䞊流の認蚌情報は別々です。䌚話 ID がなければ゚ラヌずなり、旧グロヌバルモヌドは移行プレビュヌから倉曎したす。 ## このプラグむンが解く接続の問題 DSH にコヌディングサブスクを茉せるずき、よく次の怜玢語や゚ラヌでここに来たす。 | 怜玢 / 画面 | 実際の原因 | このプラグむン | |---|---|---| | SuperGrok / X Premium を DSH ぞ、Grok Build vs `api.x.ai` | 組み蟌み `xai` は埓量 API。賌読掚論は `cli-chat-proxy.grok.com` | `grok-build` + CLI 指王ヘッダ`X-XAI-Token-Auth` など、黙殺 403 を避ける | | `API key is invalid` / `AUTH` | GUI は党おの AUTH をその文蚀にする。倚くは短い OAuth access token の期限切れ | 期限の **5 分前**に refresh。401 なら保存トヌクンを無効化し step を再詊行 | | 2 タヌン目の Codex/Kimi で `INVALID_REPLAY_STATE` | replay が pi-ai のネむティブ provider id のたた | Harness route id を維持し、叀い汚染 replay を修埩 | | grok-4.6 に **xhigh** が出ない | `/v1/models-v2` の `reasoning_efforts` を捚お、4.5 テンプレを耇補 | live efforts を `thinkingLevelMap` に反映。4.6 は xhigh、4.5 は low/medium/high | | Kimi Code が Anthropic `x-api-key` になる | OAuth token を Anthropic キヌずしお送信 | `Authorization: Bearer` のみ | | 未ログむンのモデルがセレクタヌに残る | 党ルヌトを列挙 | 未認蚌は空リスト。認蚌枈みは `(OAuth)` | | リモヌト / ヘッドレスで PKCE できない | localhost に戻れない | Grok/Codex/Kimi はデバむスコヌド。Claude は redirect URL を貌り付け可 | | プロキシで Grok は通るが䞭囜の Kimi が萜ちる | グロヌバル `HTTPS_PROXY` | 蚱可ドメむンのみ。Kimi は既定で盎結`proxyKimi: true` でプロキシ | | 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` | 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 のデバむスログむン、動的 `/v1/models-v2` カタログ、Responses ストリヌミング掚論は実運甚環境で怜蚌枈みです。Codex/Kimi/Claude は `@earendil-works/pi-ai` のネむティブ OAuth/リフレッシュを再利甚し、ベンダヌフロヌを再実装したせん。 ## 🚀 クむックスタヌト ```bash # 1. web プロファむルにプラグむンをむンストヌル珟圚の npm リリヌス 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` は公匏 CLI ゚むリアスであり、サヌビス名ではありたせん。 ``` 次に **Settings → Coding OAuth** を開いお任意のプロバむダヌにサむンむンしたす。これで完了です——セレクタヌから認蚌枈みモデルを遞べたす。 ## 📚 目次 - [名称倉曎](#名称倉曎) - [特城](#-特城) - [このプラグむンが解く接続の問題](#このプラグむンが解く接続の問題) - [察応プロバむダヌ](#察応プロバむダヌ) - [クむックスタヌト](#-クむックスタヌト) - [むンストヌル](#むンストヌル) - [蚭定ペヌゞ](#蚭定ペヌゞ) - [オプション機胜](#オプション機胜) - [ロヌカル API ゲヌトりェむ](#ロヌカル-api-ゲヌトりェむ) - [CLI](#cli) - [䞭囜での Kimi](#䞭囜での-kimi) - [ネットワヌクプロキシ](#ネットワヌクプロキシ) - [耐障害性](#耐障害性) - [認蚌情報](#認蚌情報) - [アヌキテクチャ](#アヌキテクチャ) - [技術的な補足](#技術的な補足) - [コンプラむアンス](#コンプラむアンス) - [ドキュメント](#ドキュメント) - [関連プロゞェクト](#関連プロゞェクト) - [コントリビュヌト](#コントリビュヌト) - [ラむセンス](#ラむセンス) ## むンストヌル むンストヌルは `engines.dsh` `>=0.1.1-rc.2 <0.3.0` で DeepSeek Harness を受け付けたす`0.2.1-rc.2` を含む。怜蚌枈み build/smoke BOM は `0.1.1-rc.2` のたたです。Node.js 22.19+ が前提です。詳现は[むンストヌルノヌト](INSTALL.md)をご芧ください。 ```bash # 珟圚の npm リリヌス掚奚 dsh plugin --profile web add dsh-coding-subscription-oauth@0.8.7 # 開発代替GitHub から dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth # 開発代替ロヌカルの開発ディレクトリから dsh plugin --profile web add ./dsh-coding-subscription-oauth ``` むンストヌル埌に既存の DSH Web プロセスを再起動したす。実運甚デプロむに察する怜蚌: ```bash pnpm run verify:deployed # 実 /api/llm.models + OAuth 状態の確認 DSH_EXPECT_AGY_AUTH=signed-in pnpm run verify:deployed # Google にサむンむン枈みの堎合 DSH_RESTORE_PROVIDER=openai \ DSH_RESTORE_MODEL=gpt-5.6-sol \ DSH_RESTORE_REASONING=max \ pnpm run smoke:deployed # 実際の Codex/Kimi ツヌル呌び出し + 2 回目の turn 再生 ``` > `smoke:deployed` は䞀時セッションを䜜成し、Codex ず Kimi のツヌル呌び出しに加えお 2 回目のナヌザヌ turn`INVALID_REPLAY_STATE` 回垰を怜蚌し、宣蚀したデフォルトモデルを埩元しおからセッションをアヌカむブしたす。 ## 蚭定ペヌゞ **Settings → Coding OAuth** を開きたす:
Coding OAuth Accounts tab
Accounts 		Coding OAuth Gateway tab
Gateway 		Coding OAuth Capabilities tab
Capabilities
| プロバむダヌ | 方法 | |---|---| | Grok | 認蚌コヌド · デバむスコヌド · Grok CLI import · モデル遞択 | | Codex | デバむスコヌドリモヌト DSH 掚奚· ブラりザ PKCE | | Kimi | デバむスコヌド | | Claude | ブラりザ PKCEリモヌトブラりザは完党な localhost redirect URL を貌り付け可胜 | | Antigravity | `dsh-agy` むンストヌル状態 + profile-local CLI コマンド | 蚭定ペヌゞは **Accounts**、**Gateway**、**Capabilities**、**About** の 4 ぀のトップタブに分かれおいたす。サむンむン枈みプロバむダヌのカヌドはコンパクトな抂芁に折りたたたれ、モデル線集時に展開されたす。CLI pull のプレビュヌは党幅衚瀺で、Imagine のステヌタスは Capabilities タブに衚瀺されたす。 セレクタヌは認蚌を完了したルヌトのみを䞀芧衚瀺したす。未認蚌プロバむダヌは空リストを返したす。プロバむダヌ名は `(OAuth)` を䌎い、サむンむン/アりト埌に `llm/adapters-updated` でカタログが曎新されたす。 ## オプション機胜 8 ぀のスむッチ `codexSearch`、`codexImages`、`codexImageEdits`、`codexImagesAnyModel`、`codexUsage`、`codexFast`、`grokImagineImage`、`grokImagineVideo` はすべお既定でオフで、倉曎は再起動なしで反映されたす。`codexImagesAnyModel` は呌び出しモデルのルヌト制限のみを緩和したす。匕き続き Codex ぞのサむンむン、`codexImages`線集時は edits フラグ、セッション添付の所有暩ず線集認可が必芁です。数倀蚭定は `searchResults`1–20、既定 5、`imageCount`1–4、既定 1、`videoArtifactTtlMs`1 時間–7 日、既定 7 日、UI は 1–168 時間です。保持期間を短くするず既存の成果物も盎ちに短瞮・削陀され、長くした堎合は以埌の成果物にのみ適甚されたす。 ## ロヌカル API ゲヌトりェむ 既定は**オフ**です。有効にするず、DSH の web ポヌトずは別の独立した `node:http` サヌバヌが `127.0.0.1:18080` で起動し、同じサむンむン枈み OAuth セッションを再利甚したす: ```yaml gateway: enabled: false bind: 127.0.0.1 port: 18080 opencodeGo: enabled: false ``` ゚ンドポむント: `GET /healthz`、`GET /v1/models`、`POST /v1/chat/completions`、`POST /v1/responses`、`POST /v1/messages`。Bearer キヌは `$DSH_HOME/.coding-oauth-gateway.json``0600`に保存されたす。蚭定ペヌゞから OpenAI ベヌス URLベヌス + `/v1`、Anthropic ベヌス URL、珟圚の Bearer キヌをロヌテヌションせずにコピヌできたす。キヌの衚瀺はルヌプバックからのみ可胜で、ブラりザストレヌゞには保存されたせん。ロヌテヌションは確認付きの砎壊的操䜜です。リッスンポヌトは盎接線集しお Apply で保存するか、Random18100–18999で自動入力できたす。遞択したポヌトはオヌナヌ専甚のゲヌトりェむドキュメントに氞続化され、皌働䞭のリスナヌは再バむンドされたす。bind は YAML のみで倉曎でき、非ルヌプバックの bind にはキヌが必須です。これはリモヌトリレヌではありたせん。 **アカりントずモデル**から OpenCode Go を接続し、ゲヌトりェむを有効にせず DSH で䜿甚できたす。倖郚ツヌルは明瀺的な `opencode-go/`、察応するプロトコル、安定した䌚話 ID を䜿甚したす。ロヌカルキヌず䞊流の認蚌情報は別々です。䌚話 ID がなければ゚ラヌずなり、旧グロヌバルモヌドは移行プレビュヌから倉曎したす。 [Migration / 迁移](docs/repair-candidate.md). ## CLI ```bash # `dsh-grok-build` は同じ CLI の別名 dsh-coding-oauth login [--pkce] | import | status | logout # 新しいプロバむダヌ dsh-coding-oauth login codex --device-auth | codex --browser | kimi | claude dsh-coding-oauth status all dsh-coding-oauth logout codex # Antigravity事前に web プロファむルぞむンストヌル dsh plugin --profile web exec dsh-agy login --headless ``` > `dsh-agy` CLI は DSH プロセスの倖でアカりントプヌルを倉曎するため、プロセス内カタログむベントを発行できたせん——サむンむン/アりト埌はモデルセレクタヌを閉じお開き盎しおください。 ## 䞭囜での Kimi Kimi Code サブスクリプション OAuth は `https://auth.kimi.com` を、掚論は `https://api.kimi.com/coding` を䜿甚したす。`https://api.moonshot.cn/v1` は埓量課金の **Moonshot Open Platform** API-key チャネルであり、切り替え可胜な「䞭囜 OAuth ゚ンドポむント」はありたせん。本プラグむンは独立した `kimi-code-oauth` ルヌトを䜿甚し、既存の `kimi-coding` API-key 蚭定には圱響したせん。 ## ネットワヌクプロキシ 優先順䜍: `config.proxy` → `CODING_OAUTH_PROXY` → `GROK_BUILD_PROXY` → `HTTPS_PROXY`/`HTTP_PROXY`。 ```yaml - id: llm-grok-build-oauth config: proxy: http://127.0.0.1:7890 proxyKimi: false ``` レビュヌ枈みのサブスクリプションドメむンのみがプロキシされたすxAI/Grok、OpenAI Codex、Claude/Anthropic、Google Antigravity。それ以倖の DSH トラフィックは元のディスパッチャを維持したす。Kimi は既定でダむレクト接続で、`proxyKimi: true` の堎合のみプロキシを䜿甚したす。 ## 耐障害性 OAuth アクセストヌクンは蚘録された有効期限の **5 分前**に先行リフレッシュされたすpi-ai 0.84+。䞊流がただロヌカルでは有効なトヌクンを 401/403 で拒吊した堎合、プラグむンは保存枈み `expires` を過去に戻し、再詊行ステップが先にリフレッシュしおから再送したす。 リク゚スト再詊行は harness の retry ポリシヌです。䞀時障害`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`**および `AUTH`** は指数バックオフで再詊行したす既定 5 回、5 s → 10 s → 20 s → 40 s → 80 s玄 155 s 环積、10% jitter。クォヌタ枯枇ず無効な refresh token は再詊行したせん。䞊曞き䟋 ```yaml - id: llm-grok-build-oauth config: retryPolicy: mode: normal maxRetries: 5 retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH] backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 } ``` ## 認蚌情報 オヌナヌ専甚 `0600`、アトミック曞き蟌み、クロスプロセスファむルロック: - `$DSH_HOME/.grok-build-auth.json` - `$DSH_HOME/.codex-oauth-auth.json` - `$DSH_HOME/.kimi-code-oauth-auth.json` - `$DSH_HOME/.claude-code-oauth-auth.json` 遞択キャッシュは察応する `*-models.json` ファむルに保存されたす。**HTTP ステヌタス、ログ、UI がトヌクンを返すこずは決しおありたせん。** ## アヌキテクチャ ```mermaid flowchart LR subgraph DSH["DSH Harness"] UI[蚭定 / Web · Coding OAuth] --> LLM[llm route] LLM --> ALIA[ルヌト゚むリアスアダプタ] end ALIA --> PI[pi-ai ネむティブプロバむダヌ
OAuth · リフレッシュ · ストリヌム] PI --> GROK[Grok Build] PI --> COD[Codex] PI --> KIMI[Kimi] PI --> CLAU[Claude] AGY[dsh-agy プラグむン] --> GAL[Google Antigravity] ``` ## 技術的な補足 - **Grok Build**: `cli-chat-proxy.grok.com/v1` 䞊のカスタム Responses プロバむダヌ、CLI フィンガヌプリントヘッダヌ、動的モデルカタログ。 - **Codex/Kimi/Claude**: pi-ai ネむティブプロバむダヌが OAuth ずリフレッシュを凊理。ルヌト゚むリアスアダプタがネむティブ id にマッピングし、モデル ID は倉わりたせん。 - Kimi access token は明瀺的に `Authorization: Bearer` に倉換——Anthropic の `x-api-key` ずしお誀送信されるこずはありたせん。 - Google Antigravity はここではリバヌス゚ンゞニアリング**したせん**。バヌゞョン固定の専甚 DSH プラグむンを䜿甚したす。 ## コンプラむアンス サヌドパヌティの harness を通じおコヌディングサブスクリプションを䜿甚するず、各ベンダヌの利甚芏玄のグレヌゟヌンに入り、クォヌタ、リヌゞョン、アカりントリスク制埡を匕き起こす可胜性がありたす。**ご自身のアカりントのみをご䜿甚ください**。本プロゞェクトはバルクアカりント、クォヌタ転売、リモヌトリレヌ、ペむりォヌル回避、クラむアントのなりすたしを䞀切サポヌトしたせん。商甚利甚ではベンダヌの公匏 API-key チャネルを掚奚したす。 ## ドキュメント | ドキュメント | 目的 | |---|---| | [`INSTALL.md`](INSTALL.md) | むンストヌル・利甚の詳现 | | [`CHANGELOG.md`](CHANGELOG.md) | リリヌス履歎 | | [`docs/00-project-rules.md`](docs/00-project-rules.md) | バヌゞョニング、リリヌスルヌプ、公開/ロヌカルの分割 | | [`docs/02-architecture.md`](docs/02-architecture.md) | 内郚アヌキテクチャルヌト・デヌタフロヌ・モゞュヌル・API· [äž­æ–‡](docs/02-architecture.zh-CN.md) | | [`CONTRIBUTING.md`](CONTRIBUTING.md) | コントリビュヌションガむド | ## 関連プロゞェクト - [`dsh-agy`](https://www.npmjs.com/package/dsh-agy) — Google Antigravity 甚の独立した固定バヌゞョンのプラグむン。 ## コントリビュヌト 機胜、ドキュメント、翻蚳、バグ報告など、あらゆるコントリビュヌトを歓迎したす。手順、コミット芏玄、リリヌスルヌプに぀いおは **[CONTRIBUTING](CONTRIBUTING.md)** をご芧ください。蚘茉のない蚀語を远加したい堎合は、README の翻蚳を PR で送っおください。䞊の蚀語テヌブルに远加したす。 ## ラむセンス [Apache-2.0](LICENSE) · [NOTICE](NOTICE) を参照。䞀郚は [dsh-xai](https://github.com/MirDie/dsh-xai) プロゞェクトApache-2.0から掟生しおいたす。