dalsoop · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026
@@ -125,3 +125,9 @@ Le routage et la visibilité dans le catalogue sont deux mécanismes distincts :
   un fournisseur portant ce nom (par exemple `anthropic` ou `groq`) est effectivement configuré.
 
 Consultez [Configuration](/fr/reference/configuration/) pour connaître les champs de fournisseur lus par ces règles.
+
+<a id="model-discovery-defaults"></a>
+
+## Valeurs par défaut de la découverte de modèles
+
+`modelDiscovery.newModelPolicy` vaut `"off"` par défaut, même si le champ est absent. À la première découverte réussie, seul le `defaultModel` configuré est visible ; sinon, activez les modèles nécessaires dans Models. Les sélections, interrupteurs, petites références existantes et catalogues statiques sont conservés. Un ancien catalogue en direct sans sélection comptant au moins 20 modèles et un modèle par défaut configuré est réduit une seule fois à ce dernier ; sans modèle par défaut, sa visibilité est conservée ; les choix manuels ultérieurs ne sont pas réinitialisés. Les nouveaux modèles restent masqués jusqu’à leur activation. Un `"on"` explicite autorise la publication automatique. Utilisez `ocx models new-policy off` (avec `--provider <name>` si nécessaire) et `ocx models new-arrivals --json`.
@@ -112,7 +112,7 @@ sauvegarde dont le contenu diffère, puis réécrit en identifiants sans préfix
 | `defaultModel?` | `string` | Modèle utilisé lorsque ce fournisseur est sélectionné sans modèle explicite. |
 | `models?` | `string[]` | Liste initiale ou de repli. Avec `liveModels: false`, une liste `models` non vide est suivie de `retainModels` ; si `models` est vide ou absent, la liste commence par `defaultModel` (si configuré), puis `retainModels`, en conservant la première occurrence de chaque identifiant. |
 | `liveModels?` | `boolean` | Récupère le catalogue actif au démarrage et lors de la synchronisation (true par défaut). Les fournisseurs personnalisés utilisent `${baseUrl}/models` ; les fournisseurs intégrés peuvent employer une URL de registre et un filtre. |
-| `selectedModels?` | `string[]` | Liste autorisée du catalogue après la découverte. Non vide expose uniquement ces identifiants ; vide ou omis expose tous les modèles découverts. |
+| `selectedModels?` | `string[]` | Liste autorisée après découverte. Non vide : seuls ces identifiants sont admis. Vide ou absent : aucune liste supplémentaire. La politique de découverte et `disabledModels` restent applicables. |
 | `contextWindow?` | `number` | Repli contextuel à l’échelle du fournisseur lorsque les métadonnées en amont sont absentes ; sinon, un plafond qui conserve des métadonnées en direct plus petites. Le tableau de bord Modèles expose cela séparément de `providerContextCaps`. |
 | `modelContextWindows?` | `Record<string, number>` | Valeurs de repli ou plafonds de contexte par modèle. Ils remplacent `contextWindow` : une fenêtre inconnue utilise la valeur configurée, tandis que des métadonnées actives plus faibles restent déterminantes. |
 | `inferContextWindow?` | `boolean` | Fournisseurs personnalisés uniquement, désactivé par défaut. `true` complète une fenêtre absente à partir des métadonnées embarquées du modèle ; c’est une estimation, pas la capacité vérifiée du relais. |

@@ -82,18 +82,7 @@ Routing and catalog visibility are separate controls:
   for that model.
 - A provider's non-empty `selectedModels` is another catalog allowlist. Live discovery and direct
   routing still work; only catalog and `/v1/models` emission are narrowed.
-- Fresh installs set `modelDiscovery.newModelPolicy` to `"off"`. After the first successful live
-  fetch establishes a baseline, later arrivals are appended to `disabledModels` and carry a **NEW**
-  dashboard badge until enabled or acknowledged. Existing installs remain `"on"` until opted in.
-  The policy applies before publishing newly discovered models through `/v1/models`, the dashboard,
-  client configuration exports, or a Codex catalog sync (including service startup).
-  Enabling an arrival manually keeps it enabled on later refreshes and exports.
-  If the running provider configuration differs from disk, model lists still apply the policy
-  using a temporary projection; they leave the running configuration and saved choices untouched.
-  Use `ocx models new-policy off` globally, add `--provider <name>` for an override, and inspect
-  `ocx models new-arrivals [--json]`. Failed/degraded fetches never change the baseline. Providers
-  with a non-empty `selectedModels` (including preset mode) are already curated, so this policy is
-  deliberately inert for them.
+- `modelDiscovery.newModelPolicy` defaults to `"off"`, including when omitted in an existing configuration. On the first successful live discovery, only the configured `defaultModel` starts visible; without a matching default, enable the models you need in **Models**. Saved model selections, per-model switches and short existing baselines are preserved. An existing unselected live catalog with at least 20 models and a configured default is narrowed to that default once; existing baselines without a default retain their visibility; later manual changes are not reset. Static/manual catalogs are unchanged. Later arrivals remain hidden until enabled. Explicit `"on"` opts into automatic exposure. This policy applies before `/v1/models`, client exports and Codex catalog publication; failed discovery changes no choices. Use `ocx models new-policy off` (optionally `--provider <name>`) and `ocx models new-arrivals --json`.
 - `provider.disabled: true` removes that provider from catalog discovery. Explicit
   `provider/model` requests fail, and `defaultModel` / `models[]` scans skip it.
 - Routed catalog rows are cloned from the Codex-native template, so native-only delivery flags are

@@ -83,15 +83,7 @@ model ID は変更しません。`openai-apikey/<model>` は API key transport
   ブロックしません。
 - プロバイダーの `selectedModels` が空でなければカタログ許可リストとして動作します。ライブモデル探索と
   直接ルーティングはそのままに、カタログと `/v1/models` に公開するモデルだけ絞ります。
-- `modelDiscovery.newModelPolicy` が `"off"` の場合、最初の成功したライブ探索で基準を確立し、
-  その後に追加されたモデルを `disabledModels` に入れます。これは `/v1/models`、ダッシュボード、
-  クライアント設定のエクスポート、サービス起動時を含む Codex カタログ同期で公開する前に
-  適用されます。手動で有効化したモデルは、その後の更新やエクスポートでも有効なままです。
-  新規インストールの既定値は `"off"`、既存のインストールは変更するまで `"on"` です。
-  `ocx models new-policy off` で全体に適用し、`--provider <name>` で個別に上書きします。
-  `ocx models new-arrivals [--json]` で追加モデルを確認できます。失敗または縮退した探索では
-  基準は変わりません。`selectedModels` が空でないプロバイダーはすでに選別済みのため、
-  このポリシーによる自動無効化は行いません。
+- `modelDiscovery.newModelPolicy` の既定値は `"off"` です。既存の設定で省略した場合も同じです。最初の正常なライブ探索では、設定済みの `defaultModel` のみを表示します。一致する既定モデルがない場合は **Models** で必要なモデルを有効にしてください。保存済みの選択、個別スイッチ、短い既存の探索基準、静的カタログは保持します。未選択の既存ライブ一覧が20件以上で既定モデルが設定済みなら一度だけそのモデルに絞ります。既定モデルのない既存の探索基準は表示状態を保持し、その後の手動変更は初期化しません。新着モデルも手動で有効にするまで非表示です。明示的な `"on"` は自動公開を許可します。公開前に適用し、探索失敗時は選択を変更しません。`ocx models new-policy off` と `ocx models new-arrivals --json` を使用できます。
 - `provider.disabled: true` のプロバイダーはカタログ探索から除外されます。明示的 `provider/model` リクエストは
   失敗し、`defaultModel` / `models[]` 検査でもスキップします。
 - `providerContextCaps` はプロバイダーごとに Codex に表示するコンテキスト上限を指定します。

@@ -104,7 +104,7 @@ account を削除しても mapping は保持され、同じ id を再追加す
 | `defaultModel?` | `string` |このプロバイダーが明示的なモデルなしで選択された場合に使用されるモデル。 |
 | `models?` | `string[]` | 初期／フォールバックモデル一覧。`liveModels: false` で `models` が空でなければ、その後に `retainModels` を追加します。`models` が空または省略されている場合は、設定済みの `defaultModel`、`retainModels` の順に初期一覧を作り、重複 ID は最初の出現だけを残します。 |
 | `liveModels?` | `boolean` |開始/同期時にライブ カタログをフェッチします (デフォルトは `true`)。カスタムプロバイダーは `${baseUrl}/models` を使用します。組み込みはレジストリ URL とフィルターを使用する場合があります。 |
-| `selectedModels?` | `string[]` |検出後のカタログ許可リスト。空でない場合は、それらの ID のみが公開されます。空または省略すると、検出されたすべてのモデルが公開されます。 |
+| `selectedModels?` | `string[]` | 探索後の許可リスト。非空の場合は指定 ID のみを許可し、空または省略時は追加の許可リストを適用しません。探索ポリシーと `disabledModels` は引き続き適用されます。 |
 | `modelDisplayNames?` | `Record<string, string>` | このプロバイダーの正確なネイティブモデル ID をキーにした、永続的な表示専用ラベルです。大文字と小文字は区別されます。ラベルはプロバイダーカタログのメタデータより優先され、認証、アダプター、ルーティング、課金、上流リクエストには影響しません。マップは検出上限と同じ 2,000 件までです。 |
 | `contextWindow?` | `number` | アップストリームのメタデータが無い場合に使うプロバイダー全体のコンテキスト値。メタデータがある場合は上限として働き、より小さいライブ値をそのまま残します。Models ダッシュボードでは `providerContextCaps` とは別に設定します。 |
 | `modelContextWindows?` | `Record<string, number>` | モデルごとのコンテキスト値および上限。`contextWindow` より優先され、ウィンドウが不明なら設定値を使い、より小さいライブメタデータがあればそちらが優先されます。 |

@@ -82,15 +82,7 @@ fallback하지 않습니다.
   막지는 않습니다.
 - 프로바이더의 `selectedModels`가 비어 있지 않으면 카탈로그 허용 목록으로 동작합니다. 실시간 모델 탐색과
   직접 라우팅은 그대로 두고, 카탈로그와 `/v1/models`에 내보낼 모델만 줄입니다.
-- `modelDiscovery.newModelPolicy`가 `"off"`이면 첫 실시간 탐색 성공 시 기준을 만들고,
-  이후 추가된 모델을 `disabledModels`에 넣습니다. 이 정책은 `/v1/models`, 대시보드,
-  클라이언트 설정 내보내기, 서비스 시작을 포함한 Codex 카탈로그 동기화에서 새 모델을 공개하기
-  전에 적용됩니다. 수동으로 활성화한 모델은 이후 새로고침과 내보내기에서도 활성 상태를 유지합니다.
-  새 설치의 기본값은 `"off"`이며, 기존 설치는 직접 바꾸기 전까지 `"on"`을 유지합니다.
-  `ocx models new-policy off`로 전역 정책을 설정하고, `--provider <name>`으로 프로바이더별
-  정책을 지정합니다. `ocx models new-arrivals [--json]`으로 새 모델을 확인할 수 있습니다.
-  실패하거나 제한된 탐색은 기준을 바꾸지 않습니다. `selectedModels`가 비어 있지 않은
-  프로바이더는 이미 선택 목록을 사용하므로 이 정책으로 모델을 자동 비활성화하지 않습니다.
+- `modelDiscovery.newModelPolicy`의 기본값은 `"off"`이며, 기존 설정에서 생략한 경우에도 적용됩니다. 첫 실시간 탐색 성공 시 설정된 `defaultModel`만 표시합니다. 일치하는 기본 모델이 없으면 **모델**에서 필요한 모델을 직접 켜세요. 기존 선택 목록, 모델별 켜기/끄기 설정과 짧은 탐색 기준, 수동·정적 카탈로그는 보존합니다. 선택 설정이 없는 기존 실시간 카탈로그가 20개 이상이고 기본 모델이 설정되어 있으면 한 번만 기본 모델로 줄입니다. 기본 모델이 없는 기존 탐색 기준은 표시 상태를 보존하며, 이후 수동 변경은 다시 초기화하지 않습니다. 이후 발견된 모델도 직접 켜기 전까지 숨깁니다. 명시적 `"on"`은 자동 노출을 허용합니다. `/v1/models`, 클라이언트 내보내기, Codex 카탈로그 공개 전에 적용하며, 탐색 실패 시 선택을 바꾸지 않습니다. `ocx models new-policy off`에 `--provider <name>`을 추가해 공급자별로 설정하고, `ocx models new-arrivals --json`으로 새 모델을 확인합니다.
 - `provider.disabled: true`인 프로바이더는 카탈로그 탐색에서 제외됩니다. 명시적 `provider/model` 요청은
   실패하고, `defaultModel` / `models[]` 검사에서도 건너뜁니다.
 - `providerContextCaps`는 공급자별로 Codex에 표시할 컨텍스트 상한을 지정합니다.

@@ -104,7 +104,7 @@ managed map을 활성화하면 privacy-safe selector를 만들고, 이후 계정
 | `defaultModel?` | `string` | 이 공급자를 선택할 때 모델을 따로 지정하지 않으면 사용하는 모델입니다. |
 | `models?` | `string[]` | 초기/폴백 모델 목록입니다. `liveModels: false`에서 `models`가 비어 있지 않으면 `models`, `retainModels` 순으로 구성합니다. `models`가 비어 있거나 생략되면 설정된 `defaultModel`, `retainModels` 순으로 구성하고, 중복 ID는 처음 나온 항목만 남깁니다. |
 | `liveModels?` | `boolean` | 시작 또는 동기화 시 라이브 카탈로그를 가져옵니다. 기본값은 `true`입니다. 사용자 지정 공급자는 `${baseUrl}/models`를 사용하고, 내장은 레지스트리 URL을 사용한 뒤 필터링할 수 있습니다. |
-| `selectedModels?` | `string[]` | 발견 후 카탈로그 허용 목록입니다. 값이 비어 있지 않으면 그 id만 노출하고, 비어 있거나 생략하면 발견된 모델을 모두 노출합니다. |
+| `selectedModels?` | `string[]` | 발견 후 카탈로그 허용 목록입니다. 값이 있으면 그 id만 허용하며, 비어 있거나 생략하면 추가 허용 목록을 적용하지 않습니다. 탐색 정책과 `disabledModels`는 계속 적용됩니다. |
 | `modelDisplayNames?` | `Record<string, string>` | 이 공급자의 정확한 네이티브 모델 id를 키로 쓰는 영구 표시 전용 이름입니다. 키는 대소문자를 구분합니다. 이름은 공급자 카탈로그 메타데이터보다 우선하며 인증, 어댑터, 라우팅, 청구 또는 업스트림 요청을 바꾸지 않습니다. 맵은 발견 한도와 같은 최대 2,000개 항목을 가질 수 있습니다. |
 | `contextWindow?` | `number` | 업스트림 메타데이터가 없을 때 쓰이는 공급자 전반의 컨텍스트 값입니다. 메타데이터가 있으면 상한으로 동작해 더 작은 라이브 값을 그대로 둡니다. Models 대시보드에서 `providerContextCaps`와 별도로 설정합니다. |
 | `modelContextWindows?` | `Record<string, number>` | 모델별 컨텍스트 값이자 상한입니다. `contextWindow`보다 우선하며, 창 크기를 알 수 없으면 설정값을 쓰고 더 작은 라이브 메타데이터가 있으면 그쪽을 따릅니다. |

@@ -322,7 +322,7 @@ Providers can expose a built-in shorthand, such as `agy` for `google-antigravity
 | `defaultModel?` | `string` | Model used when this provider is selected without an explicit model. |
 | `models?` | `string[]` | Seed/fallback model list. With `liveModels: false`, a nonempty `models` list is followed by `retainModels`; an empty or omitted `models` list instead seeds `defaultModel` (if configured), then `retainModels`, removing duplicate ids in first-seen order. |
 | `liveModels?` | `boolean` | Fetch the live catalog on start/sync (default `true`). Custom providers use `${baseUrl}/models`; built-ins may use a registry URL and filter. |
-| `selectedModels?` | `string[]` | Catalog allowlist after discovery. Non-empty exposes only those ids; empty or omitted exposes all discovered models. |
+| `selectedModels?` | `string[]` | Post-discovery allowlist. Non-empty exposes only those ids; empty or omitted adds no allowlist. Discovery policy and `disabledModels` still apply. |
 | `retainModels?` | `string[]` | Ids kept in the catalog even when live discovery omits them. They need not be repeated in `models`. Empty or omitted keeps today's behavior. |
 | `modelDisplayNames?` | `Record<string, string>` | Durable labels used only for display, keyed by this provider's exact upstream model id. Labels win over provider catalog metadata, survive discovery refreshes and provider edits, and never change authentication, adapter behavior, routing, billing, upstream request construction, the routed `provider/model` selector, or the upstream wire model. Keys are exact and case sensitive. Unknown model ids are kept so a temporarily missing model receives its label when it returns. The map accepts at most 2,000 entries, matching the discovery limit. |
 | `contextWindow?` | `number` | Provider-wide context fallback when upstream metadata is absent; otherwise a cap that retains smaller live metadata. The Models dashboard exposes this separately from `providerContextCaps`. |