@wuyaos/pi-model-config 0.1.5 → 0.1.7

package/model-config.schema.json

@@ -192,6 +192,14 @@
           },
           "uniqueItems": true
         },
+        "hiddenRemoteIds": {
+          "description": "Remote catalog model IDs hidden by the user across discovery refreshes.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
         "models": {
           "type": "array",
           "items": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuyaos/pi-model-config",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "description": "Pi provider 连接、远程发现与 chat/classifier/image 模型配置 TUI",
   "keywords": [

package/src/command.ts

@@ -18,6 +18,7 @@ import {
   showPreviewPanel,
   showProviderPanel,
   showConfirmationPanel,
+  showRestoreHiddenPanel,
   type MenuPanelState,
   type OverviewPanelState,
   type PanelItem,
@@ -36,7 +37,7 @@ import type {
   ProviderConnectionConfig,
   ProviderDraft,
 } from "./types.ts";
-import { identityOf } from "./types.ts";
+import { hiddenRemoteKey, identityOf, isHiddenRemote, normalizeHiddenRemoteKeys } from "./types.ts";
 import { loadUiLanguage, saveUiLanguage } from "./ui-config.ts";
 import { secretInput, withCancellableLoader } from "./ui.ts";
 import { showModelTestFlow } from "./model-test.ts";
@@ -157,6 +158,7 @@ function draftFrom(providerId: string, provider: ModelsJsonProvider | undefined,
     classifierApi: config?.classifierApi ?? "typesafe-system-one",
     imageApi: config?.imageApi ?? "openrouter-images",
     defaultType: config?.defaultType ?? "chat",
+    hiddenRemoteIds: normalizeHiddenRemoteKeys(config?.hiddenRemoteIds ?? []),
   };
 }
 
@@ -248,9 +250,9 @@ function connectionPanelFields(language: UiLanguage, draft: ProviderDraft): Pane
   ];
 }
 
-async function editConnectionPanel(ctx: ExtensionCommandContext, language: UiLanguage, draft: ProviderDraft, state: MenuPanelState, canTakeover: boolean): Promise<"models" | "takeover" | "testModels" | "preview" | "back"> {
+async function editConnectionPanel(ctx: ExtensionCommandContext, language: UiLanguage, draft: ProviderDraft, state: MenuPanelState, canTakeover: boolean, hiddenRemoteCount: number): Promise<"models" | "takeover" | "restoreHidden" | "testModels" | "preview" | "back"> {
   while (true) {
-    const result = await showConnectionPanel(ctx, language, draft.id, connectionPanelFields(language, draft), state, canTakeover);
+    const result = await showConnectionPanel(ctx, language, draft.id, connectionPanelFields(language, draft), state, canTakeover, hiddenRemoteCount);
     if (result.action !== "field") return result.action;
     try {
       switch (result.fieldId) {
@@ -409,7 +411,9 @@ export function applyChanges(
   const originalRows = new Map(
     (oldProvider.models ?? []).filter((row) => typeof row.id === "string").map((row) => [row.id as string, row]),
   );
-  const managedScopeIds = new Set([...oldManagedIds, ...adoptedChatIds]);
+  // models.json rows are managed scope by default: selected rows are rewritten (merging
+  // unknown fields), unchecked rows are removed. Only rows without a string id are kept verbatim.
+  const managedScopeIds = new Set([...oldManagedIds, ...adoptedChatIds, ...originalRows.keys()]);
   const unmanagedRows = (oldProvider.models ?? []).filter((row) => typeof row.id !== "string" || !managedScopeIds.has(row.id));
   const selectedChat = selected.filter((model) => model.type === "chat");
   provider.models = [...unmanagedRows, ...selectedChat.map((model) => ({
@@ -422,8 +426,10 @@ export function applyChanges(
   if (draft.authMode === "models-json") provider.apiKey = draft.apiKeyRaw; else delete provider.apiKey;
   models.providers[providerId] = provider;
 
+  const normalizedHiddenRemoteIds = normalizeHiddenRemoteKeys(draft.hiddenRemoteIds ?? []);
+  const { hiddenRemoteIds: _oldHiddenRemoteIds, ...oldConfigWithoutHiddenRemoteIds } = oldConfig ?? {};
   config.providers[providerId] = {
-    ...(oldConfig ?? {}),
+    ...oldConfigWithoutHiddenRemoteIds,
     name: draft.name,
     owned: draft.owned,
     enabled: draft.enabled,
@@ -434,6 +440,7 @@ export function applyChanges(
     imageApi: draft.imageApi,
     defaultType: draft.defaultType,
     managedChatIds: selectedChat.map((model) => model.id),
+    ...(normalizedHiddenRemoteIds.length ? { hiddenRemoteIds: normalizedHiddenRemoteIds } : {}),
     models: selected.filter((model): model is Extract<ManagedModel, { type: "classifier" | "image" }> => model.type !== "chat"),
     modelMetadata: modelMetadata.map((entry) => structuredClone(entry)),
   };
@@ -512,6 +519,7 @@ export interface ProviderChoice {
   id: string;
   label: string;
   priority: number;
+  enabled: boolean;
 }
 
 export function buildConfiguredProviderChoices(
@@ -522,20 +530,21 @@ export function buildConfiguredProviderChoices(
 ): ProviderChoice[] {
   const ids = new Set([...Object.keys(models.providers), ...Object.keys(config.providers)]);
   const choices: ProviderChoice[] = [];
-  for (const id of ids) {
+  for (const id of [...ids].sort((a, b) => a.localeCompare(b))) {
     const owned = config.providers[id]?.owned === true;
     const builtin = builtinProviderIds.has(id);
     const name = config.providers[id]?.name ?? models.providers[id]?.name;
     const displayBase = name && name !== id ? `${name} (${id})` : id;
     const display = config.providers[id]?.enabled === false ? `${displayBase} · ${t(language, "providerDisabled")}` : displayBase;
     const status = t(language, builtin ? "providerTagBuiltin" : "providerTagCustom");
+    const enabled = config.providers[id]?.enabled !== false;
     choices.push(owned
-      ? { id, label: t(language, "providerLabelCustom", { display, status }), priority: 0 }
+      ? { id, label: t(language, "providerLabelCustom", { display, status }), priority: 0, enabled }
       : builtin
-        ? { id, label: t(language, "providerLabelBuiltin", { display, status }), priority: 1 }
-        : { id, label: t(language, "providerLabelCustom", { display, status }), priority: 2 });
+        ? { id, label: t(language, "providerLabelBuiltin", { display, status }), priority: 1, enabled }
+        : { id, label: t(language, "providerLabelCustom", { display, status }), priority: 2, enabled });
   }
-  return choices.sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id));
+  return choices.sort((a, b) => Number(b.enabled) - Number(a.enabled) || a.priority - b.priority || a.id.localeCompare(b.id));
 }
 
 function buildProviderPanelItems(
@@ -589,7 +598,7 @@ function buildProviderPanelItems(
 export function buildBuiltinProviderChoices(language: UiLanguage, builtinProviderIds: Iterable<string>): ProviderChoice[] {
   return [...new Set(builtinProviderIds)]
     .sort((a, b) => a.localeCompare(b))
-    .map((id) => ({ id, label: t(language, "providerLabelBuiltin", { display: id, status: t(language, "providerTagBuiltin") }), priority: 0 }));
+    .map((id) => ({ id, label: t(language, "providerLabelBuiltin", { display: id, status: t(language, "providerTagBuiltin") }), priority: 0, enabled: true }));
 }
 
 async function chooseBuiltinProvider(ctx: ExtensionCommandContext, language: UiLanguage): Promise<{ id: string; isNew: false } | undefined> {
@@ -655,6 +664,7 @@ function draftPanelItem(language: UiLanguage, draft: ProviderDraft, selected: Ma
     ],
     modelDetails: [
       t(language, "panelSummaryModels", { chat, classifier, image }),
+      ...(draft.hiddenRemoteIds?.length ? [t(language, "panelHiddenRemoteCount", { count: draft.hiddenRemoteIds.length })] : []),
       t(language, "detailFetchHint"),
       ...(adoptableCount ? [t(language, "panelTakeoverCount", { count: adoptableCount })] : []),
     ],
@@ -795,20 +805,50 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
           const draft = draftFrom(target.id, oldProvider, oldConfig, target.isNew);
           const baselineDraft = structuredClone(draft);
           const managedBefore = previousManaged(oldProvider, oldConfig);
-          const baselineSelected = structuredClone(managedBefore);
           const persistedMetadata = new Map((oldConfig?.modelMetadata ?? []).map((entry) => [`${entry.type}\0${entry.id}`, entry]));
-          let selectedMetadata: ModelMetadataEntry[] = managedBefore.map((model) => {
-            const stored = persistedMetadata.get(`${model.type}\0${model.id}`);
-            if (stored) return structuredClone(stored);
-            const raw = model.type === "chat" ? oldProvider?.models?.find((entry) => entry.id === model.id) : oldConfig?.models?.find((entry) => entry.type === model.type && entry.id === model.id);
-            const explicitThinkingMap = model.type === "chat" && typeof (raw as any)?.thinkingLevelMap === "object" && (raw as any).thinkingLevelMap !== null && !Array.isArray((raw as any).thinkingLevelMap);
-            return { type: model.type, id: model.id, contextSource: model.type === "image" ? undefined : typeof (raw as any)?.contextWindow === "number" ? "existing" : "compat", maxTokensSource: model.type === "chat" ? typeof (raw as any)?.maxTokens === "number" ? "existing" : "compat" : undefined, thinkingSource: explicitThinkingMap ? "existing" : undefined };
-          });
+          const parseConfig: ProviderConnectionConfig = oldConfig ?? {
+            authMode: draft.authMode === "temporary" ? "reuse-pi" : draft.authMode,
+            chatApi: draft.chatApi,
+          };
+          // models.json rows outside managedChatIds are directly editable and become
+          // managed on the next save; only runtime catalog rows stay read-only.
+          const managedChatIdSet = new Set(oldConfig?.managedChatIds ?? []);
+          const externalModels: ManagedModel[] = [];
+          const externalMetadata = new Map<string, ModelMetadataEntry>();
+          for (const raw of oldProvider?.models ?? []) {
+            if (typeof raw.id !== "string" || managedChatIdSet.has(raw.id)) continue;
+            const model = parseManagedChat(raw, oldProvider!, parseConfig, true);
+            if (!model) continue;
+            externalModels.push(model);
+            const explicitMap = typeof raw.thinkingLevelMap === "object" && raw.thinkingLevelMap !== null && !Array.isArray(raw.thinkingLevelMap);
+            externalMetadata.set(model.id, persistedMetadata.get(`${model.type}\0${model.id}`) ?? {
+              type: model.type,
+              id: model.id,
+              contextSource: model.type === "image" ? undefined : typeof raw.contextWindow === "number" ? "existing" : "compat",
+              maxTokensSource: model.type === "chat" ? typeof raw.maxTokens === "number" ? "existing" : "compat" : undefined,
+              thinkingSource: model.type === "chat" ? explicitMap ? "existing" as const : protocolThinkingMap(model.api) ? "protocol" as const : undefined : undefined,
+            });
+          }
+          const metadataEntryFor = (model: ManagedModel, raw: Record<string, unknown> | undefined, fallback: ModelMetadataEntry | undefined): ModelMetadataEntry => fallback ?? {
+            type: model.type,
+            id: model.id,
+            contextSource: model.type === "image" ? undefined : typeof raw?.contextWindow === "number" ? "existing" : "compat",
+            maxTokensSource: model.type === "chat" ? typeof raw?.maxTokens === "number" ? "existing" : "compat" : undefined,
+            thinkingSource: model.type === "chat" && typeof raw?.thinkingLevelMap === "object" && raw.thinkingLevelMap !== null && !Array.isArray(raw.thinkingLevelMap) ? "existing" as const : undefined,
+          };
+          let selectedMetadata: ModelMetadataEntry[] = [
+            ...managedBefore.map((model) => {
+              const raw = model.type === "chat" ? oldProvider?.models?.find((entry) => entry.id === model.id) : oldConfig?.models?.find((entry) => entry.type === model.type && entry.id === model.id);
+              return structuredClone(metadataEntryFor(model, raw as Record<string, unknown> | undefined, persistedMetadata.get(`${model.type}\0${model.id}`)));
+            }),
+            ...externalModels.map((model) => structuredClone(externalMetadata.get(model.id)!)),
+          ];
+          const baselineSelected = structuredClone([...managedBefore, ...externalModels]);
           const baselineMetadata = structuredClone(selectedMetadata);
 
-          let selectedDraft = structuredClone(managedBefore);
-          const adoptedChatIds = new Set<string>();
+          let selectedDraft = structuredClone(baselineSelected);
           let cachedRemote: CandidateModel[] = [];
+          let fetchInFlight = false;
           let page: "connection" | "model" | "preview" = "connection";
           let previewOrigin: "connection" | "model" = "model";
           const connectionState: MenuPanelState = { focus: "list", actionIndex: 0, detailScroll: 0 };
@@ -816,18 +856,14 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
           const previewState: MenuPanelState = { selectedId: "provider", focus: "list", actionIndex: 0, detailScroll: 0 };
           activeSecrets.push(draft.apiKeyRaw);
 
-          const adoptableIds = () => {
-            const alreadyManaged = new Set(oldConfig?.managedChatIds ?? []);
-            return (oldProvider?.models ?? [])
-              .filter((model) => typeof model.id === "string" && !alreadyManaged.has(model.id) && !adoptedChatIds.has(model.id))
-              .map((model) => model.id as string);
-          };
+          const adoptableIds = () => externalModels
+            .filter((model) => !selectedDraft.some((selected) => selected.id === model.id && selected.type === model.type))
+            .map((model) => model.id);
           const selectionFingerprint = (models: ManagedModel[]) => JSON.stringify([...models].sort((a, b) => identityOf(a, target.id).localeCompare(identityOf(b, target.id))));
           const metadataFingerprint = (entries: ModelMetadataEntry[]) => JSON.stringify([...entries].sort((a, b) => `${a.type}\0${a.id}`.localeCompare(`${b.type}\0${b.id}`)));
           const isDirty = () => JSON.stringify(draft) !== JSON.stringify(baselineDraft)
             || selectionFingerprint(selectedDraft) !== selectionFingerprint(baselineSelected)
-            || metadataFingerprint(selectedMetadata) !== metadataFingerprint(baselineMetadata)
-            || adoptedChatIds.size > 0;
+            || metadataFingerprint(selectedMetadata) !== metadataFingerprint(baselineMetadata);
           const preparePreview = async (): Promise<boolean> => {
             if (draft.authMode === "temporary") {
               ctx.ui.notify(t(language, "temporarySaveBlocked"), "warning");
@@ -835,7 +871,7 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
             }
             try { validateSelection(draft, selectedDraft, installedModels(ctx, target.id), oldProvider); }
             catch (error) { ctx.ui.notify(displayError(language, error, activeSecrets), "error"); return false; }
-            if ((managedBefore.length > 0 || adoptedChatIds.size > 0) && selectedDraft.length === 0) {
+            if (baselineSelected.length > 0 && selectedDraft.length === 0) {
               const empty = await showConfirmationPanel(ctx, {
                 title: t(language, "emptyTitle"), summary: [t(language, "emptyBody")], severity: "error",
                 defaultActionIndex: 0, cancelActionId: "cancel",
@@ -849,10 +885,11 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
             return true;
           };
           const adoptExisting = async (): Promise<boolean> => {
-            const ids = adoptableIds();
-            if (!ids.length) { ctx.ui.notify(t(language, "takeoverModelsNone"), "info"); return false; }
+            const selectedKeys = new Set(selectedDraft.map((model) => identityOf(model, target.id)));
+            const missing = externalModels.filter((model) => !selectedKeys.has(identityOf(model, target.id)));
+            if (!missing.length) { ctx.ui.notify(t(language, "takeoverModelsNone"), "info"); return false; }
             const action = await showConfirmationPanel(ctx, {
-              title: t(language, "takeoverModelsTitle"), summary: [t(language, "takeoverModelsBody", { provider: target.id, count: ids.length })],
+              title: t(language, "takeoverModelsTitle"), summary: [t(language, "takeoverModelsBody", { provider: target.id, count: missing.length })],
               details: [t(language, "diffSafety")], severity: "warning", defaultActionIndex: 0, cancelActionId: "cancel",
               actions: [
                 { id: "cancel", label: t(language, "confirmCancel") },
@@ -860,26 +897,25 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
               ],
             });
             if (action !== "confirm") return false;
-            const parseConfig: ProviderConnectionConfig = oldConfig ?? {
-              authMode: draft.authMode === "temporary" ? "reuse-pi" : draft.authMode,
-              chatApi: draft.chatApi,
-            };
-            const selectedKeys = new Set(selectedDraft.map((model) => identityOf(model, target.id)));
-            for (const raw of oldProvider?.models ?? []) {
-              if (typeof raw.id !== "string" || !ids.includes(raw.id)) continue;
-              const model = parseManagedChat(raw, oldProvider!, parseConfig, true);
-              if (model && !selectedKeys.has(identityOf(model, target.id))) selectedDraft.push(model);
-              adoptedChatIds.add(raw.id);
+            for (const model of missing) {
+              selectedDraft.push(structuredClone(model));
+              const metadata = externalMetadata.get(model.id)!;
+              if (!selectedMetadata.some((entry) => entry.type === metadata.type && entry.id === metadata.id)) selectedMetadata.push(structuredClone(metadata));
             }
             return true;
           };
 
           providerSession: while (true) {
             if (page === "connection") {
-              const connection = await editConnectionPanel(ctx, language, draft, connectionState, adoptableIds().length > 0);
+              const connection = await editConnectionPanel(ctx, language, draft, connectionState, adoptableIds().length > 0, draft.hiddenRemoteIds?.length ?? 0);
               activeSecrets.push(draft.apiKeyRaw, draft.temporaryKey);
               if (connection === "models") { page = "model"; continue; }
               if (connection === "takeover") { if (await adoptExisting()) page = "model"; continue; }
+              if (connection === "restoreHidden") {
+                const restored = await showRestoreHiddenPanel(ctx, language, draft.hiddenRemoteIds ?? []);
+                if (restored.action === "apply") draft.hiddenRemoteIds = (draft.hiddenRemoteIds ?? []).filter((key) => !restored.restored.includes(key));
+                continue;
+              }
               if (connection === "testModels") {
                 if (!draft.enabled) { ctx.ui.notify(t(language, "testProviderDisabled"), "warning"); continue; }
                 if (draft.authMode === "temporary" || isDirty()) { ctx.ui.notify(t(language, "testDraftDirty"), "warning"); continue; }
@@ -911,32 +947,15 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
             if (page === "model") {
               const installedRaw = installedModels(ctx, target.id);
               const installed = installedRaw.map(candidateFromInstalled);
-              const managedChatIds = new Set(oldConfig?.managedChatIds ?? []);
-              const parseConfig: ProviderConnectionConfig = oldConfig ?? {
-                authMode: draft.authMode === "temporary" ? "reuse-pi" : draft.authMode,
-                chatApi: draft.chatApi,
-              };
-              const external = (oldProvider?.models ?? [])
-                .filter((model) => typeof model.id === "string" && !managedChatIds.has(model.id))
-                .map((model) => parseManagedChat(model, oldProvider!, parseConfig, adoptedChatIds.has(typeof model.id === "string" ? model.id : "")))
-                .filter((model): model is ManagedModel => model !== undefined)
-                .map((model) => {
-                  const raw = oldProvider?.models?.find((entry) => entry.id === model.id);
-                  const explicitMap = typeof raw?.thinkingLevelMap === "object" && raw.thinkingLevelMap !== null && !Array.isArray(raw.thinkingLevelMap);
-                  const defaultThinkingSource = model.type === "chat"
-                    ? explicitMap ? "existing" as const : adoptedChatIds.has(model.id) && protocolThinkingMap(model.api) ? "protocol" as const : undefined
-                    : undefined;
-                  const metadata = persistedMetadata.get(`${model.type}\0${model.id}`) ?? { type: model.type, id: model.id, contextSource: model.type === "image" ? undefined : "compat", maxTokensSource: model.type === "chat" ? "compat" : undefined, thinkingSource: defaultThinkingSource };
-                  return adoptedChatIds.has(model.id) ? candidateFromManaged(model, metadata) : candidateFromExternal(model, metadata);
-                });
-              const candidates = mergeCandidates(target.id, [...external, ...installed], managedBefore.map((model) => candidateFromManaged(model, persistedMetadata.get(`${model.type}\0${model.id}`))), cachedRemote);
+              const external = externalModels.map((model) => candidateFromExternal(model, externalMetadata.get(model.id)));
+              const visibleRemote = cachedRemote.filter((model) => !isHiddenRemote(model, draft.hiddenRemoteIds ?? []));
+              const candidates = mergeCandidates(target.id, [...external, ...installed], managedBefore.map((model) => candidateFromManaged(model, persistedMetadata.get(`${model.type}\0${model.id}`))), visibleRemote);
               const selection = await selectModels(ctx, language, target.id, draft, candidates, selectedDraft, modelState, selectedMetadata);
               selectedDraft = selection.selected;
               selectedMetadata = selection.metadata.map((entry) => ({ ...(selectedMetadata.find((old) => old.type === entry.type && old.id === entry.id) ?? {}), ...entry }));
               if (selection.action === "back") { page = "connection"; continue; }
               if (selection.action === "edit") {
                 const editTarget = selection.target;
-                if (editTarget?.readOnlyReason === "external-config") { ctx.ui.notify(t(language, "editorExternalTakeover"), "warning"); continue; }
                 const managedIndex = editTarget ? selectedDraft.findIndex((model) => model.id === editTarget.id && model.type === editTarget.type) : -1;
                 if (managedIndex < 0) { ctx.ui.notify(t(language, "editorManagedOnly"), "warning"); continue; }
                 const model = selectedDraft[managedIndex]!;
@@ -983,6 +1002,9 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
                 continue;
               }
               if (selection.action === "fetch") {
+                if (fetchInFlight) continue;
+                fetchInFlight = true;
+                try {
                 const fallbackBases = [
                   ...(oldProvider?.models ?? []).map((model) => typeof model.baseUrl === "string" ? model.baseUrl : undefined),
                   ...installedRaw.map((model) => model.baseUrl),
@@ -1025,6 +1047,7 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
                 draft.discoveryUrl = result.value!.url;
                 cachedRemote = [...result.value!.models];
                 continue;
+                } finally { fetchInFlight = false; }
               }
               if (await preparePreview()) { previewOrigin = "model"; page = "preview"; }
               continue;
@@ -1045,12 +1068,9 @@ export function registerModelConfigCommand(pi: ExtensionAPI, startupIssues: Star
               if (discard === "discard") continue mainLoop;
               continue;
             }
-            const compatItems = selectedMetadata.filter((entry) => entry.contextSource === "compat" || entry.maxTokensSource === "compat").map((entry) => entry.type + '/' + entry.id);
-            const risk = compatItems.length ? [t(language, "compatSaveRisk", { items: compatItems.join(", ") })] : [];
-            const confirmed = await confirmAction(ctx, language, t(language, "finalSaveTitle"), [t(language, "finalSaveBody"), ...risk], [...details.providerDetails, ...details.modelDetails], t(language, "confirmSave"));
-            if (!confirmed) continue;
+            // Preview is the sole save confirmation: Ctrl+S there commits the reviewed draft.
             try {
-              const next = applyChanges(files, target.id, draft, selectedDraft, adoptedChatIds, selectedMetadata);
+              const next = applyChanges(files, target.id, draft, selectedDraft, new Set(externalModels.map((model) => model.id)), selectedMetadata);
               const transaction = writeConfigTransaction(files.modelsSnapshot, files.configSnapshot, next.models, next.config);
               ctx.ui.notify(t(language, "saveSuccess", { count: transaction.backups.length }), "info");
               continue mainLoop;

package/src/config.ts

@@ -72,6 +72,7 @@ export function parseModelConfig(source: ConfigSnapshot): ModelConfigFile {
     if (provider.imageApi !== undefined && !IMAGE_API_NAMES.includes(String(provider.imageApi) as typeof IMAGE_API_NAMES[number])) {
       throw mcError("MCFG_E_UNSUPPORTED_API", { identity: `${id}/image`, api: String(provider.imageApi) });
     }
+    if (provider.hiddenRemoteIds !== undefined && (!Array.isArray(provider.hiddenRemoteIds) || provider.hiddenRemoteIds.some((modelId) => typeof modelId !== "string"))) throw mcError("MCFG_E_PROVIDER_SHAPE", { file: "model-config.json", provider: id });
     if (provider.models !== undefined && !Array.isArray(provider.models)) throw mcError("MCFG_E_MODELS_ARRAY", { file: "model-config.json", provider: id });
     if (Array.isArray(provider.models) && provider.models.some((model) => !isRecord(model))) throw mcError("MCFG_E_MODELS_ARRAY", { file: "model-config.json", provider: id });
     for (const model of Array.isArray(provider.models) ? provider.models : []) {

package/src/i18n.ts

@@ -12,7 +12,7 @@ const ZH = {
   languageEn: "English",
   languageSaved: "界面语言已保存：{language}（立即生效）",
   tuiRequired: "/model-config 需要交互式 TUI；RPC/print/json 模式不支持自定义多选界面",
-  startupIssues: "部分服务商因配置错误未注册，可继续编辑：{issues}{more}",
+  startupIssues: "部分服务商/模型条目存在配置问题（无效条目已跳过，可继续编辑修复）：{issues}{more}",
   startupMore: "；另有 {count} 项",
   newProviderTitle: "选择内置服务商（内置不代表已认证或可用）",
   providerTagCustom: "自定义",
@@ -38,9 +38,16 @@ const ZH = {
   detailConnectionTitle: "连接摘要",
   detailModelsTitle: "模型概况",
   detailFetchHint: "进入“配置模型”后按 Ctrl+R 获取远程模型列表",
+  detailRestoreHidden: "[Ctrl+H] 恢复隐藏模型（{count}）",
+  panelHiddenRemoteCount: "已隐藏远程模型：{count}",
+  restoreHiddenTitle: "恢复隐藏远程模型",
+  restoreHiddenItemDetail: "勾选后恢复到后续远程获取结果；保存前仅修改内存草稿。",
+  restoreHiddenAll: "[Ctrl+A] 全部恢复",
+  restoreHiddenApply: "[Ctrl+S] 应用恢复",
+  restoreHiddenBack: "[Esc] 返回",
   detailEditConnection: "[Ctrl+E] 编辑连接",
   detailConfigureModels: "[Ctrl+M] 配置模型",
-  detailTakeover: "[Ctrl+T] 接管已有模型",
+  detailTakeover: "[Ctrl+T] 全选并纳入管理",
   detailDisable: "[Ctrl+X] 禁用服务商",
   detailEnable: "[Ctrl+X] 启用服务商",
   detailTestModels: "[Ctrl+P] 批量测试模型",
@@ -95,11 +102,11 @@ const ZH = {
   modelDeselectFiltered: "[Ctrl+D] 取消勾选搜索结果",
   modelCycleType: "[Ctrl+T] 切换模型类型",
   modelEditParameters: "[Ctrl+E] 编辑模型参数",
-  editorExternalTakeover: "此模型来自 models.json；请先在连接页执行“接管已有模型”后再编辑",
-  editorManagedOnly: "仅当前草稿中已勾选、由本插件管理的模型可编辑参数",
+  editorManagedOnly: "仅当前草稿中已勾选的模型可编辑参数；请先勾选再编辑",
   modelProbeContext: "[Ctrl+K] 探测上下文容量",
   modelProbeThinking: "[Ctrl+L] 探测思考档位",
   modelFetch: "[Ctrl+R] 获取远程模型列表",
+  modelHideRemote: "[Ctrl+Del] 隐藏远程模型",
   modelPreview: "[Ctrl+S] 预览更改",
   modelBack: "[Esc] 返回服务商",
   addProviderTitle: "添加服务商",
@@ -112,7 +119,7 @@ const ZH = {
   discoveryRequiredEdit: "进入编辑连接设置",
   discoveryRequiredCancel: "取消获取",
   dirtyLeaveTitle: "放弃尚未保存的更改？",
-  dirtyLeaveBody: "返回总览会放弃当前服务商的连接草稿、模型选择和接管状态；不会写入配置。",
+  dirtyLeaveBody: "返回总览会放弃当前服务商的连接草稿和模型选择；不会写入配置。",
   confirmCancel: "[Esc] 取消/返回",
   confirmSave: "[Ctrl+S] 确认保存",
   confirmEmpty: "[Ctrl+S] 确认清空",
@@ -178,7 +185,7 @@ const ZH = {
   panelSummaryAuth: "认证方式：{value}",
   panelSummaryProxy: "专属代理：{value}",
   panelSummaryModels: "模型：聊天 {chat} · 判定 {classifier} · 图像生成 {image}",
-  panelTakeoverCount: "尚未接管的 models.json chat：{count}",
+  panelTakeoverCount: "尚未纳入管理的 models.json chat：{count}",
   panelDescName: "设置界面显示名称；不会改变服务商 ID。",
   panelDescId: "配置标识，只读。provider/model identity 使用此 ID。",
   panelDescOwnership: "决定 classifier/image 是否由本插件注册；不要接管 Pi 内置服务商。",
@@ -222,11 +229,10 @@ const ZH = {
   probeMaxConflict: "探测下限小于当前maxTokens；不会自动调整maxTokens，请等待逐模型参数编辑功能",
   panelModelBaseUrl: "Base URL：{value}",
   panelModelReadonly: "此模型只读，不能在这里修改或移除。",
-  panelModelReadonlyExternal: "此模型来自 models.json，但尚未由本插件管理；可先执行“接管已有模型”。",
   panelModelReadonlyRuntime: "此模型来自 Pi 内置目录或其他运行时扩展；本插件不能把取消勾选伪装成删除。",
-  takeoverModelsTitle: "接管已有模型？",
-  takeoverModelsBody: "仅接管服务商 {provider} 在 models.json 中已有的 {count} 个 chat 模型。接管只修改内存草稿；取消、返回或放弃不会写盘，最终确认保存后才更新 managedChatIds。Pi 内置目录和其他运行时扩展模型不在接管范围。",
-  takeoverModelsNone: "当前服务商没有可接管的 models.json chat 模型",
+  takeoverModelsTitle: "全选 models.json 模型？",
+  takeoverModelsBody: "将勾选服务商 {provider} 在 models.json 中尚未勾选的 {count} 个模型，并在最终保存后纳入 managedChatIds。此操作只修改内存草稿；取消、返回或放弃不会写盘。Pi 内置目录和其他运行时扩展模型不在范围。",
+  takeoverModelsNone: "当前服务商没有未勾选的 models.json 模型",
   previewConfirmSave: "[Ctrl+S] 确认保存",
   previewBackEdit: "[Esc] 返回继续编辑",
   previewDiscard: "[Ctrl+D] 放弃全部更改",
@@ -311,10 +317,10 @@ const ZH = {
   selectorNarrow: "终端过窄；请扩宽后重试，Esc 返回",
   selectorNoMatches: "  没有匹配的模型",
   selectorReadonlyStatus: "此模型不由本插件管理，当前不能在这里修改或移除",
-  selectorReadonlyExternal: "此模型来自 models.json，需先使用“接管已有模型”后才能修改或移除",
   selectorReadonlyRuntime: "此模型来自 Pi 内置目录或其他运行时扩展，不能在这里移除",
   selectorTypeConflict: "不能切换为{type}：{identity} 已存在",
   selectorReadonlyTag: "只读",
+  selectorRemoteHidden: "已隐藏远程模型 {id}；保存后后续获取也会隐藏",
   selectorTypeChat: "聊天",
   selectorTypeClassifier: "判定",
   selectorTypeImage: "图像生成",
@@ -349,7 +355,7 @@ const EN = {
   languageEn: "English",
   languageSaved: "UI language saved: {language} (effective immediately)",
   tuiRequired: "/model-config requires the interactive TUI; custom multi-select is unavailable in RPC/print/JSON modes",
-  startupIssues: "Some providers were not registered because of configuration errors. You can continue editing: {issues}{more}",
+  startupIssues: "Some providers/model entries have configuration problems (invalid entries were skipped; keep editing to fix): {issues}{more}",
   startupMore: "; {count} more",
   newProviderTitle: "Choose a Built-in Provider (built-in does not mean authenticated or available)",
   providerTagCustom: "Custom",
@@ -375,9 +381,16 @@ const EN = {
   detailConnectionTitle: "Connection Summary",
   detailModelsTitle: "Model Overview",
   detailFetchHint: "Open Configure models, then press Ctrl+R to fetch the remote model list",
+  detailRestoreHidden: "[Ctrl+H] Restore hidden models ({count})",
+  panelHiddenRemoteCount: "Hidden remote models: {count}",
+  restoreHiddenTitle: "Restore hidden remote models",
+  restoreHiddenItemDetail: "Checked entries return to future remote fetch results; this only changes the in-memory draft until save.",
+  restoreHiddenAll: "[Ctrl+A] Restore all",
+  restoreHiddenApply: "[Ctrl+S] Apply restore",
+  restoreHiddenBack: "[Esc] Back",
   detailEditConnection: "[Ctrl+E] Edit connection",
   detailConfigureModels: "[Ctrl+M] Configure models",
-  detailTakeover: "[Ctrl+T] Manage existing models",
+  detailTakeover: "[Ctrl+T] Select all and manage",
   detailDisable: "[Ctrl+X] Disable provider",
   detailEnable: "[Ctrl+X] Enable provider",
   detailTestModels: "[Ctrl+P] Batch test models",
@@ -432,11 +445,11 @@ const EN = {
   modelDeselectFiltered: "[Ctrl+D] Uncheck search results",
   modelCycleType: "[Ctrl+T] Change model type",
   modelEditParameters: "[Ctrl+E] Edit model parameters",
-  editorExternalTakeover: "This model comes from models.json. Use Manage existing models on the connection page before editing it.",
-  editorManagedOnly: "Only checked models managed by this plugin in the current draft can be edited",
+  editorManagedOnly: "Only checked models in the current draft can be edited; check the row first",
   modelProbeContext: "[Ctrl+K] Probe context capacity",
   modelProbeThinking: "[Ctrl+L] Probe thinking levels",
   modelFetch: "[Ctrl+R] Fetch remote model list",
+  modelHideRemote: "[Ctrl+Del] Hide remote model",
   modelPreview: "[Ctrl+S] Preview changes",
   modelBack: "[Esc] Back to provider",
   addProviderTitle: "Add Provider",
@@ -449,7 +462,7 @@ const EN = {
   discoveryRequiredEdit: "Open connection settings",
   discoveryRequiredCancel: "Cancel fetch",
   dirtyLeaveTitle: "Discard unsaved changes?",
-  dirtyLeaveBody: "Returning to the overview discards this provider's connection draft, model selection, and takeover state. Nothing will be written.",
+  dirtyLeaveBody: "Returning to the overview discards this provider's connection draft and model selection. Nothing will be written.",
   confirmCancel: "[Esc] Cancel / Back",
   confirmSave: "[Ctrl+S] Confirm Save",
   confirmEmpty: "[Ctrl+S] Confirm Empty",
@@ -515,7 +528,7 @@ const EN = {
   panelSummaryAuth: "Authentication: {value}",
   panelSummaryProxy: "Provider-only proxy: {value}",
   panelSummaryModels: "Models: Chat {chat} · Classification {classifier} · Image generation {image}",
-  panelTakeoverCount: "Unmanaged models.json chat models: {count}",
+  panelTakeoverCount: "models.json chat models not yet managed: {count}",
   panelDescName: "Set the display name without changing the provider ID.",
   panelDescId: "Read-only configuration identity used by provider/model identities.",
   panelDescOwnership: "Controls classifier/image registration. Never take ownership of a Pi built-in provider.",
@@ -559,11 +572,10 @@ const EN = {
   probeMaxConflict: "The probe lower bound is below current maxTokens. maxTokens will not be changed automatically; wait for per-model parameter editing.",
   panelModelBaseUrl: "Base URL: {value}",
   panelModelReadonly: "This model is read-only and cannot be changed or removed here.",
-  panelModelReadonlyExternal: "This model is in models.json but is not managed by this plugin yet; use Manage existing models first.",
   panelModelReadonlyRuntime: "This model comes from Pi's built-in catalog or another runtime extension; unchecking it cannot be presented as deletion.",
-  takeoverModelsTitle: "Manage existing models?",
-  takeoverModelsBody: "This takes ownership only of the {count} existing chat model(s) for provider {provider} in models.json. It changes the in-memory draft only; cancel, back, or discard writes nothing. managedChatIds changes only after final save. Pi built-in catalogs and other runtime-extension models are outside this scope.",
-  takeoverModelsNone: "This provider has no models.json chat models available for takeover",
+  takeoverModelsTitle: "Select all models.json models?",
+  takeoverModelsBody: "This checks the {count} unchecked model(s) of provider {provider} in models.json and includes them in managedChatIds after the final save. It changes the in-memory draft only; cancel, back, or discard writes nothing. Pi built-in catalogs and other runtime-extension models are outside this scope.",
+  takeoverModelsNone: "This provider has no unchecked models.json models",
   previewConfirmSave: "[Ctrl+S] Confirm Save",
   previewBackEdit: "[Esc] Back to Editing",
   previewDiscard: "[Ctrl+D] Discard All Changes",
@@ -648,10 +660,10 @@ const EN = {
   selectorNarrow: "Terminal too narrow; resize and retry, or press Esc to go back",
   selectorNoMatches: "  No matching models",
   selectorReadonlyStatus: "This model is not managed by this plugin and cannot be changed or removed here",
-  selectorReadonlyExternal: "This model comes from models.json; use Manage existing models before changing or removing it",
   selectorReadonlyRuntime: "This model comes from Pi's built-in catalog or another runtime extension and cannot be removed here",
   selectorTypeConflict: "Cannot change to {type}: {identity} already exists",
   selectorReadonlyTag: "read-only",
+  selectorRemoteHidden: "Remote model {id} is hidden and will remain hidden after saving and future fetches",
   selectorTypeChat: "Chat",
   selectorTypeClassifier: "Classification",
   selectorTypeImage: "Image generation",

package/src/image-apis/common.ts

@@ -130,13 +130,13 @@ function privateHostname(hostname: string): boolean {
     const low = Number.parseInt(mappedHex[2]!, 16);
     normalized = `${high >>> 8}.${high & 0xff}.${low >>> 8}.${low & 0xff}`;
   }
-  if (normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "::1" || normalized === "0:0:0:0:0:0:0:1") return true;
+  if (normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "::" || normalized === "0:0:0:0:0:0:0:0" || normalized === "::1" || normalized === "0:0:0:0:0:0:0:1") return true;
   const ipv4 = normalized.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/u)?.slice(1).map(Number);
   if (ipv4 && ipv4.every((part) => part >= 0 && part <= 255)) {
     const [a, b] = ipv4;
     return a === 0 || a === 10 || a === 127 || a === 100 && b >= 64 && b <= 127 || a === 169 && b === 254 || a === 172 && b >= 16 && b <= 31 || a === 192 && b === 168;
   }
-  return normalized.startsWith("fc") || normalized.startsWith("fd") || normalized.startsWith("fe80:");
+  return normalized.startsWith("fc") || normalized.startsWith("fd") || /^(?:fe8|fe9|fea|feb)[0-9a-f]:/u.test(normalized);
 }
 
 export function validatePublicImageUrl(value: string): URL {

package/src/panel.ts

@@ -43,7 +43,7 @@ export type ProviderPanelResult =
 
 export type ConnectionPanelResult =
   | { action: "field"; fieldId: string }
-  | { action: "models" | "takeover" | "testModels" | "preview" | "back" };
+  | { action: "models" | "takeover" | "restoreHidden" | "testModels" | "preview" | "back" };
 
 export type PreviewPanelResult = { action: "save" | "back" | "discard" };
 
@@ -434,11 +434,13 @@ export async function showConnectionPanel(
   fields: PanelItem[],
   state: MenuPanelState = { focus: "list", actionIndex: 0, detailScroll: 0 },
   canTakeover = false,
+  hiddenRemoteCount = 0,
 ): Promise<ConnectionPanelResult> {
   const actions: FooterAction[] = [
     { id: "edit", label: t(language, "connectionModify"), key: Key.enter },
     { id: "models", label: t(language, "detailConfigureModels"), key: Key.ctrl("m") },
     ...(canTakeover ? [{ id: "takeover", label: t(language, "detailTakeover"), key: Key.ctrl("t") }] : []),
+    ...(hiddenRemoteCount > 0 ? [{ id: "restoreHidden", label: t(language, "detailRestoreHidden", { count: hiddenRemoteCount }), key: Key.ctrl("h") }] : []),
     { id: "testModels", label: t(language, "detailTestModels"), key: Key.ctrl("p") },
     { id: "preview", label: t(language, "connectionPreview"), key: Key.ctrl("s") },
     { id: "back", label: t(language, "connectionBack"), key: Key.escape },
@@ -448,10 +450,33 @@ export async function showConnectionPanel(
   if (result.kind === "back" || result.id === "back") return { action: "back" };
   if (result.kind === "item" && result.id) return { action: "field", fieldId: result.id };
   if (result.id === "edit" && state.selectedId) return { action: "field", fieldId: state.selectedId };
-  if (result.id === "models" || result.id === "takeover" || result.id === "testModels" || result.id === "preview") return { action: result.id };
+  if (result.id === "models" || result.id === "takeover" || result.id === "restoreHidden" || result.id === "testModels" || result.id === "preview") return { action: result.id };
   return { action: "back" };
 }
 
+export async function showRestoreHiddenPanel(
+  ctx: ExtensionCommandContext,
+  language: UiLanguage,
+  hiddenKeys: string[],
+  state: MenuPanelState = { focus: "list", actionIndex: 0, detailScroll: 0 },
+): Promise<{ action: "apply" | "back"; restored: string[] }> {
+  const selected = new Set<string>();
+  const actions: FooterAction[] = [
+    { id: "all", label: t(language, "restoreHiddenAll"), key: Key.ctrl("a") },
+    { id: "apply", label: t(language, "restoreHiddenApply"), key: Key.ctrl("s") },
+    { id: "back", label: t(language, "restoreHiddenBack"), key: Key.escape },
+  ];
+  while (true) {
+    const items = hiddenKeys.map((key) => ({ id: key, label: `${selected.has(key) ? "[✓]" : "[ ]"} ${key.replace("\u0000", "/")}`, details: [t(language, "restoreHiddenItemDetail")] }));
+    const result = await ctx.ui.custom<{ kind: "item" | "action" | "language" | "back"; id?: string }>((tui, theme, _keys, done) =>
+      new MenuDetailPanel(tui, theme, language, t(language, "restoreHiddenTitle"), items, actions, state, true, done), MODEL_CONFIG_OVERLAY_OPTIONS);
+    if (result.kind === "back" || result.id === "back") return { action: "back", restored: [] };
+    if (result.kind === "item" && result.id) { if (selected.has(result.id)) selected.delete(result.id); else selected.add(result.id); continue; }
+    if (result.id === "all") { for (const hiddenKey of hiddenKeys) selected.add(hiddenKey); continue; }
+    if (result.id === "apply") return { action: "apply", restored: [...selected] };
+  }
+}
+
 export async function showPreviewPanel(
   ctx: ExtensionCommandContext,
   language: UiLanguage,

package/src/runtime.ts

@@ -159,34 +159,61 @@ function normalizeChatModels(providerId: string, provider: ModelsJsonProvider, c
   }));
 }
 
-function validateRuntimeConfig(providerId: string, config: ProviderConnectionConfig, modelsProvider: ModelsJsonProvider | undefined): void {
+function validateRuntimeConfig(providerId: string, config: ProviderConnectionConfig, modelsProvider: ModelsJsonProvider | undefined, issues: ProviderRegistrationIssue[] = []): void {
   if (config.discoveryUrl) validateHttpUrl(config.discoveryUrl, `${providerId} Discovery URL`);
   if (config.proxyUrl) validateHttpUrl(config.proxyUrl, `${providerId}.proxyUrl`);
   const chatApis = new Set<string>();
   for (const model of modelsProvider?.models ?? []) {
-    if (typeof model.id !== "string" || !model.id) throw mcError("MCFG_E_MODEL_SHAPE", { file: "models.json", provider: providerId });
+    if (typeof model.id !== "string" || !model.id) {
+      issues.push({ providerId, error: mcError("MCFG_E_MODEL_SHAPE", { file: "models.json", provider: providerId }) });
+      continue;
+    }
     if (model.type === "classifier" || model.type === "image") {
-      throw mcError("MCFG_E_TYPE_API", { identity: `${providerId}/chat/${model.id}`, api: String(model.api ?? model.type) });
+      issues.push({ providerId, error: mcError("MCFG_E_TYPE_API", { identity: `${providerId}/chat/${model.id}`, api: String(model.api ?? model.type) }) });
+      continue;
     }
     const api = typeof model.api === "string" ? model.api : (modelsProvider?.api ?? config.chatApi ?? "openai-completions");
-    if (!CHAT_APIS.has(api)) throw mcError("MCFG_E_UNSUPPORTED_API", { identity: `${providerId}/chat/${model.id}`, api });
+    if (!CHAT_APIS.has(api)) {
+      issues.push({ providerId, error: mcError("MCFG_E_UNSUPPORTED_API", { identity: `${providerId}/chat/${model.id}`, api }) });
+      continue;
+    }
     chatApis.add(api);
-    if (config.owned) validateHttpUrl(String(model.baseUrl ?? modelsProvider?.baseUrl ?? ""), `${providerId}/${model.id} Base URL`);
-    if (config.owned && (typeof model.contextWindow !== "number" || typeof model.maxTokens !== "number")) throw mcError("MCFG_E_MODEL_SHAPE", { file: "models.json", provider: providerId });
+    // owned chat 缺失 context/max 由 normalizeChatModels 补 Pi 兼容默认（128000/16384），
+    // 不再作为错误阻断注册；来源标记在保存时记录为 compat。
+    if (config.owned) {
+      try { validateHttpUrl(String(model.baseUrl ?? modelsProvider?.baseUrl ?? ""), `${providerId}/${model.id} Base URL`); }
+      catch (error) { issues.push({ providerId, error }); continue; }
+    }
   }
   for (const model of config.models ?? []) {
     const supported = model.type === "classifier" ? CLASSIFIER_APIS : model.type === "image" ? IMAGE_APIS : undefined;
-    if (!supported) throw mcError("MCFG_E_MODEL_SHAPE", { file: "model-config.json", provider: providerId });
-    if (!supported.has(model.api)) throw mcError("MCFG_E_TYPE_API", { identity: `${providerId}/${model.type}/${model.id}`, api: model.api });
+    if (!supported) {
+      issues.push({ providerId, error: mcError("MCFG_E_MODEL_SHAPE", { file: "model-config.json", provider: providerId }) });
+      continue;
+    }
+    if (!supported.has(model.api)) {
+      issues.push({ providerId, error: mcError("MCFG_E_TYPE_API", { identity: `${providerId}/${model.type}/${model.id}`, api: model.api }) });
+      continue;
+    }
+    if (config.authMode === "anonymous" && model.type === "image" && SELF_IMAGE_APIS.has(model.api)) {
+      issues.push({ providerId, error: mcError("MCFG_E_ANONYMOUS_UNSUPPORTED", { identity: `${providerId}/image/${model.id}` }) });
+      continue;
+    }
+    if (config.owned && model.type === "classifier" && typeof model.contextWindow !== "number") {
+      issues.push({ providerId, error: mcError("MCFG_E_MODEL_SHAPE", { file: "model-config.json", provider: providerId }) });
+      continue;
+    }
     const effectiveBaseUrl = model.type === "image"
       ? resolveImageBaseUrl(model.api, model.baseUrl, modelsProvider?.baseUrl)
       : model.baseUrl ?? modelsProvider?.baseUrl;
-    if (config.owned && !effectiveBaseUrl) throw mcError("MCFG_E_BASE_URL_REQUIRED");
-    if (config.owned && effectiveBaseUrl) validateHttpUrl(effectiveBaseUrl, `${providerId}/${model.id} Base URL`);
-    if (config.authMode === "anonymous" && model.type === "image" && SELF_IMAGE_APIS.has(model.api)) {
-      throw mcError("MCFG_E_ANONYMOUS_UNSUPPORTED", { identity: `${providerId}/image/${model.id}` });
+    if (config.owned && !effectiveBaseUrl) {
+      issues.push({ providerId, error: mcError("MCFG_E_BASE_URL_REQUIRED") });
+      continue;
+    }
+    if (config.owned && effectiveBaseUrl) {
+      try { validateHttpUrl(effectiveBaseUrl, `${providerId}/${model.id} Base URL`); }
+      catch (error) { issues.push({ providerId, error }); continue; }
     }
-    if (config.owned && model.type === "classifier" && typeof model.contextWindow !== "number") throw mcError("MCFG_E_MODEL_SHAPE", { file: "model-config.json", provider: providerId });
   }
   if (!config.owned && (config.models?.length ?? 0) > 0) {
     throw mcError("MCFG_E_NOT_OWNED", { provider: providerId });
@@ -202,14 +229,17 @@ function validateRuntimeConfig(providerId: string, config: ProviderConnectionCon
 }
 
 function registerOwnedProvider(pi: ExtensionAPI, providerId: string, config: ProviderConnectionConfig, modelsProvider: ModelsJsonProvider, language: UiLanguage): void {
-  const chatModels = normalizeChatModels(providerId, modelsProvider, config);
-  const extraModels = (config.models ?? []).map((model) => ({
-    ...model,
-    provider: providerId,
-    baseUrl: model.type === "image"
-      ? resolveImageBaseUrl(model.api, model.baseUrl, modelsProvider.baseUrl) ?? ""
-      : model.baseUrl ?? modelsProvider.baseUrl ?? "",
-  }));
+  const chatModels = normalizeChatModels(providerId, modelsProvider, config)
+    .filter((model) => typeof model.id === "string" && model.id && CHAT_APIS.has(model.api) && typeof model.contextWindow === "number" && typeof model.maxTokens === "number");
+  const extraModels = (config.models ?? [])
+    .map((model) => ({
+      ...model,
+      provider: providerId,
+      baseUrl: model.type === "image"
+        ? resolveImageBaseUrl(model.api, model.baseUrl, modelsProvider.baseUrl) ?? ""
+        : model.baseUrl ?? modelsProvider.baseUrl ?? "",
+    }))
+    .filter((model) => typeof model.id === "string" && model.id && (model.type !== "classifier" || typeof model.contextWindow === "number"));
   const allModels = [...chatModels, ...extraModels];
   if (allModels.length === 0) return;
   const chatApis = new Set(chatModels.map((model) => model.api));
@@ -297,7 +327,7 @@ export function registerConfiguredProviders(
         registerDisabledProvider(pi, providerId, config, modelsProvider);
         continue;
       }
-      validateRuntimeConfig(providerId, config, modelsProvider);
+      validateRuntimeConfig(providerId, config, modelsProvider, issues);
       if (config.owned) {
         if (!modelsProvider) throw mcError("MCFG_E_OWNED_PROVIDER_MISSING", { provider: providerId });
         registerOwnedProvider(pi, providerId, config, modelsProvider, language);

package/src/selector.ts

@@ -15,7 +15,7 @@ import { t, type UiLanguage } from "./i18n.ts";
 import { COMPAT_CONTEXT_WINDOW, COMPAT_MAX_TOKENS } from "./discovery.ts";
 import { MODEL_CONFIG_OVERLAY_OPTIONS, overlayViewportRows, renderActionFooter, renderPanelBox, type FooterAction } from "./panel.ts";
 import type { CandidateModel, ManagedModel, ManagedModelType, ModelMetadataEntry, ProviderDraft, SelectionResult, ThinkingLevelMap, ThinkingMetadataSource } from "./types.ts";
-import { identityOf } from "./types.ts";
+import { hiddenRemoteKey, identityOf } from "./types.ts";
 import { protocolThinkingMap } from "./thinking-defaults.ts";
 import { describeThinking } from "./model-editor.ts";
 
@@ -76,8 +76,10 @@ export function candidateFromManaged(model: ManagedModel, metadata?: ModelMetada
   return { ...cloneManaged(model), source: "managed", mutableType: false, contextSource: metadata?.contextSource ?? (model.type === "image" ? undefined : "existing"), maxTokensSource: metadata?.maxTokensSource ?? (model.type === "chat" ? "existing" : undefined), thinkingSource: metadata?.thinkingSource ?? (model.type === "chat" && model.thinkingLevelMap ? "existing" : undefined) } as CandidateModel;
 }
 
+/** A models.json row belongs to this provider configuration and is immediately editable.
+ * It becomes managed on the next save; only runtime catalog rows remain read-only. */
 export function candidateFromExternal(model: ManagedModel, metadata?: ModelMetadataEntry): CandidateModel {
-  return { ...cloneManaged(model), source: "external", mutableType: false, contextSource: metadata?.contextSource ?? (model.type === "image" ? undefined : "existing"), maxTokensSource: metadata?.maxTokensSource ?? (model.type === "chat" ? "existing" : undefined), thinkingSource: metadata?.thinkingSource ?? (model.type === "chat" && model.thinkingLevelMap ? "existing" : undefined), readOnly: true, readOnlyReason: "external-config" } as CandidateModel;
+  return { ...cloneManaged(model), source: "external", mutableType: false, contextSource: metadata?.contextSource ?? (model.type === "image" ? undefined : "existing"), maxTokensSource: metadata?.maxTokensSource ?? (model.type === "chat" ? "existing" : undefined), thinkingSource: metadata?.thinkingSource ?? (model.type === "chat" && model.thinkingLevelMap ? "existing" : undefined) } as CandidateModel;
 }
 
 export function mergeCandidates(provider: string, installed: CandidateModel[], managed: CandidateModel[], remote: CandidateModel[]): CandidateModel[] {
@@ -206,7 +208,7 @@ class ModelSelector implements Component, Focusable {
     const row = this.filtered[this.index];
     if (!row) return;
     if (row.readOnly) {
-      this.status = t(this.language, row.readOnlyReason === "external-config" ? "selectorReadonlyExternal" : row.readOnlyReason === "runtime-catalog" ? "selectorReadonlyRuntime" : "selectorReadonlyStatus");
+      this.status = t(this.language, row.readOnlyReason === "runtime-catalog" ? "selectorReadonlyRuntime" : "selectorReadonlyStatus");
       this.tui.requestRender();
       return;
     }
@@ -216,6 +218,19 @@ class ModelSelector implements Component, Focusable {
     this.tui.requestRender();
   }
 
+  private hideCurrentRemote(): void {
+    const row = this.current();
+    if (!row || row.source !== "remote") return;
+    const hidden = new Set(this.draft.hiddenRemoteIds ?? []);
+    hidden.add(hiddenRemoteKey(row));
+    this.draft.hiddenRemoteIds = [...hidden].sort((a, b) => a.localeCompare(b));
+    this.selected.delete(this.key(row));
+    const index = this.rows.indexOf(row);
+    if (index >= 0) this.rows.splice(index, 1);
+    this.status = t(this.language, "selectorRemoteHidden", { id: row.id });
+    this.refresh();
+  }
+
   private cycleType(): void {
     const row = this.filtered[this.index];
     if (!row?.mutableType) return;
@@ -275,6 +290,7 @@ class ModelSelector implements Component, Focusable {
       { id: "probe", label: t(this.language, "modelProbeContext"), key: Key.ctrl("k") },
       { id: "probeThinking", label: t(this.language, "modelProbeThinking"), key: Key.ctrl("l") },
       { id: "fetch", label: t(this.language, "modelFetch"), key: Key.ctrl("r") },
+      { id: "hideRemote", label: t(this.language, "modelHideRemote"), key: Key.ctrl("delete"), enabled: this.current()?.source === "remote" },
       { id: "preview", label: t(this.language, "modelPreview"), key: Key.ctrl("s") },
       { id: "back", label: t(this.language, "modelBack"), key: Key.escape },
     ];
@@ -299,12 +315,14 @@ class ModelSelector implements Component, Focusable {
     if (action.id === "selectFiltered") { for (const row of this.filtered) if (!row.readOnly) this.selected.add(this.key(row)); this.request(); return; }
     if (action.id === "deselectFiltered") { for (const row of this.filtered) if (!row.readOnly) this.selected.delete(this.key(row)); this.request(); return; }
     if (action.id === "cycleType") { this.cycleType(); return; }
+    if (action.id === "hideRemote") { this.hideCurrentRemote(); return; }
     this.finish(action.id as SelectionResult["action"]);
   }
 
   handleInput(data: string): void {
     if (data === "/") { this.state.focus = "search"; this.request(); return; }
     if (matchesKey(data, Key.ctrl("r"))) { this.finish("fetch"); return; }
+    if (matchesKey(data, Key.ctrl("delete"))) { this.hideCurrentRemote(); return; }
     if (matchesKey(data, Key.ctrl("e"))) { this.finish("edit"); return; }
     if (matchesKey(data, Key.ctrl("k"))) { this.finish("probe"); return; }
     if (matchesKey(data, Key.ctrl("l"))) { this.finish("probeThinking"); return; }
@@ -405,7 +423,7 @@ class ModelSelector implements Component, Focusable {
       ...(current.type === "image" ? [t(this.language, "panelModelOutput", { value: current.output.join(", ") || t(this.language, "valueUnset") })] : []),
       t(this.language, "panelModelCost", { input: current.cost.input, output: current.cost.output, cacheRead: current.cost.cacheRead, cacheWrite: current.cost.cacheWrite }),
       t(this.language, "panelModelBaseUrl", { value: current.baseUrl ?? t(this.language, "valueDefault") }),
-      ...(current.readOnly ? [t(this.language, current.readOnlyReason === "external-config" ? "panelModelReadonlyExternal" : current.readOnlyReason === "runtime-catalog" ? "panelModelReadonlyRuntime" : "panelModelReadonly")] : []),
+      ...(current.readOnly ? [t(this.language, current.readOnlyReason === "runtime-catalog" ? "panelModelReadonlyRuntime" : "panelModelReadonly")] : []),
     ] : [];
     const rightAll = detailText.flatMap((line) => wrapTextWithAnsi(this.theme.fg("muted", line), rightWidth));
     this.detailMaxScroll = Math.max(0, rightAll.length - bodyBudget);

package/src/types.ts

@@ -71,6 +71,8 @@ export interface ProviderConnectionConfig {
   defaultContextWindow?: number;
   defaultMaxTokens?: number;
   managedChatIds?: string[];
+  /** Remote catalog keys (`type\0id`) hidden by the user; retained across discovery refreshes. */
+  hiddenRemoteIds?: string[];
   models?: Array<ManagedClassifierModel | ManagedImageModel>;
   modelMetadata?: ModelMetadataEntry[];
 }
@@ -115,14 +117,15 @@ export interface ProviderDraft {
   classifierApi: string;
   imageApi: ImageApiName;
   defaultType: ManagedModelType;
+  hiddenRemoteIds?: string[];
 }
 
 export type CandidateModel = ManagedModel & {
   source: "managed" | "external" | "installed" | "remote";
   mutableType: boolean;
-  /** Read-only entries are visible but cannot be toggled until an explicit supported ownership action. */
+  /** Read-only entries are visible but cannot be toggled: only runtime catalog rows. */
   readOnly?: boolean;
-  readOnlyReason?: "external-config" | "runtime-catalog";
+  readOnlyReason?: "runtime-catalog";
   contextSource?: ModelMetadataSource;
   maxTokensSource?: ModelMetadataSource;
   thinkingSource?: ThinkingMetadataSource;
@@ -142,6 +145,20 @@ export interface ConfigSnapshot {
   text?: string;
 }
 
+/** Persistent remote-hide identity. Legacy id-only entries are interpreted as chat-only on read. */
+export function hiddenRemoteKey(model: Pick<ManagedModel, "id" | "type">): string { return `${model.type}\u0000${model.id}`; }
+
+export function isHiddenRemote(model: Pick<ManagedModel, "id" | "type">, hiddenKeys: readonly string[]): boolean {
+  const key = hiddenRemoteKey(model);
+  // Compatibility: prior releases stored bare IDs; treating those as chat-only prevents
+  // a legacy hidden chat model from also hiding classifier/image models with the same ID.
+  return hiddenKeys.includes(key) || model.type === "chat" && hiddenKeys.includes(model.id);
+}
+
+export function normalizeHiddenRemoteKeys(hiddenKeys: readonly string[]): string[] {
+  return [...new Set(hiddenKeys.map((key) => key.includes("\u0000") ? key : hiddenRemoteKey({ type: "chat", id: key })))].sort((a, b) => a.localeCompare(b));
+}
+
 export function identityOf(model: Pick<ManagedModel, "id" | "type"> & { provider?: string }, provider?: string): ModelIdentity {
   const p = provider ?? model.provider ?? "";
   return `${p}\u0000${model.type}\u0000${model.id}`;