dsh-coding-subscription-oauth 0.5.1 → 0.5.3

package/CHANGELOG.md

@@ -2,7 +2,18 @@
 
 All notable changes to `dsh-coding-subscription-oauth` are documented here, following the release loop in `docs/00-project-rules.md`. Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Versioning follows [SemVer](https://semver.org/).
 
-## Unreleased
+## v0.5.3 - 2026-08-19
+
+### Changed
+
+- Raise the default OAuth route retry policy to 5 stacked exponential delays (5 s → 10 s → 20 s → 40 s → 80 s, ~155 s total, 10% jitter).
+- Remap xAI “at capacity / high demand / priority processing / overloaded” finish messages to `RATE_LIMIT` so harness retries run instead of failing as `PI_AI_ERROR` when upstream `error.code` is null.
+
+## v0.5.2 - 2026-08-18
+
+### Documentation
+
+- Make the published npm package the first installation path for normal users; keep GitHub and local-directory installs explicitly as development or fallback options.
 
 ## v0.5.1 - 2026-08-18
 

package/INSTALL.md

@@ -1,22 +1,20 @@
 # 安装与使用 · dsh-coding-subscription-oauth
 
-本仓库原名 **`dsh-grok-build`**。新安装请用：
+本仓库原名 **`dsh-grok-build`**。普通用户请使用已发布的 npm 版本：
 
 ```bash
-dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 ```
 
 CLI 新命令是 `dsh-coding-oauth`（旧命令 `dsh-grok-build` 仍可用）。为兼容已有 profile，Cordis id 仍是 `llm-grok-build-oauth`，设置页 HTTP 路径仍是 `/plugins/dsh-grok-build/*`，凭据文件名不变。
 
-第一次公开发布是 **`0.4.1`**。当前推荐 **`0.5.1`**：
+第一次公开发布是 **`0.4.1`**。当前推荐 **`0.5.3`**：
 
 ```bash
-dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.1
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 dsh plugin --profile web update dsh-coding-subscription-oauth
 ```
 
-旧 GitHub 地址会解析到同一条 `main`。
-
 ## 前置条件
 
 - DeepSeek Harness 0.1.0-rc.6+
@@ -27,11 +25,14 @@ dsh plugin --profile web update dsh-coding-subscription-oauth
 ## 安装
 
 ```bash
-# 从 GitHub
+# 普通用户：当前 npm 发布版
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
+
+# 开发 / 备用：从 GitHub
 dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
 
-# 或本地开发目录
-dsh plugin --profile web add ./dsh-coding-subscription-oauth
+# 本地开发目录（备用）
+# dsh plugin --profile web add ./dsh-coding-subscription-oauth
 
 # Google Antigravity 可选依赖，固定版本
 dsh plugin --profile web add dsh-agy@0.1.2
@@ -48,7 +49,7 @@ gateway:
   port: 18080
 ```
 
-或在 Settings → Coding OAuth → Local API gateway 打开。Bearer key 存在 `$DSH_HOME/.coding-oauth-gateway.json`。不要绑定 `0.0.0.0`。
+或在 Settings → Coding OAuth → Gateway 标签页打开。Bearer key 存在 `$DSH_HOME/.coding-oauth-gateway.json`。不要绑定 `0.0.0.0`。
 
 ## Antigravity 安全配置
 
@@ -95,7 +96,7 @@ Kimi Code 中国流量默认直连；只有 `proxyKimi: true` 才代理。
 
 ## 弹性重试
 
-OAuth access token 会在本地记录过期时间前 5 分钟主动刷新。服务端若仍以 401/403 拒绝一个本地尚未过期的令牌，插件会把凭据 `expires` 回写到过去，重试的 step 先刷新再发请求。瞬时故障（429/5xx/超时/网络）和 AUTH 默认最多重试 2 次（500 ms → 10 s，10% jitter）。配额耗尽和 refresh token 失效不重试。
+OAuth access token 会在本地记录过期时间前 5 分钟主动刷新。服务端若仍以 401/403 拒绝一个本地尚未过期的令牌，插件会把凭据 `expires` 回写到过去，重试的 step 先刷新再发请求。瞬时故障（429/5xx/超时/网络）和 AUTH 默认最多重试 5 次（5 s → 10 s → 20 s → 40 s → 80 s，约 155 s 叠加时常，10% jitter）。xAI「at capacity」等文案会重映射为 `RATE_LIMIT` 后再退避。配额耗尽和 refresh token 失效不重试。
 
 部署级覆盖（可选）：
 
@@ -104,9 +105,9 @@ OAuth access token 会在本地记录过期时间前 5 分钟主动刷新。服
   config:
     retryPolicy:
       mode: normal
-      maxRetries: 2
+      maxRetries: 5
       retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH]
-      backoff: { initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0.1 }
+      backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 }
 ```
 
 ## 登录
@@ -191,6 +192,8 @@ rm -f ~/.dsh/.grok-build-models.json ~/.dsh/.codex-oauth-models.json \
 
 ## 部署验收
 
+以下命令面向维护者，需要在源码 checkout 中运行；通过 npm 安装的用户无需执行。
+
 ```bash
 pnpm run verify:deployed
 
@@ -206,7 +209,7 @@ pnpm run smoke:deployed
 
 | 现象 | 处理 |
 |---|---|
-| 还在搜 / 装着 `dsh-grok-build` | 仓库已更名为 `dsh-coding-subscription-oauth`；旧 GitHub 地址仍跟踪同一条 `main`。新安装请用新名 |
+| 还在搜 / 装着 `dsh-grok-build` | 仓库已更名为 `dsh-coding-subscription-oauth`；旧 GitHub 仓库已删除。请改用 npm 包或 `github:lninghaha/dsh-coding-subscription-oauth` |
 | Codex localhost callback 打不开 | 改用设备码，或把完整 redirect URL 粘贴回设置页 |
 | Claude localhost callback 在远端浏览器 | 把完整 redirect URL 粘贴回设置页 |
 | Kimi 401/403 | 重新登录并确认 Kimi Code 会员有效；不要改成 moonshot.cn OAuth |

package/README.de.md

@@ -4,7 +4,7 @@
 
 # 🔐 dsh-coding-subscription-oauth
 
-**v0.5.1 · früher `dsh-grok-build`
+**v0.5.3 · früher `dsh-grok-build`
 
 **OAuth-Plugin für Coding-Abonnements für [DeepSeek Harness](https://github.com/deepseek-ai/dsh).** Melden Sie sich einmal mit den Abonnements an, die Sie bereits bezahlen, und nutzen Sie die Modelle aus den Einstellungen oder der CLI von dsh. **Keine Tokens in den Chat einfügen.**
 
@@ -24,7 +24,7 @@ Zuerst **`dsh-grok-build`** (nur Grok Build). Jetzt SuperGrok / Codex / Kimi / C
 | | Das verwenden | Funktioniert weiter |
 |---|---|---|
 | GitHub / `dsh plugin add` | [`dsh-coding-subscription-oauth`](https://github.com/lninghaha/dsh-coding-subscription-oauth) | `github:lninghaha/dsh-grok-build` (derselbe `main`) |
-| npm | Noch nicht veröffentlicht; von GitHub installieren | Es gab kein altes npm-Paket |
+| npm | `dsh-coding-subscription-oauth@0.5.3` (aktuelle Version) | Es gab kein altes npm-Paket |
 | CLI | `dsh-coding-oauth` | `dsh-grok-build` |
 | Cordis-Plugin-id | `llm-grok-build-oauth` | unverändert |
 | Settings-HTTP-API | `/plugins/dsh-grok-build/*` | unverändert |
@@ -36,8 +36,11 @@ Zuerst **`dsh-grok-build`** (nur Grok Build). Jetzt SuperGrok / Codex / Kimi / C
 - 🔑 **Lokales OAuth, ohne Key einzufügen** — in den Einstellungen oder der CLI autorisieren; Tokens gelangen nie in den Chat.
 - 🧩 **Ein Plugin, fünf Anbieter** — Grok Build, Codex, Kimi, Claude und Google Antigravity.
 - 🛡️ **Sicherheit by Design** — Zugangsdateien nur-eigentümer `0600`, atomares Schreiben, dateiübergreifende Prozesssperre.
-- ⚙️ **Dynamischer Katalog** — der Modellwähler listet genau die Anbieter, die Sie authentifiziert haben.
+- ⚙️ **Dynamischer Katalog** — der Wähler listet nur authentifizierte Routen, gekennzeichnet mit `(OAuth)`, einschließlich `xhigh` von grok-4.6.
 - 🌐 **Proxy-bewusst** — nur geprüfte, vertrauenswürdige Abonnement-Domänen werden über den Proxy geleitet.
+- 📥 **Manueller CLI-Pull** — die Einstellungen entdecken erlaubte offizielle Grok-/Codex-/Kimi-/Claude-CLI-OAuth-Dateien schreibgeschützt; nach Vorschau und Überschreibbestätigung ziehen Sie eine Einweg-Kopie.
+- 🗂️ **Einstellungen mit Tabs** — Accounts, Gateway, Capabilities und About ersetzen das lange Scrollen; Karten angemeldeter Anbieter bleiben eingeklappt, bis sie erweitert werden.
+- 🎛️ **Optionale Funktionen, standardmäßig aus** — Codex-Suche, Nutzung/Kontingent, Bild erzeugen/bearbeiten, Fast und Grok Imagine wirken live beim Einschalten.
 - 🔌 **Opt-in lokales API-Gateway** — standardmäßig ausgeschalteter Loopback-Server, OpenAI-/Anthropic-kompatibel; für Ihre eigenen Werkzeuge, niemals ein öffentliches Relay.
 
 ## Integrationsprobleme, die dieses Plugin löst
@@ -70,8 +73,8 @@ Diese Suchbegriffe und DSH-Fehler führen meist hierher.
 ## 🚀 Schnellstart
 
 ```bash
-# 1. Plugin in das Web-Profil installieren
-dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
+# 1. Plugin in das Web-Profil installieren (aktuelle npm-Version)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 
 # 2. optional — Google Antigravity (gepinnte, geprüfte Version)
 dsh plugin --profile web add dsh-agy@0.1.2
@@ -85,9 +88,13 @@ Danach **Settings → Coding OAuth** öffnen und bei einem beliebigen Anbieter a
 ## 📚 Inhaltsverzeichnis
 
 - [Namensänderung](#namensänderung)
+- [Funktionen](#-funktionen)
 - [Integrationsprobleme, die dieses Plugin löst](#integrationsprobleme-die-dieses-plugin-löst)
+- [Unterstützte Anbieter](#unterstützte-anbieter)
+- [Schnellstart](#-schnellstart)
 - [Installation](#installation)
 - [Einstellungsseite](#einstellungsseite)
+- [Optionale Funktionen](#optionale-funktionen)
 - [Lokales API-Gateway](#lokales-api-gateway)
 - [CLI](#cli)
 - [Kimi in China](#kimi-in-china)
@@ -98,6 +105,7 @@ Danach **Settings → Coding OAuth** öffnen und bei einem beliebigen Anbieter a
 - [Technische Hinweise](#technische-hinweise)
 - [Compliance](#compliance)
 - [Dokumentation](#dokumentation)
+- [Verwandt](#verwandt)
 - [Mitwirken](#mitwirken)
 - [Lizenz](#lizenz)
 
@@ -106,10 +114,13 @@ Danach **Settings → Coding OAuth** öffnen und bei einem beliebigen Anbieter a
 Erfordert DeepSeek Harness `0.1.0-rc.6+` und Node.js 22.19+. Vollständige Details in den [Installationshinweisen](INSTALL.md).
 
 ```bash
-# von GitHub
+# aktuelle npm-Version (empfohlen)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
+
+# Entwicklung/Alternativ: von GitHub
 dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
 
-# oder ein lokales Entwicklungs-Checkout
+# Entwicklung/Alternativ: ein lokales Entwicklungs-Checkout
 dsh plugin --profile web add ./dsh-coding-subscription-oauth
 ```
 
@@ -198,16 +209,16 @@ Nur geprüfte Abonnement-Domänen werden proxied (xAI/Grok, OpenAI Codex, Claude
 
 OAuth-Zugriffstoken werden **fünf Minuten** vor dem gespeicherten Ablauf erneuert (pi-ai 0.84+). Lehnt der Upstream ein lokal noch gültiges Token mit 401/403 ab, setzt das Plugin das gespeicherte `expires` in die Vergangenheit; der wiederholte Step refresht zuerst und sendet dann erneut.
 
-Wiederholungen folgen der Harness-Retry-Policy: transiente Fehler (`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`) **und `AUTH`** werden mit exponentiellem Backoff wiederholt (2 Versuche, 500 ms → 10 s, 10 % Jitter). Quota-Erschöpfung und ein totes Refresh-Token werden **nicht** wiederholt. Überschreiben pro Deployment:
+Wiederholungen folgen der Harness-Retry-Policy: transiente Fehler (`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`) **und `AUTH`** werden mit exponentiellem Backoff wiederholt (5 Versuche, 5 s → 10 s → 20 s → 40 s → 80 s (~155 s gestapelt), 10 % Jitter). Quota-Erschöpfung und ein totes Refresh-Token werden **nicht** wiederholt. Überschreiben pro Deployment:
 
 ```yaml
 - id: llm-grok-build-oauth
   config:
     retryPolicy:
       mode: normal
-      maxRetries: 2
+      maxRetries: 5
       retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH]
-      backoff: { initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0.1 }
+      backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 }
 ```
 
 ## Zugangsdaten

package/README.es.md

@@ -4,7 +4,7 @@
 
 # 🔐 dsh-coding-subscription-oauth
 
-**v0.5.1 · antes `dsh-grok-build`
+**v0.5.3 · antes `dsh-grok-build`
 
 **Plugin OAuth de suscripciones de codificación para [DeepSeek Harness](https://github.com/deepseek-ai/dsh).** Inicia sesión una vez con las suscripciones que ya pagas y luego usa sus modelos desde la página de configuración o la CLI de dsh. **Sin pegar tokens en el chat.**
 
@@ -24,7 +24,7 @@ Empezó como **`dsh-grok-build`** (solo Grok Build). Ahora cubre SuperGrok / Cod
 | | Usa esto | Sigue funcionando |
 |---|---|---|
 | GitHub / `dsh plugin add` | [`dsh-coding-subscription-oauth`](https://github.com/lninghaha/dsh-coding-subscription-oauth) | `github:lninghaha/dsh-grok-build` (el mismo `main`) |
-| npm | Aún no publicado; instala desde GitHub | No se publicó un paquete npm legado |
+| npm | `dsh-coding-subscription-oauth@0.5.3` (versión actual) | No se publicó un paquete npm legado |
 | CLI | `dsh-coding-oauth` | `dsh-grok-build` |
 | Cordis plugin id | `llm-grok-build-oauth` | sin cambios |
 | API HTTP de ajustes | `/plugins/dsh-grok-build/*` | sin cambios |
@@ -36,8 +36,11 @@ Empezó como **`dsh-grok-build`** (solo Grok Build). Ahora cubre SuperGrok / Cod
 - 🔑 **OAuth local, sin pegar claves** — autoriza en la página de configuración o la CLI; los tokens nunca entran en el chat.
 - 🧩 **Un plugin, cinco proveedores** — Grok Build, Codex, Kimi, Claude y Google Antigravity.
 - 🛡️ **Seguro por diseño** — archivos de credenciales solo-propietario `0600`, escritura atómica, bloqueo de archivo entre procesos.
-- ⚙️ **Catálogo dinámico** — el selector de modelos lista exactamente los proveedores que autenticaste.
+- ⚙️ **Catálogo dinámico** — el selector lista solo rutas autenticadas, etiquetadas con `(OAuth)`, incluido el `xhigh` de grok-4.6.
 - 🌐 **Consciente de proxy** — solo hace proxy de dominios de suscripción revisados y confiables.
+- 📥 **CLI Pull manual** — la configuración descubre los archivos OAuth oficiales de los CLI Grok/Codex/Kimi/Claude permitidos, en modo solo lectura; extraes una copia unidireccional tras previsualizar y confirmar la sobrescritura.
+- 🗂️ **Configuración en pestañas** — Accounts, Gateway, Capabilities y About sustituyen el desplazamiento largo; las tarjetas de proveedores autenticados permanecen contraídas hasta expandirlas.
+- 🎛️ **Capacidades opcionales, desactivadas por defecto** — búsqueda de Codex, uso/cuota, generación/edición de imágenes, Fast y Grok Imagine se aplican en vivo al activarlas.
 - 🔌 **Gateway de API local opt-in** — servidor loopback compatible con OpenAI/Anthropic, desactivado por defecto; para tus propias herramientas, nunca un relé público.
 
 ## Problemas de integración que resuelve este plugin
@@ -70,8 +73,8 @@ Estas búsquedas y errores de DSH suelen traer a la gente hasta aquí.
 ## 🚀 Inicio rápido
 
 ```bash
-# 1. instala el plugin en el perfil web
-dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
+# 1. instala el plugin en el perfil web (versión actual de npm)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 
 # 2. opcional — Google Antigravity (versión fija revisada)
 dsh plugin --profile web add dsh-agy@0.1.2
@@ -85,9 +88,13 @@ Luego abre **Settings → Coding OAuth** e inicia sesión en cualquier proveedor
 ## 📚 Índice
 
 - [Cambio de nombre](#cambio-de-nombre)
+- [Funciones](#-funciones)
 - [Problemas de integración que resuelve este plugin](#problemas-de-integración-que-resuelve-este-plugin)
+- [Proveedores soportados](#proveedores-soportados)
+- [Inicio rápido](#-inicio-rápido)
 - [Instalación](#instalación)
 - [Página de configuración](#página-de-configuración)
+- [Capacidades opcionales](#capacidades-opcionales)
 - [Gateway de API local](#gateway-de-api-local)
 - [CLI](#cli)
 - [Kimi en China](#kimi-en-china)
@@ -98,6 +105,7 @@ Luego abre **Settings → Coding OAuth** e inicia sesión en cualquier proveedor
 - [Notas técnicas](#notas-técnicas)
 - [Cumplimiento](#cumplimiento)
 - [Documentación](#documentación)
+- [Relacionados](#relacionados)
 - [Contribución](#contribución)
 - [Licencia](#licencia)
 
@@ -106,10 +114,13 @@ Luego abre **Settings → Coding OAuth** e inicia sesión en cualquier proveedor
 Requiere DeepSeek Harness `0.1.0-rc.6+` y Node.js 22.19+. Detalles completos en las [notas de instalación](INSTALL.md).
 
 ```bash
-# desde GitHub
+# versión actual de npm (recomendado)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
+
+# desarrollo/alternativo: desde GitHub
 dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
 
-# o un checkout local de desarrollo
+# desarrollo/alternativo: un checkout local de desarrollo
 dsh plugin --profile web add ./dsh-coding-subscription-oauth
 ```
 
@@ -198,16 +209,16 @@ Solo se usan vía proxy los dominios de suscripción revisados (xAI/Grok, OpenAI
 
 Los tokens de acceso OAuth se renuevan **cinco minutos** antes del vencimiento almacenado (pi-ai 0.84+). Si el origen aún rechaza un token localmente válido con 401/403, el plugin retrocede el `expires` guardado y el step reintentado renueva el token antes de reenviar.
 
-Los reintentos siguen la política del harness: fallos transitorios (`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`) **y `AUTH`** se reintentan con backoff exponencial (2 reintentos, 500 ms → 10 s, 10% de jitter). El agotamiento de cuota y un refresh token muerto **no** se reintentan. Anulación por despliegue:
+Los reintentos siguen la política del harness: fallos transitorios (`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`) **y `AUTH`** se reintentan con backoff exponencial (5 reintentos, 5 s → 10 s → 20 s → 40 s → 80 s (~155 s acumulados), 10% de jitter). El agotamiento de cuota y un refresh token muerto **no** se reintentan. Anulación por despliegue:
 
 ```yaml
 - id: llm-grok-build-oauth
   config:
     retryPolicy:
       mode: normal
-      maxRetries: 2
+      maxRetries: 5
       retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH]
-      backoff: { initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0.1 }
+      backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 }
 ```
 
 ## Credenciales

package/README.fr.md

@@ -4,7 +4,7 @@
 
 # 🔐 dsh-coding-subscription-oauth
 
-**v0.5.1 · anciennement `dsh-grok-build`
+**v0.5.3 · anciennement `dsh-grok-build`
 
 **Plugin OAuth pour abonnements de codage de [DeepSeek Harness](https://github.com/deepseek-ai/dsh).** Connectez-vous une fois avec les abonnements que vous payez déjà, puis utilisez leurs modèles depuis la page de configuration ou la CLI dsh. **Aucun token collé dans le chat.**
 
@@ -24,7 +24,7 @@ Le projet s'appelait **`dsh-grok-build`** (Grok Build uniquement). Il couvre mai
 | | Utiliser | Toujours valable |
 |---|---|---|
 | GitHub / `dsh plugin add` | [`dsh-coding-subscription-oauth`](https://github.com/lninghaha/dsh-coding-subscription-oauth) | `github:lninghaha/dsh-grok-build` (même `main`) |
-| npm | Pas encore publié ; installer depuis GitHub | Aucun ancien paquet npm n'a été publié |
+| npm | `dsh-coding-subscription-oauth@0.5.3` (version actuelle) | Aucun ancien paquet npm n'a été publié |
 | CLI | `dsh-coding-oauth` | `dsh-grok-build` |
 | Cordis plugin id | `llm-grok-build-oauth` | inchangé |
 | API HTTP des réglages | `/plugins/dsh-grok-build/*` | inchangé |
@@ -36,8 +36,11 @@ Le projet s'appelait **`dsh-grok-build`** (Grok Build uniquement). Il couvre mai
 - 🔑 **OAuth local, sans coller de clé** — autorisez dans la page de configuration ou la CLI ; les tokens n'entrent jamais dans le chat.
 - 🧩 **Un plugin, cinq fournisseurs** — Grok Build, Codex, Kimi, Claude et Google Antigravity.
 - 🛡️ **Sécurisé par conception** — fichiers d'identification propriétaire-seul `0600`, écriture atomique, verrou de fichier inter-processus.
-- ⚙️ **Catalogue dynamique** — le sélecteur de modèles liste exactement les fournisseurs que vous avez authentifiés.
+- ⚙️ **Catalogue dynamique** — le sélecteur n'affiche que les routes authentifiées, étiquetées `(OAuth)`, y compris le `xhigh` de grok-4.6.
 - 🌐 **Conscient du proxy** — ne proxifie que les domaines d'abonnement examinés et de confiance.
+- 📥 **CLI Pull manuel** — les paramètres découvrent en lecture seule les fichiers OAuth officiels des CLI Grok/Codex/Kimi/Claude autorisés ; vous récupérez une copie à sens unique après prévisualisation et confirmation d'écrasement.
+- 🗂️ **Paramètres en onglets** — Accounts, Gateway, Capabilities et About remplacent le long défilement ; les cartes des fournisseurs connectés restent repliées jusqu'à leur expansion.
+- 🎛️ **Capacités optionnelles, désactivées par défaut** — recherche Codex, usage/quota, génération/édition d'images, Fast et Grok Imagine s'appliquent en direct dès leur activation.
 - 🔌 **Passerelle API locale opt-in** — serveur loopback compatible OpenAI/Anthropic, désactivé par défaut ; pour vos propres outils, jamais un relais public.
 
 ## Problèmes d'intégration que ce plugin résout
@@ -70,8 +73,8 @@ Ce sont les recherches et erreurs DSH qui mènent le plus souvent ici.
 ## 🚀 Démarrage rapide
 
 ```bash
-# 1. installez le plugin dans le profil web
-dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
+# 1. installez le plugin dans le profil web (version actuelle npm)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 
 # 2. optionnel — Google Antigravity (version épinglée examinée)
 dsh plugin --profile web add dsh-agy@0.1.2
@@ -85,9 +88,13 @@ Ensuite ouvrez **Settings → Coding OAuth** et connectez-vous à n'importe quel
 ## 📚 Sommaire
 
 - [Changement de nom](#changement-de-nom)
+- [Fonctionnalités](#-fonctionnalités)
 - [Problèmes d'intégration que ce plugin résout](#problèmes-dintégration-que-ce-plugin-résout)
+- [Fournisseurs pris en charge](#fournisseurs-pris-en-charge)
+- [Démarrage rapide](#-démarrage-rapide)
 - [Installation](#installation)
 - [Page de configuration](#page-de-configuration)
+- [Capacités optionnelles](#capacités-optionnelles)
 - [Passerelle API locale](#passerelle-api-locale)
 - [CLI](#cli)
 - [Kimi en Chine](#kimi-en-chine)
@@ -98,6 +105,7 @@ Ensuite ouvrez **Settings → Coding OAuth** et connectez-vous à n'importe quel
 - [Notes techniques](#notes-techniques)
 - [Conformité](#conformité)
 - [Documentation](#documentation)
+- [Lié](#lié)
 - [Contribution](#contribution)
 - [Licence](#licence)
 
@@ -106,10 +114,13 @@ Ensuite ouvrez **Settings → Coding OAuth** et connectez-vous à n'importe quel
 Nécessite DeepSeek Harness `0.1.0-rc.6+` et Node.js 22.19+. Détails complets dans les [notes d'installation](INSTALL.md).
 
 ```bash
-# depuis GitHub
+# version actuelle npm (recommandé)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
+
+# développement/alternatif : depuis GitHub
 dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
 
-# ou un checkout local de développement
+# développement/alternatif : un checkout local de développement
 dsh plugin --profile web add ./dsh-coding-subscription-oauth
 ```
 
@@ -198,16 +209,16 @@ Seuls les domaines d'abonnement examinés sont proxifiés (xAI/Grok, OpenAI Code
 
 Les jetons d'accès OAuth sont renouvelés **cinq minutes** avant l'expiration enregistrée (pi-ai 0.84+). Si l'amont refuse encore un jeton localement valide avec 401/403, le plugin recule le `expires` stocké et l'étape relancée rafraîchit le jeton avant de renvoyer.
 
-Les nouvelles tentatives suivent la politique du harness : les pannes transitoires (`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`) **et `AUTH`** sont relancées avec un backoff exponentiel (2 essais, 500 ms → 10 s, jitter 10 %). L'épuisement de quota et un refresh token mort **ne** sont **pas** relancés. Surcharge par déploiement :
+Les nouvelles tentatives suivent la politique du harness : les pannes transitoires (`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`) **et `AUTH`** sont relancées avec un backoff exponentiel (5 essais, 5 s → 10 s → 20 s → 40 s → 80 s (~155 s cumulés), jitter 10 %). L'épuisement de quota et un refresh token mort **ne** sont **pas** relancés. Surcharge par déploiement :
 
 ```yaml
 - id: llm-grok-build-oauth
   config:
     retryPolicy:
       mode: normal
-      maxRetries: 2
+      maxRetries: 5
       retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH]
-      backoff: { initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0.1 }
+      backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 }
 ```
 
 ## Identifiants

package/README.ja.md

@@ -4,7 +4,7 @@
 
 # 🔐 dsh-coding-subscription-oauth
 
-**v0.5.1 · 旧名 `dsh-grok-build`
+**v0.5.3 · 旧名 `dsh-grok-build`
 
 **DeepSeek Harness（dsh）のためのコーディングサブスクリプション OAuth プラグイン。** 支払い済みのサブスクリプションで一度きりのサインイン——その後は dsh の設定ページまたは CLI からそのモデルを使えます。**チャットにトークンを貼り付ける必要はありません。**
 
@@ -24,7 +24,7 @@
 | | これを使う | 互換 |
 |---|---|---|
 | GitHub / `dsh plugin add` | [`dsh-coding-subscription-oauth`](https://github.com/lninghaha/dsh-coding-subscription-oauth) | `github:lninghaha/dsh-grok-build`（同じ `main`） |
-| npm | 未公開。GitHub からインストール | 旧 npm パッケージは公開されていない |
+| npm | `dsh-coding-subscription-oauth@0.5.3`（現在のリリース） | 旧 npm パッケージは公開されていない |
 | CLI | `dsh-coding-oauth` | `dsh-grok-build` |
 | Cordis プラグイン id | `llm-grok-build-oauth` | 変更なし |
 | 設定ページ HTTP API | `/plugins/dsh-grok-build/*` | 変更なし |
@@ -36,8 +36,11 @@
 - 🔑 **ローカル 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 の 4 タブが長い縦スクロールを置き換え、サインイン済みプロバイダーのカードは展開するまで折りたたまれます。
+- 🎛️ **オプション機能（既定オフ）** — Codex の検索・使用量/クォータ・画像生成/編集・Fast、Grok Imagine はスイッチをオンにすると即時適用されます。
 - 🔌 **オプトインのローカル API ゲートウェイ** — 既定オフのループバック OpenAI/Anthropic 互換サーバー。自分のツール専用で、公開リレーではありません。
 
 ## このプラグインが解く接続の問題
@@ -70,8 +73,8 @@ DSH にコーディングサブスクを載せるとき、よく次の検索語
 ## 🚀 クイックスタート
 
 ```bash
-# 1. web プロファイルにプラグインをインストール
-dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
+# 1. web プロファイルにプラグインをインストール（現在の npm リリース）
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 
 # 2. 任意 — Google Antigravity（レビュー済みの固定バージョン）
 dsh plugin --profile web add dsh-agy@0.1.2
@@ -85,9 +88,13 @@ systemctl --user restart dsh-web.service
 ## 📚 目次
 
 - [名称変更](#名称変更)
+- [特徴](#-特徴)
 - [このプラグインが解く接続の問題](#このプラグインが解く接続の問題)
+- [対応プロバイダー](#対応プロバイダー)
+- [クイックスタート](#-クイックスタート)
 - [インストール](#インストール)
 - [設定ページ](#設定ページ)
+- [オプション機能](#オプション機能)
 - [ローカル API ゲートウェイ](#ローカル-api-ゲートウェイ)
 - [CLI](#cli)
 - [中国での Kimi](#中国での-kimi)
@@ -98,6 +105,7 @@ systemctl --user restart dsh-web.service
 - [技術的な補足](#技術的な補足)
 - [コンプライアンス](#コンプライアンス)
 - [ドキュメント](#ドキュメント)
+- [関連プロジェクト](#関連プロジェクト)
 - [コントリビュート](#コントリビュート)
 - [ライセンス](#ライセンス)
 
@@ -106,10 +114,13 @@ systemctl --user restart dsh-web.service
 DeepSeek Harness `0.1.0-rc.6+` と Node.js 22.19+ が前提です。詳細は[インストールノート](INSTALL.md)をご覧ください。
 
 ```bash
-# GitHub から
+# 現在の npm リリース（推奨）
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
+
+# 開発／代替：GitHub から
 dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
 
-# またはローカルの開発ディレクトリから
+# 開発／代替：ローカルの開発ディレクトリから
 dsh plugin --profile web add ./dsh-coding-subscription-oauth
 ```
 
@@ -198,16 +209,16 @@ Kimi Code サブスクリプション OAuth は `https://auth.kimi.com` を、
 
 OAuth アクセストークンは記録された有効期限の **5 分前**に先行リフレッシュされます（pi-ai 0.84+）。上流がまだローカルでは有効なトークンを 401/403 で拒否した場合、プラグインは保存済み `expires` を過去に戻し、再試行ステップが先にリフレッシュしてから再送します。
 
-リクエスト再試行は harness の retry ポリシーです。一時障害（`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`）**および `AUTH`** は指数バックオフで再試行します（既定 2 回、500 ms → 10 s、10% jitter）。クォータ枯渇と無効な refresh token は再試行しません。上書き例：
+リクエスト再試行は 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: 2
+      maxRetries: 5
       retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH]
-      backoff: { initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0.1 }
+      backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 }
 ```
 
 ## 認証情報

package/README.ko.md

@@ -4,7 +4,7 @@
 
 # 🔐 dsh-coding-subscription-oauth
 
-**v0.5.1 · 이전 이름 `dsh-grok-build`
+**v0.5.3 · 이전 이름 `dsh-grok-build`
 
 **[DeepSeek Harness](https://github.com/deepseek-ai/dsh)용 코딩 구독 OAuth 플러그인.** 이미 결제한 구독으로 한 번에 로그인하고, dsh 설정 페이지나 CLI에서 그 모델을 사용하세요. **채팅에 토큰을 붙여넣을 필요가 없습니다.**
 
@@ -24,7 +24,7 @@
 | | 이것을 쓰세요 | 계속 동작 |
 |---|---|---|
 | GitHub / `dsh plugin add` | [`dsh-coding-subscription-oauth`](https://github.com/lninghaha/dsh-coding-subscription-oauth) | `github:lninghaha/dsh-grok-build`（같은 `main`） |
-| npm | 아직 게시되지 않음. GitHub에서 설치 | 레거시 npm 패키지는 게시된 적 없음 |
+| npm | `dsh-coding-subscription-oauth@0.5.3`（현재 릴리스） | 레거시 npm 패키지는 게시된 적 없음 |
 | CLI | `dsh-coding-oauth` | `dsh-grok-build` |
 | Cordis 플러그인 id | `llm-grok-build-oauth` | 그대로 |
 | 설정 페이지 HTTP API | `/plugins/dsh-grok-build/*` | 그대로 |
@@ -36,8 +36,11 @@
 - 🔑 **로컬 OAuth, 키 붙여넣기 불필요** — 설정 페이지나 CLI에서 인증하며, 토큰이 채팅에 들어가지 않습니다.
 - 🧩 **하나의 플러그인, 다섯 프로바이더** — 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 네 탭이 긴 폭포형 스크롤을 대체하며, 로그인된 프로바이더 카드는 펼칠 때까지 접혀 있습니다.
+- 🎛️ **선택적 기능 (기본 꺼짐)** — Codex 검색, 사용량/쿼터, 이미지 생성/편집, Fast, Grok Imagine은 스위치를 켜면 즉시 적용됩니다.
 - 🔌 **옵트인 로컬 API 게이트웨이** — 기본 꺼짐의 루프백 OpenAI/Anthropic 호환 서버. 내 도구 전용이며 공개 릴레이가 아닙니다.
 
 ## 이 플러그인이 푸는 연동 문제
@@ -70,8 +73,8 @@
 ## 🚀 빠른 시작
 
 ```bash
-# 1. web 프로필에 플러그인 설치
-dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
+# 1. web 프로필에 플러그인 설치 (현재 npm 릴리스)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
 
 # 2. 선택 사항 — Google Antigravity (검증된 고정 버전)
 dsh plugin --profile web add dsh-agy@0.1.2
@@ -85,9 +88,13 @@ systemctl --user restart dsh-web.service
 ## 📚 목차
 
 - [이름 변경](#이름-변경)
+- [기능](#-기능)
 - [이 플러그인이 푸는 연동 문제](#이-플러그인이-푸는-연동-문제)
+- [지원 프로바이더](#지원-프로바이더)
+- [빠른 시작](#-빠른-시작)
 - [설치](#설치)
 - [설정 페이지](#설정-페이지)
+- [선택적 기능](#선택적-기능)
 - [로컬 API 게이트웨이](#로컬-api-게이트웨이)
 - [CLI](#cli)
 - [중국에서의 Kimi](#중국에서의-kimi)
@@ -98,6 +105,7 @@ systemctl --user restart dsh-web.service
 - [기술 메모](#기술-메모)
 - [준수](#준수)
 - [문서](#문서)
+- [관련 프로젝트](#관련-프로젝트)
 - [기여](#기여)
 - [라이선스](#라이선스)
 
@@ -106,10 +114,13 @@ systemctl --user restart dsh-web.service
 DeepSeek Harness `0.1.0-rc.6+` 및 Node.js 22.19+가 필요합니다. 자세한 내용은 [설치 노트](INSTALL.md)를 참조하세요.
 
 ```bash
-# GitHub에서
+# 현재 npm 릴리스 (권장)
+dsh plugin --profile web add dsh-coding-subscription-oauth@0.5.3
+
+# 개발/대안: GitHub에서
 dsh plugin --profile web add github:lninghaha/dsh-coding-subscription-oauth
 
-# 또는 로컬 개발 디렉터리에서
+# 개발/대안: 로컬 개발 디렉터리에서
 dsh plugin --profile web add ./dsh-coding-subscription-oauth
 ```
 
@@ -198,16 +209,16 @@ Kimi Code 구독 OAuth는 `https://auth.kimi.com`, 추론은 `https://api.kimi.c
 
 OAuth 액세스 토큰은 저장된 만료 시각 **5분 전**에 선제적으로 갱신됩니다(pi-ai 0.84+). 업스트림이 로컬에서는 아직 유효한 토큰을 401/403으로 거절하면, 플러그인이 저장된 `expires`를 과거로 되돌리고 재시도 단계에서 먼저 갱신한 뒤 다시 요청합니다.
 
-요청 재시도는 harness retry 정책을 따릅니다. 일시 오류(`RATE_LIMIT`/`SERVER`/`TIMEOUT`/`TRANSPORT`/`EMPTY_RESPONSE`)와 **`AUTH`**는 지수 백오프로 재시도합니다(기본 2회, 500 ms → 10 s, 10% jitter). 쿼터 소진과 죽은 refresh token은 재시도하지 않습니다. 배포별 재정의:
+요청 재시도는 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: 2
+      maxRetries: 5
       retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, AUTH]
-      backoff: { initialDelayMs: 500, maxDelayMs: 10000, jitterRatio: 0.1 }
+      backoff: { initialDelayMs: 5000, maxDelayMs: 80000, jitterRatio: 0.1 }
 ```
 
 ## 자격 증명