fix(i18n): emit settings expected-result codes from producers

Settings-area producers (memory, data, permission center, connection
test, computer-use health, dev dialogs) emitted zh prose that reached en
users verbatim, and presenters sniffed CJK to decide whether to show it.
Producers now return stable codes; each settings catalog maps its codes
per locale with an explicit unknown fallback.

Generated-by: Claude Code

Author: orangeCatDeveloper

apps/desktop/src/main/__tests__/computer-use-host.test.ts

@@ -36,27 +36,27 @@ describe('Computer Use host health', () => {
   it('does not report a binary-only executor as healthy before first use', () => {
     assert.deepEqual(computerUseServiceHealth('maka-cu', snapshot('idle')), {
       state: 'not_run',
-      reason: 'maka-cu 已可用，将在首次调用时启动。',
+      reason: 'cu_executor_lazy_start',
     });
   });
 
   it('reports ready, recovery, and unavailable states', () => {
     assert.equal(computerUseServiceHealth('maka-cu', snapshot('ready')).state, 'healthy');
     assert.equal(
       computerUseServiceHealth('maka-cu', snapshot('backing_off')).reason,
-      'maka-cu executor 正在启动或恢复。',
+      'cu_executor_recovering',
     );
     assert.equal(
       computerUseServiceHealth('maka-cu', snapshot('starting')).state,
       'degraded',
     );
     assert.deepEqual(computerUseServiceHealth('maka-cu', snapshot('unavailable')), {
       state: 'not_available',
-      reason: 'maka-cu executor 启动失败或已退出。',
+      reason: 'cu_executor_start_failed',
     });
     assert.deepEqual(computerUseServiceHealth('maka-cu', snapshot('disposed')), {
       state: 'not_available',
-      reason: 'maka-cu executor 已停止。',
+      reason: 'cu_executor_stopped',
     });
   });
 

apps/desktop/src/main/__tests__/github-copilot-local-credential.test.ts

@@ -71,7 +71,7 @@ describe('importGitHubCopilotLocalCredential', () => {
     assert.equal(imported.result.ok, false);
     if (!imported.result.ok) {
       assert.equal(imported.result.reason, 'token_exchange_failed');
-      assert.match(imported.result.message, /不支持 classic PAT/);
+      assert.equal(imported.result.code, 'copilot_classic_pat_unsupported');
       assert.equal(imported.result.message.includes('ghp_classic_pat'), false);
     }
     assert.equal(imported.secret, undefined);
@@ -83,7 +83,7 @@ describe('importGitHubCopilotLocalCredential', () => {
     });
 
     assert.equal(imported.result.ok, false);
-    if (!imported.result.ok) assert.match(imported.result.message, /凭据类型不受支持/);
+    if (!imported.result.ok) assert.equal(imported.result.code, 'copilot_credential_type_unsupported');
     assert.equal(imported.secret, undefined);
   });
 
@@ -95,7 +95,7 @@ describe('importGitHubCopilotLocalCredential', () => {
     });
 
     assert.equal(imported.result.ok, false);
-    if (!imported.result.ok) assert.match(imported.result.message, /未找到可导入/);
+    if (!imported.result.ok) assert.equal(imported.result.code, 'copilot_local_credential_missing');
     assert.equal(imported.secret, undefined);
   });
 });

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

@@ -25,3 +25,29 @@ test('presents a granted OS permission as a verified success', () => {
   assert.equal(getPermissionCenterCopy('zh').osStates.granted.tone, 'success');
   assert.equal(getPermissionCenterCopy('en').osStates.granted.tone, 'success');
 });
+
+test('renders capability reason codes per locale', () => {
+  const zh = getPermissionCenterCopy('zh');
+  const en = getPermissionCenterCopy('en');
+  assert.equal(zh.reasons['missing platform credentials'], '未配置平台凭据');
+  assert.equal(en.reasons['missing platform credentials'], 'Platform credentials are not configured');
+  assert.equal(zh.reasons.cu_executor_recovering, 'maka-cu executor 正在启动或恢复。');
+  assert.equal(en.reasons.cu_executor_recovering, 'The maka-cu executor is starting or recovering.');
+});
+
+test('composes the computer-use backend status from snapshot facts per locale', () => {
+  const zh = getPermissionCenterCopy('zh');
+  const en = getPermissionCenterCopy('en');
+  assert.equal(
+    zh.cuBackendStatus(['辅助功能', '屏幕录制'], 'healthy'),
+    'maka-cu artifact 已通过本地完整性检查。等待辅助功能、屏幕录制权限。操作与截图 service 已就绪；按目标与动作类别授权后可操作本机应用。',
+  );
+  assert.equal(
+    zh.cuBackendStatus([], 'not_run'),
+    'maka-cu artifact 已通过本地完整性检查。service 将在首次调用时启动；按目标与动作类别授权后可操作本机应用。',
+  );
+  assert.equal(
+    en.cuBackendStatus(['Accessibility'], 'degraded'),
+    'The maka-cu artifact passed the local integrity check. Waiting for Accessibility permission. The maka-cu service is starting or recovering.',
+  );
+});

apps/desktop/src/main/__tests__/runtime-host-artifacts-ipc-main.test.ts

@@ -52,6 +52,7 @@ function attachmentReadHandler(
 ): Handler {
   const handlers = new Map<string, Handler>();
   registerRuntimeHostArtifactsIpc({
+    uiLocale: () => 'zh' as const,
     ipcMain: {
       handle: (channel, handler) => handlers.set(channel, handler as Handler),
     },
@@ -121,6 +122,7 @@ test("Runtime Host Artifact IPC preserves previews and streams complete exports"
 
   try {
     registerRuntimeHostArtifactsIpc({
+    uiLocale: () => 'zh' as const,
       ipcMain: {
         handle: (channel, handler) => handlers.set(channel, handler as Handler),
       },

apps/desktop/src/main/__tests__/runtime-host-memory-ipc-main.test.ts

@@ -175,6 +175,7 @@ test('does not project or open remote Runtime Host file paths', async () => {
   assert.deepEqual(projected.backups.map(({ path }) => path), ['']);
   assert.deepEqual(opened, {
     ok: false,
+    code: 'remote_host_owned',
     message: 'Memory files are owned by the remote Runtime Host',
   });
 });

apps/desktop/src/main/__tests__/settings-test-result-copy.test.ts

@@ -37,3 +37,13 @@ test("missing proxy credentials have actionable bilingual copy", () => {
     "Proxy authentication is enabled. Enter a proxy password before testing.",
   );
 });
+
+test("renders the disabled-direct proxy code per locale", () => {
+  const result = { ok: true, code: "proxy_disabled_direct", message: "direct" } as never;
+  assert.equal(settingsTestResultMessage(result, "zh"), "代理未启用，当前会直接连接。");
+  assert.equal(
+    settingsTestResultMessage(result, "en"),
+    "The proxy is disabled; connections go direct.",
+  );
+});
+

apps/desktop/src/main/browser-message-box.ts

@@ -17,6 +17,7 @@
  * under the License.
  */
 
+import type { UiCatalog } from '@maka/core/ui-locale';
 import { randomUUID } from 'node:crypto';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -348,7 +349,7 @@ export function buildBrowserMessageBoxHtml(
 
 function renderBrowserMessageBoxHtml(input: BrowserMessageBoxPresentation): string {
   const nonce = randomUUID().replaceAll('-', '');
-  const closeLabel = input.locale === 'zh' ? '关闭' : 'Close';
+  const closeLabel = CLOSE_LABEL[input.locale];
   const closeButton = `<button class="window-close" type="button" data-response="${input.cancelId}" aria-label="${closeLabel}">
     <svg viewBox="0 0 24 24" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12" /></svg>
   </button>`;
@@ -638,3 +639,5 @@ function escapeHtml(value: string): string {
     return entities[character] ?? character;
   });
 }
+
+const CLOSE_LABEL = { zh: '关闭', en: 'Close' } satisfies UiCatalog<string>;

apps/desktop/src/main/capability-snapshot.ts

@@ -27,6 +27,7 @@ import {
   type CapabilityFeatureSignal,
   type CapabilityMemoryAcceptanceSignal,
   type CapabilityPermissionRequirement,
+  type CapabilityReasonCode,
   type CapabilityRuntimeProbeSignal,
   type CapabilitySnapshot,
   type CapabilitySnapshotCollection,
@@ -80,7 +81,7 @@ export function buildCapabilitySnapshotCollection(input: {
       feature: {
         state: 'partial',
         source: 'runtime',
-        reason: 'Daily Review 已聚合本地任务 / 工具 / 模型活动；当前不包含屏幕与应用级录制',
+        reason: 'activity_recorder_partial',
       },
       requiredPermissions: [
         { id: 'screen_recording', required: false, status: permissions.screen_recording.status },
@@ -90,7 +91,7 @@ export function buildCapabilitySnapshotCollection(input: {
       runtimeProbe: {
         state: 'not_run',
         source: 'runtime_probe',
-        reason: '打开 Daily Review 可查看本地活动聚合结果',
+        reason: 'activity_recorder_probe_hint',
       },
     }),
     staticCapability({
@@ -100,15 +101,15 @@ export function buildCapabilitySnapshotCollection(input: {
       feature: {
         state: 'partial',
         source: 'runtime',
-        reason: '本地 MEMORY.md 已可见；自动抽取/写入仍需用户确认',
+        reason: 'memory_partial',
       },
       requiredPermissions: [],
       actionApproval: { state: 'not_required', source: 'not_applicable' },
       memoryAcceptance: { state: 'draft_required', source: 'memory_contract' },
       runtimeProbe: {
         state: 'not_run',
         source: 'runtime_probe',
-        reason: '透明本地记忆为文件读写能力，不做后台探测',
+        reason: 'memory_no_probe',
       },
     }),
     ...BOT_PROVIDERS.map((provider) =>
@@ -138,7 +139,7 @@ function computerUseCapability(
     feature: {
       state: artifactAvailable ? 'enabled' : 'not_available',
       source: 'runtime',
-      reason: computerUseCapabilityReason(input, permissions),
+      reason: computerUseCapabilityReason(input),
     },
     requiredPermissions: [
       { id: 'accessibility', required: true, status: permissions.accessibility.status },
@@ -153,45 +154,24 @@ function computerUseCapability(
       state: input?.health.state ?? 'not_available',
       source: 'runtime_probe',
       lastCheckedAt: now,
-      reason: input?.health.reason ?? 'Computer Use 后端当前不可用。',
+      reason: input?.health.reason ?? 'cu_backend_unavailable',
     },
   });
 }
 
+// The presenter composes the full 'cu_backend_status' sentence from data the
+// same snapshot already carries (required-permission statuses and the runtime
+// probe state), so the reason stays a bare code.
 function computerUseCapabilityReason(
   input: {
     backendId: CuBackendId | 'none';
     health: ReturnType<typeof computerUseServiceHealth>;
   } | undefined,
-  permissions: PermissionSnapshot['permissions'],
 ): string {
   if (input === undefined || input.backendId === 'none') {
-    return '未找到通过完整性检查的 Computer Use 执行器 artifact。';
-  }
-
-  const reasons = [`${input.backendId} artifact 已通过本地完整性检查。`];
-  const missingPermissions = [
-    ['辅助功能', permissions.accessibility.status],
-    ['屏幕录制', permissions.screen_recording.status],
-  ].filter((entry) => entry[1] !== 'granted').map((entry) => entry[0]);
-  if (missingPermissions.length > 0) {
-    reasons.push(`等待${missingPermissions.join('、')}权限。`);
+    return 'cu_artifact_missing';
   }
-  switch (input.health.state) {
-    case 'not_available':
-      reasons.push(`${input.backendId} service 启动失败、已退出或已停止。`);
-      break;
-    case 'degraded':
-      reasons.push(`${input.backendId} service 正在启动或恢复。`);
-      break;
-    case 'healthy':
-      reasons.push('操作与截图 service 已就绪；按目标与动作类别授权后可操作本机应用。');
-      break;
-    case 'not_run':
-      reasons.push('service 将在首次调用时启动；按目标与动作类别授权后可操作本机应用。');
-      break;
-  }
-  return reasons.join('');
+  return 'cu_backend_status';
 }
 
 function staticCapability(input: {
@@ -243,7 +223,7 @@ function botCapability(
   };
   const configuration: CapabilityConfigurationSignal = hasConfig
     ? { state: 'present', source: 'settings' }
-    : { state: 'missing', source: 'settings', reason: '未配置平台凭据' };
+    : { state: 'missing', source: 'settings', reason: 'missing platform credentials' };
   const runtimeProbe = runtimeProbeFromBotReadiness(
     status.readiness,
     channel.readinessUpdatedAt,
@@ -274,20 +254,20 @@ function botCapability(
 }
 
 function accessibilitySnapshot(now: number, platform: NodeJS.Platform): OsPermissionSnapshot {
-  if (platform !== 'darwin') return unsupportedPermission('accessibility', now, '仅 macOS TCC 权限适用');
+  if (platform !== 'darwin') return unsupportedPermission('accessibility', now, 'macOS TCC only');
   try {
     const granted = systemPreferences.isTrustedAccessibilityClient(false);
     return {
       id: 'accessibility',
       status: granted ? 'granted' : 'not_determined',
       source: 'electron',
       checkedAt: now,
-      reason: granted ? undefined : 'macOS 不区分辅助功能权限是未授权还是未申请',
+      reason: granted ? undefined : 'accessibility_status_ambiguous',
       canOpenSettings: true,
       canRequest: false,
     };
   } catch (error) {
-    return unknownPermission('accessibility', now, generalizedReason(error), true);
+    return unknownPermission('accessibility', now, error, true);
   }
 }
 
@@ -298,11 +278,7 @@ function mediaPermissionSnapshot(
   platform: NodeJS.Platform,
 ): OsPermissionSnapshot {
   if (!supportsMediaPermissionProbe(id, platform)) {
-    return unsupportedPermission(
-      id,
-      now,
-      '屏幕录制权限状态仅能在 macOS 上读取',
-    );
+    return unsupportedPermission(id, now, 'screen_recording_status_mac_only');
   }
   try {
     const status = mapMediaAccessStatus(systemPreferences.getMediaAccessStatus(mediaType));
@@ -315,7 +291,7 @@ function mediaPermissionSnapshot(
       ...actions,
     };
   } catch (error) {
-    return unknownPermission(id, now, generalizedReason(error), platform === 'darwin');
+    return unknownPermission(id, now, error, platform === 'darwin');
   }
 }
 
@@ -328,9 +304,9 @@ function notificationSnapshot(now: number, platform: NodeJS.Platform): OsPermiss
     checkedAt: now,
     reason: supported
       ? platform === 'darwin'
-        ? 'Electron 无法可靠读取 macOS 通知授权状态，请在系统设置中确认'
-        : 'Electron 无法可靠读取当前系统的通知授权状态'
-      : 'Electron 通知能力不可用',
+        ? 'notifications_status_unreadable_macos'
+        : 'notifications_status_unreadable'
+      : 'notifications_unsupported',
     canOpenSettings: platform === 'darwin',
     // Showing a Notification is not an authorization API and does not report
     // whether macOS delivered or suppressed it. Never present that probe as a
@@ -340,19 +316,23 @@ function notificationSnapshot(now: number, platform: NodeJS.Platform): OsPermiss
 }
 
 function automationSnapshot(now: number, platform: NodeJS.Platform): OsPermissionSnapshot {
-  if (platform !== 'darwin') return unsupportedPermission('automation', now, '仅 macOS TCC 权限适用');
+  if (platform !== 'darwin') return unsupportedPermission('automation', now, 'macOS TCC only');
   return {
     id: 'automation',
     status: 'unknown',
     source: 'static',
     checkedAt: now,
-    reason: 'Electron 暂不支持读取逐 App 的 Apple Events 授权状态',
+    reason: 'no Electron API for per-target Apple Events TCC status',
     canOpenSettings: true,
     canRequest: false,
   };
 }
 
-function unsupportedPermission(id: OsPermissionId, now: number, reason: string): OsPermissionSnapshot {
+function unsupportedPermission(
+  id: OsPermissionId,
+  now: number,
+  reason: CapabilityReasonCode,
+): OsPermissionSnapshot {
   return {
     id,
     status: 'unsupported',
@@ -367,20 +347,19 @@ function unsupportedPermission(id: OsPermissionId, now: number, reason: string):
 function unknownPermission(
   id: OsPermissionId,
   now: number,
-  reason: string,
+  error: unknown,
   canOpenSettings: boolean,
 ): OsPermissionSnapshot {
   return {
     id,
     status: 'unknown',
     source: 'electron',
     checkedAt: now,
-    reason,
+    reason: 'permission_probe_failed',
+    // Raw probe error text passes through verbatim as diagnostic detail; the
+    // presenter renders it beside the localized 'permission_probe_failed' copy.
+    ...(error instanceof Error && error.message ? { detail: error.message } : {}),
     canOpenSettings,
     canRequest: false,
   };
 }
-
-function generalizedReason(error: unknown): string {
-  return error instanceof Error ? error.message : 'permission probe failed';
-}