@linghun/tui 0.1.0

package/dist/chunk-2YL5VKJ5.js

@@ -0,0 +1,531 @@
+import {
+  formatCooldownDoctorLine
+} from "./chunk-EBACIBJP.js";
+import {
+  formatProviderFailureKindLabel
+} from "./chunk-OZMX3E35.js";
+
+// src/model-doctor-runtime.ts
+import { readFile } from "fs/promises";
+import {
+  defaultConfig,
+  getProjectSettingsPath,
+  isDefaultPlaceholderModel,
+  lastProviderEnvMerge,
+  lastProviderEnvWarning,
+  readProviderEnvValues
+} from "@linghun/config";
+import {
+  resolveAnthropicContextEditingDiagnostic,
+  resolveEffectiveEndpointProfile,
+  resolveProviderBaseUrlDiagnostic,
+  resolveProviderRuntimeContract
+} from "@linghun/providers";
+import { normalizeDeepSeekModelName } from "@linghun/shared";
+function maskSecret(secret) {
+  if (secret.length <= 8) return "****";
+  return `${secret.slice(0, 3)}\u2026${secret.slice(-4)}`;
+}
+function getProviderEnvKeyName(providerType) {
+  return providerType === "deepseek" ? "LINGHUN_DEEPSEEK_API_KEY" : "LINGHUN_OPENAI_API_KEY";
+}
+function getProviderKeySource(providerId, providerType, projectSettingsApiKeyProviders, providerEnvApiKeyProviders) {
+  const envName = getProviderEnvKeyName(providerType);
+  if (process.env[envName]) return "shell-env";
+  if (providerEnvApiKeyProviders.has(providerId)) {
+    return process.env.LINGHUN_CONFIG_DIR ? "config-dir-provider-env" : "user-provider-env";
+  }
+  if (projectSettingsApiKeyProviders.has(providerId)) return "project-settings-legacy";
+  return "merged-config";
+}
+async function readProjectSettingsApiKeyProviders(projectPath) {
+  try {
+    const raw = await readFile(getProjectSettingsPath(projectPath), "utf8");
+    const parsed = JSON.parse(raw);
+    return new Set(
+      Object.entries(parsed.providers ?? {}).filter(([, provider]) => typeof provider.apiKey === "string" && provider.apiKey.length > 0).map(([providerId]) => providerId)
+    );
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+async function readProviderEnvApiKeyProviders() {
+  try {
+    const values = await readProviderEnvValues();
+    return /* @__PURE__ */ new Set([
+      ...values.LINGHUN_OPENAI_API_KEY ? ["openai-compatible"] : [],
+      ...values.LINGHUN_DEEPSEEK_API_KEY ? ["deepseek"] : []
+    ]);
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function isModelRole(value) {
+  return ["planner", "executor", "reviewer", "verifier", "summarizer", "vision", "image"].includes(
+    value
+  );
+}
+function getRoleRoute(config, role) {
+  const route = config.modelRoutes.routes.find((item) => item.role === role);
+  if (route) {
+    return route;
+  }
+  return {
+    role,
+    provider: "",
+    primaryModel: "",
+    fallbackModels: [],
+    requiredCapabilities: ["text"],
+    allowTools: false,
+    allowWrite: false,
+    allowBash: false,
+    requireApprovalBeforeRun: true
+  };
+}
+function isDefaultExecutorRoute(route, _config) {
+  const defaultExecutorRoute = defaultConfig.modelRoutes.routes.find((r) => r.role === "executor");
+  if (!defaultExecutorRoute) return false;
+  return route.provider === defaultExecutorRoute.provider && route.primaryModel === defaultExecutorRoute.primaryModel;
+}
+function formatModelRouteSummary(config) {
+  const routes = config.modelRoutes.routes.map(
+    (route) => `${route.role}:${route.provider || "unknown"}/${route.primaryModel || "unconfigured"}`
+  ).slice(0, 4);
+  return `\u89D2\u8272\u8DEF\u7531\u6458\u8981\uFF1A${routes.length > 0 ? routes.join("\uFF1B") : "\u672A\u914D\u7F6E"}`;
+}
+function formatModelRoutes(config) {
+  return [
+    "Model routes\uFF08\u591A\u6A21\u578B\u6309\u89D2\u8272\u89E6\u53D1\uFF0C\u4E0D\u9ED8\u8BA4\u4E71\u5F00\uFF09",
+    ...config.modelRoutes.routes.map(
+      (route) => [
+        `- ${route.role}: provider ${route.provider || "\u672A\u914D\u7F6E"}`,
+        `model ${route.primaryModel || "\u672A\u914D\u7F6E"}`,
+        `capabilities ${route.requiredCapabilities.join("+") || "none"}`,
+        `availability ${formatRouteAvailability(route)}`,
+        `tool route hint ${route.allowTools ? "yes" : "no"}`,
+        `write route hint ${route.allowWrite ? "yes" : "no"}`,
+        `bash route hint ${route.allowBash ? "yes" : "no"}`,
+        `budget ${route.maxCostCny === void 0 ? "unconfigured" : `estimated <= ${route.maxCostCny} CNY`}`
+      ].join("  ")
+    ),
+    "\u63D0\u793A\uFF1Aroute hint \u53EA\u662F\u5019\u9009\u80FD\u529B\u63D0\u793A\uFF0C\u6700\u7EC8\u5DE5\u5177\u6267\u884C\u4ECD\u7531\u6743\u9650\u6A21\u5F0F\u548C permission gate \u51B3\u5B9A\u3002",
+    "\u63D0\u793A\uFF1A/model route doctor \u8BCA\u65AD\u7F3A provider\u3001\u80FD\u529B\u4E0D\u8DB3\u548C\u9884\u7B97\u914D\u7F6E\u3002"
+  ].join("\n");
+}
+function formatRouteAvailability(route) {
+  const capabilityText = route.requiredCapabilities.join("+") || "none";
+  if (!route.provider && !route.primaryModel) {
+    return route.requiredCapabilities.includes("vision") || route.requiredCapabilities.includes("image") ? `reserved/disabled (${capabilityText} provider/model \u672A\u914D\u7F6E\uFF1B\u4E0D\u662F\u53EF\u7528\u80FD\u529B)` : "unconfigured (provider/model \u672A\u914D\u7F6E)";
+  }
+  if (!route.provider || !route.primaryModel) {
+    return "unconfigured (provider \u6216 model \u7F3A\u5931)";
+  }
+  return "configured";
+}
+function collectReservedMultimodalRoutes(config) {
+  return config.modelRoutes.routes.filter(
+    (route) => (route.requiredCapabilities.includes("vision") || route.requiredCapabilities.includes("image")) && !route.provider && !route.primaryModel
+  );
+}
+function hasOpenAiCompatibleProviderSetupProblem(provider) {
+  return provider.type === "openai-compatible" && (!provider.baseUrl || !provider.apiKey || !provider.model || provider.model === "openai-compatible-model");
+}
+function hasOpenAiCompatibleDoctorProblem(config) {
+  const provider = config.providers["openai-compatible"];
+  return Boolean(
+    provider && (!provider.baseUrl || !provider.apiKey || !provider.model || provider.model === "openai-compatible-model")
+  );
+}
+function hasOpenAiCompatiblePlaceholderProblem(config) {
+  return config.providers["openai-compatible"]?.model === "openai-compatible-model";
+}
+function collectPlaceholderModelHits(config) {
+  const providers = [];
+  for (const [providerId, provider] of Object.entries(config.providers)) {
+    if (isDefaultPlaceholderModel(provider.model)) {
+      providers.push({ providerId, model: provider.model });
+    }
+  }
+  const routes = [];
+  for (const route of config.modelRoutes.routes) {
+    if (isDefaultPlaceholderModel(route.primaryModel)) {
+      routes.push({ role: route.role, field: "primary", model: route.primaryModel });
+    }
+    for (const fallbackModel of route.fallbackModels) {
+      if (isDefaultPlaceholderModel(fallbackModel)) {
+        routes.push({ role: route.role, field: "fallback", model: fallbackModel });
+      }
+    }
+  }
+  return { providers, routes };
+}
+async function formatModelRouteDoctor(context) {
+  const isEn = context.language === "en-US";
+  const lines = [isEn ? "Model route doctor" : "\u6A21\u578B\u8DEF\u7531\u8BCA\u65AD"];
+  const projectSettingsApiKeyProviders = await readProjectSettingsApiKeyProviders(
+    context.projectPath
+  );
+  const providerEnvApiKeyProviders = await readProviderEnvApiKeyProviders();
+  if (lastProviderEnvWarning) {
+    lines.push(
+      `WARN: provider.env \u8BFB\u53D6\u5931\u8D25\uFF1B\u8DEF\u5F84 ${lastProviderEnvWarning.path}\uFF1B\u539F\u56E0 ${lastProviderEnvWarning.reason}\uFF1B\u8BF7\u4FEE\u6B63\u540E\u91CD\u542F Linghun \u6216\u91CD\u65B0\u8FD0\u884C /model setup\u3002`
+    );
+  }
+  if (lastProviderEnvMerge?.applied) {
+    const ids = lastProviderEnvMerge.providerIds;
+    lines.push(
+      `- provider.env merge: applied yes; overrode model routes ${lastProviderEnvMerge.overrodeModelRoutes ? "yes" : "no"}; overrode default model ${lastProviderEnvMerge.overrodeDefaultModel ? "yes" : "no"}; providers ${ids.length > 0 ? ids.join(",") : "none"} (provider.env / complete shell env can select the fresh-project default route; explicit project modelRoutes stay project-scoped. \u5B89\u5168\u63D0\u793A\uFF1Aprovider.env \u542B\u654F\u611F\u51ED\u636E\uFF0C\u4E0D\u8981 cat/type \u5230\u4E3B\u5C4F\u3001\u65E5\u5FD7\u6216\u62A5\u544A)`
+    );
+  } else if (lastProviderEnvMerge && !lastProviderEnvMerge.applied) {
+    lines.push(
+      "- provider.env merge: applied no (~/.linghun/provider.env \u672A\u8986\u76D6\u9879\u76EE settings\uFF1B\u5982\u9700\u5207\u6362 provider \u8BF7\u4F7F\u7528 /model setup)"
+    );
+  }
+  const placeholderHits = collectPlaceholderModelHits(context.config);
+  if (placeholderHits.providers.length > 0 || placeholderHits.routes.length > 0) {
+    const providerHits = placeholderHits.providers.map((hit) => `${hit.providerId} -> ${hit.model}`).join(",");
+    const routeHits = placeholderHits.routes.map((hit) => `${hit.role}.${hit.field} -> ${hit.model}`).join(",");
+    lines.push(
+      `- WARN placeholder model: providers=[${providerHits || "none"}] routes=[${routeHits || "none"}] (\u8FD9\u4E9B\u662F\u5360\u4F4D/\u672A\u6210\u719F\u6A21\u578B\u540D\uFF1Bsmoke \u524D\u8BF7\u7528 LINGHUN_DEEPSEEK_MODEL/LINGHUN_DEFAULT_MODEL \u66FF\u6362\u4E3A\u73B0\u5F79\u6A21\u578B\u540D\uFF0C\u4F8B\u5982 deepseek-chat/deepseek-reasoner)`
+    );
+  }
+  const reservedMultimodalRoutes = collectReservedMultimodalRoutes(context.config);
+  if (reservedMultimodalRoutes.length > 0) {
+    const roles = reservedMultimodalRoutes.map((route) => `${route.role}(${route.requiredCapabilities.join("+")})`).join(",");
+    lines.push(
+      `- reserved multimodal routes: ${roles} provider/model \u672A\u914D\u7F6E\uFF1Bstatus/doctor \u5C06\u5176\u6807\u8BB0\u4E3A reserved/disabled\uFF0C\u4E0D\u662F\u53EF\u7528\u80FD\u529B\u3002`
+    );
+  }
+  lines.push(
+    `- prompt cache: enabled ${context.config.promptCache.enabled ? "yes" : "no"}; system ttl ${context.config.promptCache.systemTtl} (5m \u9ED8\u8BA4 cache_control \u65E0 ttl \u5B57\u9762\u91CF\uFF1B1h \u624D\u663E\u5F0F\u5199 ttl)`
+  );
+  if (context.deferredToolsSummary) {
+    const summary = context.deferredToolsSummary;
+    lines.push(
+      `- deferred tools: total ${summary.total}; executable ${summary.executableCount}; codebase-memory ${summary.byKind["codebase-memory"]}; mcp ${summary.byKind.mcp}; skill ${summary.byKind.skill}; plugin ${summary.byKind.plugin} (SearchExtraTools/ExecuteExtraTool \u5165\u53E3\uFF1Bbuilt-in \u5DE5\u5177\u4E0D\u8D70\u8BE5\u6D3E\u53D1)`
+    );
+  }
+  if (context.discoveredDeferredToolsSummary) {
+    const ds = context.discoveredDeferredToolsSummary;
+    if (ds.total === 0) {
+      lines.push(
+        "- discoveredDeferredTools: 0 (\u672C session \u8FD8\u6CA1\u8FD0\u884C\u8FC7 SearchExtraTools\uFF1BExecuteExtraTool \u73B0\u5728\u4F1A\u5168\u90E8\u62D2\u7EDD\u3002\u8BF7\u5148 SearchExtraTools)"
+      );
+    } else {
+      const visible = ds.names.join(",");
+      const tail = ds.truncated ? `,\u2026+${ds.total - ds.names.length} more` : "";
+      lines.push(
+        `- discovered deferred tools: total ${ds.total}; names [${visible}${tail}] (\u672C session \u7ECF SearchExtraTools \u8BB0\u5F55\u8FC7\u7684\u5DE5\u5177\u540D\uFF1Bsession \u91CD\u542F\u5373\u6E05\u96F6)`
+      );
+    }
+  }
+  lines.push("- providers:");
+  for (const [providerId, provider] of Object.entries(context.config.providers)) {
+    const contract = resolveProviderRuntimeContract({ id: providerId, ...provider });
+    const endpointProfile = contract.endpointProfile;
+    const compatibilityProfile = contract.compatibilityProfile ?? provider.compatibilityProfile ?? (provider.type === "deepseek" ? "deepseek" : "strict_openai_compatible");
+    const reasoningLevel = provider.reasoningLevel;
+    const reasoningSentLocal = Boolean(
+      reasoningLevel && (endpointProfile === "responses" || endpointProfile === "anthropic_messages" || compatibilityProfile === "permissive_openai_compatible")
+    );
+    const reasoningPlain = !reasoningLevel ? context.language === "en-US" ? "Reasoning not configured" : "\u672A\u914D\u7F6E\u63A8\u7406\u7B49\u7EA7" : reasoningSentLocal ? context.language === "en-US" ? `Reasoning ${reasoningLevel} sent` : `\u63A8\u7406 ${reasoningLevel} \u5DF2\u53D1\u9001` : context.language === "en-US" ? `Reasoning ${reasoningLevel} not sent (gateway or model rejects it)` : `\u63A8\u7406 ${reasoningLevel} \u4E0D\u4F1A\u53D1\u9001\uFF08\u5F53\u524D\u7F51\u5173\u6216\u6A21\u578B\u4E0D\u63A5\u53D7\uFF09`;
+    const reasoningTechnical = reasoningLevel ? endpointProfile === "responses" ? `effective/sent reasoning.effort=${reasoningLevel}` : endpointProfile === "anthropic_messages" ? `effective/sent thinking.budget_tokens=${reasoningLevel === "Low" ? "1024" : reasoningLevel === "Medium" ? "4096" : reasoningLevel === "High" ? "8192" : reasoningLevel}` : compatibilityProfile === "permissive_openai_compatible" ? `effective/sent reasoning.effort=${reasoningLevel}` : `ignored/unsupported/\u672A\u751F\u6548 compatibility profile ${compatibilityProfile}` : "not configured/\u672A\u751F\u6548";
+    const reasoningStatus = `${reasoningTechnical} (${reasoningPlain})`;
+    const baseUrlDiagnostic = resolveProviderBaseUrlDiagnostic(
+      provider.baseUrl,
+      endpointProfile
+    );
+    const keySource = provider.apiKey ? getProviderKeySource(providerId, provider.type, projectSettingsApiKeyProviders, providerEnvApiKeyProviders) : void 0;
+    const decision = resolveEffectiveEndpointProfile({
+      requestEndpointProfile: void 0,
+      configEndpointProfile: provider.endpointProfile,
+      configBaseUrl: provider.baseUrl,
+      configModel: provider.model,
+      requestModel: void 0
+    });
+    lines.push(
+      `  - ${providerId}: type ${provider.type}; provider ${providerId}; model ${provider.model || "missing"}; runtime profile ${contract.profile}; endpoint profile ${contract.endpointProfile}; compatibility ${contract.compatibilityProfile}; base URL ${provider.baseUrl ? "present" : "missing"}; endpoint path ${baseUrlDiagnostic.endpointPath}; tools ${contract.supportsTools ? "enabled" : "disabled"}; tool schema ${contract.toolSchemaShape}; tool result ${contract.toolResultShape}; retry ${contract.retryStatuses.join("/")}x${contract.maxAttempts}; timeout ${contract.requestTimeoutMs}ms; idle timeout ${contract.streamIdleTimeoutMs}ms; include usage ${contract.includeUsage ? "yes" : "no"}; reasoning ${reasoningStatus}; api key ${provider.apiKey && keySource ? `present source ${keySource} masked ${maskSecret(provider.apiKey)}` : "missing source missing"}`
+    );
+    lines.push(`    endpoint profile decision: source ${decision.source}; reason ${decision.reason}`);
+    if (provider.type === "openai-compatible") {
+      lines.push(
+        "    openai-compatible endpoint hint: root baseUrl + responses \u53EF\u80FD\u53EF\u7528\uFF1Bchat_completions \u901A\u5E38\u9700\u8981 /v1 root\uFF1B\u5982\u679C\u8FD4\u56DE content type text/html\uFF0CbaseUrl \u53EF\u80FD\u586B\u5230\u4E86\u7F51\u9875\u767B\u5F55\u9875\u6216\u5C11\u4E86 /v1\u3002"
+      );
+    }
+    if (!contract.supportsTools) {
+      const reason = contract.endpointProfile === "anthropic_messages" ? "anthropic_messages profile \u5DF2\u539F\u751F\u652F\u6301 tools\uFF0C\u4F46\u5F53\u524D provider \u663E\u5F0F\u58F0\u660E supports tools false\uFF1B\u5982\u9700\u542F\u7528\u8BF7\u628A\u914D\u7F6E\u6539\u4E3A supportsTools true \u6216\u5220\u9664\u8BE5\u5B57\u6BB5" : `runtime contract supports tools false (profile ${contract.profile})`;
+      lines.push(`    tools disabled reason: ${reason}`);
+    }
+    if (contract.endpointProfile === "anthropic_messages" && contract.supportsTools) {
+      lines.push(
+        "    anthropic tools: enabled; schema anthropic_tools(input_schema); tool choice auto/none; sort name-asc(stable for prompt cache)"
+      );
+    }
+    if (contract.endpointProfile === "anthropic_messages") {
+      const promptCacheEnabled = context.config.promptCache.enabled;
+      const ttl = context.config.promptCache.systemTtl;
+      lines.push(
+        `    anthropic prompt cache: cache_control ${promptCacheEnabled ? `injected; ttl ${ttl === "1h" ? "1h" : "5m-default(no ttl literal)"}` : "off"}; usage fields cache_creation.ephemeral_5m_input_tokens/ephemeral_1h_input_tokens (read-only when emitted by upstream)`
+      );
+      const contextEditing = resolveAnthropicContextEditingDiagnostic(
+        {
+          contextEditingEnabled: provider.contextEditingEnabled,
+          anthropicBetaHeaders: provider.anthropicBetaHeaders
+        },
+        contract
+      );
+      lines.push(
+        `    anthropic context editing: enabled ${contextEditing.enabled ? "yes" : "no"}; sendable ${contextEditing.sendable ? "yes" : "no"}; beta headers ${contextEditing.betaHeaderCount}; reason ${contextEditing.disabledReason ?? "ok"} (cache_edits/cache_reference body \u5B57\u6BB5 hard-disabled)`
+      );
+    }
+    if (projectSettingsApiKeyProviders.has(providerId)) {
+      lines.push(
+        `    WARN: project settings provider ${providerId} contains apiKey; project .linghun/settings.json \u4E0D\u5EFA\u8BAE\u4FDD\u5B58 apiKey\uFF0C\u8BF7\u8FC1\u79FB\u5230\u73AF\u5883\u53D8\u91CF\u6216\u79C1\u6709\u914D\u7F6E\u3002`
+      );
+    }
+    if (decision.warnings.length > 0) {
+      for (const warning of decision.warnings) {
+        lines.push(`    warning: ${warning}`);
+      }
+    }
+    if (baseUrlDiagnostic.hasQueryOrFragment) {
+      lines.push(
+        "    warning: baseUrl \u5305\u542B query/fragment\uFF1Bdoctor \u4E0D\u663E\u793A\u539F\u503C\uFF0C\u8BF7\u6539\u4E3A\u4E0D\u542B query/fragment \u7684 root baseUrl\u3002"
+      );
+      lines.push(`    recommendation: ${baseUrlDiagnostic.recommendation}`);
+    }
+    if (baseUrlDiagnostic.fullEndpointSuffix) {
+      lines.push(
+        `    warning: baseUrl \u5305\u542B\u5B8C\u6574 endpoint suffix ${baseUrlDiagnostic.fullEndpointSuffix}\uFF1B\u5DF2\u6309 root baseUrl \u8BCA\u65AD\uFF0C\u6700\u7EC8 endpoint path ${baseUrlDiagnostic.endpointPath}`
+      );
+      lines.push(`    recommendation: ${baseUrlDiagnostic.recommendation}`);
+      if (baseUrlDiagnostic.profileMismatch) {
+        lines.push(
+          `    profile/baseUrl \u4E0D\u5339\u914D\uFF1AbaseUrl suffix ${baseUrlDiagnostic.fullEndpointSuffix}\uFF0Cendpoint profile ${endpointProfile}`
+        );
+      } else if (provider.endpointProfile && provider.endpointProfile !== endpointProfile) {
+        lines.push(
+          `    profile/baseUrl \u4E0D\u5339\u914D\uFF1AbaseUrl suffix ${baseUrlDiagnostic.fullEndpointSuffix}\uFF0Cconfigured endpoint profile ${provider.endpointProfile}\uFF0Cruntime endpoint profile ${endpointProfile}`
+        );
+      }
+    }
+  }
+  for (const route of context.config.modelRoutes.routes) {
+    const problems = diagnoseRoute(route, context.config);
+    const level = getRouteDoctorLevel(route, problems, context.config);
+    lines.push(
+      `- ${route.role}: ${level}${problems.length === 0 ? "" : `\uFF1A${problems.join("\uFF1B")}`} provider ${route.provider || "\u672A\u914D\u7F6E"} model ${route.primaryModel || "\u672A\u914D\u7F6E"} fallback ${route.fallbackModels.length > 0 ? route.fallbackModels.join(",") : "\u672A\u914D\u7F6E"}`
+    );
+  }
+  if (context.routeDecisions.length > 0) {
+    lines.push(isEn ? "- recent route decisions:" : "- \u6700\u8FD1\u8DEF\u7531\u51B3\u7B56\uFF1A");
+    for (const decision of context.routeDecisions.slice(0, 3)) {
+      lines.push(
+        `  - ${decision.role}: trigger ${decision.triggerReason}; selected ${decision.selectedProvider || "paused"}/${decision.selectedModel || "paused"}; fallback used ${decision.fallbackUsed ? "yes" : "no"}; stop ${decision.stopConditions.length > 0 ? decision.stopConditions.join("|") : "none"}`
+      );
+    }
+  }
+  if (context.providerBreaker) {
+    const cooldownLine = formatCooldownDoctorLine(context.providerBreaker, context.language);
+    if (cooldownLine) {
+      lines.push(`- ${cooldownLine}`);
+    }
+  }
+  if (context.lastProviderFailure) {
+    const failure = context.lastProviderFailure;
+    const failureKind = toProviderFailureKind(failure.kind);
+    const humanKind = formatProviderFailureKindLabel(failureKind, context.language);
+    if (isEn) {
+      lines.push(
+        `- last model-service failure: kind ${humanKind}; code ${failure.code}; provider ${failure.provider}; model ${failure.model}; endpoint profile ${failure.endpointProfile}; details: /details evidence`
+      );
+      if (failure.kind === "quota_or_balance_exhausted") {
+        lines.push(
+          "- quota/balance note: this is an upstream error classification, not a balance query."
+        );
+      }
+    } else {
+      lines.push(
+        `- \u6700\u8FD1\u6A21\u578B\u670D\u52A1\u5931\u8D25\uFF1A\u7C7B\u578B ${humanKind}\uFF1Bcode ${failure.code}\uFF1B\u670D\u52A1\u5546 ${failure.provider}\uFF1B\u6A21\u578B ${failure.model}\uFF1B\u63A5\u53E3\u7C7B\u578B ${failure.endpointProfile}\uFF1B\u8BE6\u60C5\uFF1A/details evidence`
+      );
+      if (failure.kind === "quota_or_balance_exhausted") {
+        lines.push("- \u989D\u5EA6/\u4F59\u989D\u8BF4\u660E\uFF1A\u8FD9\u662F\u4E0A\u6E38\u9519\u8BEF\u5206\u7C7B\uFF0C\u4E0D\u662F Linghun \u67E5\u8BE2\u4F59\u989D\u7684\u7ED3\u679C\u3002");
+      }
+    }
+  }
+  if (context.lastProviderFallbackAttempt) {
+    const attempt = context.lastProviderFallbackAttempt;
+    const reason = formatProviderFailureKindLabel(
+      toProviderFailureKind(attempt.reasonKind),
+      context.language
+    );
+    const statusText = context.language === "en-US" ? attempt.status : attempt.status === "attempted" ? "\u5DF2\u5C1D\u8BD5" : attempt.status === "succeeded" ? "\u5DF2\u6210\u529F" : "\u5DF2\u5931\u8D25";
+    lines.push(
+      isEn ? `- last fallback attempt: ${statusText}; ${attempt.fromProvider}/${attempt.fromModel} -> ${attempt.toProvider}/${attempt.toModel}; reason ${reason}; code ${attempt.reasonCode}` : `- \u6700\u8FD1\u5907\u7528\u6A21\u578B\u5C1D\u8BD5\uFF1A\u72B6\u6001 ${statusText}\uFF1B${attempt.fromProvider}/${attempt.fromModel} -> ${attempt.toProvider}/${attempt.toModel}\uFF1B\u539F\u56E0 ${reason}\uFF1Bcode ${attempt.reasonCode}`
+    );
+  }
+  if (hasOpenAiCompatibleDoctorProblem(context.config)) {
+    lines.push(
+      "- openai-compatible \u4FEE\u590D\uFF1A\u8BBE\u7F6E LINGHUN_OPENAI_BASE_URL\u3001LINGHUN_OPENAI_API_KEY\u3001LINGHUN_OPENAI_MODEL \u540E\u91CD\u542F Linghun\u3002"
+    );
+  }
+  if (hasOpenAiCompatiblePlaceholderProblem(context.config)) {
+    lines.push(
+      "- openai-compatible \u5360\u4F4D\u63D0\u793A\uFF1A\u8BF7\u68C0\u67E5 .linghun/settings.json\uFF0C\u907F\u514D openai-compatible-model \u5360\u4F4D\u503C\u8986\u76D6\u771F\u5B9E\u6A21\u578B\u3002"
+    );
+  }
+  lines.push(
+    "- budget: \u672A\u914D\u7F6E\u9884\u7B97\u53EA\u4F5C\u4E3A WARN\uFF1B\u91D1\u989D\u4EC5\u5728 /usage \u6216 /stats \u4E2D\u4EE5 estimated \u5C55\u793A\uFF0C\u72B6\u6001\u680F\u4E0D\u4F1A\u663E\u793A\u91D1\u989D\u3002"
+  );
+  lines.push(
+    "- handoff: \u89D2\u8272\u95F4\u53EA\u4F20 summary/evidence/diff/verification/keyFiles\uFF0C\u4E0D\u4F20\u5B8C\u6574 transcript/memory/index/logs\u3002"
+  );
+  return lines.join("\n");
+}
+function toProviderFailureKind(value) {
+  if (value === "rate_limit" || value === "quota_or_balance_exhausted" || value === "schema" || value === "auth" || value === "not_found" || value === "gateway" || value === "transit" || value === "timeout" || value === "abort" || value === "reasoning_unsupported") {
+    return value;
+  }
+  return "generic";
+}
+function diagnoseRoute(route, config) {
+  const problems = diagnoseConcreteRoute(route, route.primaryModel, route.provider, config);
+  if (route.primaryModel && isDefaultPlaceholderModel(route.primaryModel)) {
+    problems.push(`\u6A21\u578B placeholder \u672A\u66FF\u6362\u4E3A\u73B0\u5F79\u6A21\u578B\uFF1A${route.primaryModel}`);
+  }
+  if (route.fallbackModels.length === 0) {
+    problems.push("fallbackModels \u672A\u914D\u7F6E");
+  }
+  for (const fallbackModel of route.fallbackModels) {
+    const fallbackProvider = inferProviderForRouteModel(fallbackModel, config);
+    const fallbackProblems = diagnoseConcreteRoute(route, fallbackModel, fallbackProvider, config);
+    if (isDefaultPlaceholderModel(fallbackModel)) {
+      fallbackProblems.push(`\u6A21\u578B placeholder \u672A\u66FF\u6362\u4E3A\u73B0\u5F79\u6A21\u578B\uFF1A${fallbackModel}`);
+    }
+    if (getRouteBlockingProblems(fallbackProblems).length > 0) {
+      problems.push(
+        `fallback \u4E0D\u53EF\u7528 ${fallbackModel}\uFF1A${getRouteBlockingProblems(fallbackProblems).join("/")}`
+      );
+    }
+  }
+  if (route.maxCostCny === void 0) {
+    problems.push("\u9884\u7B97\u672A\u914D\u7F6E");
+  }
+  if ((route.role === "planner" || route.role === "reviewer" || route.role === "vision") && route.allowWrite) {
+    problems.push("\u6743\u9650\u8FC7\u5BBD\uFF1A\u4E0D\u5E94\u5199\u6587\u4EF6");
+  }
+  if ((route.role === "vision" || route.role === "image" || route.role === "planner") && route.allowBash) {
+    problems.push("\u6743\u9650\u8FC7\u5BBD\uFF1A\u4E0D\u5E94\u6267\u884C Bash");
+  }
+  return problems;
+}
+function diagnoseConcreteRoute(route, model, providerId, config) {
+  const problems = [];
+  const provider = providerId ? config.providers[providerId] : void 0;
+  if (!providerId) {
+    problems.push("\u7F3A provider");
+  } else if (!provider) {
+    problems.push("provider \u672A\u914D\u7F6E");
+  }
+  if (!model) {
+    problems.push("\u7F3A\u6A21\u578B");
+  }
+  if (provider?.type === "openai-compatible") {
+    if (!provider.baseUrl) problems.push("openai-compatible \u7F3A baseUrl");
+    if (!provider.apiKey) problems.push("openai-compatible \u7F3A apiKey");
+    if (!provider.model || provider.model === "openai-compatible-model") {
+      problems.push("openai-compatible \u7F3A\u5DF2\u786E\u8BA4\u6A21\u578B");
+    }
+  }
+  for (const capability of route.requiredCapabilities) {
+    if (!routeSupportsCapability({ ...route, primaryModel: model }, capability)) {
+      problems.push(
+        capability === "tools" ? "\u80FD\u529B\u4E0D\u8DB3\uFF1Atools/tool calling" : `\u80FD\u529B\u4E0D\u8DB3\uFF1A${capability}`
+      );
+    }
+  }
+  return problems;
+}
+function getRouteDoctorLevel(route, problems, config) {
+  const primaryProblems = diagnoseConcreteRoute(route, route.primaryModel, route.provider, config);
+  if (route.primaryModel && isDefaultPlaceholderModel(route.primaryModel)) {
+    primaryProblems.push(`\u6A21\u578B placeholder \u672A\u66FF\u6362\u4E3A\u73B0\u5F79\u6A21\u578B\uFF1A${route.primaryModel}`);
+  }
+  const primaryBlocking = getRouteBlockingProblems(primaryProblems);
+  if (primaryBlocking.length > 0) {
+    const hasUsableFallback = route.fallbackModels.some((fallbackModel) => {
+      const fallbackProvider = inferProviderForRouteModel(fallbackModel, config);
+      const fallbackProblems = diagnoseConcreteRoute(
+        route,
+        fallbackModel,
+        fallbackProvider,
+        config
+      );
+      if (isDefaultPlaceholderModel(fallbackModel)) {
+        fallbackProblems.push(`\u6A21\u578B placeholder \u672A\u66FF\u6362\u4E3A\u73B0\u5F79\u6A21\u578B\uFF1A${fallbackModel}`);
+      }
+      return getRouteBlockingProblems(fallbackProblems).length === 0;
+    });
+    return hasUsableFallback ? "WARN" : "BLOCK";
+  }
+  return problems.length > 0 ? "WARN" : "ok";
+}
+function getRouteBlockingProblems(problems) {
+  return problems.filter(
+    (problem) => problem !== "\u9884\u7B97\u672A\u914D\u7F6E" && problem !== "fallbackModels \u672A\u914D\u7F6E" && (problem.startsWith("\u7F3A") || problem.includes("\u672A\u914D\u7F6E") || problem.includes("\u7F3A ") || problem.includes("\u7F3A\u5DF2\u786E\u8BA4") || problem.includes("\u4E0D\u5339\u914D") || problem.startsWith("\u80FD\u529B\u4E0D\u8DB3") || // D.13J tail fix（Block D）：placeholder 模型属于 blocking，不能被当成可用 route。
+    problem.startsWith("\u6A21\u578B placeholder"))
+  );
+}
+function routeSupportsCapability(route, capability) {
+  if (capability === "text") {
+    return Boolean(route.primaryModel);
+  }
+  if (capability === "vision") {
+    return /vision|vl|gpt-4o|claude|qwen|glm|kimi/i.test(route.primaryModel);
+  }
+  if (capability === "image") {
+    return /image|dall|gpt-image|flux|sd|comfy/i.test(route.primaryModel);
+  }
+  if (capability === "tools") {
+    return route.allowTools;
+  }
+  if (capability === "thinking") {
+    return /pro|reason|thinking|claude|gpt/i.test(route.primaryModel);
+  }
+  if (capability === "promptCache") {
+    return /claude|gpt|deepseek/i.test(route.primaryModel);
+  }
+  return false;
+}
+function inferProviderForRouteModel(model, config) {
+  const normalized = normalizeDeepSeekModelName(model);
+  for (const [providerId, provider] of Object.entries(config.providers)) {
+    if (provider.model === model || provider.model === normalized) {
+      return providerId;
+    }
+  }
+  return "openai-compatible";
+}
+
+export {
+  maskSecret,
+  getProviderKeySource,
+  readProjectSettingsApiKeyProviders,
+  readProviderEnvApiKeyProviders,
+  isModelRole,
+  getRoleRoute,
+  isDefaultExecutorRoute,
+  formatModelRouteSummary,
+  formatModelRoutes,
+  hasOpenAiCompatibleProviderSetupProblem,
+  hasOpenAiCompatibleDoctorProblem,
+  hasOpenAiCompatiblePlaceholderProblem,
+  collectPlaceholderModelHits,
+  formatModelRouteDoctor,
+  diagnoseRoute,
+  diagnoseConcreteRoute,
+  getRouteDoctorLevel,
+  getRouteBlockingProblems,
+  routeSupportsCapability,
+  inferProviderForRouteModel
+};

package/dist/chunk-3AKXDMVS.js

@@ -0,0 +1,85 @@
+// src/shell/models/help-panel.ts
+var CORE_ENTRIES_ZH = [
+  { slash: "/help", description: "\u67E5\u770B\u547D\u4EE4\u5E2E\u52A9\uFF08all / advanced / details \u5207\u6362\u5206\u7EC4\uFF09" },
+  { slash: "/model", description: "\u67E5\u770B / \u5207\u6362\u6267\u884C\u6A21\u578B\u4E0E reasoning level" },
+  { slash: "/permissions", description: "\u67E5\u770B\u6743\u9650\u89C4\u5219\u4E0E\u6700\u8FD1\u88AB\u62D2\u5217\u8868" },
+  { slash: "/mode", description: "\u5207\u6362\u6743\u9650\u6A21\u5F0F\uFF08default / auto / plan / full-access\uFF09" },
+  { slash: "/config", description: "\u6253\u5F00\u914D\u7F6E\u9762\u677F\uFF08model / language / permissions \u7B49\uFF09" },
+  { slash: "/index", description: "\u67E5\u770B\u4EE3\u7801\u7D22\u5F15\u72B6\u6001\u4E0E\u5237\u65B0\u5165\u53E3" },
+  { slash: "/details", description: "\u6253\u5F00\u6700\u8FD1\u8F93\u51FA / evidence / background \u8BE6\u60C5\u9762\u677F" },
+  { slash: "/exit", description: "\u9000\u51FA Linghun" }
+];
+var CORE_ENTRIES_EN = [
+  { slash: "/help", description: "Show command help (all / advanced / details groups)" },
+  { slash: "/model", description: "Show / switch executor model and reasoning level" },
+  { slash: "/permissions", description: "Inspect permission rules and recent denials" },
+  { slash: "/mode", description: "Switch permission mode (default / auto / plan / full-access)" },
+  { slash: "/config", description: "Open the config panel (model / language / permissions ...)" },
+  { slash: "/index", description: "Show codebase index status and refresh entry" },
+  { slash: "/details", description: "Open recent output / evidence / background details panel" },
+  { slash: "/exit", description: "Exit Linghun" }
+];
+var ADVANCED_ENTRIES_ZH = [
+  { slash: "/agents", description: "\u67E5\u770B\u56E2\u961F\u667A\u80FD\u4F53\u4E0E\u540E\u53F0 agent \u72B6\u6001" },
+  { slash: "/background", description: "\u67E5\u770B\u540E\u53F0\u4EFB\u52A1\u5217\u8868\u4E0E\u8BE6\u60C5" },
+  { slash: "/job", description: "\u7BA1\u7406\u540E\u53F0\u4EFB\u52A1\uFF08start / pause / cancel\uFF09" },
+  { slash: "/batch", description: "\u542F\u52A8\u9694\u79BB worktree batch \u667A\u80FD\u4F53" },
+  { slash: "/skills", description: "\u7BA1\u7406\u6280\u80FD\u4E0E\u542F\u7528\u72B6\u6001" },
+  { slash: "/workflows", description: "\u67E5\u770B workflow \u72B6\u6001\u4E0E\u89E6\u53D1\u5165\u53E3" },
+  { slash: "/handoff", description: "\u5BFC\u51FA\u4F1A\u8BDD handoff packet" },
+  { slash: "/branch", description: "\u57FA\u4E8E handoff \u521B\u5EFA\u4F1A\u8BDD\u5206\u652F\uFF08\u4E0D\u662F git \u5206\u652F\uFF09" },
+  { slash: "/git", description: "\u67E5\u770B git \u72B6\u6001\u3001\u7A33\u5B9A\u70B9\u5EFA\u8BAE\u3001worktree \u6458\u8981\uFF08\u53EA\u8BFB\uFF09" },
+  { slash: "/worktree", description: "\u67E5\u770B git worktree \u5217\u8868\uFF08\u53EA\u8BFB\uFF09" },
+  { slash: "/checkpoint", description: "\u67E5\u770B Linghun snapshot checkpoint / \u7A33\u5B9A\u70B9\u5EFA\u8BAE" },
+  { slash: "/cache", description: "\u67E5\u770B cache \u4F7F\u7528\u60C5\u51B5\u4E0E\u51B7\u70ED\u5206\u5E03" }
+];
+var ADVANCED_ENTRIES_EN = [
+  { slash: "/agents", description: "Inspect teammate agents and background agent status" },
+  { slash: "/background", description: "List background tasks and inspect details" },
+  { slash: "/job", description: "Manage background jobs (start / pause / cancel)" },
+  { slash: "/batch", description: "Run isolated worktree batch agents" },
+  { slash: "/skills", description: "Manage skills and their enabled state" },
+  { slash: "/workflows", description: "Inspect workflow status and trigger entries" },
+  { slash: "/handoff", description: "Export the session handoff packet" },
+  { slash: "/branch", description: "Create a session branch from handoff (not a git branch)" },
+  {
+    slash: "/git",
+    description: "Show git status, stable-point hints, worktree summary (read-only)"
+  },
+  { slash: "/worktree", description: "List git worktrees (read-only)" },
+  { slash: "/checkpoint", description: "Inspect Linghun snapshot checkpoints / stable points" },
+  { slash: "/cache", description: "Inspect cache usage and hot / cold distribution" }
+];
+var DETAILS_ENTRIES_ZH = [
+  { slash: "/details", description: "\u5C55\u5F00\u6700\u8FD1\u6B63\u6587 / evidence / background \u8BE6\u60C5" },
+  { slash: "/cache-log", description: "\u67E5\u770B cache log \u8BE6\u60C5" },
+  { slash: "/break-cache", description: "\u8BCA\u65AD cache hash \u6F02\u79FB" },
+  { slash: "/model doctor", description: "\u8FD0\u884C\u6A21\u578B\u8DEF\u7531\u8BCA\u65AD" },
+  { slash: "/model route", description: "\u67E5\u770B / \u8C03\u6574\u6A21\u578B\u8DEF\u7531" },
+  { slash: "/index doctor", description: "\u8FD0\u884C\u7D22\u5F15\u8BCA\u65AD" }
+];
+var DETAILS_ENTRIES_EN = [
+  { slash: "/details", description: "Expand recent body / evidence / background details" },
+  { slash: "/cache-log", description: "Inspect cache log details" },
+  { slash: "/break-cache", description: "Diagnose cache hash drift" },
+  { slash: "/model doctor", description: "Run model route diagnostics" },
+  { slash: "/model route", description: "Inspect / adjust model routes" },
+  { slash: "/index doctor", description: "Run codebase index diagnostics" }
+];
+function getHelpPanelEntries(group, language) {
+  if (group === "core") return language === "en-US" ? CORE_ENTRIES_EN : CORE_ENTRIES_ZH;
+  if (group === "advanced") return language === "en-US" ? ADVANCED_ENTRIES_EN : ADVANCED_ENTRIES_ZH;
+  return language === "en-US" ? DETAILS_ENTRIES_EN : DETAILS_ENTRIES_ZH;
+}
+function buildHelpPanelData(group, cursor, scrollOffset, language) {
+  const entries = getHelpPanelEntries(group, language);
+  const safe = entries.length === 0 ? 0 : Math.min(Math.max(0, cursor), entries.length - 1);
+  return { group, cursor: safe, scrollOffset, entries };
+}
+var HELP_PANEL_GROUPS = ["core", "advanced", "details"];
+
+export {
+  getHelpPanelEntries,
+  buildHelpPanelData,
+  HELP_PANEL_GROUPS
+};