fix(i18n): localize health diagnostics

Keep raw capability and connection diagnostics from leaking machine or wrong-locale text into Settings surfaces.\n\nGenerated-by: OpenCode

Author: orangeCatDeveloper

apps/desktop/src/main/__tests__/health-center-copy.test.ts

@@ -19,6 +19,7 @@
 
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
+import { connectionLastTestMessageDisplay } from '../../renderer/features/connection-settings/provider-panel-shared.js';
 import { getHealthCenterCopy } from '../../renderer/locales/settings-health-copy.js';
 
 test('labels blocker counts as global across filtered health views', () => {
@@ -65,18 +66,39 @@ test('renders runtime probe details from structured params, not string parsing',
   );
 });
 
-test('maps known capability reasons per locale and degrades unknowns safely', () => {
-  const known = { kind: 'capability_reason', reason: 'missing platform credentials' } as const;
-  assert.equal(getHealthCenterCopy('zh').signalDetail(signal(({ detail: known }))), '等待填写平台凭据。');
-  assert.equal(getHealthCenterCopy('en').signalDetail(signal(({ detail: known }))), 'Waiting for platform credentials.');
-  const unknown = { kind: 'capability_reason', reason: '本地快照诊断说明' } as const;
-  assert.equal(getHealthCenterCopy('zh').signalDetail(signal({ detail: unknown })), '本地快照诊断说明');
+test('degrades capability reasons safely in both locales', () => {
+  const unknown = { kind: 'capability_reason', reason: 'Discord rejected the Bot Token.' } as const;
+  assert.equal(
+    getHealthCenterCopy('zh').signalDetail(signal({ detail: unknown })),
+    '状态详情请见对应设置页。',
+  );
   assert.equal(
     getHealthCenterCopy('en').signalDetail(signal({ detail: unknown })),
     'See the corresponding settings page for details.',
   );
 });
 
+test('maps connection test error classes without exposing machine tokens', () => {
+  const auth = { kind: 'last_test_error_class', errorClass: 'auth' } as const;
+  assert.equal(getHealthCenterCopy('zh').signalDetail(signal({ detail: auth })), '鉴权失败');
+  assert.equal(getHealthCenterCopy('en').signalDetail(signal({ detail: auth })), 'Authentication failed');
+
+  const unknown = { kind: 'last_test_message', text: 'future_error_class' } as const;
+  assert.equal(
+    getHealthCenterCopy('zh').signalDetail(signal({ detail: unknown })),
+    '连接测试状态暂时无法显示，请重新测试。',
+  );
+  assert.equal(
+    getHealthCenterCopy('en').signalDetail(signal({ detail: unknown })),
+    'The connection test status is temporarily unavailable. Test again.',
+  );
+});
+
+test('maps connection test error classes in connection details', () => {
+  assert.equal(connectionLastTestMessageDisplay('auth', 'zh'), '鉴权失败');
+  assert.equal(connectionLastTestMessageDisplay('auth', 'en'), 'Authentication failed');
+});
+
 test('suffixes runtime signal labels per locale from the id, not the producer', () => {
   const runtime = signal({ id: 'connection:demo:runtime', label: 'Demo' });
   assert.equal(getHealthCenterCopy('zh').signalLabel(runtime), 'Demo 运行态');

apps/desktop/src/renderer/features/connection-settings/settings-provider-copy.ts

@@ -165,6 +165,7 @@ const zhCopy = {
     categories: { oauth: 'OAuth', domestic: '国内', overseas: '海外', local: '本地', custom: 'Custom' },
     connectionStatuses: { retired: '已停用 · 请删除', reauth: '需要重新登录', disabledFailed: '暂不可用 · 上次连接失败', disabled: '暂不可用', failed: '上次连接失败' },
     lastTest: {
+      auth: '鉴权失败', timeout: '请求超时', provider_unavailable: '模型服务返回错误', network: '网络错误', invalid_response: '模型服务返回错误', unknown: '连接测试失败',
       '连接已验证': '连接已验证', '鉴权失败': '鉴权失败', '请求超时': '请求超时', '网络错误': '网络错误', '模型服务返回错误': '模型服务返回错误', '连接测试失败': '连接测试失败',
       'connection verified': '连接已验证', 'authentication failed': '鉴权失败', 'request timed out': '请求超时', 'network error': '网络错误', 'provider returned an error': '模型服务返回错误', 'connection test failed': '连接测试失败',
       'claude oauth 未登录。': 'Claude OAuth 未登录。', 'claude oauth 本地凭据读取失败。': 'Claude OAuth 本地凭据读取失败。', 'claude oauth 需要重新登录。': 'Claude OAuth 需要重新登录。', 'claude oauth 已登录。': 'Claude OAuth 已登录。', 'claude oauth 已退出登录。': 'Claude OAuth 已退出登录。',
@@ -325,6 +326,7 @@ const enCopy: ProviderSettingsCopy = {
     categories: { oauth: 'OAuth', domestic: 'China', overseas: 'Global', local: 'Local', custom: 'Custom' },
     connectionStatuses: { retired: 'Retired · delete it', reauth: 'Sign-in required', disabledFailed: 'Unavailable · last connection failed', disabled: 'Unavailable', failed: 'Last connection failed' },
     lastTest: {
+      auth: 'Authentication failed', timeout: 'Request timed out', provider_unavailable: 'Model service returned an error', network: 'Network error', invalid_response: 'Model service returned an error', unknown: 'Connection test failed',
       '连接已验证': 'Connection verified', '鉴权失败': 'Authentication failed', '请求超时': 'Request timed out', '网络错误': 'Network error', '模型服务返回错误': 'Model service returned an error', '连接测试失败': 'Connection test failed',
       'connection verified': 'Connection verified', 'authentication failed': 'Authentication failed', 'request timed out': 'Request timed out', 'network error': 'Network error', 'provider returned an error': 'Model service returned an error', 'connection test failed': 'Connection test failed',
       'claude oauth 未登录。': 'Claude OAuth is signed out.', 'claude oauth 本地凭据读取失败。': 'Could not read local Claude OAuth credentials.', 'claude oauth 需要重新登录。': 'Claude OAuth requires sign-in.', 'claude oauth 已登录。': 'Claude OAuth is signed in.', 'claude oauth 已退出登录。': 'Claude OAuth signed out.',

apps/desktop/src/renderer/locales/settings-health-copy.ts

@@ -19,6 +19,7 @@
 
 import type { StatusSemantic } from '@maka/ui';
 import type {
+  HealthConnectionTestErrorClass,
   HealthSignal,
   HealthSignalDetail,
   HealthSignalLayer,
@@ -178,20 +179,24 @@ const signalMessagesEn: Record<HealthSignalMessageCode, string> = {
   capability_degraded: 'The capability runtime probe is degraded.',
 };
 
-const capabilityReasonsZh: Record<string, string> = {
-  disabled: '该能力当前已关闭。',
-  'missing platform credentials': '等待填写平台凭据。',
-  'macOS TCC only': '仅 macOS 系统权限可探测。',
-  'no Electron API for per-target Apple Events TCC status': '系统未提供可直接读取的授权状态。',
-};
-
-const capabilityReasonsEn: Record<string, string> = {
-  disabled: 'This capability is currently turned off.',
-  'missing platform credentials': 'Waiting for platform credentials.',
-  'macOS TCC only': 'Only macOS TCC permissions can be probed.',
-  'no Electron API for per-target Apple Events TCC status':
-    'The system exposes no readable authorization status.',
-};
+const connectionTestErrorMessages = {
+  zh: {
+    auth: '鉴权失败',
+    timeout: '请求超时',
+    provider_unavailable: '模型服务返回错误',
+    network: '网络错误',
+    invalid_response: '模型服务返回错误',
+    unknown: '连接测试失败',
+  },
+  en: {
+    auth: 'Authentication failed',
+    timeout: 'Request timed out',
+    provider_unavailable: 'Model service returned an error',
+    network: 'Network error',
+    invalid_response: 'Model service returned an error',
+    unknown: 'Connection test failed',
+  },
+} satisfies UiCatalog<Record<HealthConnectionTestErrorClass, string>>;
 
 function signalDetailZh(detail: HealthSignalDetail | undefined): string | undefined {
   if (!detail) return undefined;
@@ -211,12 +216,11 @@ function signalDetailZh(detail: HealthSignalDetail | undefined): string | undefi
         ...(detail.errorClass ? [`错误类型=${detail.errorClass}`] : []),
       ].join(' · ');
     case 'capability_reason':
-      // Unknown reasons pass through verbatim: they are today's zh snapshot
-      // diagnostics; the capability-snapshot producer is code-ized separately.
-      return capabilityReasonsZh[detail.reason] ?? detail.reason;
+      return '状态详情请见对应设置页。';
+    case 'last_test_error_class':
+      return connectionTestErrorMessages.zh[detail.errorClass];
     case 'last_test_message':
-      // Raw connection-test diagnostic, rendered verbatim by design.
-      return detail.text;
+      return '连接测试状态暂时无法显示，请重新测试。';
   }
 }
 
@@ -238,9 +242,10 @@ function signalDetailEn(detail: HealthSignalDetail | undefined): string | undefi
         ...(detail.errorClass ? [`Error type=${detail.errorClass}`] : []),
       ].join(' · ');
     case 'capability_reason':
-      return capabilityReasonsEn[detail.reason] ?? 'See the corresponding settings page for details.';
+      return 'See the corresponding settings page for details.';
+    case 'last_test_error_class':
+      return connectionTestErrorMessages.en[detail.errorClass];
     case 'last_test_message':
-      // Raw connection-test diagnostic, rendered verbatim by design.
-      return detail.text;
+      return 'The connection test status is temporarily unavailable. Test again.';
   }
 }

apps/desktop/stories/settings/settings-pages.stories.tsx

@@ -589,16 +589,6 @@ const capabilitySnapshot: CapabilitySnapshotCollection = {
 };
 
 const healthSignals: HealthSignal[] = [
-  {
-    id: 'app:config',
-    label: '应用配置',
-    scope: 'app',
-    layer: 'configuration',
-    status: 'ok',
-    source: 'settings',
-    checkedAt: NOW - 60_000,
-    message: 'capability_ok',
-  },
   {
     id: 'conn:zai-live',
     label: 'Z.AI Live',
@@ -646,16 +636,6 @@ const healthSignals: HealthSignal[] = [
     relatedCapabilityId: 'computer_use',
     blocksCapability: true,
   },
-  {
-    id: 'storage:sessions',
-    label: '会话存储',
-    scope: 'storage',
-    layer: 'storage',
-    status: 'ok',
-    source: 'storage',
-    checkedAt: NOW - 60_000,
-    message: 'capability_ok',
-  },
 ];
 
 const healthSnapshot: HealthSnapshot = buildHealthSnapshot(NOW - 45_000, healthSignals);
@@ -2598,8 +2578,8 @@ export const HealthCenter: Story = {
       expect(errorFilter).toHaveAttribute('aria-pressed', 'true');
       expect(canvas.getByText('OpenAI Review')).toBeInTheDocument();
       expect(canvas.queryByText('Z.AI Live')).not.toBeInTheDocument();
-      expect(canvas.getByText('全部健康信号中，1/6 条会阻塞发送')).toBeInTheDocument();
-      expect(canvas.getByText('全部健康信号中，1/6 条会阻塞能力')).toBeInTheDocument();
+      expect(canvas.getByText('全部健康信号中，1/4 条会阻塞发送')).toBeInTheDocument();
+      expect(canvas.getByText('全部健康信号中，1/4 条会阻塞能力')).toBeInTheDocument();
     });
     await userEvent.click(errorFilter);
     await waitFor(() => {

packages/core/src/__tests__/health.test.ts

@@ -44,6 +44,23 @@ describe('HealthSignal contract', () => {
     assert.strictEqual(result.source, 'connection_test');
   });
 
+  test('separates connection test error classes from legacy diagnostics', () => {
+    const coded = healthSignalFromConnection(
+      connection({ lastTestStatus: 'needs_reauth', lastTestMessage: 'auth' }),
+      20,
+    );
+    assert.deepStrictEqual(coded.detail, { kind: 'last_test_error_class', errorClass: 'auth' });
+
+    const legacy = healthSignalFromConnection(
+      connection({ lastTestStatus: 'error', lastTestMessage: 'HTTP 502 upstream failure' }),
+      20,
+    );
+    assert.deepStrictEqual(legacy.detail, {
+      kind: 'last_test_message',
+      text: 'HTTP 502 upstream failure',
+    });
+  });
+
   test('a missing default model warns only when the workspace has no default target', () => {
     // The catalog projects `defaultModel` onto exactly one connection (the
     // default target). With a default configured elsewhere, an enabled

packages/core/src/health.ts

@@ -65,6 +65,14 @@ export type HealthSignalMessageCode =
   | 'capability_denied'
   | 'capability_degraded';
 
+export type HealthConnectionTestErrorClass =
+  | 'auth'
+  | 'timeout'
+  | 'provider_unavailable'
+  | 'network'
+  | 'invalid_response'
+  | 'unknown';
+
 export type HealthSignalDetail =
   | { kind: 'validation_scope_note' }
   | { kind: 'no_models_enabled_hint' }
@@ -74,8 +82,8 @@ export type HealthSignalDetail =
   // Raw machine token from the capability snapshot; the presenter maps the
   // known vocabulary per locale and falls back to a generic hint.
   | { kind: 'capability_reason'; reason: string }
-  // Raw connection-test diagnostic passthrough (producer text, not product
-  // copy); the presenter renders it verbatim in both locales.
+  | { kind: 'last_test_error_class'; errorClass: HealthConnectionTestErrorClass }
+  // Legacy connection-test diagnostic; the presenter uses locale-specific fallback copy.
   | { kind: 'last_test_message'; text: string };
 
 export interface HealthSignal {
@@ -228,7 +236,7 @@ export function healthSignalFromConnection(
       checkedAt: timeFromIso(connection.lastTestAt) ?? checkedAt,
       message: 'needs_reauth',
       ...(connection.lastTestMessage
-        ? { detail: { kind: 'last_test_message', text: connection.lastTestMessage } }
+        ? { detail: connectionLastTestDetail(connection.lastTestMessage) }
         : {}),
       blocksSend: true,
     };
@@ -245,7 +253,7 @@ export function healthSignalFromConnection(
       checkedAt: timeFromIso(connection.lastTestAt) ?? checkedAt,
       message: 'validation_failed',
       ...(connection.lastTestMessage
-        ? { detail: { kind: 'last_test_message', text: connection.lastTestMessage } }
+        ? { detail: connectionLastTestDetail(connection.lastTestMessage) }
         : {}),
       blocksSend: true,
     };
@@ -402,6 +410,21 @@ function capabilityDetail(capability: CapabilitySnapshot): HealthSignalDetail |
   return reason ? { kind: 'capability_reason', reason } : undefined;
 }
 
+function connectionLastTestDetail(message: string): HealthSignalDetail {
+  const normalized = message.trim().toLowerCase();
+  switch (normalized) {
+    case 'auth':
+    case 'timeout':
+    case 'provider_unavailable':
+    case 'network':
+    case 'invalid_response':
+    case 'unknown':
+      return { kind: 'last_test_error_class', errorClass: normalized };
+    default:
+      return { kind: 'last_test_message', text: message };
+  }
+}
+
 function timeFromIso(value: string | undefined): number | undefined {
   if (!value) return undefined;
   const parsed = Date.parse(value);