From 8e0541d766d695eab9d4d28a7196fd089c7c2765 Mon Sep 17 00:00:00 2001 From: hex2077 Date: Fri, 27 Mar 2026 18:12:25 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BB=8EREADME=E4=B8=AD=E7=A7=BB?= =?UTF-8?q?=E9=99=A4=E5=BA=9F=E5=BC=83=E7=9A=84=E4=BC=98=E5=85=88=E7=BA=A7?= =?UTF-8?q?=E9=85=8D=E7=BD=AE=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 移除所有语言版本README中关于provider_pools.json优先级配置的过时文档, 因为该功能已被移除。相应调整后续章节的编号以保持文档连贯性。 --- README-JA.md | 33 ++------------------------------- README-ZH.md | 33 ++------------------------------- README.md | 33 ++------------------------------- 3 files changed, 6 insertions(+), 93 deletions(-) diff --git a/README-JA.md b/README-JA.md index 52715ec..ff5eec3 100644 --- a/README-JA.md +++ b/README-JA.md @@ -466,36 +466,7 @@ curl http://localhost:3000/claude-kiro-oauth/v1/chat/completions \ - 一部のアカウントは割り当てまたは権限の制限により特定のモデルにアクセスできない - 異なるアカウントに異なるモデルアクセス権限を割り当てる必要がある -#### 3. プロバイダー優先度設定 - -`provider_pools.json` 内のノードごとの `priority` フィールドを通じて、確定的なアカウント順序をサポートします。 - -**設定方法**(数値が小さいほど優先度が高くなります): - -```json -{ - "claude-kiro-oauth": [ - { - "uuid": "primary-node-uuid", - "priority": 1, - "checkHealth": true - }, - { - "uuid": "backup-node-uuid", - "priority": 2, - "checkHealth": true - } - ] -} -``` - -**動作原理**: -- プールマネージャーはまず、最も低い `priority` 値によって健全/利用可能なノードをフィルタリングします -- その最高優先度ティアのノードのみが LRU/スコアベースの負荷分散に参加します -- 最高優先度ティア全体が利用不可になった場合、次の優先度ティアが自動的に使用されます -- `priority` が省略されているか無効な場合、デフォルトの `100` が適用されます(後方互換性のある動作) - -#### 4. クロスタイプフォールバック設定 +#### 3. クロスタイプフォールバック設定 あるProvider Type(例:`gemini-cli-oauth`)のすべてのアカウントが429割り当て制限により枯渇したり、unhealthyとマークされた場合、システムは直接エラーを返すのではなく、互換性のある別のProvider Type(例:`gemini-antigravity`)に自動的にフォールバックできます。 @@ -529,7 +500,7 @@ curl http://localhost:3000/claude-kiro-oauth/v1/chat/completions \ - フォールバックはプロトコル互換タイプ間でのみ発生します(例:`gemini-*` 間、`claude-*` 間) - システムは自動的にターゲットProvider Typeがリクエストされたモデルをサポートしているか確認します -#### 5. TLS Sidecar (Bypass 403/Cloudflare) +#### 4. TLS Sidecar (Bypass 403/Cloudflare) Grok などの TLS 指紋(JA3/JA4)を厳密に検証するサービスに対して、本プロジェクトは Go uTLS ベースの Sidecar プロキシを統合しています。これにより、ブラウザの TLS 特徴をシミュレートし、403 Forbidden エラーを効果的に解決します。 diff --git a/README-ZH.md b/README-ZH.md index c19ba16..454b452 100644 --- a/README-ZH.md +++ b/README-ZH.md @@ -465,36 +465,7 @@ curl http://localhost:3000/claude-kiro-oauth/v1/chat/completions \ - 某些账号因配额或权限限制无法访问特定模型 - 需要为不同账号分配不同的模型访问权限 -#### 3. 提供商优先级配置 - -支持通过 `provider_pools.json` 中每个节点的 `priority` 字段实现确定的账号排序。 - -**配置方式**(数字越小,优先级越高): - -```json -{ - "claude-kiro-oauth": [ - { - "uuid": "primary-node-uuid", - "priority": 1, - "checkHealth": true - }, - { - "uuid": "backup-node-uuid", - "priority": 2, - "checkHealth": true - } - ] -} -``` - -**工作原理**: -- 池管理器首先按最低 `priority` 值过滤健康/可用的节点 -- 只有处于该最高优先级层级的节点才会参与基于 LRU/评分的负载均衡 -- 如果整个最高优先级层级不可用,系统将自动使用下一个优先级层级 -- 如果省略 `priority` 或其无效,将应用默认值 `100`(向后兼容行为) - -#### 4. 跨类型 Fallback 配置 +#### 3. 跨类型 Fallback 配置 当某一 Provider Type(如 `gemini-cli-oauth`)下的所有账号都因 429 配额耗尽或被标记为 unhealthy 时,系统能够自动 fallback 到另一个兼容的 Provider Type(如 `gemini-antigravity`),而不是直接返回错误。 @@ -528,7 +499,7 @@ curl http://localhost:3000/claude-kiro-oauth/v1/chat/completions \ - Fallback 只会在协议兼容的类型之间进行(如 `gemini-*` 之间、`claude-*` 之间) - 系统会自动检查目标 Provider Type 是否支持当前请求的模型 -#### 5. TLS Sidecar (Bypass 403/Cloudflare) +#### 4. TLS Sidecar (Bypass 403/Cloudflare) 针对 Grok 等对 TLS 指纹(JA3/JA4)校验严格的服务,本项目集成了基于 Go uTLS 的 Sidecar 代理,通过模拟浏览器 TLS 特征有效解决 403 Forbidden 报错。 diff --git a/README.md b/README.md index f7e0528..34d4040 100644 --- a/README.md +++ b/README.md @@ -466,36 +466,7 @@ Support excluding unsupported models through `notSupportedModels` configuration, - Some accounts cannot access specific models due to quota or permission restrictions - Need to assign different model access permissions to different accounts -#### 3. Provider Priority Configuration - -Support deterministic account ordering through a per-node `priority` field in `provider_pools.json`. - -**Configuration** (smaller number = higher priority): - -```json -{ - "claude-kiro-oauth": [ - { - "uuid": "primary-node-uuid", - "priority": 1, - "checkHealth": true - }, - { - "uuid": "backup-node-uuid", - "priority": 2, - "checkHealth": true - } - ] -} -``` - -**How It Works**: -- The pool manager first filters healthy/available nodes by the lowest `priority` value -- Only nodes in that highest-priority tier participate in LRU/score-based balancing -- If the whole highest-priority tier becomes unavailable, the next priority tier is used automatically -- If `priority` is omitted or invalid, default `100` is applied (backward compatible behavior) - -#### 4. Cross-Type Fallback Configuration +#### 3. Cross-Type Fallback Configuration When all accounts under a Provider Type (e.g., `gemini-cli-oauth`) are exhausted due to 429 quota limits or marked as unhealthy, the system can automatically fallback to another compatible Provider Type (e.g., `gemini-antigravity`) instead of returning an error directly. @@ -529,7 +500,7 @@ When all accounts under a Provider Type (e.g., `gemini-cli-oauth`) are exhausted - Fallback only occurs between protocol-compatible types (e.g., between `gemini-*`, between `claude-*`) - The system automatically checks if the target Provider Type supports the requested model -#### 5. TLS Sidecar (Bypass 403/Cloudflare) +#### 4. TLS Sidecar (Bypass 403/Cloudflare) For services like Grok that strictly validate TLS fingerprints (JA3/JA4), this project integrates a Sidecar proxy based on Go uTLS, which effectively solves 403 Forbidden errors by simulating browser TLS features.