Add Spanish localization and persistent GUI language preferences to MemHub

Co-authored-by: Cursor <cursoragent@cursor.com>

memhub/apps/desktop/src/application-menu.test.ts

@@ -1,7 +1,46 @@
+import type { LanguageSnapshot } from "@one-memory/contracts/gui-i18n";
 import { expect, it, vi } from "vitest";
 
 import { installApplicationMenu } from "./application-menu";
 
+it("rebuilds translated labels from committed language updates without exporting", () => {
+  let change: (() => void) | undefined;
+  const snapshot: LanguageSnapshot = {
+    preference: "es",
+    locale: "es",
+    revision: 1,
+  };
+  const unsubscribe = vi.fn();
+  const read = vi.fn(() => snapshot);
+  const buildMenu = vi.fn(() => ({}) as never);
+  const dispose = installApplicationMenu({
+    productName: "MemHub",
+    buildMenu,
+    setMenu: vi.fn(),
+    exportLogs: async () => {},
+    reportError: vi.fn(),
+    language: {
+      read,
+      subscribe: (listener) => {
+        change = () => listener(snapshot);
+        return unsubscribe;
+      },
+    },
+  });
+  expect(buildMenu).toHaveBeenLastCalledWith(
+    expect.arrayContaining([expect.objectContaining({ label: "Ayuda" })]),
+  );
+  snapshot.locale = "zh-CN";
+  change?.();
+  expect(read).toHaveBeenCalledTimes(2);
+  expect(buildMenu).toHaveBeenCalledTimes(2);
+  expect(buildMenu).toHaveBeenLastCalledWith(
+    expect.arrayContaining([expect.objectContaining({ label: "帮助" })]),
+  );
+  dispose();
+  expect(unsubscribe).toHaveBeenCalledTimes(1);
+});
+
 it("exports logs from Help without requiring a renderer window", async () => {
   const exportLogs = vi.fn(async () => undefined);
   let template: Array<Record<string, unknown>> = [];

memhub/apps/desktop/src/application-menu.ts

@@ -1,36 +1,49 @@
+import { translate } from "@one-memory/contracts/gui-i18n";
 import type { Menu, MenuItemConstructorOptions } from "electron";
+import type { NativeLanguageSource } from "./native-language";
 
 export function installApplicationMenu(options: {
   productName: string;
+  language?: NativeLanguageSource;
   buildMenu(template: MenuItemConstructorOptions[]): Menu;
   setMenu(menu: Menu): void;
   exportLogs(): Promise<void>;
   reportError(message: string): void;
-}): void {
+}): () => void {
   const runExport = async () => {
     try {
       await options.exportLogs();
     } catch {
-      options.reportError("日志未能导出，请稍后重试。");
+      options.reportError(
+        translate(
+          options.language?.read().locale ?? "zh-CN",
+          "nativeExportError",
+        ),
+      );
     }
   };
-  options.setMenu(
-    options.buildMenu([
-      {
-        label: options.productName,
-        submenu: [{ role: "about" }, { type: "separator" }, { role: "quit" }],
-      },
-      { role: "editMenu" },
-      { role: "windowMenu" },
-      {
-        label: "帮助",
-        submenu: [
-          {
-            label: "导出日志（发给开发排查）",
-            click: runExport,
-          },
-        ],
-      },
-    ]),
-  );
+  const refresh = () => {
+    const locale = options.language?.read().locale ?? "zh-CN";
+    options.setMenu(
+      options.buildMenu([
+        {
+          label: options.productName,
+          submenu: [{ role: "about" }, { type: "separator" }, { role: "quit" }],
+        },
+        { role: "editMenu" },
+        { role: "windowMenu" },
+        {
+          label: translate(locale, "nativeHelp"),
+          submenu: [
+            {
+              label: translate(locale, "nativeExportLogs"),
+              click: runExport,
+            },
+          ],
+        },
+      ]),
+    );
+  };
+  refresh();
+  return options.language?.subscribe(refresh) ?? (() => {});
 }

memhub/apps/desktop/src/background-tray.test.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from "node:events";
+import type { LanguageSnapshot } from "@one-memory/contracts/gui-i18n";
 import type {
   App,
   Menu,
@@ -25,6 +26,12 @@ function fixture(
     enabled: false,
     status: "disabled",
   };
+  let changed: (() => void) | undefined;
+  const languageSnapshot: LanguageSnapshot = {
+    preference: "zh-CN",
+    locale: "zh-CN",
+    revision: 1,
+  };
   const app = { isPackaged: packaged, quit: vi.fn() };
   const tray = Object.assign(new EventEmitter(), {
     setToolTip: vi.fn(),
@@ -49,6 +56,15 @@ function fixture(
     installBackgroundTray({
       app: app as unknown as App,
       platform,
+      language: {
+        read: () => languageSnapshot,
+        subscribe: (listener) => {
+          changed = () => listener(languageSnapshot);
+          return () => {
+            changed = undefined;
+          };
+        },
+      },
       resourcesPath: "/bundle/Contents/Resources",
       appPath: "/repo/apps/desktop",
       createImage: vi.fn(() => image as unknown as NativeImage),
@@ -80,6 +96,10 @@ function fixture(
     install,
     menu,
     click,
+    changeLanguage(locale: LanguageSnapshot["locale"]) {
+      languageSnapshot.locale = locale;
+      changed?.();
+    },
     setState(value: LoginPreference) {
       state = value;
     },
@@ -87,6 +107,26 @@ function fixture(
 }
 
 describe("native macOS background tray", () => {
+  it("rebuilds Spanish and Chinese labels without changing login or stopping services", async () => {
+    const f = fixture();
+    f.install();
+    await flush();
+    f.changeLanguage("es");
+    await flush();
+    expect(f.menu()[0]?.label).toBe("Abrir MemHub");
+    expect(f.menu()[1]?.label).toBe("Iniciar MemHub al iniciar sesión");
+    expect(f.menu()[3]?.label).toBe(
+      "Salir de MemHub (el servicio sigue en segundo plano)",
+    );
+    expect(f.setLoginPreference).not.toHaveBeenCalled();
+    f.click(0);
+    expect(f.open).toHaveBeenCalledOnce();
+    f.changeLanguage("zh-CN");
+    await flush();
+    expect(f.menu()[0]?.label).toBe("打开 MemHub");
+    f.click(3);
+    expect(f.app.quit).toHaveBeenCalledOnce();
+  });
   it("reads and changes the unified Runtime login preference", async () => {
     const f = fixture();
     const dispose = f.install();

memhub/apps/desktop/src/background-tray.ts

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { type MessageKey, translate } from "@one-memory/contracts/gui-i18n";
 import type {
   App,
   Menu,
@@ -7,6 +8,7 @@ import type {
   Tray,
 } from "electron";
 import type { LoginPreference } from "./login-preference";
+import type { NativeLanguageSource } from "./native-language";
 
 export const LOGIN_SERVICE_NAME = "com.tencent.onememory.runtime.plist";
 
@@ -24,6 +26,7 @@ interface TrayOptions {
   setLoginPreference(enabled: boolean): Promise<LoginPreference>;
   allowLoginStartup?: boolean;
   productName?: string;
+  language?: NativeLanguageSource;
 }
 
 export function installBackgroundTray(options: TrayOptions): () => void {
@@ -41,29 +44,32 @@ export function installBackgroundTray(options: TrayOptions): () => void {
   let generation = 0;
   const refresh = async () => {
     if (disposed) return;
+    const locale = options.language?.read().locale ?? "zh-CN";
+    const t = (key: MessageKey) =>
+      translate(locale, key, { product: productName });
     const current = ++generation;
     let checked = false;
     let enabled = app.isPackaged && options.allowLoginStartup !== false;
-    let label = `登录时启动 ${productName}`;
+    let label = t("nativeLogin");
     if (options.allowLoginStartup === false) {
-      label += "（阶段包不可用）";
+      label += t("nativeTrialUnavailable");
     } else if (app.isPackaged) {
       try {
         const state = await options.readLoginPreference();
         if (disposed || current !== generation) return;
         checked = state.enabled;
         enabled = state.supported;
-        if (state.status === "managed-by-cli") label += "（由 CLI 管理）";
+        if (state.status === "managed-by-cli") label += t("nativeCliManaged");
       } catch {
-        label += "（状态不可用）";
+        label += t("nativeStatusUnavailable");
         enabled = false;
       }
     } else {
-      label += "（开发模式不可用）";
+      label += t("nativeDevelopmentUnavailable");
     }
     tray.setContextMenu(
       options.buildMenu([
-        { label: `打开 ${productName}`, click: options.open },
+        { label: t("nativeOpen"), click: options.open },
         {
           label,
           type: "checkbox",
@@ -74,14 +80,19 @@ export function installBackgroundTray(options: TrayOptions): () => void {
             void options
               .setLoginPreference(item.checked)
               .catch(() =>
-                options.reportError("无法更改登录启动设置，请重试。"),
+                options.reportError(
+                  translate(
+                    options.language?.read().locale ?? "zh-CN",
+                    "nativeLoginError",
+                  ),
+                ),
               )
               .finally(() => void refresh());
           },
         },
         { type: "separator" },
         {
-          label: `退出 ${productName}（后台服务继续运行）`,
+          label: t("nativeQuit"),
           click: () => {
             if (!disposed) app.quit();
           },
@@ -89,6 +100,7 @@ export function installBackgroundTray(options: TrayOptions): () => void {
       ]),
     );
   };
+  const unsubscribeLanguage = options.language?.subscribe(() => void refresh());
   try {
     void refresh();
     // Refresh before the native menu opens, including changes made in Settings.
@@ -101,6 +113,7 @@ export function installBackgroundTray(options: TrayOptions): () => void {
   return () => {
     if (disposed) return;
     disposed = true;
+    unsubscribeLanguage?.();
     tray.removeAllListeners("mouse-down");
     tray.removeAllListeners("right-click");
     tray.destroy();

memhub/apps/desktop/src/desktop-lifecycle.test.ts

@@ -50,6 +50,7 @@ interface Overrides {
   whenReady?: Promise<void>;
   windowGate?: Promise<void>;
   windowError?: Error;
+  beforeNativeUi?: () => Promise<void>;
 }
 
 function fixture(background = false, lock = true, overrides: Overrides = {}) {
@@ -81,6 +82,7 @@ function fixture(background = false, lock = true, overrides: Overrides = {}) {
     platform: overrides.platform ?? "darwin",
     background,
     prepare,
+    beforeNativeUi: overrides.beforeNativeUi,
     initialize,
     stop,
     dispose,
@@ -129,6 +131,35 @@ function fixture(background = false, lock = true, overrides: Overrides = {}) {
 }
 
 describe("desktop background lifecycle with injected Electron", () => {
+  it("awaits the post-readiness language hook before menus, tray and runtime", async () => {
+    const gate = deferred();
+    const beforeNativeUi = vi.fn(() => gate.promise);
+    const f = fixture(false, true, { beforeNativeUi });
+    expect(beforeNativeUi).not.toHaveBeenCalled();
+    f.ready.resolve();
+    await f.flush();
+    expect(beforeNativeUi).toHaveBeenCalledTimes(1);
+    expect(f.installTray).not.toHaveBeenCalled();
+    expect(f.initialize).not.toHaveBeenCalled();
+    gate.resolve();
+    f.starting.resolve();
+    await f.flush();
+    expect(f.installTray).toHaveBeenCalledTimes(1);
+    expect(f.windows).toHaveLength(1);
+  });
+  it("does not install native UI after quitting during the language hook", async () => {
+    const gate = deferred();
+    const f = fixture(false, true, { beforeNativeUi: () => gate.promise });
+    f.ready.resolve();
+    await f.flush();
+    f.quit();
+    gate.resolve();
+    await f.flush();
+    expect(f.installTray).not.toHaveBeenCalled();
+    expect(f.initialize).not.toHaveBeenCalled();
+    f.stopping.resolve();
+    await f.flush();
+  });
   it("starts services and tray without a window in background mode", async () => {
     const f = fixture(true);
     await f.boot();

memhub/apps/desktop/src/desktop-lifecycle.ts

@@ -18,6 +18,7 @@ interface LifecycleOptions {
   platform: NodeJS.Platform;
   background: boolean;
   prepare(): void;
+  beforeNativeUi?(): Promise<void>;
   initialize(isQuitting: () => boolean): Promise<void>;
   stop(): Promise<void>;
   dispose(): void;
@@ -145,6 +146,8 @@ export function startDesktopLifecycle(options: LifecycleOptions): void {
     .then(async () => {
       if (quitting) return;
       startup = Promise.resolve().then(async () => {
+        if (quitting) return;
+        await options.beforeNativeUi?.();
         if (quitting) return;
         options.installTray(open);
         await options.initialize(() => quitting);

memhub/apps/desktop/src/display-preferences-ipc.test.ts

@@ -1,4 +1,8 @@
 import { EventEmitter } from "node:events";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { translate } from "@one-memory/contracts/gui-i18n";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 interface FakeFrame {
@@ -11,13 +15,17 @@ interface FakeFrame {
 
 const fake = vi.hoisted(() => ({
   ready: undefined as (() => Promise<void>) | undefined,
-  handlers: new Map<string, (event: unknown) => unknown>(),
+  handlers: new Map<string, (event: unknown, ...args: unknown[]) => unknown>(),
   windows: [] as FakeWindow[],
   app: undefined as unknown as EventEmitter,
   theme: undefined as unknown as EventEmitter,
   renderer: undefined as unknown as EventEmitter,
   unload: undefined as unknown as EventTarget,
   packaged: true,
+  userData: "",
+  preferred: vi.fn(() => ["es-MX", "zh-CN"]),
+  locale: vi.fn(() => "zh-CN"),
+  menu: vi.fn(),
   loadFailure: false,
   reduceMotion: false as unknown,
   reduceTransparency: false as unknown,
@@ -93,7 +101,10 @@ vi.mock("electron", () => ({
       }),
       isPackaged: fake.packaged,
       getName: () => "One Memory Preview",
-      getPath: () => "/unused/display-test",
+      getPath: (name: string) =>
+        name === "userData" ? fake.userData : "/unused/display-test",
+      getPreferredSystemLanguages: fake.preferred,
+      getLocale: fake.locale,
       getAppPath: () => "/unused/display-test",
       quit: vi.fn(),
       exit: vi.fn(),
@@ -119,8 +130,10 @@ vi.mock("electron", () => ({
   },
   BrowserWindow: FakeWindow,
   ipcMain: {
-    handle: (channel: string, handler: (event: unknown) => unknown) =>
-      fake.handlers.set(channel, handler),
+    handle: (
+      channel: string,
+      handler: (event: unknown, ...args: unknown[]) => unknown,
+    ) => fake.handlers.set(channel, handler),
     removeHandler: (channel: string) => {
       fake.removeHandler(channel);
       fake.handlers.delete(channel);
@@ -138,7 +151,7 @@ vi.mock("electron", () => ({
   session: { defaultSession: {} },
   clipboard: { writeText: vi.fn() },
   dialog: { showErrorBox: fake.error },
-  Menu: { buildFromTemplate: vi.fn(() => ({})), setApplicationMenu: vi.fn() },
+  Menu: { buildFromTemplate: vi.fn(() => ({})), setApplicationMenu: fake.menu },
   shell: { openExternal: vi.fn() },
 }));
 vi.mock("@one-memory/host-bridge", () => ({
@@ -190,7 +203,8 @@ vi.mock("./core-supervisor", () => ({
   findAvailablePort: async () => 9999,
 }));
 
-beforeEach(() => {
+beforeEach(async () => {
+  fake.userData = await mkdtemp(path.join(os.tmpdir(), "memhub-language-ipc-"));
   vi.resetModules();
   vi.resetAllMocks();
   fake.app = new EventEmitter();
@@ -212,8 +226,9 @@ beforeEach(() => {
   vi.stubEnv("ONE_MEMORY_WEB_URL", "http://127.0.0.1:5173");
   vi.stubEnv("ONE_MEMORY_SMOKE_QUIT_MS", "0");
 });
-afterEach(() => {
+afterEach(async () => {
   fake.app.emit("will-quit");
+  await rm(fake.userData, { recursive: true, force: true });
   fake.unload.dispatchEvent(new Event("unload"));
   vi.unstubAllGlobals();
   vi.unstubAllEnvs();
@@ -242,6 +257,91 @@ const eventFor = (window: FakeWindow) => ({
   senderFrame: window.frame,
 });
 
+describe("GUI language main IPC", () => {
+  it("loads the active profile after ready and before native menus", async () => {
+    await writeFile(
+      path.join(fake.userData, "gui-language.json"),
+      JSON.stringify({ preference: "es" }),
+    );
+    await import("./main.js");
+    expect(fake.preferred).not.toHaveBeenCalled();
+    expect(fake.menu).not.toHaveBeenCalled();
+    await fake.ready?.();
+    expect(fake.preferred).toHaveBeenCalledTimes(1);
+    expect(fake.preferred.mock.invocationCallOrder[0]).toBeLessThan(
+      fake.menu.mock.invocationCallOrder[0],
+    );
+    const read = fake.handlers.get("one-memory:get-language-preference");
+    if (!read) throw Error("Missing language read handler");
+    expect(await read(eventFor(fake.windows[0]))).toEqual({
+      preference: "es",
+      locale: "es",
+      revision: 0,
+    });
+  });
+  it("guards both operations and broadcasts only to live owned main frames", async () => {
+    const window = await startup();
+    const read = fake.handlers.get("one-memory:get-language-preference");
+    if (!read) throw Error("Missing language read handler");
+    const write = fake.handlers.get("one-memory:set-language-preference");
+    if (!write) throw Error("Missing language write handler");
+    const foreign = new FakeWindow();
+    for (const event of [
+      eventFor(foreign),
+      {
+        sender: window.webContents,
+        senderFrame: { ...window.frame, parent: window.frame },
+      },
+      { sender: window.webContents, senderFrame: null },
+    ]) {
+      await expect(read(event)).rejects.toThrow();
+      await expect(write(event, "es")).rejects.toThrow();
+    }
+    window.frame.url = "https://example.invalid";
+    await expect(read(eventFor(window))).rejects.toThrow();
+    await expect(write(eventFor(window), "es")).rejects.toThrow();
+    window.frame.url = "one-memory://app/index.html";
+    await write(eventFor(window), "zh-CN");
+    expect(window.frame.send).toHaveBeenCalledWith(
+      "one-memory:language-preference-changed",
+      { preference: "zh-CN", locale: "zh-CN", revision: 1 },
+    );
+    expect(foreign.frame.send).not.toHaveBeenCalled();
+    window.frame.send.mockImplementation(() => {
+      throw Error("destroyed during send");
+    });
+    await expect(write(eventFor(window), "es")).resolves.toMatchObject({
+      revision: 2,
+    });
+    fake.app.emit("will-quit");
+    expect(fake.handlers.has("one-memory:get-language-preference")).toBe(false);
+    expect(fake.handlers.has("one-memory:set-language-preference")).toBe(false);
+  });
+  it("does not deliver an admitted write to a document that navigated during persistence", async () => {
+    const window = await startup();
+    const write = fake.handlers.get("one-memory:set-language-preference");
+    const read = fake.handlers.get("one-memory:get-language-preference");
+    if (!write || !read) throw Error("Missing language handlers");
+    const result = write(eventFor(window), "es");
+    window.frame.url = "https://example.invalid";
+    await expect(result).rejects.toThrow();
+    expect(window.frame.send).not.toHaveBeenCalled();
+    window.frame.url = "one-memory://app/index.html";
+    expect(await read(eventFor(window))).toMatchObject({
+      preference: "es",
+      revision: 1,
+    });
+  });
+  it("uses the shared locale for the native error title without translating error codes", async () => {
+    fake.loadFailure = true;
+    await startup();
+    expect(fake.error).toHaveBeenCalledWith(
+      translate("es", "nativeErrorTitle"),
+      "page_load_failed",
+    );
+  });
+});
+
 describe("display preference main IPC", () => {
   it("registers background inspection against the fixed data directory and guards navigation", async () => {
     const window = await startup();
@@ -406,6 +506,9 @@ describe("display preference main IPC", () => {
 interface PreferenceAPI {
   getBackgroundHealth(): Promise<unknown>;
   restartBackground(): Promise<{ state: "restarted" }>;
+  getLanguagePreference(): Promise<unknown>;
+  setLanguagePreference(preference: unknown): Promise<unknown>;
+  onLanguagePreferenceChanged(listener: (value: unknown) => void): () => void;
   getDisplayPreferences(): Promise<{
     reduceMotion: boolean;
     reduceTransparency: boolean;
@@ -418,6 +521,51 @@ async function preload() {
   return fake.expose.mock.calls[0][1] as PreferenceAPI;
 }
 
+describe("language preference preload", () => {
+  it("validates writes and snapshots, strips event metadata and cleans subscriptions", async () => {
+    const api = await preload();
+    const snapshot = { preference: "es", locale: "es", revision: 2 };
+    fake.invoke.mockResolvedValue({ ...snapshot, secret: "not exposed" });
+    expect(await api.getLanguagePreference()).toEqual(snapshot);
+    expect(await api.setLanguagePreference("es")).toEqual(snapshot);
+    expect(fake.invoke).toHaveBeenLastCalledWith(
+      "one-memory:set-language-preference",
+      "es",
+    );
+    fake.invoke.mockClear();
+    await expect(api.setLanguagePreference("en")).rejects.toThrow();
+    expect(fake.invoke).not.toHaveBeenCalled();
+    const listener = vi.fn();
+    const unsubscribe = api.onLanguagePreferenceChanged(listener);
+    for (const invalid of [
+      null,
+      {},
+      { ...snapshot, revision: -1 },
+      { ...snapshot, preference: "en" },
+      { ...snapshot, locale: "en" },
+    ]) {
+      fake.invoke.mockResolvedValue(invalid);
+      await expect(api.getLanguagePreference()).rejects.toThrow();
+      await expect(api.setLanguagePreference("es")).rejects.toThrow();
+      fake.renderer.emit("one-memory:language-preference-changed", {}, invalid);
+    }
+    expect(listener).not.toHaveBeenCalled();
+    fake.renderer.emit(
+      "one-memory:language-preference-changed",
+      { secret: true },
+      { ...snapshot, secret: true },
+    );
+    expect(listener).toHaveBeenCalledExactlyOnceWith(snapshot);
+    expect(listener.mock.calls[0][0]).not.toBe(snapshot);
+    fake.unload.dispatchEvent(new Event("unload"));
+    unsubscribe();
+    unsubscribe();
+    expect(
+      fake.renderer.listenerCount("one-memory:language-preference-changed"),
+    ).toBe(0);
+  });
+});
+
 describe("display preference preload", () => {
   it("preload exposes a no-argument background health read", async () => {
     const api = await preload();

memhub/apps/desktop/src/early-startup-errors.test.ts

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { installEarlyStartupErrorHandler } from "./early-startup-errors";
+import { stableRuntimeUserMessage } from "./stable-runtime";
 
 const roots: string[] = [];
 
@@ -14,6 +15,40 @@ afterEach(async () => {
 });
 
 describe("early desktop startup errors", () => {
+  it.each(["es", "throws"] as const)(
+    "uses best-effort language (%s) without changing safe error codes",
+    async (language) => {
+      const dataDir = await mkdtemp(
+        path.join(os.tmpdir(), "desktop-early-language-"),
+      );
+      roots.push(dataDir);
+      const processEvents = new EventEmitter();
+      const showError = vi.fn();
+      const exit = vi.fn();
+      const dispose = installEarlyStartupErrorHandler({
+        processEvents,
+        dataDir,
+        stderr: { write: vi.fn(() => true) },
+        showError,
+        exit,
+        readLocale: () => {
+          if (language === "throws") throw new Error("unavailable");
+          return "es";
+        },
+      });
+      processEvents.emit(
+        "uncaughtException",
+        new Error("synthetic_safe_failure"),
+      );
+      expect(showError).toHaveBeenCalledExactlyOnceWith(
+        language === "es" ? "MemHub no pudo iniciarse" : "MemHub 无法启动",
+        stableRuntimeUserMessage(new Error("synthetic_safe_failure")),
+      );
+      expect(exit).toHaveBeenCalledExactlyOnceWith(1);
+      dispose();
+    },
+  );
+
   it("replaces an earlier handler on the same process emitter", () => {
     const processEvents = new EventEmitter();
     const options = {
@@ -32,6 +67,37 @@ describe("early desktop startup errors", () => {
     dispose();
   });
 
+  it.each(["es", undefined] as const)(
+    "uses a safe title for initialized locale %s and retains the technical code",
+    async (locale) => {
+      const dataDir = await mkdtemp(
+        path.join(os.tmpdir(), "desktop-early-locale-"),
+      );
+      roots.push(dataDir);
+      const processEvents = new EventEmitter();
+      const showError = vi.fn();
+      const exit = vi.fn();
+      const dispose = installEarlyStartupErrorHandler({
+        processEvents,
+        dataDir,
+        stderr: { write: vi.fn(() => true) },
+        showError,
+        exit,
+        readLocale: () => locale,
+      });
+      processEvents.emit(
+        "uncaughtException",
+        new Error("desktop_startup_failed"),
+      );
+      expect(showError).toHaveBeenCalledExactlyOnceWith(
+        locale === "es" ? "MemHub no pudo iniciarse" : "MemHub 无法启动",
+        stableRuntimeUserMessage(new Error("desktop_startup_failed")),
+      );
+      expect(exit).toHaveBeenCalledExactlyOnceWith(1);
+      dispose();
+    },
+  );
+
   it("writes stderr and diagnostics before showing the fatal dialog", async () => {
     const dataDir = await mkdtemp(
       path.join(os.tmpdir(), "desktop-early-error-"),

memhub/apps/desktop/src/early-startup-errors.ts

@@ -1,4 +1,5 @@
 import type { EventEmitter } from "node:events";
+import { type GuiLocale, translate } from "@one-memory/contracts/gui-i18n";
 import {
   diagnosticError,
   writeDiagnosticEventSync,
@@ -12,6 +13,8 @@ interface EarlyStartupErrorHandlerOptions {
   showError(title: string, message: string): void;
   exit(code: number): void;
   afterDiagnosticWrite?: () => void;
+  /** Only already initialized preferences; never read configuration during a fatal error. */
+  readLocale?: () => GuiLocale | undefined;
 }
 
 const SAFE_ERROR_CODE = /^[a-z][a-z0-9_]{0,127}$/;
@@ -56,7 +59,16 @@ export function installEarlyStartupErrorHandler(
       // The dialog is the only part of this a person ever reads, so it gets the
       // explanation, not the code. The code stays in the diagnostic event,
       // where support can still match it against a known failure.
-      options.showError("MemHub 无法启动", stableRuntimeUserMessage(error));
+      let locale: GuiLocale = "zh-CN";
+      try {
+        locale = options.readLocale?.() ?? "zh-CN";
+      } catch {
+        // Preferences may not exist yet; do not read files or guess the locale.
+      }
+      options.showError(
+        translate(locale, "nativeErrorTitle"),
+        stableRuntimeUserMessage(error),
+      );
       options.exit(1);
     }
   };

memhub/apps/desktop/src/language-preferences-ipc.test.ts

@@ -0,0 +1,55 @@
+import { describe, expect, it, vi } from "vitest";
+import { LanguagePreferences } from "./language-preferences";
+import { installLanguagePreferencesIpc } from "./language-preferences-ipc";
+
+describe("language preference IPC", () => {
+  it("guards reads/writes, validates payloads, broadcasts commits and disposes", async () => {
+    const handlers = new Map<
+      string,
+      (event: string, ...args: unknown[]) => Promise<unknown>
+    >();
+    const save = vi.fn(async () => {});
+    const preferences = await LanguagePreferences.open(
+      "/synthetic/profile",
+      "es",
+      { read: async () => "{}", save },
+    );
+    const broadcast = vi.fn();
+    const dispose = installLanguagePreferencesIpc({
+      ipc: {
+        handle: (name, handler) => handlers.set(name, handler),
+        removeHandler: (name) => {
+          handlers.delete(name);
+        },
+      },
+      preferences,
+      requireTrustedWindow: (event: string) => {
+        if (event !== "trusted") throw Error("untrusted");
+      },
+      broadcast,
+    });
+    const read = handlers.get("one-memory:get-language-preference");
+    const write = handlers.get("one-memory:set-language-preference");
+    if (!read || !write) throw Error("Missing language handlers");
+    await expect(read("foreign")).rejects.toThrow("untrusted");
+    await expect(write("iframe", "es")).rejects.toThrow("untrusted");
+    await expect(write("trusted", "en")).rejects.toThrow();
+    await expect(write("trusted", "es", "extra")).rejects.toThrow();
+    expect(save).not.toHaveBeenCalled();
+    expect(await read("trusted")).toEqual({
+      preference: "system",
+      locale: "es",
+      revision: 0,
+    });
+    await write("trusted", "zh-CN");
+    expect(broadcast).toHaveBeenCalledExactlyOnceWith({
+      preference: "zh-CN",
+      locale: "zh-CN",
+      revision: 1,
+    });
+    dispose();
+    dispose();
+    expect(handlers.size).toBe(0);
+    await expect(write("trusted", "es")).rejects.toThrow();
+  });
+});

memhub/apps/desktop/src/language-preferences-ipc.ts

@@ -0,0 +1,50 @@
+import {
+  isLanguagePreference,
+  type LanguageSnapshot,
+} from "@one-memory/contracts/gui-i18n";
+import type { LanguagePreferences } from "./language-preferences";
+
+const GET = "one-memory:get-language-preference";
+const SET = "one-memory:set-language-preference";
+
+export function installLanguagePreferencesIpc<Event>(options: {
+  ipc: {
+    handle(
+      name: string,
+      handler: (event: Event, ...args: unknown[]) => Promise<unknown>,
+    ): unknown;
+    removeHandler(name: string): void;
+  };
+  preferences: LanguagePreferences;
+  requireTrustedWindow(event: Event): unknown;
+  broadcast(snapshot: LanguageSnapshot): void;
+}): () => void {
+  let closed = false;
+  const requireTrusted = (event: Event) => {
+    if (closed) throw Error("language_preferences_closed");
+    options.requireTrustedWindow(event);
+  };
+  options.ipc.handle(GET, async (event, ...args) => {
+    requireTrusted(event);
+    if (args.length) throw Error("invalid_language_preference_arguments");
+    return options.preferences.read();
+  });
+  options.ipc.handle(SET, async (event, ...args) => {
+    requireTrusted(event);
+    if (args.length !== 1 || !isLanguagePreference(args[0]))
+      throw Error("invalid_language_preference");
+    const snapshot = await options.preferences.set(args[0]);
+    requireTrusted(event);
+    return snapshot;
+  });
+  const unsubscribe = options.preferences.subscribe((snapshot) => {
+    if (!closed) options.broadcast(snapshot);
+  });
+  return () => {
+    if (closed) return;
+    closed = true;
+    unsubscribe();
+    options.ipc.removeHandler(GET);
+    options.ipc.removeHandler(SET);
+  };
+}

memhub/apps/desktop/src/language-preferences.test.ts

@@ -0,0 +1,141 @@
+import { mkdtemp, readdir, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  LanguagePreferences,
+  preferredSystemLanguage,
+} from "./language-preferences";
+
+const roots: string[] = [];
+async function profile() {
+  const root = await mkdtemp(path.join(os.tmpdir(), "memhub-language-"));
+  roots.push(root);
+  return root;
+}
+afterEach(async () => {
+  await Promise.all(
+    roots.splice(0).map((root) => rm(root, { recursive: true, force: true })),
+  );
+});
+
+describe("GUI language preferences", () => {
+  it("defaults to system, persists only the preference in the active profile and reloads", async () => {
+    const root = await profile();
+    const store = await LanguagePreferences.open(root, "es-MX");
+    expect(store.read()).toEqual({
+      preference: "system",
+      locale: "es",
+      revision: 0,
+    });
+    expect(await readdir(root)).toEqual([]);
+    expect(await store.set("zh-CN")).toEqual({
+      preference: "zh-CN",
+      locale: "zh-CN",
+      revision: 1,
+    });
+    expect(
+      JSON.parse(await readFile(path.join(root, "gui-language.json"), "utf8")),
+    ).toEqual({ preference: "zh-CN" });
+    expect((await LanguagePreferences.open(root, "es")).read().preference).toBe(
+      "zh-CN",
+    );
+    expect(
+      (await LanguagePreferences.open(await profile(), "es")).read().preference,
+    ).toBe("system");
+    expect(await readdir(root)).toEqual(["gui-language.json"]);
+  });
+  it.each(["{broken", '{"preference":"en"}', "null", "[]"])(
+    "does not overwrite invalid input %s while loading",
+    async (content) => {
+      const root = await profile();
+      const file = path.join(root, "gui-language.json");
+      await writeFile(file, content);
+      const store = await LanguagePreferences.open(root, "es");
+      expect(store.read().preference).toBe("system");
+      expect(await readFile(file, "utf8")).toBe(content);
+    },
+  );
+  it("survives failed reads and preserves the snapshot on failed writes, then recovers", async () => {
+    const save = vi
+      .fn()
+      .mockRejectedValueOnce(new Error("disk full"))
+      .mockResolvedValue(undefined);
+    const store = await LanguagePreferences.open("/synthetic/profile", "es", {
+      read: async () => {
+        throw new Error("unreadable");
+      },
+      save,
+    });
+    const listener = vi.fn();
+    store.subscribe(listener);
+    await expect(store.set("zh-CN")).rejects.toThrow(
+      "language_preference_save_failed",
+    );
+    expect(store.read()).toEqual({
+      preference: "system",
+      locale: "es",
+      revision: 0,
+    });
+    expect(listener).not.toHaveBeenCalled();
+    await store.set("zh-CN");
+    expect(store.read().revision).toBe(1);
+    expect(listener).toHaveBeenCalledTimes(1);
+  });
+  it("serializes racing writes and emits only committed snapshots", async () => {
+    let release!: () => void;
+    const gate = new Promise<void>((resolve) => {
+      release = resolve;
+    });
+    const save = vi
+      .fn()
+      .mockImplementationOnce(() => gate)
+      .mockResolvedValue(undefined);
+    const store = await LanguagePreferences.open("/synthetic/profile", "es", {
+      read: async () => "{}",
+      save,
+    });
+    const listener = vi.fn();
+    const unsubscribe = store.subscribe(listener);
+    const first = store.set("zh-CN");
+    const second = store.set("es");
+    await vi.waitFor(() => expect(save).toHaveBeenCalledTimes(1));
+    expect(store.read().revision).toBe(0);
+    release();
+    expect((await first).revision).toBe(1);
+    expect(await second).toEqual({
+      preference: "es",
+      locale: "es",
+      revision: 2,
+    });
+    expect(listener.mock.calls.map(([value]) => value.revision)).toEqual([
+      1, 2,
+    ]);
+    unsubscribe();
+    await store.set("system");
+    expect(listener).toHaveBeenCalledTimes(2);
+    await expect(store.set("invalid" as "es")).rejects.toThrow();
+  });
+  it("uses only the primary preferred language, falling back to locale if unavailable", () => {
+    expect(
+      preferredSystemLanguage({
+        getPreferredSystemLanguages: () => ["en", "es"],
+        getLocale: () => "es",
+      }),
+    ).toBe("en");
+    expect(
+      preferredSystemLanguage({
+        getPreferredSystemLanguages: () => [],
+        getLocale: () => "es",
+      }),
+    ).toBe("es");
+    expect(
+      preferredSystemLanguage({
+        getPreferredSystemLanguages: () => {
+          throw Error();
+        },
+        getLocale: () => "es",
+      }),
+    ).toBe("es");
+  });
+});

memhub/apps/desktop/src/language-preferences.ts

@@ -0,0 +1,135 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import {
+  isLanguagePreference,
+  type LanguagePreference,
+  type LanguageSnapshot,
+  resolveGuiLocale,
+} from "@one-memory/contracts/gui-i18n";
+
+interface Storage {
+  read(file: string): Promise<string>;
+  save(file: string, content: string): Promise<void>;
+}
+const storage: Storage = {
+  read: (file) => readFile(file, "utf8"),
+  async save(file, content) {
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    try {
+      await writeFile(temporary, content, {
+        encoding: "utf8",
+        mode: 0o600,
+        flag: "wx",
+      });
+      await rename(temporary, file);
+    } finally {
+      await rm(temporary, { force: true }).catch(() => {});
+    }
+  },
+};
+
+/** GUI-only preferences, scoped to the active Electron userData profile. */
+export class LanguagePreferences {
+  private queue: Promise<unknown> = Promise.resolve();
+  private readonly listeners = new Set<(snapshot: LanguageSnapshot) => void>();
+  private snapshot: LanguageSnapshot;
+
+  private constructor(
+    private readonly file: string,
+    private readonly systemLanguage: string | undefined,
+    private readonly io: Storage,
+    preference: LanguagePreference,
+  ) {
+    this.snapshot = {
+      preference,
+      locale: resolveGuiLocale(preference, systemLanguage),
+      revision: 0,
+    };
+  }
+
+  static async open(
+    userData: string,
+    systemLanguage?: string,
+    io: Storage = storage,
+  ): Promise<LanguagePreferences> {
+    const file = path.join(userData, "gui-language.json");
+    let preference: LanguagePreference = "system";
+    try {
+      const data: unknown = JSON.parse(await io.read(file));
+      if (
+        data &&
+        typeof data === "object" &&
+        "preference" in data &&
+        isLanguagePreference(data.preference)
+      ) {
+        preference = data.preference;
+      }
+    } catch {
+      // Missing, unreadable or corrupt preferences never block startup or get rewritten.
+    }
+    return new LanguagePreferences(file, systemLanguage, io, preference);
+  }
+
+  read(): LanguageSnapshot {
+    return { ...this.snapshot };
+  }
+
+  set(preference: LanguagePreference): Promise<LanguageSnapshot> {
+    if (!isLanguagePreference(preference))
+      return Promise.reject(Error("invalid_language_preference"));
+    const operation = this.queue.then(async () => {
+      if (preference === this.snapshot.preference) return this.read();
+      try {
+        await this.io.save(this.file, `${JSON.stringify({ preference })}\n`);
+      } catch {
+        throw Error("language_preference_save_failed");
+      }
+      this.snapshot = {
+        preference,
+        locale: resolveGuiLocale(preference, this.systemLanguage),
+        revision: this.snapshot.revision + 1,
+      };
+      for (const listener of this.listeners) {
+        try {
+          listener(this.read());
+        } catch {
+          /* A closed consumer cannot undo a committed save. */
+        }
+      }
+      return this.read();
+    });
+    this.queue = operation.catch(() => {});
+    return operation;
+  }
+
+  subscribe(listener: (snapshot: LanguageSnapshot) => void): () => void {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+
+  async drain(): Promise<void> {
+    await this.queue;
+  }
+}
+
+/** Call only after Electron readiness: later preferred languages are not fallbacks. */
+export function preferredSystemLanguage(app: {
+  getPreferredSystemLanguages(): string[];
+  getLocale(): string;
+}): string | undefined {
+  try {
+    const primary = app.getPreferredSystemLanguages()[0];
+    if (primary) return primary;
+  } catch {
+    /* Older/unavailable platform API: use Electron's locale. */
+  }
+  try {
+    return app.getLocale() || undefined;
+  } catch {
+    return undefined;
+  }
+}

memhub/apps/desktop/src/main.ts

@@ -1,6 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import { createReadStream, existsSync, mkdirSync } from "node:fs";
 import path from "node:path";
+import { translate } from "@one-memory/contracts/gui-i18n";
 import { RecallBroker } from "@one-memory/host-bridge";
 import {
   checkSkillDrift,
@@ -90,6 +91,11 @@ import {
   resolvePackagedBuildNumber,
   resolvePackagedCommit,
 } from "./isolated-runtime";
+import {
+  LanguagePreferences,
+  preferredSystemLanguage,
+} from "./language-preferences";
+import { installLanguagePreferencesIpc } from "./language-preferences-ipc";
 import {
   disableLegacyLoginItem,
   wasOpenedByLegacyLoginItem,
@@ -122,6 +128,9 @@ let runtimeSupervisor: RuntimeSupervisor | null = null;
 let runtimeDataDir: string | null = null;
 let preserveManagedRuntimeOnQuit = false;
 let disposeTray: (() => void) | null = null;
+let disposeApplicationMenu: (() => void) | null = null;
+let languagePreferences: LanguagePreferences | null = null;
+let disposeLanguagePreferences: (() => void) | null = null;
 const displayWindows = new Set<BrowserWindow>();
 let disposeDisplayPreferences: (() => void) | null = null;
 let disposeSourceDirectoryPicker: (() => void) | null = null;
@@ -143,6 +152,7 @@ installEarlyStartupErrorHandler({
     process.env.ONE_MEMORY_DATA_DIR?.trim() ||
     path.join(app.getPath("home"), ".one-memory"),
   stderr: process.stderr,
+  readLocale: () => languagePreferences?.read().locale ?? "zh-CN",
   showError: (title, message) => dialog.showErrorBox(title, message),
   exit: (code) => app.exit(code),
 });
@@ -958,6 +968,26 @@ async function initialize(isQuitting: () => boolean): Promise<void> {
   }
 
   try {
+    if (languagePreferences) {
+      disposeLanguagePreferences = installLanguagePreferencesIpc({
+        ipc: ipcMain,
+        preferences: languagePreferences,
+        requireTrustedWindow,
+        broadcast: (snapshot) => {
+          for (const window of displayWindows) {
+            try {
+              assertTrustedWindow(window);
+              window.webContents.mainFrame.send(
+                "one-memory:language-preference-changed",
+                snapshot,
+              );
+            } catch {
+              // Navigation/destruction races must never leak to another document.
+            }
+          }
+        },
+      });
+    }
     disposeDisplayPreferences = installDisplayPreferences();
     disposeSourceDirectoryPicker = installSourceDirectoryPicker();
     if (appManagedRuntime) {
@@ -1150,10 +1180,20 @@ async function initialize(isQuitting: () => boolean): Promise<void> {
       });
       void dialog.showMessageBox({
         type: "warning",
-        message: "请先将 MemHub 拖到“应用程序”文件夹",
-        detail:
-          "从“应用程序”重新打开后，MemHub 才会接入其他应用并安装命令行工具。",
-        buttons: ["知道了"],
+        message: translate(
+          languagePreferences?.read().locale ?? "zh-CN",
+          "nativeMoveTitle",
+        ),
+        detail: translate(
+          languagePreferences?.read().locale ?? "zh-CN",
+          "nativeMoveDetail",
+        ),
+        buttons: [
+          translate(
+            languagePreferences?.read().locale ?? "zh-CN",
+            "nativeAcknowledge",
+          ),
+        ],
       });
     } else if (
       trialProfile === null &&
@@ -1318,12 +1358,19 @@ if (desktopVersion !== null) {
     platform: process.platform,
     background: legacyLoginLaunch || process.argv.includes("--background"),
     prepare: prepareProtocol,
+    beforeNativeUi: async () => {
+      languagePreferences = await LanguagePreferences.open(
+        app.getPath("userData"),
+        preferredSystemLanguage(app),
+      );
+    },
     initialize,
     createWindow,
     getWindows: () => [...displayWindows],
     installTray: (open) => {
-      installApplicationMenu({
+      disposeApplicationMenu = installApplicationMenu({
         productName: app.getName(),
+        language: languagePreferences ?? undefined,
         buildMenu: (template) => Menu.buildFromTemplate(template),
         setMenu: (menu) => Menu.setApplicationMenu(menu),
         exportLogs: async () => {
@@ -1335,6 +1382,7 @@ if (desktopVersion !== null) {
       });
       disposeTray = installBackgroundTray({
         app,
+        language: languagePreferences ?? undefined,
         platform: process.platform,
         resourcesPath: process.resourcesPath,
         appPath: app.getAppPath(),
@@ -1379,6 +1427,9 @@ if (desktopVersion !== null) {
         ...(coreSupervisor ? { instance_id: coreSupervisor.instanceId } : {}),
       });
       // An admitted native effect must settle and journal before Runtime detach.
+      disposeLanguagePreferences?.();
+      disposeLanguagePreferences = null;
+      await languagePreferences?.drain();
       await connectionSetup?.drain();
       // BUG-12: stopping the supervisor only releases this process's handles. In
       // a packaged build the Runtime is its own process and was left running
@@ -1427,6 +1478,10 @@ if (desktopVersion !== null) {
       });
     },
     dispose: () => {
+      disposeLanguagePreferences?.();
+      disposeLanguagePreferences = null;
+      disposeApplicationMenu?.();
+      disposeApplicationMenu = null;
       connectionSetup?.dispose();
       disposeDiagnostics?.();
       disposeDiagnostics = null;
@@ -1448,7 +1503,10 @@ if (desktopVersion !== null) {
         error instanceof Error ? error.name : "UnknownError",
       );
       dialog.showErrorBox(
-        "MemHub 无法启动",
+        translate(
+          languagePreferences?.read().locale ?? "zh-CN",
+          "nativeErrorTitle",
+        ),
         error instanceof Error ? error.message : "desktop_unavailable",
       );
     },

memhub/apps/desktop/src/native-language.ts

@@ -0,0 +1,7 @@
+import type { LanguageSnapshot } from "@one-memory/contracts/gui-i18n";
+
+/** Shared committed GUI language for native menus, tray, and dialogs. */
+export interface NativeLanguageSource {
+  read(): LanguageSnapshot;
+  subscribe(listener: (snapshot: LanguageSnapshot) => void): () => void;
+}

memhub/apps/desktop/src/preload-sandbox.test.ts

@@ -59,6 +59,9 @@ it("loads the production preload in a sandbox with Electron as its only module",
     const bridge = exposed as unknown as Record<string, unknown>;
     expect(bridge.getApiBaseUrl).toBeTypeOf("function");
     expect(bridge.getApiToken).toBeTypeOf("function");
+    expect(bridge.getLanguagePreference).toBeTypeOf("function");
+    expect(bridge.setLanguagePreference).toBeTypeOf("function");
+    expect(bridge.onLanguagePreferenceChanged).toBeTypeOf("function");
   } finally {
     rmSync(output, { recursive: true, force: true });
   }

memhub/apps/desktop/src/preload.ts

@@ -6,6 +6,12 @@ import type {
   ConnectionSetupResult,
   ConnectionSetupSelection,
 } from "@one-memory/contracts";
+import {
+  isLanguagePreference,
+  isLanguageSnapshot,
+  type LanguagePreference,
+  type LanguageSnapshot,
+} from "@one-memory/contracts/gui-i18n";
 import type {
   RecallInstallPreview,
   RecallUninstallPreview,
@@ -30,7 +36,55 @@ import type {
   SyncHookStatus,
 } from "./sync-hook";
 
+function languageSnapshot(payload: unknown): LanguageSnapshot {
+  if (!isLanguageSnapshot(payload))
+    throw Error("language_preferences_unavailable");
+  return {
+    preference: payload.preference,
+    locale: payload.locale,
+    revision: payload.revision,
+  };
+}
+
 contextBridge.exposeInMainWorld("oneMemory", {
+  getLanguagePreference: async (): Promise<LanguageSnapshot> =>
+    languageSnapshot(
+      await ipcRenderer.invoke("one-memory:get-language-preference"),
+    ),
+  setLanguagePreference: async (
+    preference: LanguagePreference,
+  ): Promise<LanguageSnapshot> => {
+    if (!isLanguagePreference(preference))
+      throw Error("invalid_language_preference");
+    return languageSnapshot(
+      await ipcRenderer.invoke(
+        "one-memory:set-language-preference",
+        preference,
+      ),
+    );
+  },
+  onLanguagePreferenceChanged: (
+    listener: (value: LanguageSnapshot) => void,
+  ): (() => void) => {
+    if (typeof listener !== "function")
+      throw Error("invalid_language_preference_listener");
+    const handler = (_event: unknown, payload: unknown) => {
+      if (isLanguageSnapshot(payload)) listener(languageSnapshot(payload));
+    };
+    let subscribed = true;
+    const unsubscribe = () => {
+      if (!subscribed) return;
+      subscribed = false;
+      ipcRenderer.removeListener(
+        "one-memory:language-preference-changed",
+        handler,
+      );
+      window.removeEventListener("unload", unsubscribe);
+    };
+    ipcRenderer.on("one-memory:language-preference-changed", handler);
+    window.addEventListener("unload", unsubscribe, { once: true });
+    return unsubscribe;
+  },
   getDebugLogs: (): Promise<DebugLogSnapshot> =>
     ipcRenderer.invoke("one-memory:get-debug-logs"),
   logUiTrace: (input: {

memhub/apps/web/src/App.r6.test.tsx

@@ -9,6 +9,31 @@ import {
 import userEvent from "@testing-library/user-event";
 import { afterEach, beforeEach, expect, it, vi } from "vitest";
 import { App } from "./App";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
+
+it("localizes shared navigation and footer in Spanish", async () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  render(
+    <LanguageProvider>
+      <App />
+    </LanguageProvider>,
+  );
+  const nav = await screen.findByRole("navigation", {
+    name: "Navegación principal",
+  });
+  expect(
+    within(nav)
+      .getAllByRole("button")
+      .map((button) => button.textContent),
+  ).toEqual(["Aplicaciones", "Memorias", "Configuración"]);
+  expect(within(nav).getByRole("button", { name: "Configuración" }).title).toBe(
+    "Configuración",
+  );
+  expect(screen.getAllByText("Almacenamiento local").length).toBeGreaterThan(0);
+  expect(
+    screen.getByRole("link", { name: "Saltar al contenido principal" }),
+  ).toBeTruthy();
+});
 
 const memoryProps = vi.hoisted(() => vi.fn());
 

memhub/apps/web/src/App.tsx

@@ -22,10 +22,12 @@ import {
   CALL_HISTORY_ENTRY_VISIBLE,
 } from "./ApplicationsHome";
 import { getOnboarding } from "./api";
+import { useApplicationsLanguage } from "./applications-language";
 import { CallHistory } from "./CallHistory";
 import { DebugLogPanel } from "./DebugLogPanel";
 import { DesktopFrame } from "./DesktopFrame";
 import { FirstUseGuide } from "./FirstUseGuide";
+import { useGuiLanguage } from "./gui-language";
 import { HealthPanel } from "./HealthPanel";
 import { ImportProgressStrip } from "./ImportProgressStrip";
 import { MatterWorkspace } from "./MatterWorkspace";
@@ -64,6 +66,8 @@ export function App() {
 }
 
 function AppContent() {
+  const { t } = useGuiLanguage();
+  const { a } = useApplicationsLanguage();
   const [onboarding, setOnboarding] = useState<OnboardingState | null>(null);
   const [startupRead, setStartupRead] = useState<"loading" | "ready" | "error">(
     "loading",
@@ -216,19 +220,19 @@ function AppContent() {
         {startupRead === "error" ? (
           <div className="boot-status">
             <p className="error-banner" role="alert">
-              暂时无法读取启动状态，请重试。
+              {t("startupReadError")}
             </p>
             <R6Button
               onClick={() => {
                 if (!startupFlight.current) readStartup();
               }}
             >
-              重新读取
+              {t("startupRetry")}
             </R6Button>
           </div>
         ) : (
           <p className="boot-status" aria-live="polite">
-            正在打开 MemHub…
+            {t("startupOpening")}
           </p>
         )}
       </main>
@@ -264,9 +268,9 @@ function AppContent() {
           the text it used to contain. */}
       <header className="r6-titlebar" />
       <a className="skip-link" href="#main-content">
-        跳到主要内容
+        {a("skip")}
       </a>
-      <nav className="app-rail" aria-label="主要导航">
+      <nav className="app-rail" aria-label={a("navigation")}>
         <div className="brand-mark" title="MemHub">
           <Layers3 size={21} strokeWidth={1.6} aria-hidden="true" />
           <span>MemHub</span>
@@ -285,7 +289,7 @@ function AppContent() {
               key={destination}
               active={displayedView === destination}
               tourId={destination === "sources" ? "nav-sources" : undefined}
-              label={destination === "memory" ? "记忆" : "应用"}
+              label={a(destination === "memory" ? "navMemories" : "apps")}
               icon={
                 destination === "memory" ? (
                   <Network size={19} />
@@ -308,16 +312,13 @@ function AppContent() {
           <RailButton
             active={displayedView === "settings" || displayedView === "health"}
             tourId="nav-settings"
-            label="设置"
+            label={t("settings")}
             icon={<Settings size={18} />}
             onClick={() => navigate("settings")}
           />
-          <p
-            className="rail-core"
-            title="记忆保存在本机；使用云模型整理或交给已授权的助手时，相关内容会发送给对应服务。"
-          >
+          <p className="rail-core" title={a("localHint")}>
             <span aria-hidden="true" />
-            本地存储
+            {a("local")}
           </p>
         </div>
       </nav>
@@ -439,7 +440,7 @@ function AppContent() {
               onClick={() => navigate("settings")}
             >
               <ArrowLeft size={16} />
-              设置
+              {t("settings")}
             </button>
             <HealthPanel imports={imports} />
           </>
@@ -511,6 +512,7 @@ function RailButton({
       className={`rail-button${active ? " active" : ""}`}
       aria-current={active ? "page" : undefined}
       data-tour-id={tourId}
+      title={label}
       onClick={onClick}
     >
       <span className="rail-icon" aria-hidden="true">

memhub/apps/web/src/ApplicationDetail.test.tsx

@@ -12,6 +12,32 @@ import {
 import { useState } from "react";
 import { afterEach, beforeEach, expect, it, vi } from "vitest";
 import { ApplicationDetail } from "./ApplicationDetail";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
+
+it("translates application detail live without triggering extra reads or writes", async () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  const refresh = vi.fn().mockResolvedValue({ sources: [source] });
+  render(
+    <LanguageProvider>
+      <ApplicationDetail {...props} refresh={refresh} />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByRole("heading", { name: "Detalles de la aplicación" }),
+  ).toBeTruthy();
+  expect(screen.getByRole("switch", { name: "Sincronización" })).toBeTruthy();
+  await waitFor(() => expect(refresh).toHaveBeenCalledTimes(1));
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "zh-CN");
+  await act(async () =>
+    window.dispatchEvent(
+      new StorageEvent("storage", { key: LANGUAGE_STORAGE_KEY }),
+    ),
+  );
+  expect(await screen.findByRole("heading", { name: "应用详情" })).toBeTruthy();
+  expect(refresh).toHaveBeenCalledTimes(1);
+  expect(props.setSync).not.toHaveBeenCalled();
+});
+
 import { saveConnectionPreferences } from "./connection-preferences";
 import { resetConnectionReconcile } from "./connection-reconcile";
 import { commitSources } from "./source-state";

memhub/apps/web/src/ApplicationDetail.tsx

@@ -1,4 +1,5 @@
 import type { SourceResponse } from "@one-memory/contracts";
+import type { MessageKey } from "@one-memory/contracts/gui-i18n";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { AppMark } from "./app-mark";
 import { connectionHostId, preferenceHasSource } from "./connection-hosts";
@@ -14,7 +15,6 @@ import {
   hostCapabilities,
   hostConnectionApproved,
   hostConnectionUnsupported,
-  hostFailureNote,
   hostRereadFailed,
   hostWriteReason,
   matchHost,
@@ -24,6 +24,7 @@ import {
   UNSUPPORTED_NOTE,
   useRecallHosts,
 } from "./host-state";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { R6Button, R6Switch } from "./R6Controls";
 import { latestSource, useSource } from "./source-state";
 import "./application-detail.css";
@@ -34,10 +35,6 @@ const SYNC_UNCONFIRMED = "此应用的处理开关结果未能确认，其他应
 // removed — flip this back to restore it without digging through history.
 const MEMORY_PERMISSION_SECTION_VISIBLE = false;
 
-function connectFailure(reason: string | null, rereadFailed = false) {
-  return `此应用的一键接入未完成，其他应用不受影响。${hostFailureNote(reason, rereadFailed)}`;
-}
-
 function connectionLabel(input: {
   approved: boolean;
   insertionOn: boolean;
@@ -81,6 +78,10 @@ export function ApplicationDetail({
   refresh(): Promise<{ sources: SourceResponse[] }>;
   onBack(): void;
 }) {
+  const { text, t, locale } = useOnboardingTranslation();
+  function failureNote(reason: string | null, rereadFailed = false) {
+    return `${reason ? `${text("原因")}${locale === "es" ? ": " : "："}${text(reason)}。` : ""}${rereadFailed ? text("当前接入状态也未能重新读取，显示的可能不是最新状态。") : ""}`;
+  }
   const source = useSource(given);
   const hosts = useRecallHosts().data;
   const [read, setRead] = useState<{
@@ -94,7 +95,9 @@ export function ApplicationDetail({
   const [refreshing, setRefreshing] = useState(false);
   const [refreshError, setRefreshError] = useState(false);
   const [installing, setInstalling] = useState(false);
-  const [installError, setInstallError] = useState("");
+  const [installError, setInstallError] = useState<
+    string | { key: MessageKey; params: Record<string, string> }
+  >("");
   const [syncing, setSyncing] = useState(false);
   const [syncError, setSyncError] = useState("");
   const [memoryPending, setMemoryPending] = useState(false);
@@ -298,7 +301,10 @@ export function ApplicationDetail({
   });
   const hostId =
     host?.hostId ?? connectionHostId(source.source_id) ?? source.source_id;
-  const hostError = installError;
+  const hostError =
+    typeof installError === "string"
+      ? text(installError)
+      : t(installError.key, installError.params);
   async function applyInsertion(enabled: boolean) {
     const bridge = window.oneMemory;
     if (!bridge) return;
@@ -311,27 +317,27 @@ export function ApplicationDetail({
     const { outcome } = await disconnectHost(hostId);
     if (outcome.state === "failed")
       throw Object.assign(Error("disconnect_failed"), {
-        note: hostFailureNote(outcome.reason, outcome.rereadFailed),
+        note: failureNote(outcome.reason, outcome.rereadFailed),
       });
     setLink(null);
     if (outcome.state === "review")
-      setInstallError(
-        `${
+      setInstallError({
+        key:
           outcome.permission?.receipt?.status === "revoked"
-            ? `已撤销记忆权限，${source.display_name} 已查不到记忆。但`
-            : ""
-        }无法确认连接已全部移除，需要你手动核对：${outcome.findings
-          .map((finding) => `${finding.path}（${finding.where}）`)
-          .join("；")}。`,
-      );
+            ? "appRevokedReview"
+            : "appRemovalReview",
+        params: {
+          name: source.display_name,
+          paths: outcome.findings
+            .map((finding) => `${finding.path}（${finding.where}）`)
+            .join("；"),
+        },
+      });
     if (outcome.state === "revoked")
-      setInstallError(
-        `已撤销记忆权限，${source.display_name} 已查不到记忆。${
-          outcome.configEdited
-            ? "配置文件被改过，MemHub 没有自动删除；请手动移除其中的 MemHub 连接。"
-            : "连接文件没有移除，请重新核对。"
-        }`,
-      );
+      setInstallError({
+        key: outcome.configEdited ? "appRevokedModified" : "appRevokedRetained",
+        params: { name: source.display_name },
+      });
   }
   async function changeInsertion(enabled: boolean) {
     writeConnectionPreference("host", source.source_id, enabled);
@@ -357,10 +363,22 @@ export function ApplicationDetail({
           // shows the grant that is really still there after the re-read.
           setInstallError(
             wanted
-              ? connectFailure(hostWriteReason(error), hostRereadFailed(error))
-              : `连接未能移除，记忆权限也未能撤销，${source.display_name} 仍可使用记忆，请重试。${
-                  (error as { note?: string }).note ?? ""
-                }`,
+              ? {
+                  key: "appConnectFailed",
+                  params: {
+                    reason: failureNote(
+                      hostWriteReason(error),
+                      hostRereadFailed(error),
+                    ),
+                  },
+                }
+              : {
+                  key: "appDisconnectFailed",
+                  params: {
+                    name: source.display_name,
+                    reason: (error as { note?: string }).note ?? "",
+                  },
+                },
           );
         }
       }
@@ -446,12 +464,15 @@ export function ApplicationDetail({
             );
           } else if (!wanted) setHostRestartNotice("");
         } catch (error) {
-          setInstallError(
-            `此应用的记忆使用权限未能确认，请重试。${hostFailureNote(
-              hostWriteReason(error),
-              hostRereadFailed(error),
-            )}`,
-          );
+          setInstallError({
+            key: "appPermissionFailed",
+            params: {
+              reason: failureNote(
+                hostWriteReason(error),
+                hostRereadFailed(error),
+              ),
+            },
+          });
         }
       }
     } finally {
@@ -465,11 +486,11 @@ export function ApplicationDetail({
   return (
     <section
       className="r6-app-detail"
-      aria-label={`${source.display_name} 应用设置`}
+      aria-label={t("appSettingsTitle", { name: source.display_name })}
     >
-      <h1 className="r6-app-detail-title">应用详情</h1>
+      <h1 className="r6-app-detail-title">{text("应用详情")}</h1>
       <R6Button variant="quiet" onClick={onBack}>
-        返回应用
+        {text("返回应用")}
       </R6Button>
       <header>
         <span className="r6-app-detail-icon">
@@ -477,28 +498,30 @@ export function ApplicationDetail({
         </span>
         <div>
           <h2>{source.display_name}</h2>
-          <p>{syncStatus}</p>
+          <p>{text(syncStatus)}</p>
         </div>
       </header>
       <div className="r6-app-settings">
         <section className="r6-app-setting">
           <div>
-            <h2>同步开关</h2>
-            <p>开启后处理历史待办，并持续接收此应用的新会话。</p>
+            <h2>{text("同步开关")}</h2>
+            <p>{text("开启后处理历史待办，并持续接收此应用的新会话。")}</p>
             {syncing && syncChecked && (
               <p role="status">
-                正在读取已有对话，首次开启可能需要一两分钟，请不要重复点击。
+                {text(
+                  "正在读取已有对话，首次开启可能需要一两分钟，请不要重复点击。",
+                )}
               </p>
             )}
             {backfillNotice && (
               <p role="status">
-                将补充冻结期间的新对话；原有 pending Job 继续处理。
+                {text("将补充冻结期间的新对话；原有 pending Job 继续处理。")}
               </p>
             )}
-            {syncError && <p role="alert">{syncError}</p>}
+            {syncError && <p role="alert">{text(syncError)}</p>}
           </div>
           <R6Switch
-            label="同步开关"
+            label={text("同步开关")}
             checked={syncChecked}
             pending={syncing}
             disabled={
@@ -510,19 +533,19 @@ export function ApplicationDetail({
         </section>
         <section className="r6-app-setting">
           <div>
-            <h2>一键插入应用</h2>
-            <p>安装记忆连接，并默认允许此应用使用已授权记忆。</p>
+            <h2>{text("一键插入应用")}</h2>
+            <p>{text("安装记忆连接，并默认允许此应用使用已授权记忆。")}</p>
             {unsupported && (
-              <p>{`${source.display_name} ${UNSUPPORTED_NOTE}`}</p>
+              <p>{`${source.display_name} ${text(UNSUPPORTED_NOTE)}`}</p>
             )}
             {hostError && <p role="alert">{hostError}</p>}
-            {appLocationNote && <p role="status">{appLocationNote}</p>}
+            {appLocationNote && <p role="status">{text(appLocationNote)}</p>}
             {hostRestartNotice ? (
-              <p role="status">{hostRestartNotice}</p>
+              <p role="status">{text(hostRestartNotice)}</p>
             ) : null}
           </div>
           <R6Switch
-            label="一键插入应用"
+            label={text("一键插入应用")}
             checked={insertionChecked}
             pending={installing}
             disabled={
@@ -539,11 +562,11 @@ export function ApplicationDetail({
         {MEMORY_PERMISSION_SECTION_VISIBLE && (
           <section className="r6-app-setting">
             <div>
-              <h2>允许使用记忆</h2>
-              <p>让 {source.display_name} 查询已授权范围内的记忆。</p>
+              <h2>{text("允许使用记忆")}</h2>
+              <p>{t("appMemoryScope", { name: source.display_name })}</p>
             </div>
             <R6Switch
-              label="允许使用记忆"
+              label={text("允许使用记忆")}
               checked={memoryChecked}
               pending={memoryPending}
               disabled={
@@ -557,30 +580,38 @@ export function ApplicationDetail({
         )}
         <section className="r6-app-setting">
           <div>
-            <h2>连接状态</h2>
+            <h2>{text("连接状态")}</h2>
             {refreshError && (
               <p role="alert">
-                暂时无法刷新来源状态，请重试；未更改同步或读取权限。
+                {text("暂时无法刷新来源状态，请重试；未更改同步或读取权限。")}
               </p>
             )}
             {readFailed && (
-              <p role="alert">暂时无法读取连接状态，当前状态待核对；请重试。</p>
-            )}
-            {probeState && probeState !== "wired" && (
-              <p>
-                {`记忆工具没有进到 ${source.display_name} 当前对话。完全退出 ${source.display_name} 后重新打开，新对话里才会出现。`}
+              <p role="alert">
+                {text("暂时无法读取连接状态，当前状态待核对；请重试。")}
               </p>
             )}
+            {probeState && probeState !== "wired" && (
+              <p>{t("appRestart", { name: source.display_name })}</p>
+            )}
             {probeState === "wired" && (
-              <p>已接通。已经打开的对话不会中途出现这个工具，请新开一轮。</p>
+              <p>
+                {text(
+                  "已接通。已经打开的对话不会中途出现这个工具，请新开一轮。",
+                )}
+              </p>
             )}
             {linkFailed && (
               <p role="alert">
-                本次连接探测失败，当前状态待核对；未把上次读取当作本次成功。
+                {text(
+                  "本次连接探测失败，当前状态待核对；未把上次读取当作本次成功。",
+                )}
               </p>
             )}
             {checkedAt && !stale && current?.state === "ready" && (
-              <small>上次读取：{new Date(checkedAt).toLocaleString()}</small>
+              <small>
+                {text("上次读取")}: {new Date(checkedAt).toLocaleString(locale)}
+              </small>
             )}
           </div>
           <div className="r6-app-detail-actions">
@@ -590,7 +621,7 @@ export function ApplicationDetail({
               aria-busy={probing || undefined}
               onClick={() => void reread()}
             >
-              <span>{stateText}</span>
+              <span>{text(stateText)}</span>
               {probing ? (
                 <span className="r6-button-spinner" aria-hidden="true" />
               ) : null}

memhub/apps/web/src/ApplicationsHome.test.tsx

@@ -17,8 +17,54 @@ import {
 import * as api from "./api";
 import { saveConnectionPreferences } from "./connection-preferences";
 import { resetConnectionReconcile } from "./connection-reconcile";
+import { LanguageProvider } from "./gui-language";
 import { queryClient } from "./query-client";
 
+it("localizes the whole home live without repeating reads or changing imported text", async () => {
+  let change:
+    | ((snapshot: {
+        preference: "es" | "zh-CN";
+        locale: "es" | "zh-CN";
+        revision: number;
+      }) => void)
+    | undefined;
+  Object.assign(window.oneMemory ?? {}, {
+    getLanguagePreference: vi
+      .fn()
+      .mockResolvedValue({ preference: "es", locale: "es", revision: 1 }),
+    onLanguagePreferenceChanged: vi.fn((listener) => {
+      change = listener;
+      return () => {};
+    }),
+  });
+  render(<LanguageProvider>{mountHome()}</LanguageProvider>);
+  await screen.findByRole("heading", { name: "Aplicaciones", level: 1 });
+  await screen.findByText("实际治理记忆");
+  expect(
+    screen.getByRole("region", { name: "Resumen de memorias" }),
+  ).toBeTruthy();
+  expect(screen.getByText("Servicio activo")).toBeTruthy();
+  expect(screen.getByText("2 aplicaciones conectadas")).toBeTruthy();
+  expect(screen.getAllByRole("button", { name: "Ver detalles" })).toHaveLength(
+    3,
+  );
+  const calls = summary.mock.calls.length;
+  fireEvent.click(
+    screen.getByRole("button", { name: "Ver las 5 aplicaciones" }),
+  );
+  act(() => change?.({ preference: "zh-CN", locale: "zh-CN", revision: 2 }));
+  expect(
+    screen.getByRole("heading", { name: "全部应用", level: 1 }),
+  ).toBeTruthy();
+  expect(screen.getByText("App 4")).toBeTruthy();
+  expect(summary).toHaveBeenCalledTimes(calls);
+  act(() => change?.({ preference: "es", locale: "es", revision: 3 }));
+  expect(
+    screen.getByRole("heading", { name: "Todas las aplicaciones", level: 1 }),
+  ).toBeTruthy();
+  expect(summary).toHaveBeenCalledTimes(calls);
+});
+
 const { summary, processing, history, liveSync, recentConversations } =
   vi.hoisted(() => ({
     summary: vi.fn(),
@@ -101,6 +147,53 @@ beforeEach(() => {
     ]),
   } as unknown as NonNullable<typeof window.oneMemory>;
 });
+it.each([
+  [{ running: 1, pending: 0 }, "Organizando"],
+  [{ running: 0, pending: 1 }, "Preparando"],
+  [{ running: 0, pending: 0, waiting_for_model: 1 }, "Esperando modelo"],
+  [{ running: 0, pending: 0, failed: 1 }, "Requiere atención"],
+])(
+  "renders Spanish processing states without extra requests: %j",
+  async (value, label) => {
+    processing.mockResolvedValue(value);
+    Object.assign(window.oneMemory ?? {}, {
+      getLanguagePreference: vi
+        .fn()
+        .mockResolvedValue({ preference: "es", locale: "es", revision: 1 }),
+      onLanguagePreferenceChanged: vi.fn(() => () => {}),
+    });
+    render(<LanguageProvider>{mountHome()}</LanguageProvider>);
+    expect(await screen.findAllByText(label)).toHaveLength(2);
+    expect(processing).toHaveBeenCalledOnce();
+  },
+);
+it("localizes failure and empty states without leaking errors", async () => {
+  summary.mockRejectedValue(new Error("synthetic_private_error"));
+  Object.assign(window.oneMemory ?? {}, {
+    getLanguagePreference: vi
+      .fn()
+      .mockResolvedValue({ preference: "es", locale: "es", revision: 1 }),
+    onLanguagePreferenceChanged: vi.fn(() => () => {}),
+  });
+  render(
+    <LanguageProvider>
+      <ApplicationsHome
+        imports={{ ...imports, sources: [] }}
+        onManage={() => {}}
+        onMemories={() => {}}
+        onSettings={() => {}}
+      />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByText("No se puede leer el estado de las memorias"),
+  ).toBeTruthy();
+  expect(screen.getByText("Aún no hay aplicaciones para mostrar")).toBeTruthy();
+  expect(
+    screen.getByRole("button", { name: "Reintentar lectura" }),
+  ).toBeTruthy();
+  expect(document.body.textContent).not.toContain("synthetic_private_error");
+});
 it("hides a debug-frame dialogue excerpt from 最近更新 and falls back to memory", async () => {
   recentConversations.mockResolvedValue({
     items: [

memhub/apps/web/src/ApplicationsHome.tsx

@@ -42,6 +42,11 @@ import { R6Button } from "./R6Controls";
 import { prefetchDataRuntime } from "./runtime-state";
 import type { useImportSources } from "./use-import-sources";
 import "./applications-home.css";
+import type { GuiLocale } from "@one-memory/contracts/gui-i18n";
+import {
+  applicationsText,
+  useApplicationsLanguage,
+} from "./applications-language";
 
 type HomeViewState = {
   expanded: boolean;
@@ -69,13 +74,13 @@ function presentableDialogue(text: string): boolean {
 
 const retainedViews = new WeakMap<object, HomeViewState>();
 
-function clockParts(value: string) {
+function clockParts(value: string, locale: GuiLocale) {
   const ms = Date.parse(value);
   if (!Number.isFinite(ms)) return null;
   const date = new Date(ms);
   const now = new Date();
   return {
-    clock: new Intl.DateTimeFormat("zh-CN", {
+    clock: new Intl.DateTimeFormat(locale, {
       hour: "2-digit",
       minute: "2-digit",
     }).format(date),
@@ -86,16 +91,21 @@ function clockParts(value: string) {
   };
 }
 
-function stamped(value: string, suffix = "") {
-  const parts = clockParts(value);
-  if (!parts) return `时间未知${suffix}`;
-  return `${parts.today ? "今天 " : ""}${parts.clock}${suffix}`;
+function stamped(value: string, locale: GuiLocale) {
+  const parts = clockParts(value, locale);
+  if (!parts) return applicationsText(locale, "unknownTime");
+  return `${parts.today ? applicationsText(locale, "today") : ""}${parts.clock}`;
 }
 
-function memoryAction(action: string | undefined) {
-  if (action === "create") return "新增记忆";
-  if (action === "correct" || action === "restore") return "更新记忆";
-  return "记忆已保存";
+function memoryAction(action: string | undefined, locale: GuiLocale) {
+  return applicationsText(
+    locale,
+    action === "create"
+      ? "newMemory"
+      : action === "correct" || action === "restore"
+        ? "updatedMemory"
+        : "saved",
+  );
 }
 
 type ActivityChoice = "call" | "update";
@@ -135,22 +145,31 @@ function sourceActivity(
   source: SourceResponse,
   events: CallEvent[],
   callHistoryUnavailable = false,
+  locale: GuiLocale = "zh-CN",
 ): string {
-  if (!source.authorized) return "尚未关联";
+  if (!source.authorized) return applicationsText(locale, "unlinked");
   const latest = events.find(
     (item) =>
       successfulCall(item) && sourceMatchesHost(source.source_id, item.host_id),
   );
   if (!latest) return "";
-  const time = stamped(latest.occurred_at);
-  const prefix = callHistoryUnavailable ? "上次读取：" : "";
-  return `${prefix}${callDetailHeadline(latest, source.display_name)} · ${time}`;
+  const time = stamped(latest.occurred_at, locale);
+  const prefix = callHistoryUnavailable
+    ? applicationsText(locale, "lastRead")
+    : "";
+  return `${prefix}${callDetailHeadline(latest, source.display_name, locale)} · ${time}`;
 }
 
-function sourceSyncActivity(sourceId: string, sync: LiveSyncHealth[]): string {
+function sourceSyncActivity(
+  sourceId: string,
+  sync: LiveSyncHealth[],
+  locale: GuiLocale,
+): string {
   const current = sync.find((item) => item.source_id === sourceId);
   return current?.last_success_at
-    ? `最近同步 ${stamped(current.last_success_at)}`
+    ? applicationsText(locale, "recentSync", {
+        time: stamped(current.last_success_at, locale),
+      })
     : "";
 }
 
@@ -180,6 +199,7 @@ export function ApplicationsHome({
   onCalls?(): void;
   active?: boolean;
 }) {
+  const { locale, a } = useApplicationsLanguage();
   const hostQuery = useRecallHosts({ poll: active });
   const hostBridge = hostBridgeAvailable();
   const hosts = hostQuery.data ?? [];
@@ -651,22 +671,24 @@ export function ApplicationsHome({
   const apps = imports.sources.filter(
     (s) => s.authorized || s.detected === true || s.location_state === "found",
   );
-  const stateLabel = processing?.running
-    ? "整理中"
-    : processing?.blocked_stages?.some((stage) => stage.count > 0)
-      ? "排队处理中"
-      : processing?.waiting_for_model
-        ? "等待模型"
-        : processing?.failed
-          ? "需要处理"
-          : processing?.pending
-            ? "准备中"
-            : processing
-              ? "一切就绪"
-              : "待核对";
-  const latestClock = latest ? clockParts(latest.updated_at) : null;
-  const time = latestClock?.clock ?? (latest ? "时间未知" : null);
-  const checked = visible ? clockParts(visible.observed_at) : null;
+  const stateLabel = a(
+    processing?.running
+      ? "running"
+      : processing?.blocked_stages?.some((stage) => stage.count > 0)
+        ? "queued"
+        : processing?.waiting_for_model
+          ? "waitingModel"
+          : processing?.failed
+            ? "needsAttention"
+            : processing?.pending
+              ? "preparing"
+              : processing
+                ? "ready"
+                : "unchecked",
+  );
+  const latestClock = latest ? clockParts(latest.updated_at, locale) : null;
+  const time = latestClock?.clock ?? (latest ? a("unknownTime") : null);
+  const checked = visible ? clockParts(visible.observed_at, locale) : null;
   // A failed read leaves the last health in place on purpose: clearing it would
   // drop the instance it names, and that instance is what keeps memory writes
   // and backfill receipts attached to the run that produced them. So the card
@@ -682,20 +704,24 @@ export function ApplicationsHome({
     (!hostBridge && hostState !== "ready") ||
     (admitted === 0 && hostApplyPending(auto, preferences.hostSourceIds));
   const accessText = accessPending
-    ? "正在核对中"
+    ? a("checkingNow")
     : hostReadFailed
-      ? "待核对"
+      ? a("unchecked")
       : !unchecked.length
-        ? `${admitted} 个应用已接入`
+        ? a("connectedCount", { count: admitted })
         : admitted
-          ? `${admitted} 个应用已接入，${unchecked.length} 个待核对`
-          : `${unchecked.length} 个应用待核对`;
+          ? a("mixedCount", { count: admitted, pending: unchecked.length })
+          : a("pendingCount", { count: unchecked.length });
   const accessUnknownText = accessPending
     ? null
     : hostReadFailed
-      ? "应用接入状态暂时没有读到，无法确认有几个应用已接入。"
+      ? a("unknownAccess")
       : unchecked.length
-        ? `${unchecked.map((host) => host.label).join("、")} 的记忆权限暂时没有读到，无法确认是否已接入。`
+        ? a("unknownPermissions", {
+            names: new Intl.ListFormat(locale).format(
+              unchecked.map((host) => host.label),
+            ),
+          })
         : null;
   async function restartBackground() {
     if (restartingBackground) return;
@@ -735,8 +761,16 @@ export function ApplicationsHome({
   const autoFailureText = autoFailures
     .map((failure) =>
       failure.kind === "host"
-        ? `${nameOf(failure.sourceId)} 未能自动接入${failure.reason ? `：${failure.reason}` : ""}。`
-        : `${nameOf(failure.sourceId)} 的持续同步未能自动开启。${failure.reason ?? ""}`,
+        ? a("autoHostFailed", {
+            name: nameOf(failure.sourceId),
+            reason: failure.reason
+              ? `${locale === "es" ? ": " : "："}${failure.reason}`
+              : "",
+          })
+        : a("autoSyncFailed", {
+            name: nameOf(failure.sourceId),
+            reason: failure.reason ?? "",
+          }),
     )
     .join("");
   const authorizedSyncSources = imports.sources.filter(
@@ -747,12 +781,12 @@ export function ApplicationsHome({
     (failure) => failure.kind === "sync",
   );
   const syncState = authorizedSyncSources.length
-    ? `${authorizedSyncSources.length} 个应用已开启`
+    ? a("enabledCount", { count: authorizedSyncSources.length })
     : syncApplyFailed
-      ? "未能开启"
+      ? a("enableFailed")
       : wantsSync || !visible
-        ? "正在检查状态"
-        : "尚未开启";
+        ? a("checkingState")
+        : a("notEnabled");
   function toggleAll(next: boolean) {
     transition.current(next);
   }
@@ -760,7 +794,7 @@ export function ApplicationsHome({
     <section
       className="r6-home"
       ref={root}
-      aria-label="应用首页"
+      aria-label={a("home")}
       data-expanded={expanded}
       data-phase={phase}
       onFocusCapture={(event) => {
@@ -769,7 +803,7 @@ export function ApplicationsHome({
       }}
     >
       <header className="r6-home-heading">
-        <h1>{expanded ? "全部应用" : "应用"}</h1>
+        <h1>{a(expanded ? "allApps" : "apps")}</h1>
       </header>
       <button
         type="button"
@@ -782,7 +816,7 @@ export function ApplicationsHome({
       >
         <span className="r6-button-label">
           <ArrowLeft size={16} aria-hidden="true" />
-          返回首页
+          {a("back")}
         </span>
       </button>
       <div
@@ -791,14 +825,14 @@ export function ApplicationsHome({
         hidden={expanded}
         inert={expanded || phase !== "idle"}
       >
-        <HomeCardBoundary label="记忆概览">
-          <section className="r6-home-overview" aria-label="记忆概览">
+        <HomeCardBoundary label={a("overview")}>
+          <section className="r6-home-overview" aria-label={a("overview")}>
             <header>
-              <h2>记忆概览</h2>
+              <h2>{a("overview")}</h2>
             </header>
             <div className="r6-home-metrics">
               <div>
-                <p>已沉淀记忆</p>
+                <p>{a("memories")}</p>
                 {/* The figure slot used to hold the word 读取中 while the first
                   read was in flight, which is how "大数字不可见" (D51) shows up
                   on a slow link: the biggest type on the page spends the first
@@ -814,44 +848,44 @@ export function ApplicationsHome({
                         aria-hidden="true"
                       />
                     </p>
-                    <small role="status">正在读取已沉淀记忆数量…</small>
+                    <small role="status">{a("readingCount")}</small>
                   </>
                 ) : (
                   <>
                     <p className="r6-home-figure">
                       <strong className={visible ? "" : "r6-home-word"}>
                         {visible
-                          ? new Intl.NumberFormat("zh-CN").format(
+                          ? new Intl.NumberFormat(locale).format(
                               visible.memory_count,
                             )
-                          : "暂无法读取"}
+                          : a("unreadable")}
                       </strong>
-                      {visible ? <i>条</i> : null}
+                      {visible && a("unit") ? <i>{a("unit")}</i> : null}
                     </p>
-                    <small>按应用授权范围使用</small>
+                    <small>{a("scope")}</small>
                   </>
                 )}
               </div>
               <div>
-                <p>沉淀状态</p>
+                <p>{a("processing")}</p>
                 <strong className="r6-home-word">{stateLabel}</strong>
                 <small>
                   {processing?.running
-                    ? "新的对话正在整理"
+                    ? a("organizingNew")
                     : processing?.pending
-                      ? "等待队列开始处理"
-                      : "以当前处理状态为准"}
+                      ? a("waitingQueue")
+                      : a("currentState")}
                 </small>
               </div>
               <div>
-                <p>最近更新</p>
+                <p>{a("recentUpdate")}</p>
                 <strong className={time ? "r6-home-time" : "r6-home-word"}>
-                  {time ?? (visible ? "尚未生成" : "待核对")}
+                  {time ?? a(visible ? "notGenerated" : "unchecked")}
                 </strong>
                 <small>
                   {time
-                    ? `${latestClock?.today ? "今天 · " : ""}记忆已保存`
-                    : "历史与记忆分别处理"}
+                    ? `${latestClock?.today ? `${a("today").trim()} · ` : ""}${a("saved")}`
+                    : a("separate")}
                 </small>
               </div>
             </div>
@@ -873,19 +907,19 @@ export function ApplicationsHome({
                       }
                       onClick={() => setActivityView(item)}
                     >
-                      {item === "call" ? "最近调用" : "最近更新"}
+                      {a(item === "call" ? "recentCall" : "recentUpdate")}
                     </button>
                   ))}
                 </div>
               ) : (
                 <p>
                   {activity === "unavailable"
-                    ? "动态暂不可用"
+                    ? a("activityUnavailable")
                     : activity === "call"
-                      ? "最近调用"
+                      ? a("recentCall")
                       : activity === "dialogue" || activity === "memory"
-                        ? "最近更新"
-                        : "首批沉淀"}
+                        ? a("recentUpdate")
+                        : a("firstBatch")}
                 </p>
               )}
               <div>
@@ -925,42 +959,43 @@ export function ApplicationsHome({
                   <h3>
                     {activity === "unavailable"
                       ? callState === "unavailable"
-                        ? "暂时无法读取调用记录"
-                        : "暂时无法读取记忆状态"
+                        ? a("callsUnavailable")
+                        : a("memoryUnavailable")
                       : activity === "call" && recentCall
                         ? callDetailHeadline(
                             recentCall,
                             recentCallHost?.display_name ??
-                              callHostName(recentCall.host_id),
+                              callHostName(recentCall.host_id, locale),
+                            locale,
                           )
                         : activity === "memory" && latest
                           ? `${latest.content}${latest.truncated ? "…" : ""}`
                           : activity === "dialogue" && latestDialogue
                             ? `${latestDialogue.excerpt}${latestDialogue.truncated ? "…" : ""}`
                             : activity === "importing"
-                              ? "对话持续导入中，即将沉淀你的记忆"
+                              ? a("importing")
                               : activity === "first-running"
-                                ? "正在沉淀第一批记忆"
+                                ? a("firstRunning")
                                 : activity === "first-queued"
-                                  ? "准备沉淀第一批记忆"
+                                  ? a("firstQueued")
                                   : activity === "loading"
-                                    ? "正在读取动态"
-                                    : "还没有已生成的记忆"}
+                                    ? a("readingActivity")
+                                    : a("emptyMemories")}
                   </h3>
                   <small>
                     {activity === "unavailable"
                       ? callState === "unavailable"
-                        ? "已有记忆仍可查看；重试不会发起新的调用。"
-                        : "读取失败不会当作没有记忆。"
+                        ? a("callReadFailure")
+                        : a("memoryReadFailure")
                       : activity === "call" && recentCall
-                        ? `${stamped(recentCall.occurred_at)} · ${callRowDetail(recentCall)}${callState === "incomplete" ? " · 有几次调用没被记下来，列表可能不全" : ""}`
+                        ? `${stamped(recentCall.occurred_at, locale)} · ${callRowDetail(recentCall, locale)}${callState === "incomplete" ? a("incompleteCalls") : ""}`
                         : activity === "memory" && latest
-                          ? `${time} · ${memoryAction(latest.action)} · ${latest.source_ids.map((id) => imports.sources.find((s) => s.source_id === id)?.display_name ?? id).join("、")} · 版本 ${latest.revision}`
+                          ? `${time} · ${memoryAction(latest.action, locale)} · ${new Intl.ListFormat(locale).format(latest.source_ids.map((id) => imports.sources.find((s) => s.source_id === id)?.display_name ?? id))} · ${a("revision", { count: latest.revision })}`
                           : activity === "dialogue" && latestDialogue
-                            ? `${clockParts(latestDialogue.created_at ?? latestDialogue.imported_at)?.clock ?? "时间未知"} ${latestDialogue.time_basis === "conversation" ? "对话时间" : "导入时间"} · ${imports.sources.find((source) => source.source_id === latestDialogue.source_id)?.display_name ?? latestDialogue.source_id}`
+                            ? `${clockParts(latestDialogue.created_at ?? latestDialogue.imported_at, locale)?.clock ?? a("unknownTime")} ${a(latestDialogue.time_basis === "conversation" ? "conversationTime" : "importTime")} · ${imports.sources.find((source) => source.source_id === latestDialogue.source_id)?.display_name ?? latestDialogue.source_id}`
                             : activity === "importing"
-                              ? "对话正在后台持续保存。"
-                              : "历史已保存，记忆生成后会显示在这里。"}
+                              ? a("savingConversations")
+                              : a("waitingMemories")}
                   </small>
                 </section>
                 {(activity === "unavailable" ||
@@ -981,10 +1016,10 @@ export function ApplicationsHome({
                     }
                   >
                     {activity === "unavailable"
-                      ? "重新读取"
+                      ? a("reread")
                       : activity === "call"
-                        ? "查看记录"
-                        : "查看记忆"}
+                        ? a("viewCalls")
+                        : a("viewMemory")}
                     {activity === "unavailable" ? null : (
                       <ArrowRight size={14} aria-hidden="true" />
                     )}
@@ -998,8 +1033,8 @@ export function ApplicationsHome({
           <section className="r6-home-auto-failure" role="alert">
             <p>
               {attention.kind === "unavailable"
-                ? "后台服务没有运行，应用暂时查不到记忆"
-                : `${attentionHost} 最近几次没查到记忆，后台可能正忙，稍后会自动恢复`}
+                ? a("backgroundDown")
+                : a("timeoutWarning", { host: attentionHost ?? "" })}
             </p>
             {attention.kind === "unavailable" || CALL_HISTORY_ENTRY_VISIBLE ? (
               <R6Button
@@ -1013,40 +1048,40 @@ export function ApplicationsHome({
                     : onCalls
                 }
               >
-                {attention.kind === "unavailable" ? "重新启动" : "查看记录"}
+                {a(attention.kind === "unavailable" ? "restart" : "viewCalls")}
               </R6Button>
             ) : null}
           </section>
         ) : null}
-        <HomeCardBoundary label="运行状态">
+        <HomeCardBoundary label={a("runtime")}>
           <aside className="r6-home-runtime">
-            <h2>运行状态</h2>
+            <h2>{a("runtime")}</h2>
             <h3>
               {connected
-                ? "后台运行中"
+                ? a("backgroundRunning")
                 : imports.healthStale
-                  ? "连接状态待核对"
-                  : "服务未连接"}
+                  ? a("connectionUnchecked")
+                  : a("disconnected")}
             </h3>
-            <p>仅处理已授权范围</p>
+            <p>{a("authorizedOnly")}</p>
             <dl>
               <div>
-                <dt>对话同步</dt>
+                <dt>{a("sync")}</dt>
                 <dd>{syncState}</dd>
               </div>
               <div>
-                <dt>记忆整理</dt>
+                <dt>{a("organizing")}</dt>
                 <dd>{stateLabel}</dd>
               </div>
               <div>
-                <dt>应用访问</dt>
+                <dt>{a("access")}</dt>
                 <dd>{accessText}</dd>
               </div>
             </dl>
             {accessUnknownText ? (
               <div
                 role="status"
-                aria-label="应用接入核对"
+                aria-label={a("checkingAccess")}
                 className="r6-home-auto-failure"
               >
                 <p>{accessUnknownText}</p>
@@ -1056,22 +1091,22 @@ export function ApplicationsHome({
                   disabled={hostQuery.isFetching}
                   onClick={() => void hostQuery.refetch()}
                 >
-                  {hostQuery.isFetching ? "核对中…" : "重新核对"}
+                  {a(hostQuery.isFetching ? "checking" : "recheck")}
                 </button>
               </div>
             ) : null}
             {hostStale ? (
               <p
                 role="status"
-                aria-label="应用接入状态"
+                aria-label={a("accessState")}
                 className="r6-home-auto-failure"
               >
-                应用接入状态暂时读取失败，当前为上次状态。
+                {a("staleAccess")}
               </p>
             ) : null}
             {autoFailureText ? (
               <div role="alert" className="r6-home-auto-failure">
-                <p>{`${autoFailureText}不会自动重试。`}</p>
+                <p>{`${autoFailureText}${a("noAutoRetry")}`}</p>
                 <button
                   type="button"
                   className="r6-home-activity-link"
@@ -1084,14 +1119,16 @@ export function ApplicationsHome({
                     })
                   }
                 >
-                  重新接入
+                  {a("reconnect")}
                 </button>
               </div>
             ) : null}
             <p className="r6-home-checked">
-              {!checked
-                ? "上次核对：待核对"
-                : `上次核对：${checked.today ? "今天 " : ""}${checked.clock}`}
+              {a("checkedAt", {
+                time: !checked
+                  ? a("unchecked")
+                  : `${checked.today ? a("today") : ""}${checked.clock}`,
+              })}
             </p>
           </aside>
         </HomeCardBoundary>
@@ -1099,7 +1136,7 @@ export function ApplicationsHome({
       <section
         className="r6-home-apps"
         ref={panel}
-        aria-label="我的应用"
+        aria-label={a("myApps")}
         onWheel={(event) => {
           if (!expanded && apps.length > 3 && event.deltaY > 10)
             toggleAll(true);
@@ -1130,7 +1167,9 @@ export function ApplicationsHome({
         }}
       >
         <header>
-          <h2>{expanded ? `${apps.length} 个应用` : "我的应用"}</h2>
+          <h2>
+            {expanded ? a("appCount", { count: apps.length }) : a("myApps")}
+          </h2>
           {apps.length > 3 ? (
             <button
               type="button"
@@ -1142,7 +1181,7 @@ export function ApplicationsHome({
               className="r6-home-expand"
               onClick={() => toggleAll(true)}
             >
-              查看全部 {apps.length} 个应用
+              {a("viewAll", { count: apps.length })}
             </button>
           ) : null}
         </header>
@@ -1150,7 +1189,7 @@ export function ApplicationsHome({
           className="r6-home-list"
           ref={list}
           id={listId}
-          aria-label="应用列表"
+          aria-label={a("list")}
           tabIndex={expanded ? 0 : -1}
           onScroll={(event) => {
             if (expanded)
@@ -1159,8 +1198,12 @@ export function ApplicationsHome({
         >
           {(expanded ? apps : apps.slice(0, 3)).map((source) => {
             const activity =
-              sourceActivity(source, callEvents, callState === "unavailable") ||
-              sourceSyncActivity(source.source_id, syncHealth);
+              sourceActivity(
+                source,
+                callEvents,
+                callState === "unavailable",
+                locale,
+              ) || sourceSyncActivity(source.source_id, syncHealth, locale);
             const host = hosts.find((item) =>
               sourceMatchesHost(source.source_id, item.hostId),
             );
@@ -1172,13 +1215,13 @@ export function ApplicationsHome({
                     <h3>{source.display_name}</h3>
                     <p>
                       {source.sync_enabled
-                        ? "持续同步已开启"
+                        ? a("syncEnabled")
                         : host?.installed &&
                             host.permission?.state === "approved"
-                          ? "允许请求已授权记忆"
+                          ? a("recallAllowed")
                           : source.authorized
-                            ? "历史读取已授权"
-                            : "连接待完成"}
+                            ? a("historyAllowed")
+                            : a("connectionPending")}
                     </p>
                   </section>
                   {activity ? (
@@ -1189,7 +1232,7 @@ export function ApplicationsHome({
                     data-home-focus={`source:${source.source_id}`}
                     onClick={() => onManage(source.source_id)}
                   >
-                    查看详情
+                    {a("details")}
                   </R6Button>
                 </div>
               </div>
@@ -1197,7 +1240,7 @@ export function ApplicationsHome({
           })}
           {!apps.length ? (
             <p className="r6-home-empty">
-              {stale ? "应用列表暂时不可读取" : "还没有可显示的应用"}
+              {a(stale ? "listUnavailable" : "emptyApps")}
             </p>
           ) : null}
         </section>

memhub/apps/web/src/ConnectionFallback.test.tsx

@@ -3,6 +3,53 @@ import { cleanup, render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { ConnectionFallback } from "./ConnectionFallback";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
+
+it("switches connection prose live, preserves technical bytes and copies only on request", async () => {
+  const user = userEvent.setup();
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  const mcp =
+    '{"mcpServers":{"one-memory":{"command":"/synthetic/bin/recall"}}}';
+  const shell = "'/synthetic/bin/recall' '查询内容'\n";
+  const getConnectionMaterial = vi
+    .fn()
+    .mockResolvedValue({ mcp, shell, prompt: "synthetic legacy prompt" });
+  const copyText = vi.fn().mockResolvedValue(undefined);
+  const onLanguagePreferenceChanged = vi.fn().mockReturnValue(() => {});
+  window.oneMemory = {
+    getConnectionMaterial,
+    copyText,
+    getLanguagePreference: vi
+      .fn()
+      .mockResolvedValue({ preference: "es", locale: "es", revision: 1 }),
+    onLanguagePreferenceChanged,
+  } as unknown as Window["oneMemory"];
+  render(
+    <LanguageProvider>
+      <ConnectionFallback />
+    </LanguageProvider>,
+  );
+  await user.click(await screen.findByText("Conectar otras herramientas"));
+  const input = await screen.findByLabelText("Material de conexión local");
+  expect((input as HTMLTextAreaElement).value).toContain(
+    "No crees un proxy público",
+  );
+  expect((input as HTMLTextAreaElement).value).toContain(mcp);
+  expect((input as HTMLTextAreaElement).value).toContain(shell);
+  expect(copyText).not.toHaveBeenCalled();
+  await user.click(
+    screen.getByRole("button", { name: "Copiar instrucciones" }),
+  );
+  expect(copyText).toHaveBeenCalledWith((input as HTMLTextAreaElement).value);
+  await user.click(screen.getByRole("tab", { name: "Configuración MCP" }));
+  expect(input).toHaveProperty("value", mcp);
+  const listener = onLanguagePreferenceChanged.mock.calls[0][0];
+  listener({ preference: "zh-CN", locale: "zh-CN", revision: 2 });
+  expect(await screen.findByRole("tab", { name: "MCP 配置" })).toBeTruthy();
+  expect(input).toHaveProperty("value", mcp);
+  expect(getConnectionMaterial).toHaveBeenCalledTimes(1);
+  localStorage.clear();
+});
 
 afterEach(() => {
   cleanup();

memhub/apps/web/src/ConnectionFallback.tsx

@@ -1,17 +1,26 @@
 import { Copy, RefreshCw } from "lucide-react";
 import { useState } from "react";
+import { connectionPromptSpanish } from "./connection-prompt";
 import { copyText } from "./copy-text";
+import { useOnboardingTranslation } from "./onboarding-language";
 
 type Material = { mcp: string; shell: string | null; prompt: string };
 type Mode = keyof Material;
 
 export function ConnectionFallback() {
+  const { locale, text } = useOnboardingTranslation();
   const [material, setMaterial] = useState<Material | null>(null);
   const [mode, setMode] = useState<Mode>("prompt");
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(false);
   const [notice, setNotice] = useState("");
   const available = !!window.oneMemory?.getConnectionMaterial;
+  // Localize only the template prose; never parse or rewrite technical material.
+  const value = material
+    ? mode === "prompt" && locale === "es"
+      ? connectionPromptSpanish(material)
+      : (material[mode] ?? "")
+    : "";
 
   async function load() {
     const bridge = window.oneMemory;
@@ -35,26 +44,26 @@ export function ConnectionFallback() {
           void load();
       }}
     >
-      <summary>连接其他工具</summary>
+      <summary>{text("连接其他工具")}</summary>
       {!available ? (
-        <p>本机连接材料仅在桌面 App 中可用。</p>
+        <p>{text("本机连接材料仅在桌面 App 中可用。")}</p>
       ) : (
         <>
           <p className="connection-boundary">
-            仅本机 MCP / 命令工具。纯网页聊天不支持直接连接本机。
+            {text("仅本机 MCP / 命令工具。纯网页聊天不支持直接连接本机。")}
           </p>
-          <p>列表内工具请用上方一键安装，此处仅供未列出的工具。</p>
-          {loading && <p role="status">正在读取本机连接配置…</p>}
+          <p>{text("列表内工具请用上方一键安装，此处仅供未列出的工具。")}</p>
+          {loading && <p role="status">{text("正在读取本机连接配置…")}</p>}
           {error && (
             <p role="alert">
-              未能读取连接配置。
+              {text("未能读取连接配置。")}
               <button
                 type="button"
                 className="quiet"
                 onClick={() => void load()}
               >
                 <RefreshCw size={15} aria-hidden="true" />
-                重试
+                {text("重试")}
               </button>
             </p>
           )}
@@ -62,7 +71,7 @@ export function ConnectionFallback() {
             <>
               <div
                 role="tablist"
-                aria-label="连接材料格式"
+                aria-label={text("连接材料格式")}
                 className="connection-modes"
               >
                 {(
@@ -83,26 +92,27 @@ export function ConnectionFallback() {
                       setNotice("");
                     }}
                   >
-                    {label}
+                    {text(label)}
                   </button>
                 ))}
               </div>
               <textarea
-                aria-label="本机连接材料"
+                aria-label={text("本机连接材料")}
                 readOnly
-                value={material[mode] ?? ""}
+                value={value}
                 spellCheck={false}
               />
               <p>
-                包含本机路径，不含记忆和密钥。片段会运行本机 MemHub
-                连接程序；粘贴前请确认，MemHub 需保持运行。
+                {text(
+                  "包含本机路径，不含记忆和密钥。片段会运行本机 MemHub 连接程序；粘贴前请确认，MemHub 需保持运行。",
+                )}
               </p>
               <button
                 type="button"
                 className="secondary"
                 onClick={async () => {
                   try {
-                    await copyText(material[mode] ?? "");
+                    await copyText(value);
                     setNotice("已复制，尚未建立连接。");
                   } catch {
                     setNotice("复制失败，可在上方选中文本复制。");
@@ -110,14 +120,15 @@ export function ConnectionFallback() {
                 }}
               >
                 <Copy size={15} aria-hidden="true" />
-                复制
-                {mode === "prompt"
-                  ? "提示词"
-                  : mode === "mcp"
-                    ? "配置"
-                    : "命令"}
+                {text(
+                  mode === "prompt"
+                    ? "复制提示词"
+                    : mode === "mcp"
+                      ? "复制配置"
+                      : "复制命令",
+                )}
               </button>
-              {notice && <p role="status">{notice}</p>}
+              {notice && <p role="status">{text(notice)}</p>}
             </>
           )}
         </>

memhub/apps/web/src/DebugLogPanel.test.tsx

@@ -11,6 +11,7 @@ import {
 import userEvent from "@testing-library/user-event";
 import { afterEach, beforeEach, expect, it, vi } from "vitest";
 import { DebugLogPanel } from "./DebugLogPanel";
+import { LanguageProvider, useGuiLanguage } from "./gui-language";
 import {
   recordRendererDebugLog,
   resetRendererDebugLogsForTest,
@@ -57,6 +58,7 @@ const snapshot = {
 };
 
 beforeEach(() => {
+  window.localStorage.clear();
   resetRendererDebugLogsForTest();
   diagnosticLevel.get.mockClear();
   diagnosticLevel.set.mockClear();
@@ -71,6 +73,55 @@ afterEach(() => {
   vi.useRealTimers();
 });
 
+function SwitchLanguage() {
+  const { setPreference } = useGuiLanguage();
+  return (
+    <button type="button" onClick={() => void setPreference("zh-CN")}>
+      Cambiar idioma
+    </button>
+  );
+}
+
+it("translates controls live but preserves events and does not change capture", async () => {
+  // A language bridge is not required by this synthetic browser fixture.
+  const read = vi.fn().mockResolvedValue(snapshot);
+  window.oneMemory = undefined;
+  localStorage.setItem("one-memory.gui-language", "es");
+  const view = render(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <DebugLogPanel />
+    </LanguageProvider>,
+  );
+  window.oneMemory = { getDebugLogs: read } as unknown as NonNullable<
+    typeof window.oneMemory
+  >;
+  view.rerender(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <DebugLogPanel />
+    </LanguageProvider>,
+  );
+  await userEvent.click(
+    await screen.findByRole("button", {
+      name: "Abrir registros de depuración",
+    }),
+  );
+  await screen.findByText(/source\.scanned/);
+  expect(
+    screen.getByRole("searchbox", { name: "Buscar registros" }),
+  ).toBeTruthy();
+  await userEvent.click(
+    screen.getByRole("button", { name: "Pausar actualización en vivo" }),
+  );
+  const count = read.mock.calls.length;
+  await userEvent.click(screen.getByRole("button", { name: "Cambiar idioma" }));
+  await screen.findByRole("searchbox", { name: "搜索日志" });
+  expect(screen.getByText(/source\.scanned/)).toBeTruthy();
+  expect(read).toHaveBeenCalledTimes(count);
+  expect(diagnosticLevel.set).not.toHaveBeenCalled();
+});
+
 it("opens from the floating button and filters by text, level and source", async () => {
   render(<DebugLogPanel />);
   await userEvent.click(

memhub/apps/web/src/DebugLogPanel.tsx

@@ -26,6 +26,7 @@ import type {
   DebugLogLevel,
   DebugLogSnapshot,
 } from "./debug-log-types";
+import { useGuiLanguage } from "./gui-language";
 import {
   rendererDebugLogs,
   subscribeRendererDebugLogs,
@@ -50,6 +51,7 @@ const SERVICE_LABELS: Record<DebugLogEntry["service"], string> = {
 };
 
 export function DebugLogPanel() {
+  const { t, locale } = useGuiLanguage();
   const supported = typeof window.oneMemory?.getDebugLogs === "function";
   const [open, setOpen] = useState(false);
   const [live, setLive] = useState(true);
@@ -137,18 +139,22 @@ export function DebugLogPanel() {
   return (
     <div className={`debug-log-root${open ? " is-open" : ""}`}>
       {open ? (
-        <aside className="debug-log-panel" aria-label="Debug 日志">
+        <aside className="debug-log-panel" aria-label={t("debugTitle")}>
           <header className="debug-log-header">
             <div>
-              <strong>Debug 日志</strong>
-              <span>{entries.length} 条，本次启动</span>
+              <strong>{t("debugTitle")}</strong>
+              <span>
+                {t("debugCount", {
+                  count: entries.length.toLocaleString(locale),
+                })}
+              </span>
             </div>
             <div className="debug-log-header-actions">
               <button
                 type="button"
                 className="debug-icon-button"
-                title={live ? "暂停实时刷新" : "继续实时刷新"}
-                aria-label={live ? "暂停实时刷新" : "继续实时刷新"}
+                title={live ? t("debugPause") : t("debugResume")}
+                aria-label={live ? t("debugPause") : t("debugResume")}
                 onClick={() => setLive((value) => !value)}
               >
                 {live ? <CirclePause size={17} /> : <CirclePlay size={17} />}
@@ -156,8 +162,8 @@ export function DebugLogPanel() {
               <button
                 type="button"
                 className="debug-icon-button"
-                title="立即刷新"
-                aria-label="立即刷新"
+                title={t("debugRefresh")}
+                aria-label={t("debugRefresh")}
                 onClick={() => void refresh()}
               >
                 <RefreshCw
@@ -168,8 +174,8 @@ export function DebugLogPanel() {
               <button
                 type="button"
                 className="debug-icon-button"
-                title="关闭 Debug 日志"
-                aria-label="关闭 Debug 日志"
+                title={t("debugClose")}
+                aria-label={t("debugClose")}
                 onClick={() => setOpen(false)}
               >
                 <X size={18} />
@@ -183,18 +189,18 @@ export function DebugLogPanel() {
                 type="search"
                 value={query}
                 onChange={(event) => setQuery(event.target.value)}
-                placeholder="搜索事件、组件、错误码或内容"
-                aria-label="搜索日志"
+                placeholder={t("debugSearchPlaceholder")}
+                aria-label={t("debugSearch")}
               />
             </label>
             <select
-              aria-label="日志来源"
+              aria-label={t("debugSource")}
               value={service}
               onChange={(event) =>
                 setService(event.target.value as typeof service)
               }
             >
-              <option value="all">全部来源</option>
+              <option value="all">{t("debugAllSources")}</option>
               {Object.entries(SERVICE_LABELS).map(([value, label]) => (
                 <option key={value} value={value}>
                   {label}
@@ -202,9 +208,9 @@ export function DebugLogPanel() {
               ))}
             </select>
             <label className="debug-capture-level">
-              <span>采集级别</span>
+              <span>{t("debugCapture")}</span>
               <select
-                aria-label="采集级别"
+                aria-label={t("debugCapture")}
                 value={captureLevel}
                 disabled={capturePending}
                 onChange={(event) => {
@@ -225,7 +231,7 @@ export function DebugLogPanel() {
             </label>
           </div>
           <fieldset className="debug-levels">
-            <legend>显示级别</legend>
+            <legend>{t("debugDisplay")}</legend>
             {LEVELS.map((option) => (
               <button
                 type="button"
@@ -233,16 +239,20 @@ export function DebugLogPanel() {
                 aria-pressed={level === option.value}
                 onClick={() => setLevel(option.value)}
               >
-                {option.label}
+                {option.value === "all" ? t("debugAll") : option.label}
               </button>
             ))}
           </fieldset>
           <div className="debug-log-status" aria-live="polite">
-            <span>{filtered.length} 条匹配</span>
-            <span>{live ? "实时刷新" : "已暂停"}</span>
-            {snapshot?.truncated ? <span>日志过多，已截断</span> : null}
+            <span>
+              {t("debugMatches", {
+                count: filtered.length.toLocaleString(locale),
+              })}
+            </span>
+            <span>{live ? t("debugLive") : t("debugPaused")}</span>
+            {snapshot?.truncated ? <span>{t("debugTruncated")}</span> : null}
             {readState === "error" ? (
-              <span className="debug-read-error">读取失败</span>
+              <span className="debug-read-error">{t("debugReadError")}</span>
             ) : null}
           </div>
           <div className="debug-log-list" ref={listRef}>
@@ -265,7 +275,7 @@ export function DebugLogPanel() {
                       ) : (
                         <ChevronRight size={14} />
                       )}
-                      <time>{logTime(entry.timestamp)}</time>
+                      <time>{logTime(entry.timestamp, locale)}</time>
                       <span className="debug-log-level">{entry.level}</span>
                       <span className="debug-log-service">
                         {SERVICE_LABELS[entry.service]}
@@ -283,7 +293,7 @@ export function DebugLogPanel() {
               })
             ) : (
               <p className="debug-log-empty">
-                {readState === "loading" ? "正在读取日志…" : "没有匹配的日志"}
+                {readState === "loading" ? t("debugLoading") : t("debugEmpty")}
               </p>
             )}
           </div>
@@ -292,8 +302,8 @@ export function DebugLogPanel() {
       <button
         type="button"
         className="debug-fab"
-        aria-label={open ? "Debug 日志已打开" : "打开 Debug 日志"}
-        title="打开 Debug 日志"
+        aria-label={open ? t("debugOpened") : t("debugOpen")}
+        title={t("debugOpen")}
         onClick={() => setOpen(true)}
       >
         <Bug size={20} aria-hidden="true" />
@@ -309,9 +319,9 @@ function searchableEntry(entry: DebugLogEntry): string {
   return JSON.stringify(entry).toLocaleLowerCase();
 }
 
-function logTime(timestamp: string): string {
+function logTime(timestamp: string, locale: string): string {
   const date = new Date(timestamp);
   return Number.isNaN(date.getTime())
     ? timestamp
-    : date.toLocaleTimeString("zh-CN", { hour12: false });
+    : date.toLocaleTimeString(locale, { hour12: false });
 }

memhub/apps/web/src/DesktopFrame.test.tsx

@@ -47,17 +47,18 @@ describe("desktop window frame", () => {
         container.querySelectorAll(".onboarding-r6-titlebar"),
       ).toHaveLength(1);
       expect(container.querySelector(".onboarding-r6-traffic")).toBeNull();
-      // The user removed the mark, the "One Memory" wordmark and the
-      // "第一次见面" caption on 2026-09-20. The bar stays empty; MemHub is not
-      // put back into it.
+      // Branding stays removed; only the explicit GUI language selector
+      // occupies the native titlebar, outside the draggable area.
       expect(screen.queryByText("MemHub")).toBeNull();
       expect(screen.queryByText("One Memory")).toBeNull();
       expect(screen.queryByText("第一次见面")).toBeNull();
       expect(
         container.querySelector(".onboarding-r6-titlebar")?.children.length,
-      ).toBe(0);
+      ).toBe(1);
+      expect(screen.getByRole("combobox", { name: "界面语言" })).toBeTruthy();
       const titlebar = declaration(".onboarding-r6-titlebar");
-      expect(titlebar).toMatch(/flex:\s*0 0 58px/);
+      expect(titlebar).toMatch(/flex:\s*0 0 auto/);
+      expect(titlebar).toMatch(/min-height:\s*58px/);
       expect(titlebar).toMatch(/-webkit-app-region:\s*drag/);
     },
   );

memhub/apps/web/src/FirstImportReview.tsx

@@ -2,6 +2,7 @@ import type { ImportJob, SourceResponse } from "@one-memory/contracts";
 import { Pause, Play } from "lucide-react";
 import { useEffect, useRef, useState } from "react";
 import { connectionHostId } from "./connection-hosts";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { R6ColdStartFrame } from "./R6ColdStartFrame";
 import { R6Button } from "./R6Controls";
 import { R6ImportProgress } from "./R6ImportProgress";
@@ -87,6 +88,7 @@ export function FirstImportReview({
   onConnectionDraftChange,
   onContinue,
 }: FirstImportReviewProps) {
+  const { text, t } = useOnboardingTranslation();
   const stale = sourceSnapshot?.stale === true;
   const ids = [...new Set(sourceIds)];
   // Without explicit IDs, capture the initial batch once; later sync/history jobs
@@ -120,7 +122,14 @@ export function FirstImportReview({
   );
   const progressStale = stale && batch.length === 0;
   const [changing, setChanging] = useState(false);
-  const [actionMessage, setActionMessage] = useState("");
+  const [actionResult, setActionResult] = useState<{
+    stopped: boolean;
+    confirmed: number;
+    failed: number;
+  } | null>(null);
+  const actionMessage = actionResult
+    ? `${actionResult.stopped ? t("onboardingBatchStopped") : ""}${t("onboardingBatchResult", { confirmed: actionResult.confirmed, failed: actionResult.failed })}${actionResult.failed ? text("已确认项保留，请核对未确认任务后重试。") : ""}`
+    : "";
   const batchFlight = useRef(false),
     stopBatch = useRef(false),
     mounted = useRef(true);
@@ -196,7 +205,7 @@ export function FirstImportReview({
     batchFlight.current = true;
     stopBatch.current = false;
     setChanging(true);
-    setActionMessage("");
+    setActionResult(null);
     let confirmed = 0,
       failed = 0;
     try {
@@ -262,9 +271,7 @@ export function FirstImportReview({
         }
       }
       if (mounted.current)
-        setActionMessage(
-          `${stopBatch.current ? "已停止后续操作；已发出的操作仍按回执核对。" : ""}已确认 ${confirmed} 项，${failed} 项未确认。${failed ? "已确认项保留，请核对未确认任务后重试。" : ""}`,
-        );
+        setActionResult({ stopped: stopBatch.current, confirmed, failed });
     } finally {
       batchFlight.current = false;
       if (mounted.current) setChanging(false);
@@ -274,21 +281,23 @@ export function FirstImportReview({
   return (
     <R6ColdStartFrame
       step={2}
-      title={title}
-      eyebrow="导入进行中 · 顺手连接应用"
+      title={text(title)}
+      eyebrow={text("导入进行中 · 顺手连接应用")}
       footer={
         <>
           <div className="first-import-r6-footer-note">
             <p>
-              {allCompleted
-                ? "对话已保存，记忆尚待生成。"
-                : displayImporting
-                  ? "导入在后台继续，无需等待。"
-                  : stale
-                    ? "正在重新核对来源；已保存数量仍按任务回执显示。"
-                    : allPaused
-                      ? "本次历史导入已暂停，已保存的对话还在。"
-                      : "导入等待处理，已保存的对话还在。"}
+              {text(
+                allCompleted
+                  ? "对话已保存，记忆尚待生成。"
+                  : displayImporting
+                    ? "导入在后台继续，无需等待。"
+                    : stale
+                      ? "正在重新核对来源；已保存数量仍按任务回执显示。"
+                      : allPaused
+                        ? "本次历史导入已暂停，已保存的对话还在。"
+                        : "导入等待处理，已保存的对话还在。",
+              )}
             </p>
             {(error || actionMessage) && (
               <p
@@ -307,7 +316,7 @@ export function FirstImportReview({
                     : undefined
                 }
               >
-                {error || actionMessage}
+                {error ? text(error) : actionMessage}
               </p>
             )}
           </div>
@@ -318,7 +327,7 @@ export function FirstImportReview({
                   stopBatch.current = true;
                 }}
               >
-                停止后续操作
+                {text("停止后续操作")}
               </R6Button>
             ) : onChangeJob && (canPause || canResume) ? (
               <R6Button
@@ -330,7 +339,7 @@ export function FirstImportReview({
                 ) : (
                   <Play size={16} aria-hidden="true" />
                 )}
-                {canPause ? "暂停导入" : "继续导入"}
+                {text(canPause ? "暂停导入" : "继续导入")}
               </R6Button>
             ) : null}
             {recovery ? (
@@ -342,18 +351,20 @@ export function FirstImportReview({
                     recovery.onSkip();
                   }}
                 >
-                  {recovery.destination === "sources"
-                    ? "仍进入应用页"
-                    : recovery.destination === "settings"
-                      ? "仍进入设置"
-                      : "仍进入工作台"}
+                  {text(
+                    recovery.destination === "sources"
+                      ? "仍进入应用页"
+                      : recovery.destination === "settings"
+                        ? "仍进入设置"
+                        : "仍进入工作台",
+                  )}
                 </R6Button>
                 <R6Button
                   variant="primary"
                   disabled={busy}
                   onClick={() => leave(recovery.destination)}
                 >
-                  重试保存并进入
+                  {text("重试保存并进入")}
                 </R6Button>
               </>
             ) : (
@@ -362,7 +373,7 @@ export function FirstImportReview({
                 disabled={busy}
                 onClick={() => leave("settings")}
               >
-                配置模型，沉淀记忆
+                {text("配置模型，沉淀记忆")}
               </R6Button>
             )}
           </div>
@@ -370,19 +381,25 @@ export function FirstImportReview({
       }
     >
       <div className="first-import-r6-layout">
-        <section className="first-import-r6-main" aria-label="导入与原文">
+        <section
+          className="first-import-r6-main"
+          aria-label={text("导入与原文")}
+        >
           <p className="first-import-r6-intro">
-            {allCompleted
-              ? "本次导入已结束。已保存的对话无需重复导入。"
-              : "对话先保存在本机。你可以同时设置后续连接。"}
+            {text(
+              allCompleted
+                ? "本次导入已结束。已保存的对话无需重复导入。"
+                : "对话先保存在本机。你可以同时设置后续连接。",
+            )}
           </p>
           <p className="first-import-r6-subintro">
-            导入不会自动开放应用读取权限。配置模型后，才会开始生成记忆。
+            {text(
+              "导入不会自动开放应用读取权限。配置模型后，才会开始生成记忆。",
+            )}
           </p>
           {historyWindowLimited && (
             <p className="first-import-r6-history-window" role="status">
-              检测到会话数据量较大。为控制用量并保持各应用时间线一致，本次所有应用仅导入最近
-              3 天的对话。
+              {t("onboardingHistoryWindow")}
             </p>
           )}
           <R6ImportProgress
@@ -391,21 +408,24 @@ export function FirstImportReview({
             jobs={batch}
             stale={progressStale}
           />
-          <section className="first-import-r6-feed" aria-label="导入说明">
-            <h2>正在导入你的会话</h2>
+          <section
+            className="first-import-r6-feed"
+            aria-label={text("导入说明")}
+          >
+            <h2>{text("正在导入你的会话")}</h2>
             <p className="first-import-r6-feed-status">
-              后台将持续为你导入，可以放心进入下一步
+              {text("后台将持续为你导入，可以放心进入下一步")}
             </p>
             {Object.keys(failedSources).length > 0 && (
               <section
                 className="first-import-r6-failures"
-                aria-label="未开始的导入"
+                aria-label={text("未开始的导入")}
               >
                 {Object.keys(failedSources).map((id) => (
                   <p key={id}>
                     {sources.find((source) => source.source_id === id)
                       ?.display_name ?? id}{" "}
-                    未能开始导入，其他已接受任务不受影响。
+                    {text("未能开始导入，其他已接受任务不受影响。")}
                   </p>
                 ))}
                 <R6Button
@@ -413,27 +433,30 @@ export function FirstImportReview({
                   disabled={busy}
                   onClick={() => leave("sources")}
                 >
-                  查看未导入的应用
+                  {text("查看未导入的应用")}
                 </R6Button>
               </section>
             )}
           </section>
         </section>
-        <aside className="first-import-r6-options" aria-label="连接应用">
-          <p className="first-import-r6-eyebrow">让记忆继续生长</p>
-          <h2>连接你的应用</h2>
+        <aside
+          className="first-import-r6-options"
+          aria-label={text("连接应用")}
+        >
+          <p className="first-import-r6-eyebrow">{text("让记忆继续生长")}</p>
+          <h2>{text("连接你的应用")}</h2>
           <p className="first-import-r6-options-intro">
-            适用于本次选择且支持的应用。
+            {text("适用于本次选择且支持的应用。")}
           </p>
           <SelectionTile
-            title={
-              hostConnectionAvailable ? "一键接入应用" : "测试实例不接入应用"
-            }
-            body={
+            title={text(
+              hostConnectionAvailable ? "一键接入应用" : "测试实例不接入应用",
+            )}
+            body={text(
               hostConnectionAvailable
                 ? "安装记忆连接，让所选应用用上 MemHub 中的相关记忆。"
-                : "当前使用独立测试数据目录，不会修改本机应用的连接配置。"
-            }
+                : "当前使用独立测试数据目录，不会修改本机应用的连接配置。",
+            )}
             checked={
               hostConnectionAvailable &&
               !!hostEligible.length &&
@@ -456,12 +479,16 @@ export function FirstImportReview({
             }
           />
           {connectionNote && (
-            <p className="first-import-r6-options-note">{connectionNote}</p>
+            <p className="first-import-r6-options-note">
+              {text(connectionNote)}
+            </p>
           )}
           <p className="first-import-r6-options-note">
-            {draftReady
-              ? "点击底部按钮后，后台分别接入各应用；某个应用失败不影响其他应用。"
-              : "暂时无法连接应用，当前不会安装连接。"}
+            {text(
+              draftReady
+                ? "点击底部按钮后，后台分别接入各应用；某个应用失败不影响其他应用。"
+                : "暂时无法连接应用，当前不会安装连接。",
+            )}
           </p>
         </aside>
       </div>

memhub/apps/web/src/FirstUseGuide.test.tsx

@@ -1,9 +1,54 @@
 // @vitest-environment jsdom
 import type { MemoryDetail, SourceResponse } from "@one-memory/contracts";
-import { act, cleanup, render, screen, waitFor } from "@testing-library/react";
+import {
+  act,
+  cleanup,
+  fireEvent,
+  render,
+  screen,
+  waitFor,
+} from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { FirstUseGuide, FirstUseInvitation } from "./FirstUseGuide";
+import { LanguageProvider, useGuiLanguage } from "./gui-language";
+
+function GuideLanguageSwitch() {
+  const { setPreference } = useGuiLanguage();
+  return (
+    <button type="button" onClick={() => void setPreference("zh-CN")}>
+      Cambiar idioma
+    </button>
+  );
+}
+
+it("localizes the supported guide without changing original memory or copying", async () => {
+  window.oneMemory = undefined;
+  localStorage.setItem("one-memory.gui-language", "es");
+  render(
+    <LanguageProvider>
+      <GuideLanguageSwitch />
+      <FirstUseGuide sources={[source]} onSources={vi.fn()} onClose={vi.fn()} />
+    </LanguageProvider>,
+  );
+  await screen.findByRole("heading", {
+    name: "Retoma tu próxima conversación",
+  });
+  await screen.findByText(detail.memory.content, { selector: "blockquote" });
+  expect(
+    screen.getByRole("button", { name: "Copiar mensaje inicial" }),
+  ).toBeTruthy();
+  const reads = getMemory.mock.calls.length;
+  fireEvent.click(screen.getByText("Cambiar idioma"));
+  await screen.findByRole("heading", { name: "让下一次对话接得上" });
+  expect(getMemory).toHaveBeenCalledTimes(reads);
+  expect(
+    screen.getByText(detail.memory.content, { selector: "blockquote" }),
+  ).toBeTruthy();
+  expect(copyText).not.toHaveBeenCalled();
+  expect(openHandoff).not.toHaveBeenCalled();
+  localStorage.clear();
+});
 
 const getMemories = vi.fn(),
   getMemory = vi.fn(),

memhub/apps/web/src/FirstUseGuide.tsx

@@ -3,6 +3,7 @@ import type {
   MemoryDetail,
   SourceResponse,
 } from "@one-memory/contracts";
+import type { MessageKey } from "@one-memory/contracts/gui-i18n";
 import {
   ArrowLeft,
   ArrowRight,
@@ -27,6 +28,7 @@ import {
   sameGuideMemory,
 } from "./first-use-model";
 import type { RecallHostStatus } from "./global";
+import { useGuiLanguage } from "./gui-language";
 import { refreshRecallHosts, useRecallHosts } from "./host-state";
 import { refreshSources } from "./source-state";
 
@@ -41,6 +43,7 @@ export function FirstUseGuide({
   onSources(): void;
   onClose(): void;
 }) {
+  const { t, locale } = useGuiLanguage();
   const [scene, setScene] = useState<GuideScenario>("same");
   const [route, setRoute] = useState<GuideRoute>("context");
   const [memories, setMemories] = useState<GovernedMemory[]>([]);
@@ -52,11 +55,12 @@ export function FirstUseGuide({
   const hosts = hostsError ? NO_HOSTS : (hostRead.data ?? NO_HOSTS);
   const [loading, setLoading] = useState(true);
   const [detailLoading, setDetailLoading] = useState(false);
-  const [error, setError] = useState("");
+  const [error, setError] = useState<MessageKey | "">("");
   const [reload, setReload] = useState(0);
   const [targetId, setTargetId] = useState("");
   const [topic, setTopic] = useState("");
-  const [notice, setNotice] = useState("");
+  const [notice, setNotice] = useState<MessageKey | "">("");
+  const [noticeHost, setNoticeHost] = useState("");
   const [copiedKey, setCopiedKey] = useState("");
   const [busy, setBusy] = useState(false);
   const [reported, setReported] = useState<"ok" | "missing" | null>(null);
@@ -108,7 +112,7 @@ export function FirstUseGuide({
         if (!cancelled) {
           setMemories([]);
           setSelectedId("");
-          setError("暂时无法读取记忆，可稍后重试。");
+          setError("guideReadError");
         }
       })
       .finally(() => {
@@ -143,7 +147,7 @@ export function FirstUseGuide({
         );
       })
       .catch(() => {
-        if (!cancelled) setError("这条记忆暂不可读，请换一条或刷新。");
+        if (!cancelled) setError("guideDetailError");
       })
       .finally(() => {
         if (!cancelled) setDetailLoading(false);
@@ -172,7 +176,12 @@ export function FirstUseGuide({
   const nameOf = (id: string) =>
     sources.find((item) => item.source_id === id)?.display_name ??
     (id === "one-memory-manual" ? "端内添加" : id);
+  // The handoff draft is task content, not UI copy: retain its existing wording.
   const sourceLabel = sourceIds.map(nameOf).join("、") || "原应用";
+  const displaySourceLabel =
+    sourceIds
+      .map((id) => (id === "one-memory-manual" ? t("guideManual") : nameOf(id)))
+      .join(locale === "es" ? ", " : "、") || t("guideOriginalApp");
   const draft =
     available && detail
       ? draftForScenario(scene, effectiveRoute, topic, detail, sourceLabel)
@@ -218,7 +227,7 @@ export function FirstUseGuide({
       ) {
         setDetail(null);
         setCopiedKey("");
-        setError("记忆内容或授权已变化，请刷新后重新核对。");
+        setError("guideChanged");
         return;
       }
       if (
@@ -232,7 +241,7 @@ export function FirstUseGuide({
         )
       ) {
         setCopiedKey("");
-        setNotice("连接状态已变化，尚未复制。请重新选择方式。");
+        setNotice("guideConnectionChanged");
         return;
       }
       validated = true;
@@ -242,25 +251,24 @@ export function FirstUseGuide({
       if (open && host?.handoff === "open" && window.oneMemory) {
         try {
           const result = await window.oneMemory.openHandoff(host.hostId, draft);
-          if (current())
+          if (current()) {
+            setNoticeHost(host.label);
             setNotice(
-              result.opened
-                ? `已复制并请求打开 ${host.label}。尚未发送，请核对输入框。`
-                : "已完整复制，未能预填。可在目标应用粘贴，尚未发送。",
+              result.opened ? "guideCopiedOpened" : "guideCopiedNotFilled",
             );
+          }
         } catch {
-          if (current())
-            setNotice("已完整复制，但未能打开目标应用。尚未发送。");
+          if (current()) setNotice("guideCopiedNotOpened");
         }
-      } else setNotice("已完整复制。尚未发送，也没有新增读取授权。");
+      } else setNotice("guideCopied");
     } catch {
       if (current()) {
         if (!validated) {
           setDetail(null);
           setCopiedKey("");
-          setError("无法核对当前记忆与授权，旧预览已收起。请刷新后重试。");
+          setError("guideValidationError");
         }
-        setNotice("未能核对最新内容或完成复制。请重试；没有打开目标应用。");
+        setNotice("guideCopyError");
       }
     } finally {
       if (current()) setBusy(false);
@@ -271,16 +279,16 @@ export function FirstUseGuide({
     <section className="view first-use-view" aria-labelledby="first-use-title">
       <header className="first-use-heading">
         <div>
-          <p className="first-use-eyebrow">上手体验</p>
-          <h1 id="first-use-title">让下一次对话接得上</h1>
+          <p className="first-use-eyebrow">{t("guideEyebrow")}</p>
+          <h1 id="first-use-title">{t("guideTitle")}</h1>
         </div>
         <button type="button" className="quiet" onClick={onClose}>
           <ArrowLeft size={16} aria-hidden="true" />
-          返回记忆
+          {t("guideBack")}
         </button>
       </header>
       <fieldset className="first-use-scenarios">
-        <legend className="sr-only">选择使用场景</legend>
+        <legend className="sr-only">{t("guideChooseScene")}</legend>
         {GUIDE_SCENARIOS.map((item, index) => (
           <label key={item.id} data-selected={scene === item.id}>
             <input
@@ -296,47 +304,63 @@ export function FirstUseGuide({
               }}
             />
             <span className="first-use-number">0{index + 1}</span>
-            <span>{item.label}</span>
+            <span>
+              {t(
+                item.id === "same"
+                  ? "guideSame"
+                  : item.id === "switch"
+                    ? "guideSwitch"
+                    : "guideNew",
+              )}
+            </span>
           </label>
         ))}
       </fieldset>
-      <p className="first-use-description">{scenario.description}</p>
+      <p className="first-use-description">
+        {t(
+          scenario.id === "same"
+            ? "guideSameDescription"
+            : scenario.id === "switch"
+              ? "guideSwitchDescription"
+              : "guideNewDescription",
+        )}
+      </p>
       {importedMessages > 0 && (
         <p className="first-use-receipt">
-          本机已保存 {importedMessages.toLocaleString()} 条原始消息 ·{" "}
+          {t("guideSaved", { count: importedMessages.toLocaleString(locale) })}
           {loading
-            ? "正在读取已整理记忆"
-            : `本页已加载 ${memories.length} 条可用记忆`}
-          。两个阶段分别计数。
+            ? t("guideReadingMemories")
+            : t("guideLoaded", {
+                count: memories.length.toLocaleString(locale),
+              })}
+          {t("guideSeparate")}
         </p>
       )}
       <div className="first-use-path">
-        <span>选择背景</span>
+        <span>{t("guideChooseBackground")}</span>
         <ArrowRight size={14} aria-hidden="true" />
-        <span>核对来源</span>
+        <span>{t("guideCheckSources")}</span>
         <ArrowRight size={14} aria-hidden="true" />
-        <span>到新对话试用</span>
+        <span>{t("guideTry")}</span>
       </div>
       {error && (
         <p className="error-banner" role="alert">
-          {error}
+          {t(error)}
         </p>
       )}
       {loading ? (
-        <p role="status">正在读取本机已有记忆…</p>
+        <p role="status">{t("guideLoading")}</p>
       ) : !memories.length ? (
         <section className="first-use-empty">
           <FileText size={28} aria-hidden="true" />
-          <h2>先留下一条真正有用的背景</h2>
-          <p>
-            目前没有可用于这次体验的记忆。已导入的原文不等于已经整理好；候选内容也不会被自动带出。
-          </p>
+          <h2>{t("guideEmptyTitle")}</h2>
+          <p>{t("guideEmptyDescription")}</p>
           <div>
             <button type="button" onClick={onClose}>
-              去添加记忆
+              {t("guideAdd")}
             </button>
             <button type="button" className="secondary" onClick={onSources}>
-              查看导入与连接
+              {t("guideConnections")}
             </button>
             <button
               type="button"
@@ -344,7 +368,7 @@ export function FirstUseGuide({
               onClick={() => setReload((n) => n + 1)}
             >
               <RefreshCw size={15} />
-              刷新
+              {t("guideRefresh")}
             </button>
           </div>
         </section>
@@ -355,12 +379,12 @@ export function FirstUseGuide({
             aria-labelledby="guide-background-title"
           >
             <header>
-              <h2 id="guide-background-title">这次用到的背景</h2>
+              <h2 id="guide-background-title">{t("guideBackgroundTitle")}</h2>
               <button
                 type="button"
                 className="quiet"
-                title="刷新示例"
-                aria-label="刷新示例"
+                title={t("guideRefreshExample")}
+                aria-label={t("guideRefreshExample")}
                 onClick={() => {
                   changed();
                   setDetail(null);
@@ -372,7 +396,7 @@ export function FirstUseGuide({
               </button>
             </header>
             <label className="first-use-field">
-              选择一条记忆
+              {t("guideChooseMemory")}
               <select
                 value={selectedId}
                 onChange={(event) => {
@@ -390,46 +414,55 @@ export function FirstUseGuide({
               </select>
             </label>
             <p className="first-use-meta">
-              从当前已加载的 {memories.length}{" "}
-              条可用记忆中选择，不代表全部历史。
+              {t("guideLoadedScope", {
+                count: memories.length.toLocaleString(locale),
+              })}
             </p>
             {detailLoading ? (
-              <p role="status">正在核对原始依据…</p>
+              <p role="status">{t("guideCheckingEvidence")}</p>
             ) : available && detail ? (
               <>
                 <blockquote className="first-use-memory">
                   {detail.memory.content}
                 </blockquote>
                 <p className="first-use-meta">
-                  {sourceLabel} · 版本 {detail.memory.revision} ·
-                  系统整理，需你核对
+                  {t("guideRevision", {
+                    source: displaySourceLabel,
+                    revision: detail.memory.revision.toLocaleString(locale),
+                  })}
                 </p>
                 <p className="first-use-scope">
-                  适用范围：
+                  {t("guideScope")}
                   {detail.memory.scopes.includes("all-apps")
-                    ? "已设为跨应用可用，不等于个人偏好"
+                    ? t("guideAllApps")
                     : detail.memory.scopes.includes("private")
-                      ? "已停止外部记忆召回；手动带出需另行确认"
-                      : "限定范围，未扩大外部召回范围"}
+                      ? t("guidePrivate")
+                      : t("guideLimited")}
                 </p>
                 <details className="first-use-evidence" open>
-                  <summary>原始依据 · {detail.evidence.length} 段</summary>
+                  <summary>
+                    {t("guideEvidence", {
+                      count: detail.evidence.length.toLocaleString(locale),
+                    })}
+                  </summary>
                   {detail.evidence.map((item) => (
                     <article key={item.evidence_id}>
                       <header>
                         <span>
-                          {item.source_id ? nameOf(item.source_id) : "未知来源"}
+                          {item.source_id
+                            ? nameOf(item.source_id)
+                            : t("guideUnknownSource")}
                         </span>
                         <span>
                           {item.written_by === "person"
-                            ? "你"
+                            ? t("guideYou")
                             : item.written_by === "agent"
                               ? "Agent"
-                              : "作者未识别"}{" "}
+                              : t("guideUnknownAuthor")}{" "}
                           ·{" "}
                           {item.created_at
-                            ? new Date(item.created_at).toLocaleString()
-                            : "时间未知"}
+                            ? new Date(item.created_at).toLocaleString(locale)
+                            : t("guideUnknownTime")}
                         </span>
                       </header>
                       <p>{item.verbatim}</p>
@@ -438,18 +471,16 @@ export function FirstUseGuide({
                 </details>
               </>
             ) : (
-              <p className="first-use-unavailable">
-                原文或当前授权不可用。换一条背景或刷新后再试，不会带出这条内容。
-              </p>
+              <p className="first-use-unavailable">{t("guideUnavailable")}</p>
             )}
           </section>
           <section
             className="first-use-destination"
             aria-labelledby="guide-draft-title"
           >
-            <h2 id="guide-draft-title">下一段对话的开场白</h2>
+            <h2 id="guide-draft-title">{t("guideDraftTitle")}</h2>
             <label className="first-use-field">
-              在哪个应用试用
+              {t("guideChooseApp")}
               <select
                 value={host?.hostId ?? ""}
                 onChange={(event) => {
@@ -458,7 +489,7 @@ export function FirstUseGuide({
                   setRoute("context");
                 }}
               >
-                <option value="">自行选择应用 · 仅复制</option>
+                <option value="">{t("guideCopyOnly")}</option>
                 {destinations.map((item) => (
                   <option key={item.hostId} value={item.hostId}>
                     {item.label}
@@ -468,14 +499,14 @@ export function FirstUseGuide({
             </label>
             <p className="first-use-connection">
               {hostsError
-                ? "暂时无法读取连接状态，可重试或仅复制背景。"
+                ? t("guideHostsError")
                 : !host
-                  ? "尚未选择已连接的应用。手动带入不等于安装连接。"
+                  ? t("guideNoApp")
                   : canQuery
-                    ? "上次自检可达，本次是否用对仍需核对。"
+                    ? t("guideWired")
                     : host.installed
-                      ? "已安装连接，尚未验证读取。"
-                      : "尚未安装读取连接。"}
+                      ? t("guideInstalled")
+                      : t("guideNotInstalled")}
             </p>
             <button
               type="button"
@@ -483,10 +514,10 @@ export function FirstUseGuide({
               onClick={onSources}
             >
               <Link2 size={15} aria-hidden="true" />
-              管理应用连接
+              {t("guideManage")}
             </button>
             <fieldset className="first-use-routes">
-              <legend className="sr-only">选择带入方式</legend>
+              <legend className="sr-only">{t("guideChooseRoute")}</legend>
               <label>
                 <input
                   type="radio"
@@ -497,7 +528,7 @@ export function FirstUseGuide({
                     setRoute("context");
                   }}
                 />
-                带入背景
+                {t("guideContext")}
               </label>
               <label>
                 <input
@@ -510,12 +541,12 @@ export function FirstUseGuide({
                     setRoute("query");
                   }}
                 />
-                让应用查询
+                {t("guideQuery")}
               </label>
             </fieldset>
             {effectiveRoute === "query" && (
               <label className="first-use-field">
-                要接续的主题
+                {t("guideTopic")}
                 <input
                   value={topic}
                   maxLength={160}
@@ -528,17 +559,17 @@ export function FirstUseGuide({
             )}
             <p className="first-use-meta">
               {effectiveRoute === "query"
-                ? "只带查询，不把上方的预期答案塞进新会话。"
+                ? t("guideQueryHint")
                 : scene === "new"
-                  ? "仅带你选择的这一条，不自动生成个人画像。"
-                  : "完整带入这一条背景与引用；这不是自动召回测试。"}
+                  ? t("guideNewHint")
+                  : t("guideContextHint")}
             </p>
             <textarea
               className="first-use-draft"
-              aria-label="开场白完整预览"
+              aria-label={t("guidePreview")}
               readOnly
               value={draft}
-              placeholder="原始依据可用后显示开场白"
+              placeholder={t("guidePreviewPlaceholder")}
               spellCheck={false}
             />
             <div className="first-use-actions">
@@ -548,7 +579,7 @@ export function FirstUseGuide({
                 onClick={() => void carry(false)}
               >
                 <Copy size={16} aria-hidden="true" />
-                {busy ? "正在核对…" : "复制开场白"}
+                {busy ? t("guideChecking") : t("guideCopy")}
               </button>
               {host?.handoff === "open" && (
                 <button
@@ -558,18 +589,18 @@ export function FirstUseGuide({
                   onClick={() => void carry(true)}
                 >
                   <ExternalLink size={16} aria-hidden="true" />
-                  复制并打开 {host.label}
+                  {t("guideCopyOpen", { host: host.label })}
                 </button>
               )}
             </div>
             {notice && (
               <p className="first-use-notice" role="status">
-                {notice}
+                {t(notice, { host: noticeHost })}
               </p>
             )}
             {copiedKey === contextKey && (
               <section className="first-use-result">
-                <p>尚无本次外部调用回执。新对话是否引用了正确的背景？</p>
+                <p>{t("guideNoReceipt")}</p>
                 <div>
                   <button
                     type="button"
@@ -577,21 +608,21 @@ export function FirstUseGuide({
                     onClick={() => setReported("ok")}
                   >
                     <Check size={15} />
-                    我已核对结果
+                    {t("guideVerified")}
                   </button>
                   <button
                     type="button"
                     className="quiet"
                     onClick={() => setReported("missing")}
                   >
-                    没有找回来
+                    {t("guideMissing")}
                   </button>
                 </div>
                 {reported && (
                   <p role="status">
                     {reported === "ok"
-                      ? "你的反馈：已核对。这不是系统自动验收记录。"
-                      : "你的反馈：没有找回来。先检查来源是否导入、记忆范围与应用连接。"}
+                      ? t("guideFeedbackOk")
+                      : t("guideFeedbackMissing")}
                   </p>
                 )}
               </section>
@@ -610,18 +641,19 @@ export function FirstUseInvitation({
   onOpen(): void;
   onDismiss(): void;
 }) {
+  const { t } = useGuiLanguage();
   return (
-    <aside className="first-use-invitation" aria-label="上手体验邀请">
-      <span>用一条自己的记忆，试着接续下一次对话。</span>
+    <aside className="first-use-invitation" aria-label={t("guideInvitation")}>
+      <span>{t("guideInvitationHint")}</span>
       <button type="button" className="quiet" onClick={onOpen}>
-        试一次
+        {t("guideTryOnce")}
         <ArrowRight size={15} aria-hidden="true" />
       </button>
       <button
         type="button"
         className="quiet"
-        title="稍后再看"
-        aria-label="关闭上手邀请"
+        title={t("guideLater")}
+        aria-label={t("guideDismiss")}
         onClick={onDismiss}
       >
         <X size={15} />

memhub/apps/web/src/GraphWidthPrompt.test.tsx

@@ -13,6 +13,16 @@ import { cleanup, render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { GraphWidthPrompt } from "./GraphWidthPrompt";
+import { LanguageProvider, useGuiLanguage } from "./gui-language";
+
+function LanguageSwitch() {
+  const { setPreference } = useGuiLanguage();
+  return (
+    <button type="button" onClick={() => void setPreference("zh-CN")}>
+      Cambiar idioma
+    </button>
+  );
+}
 
 const { getGraphWidth, decideGraphWidth } = vi.hoisted(() => ({
   getGraphWidth: vi.fn(),
@@ -47,6 +57,44 @@ describe("GraphWidthPrompt", () => {
     });
   });
 
+  it("translates the mismatch and live switch without requesting or confirming twice", async () => {
+    window.localStorage.setItem("one-memory.gui-language", "es");
+    const user = userEvent.setup();
+    render(
+      <LanguageProvider>
+        <LanguageSwitch />
+        <GraphWidthPrompt />
+      </LanguageProvider>,
+    );
+    await screen.findByRole("dialog", {
+      name: "La biblioteca y el modelo integrado no coinciden",
+    });
+    const keep = screen.getByRole("radio", {
+      name: /Conservar la biblioteca actual/,
+    }) as HTMLInputElement;
+    expect(keep.checked).toBe(true);
+    await user.click(
+      screen.getByRole("radio", { name: /Usar el modelo integrado/ }),
+    );
+    expect(decideGraphWidth).not.toHaveBeenCalled();
+    await user.click(screen.getByRole("button", { name: "Cambiar idioma" }));
+    await screen.findByRole("dialog", { name: "现有记忆库和内置模型对不上" });
+    expect(
+      (screen.getByRole("radio", { name: /改用内置模型/ }) as HTMLInputElement)
+        .checked,
+    ).toBe(true);
+    expect(getGraphWidth).toHaveBeenCalledOnce();
+    expect(decideGraphWidth).not.toHaveBeenCalled();
+    await user.click(screen.getByRole("button", { name: "就这么办" }));
+    await waitFor(() =>
+      expect(decideGraphWidth).toHaveBeenCalledExactlyOnceWith(
+        "rebuild_with_new",
+        expect.any(String),
+      ),
+    );
+    window.localStorage.removeItem("one-memory.gui-language");
+  });
+
   it("moves focus into the modal and keeps Tab inside it", async () => {
     const user = userEvent.setup();
     render(

memhub/apps/web/src/GraphWidthPrompt.tsx

@@ -4,6 +4,7 @@ import type {
 } from "@one-memory/contracts";
 import { useEffect, useRef, useState } from "react";
 import { decideGraphWidth, getGraphWidth } from "./api";
+import { useGuiLanguage } from "./gui-language";
 import { traceUiAction } from "./ui-trace";
 import { isDefiniteRefusal, writeTraceStatus } from "./write-outcome";
 
@@ -20,6 +21,7 @@ export function GraphWidthPrompt({
 }: {
   onResolved?(): void;
 }) {
+  const { t, locale } = useGuiLanguage();
   const [status, setStatus] = useState<GraphWidthStatus | null>(null);
   const [decision, setDecision] = useState<GraphWidthDecision>("keep_existing");
   const [busy, setBusy] = useState(false);
@@ -88,7 +90,7 @@ export function GraphWidthPrompt({
           ? reason instanceof Error
             ? reason.message
             : String(reason)
-          : "宽度选择尚未确认，现有记忆库未被改动。请重试。",
+          : "graphWidthUnknown",
       );
     } finally {
       setBusy(false);
@@ -98,15 +100,19 @@ export function GraphWidthPrompt({
   const choices: { value: GraphWidthDecision; label: string }[] = [
     {
       value: "keep_existing",
-      label: `保留现有记忆库（默认）：继续用原来的 embedding 配置，${status.memory_count} 条记忆和关系图都不动`,
+      label: t("graphWidthKeep", {
+        count: status.memory_count.toLocaleString(locale),
+      }),
     },
     {
       value: "rebuild_with_new",
-      label: `改用内置模型：现有关系图会被归档（不删除），${status.memory_count} 条记忆的关系需要重新建一遍`,
+      label: t("graphWidthRebuild", {
+        count: status.memory_count.toLocaleString(locale),
+      }),
     },
     {
       value: "export_first",
-      label: "先导出再决定：现在什么都不动，导出之后再回来选",
+      label: t("graphWidthExport"),
     },
   ];
 
@@ -115,7 +121,7 @@ export function GraphWidthPrompt({
       className="graph-width-prompt"
       role="dialog"
       aria-modal="true"
-      aria-label="现有记忆库和内置模型对不上"
+      aria-label={t("graphWidthTitle")}
       ref={panel}
       onKeyDown={(event) => {
         if (event.key !== "Tab" || !panel.current) return;
@@ -136,9 +142,12 @@ export function GraphWidthPrompt({
         }
       }}
     >
-      <h2>现有记忆库和内置模型对不上</h2>
+      <h2>{t("graphWidthTitle")}</h2>
       <p>
-        {`你现在的记忆库按 ${stored_width} 维建的，内置模型出的是 ${expected_width} 维。两者接不上，不选一个的话抽取会一直失败。`}
+        {t("graphWidthDescription", {
+          stored: stored_width.toLocaleString(locale),
+          expected: expected_width.toLocaleString(locale),
+        })}
       </p>
       <ul>
         {choices.map((choice) => (
@@ -159,12 +168,16 @@ export function GraphWidthPrompt({
       </ul>
       {exportedPath ? (
         <p className="notice">
-          已导出到 <code>{exportedPath}</code>。原库没有动，现在可以再选一次。
+          {t("graphWidthExported", { path: exportedPath })}
+        </p>
+      ) : null}
+      {error ? (
+        <p className="notice">
+          {error === "graphWidthUnknown" ? t("graphWidthUnknown") : error}
         </p>
       ) : null}
-      {error ? <p className="notice">{error}</p> : null}
       <button type="button" disabled={busy} onClick={() => void confirm()}>
-        就这么办
+        {t("graphWidthConfirm")}
       </button>
     </div>
   );

memhub/apps/web/src/HealthPanel.test.tsx

@@ -12,6 +12,7 @@ import {
 import { StrictMode } from "react";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
+import { LanguageProvider, useGuiLanguage } from "./gui-language";
 import { HealthPanel } from "./HealthPanel";
 import type { ImportSourcesController } from "./use-import-sources";
 
@@ -25,6 +26,37 @@ vi.mock("./api", () => ({
   setDetailedLogging: (enabled: boolean) => setDetailedLogging(enabled),
 }));
 
+function HealthLanguageSwitch() {
+  const { setPreference } = useGuiLanguage();
+  return (
+    <button type="button" onClick={() => void setPreference("zh-CN")}>
+      Cambiar idioma
+    </button>
+  );
+}
+
+it("shows supported diagnostics in Spanish without toggling logging", async () => {
+  window.oneMemory = undefined;
+  localStorage.setItem("one-memory.gui-language", "es");
+  render(
+    <LanguageProvider>
+      <HealthLanguageSwitch />
+      <HealthPanel imports={imports()} />
+    </LanguageProvider>,
+  );
+  await screen.findByRole("heading", { name: "Diagnóstico" });
+  expect(
+    screen.getByRole("button", { name: "Volver a leer el estado" }),
+  ).toBeTruthy();
+  expect(screen.getByRole("heading", { name: "Servicio local" })).toBeTruthy();
+  const reads = getMemoryProcessing.mock.calls.length;
+  fireEvent.click(screen.getByText("Cambiar idioma"));
+  await screen.findByRole("heading", { name: "运行诊断" });
+  expect(getMemoryProcessing).toHaveBeenCalledTimes(reads);
+  expect(setDetailedLogging).not.toHaveBeenCalled();
+  localStorage.clear();
+});
+
 function source(
   sourceId: string,
   overrides: Partial<SourceResponse> = {},
@@ -151,7 +183,9 @@ describe("HealthPanel", () => {
     render(<HealthPanel imports={imports()} />);
 
     const details = await screen.findByLabelText("导入与整理详情");
-    expect(details.textContent).toContain("100000 条原文 · 50000 个完整 turn");
+    expect(details.textContent).toContain(
+      "100,000 条原文 · 50,000 个完整 turn",
+    );
     expect(details.textContent).toContain(
       "120 次调用 · 100 完成 · 1 结果不确定 · 2 失败 · 3 取消",
     );

memhub/apps/web/src/HealthPanel.tsx

@@ -1,6 +1,6 @@
+import { type GuiLocale, translate } from "@one-memory/contracts/gui-i18n";
 import { Download, Flag, RefreshCw } from "lucide-react";
 import { useCallback, useEffect, useRef, useState } from "react";
-
 import {
   getDetailedLogging,
   getMemoryProcessing,
@@ -13,7 +13,9 @@ import {
 import { clockStamp } from "./clock-stamp";
 import { exportDiagnosticsFile } from "./diagnostics-export";
 import type { RecallHostStatus } from "./global";
+import { useGuiLanguage } from "./gui-language";
 import { refreshRecallHosts } from "./host-state";
+import { memoryText } from "./memory-language";
 import {
   blockReasonLabel,
   retryingBlockLabel,
@@ -111,23 +113,26 @@ function ReadReceipt({
   confirmedAt,
   failedAt,
 }: Pick<Reading<unknown>, "pending" | "confirmedAt" | "failedAt">) {
+  const { t } = useGuiLanguage();
   return (
     <>
       {failedAt ? (
         <p role="status">
-          暂时无法读取
-          {confirmedAt ? " · 数据已过期，以下为上次读取结果。" : "。"}
+          {t("healthReadFailed")}
+          {confirmedAt ? t("healthStale") : "。"}
         </p>
       ) : null}
       {pending ? (
         <p role="status">
-          {confirmedAt ? "正在重新读取，以下为上次读取结果…" : "正在读取状态…"}
+          {confirmedAt ? t("healthRereading") : t("healthReading")}
         </p>
       ) : null}
       {confirmedAt ? (
-        <ReadTime label="上次成功读取" value={confirmedAt} />
+        <ReadTime label={t("healthReadSuccessTime")} value={confirmedAt} />
+      ) : null}
+      {failedAt ? (
+        <ReadTime label={t("healthReadFailedTime")} value={failedAt} />
       ) : null}
-      {failedAt ? <ReadTime label="读取失败时间" value={failedAt} /> : null}
     </>
   );
 }
@@ -143,6 +148,8 @@ function ReadReceipt({
  * the table the originating screen already uses.
  */
 export function HealthPanel({ imports }: { imports: ImportState }) {
+  const { t, locale } = useGuiLanguage();
+  const n = (value: number) => value.toLocaleString(locale);
   const [detailedLogging, setDetailedLoggingState] = useState(false);
   const [detailedLoggingPending, setDetailedLoggingPending] = useState(false);
   const backgroundRead = useDiagnosticRead(readBackgroundHealth);
@@ -199,13 +206,13 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
 
   async function markIncident() {
     if (!window.oneMemory?.markDiagnosticIncident) {
-      setDiagnosticMessage("请在桌面 App 中记录问题时间点。");
+      setDiagnosticMessage(t("healthIncidentDesktop"));
       return;
     }
     setDiagnosticAction("incident");
     setDiagnosticMessage("");
     try {
-      const description = window.prompt("简单描述刚才遇到的问题（可不填）", "");
+      const description = window.prompt(t("healthIncidentPrompt"), "");
       if (description === null) {
         setDiagnosticAction(null);
         return;
@@ -213,9 +220,11 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
       const receipt =
         await window.oneMemory.markDiagnosticIncident(description);
       await window.oneMemory.copyText?.(receipt.incident_id);
-      setDiagnosticMessage(`问题编号已复制：${receipt.incident_id}`);
+      setDiagnosticMessage(
+        t("healthIncidentCopied", { id: receipt.incident_id }),
+      );
     } catch {
-      setDiagnosticMessage("问题时间点未能记录，请重试。");
+      setDiagnosticMessage(t("healthIncidentError"));
     } finally {
       setDiagnosticAction(null);
     }
@@ -223,13 +232,13 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
 
   async function exportDiagnostics() {
     if (!window.oneMemory?.exportDiagnostics) {
-      setDiagnosticMessage("请在桌面 App 中导出诊断信息。");
+      setDiagnosticMessage(t("diagnosticExportDesktop"));
       return;
     }
     setDiagnosticAction("export");
     setDiagnosticMessage("");
     try {
-      const result = await exportDiagnosticsFile();
+      const result = await exportDiagnosticsFile(locale);
       setDiagnosticMessage(result.message);
     } finally {
       setDiagnosticAction(null);
@@ -244,20 +253,23 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
   const sourceReceipt = (
     <>
       {imports.loading ? (
-        <p role="status">正在读取本地服务与来源状态…</p>
+        <p role="status">{t("healthReadingSources")}</p>
       ) : sourceUnavailable ? (
         <p role="status">
-          暂时无法读取
+          {t("healthReadFailed")}
           {sourceConfirmedAt || imports.health || imports.sources.length
-            ? " · 数据已过期，以下为上次读取结果。"
+            ? t("healthStale")
             : "。"}
         </p>
       ) : null}
       {sourceConfirmedAt ? (
-        <ReadTime label="上次成功读取" value={sourceConfirmedAt} />
+        <ReadTime
+          label={t("healthReadSuccessTime")}
+          value={sourceConfirmedAt}
+        />
       ) : null}
       {sourceUnavailable && sourceFailedAt ? (
-        <ReadTime label="读取失败时间" value={sourceFailedAt} />
+        <ReadTime label={t("healthReadFailedTime")} value={sourceFailedAt} />
       ) : null}
     </>
   );
@@ -274,7 +286,7 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
     <section className="view health-view" aria-labelledby="health-title">
       <header className="view-header">
         <div>
-          <h1 id="health-title">运行诊断</h1>
+          <h1 id="health-title">{t("healthTitle")}</h1>
         </div>
       </header>
 
@@ -285,26 +297,34 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
           onClick={() => void exportDiagnostics()}
         >
           <Download size={16} aria-hidden="true" />
-          导出日志（发给开发排查）
+          {t("nativeExportLogs")}
         </R6Button>
       </div>
 
-      <section className="health-block" aria-label="本地服务">
-        <h2>本地服务</h2>
+      <section className="health-block" aria-label={t("healthLocal")}>
+        <h2>{t("healthLocal")}</h2>
         {sourceReceipt}
         {imports.health ? (
           <p>
-            {`${sourceUnavailable || imports.loading ? "上次读取" : "运行中"} · 版本 ${imports.health.version} · 实例 ${imports.health.instance_id}`}
+            {t("healthCoreVersion", {
+              state: t(
+                sourceUnavailable || imports.loading
+                  ? "healthPrevious"
+                  : "healthRunning",
+              ),
+              version: imports.health.version,
+              instance: imports.health.instance_id,
+            })}
           </p>
         ) : !sourceUnavailable && !imports.loading ? (
-          <p>还没连上本地 Core。</p>
+          <p>{t("healthCoreDisconnected")}</p>
         ) : null}
       </section>
 
-      <section className="health-block" aria-label="后台服务">
-        <h2>后台服务</h2>
+      <section className="health-block" aria-label={t("healthBackground")}>
+        <h2>{t("healthBackground")}</h2>
         {backgroundRead.value === "no-bridge" ? (
-          <p>当前环境无法检查后台服务，请在支持此功能的桌面 App 中查看。</p>
+          <p>{t("healthBackgroundUnavailable")}</p>
         ) : (
           <>
             <ReadReceipt {...backgroundRead} />
@@ -312,13 +332,18 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
               <>
                 <p>
                   {backgroundRead.pending || backgroundRead.failedAt
-                    ? "上次读取："
+                    ? `${t("healthPrevious")}${locale === "zh-CN" ? "：" : ": "}`
                     : ""}
-                  {backgroundVerdict(backgroundRead.value.state)}
+                  {backgroundVerdict(backgroundRead.value.state, locale)}
                 </p>
                 <p>
-                  Core：{runtimeStateLabel(backgroundRead.value.core)} ·
-                  宿主桥接：{runtimeStateLabel(backgroundRead.value.broker)}
+                  {t("healthRuntime", {
+                    core: runtimeStateLabel(backgroundRead.value.core, locale),
+                    broker: runtimeStateLabel(
+                      backgroundRead.value.broker,
+                      locale,
+                    ),
+                  })}
                 </p>
               </>
             ) : null}
@@ -326,8 +351,8 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
         )}
       </section>
 
-      <section className="health-block" aria-label="各来源累计条数">
-        <h2>各来源累计条数</h2>
+      <section className="health-block" aria-label={t("healthSources")}>
+        <h2>{t("healthSources")}</h2>
         {sourceReceipt}
         {imports.sources.length ? (
           <dl>
@@ -335,41 +360,72 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
               <div key={source.source_id}>
                 <dt>{source.display_name}</dt>
                 <dd>
-                  {`${source.imported_conversations} 个会话 · ${source.imported_messages} 条消息`}
+                  {t("healthSourceCount", {
+                    conversations: n(source.imported_conversations),
+                    messages: n(source.imported_messages),
+                  })}
                 </dd>
               </div>
             ))}
           </dl>
         ) : !sourceUnavailable && !imports.loading ? (
-          <p>还没有已连接的来源。</p>
+          <p>{t("healthNoSources")}</p>
         ) : null}
       </section>
 
-      <section className="health-block" aria-label="记忆提炼">
-        <h2>记忆提炼</h2>
+      <section className="health-block" aria-label={t("healthProcessing")}>
+        <h2>{t("healthProcessing")}</h2>
         <ReadReceipt {...processingRead} />
         {processing ? (
           <>
             <p>
-              {`${processing.running} 处理中 · ${processing.pending} 排队 · ${processing.completed} 已完成 · ${processing.failed} 失败`}
+              {t("healthTaskCounts", {
+                running: n(processing.running),
+                pending: n(processing.pending),
+                completed: n(processing.completed),
+                failed: n(processing.failed),
+              })}
             </p>
             {processing.metrics ? (
-              <dl aria-label="导入与整理详情">
+              <dl aria-label={t("healthImportDetails")}>
                 <div>
-                  <dt>原文与完整对话轮次</dt>
-                  <dd>{`${processing.metrics.raw_evidence} 条原文 · ${processing.metrics.complete_turns} 个完整 turn`}</dd>
+                  <dt>{t("healthRawTurns")}</dt>
+                  <dd>
+                    {t("healthRawCounts", {
+                      raw: n(processing.metrics.raw_evidence),
+                      turns: n(processing.metrics.complete_turns),
+                    })}
+                  </dd>
                 </div>
                 <div>
-                  <dt>HY 整理</dt>
-                  <dd>{`${processing.metrics.hy_calls} 次调用 · ${processing.metrics.completed} 完成 · ${processing.metrics.unknown} 结果不确定 · ${processing.metrics.failed} 失败 · ${processing.metrics.cancelled} 取消`}</dd>
+                  <dt>{t("healthHy")}</dt>
+                  <dd>
+                    {t("healthHyCounts", {
+                      calls: n(processing.metrics.hy_calls),
+                      completed: n(processing.metrics.completed),
+                      unknown: n(processing.metrics.unknown),
+                      failed: n(processing.metrics.failed),
+                      cancelled: n(processing.metrics.cancelled),
+                    })}
+                  </dd>
                 </div>
                 <div>
-                  <dt>产出</dt>
-                  <dd>{`${processing.metrics.governed_memories} 条记忆`}</dd>
+                  <dt>{t("healthOutput")}</dt>
+                  <dd>
+                    {t("healthMemories", {
+                      count: n(processing.metrics.governed_memories),
+                    })}
+                  </dd>
                 </div>
                 <div>
-                  <dt>WorkBuddy 查记忆</dt>
-                  <dd>{`${processing.metrics.workbuddy.injected} 次注入 · ${processing.metrics.workbuddy.timed_out} 次超时 · ${processing.metrics.workbuddy.unavailable} 次不可用`}</dd>
+                  <dt>{t("healthWorkbuddy")}</dt>
+                  <dd>
+                    {t("healthWorkbuddyCounts", {
+                      injected: n(processing.metrics.workbuddy.injected),
+                      timedOut: n(processing.metrics.workbuddy.timed_out),
+                      unavailable: n(processing.metrics.workbuddy.unavailable),
+                    })}
+                  </dd>
                 </div>
               </dl>
             ) : null}
@@ -378,26 +434,39 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
                 {splitBlockedStages(processing.blocked_stages).named.map(
                   (block) => (
                     <li key={`${block.kind}:${block.reason}`}>
-                      {`${taskKindLabel(block.kind)}卡在 ${blockReasonLabel(block.reason)}（${block.count} 条）`}
+                      {t("healthBlocked", {
+                        kind: memoryText(locale, taskKindLabel(block.kind)),
+                        reason: memoryText(
+                          locale,
+                          blockReasonLabel(block.reason),
+                        ),
+                        count: n(block.count),
+                      })}
                     </li>
                   ),
                 )}
-                {retrying ? <li>{retryingBlockLabel(retrying)}</li> : null}
+                {retrying ? (
+                  <li>
+                    {locale === "zh-CN"
+                      ? retryingBlockLabel(retrying)
+                      : t("healthRetrying", { count: n(retrying) })}
+                  </li>
+                ) : null}
               </ul>
             ) : !processingRead.failedAt && !processingRead.pending ? (
-              <p>暂无需要处理的问题。</p>
+              <p>{t("healthNoIssues")}</p>
             ) : null}
           </>
         ) : null}
       </section>
 
-      <section className="health-block" aria-label="AI 接通情况">
-        <h2>AI 接通情况</h2>
+      <section className="health-block" aria-label={t("healthHosts")}>
+        <h2>{t("healthHosts")}</h2>
         {/* Host state lives in the desktop shell. In a browser it is not
             false, it is unavailable, and reporting it as 未接通 would send
             the user to repair links that may well be fine. */}
         {hosts === "no-bridge" || !window.oneMemory ? (
-          <p>在浏览器里读不到；请在桌面 App 里查看。</p>
+          <p>{t("healthHostsUnavailable")}</p>
         ) : (
           <>
             <ReadReceipt {...hostsRead} />
@@ -408,34 +477,34 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
                     <dt>{host.label}</dt>
                     <dd>
                       {hostsRead.failedAt || hostsRead.pending
-                        ? "上次读取："
+                        ? `${t("healthPrevious")}${locale === "zh-CN" ? "：" : ": "}`
                         : ""}
-                      {hostVerdict(host)}
+                      {hostVerdict(host, locale)}
                     </dd>
                   </div>
                 ))}
               </dl>
             ) : hosts && !hostsRead.failedAt && !hostsRead.pending ? (
-              <p>本机没有检测到可接入的 AI 工具。</p>
+              <p>{t("healthNoHosts")}</p>
             ) : null}
           </>
         )}
       </section>
-      <section className="health-block" aria-label="详细日志">
+      <section className="health-block" aria-label={t("healthDetailed")}>
         <div className="health-setting-row">
           <div>
-            <h2>详细日志（排查用）</h2>
-            <p>默认关闭。仅在开发人员请你协助排查时开启。</p>
+            <h2>{t("healthDetailedTitle")}</h2>
+            <p>{t("healthDetailedHint")}</p>
           </div>
           <R6Switch
-            label="详细日志（排查用）"
+            label={t("healthDetailedTitle")}
             checked={detailedLogging}
             pending={detailedLoggingPending}
             onCheckedChange={(enabled) => {
               setDetailedLoggingPending(true);
               void setDetailedLogging(enabled)
                 .then(setDetailedLoggingState)
-                .catch(() => setDiagnosticMessage("详细日志设置失败，请重试。"))
+                .catch(() => setDiagnosticMessage(t("healthDetailedError")))
                 .finally(() => setDetailedLoggingPending(false));
             }}
           />
@@ -448,7 +517,7 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
           onClick={() => void refresh()}
         >
           <RefreshCw size={16} aria-hidden="true" />
-          重新读取状态
+          {t("healthRefresh")}
         </R6Button>
         <R6Button
           variant="quiet"
@@ -456,7 +525,7 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
           onClick={() => void markIncident()}
         >
           <Flag size={16} aria-hidden="true" />
-          记录问题时间点
+          {t("healthIncident")}
         </R6Button>
       </div>
       {diagnosticMessage ? (
@@ -470,31 +539,59 @@ export function HealthPanel({ imports }: { imports: ImportState }) {
 
 /** A host with no self-check on record has not been shown to work, and the
  * install flow's own wording for that is 未接通. */
-function hostVerdict(host: RecallHostStatus): string {
-  if (!host.installed) return LINK_WORDING.unreachable;
-  const state = host.selfCheck?.state;
-  return (state ? LINK_WORDING[state] : undefined) ?? LINK_WORDING.unreachable;
+function hostVerdict(host: RecallHostStatus, locale: GuiLocale): string {
+  if (locale === "zh-CN") {
+    if (!host.installed) return LINK_WORDING.unreachable;
+    const state = host.selfCheck?.state;
+    return (
+      (state ? LINK_WORDING[state] : undefined) ?? LINK_WORDING.unreachable
+    );
+  }
+  return translate(
+    locale,
+    !host.installed
+      ? "healthUnreachable"
+      : host.selfCheck?.state === "wired"
+        ? "healthWired"
+        : host.selfCheck?.state === "reachable_but_blind"
+          ? "healthBlind"
+          : "healthUnreachable",
+  );
 }
 
-function backgroundVerdict(state: BackgroundSnapshot["state"]): string {
-  return {
-    healthy: "后台服务可用",
-    stopped: "后台服务已停止",
-    degraded: "后台服务部分不可用",
-    untrusted: "后台服务身份未通过核验",
-    unknown: "后台状态尚未确认",
-  }[state];
+function backgroundVerdict(
+  state: BackgroundSnapshot["state"],
+  locale: GuiLocale,
+): string {
+  return translate(
+    locale,
+    (
+      {
+        healthy: "healthBackgroundHealthy",
+        stopped: "healthBackgroundStopped",
+        degraded: "healthBackgroundDegraded",
+        untrusted: "healthBackgroundUntrusted",
+        unknown: "healthBackgroundUnknown",
+      } as const
+    )[state],
+  );
 }
 
 function runtimeStateLabel(
   state: BackgroundSnapshot["core"] | BackgroundSnapshot["broker"],
+  locale: GuiLocale,
 ): string {
-  return {
-    running: "运行中",
-    stopped: "已停止",
-    unhealthy: "无法连接",
-    untrusted: "身份未通过核验",
-    unknown: "尚未确认",
-    not_checked: "未检查",
-  }[state];
+  return translate(
+    locale,
+    (
+      {
+        running: "healthRunning",
+        stopped: "healthStopped",
+        unhealthy: "healthUnhealthy",
+        untrusted: "healthUntrusted",
+        unknown: "healthUnknown",
+        not_checked: "healthNotChecked",
+      } as const
+    )[state],
+  );
 }

memhub/apps/web/src/HomeCardBoundary.tsx

@@ -1,9 +1,14 @@
 import { Component, type ReactNode } from "react";
+import { useApplicationsLanguage } from "./applications-language";
 
-type Props = { label: string; children: ReactNode };
+type Props = { label: string; children: ReactNode; fallback?: ReactNode };
 type State = { crashed: boolean };
 
 const RESET_MS = 15_000;
+function CardFallback({ label }: { label: string }) {
+  const { a } = useApplicationsLanguage();
+  return <p>{a("cardUnavailable", { label })}</p>;
+}
 
 /**
  * 2026-10-12: 首页任何一张卡片渲染出错时，只塌这一张卡，不塌整页。
@@ -36,9 +41,7 @@ export class HomeCardBoundary extends Component<Props, State> {
     if (this.state.crashed) {
       return (
         <section className="r6-home-auto-failure" role="status">
-          <p>
-            {this.props.label}暂时显示不了，其他功能不受影响，稍后会自动恢复。
-          </p>
+          {this.props.fallback ?? <CardFallback label={this.props.label} />}
         </section>
       );
     }

memhub/apps/web/src/ImportProgressStrip.test.tsx

@@ -12,6 +12,7 @@ import userEvent from "@testing-library/user-event";
 import { useState } from "react";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
+import { LanguageProvider, useGuiLanguage } from "./gui-language";
 import { ImportProgressStrip } from "./ImportProgressStrip";
 
 function job(overrides: Partial<ImportJob> = {}): ImportJob {
@@ -84,6 +85,57 @@ function deferred() {
 describe("ImportProgressStrip", () => {
   afterEach(cleanup);
 
+  it("translates user-facing progress and live settings CTA without invoking actions", async () => {
+    localStorage.setItem("one-memory.gui-language", "es");
+    const open = vi.fn();
+    function Switch() {
+      const { setPreference } = useGuiLanguage();
+      return (
+        <button type="button" onClick={() => void setPreference("zh-CN")}>
+          Cambiar idioma
+        </button>
+      );
+    }
+    const view = render(
+      <LanguageProvider>
+        <Switch />
+        <ImportProgressStrip
+          userFacing
+          jobs={[job()]}
+          sources={[
+            source("cursor", "Cursor", { imported_conversations: 12345 }),
+          ]}
+          backfilling={false}
+          onOpenSources={open}
+        />
+      </LanguageProvider>,
+    );
+    expect((await screen.findByRole("status")).textContent).toContain(
+      "12.345 conversaciones",
+    );
+    view.rerender(
+      <LanguageProvider>
+        <Switch />
+        <ImportProgressStrip
+          userFacing
+          jobs={[job({ status: "failed" })]}
+          sources={sources}
+          backfilling={false}
+          onOpenSources={open}
+          onConfigureModel={open}
+        />
+      </LanguageProvider>,
+    );
+    await screen.findByRole("button", { name: "Ir a configuración" });
+    expect(open).not.toHaveBeenCalled();
+    await userEvent.click(
+      screen.getByRole("button", { name: "Cambiar idioma" }),
+    );
+    await screen.findByRole("button", { name: "去设置" });
+    expect(open).not.toHaveBeenCalled();
+    localStorage.clear();
+  });
+
   it("keeps daily sync silent in the user-facing shell", () => {
     const { container } = render(
       <ImportProgressStrip

memhub/apps/web/src/ImportProgressStrip.tsx

@@ -5,6 +5,7 @@ import type {
 } from "@one-memory/contracts";
 import { LoaderCircle, Pause, Play, RefreshCw, Settings2 } from "lucide-react";
 import { useEffect, useRef, useState } from "react";
+import { useGuiLanguage } from "./gui-language";
 import {
   type MemoryArrival,
   memoryArrivalTitle,
@@ -85,6 +86,7 @@ export function ImportProgressStrip({
   showProgressDetails = true,
   userFacing = false,
 }: ImportProgressStripProps) {
+  const { t, locale } = useGuiLanguage();
   const [refreshing, setRefreshing] = useState(false);
   const [refreshError, setRefreshError] = useState<{
     epoch: number;
@@ -252,10 +254,10 @@ export function ImportProgressStrip({
       0,
     );
     const message = firstImport
-      ? `正在导入你的历史对话，已导入 ${imported.toLocaleString("zh-CN")} 个会话。记忆会陆续生成，你可以先正常使用。`
+      ? t("importUserProgress", { count: imported.toLocaleString(locale) })
       : currentArrival?.phase === "model-required"
-        ? "模型还没有配置好，新的对话暂时不会整理成记忆。"
-        : "有些内容没有处理完成，请前往设置查看。";
+        ? t("importUserModel")
+        : t("importUserIncomplete");
     return (
       <div
         className="import-strip"
@@ -277,7 +279,7 @@ export function ImportProgressStrip({
               onClick={onConfigureModel}
             >
               <Settings2 size={15} aria-hidden="true" />
-              去设置
+              {t("importUserSettings")}
             </button>
           )}
         </div>

memhub/apps/web/src/LanguageSelector.test.tsx

@@ -0,0 +1,95 @@
+// @vitest-environment jsdom
+
+import { translate } from "@one-memory/contracts/gui-i18n";
+import { cleanup, render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { afterEach, expect, it, vi } from "vitest";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
+import { LanguageSelector } from "./LanguageSelector";
+
+afterEach(() => {
+  cleanup();
+  localStorage.clear();
+  vi.restoreAllMocks();
+});
+
+it.each(["zh-CN", "es"] as const)(
+  "hides the compact label while preserving its accessible name in %s",
+  (locale) => {
+    localStorage.setItem(LANGUAGE_STORAGE_KEY, locale);
+    render(
+      <LanguageProvider>
+        <LanguageSelector compact />
+      </LanguageProvider>,
+    );
+    const name = translate(locale, "languageTitle");
+    const selector = screen.getByRole("combobox", { name });
+    const label = screen.getByText(name) as HTMLLabelElement;
+    expect(label.hidden).toBe(true);
+    expect(label.htmlFor).toBe(selector.id);
+    expect(screen.getByRole("region", { name })).toBeTruthy();
+    expect(screen.getByRole("option", { name: "Español" })).toBeTruthy();
+    expect(screen.getByRole("option", { name: "简体中文" })).toBeTruthy();
+  },
+);
+
+it.each(["zh-CN", "es"] as const)(
+  "keeps the normal settings label visible and accessible in %s",
+  (locale) => {
+    localStorage.setItem(LANGUAGE_STORAGE_KEY, locale);
+    render(
+      <LanguageProvider>
+        <LanguageSelector />
+      </LanguageProvider>,
+    );
+    const name = translate(locale, "languageLabel");
+    const selector = screen.getByRole("combobox", { name });
+    const label = screen.getByText(name) as HTMLLabelElement;
+    expect(label.hidden).toBe(false);
+    expect(label.htmlFor).toBe(selector.id);
+    expect(selector.getAttribute("aria-label")).toBeNull();
+    expect(
+      screen.getByRole("heading", { name: translate(locale, "languageTitle") }),
+    ).toBeTruthy();
+    expect(
+      screen.getByText(translate(locale, "languageDescription")),
+    ).toBeTruthy();
+  },
+);
+
+it("offers an accessible selector, persists and updates its label", async () => {
+  render(
+    <LanguageProvider>
+      <LanguageSelector />
+    </LanguageProvider>,
+  );
+  const selector = screen.getByRole("combobox", {
+    name: translate("zh-CN", "languageLabel"),
+  });
+  expect(screen.getAllByRole("option")).toHaveLength(3);
+  expect(selector.getAttribute("aria-describedby")).toBeTruthy();
+  await userEvent.selectOptions(selector, "es");
+  expect(localStorage.getItem(LANGUAGE_STORAGE_KEY)).toBe("es");
+  expect(
+    screen.getByRole("combobox", { name: translate("es", "languageLabel") }),
+  ).toBe(selector);
+  expect(document.documentElement.lang).toBe("es");
+});
+
+it("announces storage errors without replacing the confirmed choice", async () => {
+  render(
+    <LanguageProvider>
+      <LanguageSelector />
+    </LanguageProvider>,
+  );
+  vi.spyOn(Storage.prototype, "setItem").mockImplementation(() => {
+    throw new Error("denied");
+  });
+  await userEvent.selectOptions(screen.getByRole("combobox"), "es");
+  expect(screen.getByRole("alert").textContent).toBe(
+    translate("zh-CN", "languageSaveError"),
+  );
+  expect((screen.getByRole("combobox") as HTMLSelectElement).value).toBe(
+    "system",
+  );
+});

memhub/apps/web/src/LanguageSelector.tsx

@@ -0,0 +1,55 @@
+import { isLanguagePreference } from "@one-memory/contracts/gui-i18n";
+import { useId, useState } from "react";
+import { useGuiLanguage } from "./gui-language";
+
+export function LanguageSelector({ compact = false }: { compact?: boolean }) {
+  const id = useId();
+  const { preference, setPreference, t, error } = useGuiLanguage();
+  const [pending, setPending] = useState(false);
+  return (
+    <section
+      aria-labelledby={compact ? `${id}-label` : `${id}-title`}
+      className={
+        compact ? "r6-language-selector--compact" : "r6-language-setting"
+      }
+    >
+      {!compact && <h2 id={`${id}-title`}>{t("languageTitle")}</h2>}
+      <div className={compact ? "r6-language-selector-row" : "r6-setting-row"}>
+        <label id={`${id}-label`} htmlFor={`${id}-select`} hidden={compact}>
+          {t(compact ? "languageTitle" : "languageLabel")}
+        </label>
+        <select
+          id={`${id}-select`}
+          aria-label={compact ? t("languageTitle") : undefined}
+          aria-describedby={compact ? undefined : `${id}-description`}
+          value={preference}
+          disabled={pending}
+          onChange={async (event) => {
+            const value = event.currentTarget.value;
+            if (!isLanguagePreference(value)) return;
+            setPending(true);
+            try {
+              await setPreference(value);
+            } finally {
+              setPending(false);
+            }
+          }}
+        >
+          <option value="system">{t("languageSystem")}</option>
+          <option value="zh-CN" lang={compact ? "zh-CN" : undefined}>
+            {compact ? "简体中文" : t("languageChinese")}
+          </option>
+          <option value="es" lang={compact ? "es" : undefined}>
+            {compact ? "Español" : t("languageSpanish")}
+          </option>
+        </select>
+      </div>
+      {!compact && <p id={`${id}-description`}>{t("languageDescription")}</p>}
+      {error && (
+        <p role="alert" className="r6-settings-error">
+          {t(error)}
+        </p>
+      )}
+    </section>
+  );
+}

memhub/apps/web/src/MemoryEvidencePanel.tsx

@@ -5,6 +5,7 @@ import {
   useRef,
   useState,
 } from "react";
+import { useMemoryLanguage } from "./memory-language";
 import { useMediaPreference } from "./use-media-preference";
 
 type Phase = "closed" | "opening" | "open" | "closing";
@@ -20,6 +21,7 @@ export function MemoryEvidencePanel({
   children: ReactNode;
   suspended?: boolean;
 }) {
+  const { locale } = useMemoryLanguage();
   const compact = useMediaPreference("(max-width: 1100px)");
   const reduceMotion = useMediaPreference("(prefers-reduced-motion: reduce)");
   const reduceTransparency = useMediaPreference(
@@ -135,7 +137,7 @@ export function MemoryEvidencePanel({
       className="map-inspector"
       {...(modal ? { role: "dialog", "aria-modal": !suspended } : {})}
       inert={suspended}
-      aria-label="记忆与原文"
+      aria-label={locale === "es" ? "Memoria y texto original" : "记忆与原文"}
       data-tour-id="memory-original-pane"
       tabIndex={-1}
       hidden={!present || (compact && suspended)}

memhub/apps/web/src/MemoryGraph3D.tsx

@@ -11,6 +11,7 @@ import {
   subscribeDisplayPreference,
 } from "./display-preferences";
 import { graphEase } from "./graph-motion";
+import { useMemoryLanguage } from "./memory-language";
 
 /** 力导向迭代总步数。原实现在挂载时一次算完，现改为分帧推进。 */
 const LAYOUT_ITERATIONS = 90;
@@ -35,6 +36,7 @@ export function MemoryGraph3D({
   selectedNodeId: string | null;
   onSelectNode(node: MemoryGraphNode): void;
 }) {
+  const { text } = useMemoryLanguage();
   const host = useRef<HTMLDivElement>(null);
   const labelHost = useRef<HTMLDivElement>(null);
   const selectRef = useRef(onSelectNode);
@@ -626,7 +628,7 @@ export function MemoryGraph3D({
       <div className="graph-labels" ref={labelHost} aria-hidden="true" />
       {!available ? (
         <div className="memory-graph-fallback">
-          <p>这台设备打不开 3D 视图，已显示关联列表。</p>
+          <p>{text("这台设备打不开 3D 视图，已显示关联列表。")}</p>
           {graph.nodes.map((node) => (
             <button
               type="button"
@@ -644,13 +646,13 @@ export function MemoryGraph3D({
         <div
           className="memory-graph-controls"
           role="toolbar"
-          aria-label="图谱工具"
+          aria-label={text("图谱工具")}
         >
           <button
             type="button"
             className="secondary"
-            title="放大"
-            aria-label="放大图谱"
+            title={text("放大")}
+            aria-label={text("放大图谱")}
             onClick={() => actionsRef.current?.zoom(0.8)}
           >
             <Plus size={16} />
@@ -658,8 +660,8 @@ export function MemoryGraph3D({
           <button
             type="button"
             className="secondary"
-            title="缩小"
-            aria-label="缩小图谱"
+            title={text("缩小")}
+            aria-label={text("缩小图谱")}
             onClick={() => actionsRef.current?.zoom(1.25)}
           >
             <Minus size={16} />
@@ -667,8 +669,8 @@ export function MemoryGraph3D({
           <button
             type="button"
             className="secondary"
-            title="重置视角"
-            aria-label="重置图谱视角"
+            title={text("重置视角")}
+            aria-label={text("重置图谱视角")}
             onClick={() => actionsRef.current?.reset()}
           >
             <Focus size={16} />

memhub/apps/web/src/MemoryMap.tsx

@@ -5,6 +5,7 @@ import type {
   MemoryLibraryPage,
   RecentConversationItem,
 } from "@one-memory/contracts";
+import type { GuiLocale } from "@one-memory/contracts/gui-i18n";
 import {
   ArrowUp,
   ChevronLeft,
@@ -29,6 +30,7 @@ import {
   type MemoryArrival,
   resolveMemoryArrival,
 } from "./memory-arrival-state";
+import { useMemoryLanguage } from "./memory-language";
 import {
   type MapAxis,
   mapGroups,
@@ -96,8 +98,12 @@ function authorLabel(writtenBy: string) {
   return "未知";
 }
 
-function dayStamp(value: string | null | undefined) {
-  if (!value || !Number.isFinite(Date.parse(value))) return "时间未知";
+function dayStamp(
+  value: string | null | undefined,
+  locale: GuiLocale = "zh-CN",
+) {
+  if (!value || !Number.isFinite(Date.parse(value)))
+    return locale === "es" ? "Hora desconocida" : "时间未知";
   const date = new Date(value);
   const now = new Date();
   if (
@@ -105,8 +111,8 @@ function dayStamp(value: string | null | undefined) {
     date.getMonth() === now.getMonth() &&
     date.getDate() === now.getDate()
   )
-    return "今天";
-  return date.toLocaleDateString("zh-CN");
+    return locale === "es" ? "Hoy" : "今天";
+  return date.toLocaleDateString(locale);
 }
 
 /**
@@ -117,9 +123,17 @@ function dayStamp(value: string | null | undefined) {
 export const DIALOGUE_PANE_VISIBLE = false;
 
 /** "10月2日", with the year only when it is not this year. */
-function monthDay(value: string): string | null {
+function monthDay(value: string, locale: GuiLocale): string | null {
   if (!Number.isFinite(Date.parse(value))) return null;
   const date = new Date(value);
+  if (locale === "es")
+    return new Intl.DateTimeFormat(locale, {
+      day: "numeric",
+      month: "short",
+      ...(date.getFullYear() !== new Date().getFullYear()
+        ? { year: "numeric" }
+        : {}),
+    }).format(date);
   const day = `${date.getMonth() + 1}月${date.getDate()}日`;
   return date.getFullYear() === new Date().getFullYear()
     ? day
@@ -130,14 +144,20 @@ function monthDay(value: string): string | null {
 function sourceStamp(
   time: { at: string; basis: "conversation" | "import" } | undefined,
   fallback: string | null | undefined,
+  locale: GuiLocale = "zh-CN",
 ): string {
-  const day = time ? monthDay(time.at) : null;
+  const day = time ? monthDay(time.at, locale) : null;
   if (time && day)
-    return time.basis === "conversation" ? `对话于 ${day}` : `导入于 ${day}`;
-  return dayStamp(fallback);
+    return locale === "es"
+      ? `${time.basis === "conversation" ? "Conversación del" : "Importada el"} ${day}`
+      : time.basis === "conversation"
+        ? `对话于 ${day}`
+        : `导入于 ${day}`;
+  return dayStamp(fallback, locale);
 }
 
 export function MemoryMap(props: Props) {
+  const { locale, text, count } = useMemoryLanguage();
   const {
     memories,
     graph: baseGraph,
@@ -322,14 +342,16 @@ export function MemoryMap(props: Props) {
     if (library) {
       const ids = library.page?.source_ids_by_memory?.[memoryId];
       return ids?.length
-        ? ids.map((id) => sourceNameOr(sources, id, "来源待核对")).join("、")
-        : "来源待核对";
+        ? ids
+            .map((id) => sourceNameOr(sources, id, text("来源待核对")))
+            .join("、")
+        : text("来源待核对");
     }
     return (
       sourceGroups
         .filter((entry) => entry.memoryIds.includes(memoryId))
         .map((entry) => entry.label)
-        .join("、") || "来源待核对"
+        .join(locale === "es" ? ", " : "、") || text("来源待核对")
     );
   }
   const filtered = useMemo(
@@ -594,7 +616,7 @@ export function MemoryMap(props: Props) {
       (source) =>
         source.authorized && groupKey === `source:${source.source_id}`,
     )?.display_name ??
-    "全部记忆";
+    text("全部记忆");
   if (
     props.simplified &&
     (!library ||
@@ -614,28 +636,43 @@ export function MemoryMap(props: Props) {
         <div>
           <h2>
             {running
-              ? "已开始处理所选对话"
+              ? locale === "es"
+                ? "Procesamiento de conversaciones iniciado"
+                : "已开始处理所选对话"
               : queued
-                ? "处理请求已受理"
-                : "还没有已生成的记忆"}
+                ? locale === "es"
+                  ? "Solicitud de procesamiento aceptada"
+                  : "处理请求已受理"
+                : text("还没有已生成的记忆")}
           </h2>
           <p>
             {running || queued
-              ? "模型连接已通过。首批记忆生成后，会逐步出现在记忆列表里。"
+              ? locale === "es"
+                ? "Modelo conectado. Las primeras memorias aparecerán progresivamente en la lista."
+                : "模型连接已通过。首批记忆生成后，会逐步出现在记忆列表里。"
               : arrival.importedConversations > 0
-                ? `已导入 ${arrival.importedConversations.toLocaleString()} 段对话，整理成记忆后会出现在这里。`
+                ? locale === "es"
+                  ? `${count(arrival.importedConversations)} conversaciones importadas. Las memorias aparecerán al procesarlas.`
+                  : `已导入 ${arrival.importedConversations.toLocaleString()} 段对话，整理成记忆后会出现在这里。`
                 : arrival.importedMessages > 0
-                  ? "历史已保存在本机，记忆就绪后会出现在这里。"
-                  : "连接应用并导入历史后，可以开始沉淀记忆。"}
+                  ? locale === "es"
+                    ? "El historial está guardado en este equipo. Las memorias aparecerán cuando estén listas."
+                    : "历史已保存在本机，记忆就绪后会出现在这里。"
+                  : locale === "es"
+                    ? "Conecta aplicaciones e importa el historial para empezar a generar memorias."
+                    : "连接应用并导入历史后，可以开始沉淀记忆。"}
             {(running || queued) && (
               <small>
-                当前已生成 0
-                条记忆。请求已受理不等于已经完成，原始对话、模型处理任务和记忆数量分别统计。
+                {locale === "es"
+                  ? "Aún hay 0 memorias generadas. Una solicitud aceptada no implica que haya finalizado. Las conversaciones, las tareas y las memorias se cuentan por separado."
+                  : "当前已生成 0 条记忆。请求已受理不等于已经完成，原始对话、模型处理任务和记忆数量分别统计。"}
               </small>
             )}
           </p>
           <div>
-            <R6Button onClick={props.onConnect}>返回应用</R6Button>
+            <R6Button onClick={props.onConnect}>
+              {locale === "es" ? "Volver a aplicaciones" : "返回应用"}
+            </R6Button>
           </div>
         </div>
         {running && (
@@ -648,7 +685,7 @@ export function MemoryMap(props: Props) {
     <section
       id={id}
       className="core-memory-map"
-      aria-label="记忆工作台"
+      aria-label={text("记忆工作台")}
       hidden={hidden}
       inert={hidden}
       onKeyDown={(e) => {
@@ -663,7 +700,7 @@ export function MemoryMap(props: Props) {
         clear();
       }}
     >
-      <nav className="map-library" aria-label="来源与主题" ref={pane}>
+      <nav className="map-library" aria-label={text("来源与主题")} ref={pane}>
         {props.simplified && DIALOGUE_PANE_VISIBLE ? (
           <div
             className="map-library-pane"
@@ -712,13 +749,13 @@ export function MemoryMap(props: Props) {
         ) : null}
         {props.simplified ? (
           <div className="selected-source-filter">
-            <label htmlFor="selected-source-filter">来源</label>
+            <label htmlFor="selected-source-filter">{text("来源")}</label>
             <OptionMenu
               id="selected-source-filter"
               className="om-option-menu--plain"
               value={controlledSource}
               options={[
-                { value: "", label: "全部应用" },
+                { value: "", label: text("全部应用") },
                 ...(library?.source &&
                 !sources.some(
                   (source) =>
@@ -727,7 +764,7 @@ export function MemoryMap(props: Props) {
                   ? [
                       {
                         value: `source:${library.source}`,
-                        label: "所选来源待核对",
+                        label: text("所选来源待核对"),
                       },
                     ]
                   : []),
@@ -772,15 +809,15 @@ export function MemoryMap(props: Props) {
         <div className="map-search">
           <Search size={16} aria-hidden="true" />
           <input
-            aria-label="筛选地图记忆"
+            aria-label={text("筛选地图记忆")}
             name="map-memory-search"
             autoComplete="off"
             placeholder={
               libraryPane === "dialogues"
-                ? "搜索原始对话"
+                ? text("搜索原始对话")
                 : props.simplified
-                  ? "搜索记忆"
-                  : "筛选记忆…"
+                  ? text("搜索记忆")
+                  : text("筛选记忆…")
             }
             value={
               libraryPane === "dialogues"
@@ -815,22 +852,26 @@ export function MemoryMap(props: Props) {
             <span>
               {library.stale
                 ? library.page && library.page.total > 0
-                  ? `共 ${library.page.total} 条 · 正在核对来源…`
-                  : "正在核对来源…"
+                  ? locale === "es"
+                    ? `${count(library.page.total)} ${library.page.total === 1 ? "memoria" : "memorias"} · Verificando orígenes…`
+                    : `共 ${library.page.total} 条 · 正在核对来源…`
+                  : text("正在核对来源…")
                 : library.failed
-                  ? "读取失败"
+                  ? text("读取失败")
                   : library.loading && library.page?.total === 0
-                    ? "正在读取…"
+                    ? text("正在读取…")
                     : library.page
-                      ? `共 ${library.page.total} 条${refreshing ? " · 正在核对…" : ""}`
-                      : "正在读取…"}
+                      ? locale === "es"
+                        ? `${count(library.page.total)} ${library.page.total === 1 ? "memoria" : "memorias"}${refreshing ? " · Verificando…" : ""}`
+                        : `共 ${library.page.total} 条${refreshing ? " · 正在核对…" : ""}`
+                      : text("正在读取…")}
             </span>
             {!library.stale && (
               <button
                 type="button"
                 className="quiet map-tool"
-                aria-label="刷新地图记忆"
-                title="刷新地图记忆"
+                aria-label={text("刷新地图记忆")}
+                title={text("刷新地图记忆")}
                 disabled={library.loading || hidden}
                 onClick={library.onRetry}
               >
@@ -872,11 +913,15 @@ export function MemoryMap(props: Props) {
         )}
         {arrivalCount > 0 && (
           <div className="map-arrival-notice">
-            <span role="status">新增 {arrivalCount} 条记忆</span>
+            <span role="status">
+              {locale === "es"
+                ? `${count(arrivalCount)} memorias nuevas`
+                : `新增 ${arrivalCount} 条记忆`}
+            </span>
             <button
               type="button"
-              title="关闭新增记忆提示"
-              aria-label="关闭新增记忆提示"
+              title={text("关闭新增记忆提示")}
+              aria-label={text("关闭新增记忆提示")}
               onClick={() => setArrivedIds([])}
             >
               <X size={15} aria-hidden="true" />
@@ -885,7 +930,7 @@ export function MemoryMap(props: Props) {
         )}
         {filterNotice && (
           <p className="map-filter-notice" role="status">
-            {filterNotice}
+            {text(filterNotice)}
           </p>
         )}
         {libraryPane === "dialogues" ? (
@@ -937,7 +982,7 @@ export function MemoryMap(props: Props) {
         ) : null}
         <ul
           className="map-memory-list"
-          aria-label="地图记忆列表"
+          aria-label={text("地图记忆列表")}
           id="memory-pane-memories"
           hidden={libraryPane === "dialogues"}
         >
@@ -957,11 +1002,13 @@ export function MemoryMap(props: Props) {
                       {`${sourceLabel(m.memory_id)} · ${sourceStamp(
                         library?.page?.source_time_by_memory?.[m.memory_id],
                         m.updated_at,
+                        locale,
                       )}`}
                       {/* D99: the conversation date alone would hide that this
                           one was made today, so the generated day stays too. */}
                       <span className="map-memory-made">
-                        沉淀于 {dayStamp(m.updated_at)}
+                        {locale === "es" ? "Guardada: " : "沉淀于 "}
+                        {dayStamp(m.updated_at, locale)}
                       </span>
                     </>
                   ) : (
@@ -974,8 +1021,10 @@ export function MemoryMap(props: Props) {
         </ul>
         {libraryPane === "memories" && library?.failed && (
           <div role="alert">
-            <p>记忆读取失败，请重试。</p>
-            <R6Button onClick={library.onRetry}>重新读取地图记忆</R6Button>
+            <p>{text("记忆读取失败，请重试。")}</p>
+            <R6Button onClick={library.onRetry}>
+              {text("重新读取地图记忆")}
+            </R6Button>
           </div>
         )}
         {libraryPane === "memories" &&
@@ -986,10 +1035,10 @@ export function MemoryMap(props: Props) {
           !filtered.length && (
             <p className="map-empty">
               {library.query || library.source
-                ? "没有匹配的记忆"
+                ? text("没有匹配的记忆")
                 : groupKey
-                  ? "本页没有匹配的主题记忆"
-                  : "还没有已生成的记忆"}
+                  ? text("本页没有匹配的主题记忆")
+                  : text("还没有已生成的记忆")}
             </p>
           )}
         {libraryPane === "memories" &&
@@ -997,12 +1046,12 @@ export function MemoryMap(props: Props) {
           !library.loading &&
           !library.failed &&
           !library.stale && (
-            <nav aria-label="地图记忆分页" className="map-list-heading">
+            <nav aria-label={text("地图记忆分页")} className="map-list-heading">
               <button
                 type="button"
                 className="quiet map-tool"
-                aria-label="上一页记忆"
-                title="上一页记忆"
+                aria-label={text("上一页记忆")}
+                title={text("上一页记忆")}
                 disabled={library.page.offset === 0}
                 onClick={() => {
                   clear();
@@ -1014,18 +1063,21 @@ export function MemoryMap(props: Props) {
                 <ChevronLeft size={16} aria-hidden="true" />
               </button>
               <span>
-                共 {library.page.total.toLocaleString()} 条，第{" "}
+                {locale === "es"
+                  ? `${count(library.page.total)} ${library.page.total === 1 ? "memoria" : "memorias"} · Página `
+                  : `共 ${count(library.page.total)} 条，第 `}
                 {library.page.total === 0
                   ? 0
-                  : Math.floor(library.page.offset / library.page.limit) +
-                    1}{" "}
-                / {Math.ceil(library.page.total / library.page.limit)} 页
+                  : Math.floor(library.page.offset / library.page.limit) + 1}
+                {" / "}
+                {Math.ceil(library.page.total / library.page.limit)}
+                {locale === "es" ? "" : " 页"}
               </span>
               <button
                 type="button"
                 className="quiet map-tool"
-                aria-label="下一页记忆"
-                title="下一页记忆"
+                aria-label={text("下一页记忆")}
+                title={text("下一页记忆")}
                 disabled={
                   library.page.offset + library.page.items.length >=
                   library.page.total
@@ -1056,7 +1108,7 @@ export function MemoryMap(props: Props) {
           />
         )}
       </nav>
-      <section className="map-stage" aria-label="记忆关系图">
+      <section className="map-stage" aria-label={text("记忆关系图")}>
         <header className="map-stage-heading">
           <div>
             <span className="map-kicker" hidden={props.simplified}>
@@ -1064,18 +1116,18 @@ export function MemoryMap(props: Props) {
             </span>
             <h2>
               {libraryPane === "dialogues"
-                ? "原始对话"
+                ? text("原始对话")
                 : props.simplified
-                  ? "记忆关联"
+                  ? text("记忆关联")
                   : label}
             </h2>
             {props.simplified && (
               <p className="selected-graph-subtitle">
                 {libraryPane === "dialogues"
-                  ? "刚导入的原话，还不是沉淀后的记忆"
+                  ? text("刚导入的原话，还不是沉淀后的记忆")
                   : projection.nodes.length
-                    ? "来源归属"
-                    : "可在沉淀记忆后查看视图"}
+                    ? text("来源归属")
+                    : text("可在沉淀记忆后查看视图")}
               </p>
             )}
           </div>
@@ -1083,10 +1135,10 @@ export function MemoryMap(props: Props) {
             <button
               type="button"
               className="quiet map-tool"
-              aria-label={
-                selectedSource ? "查看选中来源原文" : "查看选中记忆原文"
-              }
-              title="查看原文"
+              aria-label={text(
+                selectedSource ? "查看选中来源原文" : "查看选中记忆原文",
+              )}
+              title={text("查看原文")}
               onClick={() => setInspectorOpen(true)}
             >
               <FileText size={17} />
@@ -1139,19 +1191,19 @@ export function MemoryMap(props: Props) {
               <Network size={32} strokeWidth={1} />
               <p>
                 {library?.stale
-                  ? "可在沉淀记忆后查看视图"
+                  ? text("可在沉淀记忆后查看视图")
                   : library?.failed
-                    ? "记忆暂时无法读取"
+                    ? text("记忆暂时无法读取")
                     : library?.page &&
                         (library.query || library.source || groupKey)
-                      ? "当前筛选没有可显示的记忆"
+                      ? text("当前筛选没有可显示的记忆")
                       : !loaded
-                        ? "正在读取记忆…"
+                        ? text("正在读取记忆…")
                         : active.length
-                          ? "当前筛选没有可显示的记忆"
+                          ? text("当前筛选没有可显示的记忆")
                           : arrival.importedMessages > 0
-                            ? "已保存的对话还未生成记忆"
-                            : "还没有可显示的记忆"}
+                            ? text("已保存的对话还未生成记忆")
+                            : text("还没有可显示的记忆")}
               </p>
             </div>
           )}
@@ -1169,7 +1221,7 @@ export function MemoryMap(props: Props) {
           )}
           {props.simplified ? (
             projection.nodes.length ? (
-              <span>连线表示来源归属</span>
+              <span>{text("连线表示来源归属")}</span>
             ) : null
           ) : (
             <span>{filtered.length} 条记忆 · 当前已加载</span>
@@ -1248,19 +1300,19 @@ export function MemoryMap(props: Props) {
         <header className="map-inspector-heading">
           <h2>
             {inspectorDetail
-              ? "记忆详情"
+              ? text("记忆详情")
               : selectedSource
-                ? "来源原文"
+                ? text("来源原文")
                 : visibleGroupNode
-                  ? "关联节点"
-                  : "记忆详情"}
+                  ? text("关联节点")
+                  : text("记忆详情")}
           </h2>
           {(activeId || visibleGroupNode) && (
             <button
               type="button"
               className="quiet map-tool"
-              aria-label="关闭记忆详情"
-              title="关闭详情"
+              aria-label={text("关闭记忆详情")}
+              title={text("关闭详情")}
               onClick={closeInspector}
             >
               <X size={17} />
@@ -1311,7 +1363,7 @@ export function MemoryMap(props: Props) {
                   <i />
                   <i />
                 </div>
-                <p role="status">正在读取这条记忆…</p>
+                <p role="status">{text("正在读取这条记忆…")}</p>
               </div>
             ) : (
               <SelectedMemoryDetail
@@ -1370,13 +1422,15 @@ export function MemoryMap(props: Props) {
             {props.detailLoad?.memoryId === activeId &&
             props.detailLoad.status === "failed" ? (
               <>
-                <p role="alert">这条记忆的原文暂时无法读取，选择已保留。</p>
+                <p role="alert">
+                  {text("这条记忆的原文暂时无法读取，选择已保留。")}
+                </p>
                 <button
                   type="button"
                   className="secondary"
                   onClick={() => activeId && onOpenMemory(activeId)}
                 >
-                  重试读取原文
+                  {text("重试读取原文")}
                 </button>
               </>
             ) : props.simplified && !activeId && filtered.length ? (
@@ -1386,15 +1440,24 @@ export function MemoryMap(props: Props) {
               // single-column surface needs it — the three-column one already
               // lists the same memories in the pane beside this one.
               <>
-                <p>{`已沉淀 ${filtered.length} 条记忆`}</p>
-                <ul className="map-settled-list" aria-label="已沉淀的记忆">
+                <p>
+                  {locale === "es"
+                    ? `${count(filtered.length)} memorias guardadas`
+                    : `已沉淀 ${filtered.length} 条记忆`}
+                </p>
+                <ul
+                  className="map-settled-list"
+                  aria-label={text("已沉淀的记忆")}
+                >
                   {filtered.map((m) => (
                     <li key={m.memory_id}>{m.content}</li>
                   ))}
                 </ul>
               </>
             ) : (
-              <p>{activeId ? "正在读取记忆详情…" : "沉淀记忆后查看详情"}</p>
+              <p>
+                {text(activeId ? "正在读取记忆详情…" : "沉淀记忆后查看详情")}
+              </p>
             )}
           </div>
         )}

memhub/apps/web/src/MemoryNoteComposer.test.tsx

@@ -3,8 +3,40 @@ import type { MemoryNoteReceipt } from "@one-memory/contracts";
 import { cleanup, render, screen, waitFor } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { afterEach, beforeEach, expect, it, vi } from "vitest";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
 import { MemoryNoteComposer } from "./MemoryNoteComposer";
 
+it("opens a Spanish composer without saving, processing or enabling anything", async () => {
+  delete window.oneMemory;
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  render(
+    <LanguageProvider>
+      <MemoryNoteComposer
+        onSaved={vi.fn()}
+        onOpenMemory={vi.fn()}
+        onConfigureModel={vi.fn()}
+      />
+    </LanguageProvider>,
+  );
+  await userEvent.click(
+    await screen.findByRole("button", { name: "Añadir memoria" }),
+  );
+  expect(screen.getByRole("dialog", { name: "Añadir memoria" })).toBeTruthy();
+  expect(
+    screen.getByRole("textbox", { name: "¿Qué quieres recordar?" }),
+  ).toBeTruthy();
+  expect(
+    (screen.getByRole("button", { name: "Guardar texto" }) as HTMLButtonElement)
+      .disabled,
+  ).toBe(true);
+  await userEvent.click(
+    screen.getByRole("button", { name: "Cerrar nueva memoria" }),
+  );
+  expect(api.saveMemoryNote).not.toHaveBeenCalled();
+  expect(api.processMemoryNote).not.toHaveBeenCalled();
+  localStorage.clear();
+});
+
 const api = vi.hoisted(() => ({
   getMemoryNotes: vi.fn(),
   getMemoryNoteOperation: vi.fn(),

memhub/apps/web/src/MemoryNoteComposer.tsx

@@ -8,6 +8,7 @@ import {
   processMemoryNote,
   saveMemoryNote,
 } from "./api";
+import { useMemoryLanguage } from "./memory-language";
 import { memoryWriteErrorText } from "./model-error-text";
 import { subscribePoll } from "./poll-scheduler";
 import { traceUiAction } from "./ui-trace";
@@ -42,6 +43,7 @@ export function MemoryNoteComposer({
   onPendingChange?(note: PendingMemoryNote | null): void;
   suspended?: boolean;
 }) {
+  const { text: copy } = useMemoryLanguage();
   const [open, setOpen] = useState(false);
   const [text, setText] = useState("");
   const [notes, setNotes] = useState<MemoryNoteReceipt[]>([]);
@@ -274,11 +276,11 @@ export function MemoryNoteComposer({
         data-tour-id="memory-note-trigger"
         onClick={() => setOpen(true)}
       >
-        <FilePlus2 size={16} aria-hidden="true" /> 添加记忆
+        <FilePlus2 size={16} aria-hidden="true" /> {copy("添加记忆")}
       </button>
       {savedToast && (
         <p className="memory-note-toast" role="status">
-          {savedToast}
+          {copy(savedToast)}
         </p>
       )}
       {open && (
@@ -313,12 +315,12 @@ export function MemoryNoteComposer({
             }}
           >
             <header className="memory-note-heading">
-              <h2 id="memory-note-title">添加记忆</h2>
+              <h2 id="memory-note-title">{copy("添加记忆")}</h2>
               <button
                 className="quiet"
                 type="button"
-                aria-label="关闭新增记忆"
-                title="关闭"
+                aria-label={copy("关闭新增记忆")}
+                title={copy("关闭")}
                 disabled={busy}
                 onClick={close}
               >
@@ -332,7 +334,7 @@ export function MemoryNoteComposer({
               }}
             >
               <label className="memory-note-label" htmlFor="memory-note-text">
-                记下这件事
+                {copy("记下这件事")}
               </label>
               <textarea
                 id="memory-note-text"
@@ -340,20 +342,20 @@ export function MemoryNoteComposer({
                 maxLength={12000}
                 value={text}
                 disabled={busy}
-                placeholder="例如：项目周会不排在周五。"
+                placeholder={copy("例如：项目周会不排在周五。")}
                 onChange={(event) => setText(event.target.value)}
               />
               <p className="memory-note-model">
-                整理模型：
+                {copy("整理模型：")}
                 {model?.name ??
-                  (modelRead ? "尚未配置，原话仍可保存" : "正在读取")}
+                  copy(modelRead ? "尚未配置，原话仍可保存" : "正在读取")}
               </p>
               {error && (
                 <p className="error-banner" role="alert">
-                  {error}
+                  {copy(error)}
                 </p>
               )}
-              {notice && <p role="status">{notice}</p>}
+              {notice && <p role="status">{copy(notice)}</p>}
               <div className="consent-actions">
                 {modelRead && !model && (
                   <button
@@ -365,30 +367,35 @@ export function MemoryNoteComposer({
                       onConfigureModel();
                     }}
                   >
-                    配置模型
+                    {copy("配置模型")}
                   </button>
                 )}
                 <button type="submit" disabled={busy || !text.trim()}>
-                  {busy ? "保存中…" : "保存原话"}
+                  {copy(busy ? "保存中…" : "保存原话")}
                 </button>
               </div>
             </form>
             {notes.length > 0 && (
-              <section className="memory-note-recent" aria-label="最近添加">
-                <h3>最近添加</h3>
+              <section
+                className="memory-note-recent"
+                aria-label={copy("最近添加")}
+              >
+                <h3>{copy("最近添加")}</h3>
                 <ul>
                   {notes.map((note) => (
                     <li key={note.evidence_id}>
                       <p>{note.text}</p>
-                      <small>{states[note.state]}</small>
+                      <small>{copy(states[note.state])}</small>
                       {memoryWriteErrorText(note.error) && (
                         <p className="error-banner">
-                          {memoryWriteErrorText(note.error)}
+                          {copy(memoryWriteErrorText(note.error) ?? "")}
                         </p>
                       )}
                       {note.error === "hy_memory_model_payment_required" && (
                         <p className="error-banner">
-                          模型服务要求检查余额或付款状态，原话仍已保存。
+                          {copy(
+                            "模型服务要求检查余额或付款状态，原话仍已保存。",
+                          )}
                         </p>
                       )}
                       <div className="memory-note-actions">
@@ -402,7 +409,7 @@ export function MemoryNoteComposer({
                               onOpenMemory(id);
                             }}
                           >
-                            查看记忆
+                            {copy("查看记忆")}
                             {note.memory_ids.length > 1 ? ` ${index + 1}` : ""}
                           </button>
                         ))}
@@ -416,7 +423,7 @@ export function MemoryNoteComposer({
                             onClick={() => void retry(note)}
                           >
                             <RefreshCw size={14} aria-hidden="true" />
-                            重新整理
+                            {copy("重新整理")}
                           </button>
                         )}
                       </div>

memhub/apps/web/src/MemoryRecallScope.tsx

@@ -2,6 +2,7 @@ import type { MemoryDetail } from "@one-memory/contracts";
 import { Check, Globe2, LockKeyhole, Settings2 } from "lucide-react";
 import { useId, useRef, useState } from "react";
 import { apiErrorCode } from "./api";
+import { useMemoryLanguage } from "./memory-language";
 import { isDefiniteRefusal } from "./write-outcome";
 
 type Mode = "limited" | "shared" | "disabled";
@@ -51,6 +52,7 @@ export function MemoryRecallScope({
   busy: boolean;
   onSave(scopes: string[]): Promise<void>;
 }) {
+  const { text } = useMemoryLanguage();
   const id = useId();
   const editButton = useRef<HTMLButtonElement>(null);
   const [editing, setEditing] = useState(false);
@@ -107,18 +109,21 @@ export function MemoryRecallScope({
     }
   };
   return (
-    <section className="memory-recall-scope" aria-label="外部记忆召回范围">
+    <section
+      className="memory-recall-scope"
+      aria-label={text("外部记忆召回范围")}
+    >
       <div className="recall-scope-heading">
         <span>
           <LockKeyhole size={15} aria-hidden="true" />
-          外部记忆召回
+          {text("外部记忆召回")}
         </span>
         {editable && !editing && (
           <button
             type="button"
             className="quiet map-tool"
-            title="调整召回范围"
-            aria-label="调整召回范围"
+            title={text("调整召回范围")}
+            aria-label={text("调整召回范围")}
             ref={editButton}
             disabled={disabled}
             onClick={() => {
@@ -130,11 +135,11 @@ export function MemoryRecallScope({
           </button>
         )}
       </div>
-      <p className="recall-scope-summary">{summary}</p>
+      <p className="recall-scope-summary">{text(summary)}</p>
       {editing && (
         <>
           <fieldset disabled={disabled}>
-            <legend className="sr-only">选择召回范围</legend>
+            <legend className="sr-only">{text("选择召回范围")}</legend>
             {(
               [
                 ...(previous.length ? [["limited", "原有限定范围"]] : []),
@@ -158,7 +163,7 @@ export function MemoryRecallScope({
                 ) : (
                   <LockKeyhole size={16} aria-hidden="true" />
                 )}
-                <span>{label}</span>
+                <span>{text(label)}</span>
               </label>
             ))}
           </fieldset>
@@ -169,27 +174,27 @@ export function MemoryRecallScope({
               onClick={() => void save()}
             >
               <Check size={15} aria-hidden="true" />
-              {saving ? "正在保存…" : "保存召回范围"}
+              {text(saving ? "正在保存…" : "保存召回范围")}
             </button>
             <button
               type="button"
               className="quiet"
-              aria-label="取消范围修改"
+              aria-label={text("取消范围修改")}
               disabled={disabled}
               onClick={close}
             >
-              取消
+              {text("取消")}
             </button>
           </div>
         </>
       )}
       {error && (
         <p className="notice danger" role="alert">
-          {error}
+          {text(error)}
         </p>
       )}
       <p className="recall-scope-boundary">
-        原文检索仍按来源授权；已带出的内容不会撤回。
+        {text("原文检索仍按来源授权；已带出的内容不会撤回。")}
       </p>
     </section>
   );

memhub/apps/web/src/MemorySpace.r6.test.tsx

@@ -8,9 +8,39 @@ import {
   waitFor,
 } from "@testing-library/react";
 import { afterEach, expect, it, vi } from "vitest";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
 import { DIALOGUE_PANE_VISIBLE } from "./MemoryMap";
 import { MemorySpace } from "./MemorySpace";
 
+it("translates memory filters and detail affordances live without refetching", async () => {
+  setup();
+  delete window.oneMemory;
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  render(
+    <LanguageProvider>
+      <MemorySpace simplified />
+    </LanguageProvider>,
+  );
+  await screen.findByRole("heading", { name: "Memorias", level: 1 });
+  await screen.findByText("已保存的记忆");
+  expect(
+    screen.getByRole("textbox", { name: "Filtrar memorias del mapa" }),
+  ).toBeTruthy();
+  expect(
+    screen.getByRole("button", { name: "Actualizar memorias" }),
+  ).toBeTruthy();
+  const calls = reads.mapLibrary.mock.calls.length;
+  act(() => {
+    localStorage.setItem(LANGUAGE_STORAGE_KEY, "zh-CN");
+    window.dispatchEvent(
+      new StorageEvent("storage", { key: LANGUAGE_STORAGE_KEY }),
+    );
+  });
+  expect(screen.getByRole("heading", { name: "记忆", level: 1 })).toBeTruthy();
+  expect(reads.mapLibrary).toHaveBeenCalledTimes(calls);
+  localStorage.clear();
+});
+
 const { reads } = vi.hoisted(() => ({
   reads: {
     memories: vi.fn(),
@@ -69,6 +99,36 @@ afterEach(() => {
   vi.useRealTimers();
   vi.clearAllMocks();
 });
+it("translates the model-required prompt without configuring a model", async () => {
+  setup();
+  reads.processing.mockResolvedValue({
+    running: 0,
+    pending: 0,
+    completed: 0,
+    blocked_stages: [
+      { kind: "extract", reason: "waiting_for_model", count: 4 },
+    ],
+  });
+  delete window.oneMemory;
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  const configure = vi.fn();
+  render(
+    <LanguageProvider>
+      <MemorySpace simplified onConfigureModel={configure} />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByRole("status", {
+      name: "Generación de memorias detenida",
+    }),
+  ).toHaveProperty(
+    "textContent",
+    "Aún no se generan memorias: Esperando un modelo disponible (4 pendientes)Configurar modelo de generación",
+  );
+  expect(configure).not.toHaveBeenCalled();
+  localStorage.clear();
+});
+
 function setup() {
   const items = [
     {

memhub/apps/web/src/MemorySpace.tsx

@@ -63,6 +63,7 @@ import {
 } from "./MemoryNoteComposer";
 import { MemoryRecallScope, memoryProvenanceLabel } from "./MemoryRecallScope";
 import type { MemoryArrival } from "./memory-arrival-state";
+import { useMemoryLanguage } from "./memory-language";
 import {
   blockReasonLabel,
   extractionStateLabel,
@@ -119,6 +120,7 @@ export function MemorySpace({
   focusDialogue?: boolean;
   onFocusDialogueConsumed?(): void;
 }) {
+  const { locale, text, count } = useMemoryLanguage();
   const [memories, setMemories] = useState<GovernedMemory[]>([]);
   const [detail, setDetail] = useState<MemoryDetail | null>(null);
   const [detailFreshness, setDetailFreshness] = useState<{
@@ -197,10 +199,12 @@ export function MemorySpace({
   // filter's, and naming the new one would caption the wrong numbers.
   const settledFilterLabel = [
     mapLibrary.settledSource
-      ? `来源 ${sourceNameOr(sources, mapLibrary.settledSource, mapLibrary.settledSource)}`
+      ? `${text("来源")} ${sourceNameOr(sources, mapLibrary.settledSource, mapLibrary.settledSource)}`
       : "",
     mapLibrary.settledQuery.trim()
-      ? `关键词“${mapLibrary.settledQuery.trim()}”`
+      ? locale === "es"
+        ? `Búsqueda: «${mapLibrary.settledQuery.trim()}»`
+        : `关键词“${mapLibrary.settledQuery.trim()}”`
       : "",
   ]
     .filter(Boolean)
@@ -1416,16 +1420,18 @@ export function MemorySpace({
       </div>
       <header className="memory-instrument-header">
         <div>
-          <h1 id="memory-title">{simplified ? "记忆" : "记忆空间"}</h1>
+          <h1 id="memory-title">{text(simplified ? "记忆" : "记忆空间")}</h1>
           <span className="memory-loaded-count">
             {simplified && !management
               ? mapLibrary.failed
-                ? "记忆读取失败"
+                ? text("记忆读取失败")
                 : mapLibrary.stale
-                  ? "正在导入历史会话，记忆将陆续出现"
+                  ? text("正在导入历史会话，记忆将陆续出现")
                   : mapLibrary.page
-                    ? `已沉淀 ${mapLibrary.page.total} 条${settledFilterLabel ? `（${settledFilterLabel}）` : ""} · 当前展示 ${mapLibrary.page.items.length} 条`
-                    : "正在读取…"
+                    ? locale === "es"
+                      ? `${count(mapLibrary.page.total)} ${mapLibrary.page.total === 1 ? "memoria guardada" : "memorias guardadas"}${settledFilterLabel ? ` (${settledFilterLabel})` : ""} · ${count(mapLibrary.page.items.length)} visibles`
+                      : `已沉淀 ${mapLibrary.page.total} 条${settledFilterLabel ? `（${settledFilterLabel}）` : ""} · 当前展示 ${mapLibrary.page.items.length} 条`
+                    : text("正在读取…")
               : loaded
                 ? `已加载 ${memories.filter((m) => m.status !== "deleted").length} 条记忆`
                 : "正在读取…"}
@@ -1596,10 +1602,15 @@ export function MemorySpace({
       />
       {simplified && pendingNote ? (
         <p className="memory-pending-note" role="status">
-          <span>原话已保存，正在等待整理：{pendingNote.text}</span>
+          <span>
+            {locale === "es"
+              ? "Texto guardado; pendiente de procesar: "
+              : "原话已保存，正在等待整理："}
+            {pendingNote.text}
+          </span>
           {pendingNote.state === "waiting_for_model" ? (
             <button type="button" onClick={onConfigureModel}>
-              配置整理模型
+              {text("配置整理模型")}
             </button>
           ) : null}
         </p>
@@ -1607,18 +1618,18 @@ export function MemorySpace({
 
       {readError && (
         <details className="memory-feedback-details">
-          <summary>查看读取详情</summary>
-          <p>{readError}</p>
+          <summary>{text("查看读取详情")}</summary>
+          <p>{text(readError)}</p>
         </details>
       )}
       {refreshing ? (
         <p className="memory-refreshing" role="status">
-          正在更新…
+          {text("正在更新…")}
         </p>
       ) : null}
       {error ? (
         <p className="error-banner" role="alert">
-          {error}
+          {text(error)}
         </p>
       ) : null}
 
@@ -1901,17 +1912,24 @@ export function MemorySpace({
           {management && (
             <>
               {library.page ? (
-                <nav aria-label="记忆库分页">
-                  <span aria-live="polite">共 {library.page.total} 条</span>{" "}
+                <nav
+                  className="memory-library-pagination"
+                  aria-label={text("记忆库分页")}
+                >
+                  <span aria-live="polite">
+                    {locale === "es"
+                      ? `${library.page.total} memorias en total`
+                      : `共 ${library.page.total} 条`}
+                  </span>{" "}
                   <span>
-                    第{" "}
-                    {Math.floor(library.page.offset / library.page.limit) + 1}{" "}
-                    页
+                    {locale === "es"
+                      ? `Página ${Math.floor(library.page.offset / library.page.limit) + 1}`
+                      : `第 ${Math.floor(library.page.offset / library.page.limit) + 1} 页`}
                   </span>
                   <R6Button
                     variant="quiet"
-                    title="上一页"
-                    aria-label="上一页"
+                    title={text("上一页")}
+                    aria-label={text("上一页")}
                     disabled={busy || library.page.offset === 0}
                     onClick={() => {
                       if (library.page) {
@@ -1924,8 +1942,8 @@ export function MemorySpace({
                   </R6Button>
                   <R6Button
                     variant="quiet"
-                    title="下一页"
-                    aria-label="下一页"
+                    title={text("下一页")}
+                    aria-label={text("下一页")}
                     disabled={
                       busy ||
                       library.page.offset + library.page.limit >=
@@ -2100,6 +2118,7 @@ function ModelPrompt({
   hasMemories: boolean;
   onConfigureModel(): void;
 }) {
+  const { locale, text, count } = useMemoryLanguage();
   const blocked = processing ? modelBlock(processing.blocked_stages) : null;
   if (!blocked) return null;
   if (
@@ -2110,12 +2129,20 @@ function ModelPrompt({
   )
     return null;
   return (
-    <p className="model-prompt" role="status" aria-label="记忆未在生成">
+    <p
+      className="model-prompt"
+      role="status"
+      aria-label={
+        locale === "es" ? "Generación de memorias detenida" : "记忆未在生成"
+      }
+    >
       <span>
-        {`还没有开始生成记忆：${blockReasonLabel(blocked.reason)}（${blocked.count} 条待处理）`}
+        {locale === "es"
+          ? `Aún no se generan memorias: ${text(blockReasonLabel(blocked.reason))} (${count(blocked.count)} pendientes)`
+          : `还没有开始生成记忆：${blockReasonLabel(blocked.reason)}（${blocked.count} 条待处理）`}
       </span>
       <button type="button" onClick={onConfigureModel}>
-        去配置生成模型
+        {locale === "es" ? "Configurar modelo de generación" : "去配置生成模型"}
       </button>
     </p>
   );

memhub/apps/web/src/ModelSettings.test.tsx

@@ -12,7 +12,7 @@ import {
 import userEvent from "@testing-library/user-event";
 import { createRef } from "react";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
 import {
   ModelSettings,
   type ModelSettingsActions,
@@ -20,6 +20,45 @@ import {
 } from "./ModelSettings";
 import { PROVIDER_PRESETS } from "./provider-presets";
 
+it("keeps the edited model draft and does not mutate on live language changes", async () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  profiles = [profile];
+  const user = userEvent.setup();
+  render(
+    <LanguageProvider>
+      <ModelSettings />
+    </LanguageProvider>,
+  );
+  const field = await screen.findByLabelText(
+    "Identificador del modelo de generación",
+  );
+  await user.type(field, "synthetic-model");
+  const before = [
+    create.mock.calls.length,
+    update.mock.calls.length,
+    activate.mock.calls.length,
+    probeProfile.mock.calls.length,
+  ];
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "zh-CN");
+  await act(async () =>
+    window.dispatchEvent(
+      new StorageEvent("storage", { key: LANGUAGE_STORAGE_KEY }),
+    ),
+  );
+  expect(await screen.findByLabelText("生成模型名")).toHaveProperty(
+    "value",
+    "synthetic-model",
+  );
+  expect([
+    create.mock.calls.length,
+    update.mock.calls.length,
+    activate.mock.calls.length,
+    probeProfile.mock.calls.length,
+  ]).toEqual(before);
+  cleanup();
+  localStorage.clear();
+});
+
 const create = vi.fn();
 const probeProfile = vi.fn();
 const activate = vi.fn();

memhub/apps/web/src/ModelSettings.tsx

@@ -17,6 +17,7 @@ import {
   useState,
 } from "react";
 import { OptionMenu } from "./OptionMenu";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { PROVIDER_PRESETS } from "./provider-presets";
 import { useModelProfiles } from "./use-model-profiles";
 import "./model-setup-next.css";
@@ -226,6 +227,7 @@ export function ModelSettings({
   compactSingle?: boolean;
   onSetupComplete?(): void;
 } = {}) {
+  const { text } = useOnboardingTranslation();
   const models = useModelProfiles();
   const [provider, setProvider] = useState<ProviderKind>("openai_compatible");
   const [providerPreset, setProviderPreset] = useState("custom");
@@ -669,25 +671,28 @@ export function ModelSettings({
       <div className="section-heading">
         <div>
           <p className="section-index">02</p>
-          <h2 id="models-title">记忆模型</h2>
+          <h2 id="models-title">{text("记忆模型")}</h2>
         </div>
         <p>
-          只需配置生成模型。向量嵌入已内置在本机，不为 System 1、System 2
-          分开选模型。
+          {text(
+            "只需配置生成模型。向量嵌入已内置在本机，不为 System 1、System 2 分开选模型。",
+          )}
         </p>
       </div>
 
       {models.error ? (
         <p className="error-banner" role="alert">
-          {models.error}
+          {text(models.error)}
         </p>
       ) : null}
       {(models.pendingProbe || models.probeStorageFailed) && (
         <div role="status" className="model-refresh-notice">
           <p>
-            {models.probeStorageFailed
-              ? "无法读取测试恢复记录，暂不发送新的测试。"
-              : "上次模型测试结果待核对，暂不修改或启用配置。"}
+            {text(
+              models.probeStorageFailed
+                ? "无法读取测试恢复记录，暂不发送新的测试。"
+                : "上次模型测试结果待核对，暂不修改或启用配置。",
+            )}
           </p>
           {models.pendingProbe && (
             <button
@@ -702,7 +707,7 @@ export function ModelSettings({
                 if (alive.current) onProfilesChanged?.();
               }}
             >
-              核对测试结果
+              {text("核对测试结果")}
             </button>
           )}
         </div>
@@ -710,9 +715,11 @@ export function ModelSettings({
       {(models.pendingCreation || models.creationStorageFailed) && (
         <div role="status" className="model-refresh-notice">
           <p>
-            {models.creationMissing
-              ? "未找到上次创建记录。确认放弃旧记录后可重新配置；系统不会自动重试。"
-              : "上次模型创建结果待核对，暂不开始新的操作。"}
+            {text(
+              models.creationMissing
+                ? "未找到上次创建记录。确认放弃旧记录后可重新配置；系统不会自动重试。"
+                : "上次模型创建结果待核对，暂不开始新的操作。",
+            )}
           </p>
           <button
             type="button"
@@ -728,7 +735,7 @@ export function ModelSettings({
               onProfilesChanged?.();
             }}
           >
-            核对创建结果
+            {text("核对创建结果")}
           </button>
           {models.pendingCreation && (
             <button
@@ -742,26 +749,28 @@ export function ModelSettings({
                 setSaveError(null);
               }}
             >
-              放弃旧记录，重新配置
+              {text("放弃旧记录，重新配置")}
             </button>
           )}
         </div>
       )}
       {setupPhase && (
         <p className="model-test-notice" role="status">
-          {setupPhase === "testing"
-            ? "配置已保存，正在测试连接…"
-            : "连接通过，正在启用模型…"}
+          {text(
+            setupPhase === "testing"
+              ? "配置已保存，正在测试连接…"
+              : "连接通过，正在启用模型…",
+          )}
         </p>
       )}
       {setupError && (
         <p className="model-save-error" role="alert">
-          {setupError}
+          {text(setupError)}
         </p>
       )}
       {models.refreshError && (
         <div className="model-refresh-notice" role="status">
-          <p>{models.refreshError}</p>
+          <p>{text(models.refreshError)}</p>
           <button
             type="button"
             className="secondary"
@@ -769,7 +778,7 @@ export function ModelSettings({
             onClick={() => void models.refreshProfiles()}
           >
             <RefreshCw size={16} aria-hidden="true" />
-            刷新配置列表
+            {text("刷新配置列表")}
           </button>
         </div>
       )}
@@ -808,7 +817,7 @@ export function ModelSettings({
               } else newProfile();
             }}
           >
-            自定义一个模型
+            {text("自定义一个模型")}
           </button>
         </div>
       ) : null}
@@ -816,7 +825,7 @@ export function ModelSettings({
       {!compactSingle && savedProfile && (
         <article
           className="model-saved-card"
-          aria-label="已保存的模型配置"
+          aria-label={text("已保存的模型配置")}
           tabIndex={-1}
           ref={savedCard}
           data-tour-id="model-form"
@@ -824,34 +833,37 @@ export function ModelSettings({
           <div className="model-saved-heading">
             <Check size={18} aria-hidden="true" />
             <strong>
-              {isReady(savedProfile) && savedProfile.is_active
-                ? "已保存，已启用"
-                : isReady(savedProfile)
-                  ? "已保存，连接通过"
-                  : models.probeFor(savedProfile)
-                    ? "已保存，测试未通过"
-                    : "已保存，待测试"}
+              {text(
+                isReady(savedProfile) && savedProfile.is_active
+                  ? "已保存，已启用"
+                  : isReady(savedProfile)
+                    ? "已保存，连接通过"
+                    : models.probeFor(savedProfile)
+                      ? "已保存，测试未通过"
+                      : "已保存，待测试",
+              )}
             </strong>
           </div>
           <h3>{savedProfile.name}</h3>
           <p>
-            {savedProfile.model} · {endpointLabel(savedProfile.base_url)} · 版本{" "}
-            {savedProfile.revision}
+            {savedProfile.model} · {text(endpointLabel(savedProfile.base_url))}{" "}
+            · {text("版本")} {savedProfile.revision}
           </p>
           {savedProfile.credential_state === "unavailable" && (
             <p role="status">
-              需要允许 MemHub
-              访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。
+              {text(
+                "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。",
+              )}
             </p>
           )}
-          <p>测试只向此接口发送测试内容，不发送历史对话。</p>
+          <p>{text("测试只向此接口发送测试内容，不发送历史对话。")}</p>
           <div className="source-actions">
             <button
               type="button"
               disabled={locked}
               onClick={() => void resumeSetup(savedProfile)}
             >
-              {setupError ? "重试测试并启用" : "测试并启用"}
+              {text(setupError ? "重试测试并启用" : "测试并启用")}
             </button>
             <button
               type="button"
@@ -860,7 +872,7 @@ export function ModelSettings({
               onClick={() => editProfile(savedProfile)}
             >
               <Pencil size={16} aria-hidden="true" />
-              编辑配置
+              {text("编辑配置")}
             </button>
             <button
               type="button"
@@ -869,7 +881,7 @@ export function ModelSettings({
               onClick={newProfile}
             >
               <Plus size={16} aria-hidden="true" />
-              新增配置
+              {text("新增配置")}
             </button>
           </div>
           <ProbeFeedback
@@ -891,18 +903,20 @@ export function ModelSettings({
         >
           {editing && (
             <p className="model-test-notice">
-              编辑 {editing.name} · 版本 {editing.revision}
-              。修改后需重新测试并设为当前模型，内容授权不会自动更新。
+              {text("编辑")} {editing.name} · {text("版本")} {editing.revision}
+              {text("。修改后需重新测试并设为当前模型，内容授权不会自动更新。")}
             </p>
           )}
           {editChanged && (
             <p role="alert" className="model-save-error">
-              配置已在其他位置变化，草稿已保留。请取消编辑后重新打开核对。
+              {text(
+                "配置已在其他位置变化，草稿已保留。请取消编辑后重新打开核对。",
+              )}
             </p>
           )}
           {saveError && (
             <p className="model-save-error" role="alert">
-              {saveError}
+              {text(saveError)}
             </p>
           )}
           {unknownCreation && !editing && (
@@ -911,13 +925,13 @@ export function ModelSettings({
               disabled={formLocked}
               onClick={() => void models.refreshProfiles()}
             >
-              刷新配置列表
+              {text("刷新配置列表")}
             </button>
           )}
           <div className="model-form-field">
-            服务商预设
+            {text("服务商预设")}
             <OptionMenu
-              ariaLabel="服务商预设"
+              ariaLabel={text("服务商预设")}
               describedBy="model-preset-help"
               value={providerPreset}
               disabled={formLocked}
@@ -926,7 +940,7 @@ export function ModelSettings({
                   value: item.id,
                   label: item.label,
                 })),
-                { value: "custom", label: "自定义兼容服务" },
+                { value: "custom", label: text("自定义兼容服务") },
               ]}
               onChange={(value) => {
                 const next = PROVIDER_PRESETS.find((item) => item.id === value);
@@ -948,15 +962,16 @@ export function ModelSettings({
               }}
             />
             <small id="model-preset-help">
-              只是帮你填好接口地址和一个模型名，不代表这个模型当前可用。
-              请对照服务商的模型列表核对后再保存。
+              {text(
+                "只是帮你填好接口地址和一个模型名，不代表这个模型当前可用。 请对照服务商的模型列表核对后再保存。",
+              )}
             </small>
           </div>
           <label>
-            协议
+            {text("协议")}
             <select
               name="provider"
-              aria-label="协议"
+              aria-label={text("协议")}
               aria-describedby="model-provider-help"
               value={provider}
               disabled={formLocked}
@@ -972,19 +987,19 @@ export function ModelSettings({
                * the reader parse a parenthesis to find out they were dead. */}
               {PROVIDERS.filter((item) => item.activatable).map((item) => (
                 <option key={item.kind} value={item.kind}>
-                  {item.label}
+                  {text(item.label)}
                 </option>
               ))}
             </select>
             <small id="model-provider-help">
-              与模型服务提供的接口协议保持一致。
+              {text("与模型服务提供的接口协议保持一致。")}
             </small>
           </label>
           <label>
-            配置名称
+            {text("配置名称")}
             <input
               name="name"
-              aria-label="配置名称"
+              aria-label={text("配置名称")}
               aria-describedby="model-name-help"
               autoComplete="off"
               maxLength={128}
@@ -995,13 +1010,15 @@ export function ModelSettings({
                 setName(event.target.value);
               }}
             />
-            <small id="model-name-help">用于区分配置，不影响模型请求。</small>
+            <small id="model-name-help">
+              {text("用于区分配置，不影响模型请求。")}
+            </small>
           </label>
           <label>
-            生成模型名
+            {text("生成模型名")}
             <input
               name="model"
-              aria-label="生成模型名"
+              aria-label={text("生成模型名")}
               aria-describedby={`model-identifier-help${fields.model ? " model-field-error" : ""}`}
               aria-invalid={!!fields.model}
               autoComplete="off"
@@ -1014,14 +1031,14 @@ export function ModelSettings({
                 setProviderPreset("custom");
                 if (!nameEdited) setName(suggestedName(event.target.value));
               }}
-              placeholder="例如：gpt-4o-mini…"
+              placeholder={text("例如：gpt-4o-mini…")}
             />
             <small id="model-identifier-help">
-              填写服务方提供的完整模型标识。
+              {text("填写服务方提供的完整模型标识。")}
             </small>
             {fields.model && (
               <small id="model-field-error" className="model-field-error">
-                {fields.model}
+                {text(fields.model)}
               </small>
             )}
           </label>
@@ -1034,12 +1051,12 @@ export function ModelSettings({
               disabled={formLocked}
               onClick={() => setAdvancedEmbedding(!advancedEmbedding)}
             >
-              高级：自行配置向量模型
+              {text("高级：自行配置向量模型")}
             </button>
             {advancedEmbedding ? (
               <>
                 <label>
-                  向量配置模式
+                  {text("向量配置模式")}
                   <select
                     name="embedding-mode"
                     value={embeddingMode}
@@ -1056,14 +1073,14 @@ export function ModelSettings({
                       }));
                     }}
                   >
-                    <option value="local">本地内置</option>
-                    <option value="custom">自定义向量模型</option>
+                    <option value="local">{text("本地内置")}</option>
+                    <option value="custom">{text("自定义向量模型")}</option>
                   </select>
                 </label>
                 {embeddingMode === "custom" ? (
                   <>
                     <label>
-                      向量模型名
+                      {text("向量模型名")}
                       <input
                         name="embedding-model"
                         autoComplete="off"
@@ -1080,19 +1097,19 @@ export function ModelSettings({
                         onChange={(event) =>
                           setEmbeddingModel(event.target.value)
                         }
-                        placeholder="例如：text-embedding-3-small…"
+                        placeholder={text("例如：text-embedding-3-small…")}
                       />
                       {fields["embedding-model"] && (
                         <small
                           id="model-embedding-error"
                           className="model-field-error"
                         >
-                          {fields["embedding-model"]}
+                          {text(fields["embedding-model"])}
                         </small>
                       )}
                     </label>
                     <label>
-                      向量模型来源
+                      {text("向量模型来源")}
                       <select
                         name="embedding-provider"
                         value={embeddingProvider}
@@ -1104,14 +1121,14 @@ export function ModelSettings({
                           setEmbeddingProvider(next);
                         }}
                       >
-                        <option value="ollama">本机 Ollama</option>
+                        <option value="ollama">{text("本机 Ollama")}</option>
                         <option value="openai_compatible">
-                          同源 OpenAI-compatible（共用 API Key）
+                          {text("同源 OpenAI-compatible（共用 API Key）")}
                         </option>
                       </select>
                     </label>
                     <label>
-                      向量模型 Base URL
+                      {text("向量模型 Base URL")}
                       <input
                         name="embedding-base-url"
                         type="url"
@@ -1140,27 +1157,27 @@ export function ModelSettings({
                           id="model-embedding-url-error"
                           className="model-field-error"
                         >
-                          {fields["embedding-base-url"]}
+                          {text(fields["embedding-base-url"])}
                         </small>
                       )}
                     </label>
                     {embeddingProvider === "openai_compatible" ? (
                       <small>
-                        为避免凭据外泄，向量地址必须与生成模型同源。
+                        {text("为避免凭据外泄，向量地址必须与生成模型同源。")}
                       </small>
                     ) : null}
                   </>
                 ) : (
                   <small>
-                    使用内置本地向量模型；不会发送内容给远程向量服务。
+                    {text("使用内置本地向量模型；不会发送内容给远程向量服务。")}
                   </small>
                 )}
               </>
             ) : null}
             {!advancedEmbedding && embeddingMode === "custom" ? (
               <p className="model-help">
-                自定义向量：{embeddingModel || "尚未填写模型"} ·{" "}
-                {embeddingBaseUrl || "尚未填写地址"}
+                {text("自定义向量")}: {embeddingModel || text("尚未填写模型")} ·{" "}
+                {embeddingBaseUrl || text("尚未填写地址")}
               </p>
             ) : null}
           </div>
@@ -1183,19 +1200,19 @@ export function ModelSettings({
               }}
             />
             <small id="model-url-help">
-              填写服务接口地址，不是聊天网页地址。
+              {text("填写服务接口地址，不是聊天网页地址。")}
             </small>
             {fields["base-url"] && (
               <small id="model-url-error" className="model-field-error">
-                {fields["base-url"]}
+                {text(fields["base-url"])}
               </small>
             )}
           </label>
           <label>
-            API Key{keyRequired ? "" : "（可选）"}
+            API Key{keyRequired ? "" : text("（可选）")}
             <input
               name="api-key"
-              aria-label={`API Key${keyRequired ? "" : "（可选）"}`}
+              aria-label={`API Key${keyRequired ? "" : text("（可选）")}`}
               aria-describedby={`model-key-help${fields["api-key"] ? " model-key-error" : ""}`}
               aria-invalid={!!fields["api-key"]}
               type="password"
@@ -1204,18 +1221,20 @@ export function ModelSettings({
               value={apiKey}
               disabled={formLocked}
               onChange={(event) => setApiKey(event.target.value)}
-              placeholder="保存后不会再次显示…"
+              placeholder={text("保存后不会再次显示…")}
             />
             <small id="model-key-help">
-              {editing && !endpointMoved
-                ? "留空保留已保存密钥；填写新密钥后需重新测试和启用。"
-                : editing && keyRequired
-                  ? "换了服务商后需要填写新的 API Key，已保存的密钥不会带到新地址。"
-                  : "保存在系统安全存储中，不随安装包分发。"}
+              {text(
+                editing && !endpointMoved
+                  ? "留空保留已保存密钥；填写新密钥后需重新测试和启用。"
+                  : editing && keyRequired
+                    ? "换了服务商后需要填写新的 API Key，已保存的密钥不会带到新地址。"
+                    : "保存在系统安全存储中，不随安装包分发。",
+              )}
             </small>
             {fields["api-key"] && (
               <small id="model-key-error" className="model-field-error">
-                {fields["api-key"]}
+                {text(fields["api-key"])}
               </small>
             )}
           </label>
@@ -1227,7 +1246,7 @@ export function ModelSettings({
               disabled={formLocked}
               onChange={(event) => setDisableThinking(event.target.checked)}
             />
-            关闭思考链（向支持的厂商下发 thinking-off 参数）
+            {text("关闭思考链（向支持的厂商下发 thinking-off 参数）")}
           </label>
           <div className="form-submit">
             {!compactSingle && (
@@ -1237,7 +1256,7 @@ export function ModelSettings({
                   locked || editChanged || (!editing && unknownCreation)
                 }
               >
-                {editing ? "保存修改" : "保存配置"}
+                {text(editing ? "保存修改" : "保存配置")}
               </button>
             )}
             <button
@@ -1245,13 +1264,15 @@ export function ModelSettings({
               disabled={locked || editChanged || (!editing && unknownCreation)}
               onClick={() => void persist(true)}
             >
-              {setupPhase === "testing"
-                ? "正在测试连接…"
-                : setupPhase === "activating"
-                  ? "正在启用配置…"
-                  : compactSingle
-                    ? "测试并完成配置"
-                    : "保存并测试启用"}
+              {text(
+                setupPhase === "testing"
+                  ? "正在测试连接…"
+                  : setupPhase === "activating"
+                    ? "正在启用配置…"
+                    : compactSingle
+                      ? "测试并完成配置"
+                      : "保存并测试启用",
+              )}
             </button>
             {editing && (
               <button
@@ -1266,10 +1287,12 @@ export function ModelSettings({
                   setFields({});
                 }}
               >
-                取消编辑
+                {text("取消编辑")}
               </button>
             )}
-            <small>密钥保存在系统安全存储；测试仅发送测试内容。</small>
+            <small>
+              {text("密钥保存在系统安全存储；测试仅发送测试内容。")}
+            </small>
           </div>
         </form>
       ) : null}
@@ -1286,14 +1309,16 @@ export function ModelSettings({
               <article key={profile.profile_id} className="profile-row">
                 {profile.credential_state === "unavailable" && (
                   <p className="error-banner" role="status">
-                    需要允许 MemHub
-                    访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。
+                    {text(
+                      "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。",
+                    )}
                   </p>
                 )}
                 <div>
                   <strong>{profile.name}</strong>
                   <p>
-                    {providerLabel(profile.provider_kind)} · {profile.model} ·
+                    {text(providerLabel(profile.provider_kind))} ·{" "}
+                    {profile.model} ·
                     {/* Core fills in the built-in vector model on every profile,
                      * so printing it unconditionally put a line about
                      * bge-small-zh-v1.5 under a profile whose owner never chose
@@ -1302,17 +1327,17 @@ export function ModelSettings({
                     {profile.embedding_model &&
                     profile.embedding_provider_kind &&
                     profile.embedding_provider_kind !== BUILTIN_EMBEDDING_KIND
-                      ? ` 向量: ${profile.embedding_model} (${providerLabel(
-                          profile.embedding_provider_kind,
+                      ? ` ${text("自定义向量")}: ${profile.embedding_model} (${text(
+                          providerLabel(profile.embedding_provider_kind),
                         )}) ·`
                       : ""}{" "}
                     revision {profile.revision}
                   </p>
                 </div>
-                <span>{profile.is_active ? "当前使用" : "未启用"}</span>
+                <span>{text(profile.is_active ? "当前使用" : "未启用")}</span>
                 <p className="model-test-notice">
-                  测试目标：{endpointLabel(profile.base_url)}
-                  。仅发送测试内容，不发送历史对话。
+                  {text("测试目标")}: {text(endpointLabel(profile.base_url))}
+                  {text("。仅发送测试内容，不发送历史对话。")}
                 </p>
                 <div className="source-actions">
                   <button
@@ -1320,7 +1345,7 @@ export function ModelSettings({
                     disabled={locked}
                     onClick={() => void resumeSetup(profile)}
                   >
-                    {setupError ? "重试测试并启用" : "测试并启用"}
+                    {text(setupError ? "重试测试并启用" : "测试并启用")}
                   </button>
                   <button
                     type="button"
@@ -1329,7 +1354,7 @@ export function ModelSettings({
                     onClick={() => editProfile(profile)}
                   >
                     <Pencil size={16} aria-hidden="true" />
-                    编辑配置
+                    {text("编辑配置")}
                   </button>
                   <button
                     type="button"
@@ -1337,7 +1362,7 @@ export function ModelSettings({
                     disabled={locked}
                     onClick={() => models.probeProfile(profile.profile_id)}
                   >
-                    测试连接
+                    {text("测试连接")}
                   </button>
                   {!profile.is_active ? (
                     <>
@@ -1346,7 +1371,7 @@ export function ModelSettings({
                         disabled={locked || !isReady(profile)}
                         onClick={() => models.activate(profile.profile_id)}
                       >
-                        设为当前模型
+                        {text("设为当前模型")}
                       </button>
                       <button
                         type="button"
@@ -1354,7 +1379,7 @@ export function ModelSettings({
                         disabled={locked}
                         onClick={() => models.remove(profile.profile_id)}
                       >
-                        删除
+                        {text("删除")}
                       </button>
                     </>
                   ) : null}
@@ -1406,6 +1431,7 @@ function PresetProfileCard({
   probe: ModelProbeResult | null;
   probeError: string | null;
 }) {
+  const { text } = useOnboardingTranslation();
   const [key, setKey] = useState("");
   const [error, setError] = useState<string | null>(null);
   const [saving, setSaving] = useState(false);
@@ -1454,21 +1480,25 @@ function PresetProfileCard({
     <section className="preset-profile" aria-label={profile.name}>
       <div>
         <strong>{profile.name}</strong>
-        <p>{presetStatus(profile)}</p>
+        <p>{text(presetStatus(profile))}</p>
       </div>
       {discloseRecipients && (
         <p>
-          生成接收方：{endpointLabel(profile.base_url)}；向量接收方：
+          {text("生成接收方")}: {text(endpointLabel(profile.base_url))};{" "}
+          {text("向量接收方")}:
           {profile.embedding_provider_kind === BUILTIN_EMBEDDING_KIND
-            ? "本机"
-            : endpointLabel(profile.embedding_base_url ?? profile.base_url)}
-          。启用此配置后按上方选择处理历史及未来允许来源。
+            ? text("本机")
+            : text(
+                endpointLabel(profile.embedding_base_url ?? profile.base_url),
+              )}
+          {text("。启用此配置后按上方选择处理历史及未来允许来源。")}
         </p>
       )}
       {profile.credential_state === "unavailable" && (
         <p role="status">
-          需要允许 MemHub
-          访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。
+          {text(
+            "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。",
+          )}
         </p>
       )}
       {profile.has_api_key ? null : (
@@ -1482,7 +1512,7 @@ function PresetProfileCard({
           noValidate
         >
           <label>
-            {keyLabel}
+            {text(keyLabel)}
             <input
               name="preset-api-key"
               type="password"
@@ -1495,7 +1525,7 @@ function PresetProfileCard({
               }
               value={key}
               onChange={(event) => setKey(event.target.value)}
-              placeholder="保存后不会再次显示…"
+              placeholder={text("保存后不会再次显示…")}
             />
             {error && (
               <small
@@ -1503,12 +1533,12 @@ function PresetProfileCard({
                 className="model-field-error"
                 role="alert"
               >
-                {error}
+                {text(error)}
               </small>
             )}
           </label>
           <button type="submit" disabled={busy || saving}>
-            保存 key
+            {text("保存 key")}
           </button>
           <button
             type="button"
@@ -1516,11 +1546,11 @@ function PresetProfileCard({
             disabled={busy || saving || !canEnable}
             onClick={() => void save(true)}
           >
-            保存并测试启用
+            {text("保存并测试启用")}
           </button>
           {applyHref ? (
             <a href={applyHref} target="_blank" rel="noreferrer">
-              还没有 key？去申请
+              {text("还没有 key？去申请")}
             </a>
           ) : null}
         </form>
@@ -1533,21 +1563,21 @@ function PresetProfileCard({
             disabled={busy || !canEnable}
             onClick={onContinue}
           >
-            测试并启用
+            {text("测试并启用")}
           </button>
           <p className="model-test-notice">
-            测试目标：{endpointLabel(profile.base_url)}
-            。仅发送测试内容，不发送历史对话。
+            {text("测试目标")}: {text(endpointLabel(profile.base_url))}
+            {text("。仅发送测试内容，不发送历史对话。")}
           </p>
           <button type="button" disabled={busy} onClick={onTest}>
-            测试连接
+            {text("测试连接")}
           </button>
           <button
             type="button"
             disabled={busy || !canEnable || !ready(profile, probe, probeError)}
             onClick={onActivate}
           >
-            设为当前模型
+            {text("设为当前模型")}
           </button>
           <button
             type="button"
@@ -1555,7 +1585,7 @@ function PresetProfileCard({
             disabled={busy}
             onClick={onRemove}
           >
-            删除
+            {text("删除")}
           </button>
         </div>
       ) : null}
@@ -1572,7 +1602,7 @@ function PresetProfileCard({
             disabled={busy}
             onClick={onRemove}
           >
-            删除这张卡
+            {text("删除这张卡")}
           </button>
         </div>
       )}
@@ -1610,6 +1640,7 @@ function ProbeFeedback({
   result: ModelProbeResult | null;
   error: string | null;
 }) {
+  const { text } = useOnboardingTranslation();
   const matching =
     result?.profile_id === profile.profile_id &&
     result.profile_revision === profile.revision
@@ -1619,20 +1650,22 @@ function ProbeFeedback({
   return (
     <section
       className="probe-result"
-      aria-label={`${profile.name} 版本 ${profile.revision} 测试结果`}
+      aria-label={`${profile.name} ${text("版本")} ${profile.revision} ${text("测试结果")}`}
     >
       <strong>
-        {profile.name} · 版本 {profile.revision} · 连接测试
+        {profile.name} · {text("版本")} {profile.revision} · {text("测试连接")}
       </strong>
       <p>
-        测试目标：{endpointLabel(profile.base_url)} · {profile.model}
+        {text("测试目标")}: {text(endpointLabel(profile.base_url))} ·{" "}
+        {profile.model}
       </p>
-      {error && <p role="alert">{error}</p>}
+      {error && <p role="alert">{text(error)}</p>}
       {matching && (
         <ul>
           {matching.stages.map((stage) => (
             <li key={stage.stage}>
-              {stage.stage}: {probeLabel(stage.code)} · {stage.latency_ms}ms
+              {stage.stage}: {text(probeLabel(stage.code))} · {stage.latency_ms}
+              ms
             </li>
           ))}
         </ul>

memhub/apps/web/src/OnboardingFlow.language.test.tsx

@@ -0,0 +1,425 @@
+// @vitest-environment jsdom
+import type { ImportJob, SourceResponse } from "@one-memory/contracts";
+import {
+  act,
+  cleanup,
+  fireEvent,
+  render,
+  screen,
+  waitFor,
+} from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { afterEach, beforeEach, expect, it, vi } from "vitest";
+import { completeOnboarding } from "./api";
+import { FirstImportReview } from "./FirstImportReview";
+import {
+  LANGUAGE_STORAGE_KEY,
+  LanguageProvider,
+  useGuiLanguage,
+} from "./gui-language";
+import { OnboardingFlow } from "./OnboardingFlow";
+import { OnboardingModelController } from "./OnboardingModelController";
+import { R6ImportProgress } from "./R6ImportProgress";
+import type { ImportSourcesController } from "./use-import-sources";
+
+vi.mock("./api", () => ({
+  completeOnboarding: vi.fn(),
+  getModelProfiles: vi.fn(),
+}));
+const models = {
+  pendingProbe: false,
+  probeStorageFailed: false,
+  pendingCreation: false,
+  creationStorageFailed: false,
+  error: null,
+  create: vi.fn(),
+  update: vi.fn(),
+  probeProfile: vi.fn(),
+  activate: vi.fn(),
+};
+vi.mock("./use-model-profiles", () => ({ useModelProfiles: () => models }));
+const source: SourceResponse = {
+  source_id: "cursor",
+  display_name: "Cursor",
+  available: true,
+  authorized: false,
+  detected: false,
+  storage_kinds: ["jsonl"],
+  root_label: null,
+  candidate_path: "/fixture/cursor",
+  candidate_kind: "default",
+  candidate_root_id: "fixture-root",
+  location_state: "found",
+  imported_messages: 0,
+  imported_conversations: 0,
+  sync_enabled: false,
+  sync_completeness: "additions_only",
+  capabilities: {
+    historical_import: "implemented",
+    incremental_import: "implemented",
+    live_sync: "not_implemented",
+    recall: "not_implemented",
+    installer: "not_implemented",
+    verification: "fixture_only",
+  },
+};
+function controller(overrides: Partial<SourceResponse> = {}) {
+  const sources = [{ ...source, ...overrides }];
+  return {
+    sources,
+    jobs: [],
+    loading: false,
+    refresh: vi.fn().mockResolvedValue({ sources, jobs: [], health: null }),
+    connectForOnboarding: vi.fn(),
+    detect: vi.fn(),
+  } as unknown as ImportSourcesController;
+}
+function SwitchLanguage() {
+  const { setPreference } = useGuiLanguage();
+  return (
+    <button type="button" onClick={() => void setPreference("zh-CN")}>
+      中文
+    </button>
+  );
+}
+const state = {
+  status: "not_started" as const,
+  selected_source_ids: [],
+  started_at: null,
+  completed_at: null,
+};
+beforeEach(() => {
+  delete window.oneMemory;
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  vi.clearAllMocks();
+});
+afterEach(() => {
+  cleanup();
+  localStorage.clear();
+  delete window.oneMemory;
+});
+
+it("changes the first-screen language without losing source choices or starting an import", async () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "zh-CN");
+  const imports = controller();
+  const finish = vi.fn();
+  const user = userEvent.setup();
+  render(
+    <LanguageProvider>
+      <OnboardingFlow state={state} imports={imports} onFinish={finish} />
+    </LanguageProvider>,
+  );
+  const selector = screen.getByRole("combobox", { name: "界面语言" });
+  await waitFor(() =>
+    expect(screen.getByLabelText("导入 Cursor 历史")).toHaveProperty(
+      "checked",
+      true,
+    ),
+  );
+  await user.click(screen.getByLabelText("导入 Cursor 历史"));
+  await user.selectOptions(selector, "es");
+  expect(screen.getByRole("combobox", { name: "Idioma de la interfaz" })).toBe(
+    selector,
+  );
+  expect(
+    screen.getByLabelText("Importar el historial de Cursor"),
+  ).toHaveProperty("checked", false);
+  await user.click(screen.getByLabelText("Importar el historial de Cursor"));
+  await user.selectOptions(selector, "zh-CN");
+  expect(screen.getByLabelText("导入 Cursor 历史")).toHaveProperty(
+    "checked",
+    true,
+  );
+  expect(imports.refresh).toHaveBeenCalledOnce();
+  expect(imports.connectForOnboarding).not.toHaveBeenCalled();
+  expect(imports.detect).not.toHaveBeenCalled();
+  expect(completeOnboarding).not.toHaveBeenCalled();
+  expect(finish).not.toHaveBeenCalled();
+});
+
+it("translates discovery, progress and privacy without importing or authorizing on language changes", async () => {
+  const imports = controller();
+  render(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <OnboardingFlow state={state} imports={imports} onFinish={vi.fn()} />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByRole("heading", {
+      name: "Trae aquí el contexto que ya tienes",
+    }),
+  ).toBeTruthy();
+  await waitFor(() =>
+    expect(
+      screen.getByLabelText<HTMLInputElement>("Importar el historial de Cursor")
+        .checked,
+    ).toBe(true),
+  );
+  expect(
+    screen.getByRole("navigation", {
+      name: "Progreso de la configuración inicial",
+    }),
+  ).toBeTruthy();
+  expect(
+    screen.getByText(
+      "Antes de confirmar, solo se comprueba la información de las aplicaciones. No se leen conversaciones ni se instalan conexiones.",
+    ),
+  ).toBeTruthy();
+  expect(
+    screen.getByText("/fixture/cursor · Ubicación predeterminada"),
+  ).toBeTruthy();
+  fireEvent.click(screen.getByText("中文"));
+  await screen.findByRole("heading", { name: "把熟悉的背景，带到这里" });
+  expect(
+    screen.getByLabelText<HTMLInputElement>("导入 Cursor 历史").checked,
+  ).toBe(true);
+  expect(imports.refresh).toHaveBeenCalledTimes(1);
+  expect(imports.connectForOnboarding).not.toHaveBeenCalled();
+  expect(imports.detect).not.toHaveBeenCalled();
+});
+it("translates stored discovery errors live without repeating discovery", async () => {
+  const imports = controller();
+  vi.mocked(imports.refresh).mockRejectedValue(new Error("fixture-offline"));
+  render(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <OnboardingFlow state={state} imports={imports} onFinish={vi.fn()} />
+    </LanguageProvider>,
+  );
+  await waitFor(() =>
+    expect(screen.getByRole("alert").textContent).toContain(
+      "No se completó la detección",
+    ),
+  );
+  fireEvent.click(screen.getByText("中文"));
+  await waitFor(() =>
+    expect(screen.getByRole("alert").textContent).toContain("位置检测未完成"),
+  );
+  expect(imports.refresh).toHaveBeenCalledTimes(1);
+});
+it("translates custom-location consent without granting access", async () => {
+  const imports = controller({ candidate_kind: "environment_override" });
+  render(
+    <LanguageProvider>
+      <OnboardingFlow state={state} imports={imports} onFinish={vi.fn()} />
+    </LanguageProvider>,
+  );
+  await waitFor(() =>
+    expect(
+      screen.getByLabelText("Importar el historial de Cursor"),
+    ).toHaveProperty("disabled", false),
+  );
+  fireEvent.click(screen.getByLabelText("Importar el historial de Cursor"));
+  expect(
+    screen.getByRole("dialog", { name: "Confirmar ubicación personalizada" }),
+  ).toBeTruthy();
+  expect(
+    screen.getByLabelText(
+      "Confirmo que esta es la ubicación del historial de Cursor",
+    ),
+  ).toBeTruthy();
+  fireEvent.click(screen.getByRole("button", { name: "Cancelar" }));
+  expect(imports.connectForOnboarding).not.toHaveBeenCalled();
+});
+it("translates import review and preserves independent permission disclosure", async () => {
+  const change = vi.fn();
+  render(
+    <LanguageProvider>
+      <FirstImportReview
+        sources={[{ ...source, authorized: true }]}
+        sourceIds={[source.source_id]}
+        jobs={[]}
+        onContinue={change}
+      />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByRole("heading", {
+      name: "Tus conversaciones llegan; tus memorias empiezan aquí",
+    }),
+  ).toBeTruthy();
+  expect(
+    screen.getByText(
+      "Importar no concede automáticamente acceso de lectura a las aplicaciones. Las memorias comenzarán a generarse cuando configures un modelo.",
+    ),
+  ).toBeTruthy();
+  expect(
+    screen.getByRole("region", {
+      name: "Progreso de importación de las aplicaciones",
+    }),
+  ).toBeTruthy();
+  expect(change).not.toHaveBeenCalled();
+});
+it("uses compact Spanish actions and preserves Chinese copy and permissions", async () => {
+  const next = vi.fn();
+  const draft = vi.fn();
+  render(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <FirstImportReview
+        sources={[{ ...source, authorized: true }]}
+        sourceIds={[source.source_id]}
+        jobs={[]}
+        connectionDraft={{ hostSourceIds: [] }}
+        onConnectionDraftChange={draft}
+        onContinue={next}
+      />
+    </LanguageProvider>,
+  );
+  const navigation = screen.getByRole("navigation");
+  expect(navigation.textContent).toContain("Conectar apps");
+  expect(
+    screen.getByRole("button", { name: "Configurar modelo" }),
+  ).toBeTruthy();
+  expect(screen.getByText(/Importar no concede automáticamente/)).toBeTruthy();
+  expect(
+    screen.getByText(/Solo para las apps seleccionadas y compatibles/),
+  ).toBeTruthy();
+  expect(screen.getByText(/Si una falla, las demás siguen/)).toBeTruthy();
+  fireEvent.click(screen.getByText("中文"));
+  expect(
+    screen.getByRole("button", { name: "配置模型，沉淀记忆" }),
+  ).toBeTruthy();
+  expect(navigation.textContent).toContain("连接应用");
+  expect(screen.getByText(/不会自动开放应用读取权限/)).toBeTruthy();
+  expect(next).not.toHaveBeenCalled();
+  expect(draft).not.toHaveBeenCalled();
+});
+it.each([
+  ["pending", "Importando"],
+  ["running", "Importando"],
+  ["paused", "En pausa"],
+  ["interrupted", "Interrumpida"],
+  ["failed", "Problema de importación"],
+  ["cancelled", "Cancelada"],
+  ["completed", "Guardada"],
+] as const)(
+  "translates %s progress receipts without changing counts",
+  async (status, label) => {
+    const job = {
+      job_id: "fixture-job",
+      source_id: "cursor",
+      status,
+      stored: 17,
+      errors: 2,
+      created_at: "2026-01-01T00:00:00Z",
+      updated_at: "2026-01-01T00:01:00Z",
+    } as ImportJob;
+    render(
+      <LanguageProvider>
+        <R6ImportProgress
+          sourceIds={["cursor"]}
+          sources={[{ ...source, authorized: true }]}
+          jobs={[job]}
+        />
+      </LanguageProvider>,
+    );
+    expect(
+      await screen.findByRole("article", {
+        name: "Progreso de importación de Cursor",
+      }),
+    ).toBeTruthy();
+    expect(screen.getByText("Mensajes guardados: 17")).toBeTruthy();
+    expect(screen.getByRole("status").textContent).toBe(
+      `${label} · Errores de lectura: 2`,
+    );
+  },
+);
+it.each(["es", "zh-CN"] as const)(
+  "preserves three multiline progress cards and receipt statuses in %s",
+  (locale) => {
+    localStorage.setItem(LANGUAGE_STORAGE_KEY, locale);
+    const sources = ["cursor", "claude-code", "codex"].map((id, i) => ({
+      ...source,
+      source_id: id,
+      display_name: `${locale === "es" ? "Aplicación con nombre largo" : "名称较长的应用"} ${i + 1}`,
+      authorized: true,
+    }));
+    const jobs = sources.map((item, i) => ({
+      job_id: `fixture-${i}`,
+      source_id: item.source_id,
+      status: ["completed", "failed", "paused"][i],
+      stored: 12345,
+      errors: i,
+      created_at: "2026-01-01T00:00:00Z",
+      updated_at: "2026-01-01T00:01:00Z",
+    })) as ImportJob[];
+    render(
+      <LanguageProvider>
+        <R6ImportProgress
+          sourceIds={sources.map((item) => item.source_id)}
+          sources={sources}
+          jobs={jobs}
+        />
+      </LanguageProvider>,
+    );
+    expect(screen.getAllByRole("article")).toHaveLength(3);
+    const statuses = screen
+      .getAllByRole("status")
+      .map((item) => item.textContent);
+    expect(statuses).toEqual(
+      locale === "es"
+        ? [
+            "Guardada",
+            "Problema de importación · Errores de lectura: 1",
+            "En pausa · Errores de lectura: 2",
+          ]
+        : ["已保存", "导入遇到问题 · 1 条读取异常", "已暂停 · 2 条读取异常"],
+    );
+  },
+);
+it("translates completion recovery live without repeating completion writes", async () => {
+  vi.mocked(completeOnboarding).mockRejectedValueOnce(
+    new Error("fixture-offline"),
+  );
+  const imports = controller();
+  const finish = vi.fn();
+  render(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <OnboardingFlow state={state} imports={imports} onFinish={finish} />
+    </LanguageProvider>,
+  );
+  await waitFor(() =>
+    expect(
+      screen.getByRole("button", { name: "Entrar y añadir más tarde" }),
+    ).toHaveProperty("disabled", false),
+  );
+  fireEvent.click(
+    screen.getByRole("button", { name: "Entrar y añadir más tarde" }),
+  );
+  expect(
+    await screen.findByRole("button", { name: "Reintentar guardar y entrar" }),
+  ).toBeTruthy();
+  expect(screen.getByRole("alert").textContent).toContain(
+    "aún no está confirmada",
+  );
+  fireEvent.click(screen.getByText("中文"));
+  expect(
+    await screen.findByRole("button", { name: "重试保存并进入" }),
+  ).toBeTruthy();
+  expect(completeOnboarding).toHaveBeenCalledTimes(1);
+  expect(finish).not.toHaveBeenCalled();
+});
+it("translates model configuration, validation and advanced fields without activating permissions", async () => {
+  render(
+    <LanguageProvider>
+      <SwitchLanguage />
+      <OnboardingModelController sourceNames={["Cursor"]} onBack={vi.fn()} />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByRole("heading", {
+      name: "Elige un modelo para crear memorias",
+    }),
+  ).toBeTruthy();
+  fireEvent.click(screen.getByRole("button", { name: "Probar conexión" }));
+  expect(await screen.findByText("Introduce una API Key.")).toBeTruthy();
+  expect(screen.getByLabelText("Tiempo de espera (segundos)")).toBeTruthy();
+  expect(models.create).not.toHaveBeenCalled();
+  expect(models.activate).not.toHaveBeenCalled();
+  await act(async () => fireEvent.click(screen.getByText("中文")));
+  expect(screen.getByText("请填写 API Key。")).toBeTruthy();
+  expect(screen.getByLabelText("超时（秒）")).toBeTruthy();
+});

memhub/apps/web/src/OnboardingFlow.tsx

@@ -29,6 +29,7 @@ import {
   hostWriteReason,
 } from "./host-state";
 import { OnboardingModelController } from "./OnboardingModelController";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { R6ColdStartFrame } from "./R6ColdStartFrame";
 import { R6Button } from "./R6Controls";
 import { traceUiAction } from "./ui-trace";
@@ -63,6 +64,7 @@ export function OnboardingFlow({
   imports: ImportSourcesController;
   onFinish(destination: OnboardingDestination): void;
 }) {
+  const { text, t } = useOnboardingTranslation();
   const [sources, setSources] = useState(imports.sources);
   const sourceGeneration = useRef({ value: imports.sources, epoch: 0 });
   if (sourceGeneration.current.value !== imports.sources) {
@@ -99,7 +101,21 @@ export function OnboardingFlow({
     "idle" | "applying" | "applied" | "partial" | "failed"
   >("idle");
   const [applyTick, setApplyTick] = useState(0);
-  const [connectionNote, setConnectionNote] = useState("");
+  const [connectionNote, setConnectionNote] = useState<
+    string | { success: number; failures: [string, string | null][] }
+  >("");
+  const renderedConnectionNote =
+    typeof connectionNote === "string"
+      ? text(connectionNote)
+      : t("onboardingConnectionPartial", {
+          success: connectionNote.success,
+          failed: connectionNote.failures.length,
+          names: connectionNote.failures
+            .map(([name, reason]) =>
+              reason ? `${name}（${text(reason)}）` : name,
+            )
+            .join("、"),
+        });
   const flight = useRef(false);
   const connectionAttempt = useRef<string | null>(null);
   const connectionQueue = useRef(Promise.resolve());
@@ -244,12 +260,10 @@ export function OnboardingFlow({
         }
         if (failed.size && alive.current) {
           connectionQueueFailed.current = true;
-          const names = [...failed].map(([name, reason]) =>
-            reason ? `${name}（${reason}）` : name,
-          );
-          setConnectionNote(
-            `${apps.size - failed.size} 个应用已接入，${failed.size} 个未完成：${names.join("、")}。可进入应用后单独处理。`,
-          );
+          setConnectionNote({
+            success: apps.size - failed.size,
+            failures: [...failed],
+          });
         }
         try {
           await refreshImports();
@@ -637,7 +651,7 @@ export function OnboardingFlow({
             }}
             connectionExecutionAvailable={connectionAvailable}
             hostConnectionAvailable={hostConnectionAvailable}
-            connectionNote={connectionNote}
+            connectionNote={renderedConnectionNote}
             acceptedJobIds={accepted?.jobs.map((job) => job.job_id)}
             onChangeJob={imports.changeJob}
             sourceIds={sourceIds}
@@ -646,7 +660,7 @@ export function OnboardingFlow({
             failedSources={accepted?.failed_sources}
             sourceSnapshot={imports.sourceSnapshot}
             busy={busy === "leaving"}
-            error={error}
+            error={error && text(error)}
             onContinue={(destination) => {
               if (busy === "leaving") return;
               const selection = {
@@ -710,8 +724,8 @@ export function OnboardingFlow({
     return (
       <R6ColdStartFrame
         step={1}
-        title="把熟悉的背景，带到这里"
-        eyebrow="你的记忆，从这里接上"
+        title={text("把熟悉的背景，带到这里")}
+        eyebrow={text("你的记忆，从这里接上")}
         footer={
           <>
             <R6Button
@@ -719,20 +733,22 @@ export function OnboardingFlow({
               disabled={busy !== null}
               onClick={() => finishOnce(exitDestination)}
             >
-              {exitDestination === "sources" ? "仍进入应用页" : "仍进入工作台"}
+              {text(
+                exitDestination === "sources" ? "仍进入应用页" : "仍进入工作台",
+              )}
             </R6Button>
             <R6Button
               variant="primary"
               disabled={busy !== null}
               onClick={() => void leave(exitDestination)}
             >
-              重试保存并进入
+              {text("重试保存并进入")}
             </R6Button>
           </>
         }
       >
         <p className="onboarding-r6-error" role="alert">
-          {error}
+          {error && text(error)}
         </p>
       </R6ColdStartFrame>
     );
@@ -740,8 +756,8 @@ export function OnboardingFlow({
   return (
     <R6ColdStartFrame
       step={1}
-      title="把熟悉的背景，带到这里"
-      eyebrow="你的记忆，从这里接上"
+      title={text("把熟悉的背景，带到这里")}
+      eyebrow={text("你的记忆，从这里接上")}
       footer={
         <>
           <R6Button
@@ -749,11 +765,11 @@ export function OnboardingFlow({
             disabled={locked}
             onClick={() => void leave("sources")}
           >
-            稍后添加，先进入
+            {text("稍后添加，先进入")}
           </R6Button>
           {error && (
             <p className="onboarding-r6-error" role="alert">
-              {error}
+              {error && text(error)}
             </p>
           )}
           <R6Button
@@ -762,7 +778,7 @@ export function OnboardingFlow({
             disabled={locked || count === 0}
             onClick={() => void startImport()}
           >
-            {busy === "submitting" ? "正在开始导入…" : "开始导入"}
+            {text(busy === "submitting" ? "正在开始导入…" : "开始导入")}
           </R6Button>
         </>
       }
@@ -773,33 +789,35 @@ export function OnboardingFlow({
           aria-labelledby="cold-start-phase"
         >
           <div className="onboarding-r6-intro">
-            <p>不用从头介绍自己。从常用的 App 开始，把已有背景带过来。</p>
-            <p>确认前只检查应用信息，不读取对话，也不安装连接。</p>
+            <p>
+              {text("不用从头介绍自己。从常用的 App 开始，把已有背景带过来。")}
+            </p>
+            <p>{text("确认前只检查应用信息，不读取对话，也不安装连接。")}</p>
           </div>
           <div className="onboarding-r6-list-heading">
             <h2 id="cold-start-phase" ref={heading} tabIndex={-1}>
-              本机 AI 应用
+              {text("本机 AI 应用")}
             </h2>
             <button
               type="button"
               className="onboarding-r6-quiet"
-              aria-label="重新检测位置"
+              aria-label={text("重新检测位置")}
               disabled={locked}
               onClick={() => void checkLocations()}
             >
-              {busy === "checking" ? "检测中…" : "重新检测"}
+              {text(busy === "checking" ? "检测中…" : "重新检测")}
             </button>
           </div>
           <SourceList
             className="onboarding-r6-list"
-            aria-label="候选应用"
+            aria-label={text("候选应用")}
             aria-busy={busy === "checking"}
             count={visibleApps.length}
             status={
               locationCheck === "checking"
-                ? "正在检测其他应用…"
+                ? text("正在检测其他应用…")
                 : locationCheck === "failed"
-                  ? "检测未完成"
+                  ? text("检测未完成")
                   : undefined
             }
             selection={
@@ -809,7 +827,7 @@ export function OnboardingFlow({
                 disabled={locked || allSelected || readableApps.length === 0}
                 onClick={selectAllSources}
               >
-                {allSelected ? "已全选" : "全选"}
+                {text(allSelected ? "已全选" : "全选")}
               </button>
             }
           >
@@ -818,7 +836,9 @@ export function OnboardingFlow({
                 <label>
                   <input
                     type="checkbox"
-                    aria-label={`导入 ${visibleApps[0].display_name} 历史`}
+                    aria-label={t("onboardingImportHistory", {
+                      name: visibleApps[0].display_name,
+                    })}
                     checked
                     disabled
                     readOnly
@@ -826,11 +846,11 @@ export function OnboardingFlow({
                   <R6SourceIcon id={visibleApps[0].source_id} />
                   <span className="onboarding-r6-row-info">
                     <strong>{visibleApps[0].display_name}</strong>
-                    <small>正在核对本机保存位置</small>
+                    <small>{text("正在核对本机保存位置")}</small>
                   </span>
                   <span className="onboarding-r6-badge" data-found="true">
                     <i aria-hidden="true" />
-                    已发现
+                    {text("已发现")}
                   </span>
                 </label>
               </li>
@@ -842,6 +862,7 @@ export function OnboardingFlow({
                 );
                 const note =
                   locationCheck === "ready" ? locationNote(item) : null;
+                const translatedNote = note ? text(note) : null;
                 return (
                   <li
                     className={`onboarding-r6-row${checked ? " is-selected" : ""}`}
@@ -853,7 +874,9 @@ export function OnboardingFlow({
                     <label>
                       <input
                         type="checkbox"
-                        aria-label={`导入 ${item.display_name} 历史`}
+                        aria-label={t("onboardingImportHistory", {
+                          name: item.display_name,
+                        })}
                         checked={checked}
                         disabled={
                           locked || locationCheck !== "ready" || !canRead(item)
@@ -865,13 +888,13 @@ export function OnboardingFlow({
                       <R6SourceIcon id={item.source_id} />
                       <span className="onboarding-r6-row-info">
                         <strong>{item.display_name}</strong>
-                        <small title={note ?? item.candidate_path}>
-                          {item.candidate_path || "位置待核对"} ·{" "}
-                          {pathKind(item)}
+                        <small title={translatedNote ?? item.candidate_path}>
+                          {item.candidate_path || text("位置待核对")} ·{" "}
+                          {text(pathKind(item))}
                         </small>
                         {itemErrors[item.source_id] && (
                           <small className="onboarding-r6-error">
-                            {failureLabel(itemErrors[item.source_id])}
+                            {failureLabel(itemErrors[item.source_id], text, t)}
                           </small>
                         )}
                       </span>
@@ -881,10 +904,10 @@ export function OnboardingFlow({
                           locationCheck === "ready" &&
                           item.location_state === "found"
                         }
-                        title={note ?? undefined}
+                        title={translatedNote ?? undefined}
                       >
                         <i aria-hidden="true" />
-                        {locationLabel(item, locationCheck)}
+                        {text(locationLabel(item, locationCheck))}
                       </span>
                     </label>
                   </li>
@@ -907,28 +930,30 @@ export function OnboardingFlow({
             {!visibleApps.length && busy !== "checking" && (
               <li className="onboarding-r6-empty">
                 {locationCheck === "ready"
-                  ? "当前没有候选来源。可以稍后在应用页添加历史包。"
-                  : "候选来源尚未加载。可以检测位置，或先进入工作台。"}
+                  ? text("当前没有候选来源。可以稍后在应用页添加历史包。")
+                  : text("候选来源尚未加载。可以检测位置，或先进入工作台。")}
               </li>
             )}
           </SourceList>
         </section>
-        <aside className="onboarding-r6-summary" aria-label="本次导入">
-          <p>本次导入</p>
+        <aside className="onboarding-r6-summary" aria-label={text("本次导入")}>
+          <p>{text("本次导入")}</p>
           <p
             className="onboarding-r6-count"
             aria-live="polite"
             data-unknown={locationCheck !== "ready"}
           >
-            {summaryCount}
+            {text(summaryCount)}
           </p>
-          <p>个 App 的历史对话</p>
+          <p>{text("个 App 的历史对话")}</p>
           <h2>
-            把零散的会话，
+            {text("把零散的会话，")}
             <br />
-            汇成完整的记忆
+            {text("汇成完整的记忆")}
           </h2>
-          <p className="onboarding-r6-signoff">少一些重复交代，多一些理解。</p>
+          <p className="onboarding-r6-signoff">
+            {text("少一些重复交代，多一些理解。")}
+          </p>
         </aside>
       </div>
       {custom && (
@@ -966,6 +991,7 @@ function SourceList({
   status?: string;
   selection: ReactNode;
 }) {
+  const { t } = useOnboardingTranslation();
   const list = useRef<HTMLUListElement>(null);
   const [more, setMore] = useState(0);
   const measure = useCallback(() => {
@@ -1014,9 +1040,9 @@ function SourceList({
         <span data-scroll-hint={!status && more > 0 ? "true" : "false"}>
           {status ??
             (more > 0
-              ? `向下查看更多 · 还有 ${more} 个应用`
+              ? t("onboardingMoreApps", { count: more })
               : count > 3
-                ? `已显示全部 ${count} 个应用`
+                ? t("onboardingAllApps", { count })
                 : "")}
         </span>
         {selection}
@@ -1114,7 +1140,11 @@ function locationNote(source: SourceResponse) {
   return null;
 }
 
-function failureLabel(reason: string) {
+function failureLabel(
+  reason: string,
+  text: (value: string) => string,
+  t: ReturnType<typeof useOnboardingTranslation>["t"],
+) {
   const labels: Record<string, string> = {
     source_unavailable: "来源目录暂时不可读取，请核对位置和权限。",
     source_not_available: "来源目录暂时不可读取，请核对位置和权限。",
@@ -1124,7 +1154,9 @@ function failureLabel(reason: string) {
     environment_override_confirmation_required: "自定义来源位置需要重新确认。",
     imports_disabled: "当前 Core 未启用历史导入。",
   };
-  return labels[reason] ?? `尚未获准导入（${reason}）。请核对来源后重试。`;
+  return labels[reason]
+    ? text(labels[reason])
+    : t("onboardingImportRefused", { reason });
 }
 
 // S1.3 supplied app marks; WorkBuddy keeps the source geometry with flat fills.
@@ -1149,6 +1181,7 @@ function CustomLocationDialog({
   onCancel(): void;
   onConfirm(): void;
 }) {
+  const { text, t } = useOnboardingTranslation();
   const [confirmed, setConfirmed] = useState(false);
   const panel = useRef<HTMLDivElement>(null);
   useLayoutEffect(() => {
@@ -1233,12 +1266,12 @@ function CustomLocationDialog({
         tabIndex={-1}
       >
         <header>
-          <h2 id="cold-start-custom-title">确认自定义位置</h2>
+          <h2 id="cold-start-custom-title">{text("确认自定义位置")}</h2>
           <button
             type="button"
             className="cold-start-icon-button"
-            aria-label="关闭位置确认"
-            title="关闭位置确认"
+            aria-label={text("关闭位置确认")}
+            title={text("关闭位置确认")}
             onClick={onCancel}
           >
             <X size={18} aria-hidden="true" />
@@ -1246,7 +1279,9 @@ function CustomLocationDialog({
         </header>
         <div className="cold-start-dialog-body">
           <p id="cold-start-custom-description">
-            此位置来自当前配置，并非应用默认目录。确认位置不会开始读取历史。
+            {text(
+              "此位置来自当前配置，并非应用默认目录。确认位置不会开始读取历史。",
+            )}
           </p>
           <strong>{source.display_name}</strong>
           <code>{source.candidate_path}</code>
@@ -1256,7 +1291,9 @@ function CustomLocationDialog({
               checked={confirmed}
               onChange={(event) => setConfirmed(event.target.checked)}
             />
-            <span>确认这是 {source.display_name} 的历史位置</span>
+            <span>
+              {t("onboardingConfirmHistory", { name: source.display_name })}
+            </span>
           </label>
         </div>
         <footer>
@@ -1265,7 +1302,7 @@ function CustomLocationDialog({
             className="cold-start-secondary"
             onClick={onCancel}
           >
-            取消
+            {text("取消")}
           </button>
           <button
             type="button"
@@ -1275,7 +1312,7 @@ function CustomLocationDialog({
             }}
           >
             <Check size={16} aria-hidden="true" />
-            确认此位置
+            {text("确认此位置")}
           </button>
         </footer>
       </div>

memhub/apps/web/src/OnboardingModelController.tsx

@@ -9,6 +9,7 @@ import {
   type OnboardingModelDraft,
   OnboardingModelStep,
 } from "./OnboardingModelStep";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { PROVIDER_PRESETS } from "./provider-presets";
 import { traceUiAction } from "./ui-trace";
 import { useModelProfiles } from "./use-model-profiles";
@@ -65,6 +66,7 @@ export function OnboardingModelController({
   onEnabled?(): void;
   connectionAlreadyApplied?: boolean;
 }) {
+  const { text, t } = useOnboardingTranslation();
   const models = useModelProfiles();
   const [draft, setDraft] = useState(initial);
   const [advanced, setAdvanced] = useState(false);
@@ -119,7 +121,7 @@ export function OnboardingModelController({
         value < min ||
         value > max
       )
-        next[key] = `请输入 ${min} 至 ${max} 的整数。`;
+        next[key] = "onboardingIntegerRange";
       return value;
     };
     const timeout = integer("timeout_seconds", 1, 600);
@@ -269,8 +271,22 @@ export function OnboardingModelController({
       canTest={!models.pendingProbe && !models.probeStorageFailed}
       canSaveDraft={!models.pendingCreation && !models.creationStorageFailed}
       inputsLocked={flight.current}
-      fieldErrors={fields}
-      error={error ?? models.error}
+      fieldErrors={Object.fromEntries(
+        Object.entries(fields).map(([key, value]) => [
+          key,
+          value === "onboardingIntegerRange"
+            ? t(
+                "onboardingIntegerRange",
+                key === "timeout_seconds"
+                  ? { min: 1, max: 600 }
+                  : key === "max_concurrency"
+                    ? { min: 1, max: 32 }
+                    : { min: 1024, max: 10_000_000 },
+              )
+            : text(value),
+        ]),
+      )}
+      error={error ?? (models.error ? text(models.error) : null)}
       probe={probe}
       profile={
         saved

memhub/apps/web/src/OnboardingModelStep.test.tsx

@@ -9,12 +9,93 @@ import {
   within,
 } from "@testing-library/react";
 import { afterEach, expect, it, vi } from "vitest";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
 import {
   OnboardingModelStep,
   type OnboardingModelStepProps,
 } from "./OnboardingModelStep";
 
-afterEach(cleanup);
+afterEach(() => {
+  cleanup();
+  localStorage.clear();
+});
+
+it.each(["es", "zh-CN"] as const)(
+  "keeps %s footer actions, pending locks and permission boundaries",
+  async (locale) => {
+    localStorage.setItem(LANGUAGE_STORAGE_KEY, locale);
+    const p = props();
+    p.onSkip = vi.fn();
+    let finish!: () => void;
+    p.onTest = vi.fn(
+      () =>
+        new Promise<void>((resolve) => {
+          finish = resolve;
+        }),
+    );
+    const labels =
+      locale === "es"
+        ? [
+            "Omitir por ahora",
+            "Probar conexión",
+            "Confirmar y habilitar",
+            "Probando el modelo…",
+          ]
+        : ["跳过，先进入应用", "测试模型连通性", "确认启用", "正在测试模型…"];
+    const draw = (probe?: OnboardingModelStepProps["probe"]) => (
+      <LanguageProvider>
+        <OnboardingModelStep
+          {...p}
+          capability={{ saveAndEnable: true }}
+          probe={probe}
+          advancedOpen
+        />
+      </LanguageProvider>
+    );
+    const view = render(draw());
+    const skip = screen.getByRole("button", { name: labels[0] });
+    if (locale === "es") {
+      expect(
+        document.getElementById(skip.getAttribute("aria-describedby") ?? "")
+          ?.textContent,
+      ).toContain("Aplicaciones");
+    }
+    fireEvent.click(skip);
+    expect(p.onSkip).toHaveBeenCalledOnce();
+    expect(p.onBack).not.toHaveBeenCalled();
+    expect(screen.getByRole("button", { name: labels[2] })).toHaveProperty(
+      "disabled",
+      true,
+    );
+    fireEvent.click(screen.getByRole("button", { name: labels[1] }));
+    expect(screen.getByRole("button", { name: labels[3] })).toHaveProperty(
+      "disabled",
+      true,
+    );
+    expect(skip).toHaveProperty("disabled", true);
+    expect(p.onSaveAndEnable).not.toHaveBeenCalled();
+    await act(async () => finish());
+    view.rerender(draw({ state: "failed", message: "synthetic failure" }));
+    expect(screen.getByRole("button", { name: labels[2] })).toHaveProperty(
+      "disabled",
+      true,
+    );
+    expect(screen.getByLabelText("API Key")).toHaveProperty("value", "secret");
+    expect(p.onDraftChange).not.toHaveBeenCalled();
+    view.rerender(draw({ state: "passed", message: "synthetic success" }));
+    fireEvent.click(screen.getByRole("button", { name: labels[2] }));
+    await act(async () => {});
+    expect(p.onSaveAndEnable).toHaveBeenCalledOnce();
+    expect(p.onSaveDraft).not.toHaveBeenCalled();
+    expect(
+      screen.getByText(
+        locale === "es"
+          ? /La prueba de conexión solo envía/
+          : /测试连接只发送测试内容/,
+      ),
+    ).toBeTruthy();
+  },
+);
 function props(): OnboardingModelStepProps {
   return {
     draft: {

memhub/apps/web/src/OnboardingModelStep.tsx

@@ -2,6 +2,7 @@ import type { ProviderKind } from "@one-memory/contracts";
 import { ChevronDown, ChevronUp } from "lucide-react";
 import { useEffect, useId, useRef, useState } from "react";
 import { OptionMenu } from "./OptionMenu";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { R6ColdStartFrame } from "./R6ColdStartFrame";
 import { R6Button } from "./R6Controls";
 import "./onboarding-model-r6.css";
@@ -71,6 +72,7 @@ export interface OnboardingModelStepProps {
 }
 
 export function OnboardingModelStep(props: OnboardingModelStepProps) {
+  const { text, t, locale } = useOnboardingTranslation();
   const { draft, advancedOpen, onDraftChange, fieldErrors = {}, phase } = props;
   const id = useId();
   const fields = useRef<HTMLElement>(null);
@@ -113,7 +115,10 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
   const sourceSummary =
     props.sourceNames.length <= 3
       ? props.sourceNames.join(" · ")
-      : `${props.sourceNames.slice(0, 3).join(" · ")} 等 ${props.sourceNames.length} 个应用`;
+      : t("onboardingSourcesSummary", {
+          names: props.sourceNames.slice(0, 3).join(" · "),
+          count: props.sourceNames.length,
+        });
   async function run(action: Action) {
     if (flight.current || locked) return;
     if (action === "save-and-enable" && !canEnable) return;
@@ -153,11 +158,11 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
     const error = fieldErrors[key];
     return (
       <label className="onboarding-model-field" htmlFor={`${id}-${key}`}>
-        <span>{label}</span>
+        <span>{text(label)}</span>
         <input
           id={`${id}-${key}`}
           name={key}
-          aria-label={label}
+          aria-label={text(label)}
           type={options.type ?? "text"}
           autoComplete="off"
           spellCheck={false}
@@ -169,7 +174,9 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
           max={options.max}
           maxLength={options.maxLength}
           required={options.required}
-          placeholder={options.placeholder}
+          placeholder={
+            options.placeholder ? text(options.placeholder) : undefined
+          }
           onChange={(event) => {
             if (!flight.current && !fieldsLocked)
               onDraftChange({ [key]: event.target.value });
@@ -177,7 +184,7 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
         />
         {error && (
           <small id={`${id}-${key}-error`} className="onboarding-model-error">
-            {error}
+            {text(error)}
           </small>
         )}
       </label>
@@ -215,43 +222,57 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
     >
       <R6ColdStartFrame
         step={3}
-        eyebrow="沉淀记忆 · 使用你选择的模型"
-        title={pageTitle}
+        eyebrow={text("沉淀记忆 · 使用你选择的模型")}
+        title={text(pageTitle)}
         footer={
           <>
             <p className="onboarding-model-footer-note">
-              {!props.capability.saveAndEnable
-                ? "当前无法启用模型，已填写内容保留。"
-                : props.probe?.state === "passed"
-                  ? "模型连接测试通过，可以启用并开始沉淀记忆。"
-                  : "先测试模型连通性；测试通过后再启用。"}
+              {text(
+                !props.capability.saveAndEnable
+                  ? "当前无法启用模型，已填写内容保留。"
+                  : props.probe?.state === "passed"
+                    ? "模型连接测试通过，可以启用并开始沉淀记忆。"
+                    : "先测试模型连通性；测试通过后再启用。",
+              )}
             </p>
             <div className="onboarding-model-footer-actions">
+              {locale === "es" && (
+                <span id={`${id}-skip-destination`} hidden>
+                  Omitir y entrar a Aplicaciones
+                </span>
+              )}
               <R6Button
+                aria-describedby={
+                  locale === "es" ? `${id}-skip-destination` : undefined
+                }
                 disabled={locked}
                 onClick={() => {
                   if (!flight.current && !locked)
                     (props.onSkip ?? props.onBack)();
                 }}
               >
-                跳过，先进入应用
+                {text("跳过，先进入应用")}
               </R6Button>
               <R6Button
                 disabled={locked || !props.canTest}
                 onClick={() => void run("test")}
               >
-                {displayedPhase === "testing"
-                  ? "正在测试模型…"
-                  : (props.testActionLabel ?? "测试模型连通性")}
+                {text(
+                  displayedPhase === "testing"
+                    ? "正在测试模型…"
+                    : (props.testActionLabel ?? "测试模型连通性"),
+                )}
               </R6Button>
               <R6Button
                 variant="primary"
                 disabled={locked || !canEnable}
                 onClick={() => void run("save-and-enable")}
               >
-                {displayedPhase === "enabling"
-                  ? "正在启用…"
-                  : (props.enableActionLabel ?? "确认启用")}
+                {text(
+                  displayedPhase === "enabling"
+                    ? "正在启用…"
+                    : (props.enableActionLabel ?? "确认启用"),
+                )}
               </R6Button>
             </div>
           </>
@@ -260,27 +281,29 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
         <div className="onboarding-model-layout">
           <section
             className="onboarding-model-form"
-            aria-label="模型配置"
+            aria-label={text("模型配置")}
             data-advanced={advancedOpen}
           >
             <section
               ref={fields}
               id={`${id}-fields`}
               className="onboarding-model-fields"
-              aria-label="模型参数"
+              aria-label={text("模型参数")}
               // biome-ignore lint/a11y/noNoninteractiveTabindex: The parameter pane needs keyboard scrolling.
               tabIndex={0}
             >
               {!advancedOpen ? (
                 <>
                   <p className="onboarding-model-intro">
-                    选择服务商，填入 API Key。核对已有配置后再继续。
+                    {text("选择服务商，填入 API Key。核对已有配置后再继续。")}
                   </p>
                   <label
                     className="onboarding-model-field onboarding-model-provider"
                     htmlFor={`${id}-provider`}
                   >
-                    <span id={`${id}-provider-label`}>模型服务商</span>
+                    <span id={`${id}-provider-label`}>
+                      {text("模型服务商")}
+                    </span>
                     <OptionMenu
                       id={`${id}-provider`}
                       labelledBy={`${id}-provider-label`}
@@ -288,11 +311,11 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                       disabled={fieldsLocked}
                       options={[
                         ...(!provider
-                          ? [{ value: "", label: "选择服务商" }]
+                          ? [{ value: "", label: text("选择服务商") }]
                           : []),
                         ...props.providers.map((item) => ({
                           value: item.id,
-                          label: item.label,
+                          label: text(item.label),
                           disabled: !item.supported,
                         })),
                       ]}
@@ -317,13 +340,15 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                     className="onboarding-model-key-note"
                     data-state={connectionFailed ? "failed" : "idle"}
                   >
-                    {connectionFailed
-                      ? "连接未通过，请检查 API Key、模型与接口地址后重试。配置已保留。"
-                      : props.profile?.credential_state === "unavailable"
-                        ? "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”。"
-                        : props.profile?.has_configured_api_key
-                          ? "留空保留已保存密钥；填写新密钥后需重新测试。"
-                          : "密钥保存在系统安全存储中，不写入对话或日志。"}
+                    {text(
+                      connectionFailed
+                        ? "连接未通过，请检查 API Key、模型与接口地址后重试。配置已保留。"
+                        : props.profile?.credential_state === "unavailable"
+                          ? "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”。"
+                          : props.profile?.has_configured_api_key
+                            ? "留空保留已保存密钥；填写新密钥后需重新测试。"
+                            : "密钥保存在系统安全存储中，不写入对话或日志。",
+                    )}
                   </p>
                   <button
                     ref={advancedToggle}
@@ -334,24 +359,27 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                     disabled={fieldsLocked}
                     onClick={() => changeAdvanced(true)}
                   >
-                    配置详情与高级设置{" "}
+                    {text("配置详情与高级设置")}{" "}
                     <ChevronDown size={16} aria-hidden="true" />
                   </button>
                   <p className="onboarding-model-profile">
-                    {provider?.label ?? "服务商待选择"} ·{" "}
-                    {draft.model || "模型待填写"}
+                    {provider ? text(provider.label) : text("服务商待选择")} ·{" "}
+                    {draft.model || text("模型待填写")}
                     <br />
-                    {safeEndpoint(draft.base_url)} ·{" "}
+                    {text(safeEndpoint(draft.base_url))} ·{" "}
                     {draft.embedding_mode === "local"
-                      ? "本地向量模型"
-                      : draft.embedding_model || "向量模型待填写"}{" "}
-                    · {draft.disable_thinking ? "思考已关闭" : "思考未关闭"}
+                      ? text("本地向量模型")
+                      : draft.embedding_model || text("向量模型待填写")}{" "}
+                    ·{" "}
+                    {text(draft.disable_thinking ? "思考已关闭" : "思考未关闭")}
                   </p>
                 </>
               ) : (
                 <>
                   <div className="onboarding-model-advanced-head">
-                    <p>预设已填好，只有自定义服务或特殊需求才需要修改。</p>
+                    <p>
+                      {text("预设已填好，只有自定义服务或特殊需求才需要修改。")}
+                    </p>
                     <button
                       ref={advancedToggle}
                       type="button"
@@ -361,7 +389,8 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                       disabled={fieldsLocked}
                       onClick={() => changeAdvanced(false)}
                     >
-                      返回服务商选择 <ChevronUp size={16} aria-hidden="true" />
+                      {text("返回服务商选择")}{" "}
+                      <ChevronUp size={16} aria-hidden="true" />
                     </button>
                   </div>
                   <div className="onboarding-model-advanced-grid">
@@ -390,15 +419,17 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                         className="onboarding-model-key-note"
                         data-state={connectionFailed ? "failed" : "idle"}
                       >
-                        {props.profile?.has_configured_api_key
-                          ? "留空保留已保存密钥；填写新密钥后需重新测试。"
-                          : "密钥保存在系统安全存储中，不写入对话或日志。"}
+                        {text(
+                          props.profile?.has_configured_api_key
+                            ? "留空保留已保存密钥；填写新密钥后需重新测试。"
+                            : "密钥保存在系统安全存储中，不写入对话或日志。",
+                        )}
                       </p>
                     </div>
                     <label className="onboarding-model-field">
-                      <span>协议</span>
+                      <span>{text("协议")}</span>
                       <select
-                        aria-label="协议"
+                        aria-label={text("协议")}
                         value={draft.provider_kind}
                         disabled={fieldsLocked}
                         onChange={(e) => {
@@ -413,17 +444,17 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                         </option>
                         <option value="ollama">Ollama</option>
                         <option value="anthropic" disabled>
-                          Anthropic（暂不支持）
+                          {text("Anthropic（暂不支持）")}
                         </option>
                         <option value="hy_default" disabled>
-                          HY 托管（当前不可用）
+                          {text("HY 托管（当前不可用）")}
                         </option>
                       </select>
                     </label>
                     <label className="onboarding-model-field">
-                      <span>向量模型</span>
+                      <span>{text("向量模型")}</span>
                       <select
-                        aria-label="向量模型"
+                        aria-label={text("向量模型")}
                         value={draft.embedding_mode}
                         disabled={fieldsLocked}
                         onChange={(e) => {
@@ -435,8 +466,10 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                             });
                         }}
                       >
-                        <option value="local">本地 ONNX · 内置</option>
-                        <option value="custom">自定义向量</option>
+                        <option value="local">
+                          {text("本地 ONNX · 内置")}
+                        </option>
+                        <option value="custom">{text("自定义向量")}</option>
                       </select>
                     </label>
                     <div className="onboarding-model-numbers">
@@ -469,12 +502,14 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                             });
                         }}
                       />
-                      关闭思考模式
+                      {text("关闭思考模式")}
                     </label>
                     <p className="onboarding-model-vector-note">
-                      自定义向量配置可展开；远程向量服务须遵守凭据边界。
+                      {text(
+                        "自定义向量配置可展开；远程向量服务须遵守凭据边界。",
+                      )}
                       <br />
-                      切换服务商或模型后，需要重新测试并启用。
+                      {text("切换服务商或模型后，需要重新测试并启用。")}
                     </p>
                     {draft.embedding_mode === "custom" && (
                       <>
@@ -483,9 +518,9 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                           maxLength: 256,
                         })}
                         <label className="onboarding-model-field">
-                          <span>向量协议</span>
+                          <span>{text("向量协议")}</span>
                           <select
-                            aria-label="向量协议"
+                            aria-label={text("向量协议")}
                             value={draft.embedding_provider_kind}
                             disabled={fieldsLocked}
                             onChange={(e) => {
@@ -498,9 +533,11 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                             }}
                           >
                             <option value="openai_compatible">
-                              同源 OpenAI-compatible（共用 Key）
+                              {text("同源 OpenAI-compatible（共用 Key）")}
+                            </option>
+                            <option value="ollama">
+                              {text("本机 Ollama")}
                             </option>
-                            <option value="ollama">本机 Ollama</option>
                           </select>
                         </label>
                         <div className="onboarding-model-wide">
@@ -509,7 +546,9 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                             required: true,
                           })}
                           <small>
-                            远程向量地址须与生成服务同源；本机地址仍需校验。
+                            {text(
+                              "远程向量地址须与生成服务同源；本机地址仍需校验。",
+                            )}
                           </small>
                         </div>
                       </>
@@ -524,7 +563,7 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                   disabled={locked}
                   onClick={() => void props.onRecoverCreation?.()}
                 >
-                  核对创建结果
+                  {text("核对创建结果")}
                 </R6Button>
               )}
               {props.onDiscardMissingCreation && (
@@ -533,17 +572,19 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                   disabled={locked}
                   onClick={() => void props.onDiscardMissingCreation?.()}
                 >
-                  放弃旧记录，重新配置
+                  {text("放弃旧记录，重新配置")}
                 </R6Button>
               )}
             </div>
             <div className="onboarding-model-feedback" tabIndex={-1}>
               {(displayedPhase === "testing" ||
                 displayedPhase === "enabling") && (
-                <p role="status" aria-label="模型提交状态">
-                  {displayedPhase === "testing"
-                    ? "正在测试连接…"
-                    : "正在提交保存与启用，请等待回执…"}
+                <p role="status" aria-label={text("模型提交状态")}>
+                  {text(
+                    displayedPhase === "testing"
+                      ? "正在测试连接…"
+                      : "正在提交保存与启用，请等待回执…",
+                  )}
                 </p>
               )}
               {props.probe && (
@@ -552,54 +593,60 @@ export function OnboardingModelStep(props: OnboardingModelStepProps) {
                   data-state={props.probe.state}
                   role="status"
                 >
-                  {props.probe.message}
+                  {text(props.probe.message)}
                 </p>
               )}
               {(props.error || callbackFailed) && (
                 <p className="onboarding-model-error" role="alert">
-                  {props.error ||
-                    "操作结果未确认，已填写内容保留，请核对后重试。"}
+                  {text(
+                    props.error ||
+                      "操作结果未确认，已填写内容保留，请核对后重试。",
+                  )}
                 </p>
               )}
             </div>
           </section>
           <aside
             className="onboarding-model-summary"
-            aria-label="本次沉淀"
+            aria-label={text("本次沉淀")}
             data-full-height={advancedOpen || connectionFailed}
             // biome-ignore lint/a11y/noNoninteractiveTabindex: Keyboard users must be able to scroll the full permission disclosure.
             tabIndex={0}
           >
             <div className="onboarding-model-summary-heading">
-              <p>本次沉淀</p>
-              <h2>让记忆从这里开始</h2>
+              <p>{text("本次沉淀")}</p>
+              <h2>{text("让记忆从这里开始")}</h2>
             </div>
             <div className="onboarding-model-connections">
-              <p>对话来源</p>
-              <strong>{sourceSummary || "尚无已选来源"}</strong>
+              <p>{text("对话来源")}</p>
+              <strong>{sourceSummary || text("尚无已选来源")}</strong>
               <small>
-                已导入 {props.importedConversationCount ?? 0}{" "}
-                条对话；来源开关继续控制之后同步到本机的内容。
+                {t("onboardingImportedConversations", {
+                  count: props.importedConversationCount ?? 0,
+                })}
               </small>
             </div>
             <div className="onboarding-model-summary-status">
               {connectionReceipt && (
                 <small className="onboarding-model-connection-receipt">
-                  {connectionReceipt}
+                  {text(connectionReceipt)}
                 </small>
               )}
               <small>
-                处理服务：{provider?.label ?? "待选择"}
+                {text("处理服务：")}
+                {text(provider?.label ?? "待选择")}
                 <br />
-                相关对话会发送给所选服务商。
+                {text("相关对话会发送给所选服务商。")}
               </small>
               <small>
-                测试连接只发送测试内容。启用后会使用此模型整理已导入和之后同步的会话。
+                {text(
+                  "测试连接只发送测试内容。启用后会使用此模型整理已导入和之后同步的会话。",
+                )}
               </small>
             </div>
             {!props.capability.saveAndEnable && (
               <p role="status">
-                {props.capability.reason || "当前不能在此启用模型。"}
+                {text(props.capability.reason || "当前不能在此启用模型。")}
               </p>
             )}
           </aside>

memhub/apps/web/src/R6ColdStartFrame.test.tsx

@@ -0,0 +1,153 @@
+// @vitest-environment jsdom
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { cleanup, render, screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { afterEach, expect, it } from "vitest";
+import { LanguageProvider } from "./gui-language";
+import { R6ColdStartFrame } from "./R6ColdStartFrame";
+
+afterEach(() => {
+  cleanup();
+  localStorage.clear();
+});
+
+function declaration(file: string, selector: string): string {
+  const css = readFileSync(join(process.cwd(), "src", file), "utf8");
+  const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return css.match(new RegExp(`${escaped}\\s*\\{([^}]*)\\}`))?.[1] ?? "";
+}
+
+it("lets multiline headings grow above the separator in normal flow", () => {
+  const head = declaration("onboarding-r6.css", ".onboarding-r6-head");
+  expect(head).toMatch(/flex:\s*0 0 auto/);
+  expect(head).toMatch(/display:\s*flex/);
+  expect(head).toMatch(/flex-wrap:\s*wrap/);
+  expect(
+    declaration("onboarding-r6.css", ".onboarding-r6-head .r6-stepper"),
+  ).not.toMatch(/position:\s*absolute/);
+});
+
+it("allows step labels to wrap in separate flexible tracks", () => {
+  const list = declaration("r6-controls.css", ".r6-stepper ol");
+  const step = declaration("r6-controls.css", ".r6-stepper li");
+  expect(list).toMatch(
+    /grid-template-columns:\s*repeat\(3, minmax\(0, 1fr\)\)/,
+  );
+  expect(step).toMatch(/white-space:\s*normal/);
+  expect(step).toMatch(/height:\s*auto/);
+  expect(step).not.toMatch(/width:\s*84px/);
+});
+
+it("sizes the import action to its label and wraps footer content", () => {
+  const submit = declaration("onboarding-r6.css", ".onboarding-r6-submit");
+  expect(submit).toMatch(/width:\s*auto/);
+  expect(submit).toMatch(/min-width:\s*138px/);
+  expect(declaration("onboarding-r6.css", ".onboarding-r6-foot")).toMatch(
+    /flex-wrap:\s*wrap/,
+  );
+});
+
+it("keeps progress cards content-sized and the step-two footer in normal flow", () => {
+  const card = declaration(
+    "r6-import-progress.css",
+    ".r6-import-progress-card",
+  );
+  expect(card).toMatch(/min-height:\s*218px/);
+  expect(card).not.toMatch(/(?:^|;)\s*height:/);
+  expect(
+    declaration(
+      "first-import-r6.css",
+      ".first-import-r6-main > .r6-import-progress",
+    ),
+  ).toMatch(/flex:\s*0 0 auto/);
+  expect(declaration("first-import-r6.css", ".first-import-r6-layout")).toMatch(
+    /height:\s*auto/,
+  );
+  expect(
+    declaration("first-import-r6.css", ".first-import-r6-footer-note"),
+  ).not.toMatch(/max-height|overflow/);
+  expect(declaration("onboarding-r6.css", ".onboarding-r6-body")).toMatch(
+    /overflow-y:\s*auto/,
+  );
+});
+
+it("removes the duplicate native drag overlay above the language selector", () => {
+  expect(
+    declaration(
+      "onboarding-r6.css",
+      ".desktop-frame:has(.onboarding-r6) > .window-drag-region",
+    ),
+  ).toMatch(/display:\s*none/);
+  expect(
+    declaration(
+      "onboarding-r6.css",
+      ".onboarding-r6-titlebar .r6-language-selector--compact",
+    ),
+  ).toMatch(/-webkit-app-region:\s*no-drag/);
+});
+
+it("keeps selection status outside decorative fades and readable when disabled", () => {
+  expect(
+    declaration("onboarding-r6.css", ".onboarding-r6-list-area::after"),
+  ).toBe("");
+  expect(
+    declaration(
+      "onboarding-r6.css",
+      ".onboarding-r6-list-status .onboarding-r6-quiet:disabled",
+    ),
+  ).toMatch(/opacity:\s*1/);
+});
+
+it("keeps the native selector keyboard-focusable and switches both languages", async () => {
+  render(
+    <LanguageProvider>
+      <R6ColdStartFrame
+        step={1}
+        title="Fixture"
+        eyebrow="Fixture"
+        footer={null}
+      >
+        <p>Fixture body</p>
+      </R6ColdStartFrame>
+    </LanguageProvider>,
+  );
+  const user = userEvent.setup();
+  const selector = screen.getByRole("combobox");
+  await user.tab();
+  expect(document.activeElement).toBe(selector);
+  await user.selectOptions(selector, "es");
+  expect(document.documentElement.lang).toBe("es");
+  expect(screen.getByRole("combobox").getAttribute("id")).toBe(selector.id);
+  await user.selectOptions(selector, "zh-CN");
+  expect(document.documentElement.lang).toBe("zh-CN");
+  expect(screen.getByRole("combobox", { name: "界面语言" })).toBe(selector);
+});
+
+it.each([1, 2, 3] as const)(
+  "offers a compact language selector on step %s",
+  (step) => {
+    render(
+      <LanguageProvider>
+        <R6ColdStartFrame
+          step={step}
+          title="Fixture"
+          eyebrow="Fixture"
+          footer={null}
+        >
+          <p>Fixture body</p>
+        </R6ColdStartFrame>
+      </LanguageProvider>,
+    );
+    const selector = screen.getByRole("combobox", { name: "界面语言" });
+    expect(selector.closest(".r6-language-selector--compact")).toBeTruthy();
+    expect(
+      screen.getByRole("option", { name: "简体中文" }).getAttribute("lang"),
+    ).toBe("zh-CN");
+    expect(
+      screen.getByRole("option", { name: "Español" }).getAttribute("lang"),
+    ).toBe("es");
+    expect(screen.queryByRole("heading", { name: "界面语言" })).toBeNull();
+    expect(selector.getAttribute("aria-describedby")).toBeNull();
+  },
+);

memhub/apps/web/src/R6ColdStartFrame.tsx

@@ -1,4 +1,5 @@
 import type { ReactNode } from "react";
+import { LanguageSelector } from "./LanguageSelector";
 import { R6LocalStorage, R6Stepper } from "./R6Controls";
 import "./onboarding-r6.css";
 
@@ -21,9 +22,12 @@ export function R6ColdStartFrame({
           left of this bar and a "第一次见面" caption on the right. The user
           removed both deliberately on 2026-09-20 — this is a product decision,
           not a missing implementation, so do not "restore" them when comparing
-          against the canvas. The bar itself stays: it is the 58px window drag
-          region and reserves room for the native traffic lights. */}
-      <header className="onboarding-r6-titlebar" />
+          against the canvas. The bar itself stays: it is the window drag
+          region (at least 58px) and reserves room for native traffic lights.
+          The language control opts out of dragging. */}
+      <header className="onboarding-r6-titlebar">
+        <LanguageSelector compact />
+      </header>
       <div className="onboarding-r6-stage">
         <section className="onboarding-r6-shell" data-step={step}>
           <header className="onboarding-r6-head">

memhub/apps/web/src/R6Controls.tsx

@@ -3,6 +3,7 @@ import {
   type InputHTMLAttributes,
   useId,
 } from "react";
+import { useOnboardingTranslation } from "./onboarding-language";
 import "./r6-controls.css";
 
 type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
@@ -35,15 +36,16 @@ export function R6Button({
 }
 
 export function R6Stepper({ active }: { active: 1 | 2 | 3 }) {
+  const { text } = useOnboardingTranslation();
   return (
-    <nav className="r6-stepper" aria-label="首次设置进度">
+    <nav className="r6-stepper" aria-label={text("首次设置进度")}>
       <ol>
         {["导入历史", "连接应用", "沉淀记忆"].map((label, index) => (
           <li
             key={label}
             aria-current={active === index + 1 ? "step" : undefined}
           >
-            <span aria-hidden="true">0{index + 1}</span> {label}
+            <span aria-hidden="true">0{index + 1}</span> {text(label)}
           </li>
         ))}
       </ol>
@@ -115,13 +117,16 @@ export function R6Field({
 }
 
 export function R6LocalStorage() {
+  const { text } = useOnboardingTranslation();
   return (
     <span
       className="r6-local-storage"
-      title="对话与记忆保存在本机；使用云模型或已授权的助手时，相关内容会发送给对应服务。"
+      title={text(
+        "对话与记忆保存在本机；使用云模型或已授权的助手时，相关内容会发送给对应服务。",
+      )}
     >
       <span aria-hidden="true" />
-      本地存储
+      {text("本地存储")}
     </span>
   );
 }

memhub/apps/web/src/R6ImportProgress.tsx

@@ -1,6 +1,7 @@
 import type { ImportJob, SourceResponse } from "@one-memory/contracts";
 import { useEffect, useLayoutEffect, useRef } from "react";
 import { AppMark } from "./app-mark";
+import { useOnboardingTranslation } from "./onboarding-language";
 import "./r6-import-progress.css";
 
 export function R6ImportProgress({
@@ -14,6 +15,7 @@ export function R6ImportProgress({
   jobs: ImportJob[];
   stale?: boolean;
 }) {
+  const { text, t, locale } = useOnboardingTranslation();
   const scroller = useRef<HTMLElement>(null);
   const userScrollLeft = useRef(0);
   const userScrollIntent = useRef(false);
@@ -41,7 +43,7 @@ export function R6ImportProgress({
   return (
     <section
       className="r6-import-progress"
-      aria-label="本次应用导入进度"
+      aria-label={text("本次应用导入进度")}
       data-count={ids.length <= 2 ? String(ids.length) : "many"}
       ref={scroller}
       onPointerDown={markUserScrollIntent}
@@ -92,7 +94,9 @@ export function R6ImportProgress({
           <article
             className="r6-import-progress-card"
             key={id}
-            aria-label={`${source?.display_name ?? id} 导入进度`}
+            aria-label={t("onboardingAppProgress", {
+              name: source?.display_name ?? id,
+            })}
             data-running={running ? "true" : "false"}
           >
             <div className="r6-import-progress-orbit" aria-hidden="true">
@@ -103,22 +107,34 @@ export function R6ImportProgress({
             </div>
             <h2>{source?.display_name ?? id}</h2>
             {job && job.stored > 0 ? (
-              <p>{`已保存 ${job.stored.toLocaleString()} 条消息`}</p>
+              <p>
+                {t("onboardingSavedMessages", {
+                  count: job.stored.toLocaleString(locale),
+                })}
+              </p>
             ) : job && job.discovered > 0 ? (
-              <p>{`已扫描 ${job.discovered.toLocaleString()} 条，正在保存`}</p>
+              <p>
+                {t("onboardingScannedMessages", {
+                  count: job.discovered.toLocaleString(locale),
+                })}
+              </p>
             ) : noImportedHistory ? (
-              <p>没有可保存的历史对话</p>
+              <p>{text("没有可保存的历史对话")}</p>
             ) : null}
             <small role="status">
-              {stale
-                ? "状态待核对"
-                : source?.authorized !== true
-                  ? "读取授权不可用"
-                  : job
-                    ? names[job.status]
-                    : "正在导入"}
+              {text(
+                stale
+                  ? "状态待核对"
+                  : source?.authorized !== true
+                    ? "读取授权不可用"
+                    : job
+                      ? names[job.status]
+                      : "正在导入",
+              )}
               {job && job.errors > 0
-                ? ` · ${job.errors.toLocaleString()} 条读取异常`
+                ? t("onboardingReadErrors", {
+                    count: job.errors.toLocaleString(locale),
+                  })
                 : ""}
             </small>
           </article>

memhub/apps/web/src/R6Settings.test.tsx

@@ -3,8 +3,31 @@
 import { cleanup, render, screen } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { afterEach, expect, it, vi } from "vitest";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
 import { R6Settings } from "./R6Settings";
 
+it("changes settings copy live without rereading profiles or changing permissions", async () => {
+  const user = userEvent.setup();
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  const { getModelProfiles } = await import("./api");
+  render(
+    <LanguageProvider>
+      <R6Settings onDiagnostics={vi.fn()} />
+    </LanguageProvider>,
+  );
+  expect(
+    await screen.findByRole("heading", { name: "Modelo de memorias" }),
+  ).toBeTruthy();
+  expect(
+    screen.queryByRole("switch", {
+      name: "Permitir que el modelo configurado lea las conversaciones locales",
+    }),
+  ).toBeNull();
+  const reads = vi.mocked(getModelProfiles).mock.calls.length;
+  await user.selectOptions(screen.getByRole("combobox"), "zh-CN");
+  expect(await screen.findByRole("heading", { name: "记忆模型" })).toBeTruthy();
+  expect(vi.mocked(getModelProfiles).mock.calls).toHaveLength(reads);
+});
 vi.mock("./api", () => ({
   getModelProfiles: vi.fn().mockResolvedValue([
     {
@@ -32,6 +55,7 @@ vi.mock("./diagnostics-export", () => ({
 }));
 afterEach(() => {
   cleanup();
+  localStorage.clear();
   vi.clearAllMocks();
 });
 
@@ -39,6 +63,8 @@ it("hides diagnostics by default and exposes it only when configured", async ()
   const user = userEvent.setup();
   const view = render(<R6Settings onDiagnostics={vi.fn()} />);
   expect(screen.queryByRole("button", { name: "帮助与诊断" })).toBeNull();
+  expect(screen.getByRole("combobox")).toBeTruthy();
+  expect(screen.getAllByRole("option")).toHaveLength(3);
 
   view.rerender(<R6Settings onDiagnostics={vi.fn()} showDiagnostics={true} />);
   await user.click(screen.getByRole("button", { name: "帮助与诊断" }));

memhub/apps/web/src/R6Settings.tsx

@@ -11,7 +11,9 @@ import {
 import { getModelProfiles } from "./api";
 import { ConnectionFallback } from "./ConnectionFallback";
 import { exportDiagnosticsFile } from "./diagnostics-export";
+import { LanguageSelector } from "./LanguageSelector";
 import { ModelSettings, type ModelSettingsActions } from "./ModelSettings";
+import { useOnboardingTranslation } from "./onboarding-language";
 import { R6Button, R6Switch } from "./R6Controls";
 import {
   refreshLoginPreference,
@@ -50,6 +52,7 @@ export function R6Settings({
   showDiagnostics?: boolean;
 }) {
   const id = useId();
+  const { t, text, locale } = useOnboardingTranslation();
   const groups = showDiagnostics
     ? [...primaryGroups, "help" as const]
     : primaryGroups;
@@ -80,7 +83,7 @@ export function R6Settings({
     setExportingLogs(true);
     setExportMessage("");
     try {
-      const result = await exportDiagnosticsFile();
+      const result = await exportDiagnosticsFile(locale);
       setExportMessage(result.message);
     } finally {
       setExportingLogs(false);
@@ -204,10 +207,11 @@ export function R6Settings({
   }
 
   return (
-    <section className="r6-settings" aria-label="设置">
-      <h1>设置</h1>
+    <section className="r6-settings" aria-label={t("settings")}>
+      <h1>{t("settings")}</h1>
+      <LanguageSelector />
       <div className="r6-settings-layout">
-        <nav aria-label="设置分组">
+        <nav aria-label={text("设置分组")}>
           {groups.map((key) => (
             <button
               type="button"
@@ -218,7 +222,7 @@ export function R6Settings({
               onKeyDown={moveGroupFocus}
               onClick={() => setGroup(key)}
             >
-              {labels[key]}
+              {text(labels[key])}
             </button>
           ))}
         </nav>
@@ -229,20 +233,23 @@ export function R6Settings({
             hidden={group !== "model"}
             className="r6-settings-model"
           >
-            <h2>记忆模型</h2>
+            <h2>{text("记忆模型")}</h2>
             <div className="r6-model-overview">
-              <p className="r6-model-caption">当前模型</p>
+              <p className="r6-model-caption">{text("当前模型")}</p>
               <h3 className="r6-current-model">
                 {currentModel?.name ??
-                  (profiles === null
-                    ? "正在读取模型…"
-                    : modelError
-                      ? "模型状态暂不可读"
-                      : "尚未配置模型")}
+                  text(
+                    profiles === null
+                      ? "正在读取模型…"
+                      : modelError
+                        ? "模型状态暂不可读"
+                        : "尚未配置模型",
+                  )}
               </h3>
               {currentModel && (
                 <p className="r6-model-state">
-                  {currentModel.model} · {safeEndpoint(currentModel.base_url)}
+                  {currentModel.model} ·{" "}
+                  {text(safeEndpoint(currentModel.base_url))}
                 </p>
               )}
               <div className="r6-model-actions">
@@ -251,12 +258,12 @@ export function R6Settings({
                   disabled={profiles === null}
                   onClick={openConfiguration}
                 >
-                  {currentModel ? "修改模型" : "配置模型"}
+                  {text(currentModel ? "修改模型" : "配置模型")}
                 </R6Button>
                 <R6Button
                   variant="quiet"
-                  aria-label="刷新模型状态"
-                  title="刷新模型状态"
+                  aria-label={text("刷新模型状态")}
+                  title={text("刷新模型状态")}
                   onClick={() => setModelVersion((value) => value + 1)}
                 >
                   <RefreshCw size={16} aria-hidden="true" />
@@ -264,22 +271,25 @@ export function R6Settings({
               </div>
               {modelError && (
                 <p role="alert" className="r6-settings-error">
-                  {profiles === null
-                    ? "模型状态未能读取，请重试。"
-                    : "模型状态刷新未成功，仍显示上次确认的模型状态；请重试。"}
+                  {text(
+                    profiles === null
+                      ? "模型状态未能读取，请重试。"
+                      : "模型状态刷新未成功，仍显示上次确认的模型状态；请重试。",
+                  )}
                 </p>
               )}
               {configurationRefusal && (
                 <p role="alert" className="r6-settings-error">
-                  模型配置暂时无法打开：正在处理上一次创建或测试，或本机存储暂时不可用。
-                  请等待当前操作结束后重试；现有配置和原文不会被改动。
+                  {text(
+                    "模型配置暂时无法打开：正在处理上一次创建或测试，或本机存储暂时不可用。 请等待当前操作结束后重试；现有配置和原文不会被改动。",
+                  )}
                 </p>
               )}
             </div>
             <section
               className="r6-model-owner"
               hidden={!configurationOpen}
-              aria-label="模型配置表单"
+              aria-label={text("模型配置表单")}
             >
               <ModelSettings
                 compactSingle
@@ -295,7 +305,7 @@ export function R6Settings({
             hidden={group !== "connections"}
             className="r6-settings-connections"
           >
-            <h2>连接其他应用</h2>
+            <h2>{text("连接其他应用")}</h2>
             <ConnectionFallback />
           </section>
           {showDiagnostics && (
@@ -305,14 +315,14 @@ export function R6Settings({
               hidden={group !== "help"}
               className="r6-settings-help"
             >
-              <h2>帮助与诊断</h2>
+              <h2>{text("帮助与诊断")}</h2>
               <div className="r6-setting-row">
                 <div>
-                  <h3>登录后启动后台服务</h3>
-                  <p>无需打开界面，持续同步、整理和提供记忆。</p>
+                  <h3>{text("登录后启动后台服务")}</h3>
+                  <p>{text("无需打开界面，持续同步、整理和提供记忆。")}</p>
                 </div>
                 <R6Switch
-                  label="登录后启动后台服务"
+                  label={text("登录后启动后台服务")}
                   checked={login?.enabled === true}
                   disabled={
                     !dataReady ||
@@ -325,15 +335,17 @@ export function R6Settings({
               </div>
               {(dataError || readError) && (
                 <p role="alert" className="r6-settings-error">
-                  {dataError || readError}
+                  {text(dataError || readError)}
                 </p>
               )}
               <div className="r6-setting-row">
                 <div>
-                  <h3>导出日志</h3>
+                  <h3>{text("导出日志")}</h3>
                   <p>
-                    {exportMessage ||
-                      "把本机运行日志打包成一个文件，发给开发排查。"}
+                    {text(
+                      exportMessage ||
+                        "把本机运行日志打包成一个文件，发给开发排查。",
+                    )}
                   </p>
                 </div>
                 <R6Button
@@ -342,7 +354,7 @@ export function R6Settings({
                   onClick={() => void handleExportLogs()}
                 >
                   <Download size={16} aria-hidden="true" />
-                  导出日志
+                  {text("导出日志")}
                 </R6Button>
               </div>
             </section>
@@ -381,23 +393,25 @@ export function R6Settings({
               }
             }}
           >
-            <h2 id={`${id}-quit-title`}>确定退出 One Memory 界面吗？</h2>
-            <p>后台服务会继续同步、整理和提供记忆。</p>
+            <h2 id={`${id}-quit-title`}>
+              {text("确定退出 One Memory 界面吗？")}
+            </h2>
+            <p>{text("后台服务会继续同步、整理和提供记忆。")}</p>
             {quitError && (
               <p role="alert" className="r6-settings-error">
-                {quitError}
+                {text(quitError)}
               </p>
             )}
             <footer>
               <R6Button disabled={quitting} onClick={() => setQuitOpen(false)}>
-                取消
+                {text("取消")}
               </R6Button>
               <R6Button
                 variant="primary"
                 pending={quitting}
                 onClick={() => void quitApplication()}
               >
-                退出界面
+                {text("退出界面")}
               </R6Button>
             </footer>
           </section>

memhub/apps/web/src/SelectedMemoryDetail.test.tsx

@@ -11,8 +11,32 @@ import {
 } from "@testing-library/react";
 import { StrictMode } from "react";
 import { afterEach, beforeEach, expect, it, vi } from "vitest";
+import { LANGUAGE_STORAGE_KEY, LanguageProvider } from "./gui-language";
 import { SelectedMemoryDetail } from "./SelectedMemoryDetail";
 
+it("localizes informational details and dates while preserving evidence and memory", async () => {
+  delete window.oneMemory;
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  render(
+    <LanguageProvider>
+      <SelectedMemoryDetail
+        detail={detail}
+        sources={[]}
+        onChanged={vi.fn()}
+        hideActions
+      />
+    </LanguageProvider>,
+  );
+  expect(await screen.findByText("Guardada · Versión 2")).toBeTruthy();
+  expect(
+    screen.getByRole("heading", { name: "Evidencia original" }),
+  ).toBeTruthy();
+  expect(screen.getByText("这次先确认范围。")).toBeTruthy();
+  expect(correct).not.toHaveBeenCalled();
+  expect(remove).not.toHaveBeenCalled();
+  localStorage.clear();
+});
+
 const { correct, read, remove, errorCode } = vi.hoisted(() => ({
   correct: vi.fn(),
   read: vi.fn(),

memhub/apps/web/src/SelectedMemoryDetail.tsx

@@ -9,6 +9,7 @@ import { sourceNameOr } from "./source-label";
 import { traceUiAction } from "./ui-trace";
 import { isDefiniteRefusal, writeTraceStatus } from "./write-outcome";
 import "./selected-memory.css";
+import { useMemoryLanguage } from "./memory-language";
 
 type Page = "read" | "edit" | "original" | "delete";
 
@@ -30,6 +31,7 @@ export function SelectedMemoryDetail({
   /** D99: when the cited conversation happened, in the list's own terms. */
   conversationAt?: { at: string; basis: "conversation" | "import" } | null;
 }) {
+  const { locale, text } = useMemoryLanguage();
   const [page, setPage] = useState<Page>("read");
   const [draft, setDraft] = useState(detail.memory.content);
   const [base, setBase] = useState(detail.memory.revision);
@@ -59,7 +61,12 @@ export function SelectedMemoryDetail({
         : memory.status === "superseded"
           ? "已被取代"
           : "状态待核对";
-  const source = sourceNameOr(sources, evidence?.source_id, "来源待核对");
+  const source =
+    evidence?.source_id === "one-memory-manual" && locale === "es"
+      ? "Añadida manualmente"
+      : evidence?.source_id === "memory-content-export" && locale === "es"
+        ? "Memoria existente importada"
+        : sourceNameOr(sources, evidence?.source_id, text("来源待核对"));
   const dirty = page === "edit" && draft !== memory.content;
   useEffect(() => {
     if (page === "edit" && memory.revision > base) setConflictFound(true);
@@ -88,7 +95,7 @@ export function SelectedMemoryDetail({
   }, [dirty]);
   function close() {
     if (busy) return;
-    if (dirty && !window.confirm("放弃尚未保存的修改？")) return;
+    if (dirty && !window.confirm(text("放弃尚未保存的修改？"))) return;
     setPage("read");
     setError("");
     setConflictFound(false);
@@ -224,7 +231,7 @@ export function SelectedMemoryDetail({
       : evidence?.written_by === "agent" || evidence?.written_by === "assistant"
         ? "助手原话"
         : "作者待核对";
-  const timestamp = clockStamp(evidence?.created_at);
+  const timestamp = clockStamp(evidence?.created_at, locale);
   const split = memory.content.search(/[。\n]/);
   const heading =
     split > 0 && split < 85
@@ -239,17 +246,22 @@ export function SelectedMemoryDetail({
         data-hide-actions={hideActions ? "true" : "false"}
       >
         <p className="selected-memory-status">
-          {statusLabel} · 第 {memory.revision} 版
+          {text(statusLabel)} ·{" "}
+          {locale === "es"
+            ? `Versión ${memory.revision}`
+            : `第 ${memory.revision} 版`}
         </p>
         <h3>{heading}</h3>
         {body && <p className="selected-memory-body">{body}</p>}
         <p className="selected-memory-source">
-          来源 {source} · {timestamp}
+          {text("来源")} {source} · {timestamp}
         </p>
         <p className="selected-memory-times">
-          对话时间 {clockStamp(conversationAt?.at ?? evidence?.created_at)}
+          {locale === "es" ? "Conversación: " : "对话时间 "}
+          {clockStamp(conversationAt?.at ?? evidence?.created_at, locale)}
           {" · "}
-          沉淀时间 {clockStamp(memory.updated_at)}
+          {locale === "es" ? "Guardada: " : "沉淀时间 "}
+          {clockStamp(memory.updated_at, locale)}
         </p>
         {!hideActions && (
           <R6Button
@@ -263,16 +275,21 @@ export function SelectedMemoryDetail({
               setPage("edit");
             }}
           >
-            编辑
+            {text("编辑")}
           </R6Button>
         )}
         <section className="selected-memory-evidence">
-          <h4>原始依据</h4>
+          <h4>{text("原始依据")}</h4>
           <small>
-            {author} · 原对话 {timestamp}：
+            {text(author)} ·{" "}
+            {locale === "es" ? "Conversación original " : "原对话 "}
+            {timestamp}
+            {locale === "es" ? ":" : "："}
           </small>
           <blockquote>
-            {evidence?.available ? evidence.verbatim : "这段原文当前不可查看。"}
+            {evidence?.available
+              ? evidence.verbatim
+              : text("这段原文当前不可查看。")}
           </blockquote>
           {!hideActions && (
             <R6Button
@@ -281,20 +298,24 @@ export function SelectedMemoryDetail({
                 setPage("original");
               }}
             >
-              查看原文
+              {text("查看原文")}
             </R6Button>
           )}
         </section>
         {!hideActions && (
           <R6Button variant="quiet" onClick={() => setShowHistory((v) => !v)}>
-            版本记录
+            {text("版本记录")}
           </R6Button>
         )}
         {!hideActions && showHistory && (
           <ol className="selected-memory-history">
             {detail.history.map((v) => (
               <li key={v.revision}>
-                <small>第 {v.revision} 版</small>
+                <small>
+                  {locale === "es"
+                    ? `Versión ${v.revision}`
+                    : `第 ${v.revision} 版`}
+                </small>
                 <p>{v.content}</p>
               </li>
             ))}
@@ -302,7 +323,7 @@ export function SelectedMemoryDetail({
         )}
         {!hideActions && (
           <details className="selected-memory-more">
-            <summary>更多管理</summary>
+            <summary>{text("更多管理")}</summary>
             {onSaveScopes && (
               <MemoryRecallScope
                 detail={detail}
@@ -312,7 +333,7 @@ export function SelectedMemoryDetail({
             )}
             {detail.history.length > 1 && (
               <R6Button pending={busy} onClick={() => void govern("undo")}>
-                撤销上次修改
+                {text("撤销上次修改")}
               </R6Button>
             )}
             <R6Button
@@ -322,11 +343,11 @@ export function SelectedMemoryDetail({
                 setPage("delete");
               }}
             >
-              删除记忆
+              {text("删除记忆")}
             </R6Button>
           </details>
         )}
-        {error && page === "read" && <p role="alert">{error}</p>}
+        {error && page === "read" && <p role="alert">{text(error)}</p>}
       </article>
       {page !== "read" &&
         createPortal(
@@ -335,10 +356,10 @@ export function SelectedMemoryDetail({
             hidden={suspended}
             aria-label={
               page === "edit"
-                ? "编辑记忆"
+                ? text("编辑记忆")
                 : page === "original"
-                  ? "原始对话"
-                  : "删除记忆"
+                  ? text("原始对话")
+                  : text("删除记忆")
             }
             onKeyDown={(event) => {
               if (event.key === "Tab") {
@@ -370,20 +391,20 @@ export function SelectedMemoryDetail({
             <header>
               <h1 ref={focus} tabIndex={-1}>
                 {page === "edit"
-                  ? "编辑记忆"
+                  ? text("编辑记忆")
                   : page === "original"
-                    ? "原始对话"
-                    : "删除记忆"}
+                    ? text("原始对话")
+                    : text("删除记忆")}
               </h1>
               {page === "original" && (
-                <R6Button onClick={close}>返回记忆</R6Button>
+                <R6Button onClick={close}>{text("返回记忆")}</R6Button>
               )}
             </header>
             {page === "edit" ? (
               <div className="selected-editor">
-                <p>修改这条记忆，原始对话保持不变。</p>
+                <p>{text("修改这条记忆，原始对话保持不变。")}</p>
                 <textarea
-                  aria-label="记忆内容"
+                  aria-label={text("记忆内容")}
                   name="memory-content"
                   value={draft}
                   disabled={busy}
@@ -393,16 +414,18 @@ export function SelectedMemoryDetail({
                     request.current = null;
                   }}
                 />
-                <p>使用范围保持不变</p>
+                <p>{text("使用范围保持不变")}</p>
                 {conflictFound && (
                   <section className="selected-conflict">
-                    <h2>已有新版本</h2>
-                    <p>你的草稿已保留，先查看新版本再决定如何修改。</p>
+                    <h2>{text("已有新版本")}</h2>
+                    <p>
+                      {text("你的草稿已保留，先查看新版本再决定如何修改。")}
+                    </p>
                     <R6Button
                       pending={busy}
                       onClick={() => void refreshConflict()}
                     >
-                      查看新版本
+                      {text("查看新版本")}
                     </R6Button>
                     {conflict && (
                       <>
@@ -414,7 +437,7 @@ export function SelectedMemoryDetail({
                             request.current = null;
                           }}
                         >
-                          基于此版本继续编辑
+                          {text("基于此版本继续编辑")}
                         </R6Button>
                       </>
                     )}
@@ -422,7 +445,7 @@ export function SelectedMemoryDetail({
                 )}
                 <div className="selected-page-actions">
                   <R6Button disabled={busy} onClick={close}>
-                    取消
+                    {text("取消")}
                   </R6Button>
                   <R6Button
                     variant="primary"
@@ -430,7 +453,7 @@ export function SelectedMemoryDetail({
                     disabled={!draft.trim() || conflictFound}
                     onClick={() => void save()}
                   >
-                    保存修改
+                    {text("保存修改")}
                   </R6Button>
                 </div>
               </div>
@@ -439,54 +462,61 @@ export function SelectedMemoryDetail({
                 <small>
                   {source} · {timestamp}
                 </small>
-                <p>{author}</p>
+                <p>{text(author)}</p>
                 {detail.evidence.map((item) => (
                   <section key={item.evidence_id}>
                     <small>
-                      {sourceNameOr(sources, item.source_id, "来源待核对")} ·{" "}
+                      {sourceNameOr(
+                        sources,
+                        item.source_id,
+                        text("来源待核对"),
+                      )}{" "}
+                      ·{" "}
                       {item.written_by === "person"
-                        ? "你"
+                        ? text("你")
                         : item.written_by === "agent"
-                          ? "助手"
-                          : "作者待核对"}
+                          ? text("助手")
+                          : text("作者待核对")}
                     </small>
                     <blockquote>
                       {item.available
                         ? item.verbatim
-                        : "来源权限已变化或原文不可用。"}
+                        : text("来源权限已变化或原文不可用。")}
                     </blockquote>
                   </section>
                 ))}
-                <small>对应记忆</small>
+                <small>{text("对应记忆")}</small>
                 <h2>{heading}</h2>
-                <R6Button onClick={close}>查看记忆</R6Button>
+                <R6Button onClick={close}>{text("查看记忆")}</R6Button>
               </div>
             ) : (
               <div className="selected-delete">
-                <h2>删除这条记忆？</h2>
+                <h2>{text("删除这条记忆？")}</h2>
                 <p>{heading}</p>
                 <p>
-                  删除后不再用于新的召回，来源 App 中的原始对话不会删除。
+                  {text(
+                    "删除后不再用于新的召回，来源 App 中的原始对话不会删除。",
+                  )}
                   <br />
-                  已经发送给应用的内容无法远程收回。
+                  {text("已经发送给应用的内容无法远程收回。")}
                 </p>
                 <div className="selected-page-actions">
                   <R6Button disabled={busy} onClick={close}>
-                    取消
+                    {text("取消")}
                   </R6Button>
                   <R6Button
                     variant="primary"
                     pending={busy}
                     onClick={() => void remove()}
                   >
-                    删除记忆
+                    {text("删除记忆")}
                   </R6Button>
                 </div>
               </div>
             )}
             {error && (
               <p className="selected-page-error" role="alert">
-                {error}
+                {text(error)}
               </p>
             )}
           </section>,

memhub/apps/web/src/SourceImportReceipt.tsx

@@ -6,6 +6,7 @@ import type {
 import { FileText, RefreshCw, X } from "lucide-react";
 import { useEffect, useRef, useState } from "react";
 import { getConversation, getSourceImportReceipt } from "./api";
+import { useMemoryLanguage } from "./memory-language";
 
 export function SourceImportReceipt({ source }: { source: SourceResponse }) {
   return source.authorized ? (
@@ -14,6 +15,7 @@ export function SourceImportReceipt({ source }: { source: SourceResponse }) {
 }
 
 function ReceiptBody({ source }: { source: SourceResponse }) {
+  const { locale, text, count } = useMemoryLanguage();
   const [receipt, setReceipt] = useState<Receipt | null>(null);
   const [error, setError] = useState("");
   const [loading, setLoading] = useState(false);
@@ -97,85 +99,98 @@ function ReceiptBody({ source }: { source: SourceResponse }) {
         }
       }}
     >
-      <summary>查看已读内容</summary>
+      <summary>{text("查看已读内容")}</summary>
       {opened && (
         <div className="source-receipt-body">
           <header>
-            <span>已保存原文 · {source.display_name}</span>
+            <span>
+              {text("已保存原文")} · {source.display_name}
+            </span>
             <button
               type="button"
               className="quiet"
-              title="刷新已读内容"
-              aria-label="刷新已读内容"
+              title={text("刷新已读内容")}
+              aria-label={text("刷新已读内容")}
               disabled={loading}
               onClick={() => void load()}
             >
               <RefreshCw size={15} />
             </button>
           </header>
-          {loading && <p role="status">正在核对本机已保存记录…</p>}
-          {error && <p role="alert">{error}</p>}
+          {loading && <p role="status">{text("正在核对本机已保存记录…")}</p>}
+          {error && <p role="alert">{text(error)}</p>}
           {receipt && (
             <>
               <dl className="source-receipt-counts">
                 <div>
-                  <dt>原始消息</dt>
-                  <dd>{receipt.messages.toLocaleString()}</dd>
+                  <dt>{text("原始消息")}</dt>
+                  <dd>{receipt.messages.toLocaleString(locale)}</dd>
                 </div>
                 <div>
-                  <dt>会话</dt>
-                  <dd>{receipt.conversations.toLocaleString()}</dd>
+                  <dt>{text("会话")}</dt>
+                  <dd>{receipt.conversations.toLocaleString(locale)}</dd>
                 </div>
                 <div>
-                  <dt>用户发言</dt>
-                  <dd>{receipt.person_messages.toLocaleString()}</dd>
+                  <dt>{text("用户发言")}</dt>
+                  <dd>{receipt.person_messages.toLocaleString(locale)}</dd>
                 </div>
                 <div>
-                  <dt>Agent 发言</dt>
-                  <dd>{receipt.agent_messages.toLocaleString()}</dd>
+                  <dt>{text("Agent 发言")}</dt>
+                  <dd>{receipt.agent_messages.toLocaleString(locale)}</dd>
                 </div>
                 <div>
-                  <dt>作者未知</dt>
-                  <dd>{receipt.unknown_author_messages.toLocaleString()}</dd>
+                  <dt>{text("作者未知")}</dt>
+                  <dd>
+                    {receipt.unknown_author_messages.toLocaleString(locale)}
+                  </dd>
                 </div>
                 <div>
-                  <dt>原始时间未知</dt>
-                  <dd>{receipt.unknown_time_messages.toLocaleString()}</dd>
+                  <dt>{text("原始时间未知")}</dt>
+                  <dd>
+                    {receipt.unknown_time_messages.toLocaleString(locale)}
+                  </dd>
                 </div>
                 {receipt.tool_messages > 0 && (
                   <div>
-                    <dt>工具记录</dt>
-                    <dd>{receipt.tool_messages.toLocaleString()}</dd>
+                    <dt>{text("工具记录")}</dt>
+                    <dd>{receipt.tool_messages.toLocaleString(locale)}</dd>
                   </div>
                 )}
               </dl>
               <p className="source-receipt-note">
                 {receipt.unknown_time_messages > 0
-                  ? `${receipt.unknown_time_messages.toLocaleString()} 条记录没有原始时间，未用导入时间代替。`
-                  : "原始时间来自已保存记录。"}{" "}
-                作者数量按当前记录分类统计，不代表记忆抽取已完成或语义已核实。
+                  ? locale === "es"
+                    ? `${count(receipt.unknown_time_messages)} registros sin fecha original; no se sustituyó por la fecha de importación.`
+                    : `${receipt.unknown_time_messages.toLocaleString(locale)} 条记录没有原始时间，未用导入时间代替。`
+                  : text("原始时间来自已保存记录。")}{" "}
+                {locale === "es"
+                  ? "Los autores se cuentan según los registros actuales; no implica que la extracción o la verificación semántica hayan terminado."
+                  : "作者数量按当前记录分类统计，不代表记忆抽取已完成或语义已核实。"}
               </p>
               <p className="source-receipt-meta">
-                统计于 {time(receipt.measured_at)}
+                {locale === "es" ? "Medido el " : "统计于 "}
+                {time(receipt.measured_at, locale)}
                 {receipt.messages !== source.imported_messages
-                  ? " · 导入数量仍在更新，可刷新核对"
+                  ? locale === "es"
+                    ? " · La importación continúa; actualiza para verificar"
+                    : " · 导入数量仍在更新，可刷新核对"
                   : ""}
               </p>
               {receipt.examples.length > 0 ? (
                 <section
                   className="source-receipt-examples"
-                  aria-label="已保存的原文样例"
+                  aria-label={text("已保存的原文样例")}
                 >
-                  <h3>已保存的原文样例</h3>
+                  <h3>{text("已保存的原文样例")}</h3>
                   <p className="source-receipt-meta">
-                    最多展示 3 段，不代表全部历史或推荐记忆。
+                    {text("最多展示 3 段，不代表全部历史或推荐记忆。")}
                   </p>
                   {receipt.examples.map((example) => (
                     <article key={example.evidence_id}>
                       <header>
                         <span>
-                          {author(example.written_by)} ·{" "}
-                          {time(example.created_at)}
+                          {text(author(example.written_by))} ·{" "}
+                          {time(example.created_at, locale)}
                         </span>
                         <button
                           type="button"
@@ -183,35 +198,37 @@ function ReceiptBody({ source }: { source: SourceResponse }) {
                           onClick={() => void read(example.evidence_id)}
                         >
                           <FileText size={14} aria-hidden="true" />
-                          查看完整对话
+                          {text("查看完整对话")}
                         </button>
                       </header>
                       <p className="source-receipt-quote">{example.excerpt}</p>
                       {example.truncated && (
-                        <small>原文较长，此处仅展示前 600 个字符。</small>
+                        <small>
+                          {text("原文较长，此处仅展示前 600 个字符。")}
+                        </small>
                       )}
                     </article>
                   ))}
                 </section>
               ) : (
-                <p>这个来源还没有保存原文。</p>
+                <p>{text("这个来源还没有保存原文。")}</p>
               )}
             </>
           )}
-          {reading && <p role="status">正在读取完整对话…</p>}
-          {readError && <p role="alert">{readError}</p>}
+          {reading && <p role="status">{text("正在读取完整对话…")}</p>}
+          {readError && <p role="alert">{text(readError)}</p>}
           {transcript && (
             <section
               className="source-receipt-conversation"
-              aria-label="完整对话"
+              aria-label={text("完整对话")}
             >
               <header>
-                <h3>完整对话</h3>
+                <h3>{text("完整对话")}</h3>
                 <button
                   type="button"
                   className="quiet"
-                  title="关闭完整对话"
-                  aria-label="关闭完整对话"
+                  title={text("关闭完整对话")}
+                  aria-label={text("关闭完整对话")}
                   onClick={() => {
                     conversationGeneration.current++;
                     setTranscript(null);
@@ -224,7 +241,8 @@ function ReceiptBody({ source }: { source: SourceResponse }) {
                 {transcript.messages.map((message) => (
                   <li key={message.evidence_id}>
                     <small>
-                      {author(message.written_by)} · {time(message.created_at)}
+                      {text(author(message.written_by))} ·{" "}
+                      {time(message.created_at, locale)}
                     </small>
                     <p>{message.verbatim}</p>
                   </li>
@@ -247,8 +265,10 @@ function author(value: string) {
         ? "工具"
         : "作者未知";
 }
-function time(value: string | null) {
+function time(value: string | null, locale = "zh-CN") {
   return value && Number.isFinite(Date.parse(value))
-    ? new Date(value).toLocaleString()
-    : "时间未知";
+    ? new Date(value).toLocaleString(locale)
+    : locale === "es"
+      ? "Hora desconocida"
+      : "时间未知";
 }

memhub/apps/web/src/application-detail.css

@@ -139,7 +139,9 @@
   display: inline-flex;
   align-items: center;
   gap: 8px;
-  white-space: nowrap;
+  white-space: normal;
+  overflow-wrap: anywhere;
+  text-align: end;
   cursor: pointer;
 }
 .r6-app-detail-status .r6-button-spinner {
@@ -213,7 +215,20 @@
     padding: 20px 16px;
   }
   .r6-app-settings {
-    padding: 0 18px;
+    padding: 0;
+    margin: 0;
+  }
+  .r6-app-detail > .r6-button:first-of-type {
+    position: static;
+    width: auto;
+    max-width: 100%;
+  }
+  .r6-app-detail > header {
+    margin: 24px 0;
+    min-width: 0;
+  }
+  .r6-app-detail > header h2 {
+    overflow-wrap: anywhere;
   }
 }
 @media (prefers-reduced-transparency: reduce) {

memhub/apps/web/src/applications-home.css

@@ -339,7 +339,9 @@
   min-width: 0;
 }
 .r6-home-apps > header {
-  height: 56px;
+  min-height: 56px;
+  flex-wrap: wrap;
+  padding-block: 8px;
 }
 button.r6-home-expand {
   padding: 8px;
@@ -411,18 +413,19 @@ button.r6-home-expand:active:not(:disabled) {
   flex: 0 0 auto;
 }
 .r6-home-app-row {
-  height: 96px;
+  min-height: 96px;
   box-sizing: border-box;
   border-bottom: 1px solid #d0dde5;
 }
 .r6-home[data-expanded="true"] .r6-home-app-row {
-  height: 112px;
+  min-height: 112px;
 }
 .r6-home-row-content {
   display: flex;
   align-items: center;
   gap: 20px;
-  height: 100%;
+  min-height: inherit;
+  padding-block: 12px;
 }
 .r6-home-app-row img,
 .r6-home-row-content > svg {
@@ -447,6 +450,8 @@ button.r6-home-expand:active:not(:disabled) {
 }
 .r6-home-app-row .r6-home-app-meta {
   width: 220px;
+  max-width: 30%;
+  overflow-wrap: anywhere;
   flex-shrink: 0;
   margin: 0;
   text-align: right;
@@ -456,8 +461,9 @@ button.r6-home-expand:active:not(:disabled) {
 }
 .r6-home-app-row .r6-button {
   min-width: 78px;
-  min-height: 26px;
-  height: 26px;
+  flex-shrink: 0;
+  min-height: 32px;
+  height: auto;
   padding: 0;
   font-size: 12px;
 }
@@ -510,7 +516,20 @@ button.r6-home-expand:focus-visible,
     padding: 0 18px 12px;
   }
   .r6-home-row-content {
-    gap: 12px;
+    display: grid;
+    grid-template-columns: auto minmax(0, 1fr) auto;
+    gap: 8px 12px;
+  }
+  .r6-home-app-row .r6-home-app-meta {
+    grid-column: 2;
+    grid-row: 2;
+    width: auto;
+    max-width: none;
+    text-align: left;
+  }
+  .r6-home-row-content > .r6-button {
+    grid-column: 3;
+    grid-row: 1 / 3;
   }
   .r6-home-heading {
     flex-wrap: wrap;

memhub/apps/web/src/applications-language.ts

@@ -0,0 +1,199 @@
+import type { GuiLocale } from "@one-memory/contracts/gui-i18n";
+import { useGuiLanguage } from "./gui-language";
+
+// Presentation-only catalogue: never translate imported content, names or error codes.
+const messages = {
+  apps: ["应用", "Aplicaciones"],
+  allApps: ["全部应用", "Todas las aplicaciones"],
+  home: ["应用首页", "Inicio de aplicaciones"],
+  back: ["返回首页", "Volver al inicio"],
+  overview: ["记忆概览", "Resumen de memorias"],
+  memories: ["已沉淀记忆", "Memorias guardadas"],
+  readingCount: ["正在读取已沉淀记忆数量…", "Leyendo el total de memorias…"],
+  unreadable: ["暂无法读取", "No disponible"],
+  unit: ["条", ""],
+  scope: ["按应用授权范围使用", "Según los permisos de cada aplicación"],
+  processing: ["沉淀状态", "Procesamiento"],
+  modelOff: ["模型读取已关闭", "Lectura desactivada"],
+  running: ["整理中", "Organizando"],
+  queued: ["排队处理中", "En cola"],
+  waitingModel: ["等待模型", "Esperando modelo"],
+  needsAttention: ["需要处理", "Requiere atención"],
+  preparing: ["准备中", "Preparando"],
+  ready: ["一切就绪", "Todo listo"],
+  unchecked: ["待核对", "Sin verificar"],
+  noNewMemories: [
+    "新的对话不会再整理成记忆",
+    "Las nuevas conversaciones no generarán memorias",
+  ],
+  organizingNew: ["新的对话正在整理", "Organizando nuevas conversaciones"],
+  waitingQueue: ["等待队列开始处理", "Esperando el inicio del procesamiento"],
+  currentState: ["以当前处理状态为准", "Estado actual del procesamiento"],
+  modelPermission: ["打开模型内容权限", "Permisos del modelo"],
+  recentUpdate: ["最近更新", "Última actualización"],
+  notGenerated: ["尚未生成", "Sin generar"],
+  saved: ["记忆已保存", "Memoria guardada"],
+  separate: [
+    "历史与记忆分别处理",
+    "Historial y memorias se procesan por separado",
+  ],
+  recentCall: ["最近调用", "Última consulta"],
+  activityUnavailable: ["动态暂不可用", "Actividad no disponible"],
+  firstBatch: ["首批沉淀", "Primeras memorias"],
+  callsUnavailable: ["暂时无法读取调用记录", "No se pueden leer las consultas"],
+  memoryUnavailable: [
+    "暂时无法读取记忆状态",
+    "No se puede leer el estado de las memorias",
+  ],
+  importing: [
+    "对话持续导入中，即将沉淀你的记忆",
+    "Importando conversaciones para generar memorias",
+  ],
+  firstRunning: ["正在沉淀第一批记忆", "Generando las primeras memorias"],
+  firstQueued: ["准备沉淀第一批记忆", "Preparando las primeras memorias"],
+  readingActivity: ["正在读取动态", "Leyendo actividad"],
+  emptyMemories: ["还没有已生成的记忆", "Aún no hay memorias generadas"],
+  callReadFailure: [
+    "已有记忆仍可查看；重试不会发起新的调用。",
+    "Puedes ver las memorias guardadas. Reintentar no inicia otra consulta.",
+  ],
+  memoryReadFailure: [
+    "读取失败不会当作没有记忆。",
+    "Un error de lectura no significa que no haya memorias.",
+  ],
+  savingConversations: [
+    "对话正在后台持续保存。",
+    "Las conversaciones se guardan en segundo plano.",
+  ],
+  waitingMemories: [
+    "历史已保存，记忆生成后会显示在这里。",
+    "El historial está guardado. Las memorias aparecerán cuando se generen.",
+  ],
+  reread: ["重新读取", "Reintentar lectura"],
+  viewCalls: ["查看记录", "Ver consultas"],
+  viewMemory: ["查看记忆", "Ver memoria"],
+  backgroundDown: [
+    "后台服务没有运行，应用暂时查不到记忆",
+    "El servicio está detenido; las aplicaciones no pueden consultar memorias",
+  ],
+  restart: ["重新启动", "Reiniciar"],
+  runtime: ["运行状态", "Estado del servicio"],
+  backgroundRunning: ["后台运行中", "Servicio activo"],
+  connectionUnchecked: ["连接状态待核对", "Conexión sin verificar"],
+  disconnected: ["服务未连接", "Servicio desconectado"],
+  authorizedOnly: ["仅处理已授权范围", "Solo procesa contenido autorizado"],
+  sync: ["对话同步", "Sincronización"],
+  organizing: ["记忆整理", "Memorias"],
+  access: ["应用访问", "Acceso de aplicaciones"],
+  checkingAccess: ["应用接入核对", "Verificación de acceso"],
+  checking: ["核对中…", "Verificando…"],
+  recheck: ["重新核对", "Volver a verificar"],
+  accessState: ["应用接入状态", "Estado del acceso"],
+  staleAccess: [
+    "应用接入状态暂时读取失败，当前为上次状态。",
+    "No se pudo actualizar el acceso. Se muestra el último estado conocido.",
+  ],
+  reconnect: ["重新接入", "Volver a conectar"],
+  myApps: ["我的应用", "Mis aplicaciones"],
+  list: ["应用列表", "Lista de aplicaciones"],
+  syncEnabled: ["持续同步已开启", "Sincronización continua activada"],
+  recallAllowed: ["允许请求已授权记忆", "Puede consultar memorias autorizadas"],
+  historyAllowed: ["历史读取已授权", "Lectura del historial autorizada"],
+  connectionPending: ["连接待完成", "Conexión pendiente"],
+  details: ["查看详情", "Ver detalles"],
+  listUnavailable: [
+    "应用列表暂时不可读取",
+    "No se puede leer la lista de aplicaciones",
+  ],
+  emptyApps: ["还没有可显示的应用", "Aún no hay aplicaciones para mostrar"],
+  checkingNow: ["正在核对中", "Verificando"],
+  checkingState: ["正在检查状态", "Comprobando estado"],
+  notEnabled: ["尚未开启", "Desactivada"],
+  enableFailed: ["未能开启", "No se pudo activar"],
+  unknownTime: ["时间未知", "Hora desconocida"],
+  today: ["今天 ", "Hoy "],
+  newMemory: ["新增记忆", "Nueva memoria"],
+  updatedMemory: ["更新记忆", "Memoria actualizada"],
+  unlinked: ["尚未关联", "Sin vincular"],
+  lastRead: ["上次读取：", "Última lectura: "],
+  recentSync: ["最近同步 {time}", "Última sincronización: {time}"],
+  connectedCount: ["{count} 个应用已接入", "{count} aplicaciones conectadas"],
+  pendingCount: ["{count} 个应用待核对", "{count} aplicaciones sin verificar"],
+  mixedCount: [
+    "{count} 个应用已接入，{pending} 个待核对",
+    "{count} conectadas; {pending} sin verificar",
+  ],
+  unknownAccess: [
+    "应用接入状态暂时没有读到，无法确认有几个应用已接入。",
+    "No se pudo leer el acceso; no se puede confirmar cuántas aplicaciones están conectadas.",
+  ],
+  unknownPermissions: [
+    "{names} 的记忆权限暂时没有读到，无法确认是否已接入。",
+    "No se pudieron leer los permisos de {names}; su conexión no está confirmada.",
+  ],
+  enabledCount: ["{count} 个应用已开启", "{count} aplicaciones activadas"],
+  appCount: ["{count} 个应用", "{count} aplicaciones"],
+  viewAll: ["查看全部 {count} 个应用", "Ver las {count} aplicaciones"],
+  checkedAt: ["上次核对：{time}", "Última verificación: {time}"],
+  revision: ["版本 {count}", "Versión {count}"],
+  conversationTime: ["对话时间", "Hora de conversación"],
+  importTime: ["导入时间", "Hora de importación"],
+  incompleteCalls: [
+    " · 有几次调用没被记下来，列表可能不全",
+    " · Algunas consultas no se registraron; la lista puede estar incompleta",
+  ],
+  timeoutWarning: [
+    "{host} 最近几次没查到记忆，后台可能正忙，稍后会自动恢复",
+    "Las últimas consultas de {host} no se completaron. El servicio puede estar ocupado; se recuperará automáticamente.",
+  ],
+  autoHostFailed: [
+    "{name} 未能自动接入{reason}。",
+    "No se pudo conectar {name} automáticamente{reason}. ",
+  ],
+  autoSyncFailed: [
+    "{name} 的持续同步未能自动开启。{reason}",
+    "No se pudo activar la sincronización continua de {name}. {reason}",
+  ],
+  noAutoRetry: ["不会自动重试。", "No se reintentará automáticamente."],
+  cardUnavailable: [
+    "{label}暂时显示不了，其他功能不受影响，稍后会自动恢复。",
+    "{label} no está disponible. Las demás funciones siguen activas; se recuperará automáticamente.",
+  ],
+  navMemories: ["记忆", "Memorias"],
+  navigation: ["主要导航", "Navegación principal"],
+  skip: ["跳到主要内容", "Saltar al contenido principal"],
+  local: ["本地存储", "Almacenamiento local"],
+  localHint: [
+    "记忆保存在本机；使用云模型整理或交给已授权的助手时，相关内容会发送给对应服务。",
+    "Las memorias se guardan en este equipo. Al usar modelos en la nube o asistentes autorizados, el contenido pertinente se envía al servicio correspondiente.",
+  ],
+} as const;
+export type ApplicationsMessage = keyof typeof messages;
+export function applicationsText(
+  locale: GuiLocale,
+  key: ApplicationsMessage,
+  params?: Record<string, string | number>,
+): string {
+  const singular: Partial<Record<ApplicationsMessage, string>> = {
+    connectedCount: "{count} aplicación conectada",
+    pendingCount: "{count} aplicación sin verificar",
+    enabledCount: "{count} aplicación activada",
+    appCount: "{count} aplicación",
+    viewAll: "Ver la aplicación",
+  };
+  const message =
+    locale === "es" && params?.count === 1 && singular[key]
+      ? singular[key]
+      : messages[key][locale === "es" ? 1 : 0];
+  return message.replace(/\{(\w+)\}/g, (match, name: string) =>
+    params && Object.hasOwn(params, name) ? String(params[name]) : match,
+  );
+}
+export function useApplicationsLanguage() {
+  const { locale } = useGuiLanguage();
+  return {
+    locale,
+    a: (key: ApplicationsMessage, params?: Record<string, string | number>) =>
+      applicationsText(locale, key, params),
+  };
+}

memhub/apps/web/src/call-history-client.ts

@@ -1,3 +1,4 @@
+import type { GuiLocale } from "@one-memory/contracts/gui-i18n";
 import {
   clearAllCallEventsRequest,
   clearCallEventsRequest,
@@ -64,14 +65,30 @@ export const CALL_HOSTS: Record<string, string> = {
   pi: "Pi",
   "deepseek-harness": "DeepSeek Harness",
 };
-export function callHostName(id: string | null) {
-  return id === null ? "直接调用（诊断）" : (CALL_HOSTS[id] ?? id);
+export function callHostName(id: string | null, locale: GuiLocale = "zh-CN") {
+  return id === null
+    ? locale === "es"
+      ? "Consulta directa (diagnóstico)"
+      : "直接调用（诊断）"
+    : (CALL_HOSTS[id] ?? id);
 }
 export function callEventHeadline(
   item: CallEvent,
   host = callHostName(item.host_id),
+  locale: GuiLocale = "zh-CN",
 ) {
   const count = item.raw_count + item.memory_count;
+  if (locale === "es") {
+    if (item.state === "timed_out")
+      return `${host} no pudo consultar las memorias a tiempo`;
+    if (item.state === "unavailable")
+      return `${host} no puede consultar memorias ahora`;
+    if (item.state === "denied")
+      return `${host} no tiene permiso para consultar memorias`;
+    if (item.state === "empty")
+      return `${host} no encontró memorias relacionadas`;
+    return `${host} encontró ${new Intl.NumberFormat(locale).format(count)} ${count === 1 ? "contenido relacionado" : "contenidos relacionados"}`;
+  }
   if (item.state === "timed_out") return `${host} 这次没来得及查到记忆`;
   if (item.state === "unavailable") return `${host} 暂时无法查记忆`;
   if (item.state === "denied") return `${host} 未获准查记忆`;
@@ -81,8 +98,26 @@ export function callEventHeadline(
 export function callRowHeadline(item: CallEvent) {
   return callEventHeadline(item);
 }
-export function callRowDetail(item: CallEvent) {
-  const host = callHostName(item.host_id);
+export function callRowDetail(item: CallEvent, locale: GuiLocale = "zh-CN") {
+  const host = callHostName(item.host_id, locale);
+  if (locale === "es") {
+    if (item.state === "timed_out")
+      return "La consulta agotó el tiempo mientras se organizaban las memorias; la respuesta no incluyó memorias";
+    if (item.state === "unavailable")
+      return "One Memory no está disponible; la respuesta no incluyó memorias";
+    if (item.state === "denied")
+      return "Los permisos actuales no permiten esta consulta";
+    if (item.state === "partial")
+      return item.delivery === "delivered"
+        ? `Entregado a ${host} · Parte del contenido sigue procesándose`
+        : "Parte del contenido sigue procesándose";
+    if (item.delivery === "delivered") return `Entregado a ${host}`;
+    if (item.delivery === "not_delivered")
+      return "No se entregó a la aplicación";
+    return item.state === "empty"
+      ? "No se encontraron memorias relacionadas"
+      : "Consulta completada";
+  }
   if (item.state === "timed_out")
     return "后台正在整理记忆，查询超时，这次回答没有带上记忆";
   if (item.state === "unavailable")
@@ -100,8 +135,9 @@ export function callRowDetail(item: CallEvent) {
 export function callDetailHeadline(
   item: CallEvent,
   host = callHostName(item.host_id),
+  locale: GuiLocale = "zh-CN",
 ) {
-  return callEventHeadline(item, host);
+  return callEventHeadline(item, host, locale);
 }
 export function callDeliveryLabel(item: CallEvent) {
   if (item.delivery === "delivered")

memhub/apps/web/src/clock-stamp.ts

@@ -14,11 +14,15 @@
  * Unparseable input returns 时间未知 rather than a fabricated date. That string
  * is already asserted across several suites, so it stays exactly as-is.
  */
-export function clockStamp(value: string | null | undefined): string {
-  if (!value || !Number.isFinite(Date.parse(value))) return "时间未知";
+export function clockStamp(
+  value: string | null | undefined,
+  locale = "zh-CN",
+): string {
+  if (!value || !Number.isFinite(Date.parse(value)))
+    return locale === "es" ? "Hora desconocida" : "时间未知";
   const date = new Date(value);
   const now = new Date();
-  const clock = new Intl.DateTimeFormat("zh-CN", {
+  const clock = new Intl.DateTimeFormat(locale, {
     hour: "2-digit",
     minute: "2-digit",
   }).format(date);
@@ -27,8 +31,8 @@ export function clockStamp(value: string | null | undefined): string {
     date.getMonth() === now.getMonth() &&
     date.getDate() === now.getDate()
   )
-    return `今天 ${clock}`;
-  return new Intl.DateTimeFormat("zh-CN", {
+    return `${locale === "es" ? "Hoy" : "今天"} ${clock}`;
+  return new Intl.DateTimeFormat(locale, {
     month: "2-digit",
     day: "2-digit",
     hour: "2-digit",

memhub/apps/web/src/connection-prompt.ts

@@ -0,0 +1,34 @@
+/** Spanish presentation template. Technical snippets are opaque installation data. */
+export function connectionPromptSpanish(material: {
+  mcp: string;
+  shell: string | null;
+}): string {
+  return `Ayúdame a conectar esta herramienta a MemHub en este dispositivo. Los siguientes datos de configuración proceden de la instalación local; no son memorias.
+Primero comprueba si admites MCP stdio local o shell local. Un chat exclusivamente web, un contenedor remoto u otro equipo no pueden usar directamente estas rutas. Si no hay una interfaz compatible, dilo claramente: no afirmes que existe conexión. No crees un proxy público.
+Si admites MCP, integra el servicio one-memory siguiente en el formato de configuración de esta herramienta y conserva los demás servicios. Muestra primero la ubicación y los cambios, y espera mi confirmación antes de editar o ejecutar. No solicites ni copies las claves de MemHub.
+
+\`\`\`json
+${material.mcp}\`\`\`
+${
+  material.shell
+    ? `
+Si solo admites shell local, puedes consultar con el comando siguiente. Conserva el escape de las rutas y los argumentos del directorio de trabajo. Al sustituir el texto de consulta, conserva las comillas y el escape correctos:
+\`\`\`bash
+${material.shell}\`\`\`
+`
+    : ""
+}
+Tras conectar, realiza una consulta real e informa por separado si descubriste la herramienta, si devolvió resultados y si la respuesta utilizó sus fuentes. Escribir la configuración no demuestra una conexión correcta.
+En adelante, consulta MemHub cuando la respuesta dependa de mis decisiones, preferencias o restricciones anteriores, o continúe una tarea previa. No es necesario si no es pertinente ni en cada turno.
+Respeta los parámetros: MemHub_recall usa query; MemHub_ask usa question; MemHub_conversations usa query.
+Si MemHub_context está expuesto, usa query para consultar conjuntamente conversaciones originales y memorias consolidadas; no excluyas raw. Usa los originales pertinentes aunque la ruta memory esté vacía. raw_source_ids solo filtra originales. Revisa paths.raw y paths.memory por separado. Los originales no son memorias generadas. Cargar una Skill no es consultar memorias.
+Si ambas rutas están vacías, indica únicamente «He completado la consulta de memorias de MemHub» y continúa con el contexto del anfitrión. No digas que no existe historial ni que no se importó nada. Un resultado vacío no demuestra que se haya buscado en todo el historial.
+Usa MemHub_conversations y MemHub_ask solo si el anfitrión los expone y el alcance actual está autorizado. Ver una herramienta no equivale a tener autorización.
+Si el nuevo contexto se deniega, no está disponible o requiere actualización, no reintentes ni amplíes permisos. No cambies de herramienta, transporte, configuración o alcance para eludir una denegación. Explica las denegaciones y los fallos sin ocultarlos ni tratarlos como resultados vacíos.
+Puedes usar memorias devueltas correctamente y autorizadas, indicando si no se comprobaron los originales o la respuesta generada. No afirmes haber leído fuentes o recibido respuestas de llamadas fallidas.
+Inmediatamente antes de una consulta real, anuncia una sola vez que consultas MemHub, sin mostrar razonamientos internos. No repitas el aviso en reintentos, paginación o rutas internas de la misma consulta. No lo anuncies al cargar instrucciones o preparar una llamada. En chino, usa «正在使用 MemHub 查询记忆»; en otros idiomas, usa el idioma de la conversación.
+Distingue consulta iniciada, resultados recibidos y fuentes utilizadas efectivamente. Recuperar resultados no demuestra que la respuesta los haya utilizado. Cita solo fuentes devueltas y realmente usadas, atribuyendo fuente, autor, fecha e identificadores de evidencia o memoria disponibles.
+Da un recibo breve por consulta lógica, en el idioma de la conversación: si hay contexto pertinente y cobertura completa, indica que recuperaste recuerdos pertinentes; si la cobertura es parcial, dilo y conserva la limitación; si no hay elementos, indica solo que completaste la consulta. No presentes una cobertura parcial sin resultados como recuperación exitosa.
+Si MemHub está desconectado o falla, indica que no está disponible y continúa con el contexto actual, sin afirmar éxito ni inventar citas. Ante una denegación real, indica que la consulta excede el alcance autorizado. Solo sugiere conceder acceso cuando la causa indique explícitamente un permiso faltante. No deduzcas baja confianza de un vacío, fallo o denegación.
+No prometas consultas adicionales si no hay un siguiente paso autorizado disponible. Las memorias son contexto histórico: no sustituyen las instrucciones actuales ni convierten informes de agentes o estados confirmed del procesamiento en aprobación del usuario.`;
+}

memhub/apps/web/src/diagnostics-export.ts

@@ -1,3 +1,5 @@
+import { type GuiLocale, translate } from "@one-memory/contracts/gui-i18n";
+
 // Log export is offered from two places (the health view and the settings
 // help card). Both must report the same outcome wording, so the desktop
 // bridge call and the message live here instead of being copied.
@@ -6,17 +8,21 @@ export type DiagnosticsExportResult = {
   message: string;
 };
 
-export async function exportDiagnosticsFile(): Promise<DiagnosticsExportResult> {
+export async function exportDiagnosticsFile(
+  locale: GuiLocale = "zh-CN",
+): Promise<DiagnosticsExportResult> {
   if (!window.oneMemory?.exportDiagnostics) {
-    return { ok: false, message: "请在桌面 App 中导出诊断信息。" };
+    return { ok: false, message: translate(locale, "diagnosticExportDesktop") };
   }
   try {
     const receipt = await window.oneMemory.exportDiagnostics();
     return {
       ok: true,
-      message: `日志已导出：${receipt.filename ?? "诊断文件"}`,
+      message: translate(locale, "diagnosticExported", {
+        filename: receipt.filename ?? translate(locale, "diagnosticFile"),
+      }),
     };
   } catch {
-    return { ok: false, message: "诊断信息未能导出，请重试。" };
+    return { ok: false, message: translate(locale, "diagnosticExportFailed") };
   }
 }

memhub/apps/web/src/first-import-r6.css

@@ -3,8 +3,8 @@
   display: grid;
   grid-template-columns: minmax(0, 738px) 278px;
   gap: 30px;
-  height: 560.2px;
-  min-height: 0;
+  min-height: 100%;
+  height: auto;
 }
 .first-import-r6-main {
   min-width: 0;
@@ -35,13 +35,12 @@
   line-height: 20px;
 }
 .first-import-r6-main > .r6-import-progress {
-  flex: 0 0 218px;
+  flex: 0 0 auto;
 }
 .first-import-r6-feed {
-  min-height: 0;
-  flex: 1;
+  flex: 0 0 auto;
   margin-top: 26px;
-  overflow: auto;
+  overflow: visible;
   scrollbar-width: thin;
   overscroll-behavior: contain;
 }
@@ -225,10 +224,8 @@
   margin: 6px 0;
 }
 .first-import-r6-footer-note {
-  flex: 1;
+  flex: 1 1 240px;
   min-width: 0;
-  max-height: 64px;
-  overflow: auto;
 }
 .first-import-r6-footer-note p {
   margin: 0;
@@ -245,12 +242,15 @@
 }
 .first-import-r6-footer-actions {
   display: flex;
+  flex: 0 1 auto;
+  min-width: 0;
+  max-width: 100%;
   flex-wrap: wrap;
-  gap: 16px;
+  gap: 12px;
   align-items: center;
 }
 .first-import-r6-footer-actions > [data-variant="primary"] {
-  min-width: 210px;
+  min-width: min(160px, 100%);
 }
 .first-import-r6-footer-actions .r6-button-label {
   display: inline-flex;
@@ -403,18 +403,18 @@ dialog.first-import-r6-original[open] {
 }
 @media (min-width: 761px) and (max-height: 959px) {
   .onboarding-r6-body:has(> .first-import-r6-layout) {
-    overflow: hidden;
+    overflow-y: auto;
     padding-top: 16px;
     padding-bottom: 16px;
   }
   .first-import-r6-layout {
-    height: 100%;
+    height: auto;
   }
 }
 @media (min-width: 761px) and (max-height: 859px) {
   .first-import-r6-options {
     padding: 14px;
-    overflow: hidden;
+    overflow: visible;
   }
   .first-import-r6-eyebrow {
     margin-bottom: 4px;

memhub/apps/web/src/global.d.ts

@@ -6,6 +6,10 @@ import type {
   ConnectionSetupResult,
   ConnectionSetupSelection,
 } from "@one-memory/contracts";
+import type {
+  LanguagePreference,
+  LanguageSnapshot,
+} from "@one-memory/contracts/gui-i18n";
 import type { DebugLogSnapshot } from "./debug-log-types.js";
 
 export type RecallPermissionTool =
@@ -214,6 +218,13 @@ export interface RecallUninstallPreview {
 declare global {
   interface Window {
     oneMemory?: {
+      getLanguagePreference?(): Promise<LanguageSnapshot>;
+      setLanguagePreference?(
+        preference: LanguagePreference,
+      ): Promise<LanguageSnapshot>;
+      onLanguagePreferenceChanged?(
+        listener: (snapshot: LanguageSnapshot) => void,
+      ): () => void;
       getDebugLogs?(): Promise<DebugLogSnapshot>;
       /** Renderer end of the four-step UI/kernel trace. */
       logUiTrace?(input: {

memhub/apps/web/src/gui-language-lifecycle.test.tsx

@@ -0,0 +1,140 @@
+// @vitest-environment jsdom
+
+import type { LanguageSnapshot } from "@one-memory/contracts/gui-i18n";
+import { act, cleanup, render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { StrictMode } from "react";
+import { afterEach, beforeEach, expect, it, vi } from "vitest";
+import {
+  LANGUAGE_STORAGE_KEY,
+  LanguageProvider,
+  useGuiLanguage,
+} from "./gui-language";
+
+function Probe() {
+  const { locale, preference, error, setPreference } = useGuiLanguage();
+  return (
+    <>
+      <output>
+        {locale}:{preference}
+      </output>
+      <button type="button" onClick={() => void setPreference("es")}>
+        Spanish
+      </button>
+      {error && <p role="alert">{error}</p>}
+    </>
+  );
+}
+function mount() {
+  return render(
+    <StrictMode>
+      <LanguageProvider>
+        <Probe />
+      </LanguageProvider>
+    </StrictMode>,
+  );
+}
+beforeEach(() => {
+  localStorage.clear();
+  delete window.oneMemory;
+});
+afterEach(() => {
+  cleanup();
+  delete window.oneMemory;
+  vi.restoreAllMocks();
+  localStorage.clear();
+});
+
+it("removes browser listeners on StrictMode cleanup and final unmount", () => {
+  const add = vi.spyOn(window, "addEventListener");
+  const remove = vi.spyOn(window, "removeEventListener");
+  const view = mount();
+  view.unmount();
+  for (const type of ["storage", "languagechange"]) {
+    const callbacks = add.mock.calls
+      .filter(([name]) => name === type)
+      .map(([, callback]) => callback);
+    expect(callbacks).toHaveLength(2);
+    for (const callback of callbacks)
+      expect(remove).toHaveBeenCalledWith(type, callback);
+  }
+});
+it("ignores unrelated storage and language changes for explicit preferences", async () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "zh-CN");
+  mount();
+  vi.spyOn(navigator, "language", "get").mockReturnValue("es");
+  act(() => {
+    window.dispatchEvent(new Event("languagechange"));
+    window.dispatchEvent(
+      new StorageEvent("storage", { key: "unrelated", newValue: "es" }),
+    );
+    window.dispatchEvent(
+      new StorageEvent("storage", {
+        key: LANGUAGE_STORAGE_KEY,
+        storageArea: sessionStorage,
+      }),
+    );
+  });
+  expect(screen.getByText("zh-CN:zh-CN")).toBeTruthy();
+});
+it("shows errors for unavailable desktop bridges without using browser fallback", async () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+  window.oneMemory = {} as NonNullable<Window["oneMemory"]>;
+  const read = vi.spyOn(Storage.prototype, "getItem");
+  const write = vi.spyOn(Storage.prototype, "setItem");
+  mount();
+  expect(screen.getByRole("alert").textContent).toBe("languageLoadError");
+  await userEvent.click(screen.getByRole("button"));
+  expect(screen.getByRole("alert").textContent).toBe("languageSaveError");
+  expect(screen.getByText("zh-CN:system")).toBeTruthy();
+  expect(read).not.toHaveBeenCalled();
+  expect(write).not.toHaveBeenCalled();
+});
+it("does not surface a stale read rejection after an authoritative event", async () => {
+  let rejectRead!: (reason?: unknown) => void;
+  let listener!: (value: LanguageSnapshot) => void;
+  const pending = new Promise<LanguageSnapshot>((_, reject) => {
+    rejectRead = reject;
+  });
+  window.oneMemory = {
+    getLanguagePreference: () => pending,
+    onLanguagePreferenceChanged: (next: typeof listener) => {
+      listener = next;
+      return () => {};
+    },
+  } as NonNullable<Window["oneMemory"]>;
+  mount();
+  await act(async () => {
+    listener({ preference: "es", locale: "es", revision: 3 });
+    rejectRead(new Error("late failure"));
+  });
+  expect(screen.getByText("es:es")).toBeTruthy();
+  expect(screen.queryByRole("alert")).toBeNull();
+});
+it("validates native replies and keeps the last confirmed snapshot when saving fails", async () => {
+  const set = vi.fn().mockRejectedValue(new Error("denied"));
+  let listener!: (value: LanguageSnapshot) => void;
+  window.oneMemory = {
+    getLanguagePreference: async () => ({
+      preference: "bad",
+      locale: "es",
+      revision: 0,
+    }),
+    setLanguagePreference: set,
+    onLanguagePreferenceChanged: (next: typeof listener) => {
+      listener = next;
+      return () => {};
+    },
+  } as unknown as NonNullable<Window["oneMemory"]>;
+  mount();
+  await waitFor(() =>
+    expect(screen.getByRole("alert").textContent).toBe("languageLoadError"),
+  );
+  act(() => listener({ preference: "system", locale: "zh-CN", revision: 2 }));
+  await userEvent.click(screen.getByRole("button"));
+  expect(set).toHaveBeenCalledWith("es");
+  expect(screen.getByRole("alert").textContent).toBe("languageSaveError");
+  expect(screen.getByText("zh-CN:system")).toBeTruthy();
+  act(() => listener({ preference: "system", locale: "zh-CN", revision: 2 }));
+  expect(screen.queryByRole("alert")).toBeNull();
+});

memhub/apps/web/src/gui-language.test.tsx

@@ -0,0 +1,224 @@
+// @vitest-environment jsdom
+
+import type { LanguageSnapshot } from "@one-memory/contracts/gui-i18n";
+import { act, cleanup, render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { StrictMode } from "react";
+import { afterEach, beforeEach, expect, it, vi } from "vitest";
+import {
+  LANGUAGE_STORAGE_KEY,
+  LanguageProvider,
+  useGuiLanguage,
+} from "./gui-language";
+
+function deferred<T>() {
+  let resolve!: (value: T) => void;
+  let reject!: (reason?: unknown) => void;
+  const promise = new Promise<T>((yes, no) => {
+    resolve = yes;
+    reject = no;
+  });
+  return { promise, resolve, reject };
+}
+function Probe() {
+  const language = useGuiLanguage();
+  return (
+    <>
+      <output>
+        {language.locale}:{language.preference}
+      </output>
+      <input aria-label="draft" defaultValue="draft" />
+      <button onClick={() => void language.setPreference("es")} type="button">
+        Spanish
+      </button>
+      {language.error && <p role="alert">{language.error}</p>}
+    </>
+  );
+}
+function mount() {
+  return render(
+    <StrictMode>
+      <LanguageProvider>
+        <Probe />
+      </LanguageProvider>
+    </StrictMode>,
+  );
+}
+function desktop(get: () => Promise<LanguageSnapshot>) {
+  const listeners = new Set<(value: LanguageSnapshot) => void>();
+  const unsubscribe = vi.fn();
+  const bridge = {
+    getLanguagePreference: vi.fn(() => {
+      expect(listeners.size).toBe(1);
+      return get();
+    }),
+    setLanguagePreference: vi
+      .fn()
+      .mockResolvedValue({ preference: "es", locale: "es", revision: 2 }),
+    onLanguagePreferenceChanged: vi.fn(
+      (listener: (value: LanguageSnapshot) => void) => {
+        listeners.add(listener);
+        return () => {
+          listeners.delete(listener);
+          unsubscribe();
+        };
+      },
+    ),
+  };
+  window.oneMemory = bridge as unknown as NonNullable<Window["oneMemory"]>;
+  return { bridge, listeners, unsubscribe };
+}
+beforeEach(() => {
+  localStorage.clear();
+  delete window.oneMemory;
+  vi.spyOn(navigator, "language", "get").mockReturnValue("zh-CN");
+});
+afterEach(() => {
+  cleanup();
+  delete window.oneMemory;
+  vi.restoreAllMocks();
+  localStorage.clear();
+});
+
+it("persists before publishing and retains form state without remounting", async () => {
+  const user = userEvent.setup();
+  mount();
+  await user.type(screen.getByRole("textbox"), " preserved");
+  await user.click(screen.getByRole("button"));
+  expect(localStorage.getItem(LANGUAGE_STORAGE_KEY)).toBe("es");
+  expect(screen.getByText("es:es")).toBeTruthy();
+  expect(document.documentElement.lang).toBe("es");
+  expect((screen.getByRole("textbox") as HTMLInputElement).value).toBe(
+    "draft preserved",
+  );
+  cleanup();
+  mount();
+  expect(screen.getByText("es:es")).toBeTruthy();
+});
+it("keeps confirmed language and exposes storage write errors", async () => {
+  mount();
+  vi.spyOn(Storage.prototype, "setItem").mockImplementation(() => {
+    throw new Error("private storage");
+  });
+  await userEvent.click(screen.getByRole("button"));
+  expect(screen.getByText("zh-CN:system")).toBeTruthy();
+  expect(screen.getByRole("alert").textContent).toBe("languageSaveError");
+});
+it("exposes browser read errors without crashing", () => {
+  vi.spyOn(Storage.prototype, "getItem").mockImplementation(() => {
+    throw new Error("denied");
+  });
+  mount();
+  expect(screen.getByRole("alert").textContent).toBe("languageLoadError");
+});
+it("validates browser storage and synchronizes tabs and principal navigator language", () => {
+  localStorage.setItem(LANGUAGE_STORAGE_KEY, "invalid");
+  mount();
+  expect(screen.getByText("zh-CN:system")).toBeTruthy();
+  act(() => {
+    localStorage.setItem(LANGUAGE_STORAGE_KEY, "es");
+    window.dispatchEvent(
+      new StorageEvent("storage", {
+        key: LANGUAGE_STORAGE_KEY,
+        storageArea: localStorage,
+      }),
+    );
+  });
+  expect(screen.getByText("es:es")).toBeTruthy();
+  act(() => {
+    localStorage.removeItem(LANGUAGE_STORAGE_KEY);
+    window.dispatchEvent(
+      new StorageEvent("storage", { key: null, storageArea: localStorage }),
+    );
+  });
+  vi.spyOn(navigator, "language", "get").mockReturnValue("es-MX");
+  act(() => window.dispatchEvent(new Event("languagechange")));
+  expect(screen.getByText("es:system")).toBeTruthy();
+});
+it("subscribes before reads, rejects stale snapshots and cleans StrictMode subscriptions", async () => {
+  const reads = [deferred<LanguageSnapshot>(), deferred<LanguageSnapshot>()];
+  let index = 0;
+  const { listeners, unsubscribe } = desktop(() => reads[index++].promise);
+  const view = mount();
+  expect(listeners.size).toBe(1);
+  act(() => {
+    for (const listener of listeners)
+      listener({ preference: "es", locale: "es", revision: 5 });
+  });
+  await act(async () => {
+    for (const read of reads)
+      read.resolve({ preference: "zh-CN", locale: "zh-CN", revision: 1 });
+  });
+  expect(screen.getByText("es:es")).toBeTruthy();
+  view.unmount();
+  expect(listeners.size).toBe(0);
+  expect(unsubscribe).toHaveBeenCalledTimes(2);
+});
+it("never accesses browser persistence or browser locale in desktop mode and exposes read failures", async () => {
+  const { listeners } = desktop(() => Promise.reject(new Error("unavailable")));
+  const read = vi.spyOn(Storage.prototype, "getItem");
+  const write = vi.spyOn(Storage.prototype, "setItem");
+  mount();
+  await waitFor(() =>
+    expect(screen.getByRole("alert").textContent).toBe("languageLoadError"),
+  );
+  vi.spyOn(navigator, "language", "get").mockReturnValue("es");
+  act(() => window.dispatchEvent(new Event("languagechange")));
+  expect(screen.getByText("zh-CN:system")).toBeTruthy();
+  act(() => {
+    for (const listener of listeners)
+      listener({ preference: "system", locale: "es", revision: 3 });
+  });
+  expect(screen.queryByRole("alert")).toBeNull();
+  expect(screen.getByText("es:system")).toBeTruthy();
+  expect(read).not.toHaveBeenCalled();
+  expect(write).not.toHaveBeenCalled();
+});
+it("does not surface an obsolete write failure after a newer save succeeds", async () => {
+  const { bridge } = desktop(async () => ({
+    preference: "system",
+    locale: "zh-CN",
+    revision: 0,
+  }));
+  const first = deferred<LanguageSnapshot>();
+  bridge.setLanguagePreference
+    .mockReturnValueOnce(first.promise)
+    .mockResolvedValueOnce({ preference: "es", locale: "es", revision: 2 });
+  mount();
+  await act(async () => {});
+  await userEvent.click(screen.getByRole("button"));
+  await userEvent.click(screen.getByRole("button"));
+  expect(screen.getByText("es:es")).toBeTruthy();
+  await act(async () => first.reject(new Error("obsolete failure")));
+  expect(screen.queryByRole("alert")).toBeNull();
+});
+
+it("rejects conflicting native locale and explicit preference pairs", async () => {
+  desktop(async () => ({ preference: "es", locale: "zh-CN", revision: 1 }));
+  mount();
+  await waitFor(() =>
+    expect(screen.getByRole("alert").textContent).toBe("languageLoadError"),
+  );
+  expect(screen.getByText("zh-CN:system")).toBeTruthy();
+});
+
+it("does not allow a late write reply to overwrite a newer native event", async () => {
+  const { bridge, listeners } = desktop(async () => ({
+    preference: "system",
+    locale: "zh-CN",
+    revision: 0,
+  }));
+  const write = deferred<LanguageSnapshot>();
+  bridge.setLanguagePreference.mockReturnValue(write.promise);
+  mount();
+  await act(async () => {});
+  await userEvent.click(screen.getByRole("button"));
+  act(() => {
+    for (const listener of listeners)
+      listener({ preference: "zh-CN", locale: "zh-CN", revision: 8 });
+  });
+  await act(async () =>
+    write.resolve({ preference: "es", locale: "es", revision: 7 }),
+  );
+  expect(screen.getByText("zh-CN:zh-CN")).toBeTruthy();
+});

memhub/apps/web/src/gui-language.tsx

@@ -0,0 +1,206 @@
+import {
+  isLanguagePreference,
+  isLanguageSnapshot,
+  type LanguagePreference,
+  type LanguageSnapshot,
+  resolveGuiLocale,
+  translate,
+} from "@one-memory/contracts/gui-i18n";
+import {
+  createContext,
+  type ReactNode,
+  useContext,
+  useEffect,
+  useState,
+  useSyncExternalStore,
+} from "react";
+
+export const LANGUAGE_STORAGE_KEY = "one-memory.gui-language";
+type LanguageError = "languageLoadError" | "languageSaveError" | null;
+type State = LanguageSnapshot & { error: LanguageError };
+const initial: State = {
+  preference: "system",
+  locale: "zh-CN",
+  revision: 0,
+  error: null,
+};
+
+function createLanguageStore() {
+  let state = initial;
+  let revision = -1;
+  let generation = 0;
+  let writeRequest = 0;
+  let bridge: Window["oneMemory"];
+  const listeners = new Set<() => void>();
+  const publish = (next: State) => {
+    state = next;
+    for (const listener of listeners) listener();
+  };
+  const accept = (snapshot: unknown) => {
+    if (!isLanguageSnapshot(snapshot))
+      throw new Error("Invalid language snapshot");
+    if (snapshot.revision < revision) return;
+    if (
+      snapshot.revision === revision &&
+      (snapshot.preference !== state.preference ||
+        snapshot.locale !== state.locale)
+    )
+      return;
+    revision = snapshot.revision;
+    publish({ ...snapshot, error: null });
+  };
+  const readBrowser = () => {
+    try {
+      const stored = window.localStorage.getItem(LANGUAGE_STORAGE_KEY);
+      const preference = isLanguagePreference(stored) ? stored : "system";
+      publish({
+        preference,
+        locale: resolveGuiLocale(preference, navigator.language),
+        revision: state.revision + 1,
+        error: null,
+      });
+    } catch {
+      publish({ ...state, error: "languageLoadError" });
+    }
+  };
+  return {
+    getSnapshot: () => state,
+    subscribe(listener: () => void) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    start() {
+      const current = ++generation;
+      bridge = window.oneMemory;
+      if (bridge) {
+        let unsubscribe: (() => void) | undefined;
+        const beforeRead = revision;
+        try {
+          if (
+            !bridge.onLanguagePreferenceChanged ||
+            !bridge.getLanguagePreference
+          )
+            throw new Error("Language bridge unavailable");
+          unsubscribe = bridge.onLanguagePreferenceChanged((snapshot) => {
+            if (generation !== current) return;
+            try {
+              accept(snapshot);
+            } catch {
+              publish({ ...state, error: "languageLoadError" });
+            }
+          });
+          void bridge
+            .getLanguagePreference()
+            .then((snapshot) => {
+              if (generation === current) accept(snapshot);
+            })
+            .catch(() => {
+              if (generation === current && revision === beforeRead)
+                publish({ ...state, error: "languageLoadError" });
+            });
+        } catch {
+          publish({ ...state, error: "languageLoadError" });
+        }
+        return () => {
+          generation++;
+          unsubscribe?.();
+        };
+      }
+      const storage = (event: StorageEvent) => {
+        if (event.key !== null && event.key !== LANGUAGE_STORAGE_KEY) return;
+        try {
+          if (
+            event.storageArea !== null &&
+            event.storageArea !== window.localStorage
+          )
+            return;
+          readBrowser();
+        } catch {
+          publish({ ...state, error: "languageLoadError" });
+        }
+      };
+      const languageChange = () => {
+        if (state.preference === "system")
+          publish({
+            ...state,
+            locale: resolveGuiLocale("system", navigator.language),
+          });
+      };
+      window.addEventListener("storage", storage);
+      window.addEventListener("languagechange", languageChange);
+      readBrowser();
+      return () => {
+        generation++;
+        window.removeEventListener("storage", storage);
+        window.removeEventListener("languagechange", languageChange);
+      };
+    },
+    async setPreference(preference: LanguagePreference) {
+      const current = generation;
+      const request = ++writeRequest;
+      try {
+        if (!isLanguagePreference(preference))
+          throw new Error("Invalid language preference");
+        if (bridge) {
+          if (!bridge.setLanguagePreference)
+            throw new Error("Language bridge unavailable");
+          const snapshot = await bridge.setLanguagePreference(preference);
+          if (generation === current) accept(snapshot);
+        } else {
+          window.localStorage.setItem(LANGUAGE_STORAGE_KEY, preference);
+          publish({
+            preference,
+            locale: resolveGuiLocale(preference, navigator.language),
+            revision: state.revision + 1,
+            error: null,
+          });
+        }
+      } catch {
+        if (generation === current && request === writeRequest)
+          publish({ ...state, error: "languageSaveError" });
+      }
+    },
+  };
+}
+
+type LanguageContextValue = State & {
+  setPreference(preference: LanguagePreference): Promise<void>;
+};
+// Standalone components retain the historical Chinese UI without a provider.
+const LanguageContext = createContext<LanguageContextValue>({
+  ...initial,
+  setPreference: async () => {},
+});
+
+export function LanguageProvider({ children }: { children: ReactNode }) {
+  const [store] = useState(createLanguageStore);
+  const state = useSyncExternalStore(
+    store.subscribe,
+    store.getSnapshot,
+    store.getSnapshot,
+  );
+  useEffect(() => store.start(), [store]);
+  useEffect(() => {
+    document.documentElement.lang = state.locale;
+  }, [state.locale]);
+  return (
+    <LanguageContext.Provider
+      value={{ ...state, setPreference: store.setPreference }}
+    >
+      {children}
+    </LanguageContext.Provider>
+  );
+}
+
+export function useGuiLanguage() {
+  const language = useContext(LanguageContext);
+  return {
+    ...language,
+    t: (
+      key: Parameters<typeof translate>[1],
+      params?: Parameters<typeof translate>[2],
+    ) => translate(language.locale, key, params),
+  };
+}

memhub/apps/web/src/main.tsx

@@ -2,6 +2,7 @@ import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 
 import { App } from "./App";
+import { LanguageProvider } from "./gui-language";
 import { installNativeDisplayStyles } from "./native-display-styles";
 import { installRendererDebugLogCapture } from "./renderer-debug-log";
 import "./native-display-styles.css";
@@ -20,6 +21,8 @@ import.meta.hot?.dispose(stopRendererDebugLogs);
 
 createRoot(root).render(
   <StrictMode>
-    <App />
+    <LanguageProvider>
+      <App />
+    </LanguageProvider>
   </StrictMode>,
 );

memhub/apps/web/src/memory-language.ts

@@ -0,0 +1,316 @@
+import type { GuiLocale } from "@one-memory/contracts/gui-i18n";
+import { useGuiLanguage } from "./gui-language";
+
+// Only explicit interface copy belongs here. Imported text is never passed in.
+const spanish: Record<string, string> = {
+  记忆抽取: "Extracción de memorias",
+  关系归纳: "Síntesis de relaciones",
+  深度整理: "Procesamiento profundo",
+  跨域整理: "Procesamiento entre áreas",
+  当前模型已变化: "El modelo actual cambió",
+  本地会话内容已变化: "El contenido de las conversaciones locales cambió",
+  "这段对话含过长原文，暂未整理；原文已保留":
+    "Esta conversación contiene texto demasiado largo y no se procesó; el original se conservó",
+  记忆库分页: "Paginación de la biblioteca de memorias",
+  上一页: "Página anterior",
+  下一页: "Página siguiente",
+  等待可用生成模型: "Esperando un modelo disponible",
+  还没有启用生成模型: "No hay un modelo de generación activo",
+  "缺少生成模型 API Key": "Falta la clave API del modelo",
+  模型凭据暂不可用: "Credenciales del modelo no disponibles",
+  本机凭据存储暂不可用: "Almacén local de credenciales no disponible",
+  "需要授权访问本机钥匙串。请重新打开 App 并完成一次授权":
+    "Se necesita permiso para acceder al llavero. Vuelve a abrir la aplicación y completa la autorización",
+  "读取本机钥匙串超时。重新保存一遍模型配置即可恢复":
+    "La lectura del llavero agotó el tiempo. Vuelve a guardar la configuración del modelo",
+  "写入本机钥匙串超时。重新保存一遍模型配置即可恢复":
+    "La escritura del llavero agotó el tiempo. Vuelve a guardar la configuración del modelo",
+  "模型认证失败。更新 key 后，到设置里点一次检测，会自动接着处理":
+    "Falló la autenticación. Actualiza la clave y comprueba la conexión en Configuración para continuar",
+  "模型账户余额不足。充值或换 key 后，到设置里点一次检测，会自动接着处理":
+    "Saldo del proveedor insuficiente. Recarga o cambia la clave y comprueba la conexión en Configuración",
+  "模型服务拒绝访问。更新权限后，到设置里点一次检测，会自动接着处理":
+    "El proveedor rechazó el acceso. Actualiza los permisos y comprueba la conexión en Configuración",
+  模型服务限流: "Límite de solicitudes del proveedor",
+  模型服务暂不可用: "Servicio del modelo no disponible",
+  模型服务响应超时: "El modelo agotó el tiempo de respuesta",
+  "模型请求不兼容，请核对配置":
+    "Solicitud incompatible; revisa la configuración",
+  模型请求未成功: "La solicitud al modelo no se completó",
+  "HY Memory 不可用": "HY Memory no está disponible",
+  "HY Memory 启动失败": "HY Memory no pudo iniciarse",
+
+  查看已读内容: "Ver contenido leído",
+  已保存原文: "Texto original guardado",
+  刷新已读内容: "Actualizar contenido leído",
+  "正在核对本机已保存记录…": "Verificando registros guardados en este equipo…",
+  原始消息: "Mensajes originales",
+  会话: "Conversaciones",
+  用户发言: "Mensajes del usuario",
+  "Agent 发言": "Mensajes del agente",
+  作者未知: "Autor desconocido",
+  原始时间未知: "Fecha original desconocida",
+  工具记录: "Registros de herramientas",
+  "原始时间来自已保存记录。":
+    "Las fechas originales proceden de los registros guardados.",
+  已保存的原文样例: "Ejemplos de texto original guardado",
+  "最多展示 3 段，不代表全部历史或推荐记忆。":
+    "Se muestran hasta 3 fragmentos, no el historial completo ni memorias recomendadas.",
+  查看完整对话: "Ver conversación completa",
+  "原文较长，此处仅展示前 600 个字符。":
+    "Texto largo: se muestran los primeros 600 caracteres.",
+  "这个来源还没有保存原文。":
+    "Aún no hay texto original guardado de este origen.",
+  完整对话: "Conversación completa",
+  关闭完整对话: "Cerrar conversación completa",
+  用户: "Usuario",
+  "暂时无法读取已保存内容，旧回执已收起。请检查授权或重试。":
+    "No se puede leer el contenido guardado. Se ocultó el informe anterior; revisa los permisos o reintenta.",
+  "这段原文暂不可读，可能已被撤回授权。请刷新回执。":
+    "Este texto no está disponible; es posible que se hayan revocado sus permisos. Actualiza el informe.",
+
+  外部记忆召回范围: "Ámbito de consulta externa",
+  外部记忆召回: "Consulta externa de memorias",
+  调整召回范围: "Ajustar ámbito de consulta",
+  所有关联工具: "Todas las herramientas vinculadas",
+  已停止外部记忆召回: "Consulta externa desactivada",
+  原有限定范围: "Ámbito limitado original",
+  选择召回范围: "Elegir ámbito de consulta",
+  停止外部记忆召回: "Desactivar consulta externa",
+  "正在保存…": "Guardando…",
+  保存召回范围: "Guardar ámbito de consulta",
+  取消范围修改: "Cancelar cambio de ámbito",
+  "原文检索仍按来源授权；已带出的内容不会撤回。":
+    "La búsqueda del texto original sigue los permisos del origen. El contenido ya enviado no se retira.",
+  "记忆已更新，请重新打开这条记忆后再调整范围。":
+    "La memoria cambió. Vuelve a abrirla antes de ajustar el ámbito.",
+  "范围修改未提交，当前范围保持不变。请修正后重试。":
+    "No se envió el cambio; se conserva el ámbito actual. Corrige el problema y reintenta.",
+  "保存结果尚未确认，请重试。": "El guardado no está confirmado. Reinténtalo.",
+  "原话已保存在本机；当前内容、模型接收方或授权版本尚未通过核对，未继续整理。":
+    "El texto está guardado en este equipo. No se continuó el procesamiento porque falta verificar el contenido, el modelo receptor o la versión de autorización.",
+  "HY 未返回可核对的已有记忆，未创建替代内容；原始记录已保留，可重试处理。":
+    "HY no devolvió memorias verificables. No se creó contenido sustituto; los originales se conservan y puedes reintentar.",
+  "历史引用尚未绑定到原始来源，当前批次未完成，原话已保留。":
+    "Las referencias históricas aún no están vinculadas a su origen. El lote está incompleto; el texto se conserva.",
+  "记忆内容未通过来源与作者核验，当前批次未完成，原话已保留。":
+    "No se pudo verificar el origen y autor de la memoria. El lote está incompleto; el texto se conserva.",
+  "所选记忆已不可读取，请重新读取记忆库。":
+    "La memoria seleccionada ya no está disponible. Actualiza la biblioteca.",
+  "还没连上本地 Core，正在重试…": "Conectando con Core local; reintentando…",
+  "记忆内容或使用权限已变化，回答已停止。请重新提问。":
+    "El contenido o los permisos cambiaron. La respuesta se detuvo; vuelve a preguntar.",
+  "这条记忆的来源授权已撤回，暂时不能读取。":
+    "Se revocó el permiso del origen de esta memoria; no se puede leer.",
+  "记忆已被更新，请刷新后重试。":
+    "La memoria cambió. Actualiza antes de reintentar.",
+  "已删除的记忆不能修改。": "No se puede editar una memoria eliminada.",
+  "这条记忆已经删除。": "Esta memoria ya se eliminó.",
+  "这条记忆已被更新的记忆取代，只能查看或删除。":
+    "Esta memoria fue sustituida; solo puedes verla o eliminarla.",
+  "没有更早的修改可以撤销。": "No hay cambios anteriores que deshacer.",
+  "来源原话已不存在，无法建立这条记忆。":
+    "El texto original ya no existe; no se puede crear la memoria.",
+  "这次操作与已完成的请求不一致。":
+    "La operación no coincide con la solicitud ya completada.",
+  "输入内容不符合要求。": "El contenido no cumple los requisitos.",
+  "本地记忆库正忙，请稍后重试。":
+    "La biblioteca local está ocupada. Reinténtalo más tarde.",
+
+  记忆: "Memorias",
+  记忆空间: "Espacio de memorias",
+  全部应用: "Todas las aplicaciones",
+  来源: "Origen",
+  主题: "Temas",
+  归纳: "Patrones",
+  全部记忆: "Todas las memorias",
+  来源待核对: "Origen sin verificar",
+  所选来源待核对: "Origen seleccionado sin verificar",
+  未知来源: "Origen desconocido",
+  记忆读取失败: "Error al leer las memorias",
+  "正在读取…": "Leyendo…",
+  "正在更新…": "Actualizando…",
+  读取失败: "Error de lectura",
+  "正在核对来源…": "Verificando orígenes…",
+  "正在导入历史会话，记忆将陆续出现":
+    "Importando el historial; las memorias aparecerán progresivamente",
+  记忆工作台: "Panel de memorias",
+  来源与主题: "Orígenes y temas",
+  记忆或原始对话: "Memorias o conversaciones originales",
+  原始对话: "Conversaciones originales",
+  地图组织方式: "Organización del mapa",
+  筛选地图记忆: "Filtrar memorias del mapa",
+  搜索原始对话: "Buscar conversaciones originales",
+  搜索记忆: "Buscar memorias",
+  "筛选记忆…": "Filtrar memorias…",
+  刷新地图记忆: "Actualizar memorias",
+  关闭新增记忆提示: "Cerrar aviso de nuevas memorias",
+  地图记忆列表: "Lista de memorias del mapa",
+  "记忆读取失败，请重试。": "No se pudieron leer las memorias. Reinténtalo.",
+  重新读取地图记忆: "Volver a leer las memorias",
+  没有匹配的记忆: "No hay memorias que coincidan",
+  本页没有匹配的主题记忆: "No hay memorias de este tema en la página",
+  还没有已生成的记忆: "Aún no hay memorias generadas",
+  地图记忆分页: "Paginación de memorias",
+  上一页记忆: "Página anterior de memorias",
+  下一页记忆: "Página siguiente de memorias",
+  记忆关系图: "Grafo de memorias",
+  "主题视角（非事项）": "Vista por temas",
+  来源视角: "Vista por origen",
+  记忆关联: "Relaciones entre memorias",
+  "刚导入的原话，还不是沉淀后的记忆":
+    "Conversaciones importadas, aún sin convertir en memorias",
+  来源归属: "Relación con el origen",
+  可在沉淀记忆后查看视图:
+    "La vista estará disponible cuando se generen memorias",
+  查看选中来源原文: "Ver texto del origen seleccionado",
+  查看选中记忆原文: "Ver texto de la memoria seleccionada",
+  查看原文: "Ver texto original",
+  整理已有关系: "Organizar relaciones existentes",
+  "正在读取原文…": "Leyendo texto original…",
+  选择一条原始对话: "Selecciona una conversación original",
+  记忆暂时无法读取: "Las memorias no están disponibles",
+  当前筛选没有可显示的记忆: "No hay memorias para este filtro",
+  "正在读取记忆…": "Leyendo memorias…",
+  已保存的对话还未生成记忆:
+    "Las conversaciones guardadas aún no han generado memorias",
+  还没有可显示的记忆: "Aún no hay memorias para mostrar",
+  连线表示来源归属: "Las líneas indican el origen",
+  记忆详情: "Detalles de la memoria",
+  来源原文: "Texto original",
+  关联节点: "Nodo relacionado",
+  关闭记忆详情: "Cerrar detalles de la memoria",
+  关闭详情: "Cerrar detalles",
+  "正在读取这条记忆…": "Leyendo esta memoria…",
+  "这条记忆的原文暂时无法读取，选择已保留。":
+    "No se puede leer el texto original. La selección se conserva.",
+  重试读取原文: "Reintentar lectura del original",
+  已沉淀的记忆: "Memorias guardadas",
+  "正在读取记忆详情…": "Leyendo detalles…",
+  沉淀记忆后查看详情:
+    "Los detalles estarán disponibles cuando se generen memorias",
+  时间未知: "Hora desconocida",
+  来源原文已不可读取: "El texto original ya no está disponible",
+  关联记忆: "Memorias relacionadas",
+  "正在读取完整对话…": "Leyendo conversación completa…",
+  重试读取完整对话: "Reintentar lectura de la conversación",
+  看完整对话: "Ver conversación completa",
+  今天: "Hoy",
+  你: "Tú",
+  助手: "Asistente",
+  工具: "Herramienta",
+  未知: "Desconocido",
+  作者待核对: "Autor sin verificar",
+  你说: "Tus palabras",
+  助手原话: "Palabras del asistente",
+  已沉淀: "Guardada",
+  已删除: "Eliminada",
+  已被取代: "Sustituida",
+  状态待核对: "Estado sin verificar",
+  编辑: "Editar",
+  原始依据: "Evidencia original",
+  "这段原文当前不可查看。": "Este texto original no está disponible.",
+  版本记录: "Historial de versiones",
+  更多管理: "Más opciones",
+  撤销上次修改: "Deshacer último cambio",
+  删除记忆: "Eliminar memoria",
+  编辑记忆: "Editar memoria",
+  返回记忆: "Volver a la memoria",
+  "修改这条记忆，原始对话保持不变。":
+    "Edita esta memoria sin modificar la conversación original.",
+  记忆内容: "Contenido de la memoria",
+  使用范围保持不变: "El ámbito de uso no cambia",
+  已有新版本: "Hay una nueva versión",
+  "你的草稿已保留，先查看新版本再决定如何修改。":
+    "Tu borrador se conserva. Revisa la nueva versión antes de editar.",
+  查看新版本: "Ver nueva versión",
+  基于此版本继续编辑: "Continuar editando esta versión",
+  取消: "Cancelar",
+  保存修改: "Guardar cambios",
+  对应记忆: "Memoria correspondiente",
+  查看记忆: "Ver memoria",
+  "删除这条记忆？": "¿Eliminar esta memoria?",
+  "删除后不再用于新的召回，来源 App 中的原始对话不会删除。":
+    "Dejará de usarse en nuevas consultas. La conversación original de la aplicación no se eliminará.",
+  "已经发送给应用的内容无法远程收回。":
+    "No es posible retirar el contenido ya enviado a otras aplicaciones.",
+  "放弃尚未保存的修改？": "¿Descartar los cambios sin guardar?",
+  "来源权限已变化或原文不可用。":
+    "Los permisos del origen han cambiado o el texto no está disponible.",
+  "暂时无法读取新版本，草稿已保留。":
+    "No se pudo leer la nueva versión. Tu borrador se conserva.",
+  "修改未提交；草稿已保留。请按提示修正后重试。":
+    "Los cambios no se enviaron. Tu borrador se conserva; corrígelo y reinténtalo.",
+  "修改尚未确认，草稿已保留。请先刷新核对，避免重复提交。":
+    "Los cambios no están confirmados. Tu borrador se conserva; actualiza antes de volver a enviarlo.",
+  "删除未提交。请核对这条记忆的状态后重试。":
+    "La eliminación no se envió. Verifica el estado de la memoria antes de reintentar.",
+  "删除尚未确认。请重新核对记忆状态，不会自动扩大删除范围。":
+    "La eliminación no está confirmada. Verifica el estado; no se eliminará ningún contenido adicional automáticamente.",
+  "撤销未提交。请按提示修正后重试。":
+    "No se envió la acción de deshacer. Corrige el problema y reintenta.",
+  "撤销尚未确认，请先核对当前记忆版本，避免重复撤销。":
+    "La acción de deshacer no está confirmada. Verifica la versión antes de reintentar.",
+  添加记忆: "Añadir memoria",
+  关闭新增记忆: "Cerrar nueva memoria",
+  关闭: "Cerrar",
+  记下这件事: "¿Qué quieres recordar?",
+  "例如：项目周会不排在周五。":
+    "Por ejemplo: no programar reuniones del proyecto los viernes.",
+  "整理模型：": "Modelo: ",
+  "尚未配置，原话仍可保存": "Sin configurar; puedes guardar el texto",
+  正在读取: "Leyendo",
+  配置模型: "Configurar modelo",
+  "保存中…": "Guardando…",
+  保存原话: "Guardar texto",
+  最近添加: "Añadidas recientemente",
+  重新整理: "Volver a procesar",
+  "原话已保存，等待可用模型": "Texto guardado; esperando un modelo",
+  "原话已保存，等待整理": "Texto guardado; pendiente de procesar",
+  正在整理: "Procesando",
+  "原话已保存，整理未完成": "Texto guardado; procesamiento incompleto",
+  整理已完成: "Procesamiento completado",
+  "原话已保存，未提取出可用记忆":
+    "Texto guardado; no se extrajeron memorias utilizables",
+  "最近添加的内容读取失败。": "No se pudieron leer las notas recientes.",
+  "整理状态暂时不可用，原话已保存。":
+    "Estado del procesamiento no disponible. El texto está guardado.",
+  "已保存，正在后台沉淀记忆": "Guardado; generando memorias en segundo plano",
+  "未能确认保存结果，输入已保留。重试不会重复添加。":
+    "No se pudo confirmar el guardado. Tu texto se conserva; reintentar no lo duplicará.",
+  "整理未能开始，原话仍已保存。":
+    "No se pudo iniciar el procesamiento. El texto sigue guardado.",
+  "整理结果尚未确认，原话仍已保存。请刷新后核对。":
+    "El resultado no está confirmado. El texto sigue guardado; actualiza para verificarlo.",
+  "模型服务要求检查余额或付款状态，原话仍已保存。":
+    "Revisa el saldo o los pagos del proveedor. El texto sigue guardado.",
+  "这台设备打不开 3D 视图，已显示关联列表。":
+    "La vista 3D no está disponible en este equipo. Se muestran las relaciones en una lista.",
+  图谱工具: "Herramientas del grafo",
+  放大: "Acercar",
+  放大图谱: "Acercar grafo",
+  缩小: "Alejar",
+  缩小图谱: "Alejar grafo",
+  重置视角: "Restablecer vista",
+  重置图谱视角: "Restablecer vista del grafo",
+  查看读取详情: "Ver detalles de lectura",
+  配置整理模型: "Configurar modelo",
+  原文暂时无法读取: "Texto original no disponible",
+  "暂时无法读取这段对话，已保留当前记忆。":
+    "No se puede leer la conversación. La memoria actual se conserva.",
+  "已清除筛选，定位到关联记忆。":
+    "Filtros eliminados; memoria relacionada localizada.",
+  "所选记忆不在当前筛选内，已取消选择。":
+    "La memoria seleccionada no está en este filtro. Se canceló la selección.",
+};
+export function memoryText(locale: GuiLocale, message: string): string {
+  return locale === "es" ? (spanish[message] ?? message) : message;
+}
+export function useMemoryLanguage() {
+  const { locale } = useGuiLanguage();
+  return {
+    locale,
+    text: (message: string) => memoryText(locale, message),
+    count: (value: number) => new Intl.NumberFormat(locale).format(value),
+  };
+}

memhub/apps/web/src/onboarding-language.ts

@@ -0,0 +1,20 @@
+import { type MessageKey, translate } from "@one-memory/contracts/gui-i18n";
+import { useGuiLanguage } from "./gui-language";
+
+/** Translate presentation copy at render time, retaining external names and unknown errors. */
+export function useOnboardingTranslation() {
+  const { t, locale } = useGuiLanguage();
+  return {
+    locale,
+    text: (message: string) => {
+      if (message.startsWith("操作没成功："))
+        return translate(locale, "onboardingModelOperationFailed", {
+          code: message.slice("操作没成功：".length),
+        });
+      const translated = t(message as MessageKey);
+      return typeof translated === "string" ? translated : message;
+    },
+    t: (key: MessageKey, params?: Record<string, string | number>) =>
+      translate(locale, key, params),
+  };
+}

memhub/apps/web/src/onboarding-model-r6.css

@@ -1,7 +1,7 @@
 /* P3 source 143:2786 / 2854 / 2936; shared shell stays in R6ColdStartFrame. */
 .onboarding-model-r6 .onboarding-r6-head > div {
   width: 620px;
-  max-width: calc(100% - 320px);
+  max-width: 100%;
 }
 .onboarding-model-layout {
   display: grid;
@@ -234,7 +234,7 @@
   font-size: 12px;
 }
 .onboarding-model-footer-note {
-  flex: 1;
+  flex: 1 1 260px;
   min-width: 0;
   font-size: 12px;
   line-height: 24px;
@@ -243,13 +243,24 @@
 }
 .onboarding-model-footer-actions {
   display: flex;
-  gap: 16px;
-  width: 398px;
+  flex: 0 1 auto;
+  flex-wrap: wrap;
+  min-width: 0;
+  max-width: 100%;
+  gap: 12px;
+  margin-left: auto;
   justify-content: flex-end;
+  align-items: stretch;
 }
 .onboarding-model-footer-actions .r6-button {
-  width: 150px;
-  height: 44px;
+  flex: 1 1 auto;
+  min-width: 0;
+  max-width: 100%;
+  width: auto;
+  height: auto;
+  padding: 10px 20px;
+  white-space: normal;
+  overflow-wrap: anywhere;
   min-height: 44px;
   border-radius: 8px;
   font-size: 14px;
@@ -257,7 +268,7 @@
   background: rgb(255 255 255 / 34%);
 }
 .onboarding-model-footer-actions .r6-button[data-variant="primary"] {
-  width: 210px;
+  width: auto;
   background: var(--r6-action);
   color: white;
   border-color: #5b6f7e;
@@ -268,12 +279,24 @@
   border-color: var(--r6-control-edge);
 }
 .onboarding-model-advanced-head {
-  display: block;
-  height: 28px;
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 16px;
   font-size: 13px;
   line-height: 21px;
   color: #63707b;
 }
+.onboarding-model-advanced-head .onboarding-model-toggle {
+  margin-top: 0;
+  padding: 6px 0;
+  gap: 12px;
+  text-align: left;
+  white-space: normal;
+}
+.onboarding-model-advanced-head .onboarding-model-toggle svg {
+  flex-shrink: 0;
+}
 .onboarding-model-advanced-grid {
   display: grid;
   grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
@@ -362,11 +385,10 @@
     gap: 24px;
   }
 }
-@media (min-width: 761px) and (max-height: 959px) {
+/* One scroll owner for the editable pane; the disclosure scrolls independently. */
+@media (min-width: 761px) {
   .onboarding-model-r6 .onboarding-r6-body {
     overflow: hidden;
-    padding-top: 16px;
-    padding-bottom: 16px;
   }
   .onboarding-model-layout {
     height: 100%;
@@ -382,11 +404,21 @@
     overscroll-behavior: contain;
     scrollbar-width: thin;
     scrollbar-gutter: stable;
-    scroll-padding: 4px;
+    scroll-padding: 12px;
+    padding-inline: 4px 16px;
   }
   .onboarding-model-recovery-actions {
     flex-shrink: 0;
   }
+}
+.onboarding-model-field select {
+  padding-inline-end: 32px;
+}
+@media (min-width: 761px) and (max-height: 959px) {
+  .onboarding-model-r6 .onboarding-r6-body {
+    padding-top: 16px;
+    padding-bottom: 16px;
+  }
   .onboarding-model-feedback {
     flex: 0 1 auto;
     min-height: 0;
@@ -473,9 +505,14 @@
     width: 100%;
     gap: 12px;
   }
+  .onboarding-model-footer-actions .r6-button,
   .onboarding-model-footer-actions .r6-button[data-variant="primary"] {
-    width: auto;
-    flex: 1;
+    flex: 1 1 160px;
+  }
+}
+@media (max-width: 480px) {
+  .onboarding-model-advanced-grid {
+    grid-template-columns: minmax(0, 1fr);
   }
 }
 @media (prefers-reduced-transparency: reduce) {

memhub/apps/web/src/onboarding-r6.css

@@ -24,15 +24,68 @@
 .onboarding-r6 [hidden] {
   display: none;
 }
+/* Onboarding owns its drag strip; the global overlay would intercept the select. */
+.desktop-frame:has(.onboarding-r6) > .window-drag-region {
+  display: none;
+}
 .onboarding-r6-titlebar {
   position: relative;
-  flex: 0 0 58px;
+  flex: 0 0 auto;
+  min-height: 58px;
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
+  padding: 8px 24px 8px 88px;
   border-bottom: 1px solid #ffffffa8;
   background: #ffffff30;
   backdrop-filter: blur(40px);
   user-select: none;
   -webkit-app-region: drag;
 }
+.onboarding-r6-titlebar .r6-language-selector--compact {
+  min-width: 0;
+  max-width: 100%;
+  -webkit-app-region: no-drag;
+}
+.onboarding-r6-titlebar .r6-language-selector-row {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 6px 10px;
+  font-size: 12px;
+}
+.onboarding-r6-titlebar select {
+  min-width: 0;
+  max-width: 100%;
+  min-height: 32px;
+  padding: 4px 8px;
+  border: 1px solid #9badbd;
+  border-radius: 8px;
+  color: inherit;
+  background: #f7fafc;
+  font: inherit;
+}
+.onboarding-r6-titlebar select:focus-visible {
+  outline: 2px solid #356d99;
+  outline-offset: 2px;
+}
+.onboarding-r6-titlebar [role="alert"] {
+  margin: 6px 0 0;
+  max-width: 320px;
+  color: #9f3333;
+  font-size: 12px;
+  overflow-wrap: anywhere;
+}
+@media (max-width: 480px) {
+  .onboarding-r6-titlebar {
+    padding-right: 12px;
+  }
+  .onboarding-r6-titlebar .r6-language-selector-row {
+    flex-direction: column;
+    align-items: flex-end;
+  }
+}
 .onboarding-r6
   :is(
     button,
@@ -52,6 +105,7 @@
   padding: 32px 24px 2px;
 }
 .onboarding-r6-shell {
+  min-height: 0;
   width: 1120px;
   max-width: 100%;
   height: 820px;
@@ -69,8 +123,13 @@
     inset 0 -1px 0 #adc0d22e;
 }
 .onboarding-r6-head {
-  min-height: 0;
-  flex: 0 0 123.7px;
+  min-height: 123.7px;
+  flex: 0 0 auto;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 22px 32px;
   position: relative;
   border-bottom: 1px solid #ffffffc4;
   background: linear-gradient(115deg, #ffffff57, #ffffff0a);
@@ -78,8 +137,11 @@
   border-radius: 25px 25px 0 0;
 }
 .onboarding-r6-head > div {
+  flex: 1 1 360px;
+  min-width: 0;
   width: 450px;
-  max-width: calc(100% - 320px);
+  max-width: 100%;
+  overflow-wrap: anywhere;
 }
 .onboarding-r6-head p {
   margin: 0 0 10px;
@@ -94,12 +156,10 @@
   line-height: 43px;
 }
 .onboarding-r6-head .r6-stepper {
-  position: absolute;
-  top: 42px;
-  right: 36px;
+  margin-top: 14px;
 }
 .onboarding-r6-head .r6-stepper li {
-  height: 36px;
+  min-height: 36px;
   padding: 0 0 12px;
   align-items: flex-start;
   line-height: 18px;
@@ -107,11 +167,15 @@
 .onboarding-r6-body {
   flex: 1;
   min-height: 0;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  scrollbar-width: thin;
   padding: 26px 36px;
 }
 .onboarding-r6-foot {
-  min-height: 0;
-  flex: 0 0 82.1px;
+  min-height: 82.1px;
+  flex: 0 0 auto;
+  flex-wrap: wrap;
   padding: 20px 36px 18px;
   border-top: 1px solid #ffffffc4;
   background: #ffffff38;
@@ -202,13 +266,9 @@
   position: absolute;
   inset: 142px 0 auto;
 }
-.onboarding-r6-list-area::after {
-  content: "";
-  position: absolute;
-  inset: auto 0 0;
-  height: 40px;
-  pointer-events: none;
-  background: linear-gradient(180deg, transparent, #f7fafc 92%);
+.onboarding-r6-list-status .onboarding-r6-quiet:disabled {
+  color: #4e6478;
+  opacity: 1;
 }
 .onboarding-r6-list {
   padding: 0;
@@ -464,9 +524,17 @@
   color: #4e6478;
 }
 .onboarding-r6-submit {
-  width: 138px;
+  width: auto;
+  min-width: 138px;
   margin-left: auto;
 }
+.onboarding-r6-foot .r6-button {
+  max-width: 100%;
+  height: auto;
+  padding-block: 10px;
+  white-space: normal;
+  overflow-wrap: anywhere;
+}
 .onboarding-r6 .r6-button[data-variant="primary"]:not(:disabled) {
   background: #4f6373;
   border-color: #5b6f7e;
@@ -605,12 +673,12 @@
     flex-basis: auto;
   }
   .onboarding-r6-head > div {
+    flex-basis: 100%;
     max-width: 100%;
     width: auto;
   }
   .onboarding-r6-head .r6-stepper {
-    position: static;
-    margin-top: 22px;
+    margin-top: 0;
   }
   .onboarding-r6-body {
     padding: 24px 20px;

memhub/apps/web/src/query-client.test-setup.ts

@@ -1,6 +1,12 @@
-import { afterEach } from "vitest";
+import { afterEach, beforeEach, vi } from "vitest";
 import { resetClient } from "./query-client";
 
+beforeEach(() => {
+  if (typeof navigator !== "undefined") {
+    vi.spyOn(navigator, "language", "get").mockReturnValue("zh-CN");
+  }
+});
+
 afterEach(() => {
   resetClient();
 });

memhub/apps/web/src/r6-controls.css

@@ -118,11 +118,13 @@ button.r6-button[data-variant="quiet"]:disabled {
 
 .r6-stepper {
   width: 288px;
-  height: 40px;
+  max-width: 100%;
+  min-height: 40px;
   flex-shrink: 0;
 }
 .r6-stepper ol {
-  display: flex;
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
   gap: 18px;
   list-style: none;
   padding: 0;
@@ -134,8 +136,9 @@ button.r6-button[data-variant="quiet"]:disabled {
   align-items: center;
   gap: 7px;
   box-sizing: border-box;
-  width: 84px;
-  height: 40px;
+  min-width: 0;
+  min-height: 40px;
+  height: auto;
   padding-bottom: 12px;
   border-bottom: 2px solid #cbd6de;
   color: var(--r6-muted);
@@ -144,7 +147,8 @@ button.r6-button[data-variant="quiet"]:disabled {
     "PingFang SC",
     sans-serif;
   letter-spacing: 0;
-  white-space: nowrap;
+  white-space: normal;
+  overflow-wrap: normal;
   transition: color 220ms ease;
 }
 /* The active rail is drawn as an overlay that wipes in, rather than by
@@ -171,6 +175,7 @@ button.r6-button[data-variant="quiet"]:disabled {
   transform: scaleX(1);
 }
 .r6-stepper li > span {
+  flex-shrink: 0;
   font-size: 10px;
   font-variant-numeric: tabular-nums;
 }

memhub/apps/web/src/r6-import-progress.css

@@ -2,7 +2,7 @@
 .r6-import-progress {
   display: grid;
   grid-auto-flow: column;
-  grid-auto-columns: calc((100% - 32px) / 3);
+  grid-auto-columns: max(140px, calc((100% - 32px) / 3));
   gap: 16px;
   width: 100%;
   overflow-x: auto;
@@ -22,7 +22,7 @@
 .r6-import-progress-card {
   box-sizing: border-box;
   position: relative;
-  height: 218px;
+  min-height: 218px;
   min-width: 0;
   padding: 16px 12px 12px;
   background:

memhub/apps/web/src/r6-memory.css

@@ -204,6 +204,19 @@
 .r6-memory .memory-processing-details {
   margin: 0 0 16px;
 }
+.r6-memory .memory-library-pagination {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px 12px;
+  min-width: 0;
+  height: auto;
+  overflow: visible;
+}
+.r6-memory .memory-library-pagination span {
+  white-space: normal;
+  overflow-wrap: anywhere;
+}
 .r6-memory .memory-library-layout {
   min-height: 0;
   overflow: auto;

memhub/apps/web/src/r6-settings.css

@@ -17,6 +17,35 @@
     sans-serif;
   margin: 0 0 28px;
 }
+.r6-settings .r6-language-setting {
+  margin-bottom: 24px;
+  padding: 20px 24px;
+  border: 1px solid #dce4eb;
+  border-radius: 16px;
+  background: #fff;
+}
+.r6-settings .r6-language-setting h2 {
+  margin: 0 0 12px;
+  font-size: 18px;
+}
+.r6-settings .r6-language-setting select {
+  max-width: 100%;
+  min-height: 36px;
+  padding: 6px 10px;
+  border: 1px solid #dce4eb;
+  border-radius: 8px;
+  color: inherit;
+  background: #fff;
+  font: inherit;
+}
+.r6-settings .r6-language-setting select:focus-visible {
+  outline: 2px solid #225f9d;
+  outline-offset: 2px;
+}
+.r6-settings .r6-language-setting > p {
+  margin: 12px 0 0;
+  overflow-wrap: anywhere;
+}
 .r6-settings .r6-settings-layout {
   display: grid;
   grid-template-columns: 220px minmax(0, 1fr);
@@ -40,7 +69,7 @@
 .r6-settings .r6-settings-layout > nav > button {
   box-sizing: border-box;
   padding: 8px 16px;
-  height: 46px;
+  height: auto;
   min-height: 46px;
   text-align: left;
   border: 0;

memhub/apps/web/src/r6-shell.css

@@ -1,6 +1,6 @@
 .app-shell.r6-shell {
   display: grid;
-  grid-template-columns: 78px minmax(0, 1fr);
+  grid-template-columns: max-content minmax(0, 1fr);
   grid-template-rows: 58px minmax(0, 1fr) 48px;
   height: 100dvh;
   min-height: 0;
@@ -26,6 +26,9 @@
   user-select: none;
 }
 .r6-shell > .app-rail {
+  /* Keep the R6 sidebar vertical when legacy mobile navigation becomes a grid. */
+  display: flex;
+  flex-direction: column;
   grid-column: 1;
   grid-row: 2;
   padding: 34px 9px 18px;
@@ -43,7 +46,10 @@
 }
 .r6-shell button.rail-button {
   border-radius: 8px;
-  width: 60px;
+  width: 100%;
+  min-width: 60px;
+  padding-inline: 9px;
+  white-space: nowrap;
   min-height: 70px;
   height: 70px;
 }
@@ -108,7 +114,7 @@
 }
 @media (max-width: 600px) {
   .app-shell.r6-shell {
-    grid-template-columns: 64px minmax(0, 1fr);
+    grid-template-columns: max-content minmax(0, 1fr);
   }
   .r6-shell > .app-rail {
     padding: 12px 4px;

memhub/packages/contracts/package.json

@@ -8,6 +8,10 @@
     ".": {
       "types": "./src/index.ts",
       "default": "./src/index.ts"
+    },
+    "./gui-i18n": {
+      "types": "./src/gui-i18n.ts",
+      "default": "./src/gui-i18n.ts"
     }
   },
   "scripts": {

memhub/packages/contracts/src/gui-i18n-guide.ts

@@ -0,0 +1,203 @@
+/** Presentation-only guide copy. Original memories and generated handoff drafts stay untouched. */
+export const guideChineseMessages = {
+  guideEyebrow: "上手体验",
+  guideTitle: "让下一次对话接得上",
+  guideBack: "返回记忆",
+  guideChooseScene: "选择使用场景",
+  guideSame: "新对话接着做",
+  guideSameDescription: "同一个应用，换个会话，仍能找回之前的决定。",
+  guideSwitch: "换个应用继续",
+  guideSwitchDescription: "工作没有换，只是换了一个 AI。先把相关背景接上。",
+  guideNew: "让新工具了解我",
+  guideNewDescription: "从你愿意提供的一条背景开始，不必从头自我介绍。",
+  guideReadError: "暂时无法读取记忆，可稍后重试。",
+  guideDetailError: "这条记忆暂不可读，请换一条或刷新。",
+  guideChanged: "记忆内容或授权已变化，请刷新后重新核对。",
+  guideConnectionChanged: "连接状态已变化，尚未复制。请重新选择方式。",
+  guideCopiedOpened: "已复制并请求打开 {host}。尚未发送，请核对输入框。",
+  guideCopiedNotFilled: "已完整复制，未能预填。可在目标应用粘贴，尚未发送。",
+  guideCopiedNotOpened: "已完整复制，但未能打开目标应用。尚未发送。",
+  guideCopied: "已完整复制。尚未发送，也没有新增读取授权。",
+  guideValidationError: "无法核对当前记忆与授权，旧预览已收起。请刷新后重试。",
+  guideCopyError: "未能核对最新内容或完成复制。请重试；没有打开目标应用。",
+  guideManual: "端内添加",
+  guideOriginalApp: "原应用",
+  guideSaved: "本机已保存 {count} 条原始消息 · ",
+  guideReadingMemories: "正在读取已整理记忆",
+  guideLoaded: "本页已加载 {count} 条可用记忆",
+  guideSeparate: "。两个阶段分别计数。",
+  guideChooseBackground: "选择背景",
+  guideCheckSources: "核对来源",
+  guideTry: "到新对话试用",
+  guideLoading: "正在读取本机已有记忆…",
+  guideEmptyTitle: "先留下一条真正有用的背景",
+  guideEmptyDescription:
+    "目前没有可用于这次体验的记忆。已导入的原文不等于已经整理好；候选内容也不会被自动带出。",
+  guideAdd: "去添加记忆",
+  guideConnections: "查看导入与连接",
+  guideRefresh: "刷新",
+  guideBackgroundTitle: "这次用到的背景",
+  guideRefreshExample: "刷新示例",
+  guideChooseMemory: "选择一条记忆",
+  guideLoadedScope: "从当前已加载的 {count} 条可用记忆中选择，不代表全部历史。",
+  guideCheckingEvidence: "正在核对原始依据…",
+  guideRevision: "{source} · 版本 {revision} · 系统整理，需你核对",
+  guideScope: "适用范围：",
+  guideAllApps: "已设为跨应用可用，不等于个人偏好",
+  guidePrivate: "已停止外部记忆召回；手动带出需另行确认",
+  guideLimited: "限定范围，未扩大外部召回范围",
+  guideEvidence: "原始依据 · {count} 段",
+  guideUnknownSource: "未知来源",
+  guideYou: "你",
+  guideUnknownAuthor: "作者未识别",
+  guideUnknownTime: "时间未知",
+  guideUnavailable:
+    "原文或当前授权不可用。换一条背景或刷新后再试，不会带出这条内容。",
+  guideDraftTitle: "下一段对话的开场白",
+  guideChooseApp: "在哪个应用试用",
+  guideCopyOnly: "自行选择应用 · 仅复制",
+  guideHostsError: "暂时无法读取连接状态，可重试或仅复制背景。",
+  guideNoApp: "尚未选择已连接的应用。手动带入不等于安装连接。",
+  guideWired: "上次自检可达，本次是否用对仍需核对。",
+  guideInstalled: "已安装连接，尚未验证读取。",
+  guideNotInstalled: "尚未安装读取连接。",
+  guideManage: "管理应用连接",
+  guideChooseRoute: "选择带入方式",
+  guideContext: "带入背景",
+  guideQuery: "让应用查询",
+  guideTopic: "要接续的主题",
+  guideQueryHint: "只带查询，不把上方的预期答案塞进新会话。",
+  guideNewHint: "仅带你选择的这一条，不自动生成个人画像。",
+  guideContextHint: "完整带入这一条背景与引用；这不是自动召回测试。",
+  guidePreview: "开场白完整预览",
+  guidePreviewPlaceholder: "原始依据可用后显示开场白",
+  guideChecking: "正在核对…",
+  guideCopy: "复制开场白",
+  guideCopyOpen: "复制并打开 {host}",
+  guideNoReceipt: "尚无本次外部调用回执。新对话是否引用了正确的背景？",
+  guideVerified: "我已核对结果",
+  guideMissing: "没有找回来",
+  guideFeedbackOk: "你的反馈：已核对。这不是系统自动验收记录。",
+  guideFeedbackMissing:
+    "你的反馈：没有找回来。先检查来源是否导入、记忆范围与应用连接。",
+  guideInvitation: "上手体验邀请",
+  guideInvitationHint: "用一条自己的记忆，试着接续下一次对话。",
+  guideTryOnce: "试一次",
+  guideLater: "稍后再看",
+  guideDismiss: "关闭上手邀请",
+} as const;
+export const guideSpanishMessages: Record<
+  keyof typeof guideChineseMessages,
+  string
+> = {
+  guideEyebrow: "Primeros pasos",
+  guideTitle: "Retoma tu próxima conversación",
+  guideBack: "Volver a memorias",
+  guideChooseScene: "Elegir un escenario",
+  guideSame: "Continuar en una conversación nueva",
+  guideSameDescription:
+    "Recupera decisiones anteriores en una conversación nueva de la misma aplicación.",
+  guideSwitch: "Continuar en otra aplicación",
+  guideSwitchDescription:
+    "El trabajo es el mismo; solo cambia la IA. Incorpora primero el contexto relevante.",
+  guideNew: "Darte a conocer a una herramienta nueva",
+  guideNewDescription:
+    "Empieza por el contexto que quieras compartir, sin tener que presentarte desde cero.",
+  guideReadError: "No se pudieron leer las memorias. Inténtalo más tarde.",
+  guideDetailError: "Esta memoria no se puede leer. Elige otra o actualiza.",
+  guideChanged:
+    "La memoria o los permisos cambiaron. Actualiza y vuelve a comprobarlos.",
+  guideConnectionChanged:
+    "La conexión cambió; no se copió nada. Vuelve a elegir el método.",
+  guideCopiedOpened:
+    "Se copió y se solicitó abrir {host}. No se envió; revisa el campo de entrada.",
+  guideCopiedNotFilled:
+    "Se copió todo, pero no se pudo rellenar el campo. Puedes pegarlo en la aplicación; no se envió.",
+  guideCopiedNotOpened:
+    "Se copió todo, pero no se pudo abrir la aplicación de destino. No se envió.",
+  guideCopied:
+    "Se copió todo. No se envió ni se concedieron permisos de lectura nuevos.",
+  guideValidationError:
+    "No se pudieron verificar la memoria y los permisos actuales. Se ocultó la vista previa anterior; actualiza e inténtalo de nuevo.",
+  guideCopyError:
+    "No se pudo verificar o copiar el contenido actualizado. Inténtalo de nuevo; no se abrió la aplicación de destino.",
+  guideManual: "Añadido en la aplicación",
+  guideOriginalApp: "Aplicación original",
+  guideSaved: "{count} mensajes originales guardados localmente · ",
+  guideReadingMemories: "Leyendo las memorias procesadas",
+  guideLoaded: "{count} memorias disponibles cargadas en esta página",
+  guideSeparate: ". Ambas etapas se cuentan por separado.",
+  guideChooseBackground: "Elegir contexto",
+  guideCheckSources: "Revisar orígenes",
+  guideTry: "Probar en una conversación nueva",
+  guideLoading: "Leyendo las memorias locales…",
+  guideEmptyTitle: "Guarda primero un contexto realmente útil",
+  guideEmptyDescription:
+    "No hay memorias disponibles para esta prueba. Importar los originales no significa que ya estén procesados; los candidatos tampoco se compartirán automáticamente.",
+  guideAdd: "Añadir una memoria",
+  guideConnections: "Ver importaciones y conexiones",
+  guideRefresh: "Actualizar",
+  guideBackgroundTitle: "Contexto para esta prueba",
+  guideRefreshExample: "Actualizar ejemplo",
+  guideChooseMemory: "Elegir una memoria",
+  guideLoadedScope:
+    "Elige entre las {count} memorias disponibles cargadas; no representan todo el historial.",
+  guideCheckingEvidence: "Verificando los originales…",
+  guideRevision:
+    "{source} · revisión {revision} · organizado por el sistema; debes revisarlo",
+  guideScope: "Alcance: ",
+  guideAllApps:
+    "Disponible entre aplicaciones; no implica una preferencia personal",
+  guidePrivate:
+    "Recuperación externa detenida; compartir manualmente requiere otra confirmación",
+  guideLimited: "Alcance limitado; no se amplió la recuperación externa",
+  guideEvidence: "Originales · {count} fragmentos",
+  guideUnknownSource: "Origen desconocido",
+  guideYou: "Tú",
+  guideUnknownAuthor: "Autor sin identificar",
+  guideUnknownTime: "Fecha desconocida",
+  guideUnavailable:
+    "El original o el permiso actual no están disponibles. Elige otro contexto o actualiza; este contenido no se compartirá.",
+  guideDraftTitle: "Mensaje inicial de la próxima conversación",
+  guideChooseApp: "Aplicación para la prueba",
+  guideCopyOnly: "Elegir aplicación manualmente · solo copiar",
+  guideHostsError:
+    "No se pudo leer la conexión. Reintenta o copia solo el contexto.",
+  guideNoApp:
+    "No se seleccionó una aplicación conectada. Incorporar contexto manualmente no instala una conexión.",
+  guideWired:
+    "La última comprobación tuvo éxito; aún debes revisar que se use correctamente.",
+  guideInstalled: "Conexión instalada; lectura todavía sin verificar.",
+  guideNotInstalled: "La conexión de lectura no está instalada.",
+  guideManage: "Administrar conexiones de aplicaciones",
+  guideChooseRoute: "Elegir cómo incorporar el contexto",
+  guideContext: "Incorporar contexto",
+  guideQuery: "Pedir a la aplicación que consulte",
+  guideTopic: "Tema que quieres retomar",
+  guideQueryHint:
+    "Incluye solo la consulta, no la respuesta esperada de arriba.",
+  guideNewHint:
+    "Solo se incluye la memoria elegida; no se crea un perfil personal automáticamente.",
+  guideContextHint:
+    "Incluye este contexto completo y sus referencias; no es una prueba de recuperación automática.",
+  guidePreview: "Vista previa del mensaje inicial completo",
+  guidePreviewPlaceholder:
+    "El mensaje inicial aparecerá cuando estén disponibles los originales",
+  guideChecking: "Verificando…",
+  guideCopy: "Copiar mensaje inicial",
+  guideCopyOpen: "Copiar y abrir {host}",
+  guideNoReceipt:
+    "No hay un recibo de llamada externa para esta prueba. ¿La nueva conversación citó el contexto correcto?",
+  guideVerified: "Ya revisé el resultado",
+  guideMissing: "No lo recuperó",
+  guideFeedbackOk:
+    "Tu respuesta: revisado. Esto no es una verificación automática del sistema.",
+  guideFeedbackMissing:
+    "Tu respuesta: no se recuperó. Comprueba la importación del origen, el alcance de la memoria y la conexión de la aplicación.",
+  guideInvitation: "Invitación a primeros pasos",
+  guideInvitationHint:
+    "Prueba a retomar la próxima conversación con una memoria tuya.",
+  guideTryOnce: "Probar",
+  guideLater: "Ver más tarde",
+  guideDismiss: "Cerrar invitación",
+};

memhub/packages/contracts/src/gui-i18n-health-guide.test.ts

@@ -0,0 +1,30 @@
+import { expect, it } from "vitest";
+import { type MessageKey, translate } from "./gui-i18n.js";
+import {
+  guideChineseMessages,
+  guideSpanishMessages,
+} from "./gui-i18n-guide.js";
+import {
+  healthChineseMessages,
+  healthSpanishMessages,
+} from "./gui-i18n-health.js";
+
+it("covers every health and guide key without accidental Chinese fallback", () => {
+  const params = (message: string) =>
+    [...message.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)]
+      .map((match) => match[1])
+      .sort();
+  for (const [chinese, spanish] of [
+    [healthChineseMessages, healthSpanishMessages],
+    [guideChineseMessages, guideSpanishMessages],
+  ]) {
+    expect(Object.keys(spanish).sort()).toEqual(Object.keys(chinese).sort());
+    for (const [key, value] of Object.entries(chinese)) {
+      const translated = spanish[key as keyof typeof spanish];
+      expect(translated, key).toBeTruthy();
+      expect(params(translated), key).toEqual(params(value));
+      expect(translate("es", key as MessageKey), key).toBe(translated);
+      expect(translate("zh-CN", key as MessageKey), key).toBe(value);
+    }
+  }
+});

memhub/packages/contracts/src/gui-i18n-health.ts

@@ -0,0 +1,141 @@
+export const healthChineseMessages = {
+  healthTitle: "运行诊断",
+  healthLocal: "本地服务",
+  healthBackground: "后台服务",
+  healthSources: "各来源累计条数",
+  healthProcessing: "记忆提炼",
+  healthHosts: "AI 接通情况",
+  healthDetailed: "详细日志",
+  healthDetailedTitle: "详细日志（排查用）",
+  healthDetailedHint: "默认关闭。仅在开发人员请你协助排查时开启。",
+  healthDetailedError: "详细日志设置失败，请重试。",
+  healthRefresh: "重新读取状态",
+  healthIncident: "记录问题时间点",
+  healthIncidentDesktop: "请在桌面 App 中记录问题时间点。",
+  healthIncidentPrompt: "简单描述刚才遇到的问题（可不填）",
+  healthIncidentCopied: "问题编号已复制：{id}",
+  healthIncidentError: "问题时间点未能记录，请重试。",
+  healthReadFailed: "暂时无法读取",
+  healthStale: " · 数据已过期，以下为上次读取结果。",
+  healthReading: "正在读取状态…",
+  healthRereading: "正在重新读取，以下为上次读取结果…",
+  healthReadSuccessTime: "上次成功读取",
+  healthReadFailedTime: "读取失败时间",
+  healthReadingSources: "正在读取本地服务与来源状态…",
+  healthPrevious: "上次读取",
+  healthRunning: "运行中",
+  healthCoreVersion: "{state} · 版本 {version} · 实例 {instance}",
+  healthCoreDisconnected: "还没连上本地 Core。",
+  healthBackgroundUnavailable:
+    "当前环境无法检查后台服务，请在支持此功能的桌面 App 中查看。",
+  healthRuntime: "Core：{core} · 宿主桥接：{broker}",
+  healthSourceCount: "{conversations} 个会话 · {messages} 条消息",
+  healthNoSources: "还没有已连接的来源。",
+  healthTaskCounts:
+    "{running} 处理中 · {pending} 排队 · {completed} 已完成 · {failed} 失败",
+  healthImportDetails: "导入与整理详情",
+  healthRawTurns: "原文与完整对话轮次",
+  healthRawCounts: "{raw} 条原文 · {turns} 个完整 turn",
+  healthHy: "HY 整理",
+  healthHyCounts:
+    "{calls} 次调用 · {completed} 完成 · {unknown} 结果不确定 · {failed} 失败 · {cancelled} 取消",
+  healthOutput: "产出",
+  healthMemories: "{count} 条记忆",
+  healthWorkbuddy: "WorkBuddy 查记忆",
+  healthWorkbuddyCounts:
+    "{injected} 次注入 · {timedOut} 次超时 · {unavailable} 次不可用",
+  healthBlocked: "{kind}卡在 {reason}（{count} 条）",
+  healthRetrying: "{count} 项正在重试",
+  healthNoIssues: "暂无需要处理的问题。",
+  healthHostsUnavailable: "在浏览器里读不到；请在桌面 App 里查看。",
+  healthNoHosts: "本机没有检测到可接入的 AI 工具。",
+  healthBackgroundHealthy: "后台服务可用",
+  healthBackgroundStopped: "后台服务已停止",
+  healthBackgroundDegraded: "后台服务部分不可用",
+  healthBackgroundUntrusted: "后台服务身份未通过核验",
+  healthBackgroundUnknown: "后台状态尚未确认",
+  healthStopped: "已停止",
+  healthUnhealthy: "无法连接",
+  healthUntrusted: "身份未通过核验",
+  healthUnknown: "尚未确认",
+  healthNotChecked: "未检查",
+  healthWired: "已接通",
+  healthBlind: "已安装，但取不到记忆",
+  healthUnreachable: "未接通",
+} as const;
+
+export const healthSpanishMessages: Record<
+  keyof typeof healthChineseMessages,
+  string
+> = {
+  healthTitle: "Diagnóstico",
+  healthLocal: "Servicio local",
+  healthBackground: "Servicio en segundo plano",
+  healthSources: "Totales por origen",
+  healthProcessing: "Procesamiento de memorias",
+  healthHosts: "Conexiones de IA",
+  healthDetailed: "Registros detallados",
+  healthDetailedTitle: "Registros detallados (diagnóstico)",
+  healthDetailedHint:
+    "Desactivados de forma predeterminada. Actívalos solo si el equipo de desarrollo te pide ayuda para diagnosticar un problema.",
+  healthDetailedError:
+    "No se pudieron cambiar los registros detallados. Inténtalo de nuevo.",
+  healthRefresh: "Volver a leer el estado",
+  healthIncident: "Registrar el momento del problema",
+  healthIncidentDesktop:
+    "Registra el momento del problema desde la aplicación de escritorio.",
+  healthIncidentPrompt: "Describe brevemente el problema (opcional)",
+  healthIncidentCopied: "Identificador del problema copiado: {id}",
+  healthIncidentError:
+    "No se pudo registrar el momento del problema. Inténtalo de nuevo.",
+  healthReadFailed: "No se pudo leer el estado",
+  healthStale:
+    " · Los datos están desactualizados; se muestra la última lectura.",
+  healthReading: "Leyendo el estado…",
+  healthRereading: "Volviendo a leer; se muestra la lectura anterior…",
+  healthReadSuccessTime: "Última lectura correcta",
+  healthReadFailedTime: "Hora de la lectura fallida",
+  healthReadingSources: "Leyendo el servicio local y los orígenes…",
+  healthPrevious: "Lectura anterior",
+  healthRunning: "En ejecución",
+  healthCoreVersion: "{state} · versión {version} · instancia {instance}",
+  healthCoreDisconnected: "Aún no se conectó con Core local.",
+  healthBackgroundUnavailable:
+    "No se puede comprobar el servicio en este entorno. Usa una aplicación de escritorio compatible.",
+  healthRuntime: "Core: {core} · puente de aplicaciones: {broker}",
+  healthSourceCount: "{conversations} conversaciones · {messages} mensajes",
+  healthNoSources: "Todavía no hay orígenes conectados.",
+  healthTaskCounts:
+    "{running} en proceso · {pending} en espera · {completed} completadas · {failed} fallidas",
+  healthImportDetails: "Detalles de importación y procesamiento",
+  healthRawTurns: "Originales y turnos completos",
+  healthRawCounts: "{raw} originales · {turns} turnos completos",
+  healthHy: "Procesamiento HY",
+  healthHyCounts:
+    "{calls} llamadas · {completed} completadas · {unknown} sin confirmar · {failed} fallidas · {cancelled} canceladas",
+  healthOutput: "Resultados",
+  healthMemories: "{count} memorias",
+  healthWorkbuddy: "Consultas de WorkBuddy",
+  healthWorkbuddyCounts:
+    "{injected} incorporaciones · {timedOut} tiempos agotados · {unavailable} no disponibles",
+  healthBlocked: "{kind}: bloqueo por {reason} ({count})",
+  healthRetrying: "{count} elementos reintentándose",
+  healthNoIssues: "No hay problemas pendientes.",
+  healthHostsUnavailable:
+    "No se puede leer desde el navegador; consulta la aplicación de escritorio.",
+  healthNoHosts:
+    "No se detectaron herramientas de IA compatibles en este equipo.",
+  healthBackgroundHealthy: "Servicio en segundo plano disponible",
+  healthBackgroundStopped: "Servicio en segundo plano detenido",
+  healthBackgroundDegraded: "Servicio en segundo plano parcialmente disponible",
+  healthBackgroundUntrusted: "No se pudo verificar la identidad del servicio",
+  healthBackgroundUnknown: "Estado en segundo plano sin confirmar",
+  healthStopped: "Detenido",
+  healthUnhealthy: "Sin conexión",
+  healthUntrusted: "Identidad sin verificar",
+  healthUnknown: "Sin confirmar",
+  healthNotChecked: "Sin comprobar",
+  healthWired: "Conectado",
+  healthBlind: "Instalado, pero no recupera memorias",
+  healthUnreachable: "Sin conectar",
+};

memhub/packages/contracts/src/gui-i18n-messages.ts

@@ -0,0 +1,61 @@
+import {
+  guideChineseMessages,
+  guideSpanishMessages,
+} from "./gui-i18n-guide.js";
+import {
+  healthChineseMessages,
+  healthSpanishMessages,
+} from "./gui-i18n-health.js";
+import {
+  onboardingChineseMessages,
+  onboardingSpanishMessages,
+} from "./gui-i18n-onboarding.js";
+import {
+  recoveryChineseMessages,
+  recoverySpanishMessages,
+} from "./gui-i18n-recovery.js";
+import {
+  settingsChineseMessages,
+  settingsSpanishMessages,
+} from "./gui-i18n-settings.js";
+
+/** The complete Chinese GUI catalog defines the supported message keys. */
+export const chineseMessages = {
+  ...guideChineseMessages,
+  ...healthChineseMessages,
+  ...recoveryChineseMessages,
+  ...settingsChineseMessages,
+  ...onboardingChineseMessages,
+  settings: "设置",
+  languageTitle: "界面语言",
+  languageLabel: "语言",
+  languageSystem: "跟随系统",
+  languageChinese: "简体中文",
+  languageSpanish: "西班牙语",
+  languageDescription: "选择界面语言。此设置不会更改你的对话或记忆内容。",
+  languageSaveError: "无法保存语言设置，请重试。",
+  languageLoadError: "无法加载语言设置，请重试。",
+  nativeErrorTitle: "MemHub 无法启动",
+} as const;
+
+/** Spanish may be partial; untranslated messages use the Chinese catalog. */
+export const spanishMessages: Partial<
+  Record<keyof typeof chineseMessages, string>
+> = {
+  ...guideSpanishMessages,
+  ...healthSpanishMessages,
+  ...recoverySpanishMessages,
+  ...settingsSpanishMessages,
+  ...onboardingSpanishMessages,
+  settings: "Configuración",
+  languageTitle: "Idioma de la interfaz",
+  languageLabel: "Idioma",
+  languageSystem: "Usar el idioma del sistema",
+  languageChinese: "Chino simplificado",
+  languageSpanish: "Español",
+  languageDescription:
+    "Elige el idioma de la interfaz. Esta opción no modifica tus conversaciones ni tus memorias.",
+  languageSaveError: "No se pudo guardar el idioma. Inténtalo de nuevo.",
+  languageLoadError: "No se pudo cargar el idioma. Inténtalo de nuevo.",
+  nativeErrorTitle: "MemHub no pudo iniciarse",
+};

memhub/packages/contracts/src/gui-i18n-onboarding.test.ts

@@ -0,0 +1,48 @@
+import { expect, it } from "vitest";
+import { translate } from "./gui-i18n.js";
+import {
+  onboardingChineseMessages,
+  onboardingSpanishMessages,
+} from "./gui-i18n-onboarding.js";
+
+it("provides Spanish copy for every onboarding message with identical interpolation parameters", () => {
+  for (const key of Object.keys(
+    onboardingChineseMessages,
+  ) as (keyof typeof onboardingChineseMessages)[]) {
+    const chinese = onboardingChineseMessages[key];
+    const spanish = onboardingSpanishMessages[key];
+    expect(spanish, key).toBeTruthy();
+    expect(
+      [...spanish.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)]
+        .map((match) => match[1])
+        .sort(),
+      key,
+    ).toEqual(
+      [...chinese.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)]
+        .map((match) => match[1])
+        .sort(),
+    );
+    expect(translate("zh-CN", key)).toBe(chinese);
+    expect(translate("es", key)).toBe(spanish);
+  }
+});
+it("keeps product names, paths and error codes intact during interpolation", () => {
+  expect(translate("es", "onboardingImportHistory", { name: "Cursor" })).toBe(
+    "Importar el historial de Cursor",
+  );
+  expect(
+    translate("zh-CN", "onboardingImportHistory", { name: "Cursor" }),
+  ).toBe("导入 Cursor 历史");
+  expect(
+    translate("es", "onboardingModelOperationFailed", {
+      code: "fixture_error",
+    }),
+  ).toBe("La operación no se completó: fixture_error");
+  expect(
+    translate("es", "onboardingConnectionPartial", {
+      success: 1,
+      failed: 2,
+      names: "Cursor, /fixture/source",
+    }),
+  ).toContain("Cursor, /fixture/source");
+});

memhub/packages/contracts/src/gui-i18n-onboarding.ts

@@ -0,0 +1,392 @@
+/** Onboarding copy is also its stable Chinese fallback key. Never use these keys as workflow state. */
+export const onboardingSpanishMessages = {
+  "把熟悉的背景，带到这里": "Trae aquí el contexto que ya tienes",
+  "你的记忆，从这里接上": "Tus memorias empiezan aquí",
+  "这张卡还没测过。点一次「设为当前模型」会先自动测，如果还是不行，说明端点、key 或模型名有一处不对。":
+    "Esta configuración aún no se ha probado. Al seleccionarla como modelo actual se probará automáticamente. Si falla, comprueba el servicio, la clave y el nombre del modelo.",
+  "这类模型接口暂时用不了，换一张卡。":
+    "Este tipo de servicio de modelos no está disponible. Elige otra configuración.",
+  "这张卡缺了向量化模型，补上才能启用。":
+    "Falta el modelo de embeddings. Añádelo antes de habilitar esta configuración.",
+  "这张卡已经不在了，可能刚被删掉。刷新一下。":
+    "Esta configuración ya no existe; puede que se haya eliminado. Actualiza la lista.",
+  "这张卡刚被改过。刷新一下再试，免得覆盖掉别处的改动。":
+    "Esta configuración cambió. Actualiza antes de reintentar para no sobrescribir otros cambios.",
+  onboardingModelOperationFailed: "La operación no se completó: {code}",
+  首次设置进度: "Progreso de la configuración inicial",
+  导入历史: "Importar historial",
+  连接应用: "Conectar apps",
+  沉淀记忆: "Crear memorias",
+  本地存储: "Almacenamiento local",
+  "对话与记忆保存在本机；使用云模型或已授权的助手时，相关内容会发送给对应服务。":
+    "Las conversaciones y memorias se guardan en este dispositivo. Al usar modelos en la nube o asistentes autorizados, el contenido pertinente se envía al servicio correspondiente.",
+  "来源位置、身份或状态已变化，请重新选择并核对。尚未提交本次授权。":
+    "La ubicación, identidad o estado de la fuente ha cambiado. Vuelve a seleccionarla y comprobarla. Todavía no se ha enviado esta autorización.",
+  "来源位置、身份或状态已变化，正在等待本次提交回执。不会自动扩大已提交范围。":
+    "La ubicación, identidad o estado de la fuente ha cambiado. Se espera la confirmación del envío; su alcance no se ampliará automáticamente.",
+  测试实例不接入应用: "La instancia de prueba no conecta aplicaciones",
+  "请先把 MemHub 拖到“应用程序”并从那里重新打开，才能接入应用。":
+    "Para conectar aplicaciones, arrastra MemHub a Aplicaciones y vuelve a abrirlo desde allí.",
+  "部分应用未能完成接入，已成功的设置会保留，可进入应用后单独处理。":
+    "No se pudieron conectar algunas aplicaciones. Se conservará la configuración completada y podrás resolver las demás desde la aplicación.",
+  onboardingConnectionPartial:
+    "Aplicaciones conectadas: {success}; pendientes: {failed}: {names}. Puedes resolverlas por separado desde la aplicación.",
+  "首次设置的完成状态未能保存。已确认的导入回执不受影响；下次启动可能再次出现此页。":
+    "No se pudo guardar la finalización de la configuración inicial. Las importaciones confirmadas no se ven afectadas; esta página podría reaparecer al iniciar.",
+  "首次设置的完成状态尚未确认。已确认的导入回执不受影响；下次启动可能再次出现此页。":
+    "La finalización de la configuración inicial aún no está confirmada. Las importaciones confirmadas no se ven afectadas; esta página podría reaparecer al iniciar.",
+  "位置检测未完成，尚未读取历史。可以重新检测，或先进入工作台。":
+    "No se completó la detección de ubicaciones y no se ha leído el historial. Puedes volver a detectar o entrar al espacio de trabajo.",
+  "暂时无法核对来源，尚未提交授权。选择已保留，可以重试。":
+    "No se pueden comprobar las fuentes por ahora. No se ha enviado la autorización. Tu selección se conserva; puedes reintentar.",
+  "本次没有来源获准导入。请核对下方原因后重试，或到应用页查看状态。":
+    "No se autorizó la importación de ninguna fuente. Comprueba los motivos y reintenta, o consulta el estado en Aplicaciones.",
+  "开始导入的结果尚未确认，选择已保留。可以重试，或进入应用页核对。":
+    "El inicio de la importación aún no está confirmado. Tu selección se conserva. Puedes reintentar o comprobarlo en Aplicaciones.",
+  未完成: "Sin completar",
+  核对中: "Comprobando",
+  仍进入应用页: "Entrar igualmente a Aplicaciones",
+  仍进入工作台: "Entrar igualmente al espacio de trabajo",
+  仍进入设置: "Entrar igualmente a Configuración",
+  重试保存并进入: "Reintentar guardar y entrar",
+  "稍后添加，先进入": "Entrar y añadir más tarde",
+  "正在开始导入…": "Iniciando importación…",
+  开始导入: "Iniciar importación",
+  "不用从头介绍自己。从常用的 App 开始，把已有背景带过来。":
+    "No necesitas presentarte de nuevo. Trae el contexto de las aplicaciones que ya utilizas.",
+  "确认前只检查应用信息，不读取对话，也不安装连接。":
+    "Antes de confirmar, solo se comprueba la información de las aplicaciones. No se leen conversaciones ni se instalan conexiones.",
+  "本机 AI 应用": "Aplicaciones de IA en este dispositivo",
+  重新检测位置: "Volver a detectar ubicaciones",
+  "检测中…": "Detectando…",
+  重新检测: "Volver a detectar",
+  候选应用: "Aplicaciones disponibles",
+  "正在检测其他应用…": "Detectando otras aplicaciones…",
+  检测未完成: "Detección sin completar",
+  已全选: "Todas seleccionadas",
+  全选: "Seleccionar todas",
+  onboardingImportHistory: "Importar el historial de {name}",
+  正在核对本机保存位置: "Comprobando la ubicación de almacenamiento local",
+  已发现: "Encontrada",
+  位置待核对: "Ubicación pendiente de comprobar",
+  "当前没有候选来源。可以稍后在应用页添加历史包。":
+    "No hay fuentes disponibles. Puedes añadir un archivo de historial más tarde en Aplicaciones.",
+  "候选来源尚未加载。可以检测位置，或先进入工作台。":
+    "Las fuentes aún no se han cargado. Puedes detectar ubicaciones o entrar al espacio de trabajo.",
+  本次导入: "Esta importación",
+  "个 App 的历史对话": "aplicaciones con historial de conversaciones",
+  "把零散的会话，": "Reúne conversaciones dispersas",
+  汇成完整的记忆: "en memorias completas",
+  "少一些重复交代，多一些理解。":
+    "Menos explicaciones repetidas, más comprensión.",
+  onboardingMoreApps: "Desplázate para ver más · Quedan {count} aplicaciones",
+  onboardingAllApps: "Se muestran las {count} aplicaciones",
+  默认位置: "Ubicación predeterminada",
+  自定义位置: "Ubicación personalizada",
+  尚未检测: "Sin detectar",
+  检测中: "Detectando",
+  未发现: "No encontrada",
+  无法访问: "Sin acceso",
+  位置无效: "Ubicación no válida",
+  "需要更新 Core": "Es necesario actualizar Core",
+  "候选位置不存在，可能尚无历史或路径不同。":
+    "La ubicación no existe. Puede que no haya historial o que la ruta sea diferente.",
+  "无法检查此位置，请核对目录访问权限后重试。":
+    "No se puede comprobar esta ubicación. Revisa los permisos de acceso a la carpeta y reintenta.",
+  "此位置未通过安全检查，不能读取。":
+    "Esta ubicación no superó la comprobación de seguridad y no se puede leer.",
+  "当前 Core 未提供可确认的位置身份，需更新后再选择。":
+    "Core no proporcionó una identidad de ubicación verificable. Actualízalo antes de seleccionar.",
+  暂不支持历史导入: "La importación de historial aún no está disponible",
+  "当前来源不可读取，请重新检测。":
+    "No se puede leer esta fuente. Vuelve a detectarla.",
+  "来源目录暂时不可读取，请核对位置和权限。":
+    "No se puede leer la carpeta de la fuente. Comprueba su ubicación y permisos.",
+  "来源目录身份已变化，请返回重新检测。":
+    "La identidad de la carpeta ha cambiado. Vuelve atrás y detecta de nuevo.",
+  "来源权限已变化，请返回重新确认。":
+    "Los permisos de la fuente han cambiado. Vuelve atrás y confírmalos de nuevo.",
+  "此来源尚未获得读取授权。":
+    "Esta fuente aún no tiene autorización de lectura.",
+  "自定义来源位置需要重新确认。":
+    "Debes volver a confirmar la ubicación personalizada de la fuente.",
+  "当前 Core 未启用历史导入。":
+    "Core no tiene habilitada la importación de historial.",
+  onboardingImportRefused:
+    "La importación aún no está autorizada ({reason}). Comprueba la fuente y reintenta.",
+  确认自定义位置: "Confirmar ubicación personalizada",
+  关闭位置确认: "Cerrar confirmación de ubicación",
+  "此位置来自当前配置，并非应用默认目录。确认位置不会开始读取历史。":
+    "Esta ubicación procede de la configuración actual y no es la carpeta predeterminada de la aplicación. Confirmarla no inicia la lectura del historial.",
+  onboardingConfirmHistory:
+    "Confirmo que esta es la ubicación del historial de {name}",
+  取消: "Cancelar",
+  确认此位置: "Confirmar esta ubicación",
+  "对话正在汇入，记忆从这里开始":
+    "Tus conversaciones llegan; tus memorias empiezan aquí",
+  "导入进行中 · 顺手连接应用":
+    "Importación en curso · Conecta tus aplicaciones",
+  "对话已保存，记忆尚待生成。":
+    "Las conversaciones se han guardado. Las memorias aún no se han generado.",
+  "导入在后台继续，无需等待。":
+    "La importación continúa en segundo plano; no necesitas esperar.",
+  "正在重新核对来源；已保存数量仍按任务回执显示。":
+    "Comprobando de nuevo las fuentes. Las cantidades guardadas siguen basándose en las confirmaciones de las tareas.",
+  "本次历史导入已暂停，已保存的对话还在。":
+    "Esta importación de historial está pausada. Las conversaciones guardadas se conservan.",
+  "导入等待处理，已保存的对话还在。":
+    "La importación está pendiente. Las conversaciones guardadas se conservan.",
+  停止后续操作: "Detener las operaciones siguientes",
+  暂停导入: "Pausar importación",
+  继续导入: "Reanudar importación",
+  "配置模型，沉淀记忆": "Configurar modelo",
+  导入与原文: "Importación y contenido original",
+  "本次导入已结束。已保存的对话无需重复导入。":
+    "Esta importación ha terminado. No es necesario volver a importar las conversaciones guardadas.",
+  "对话先保存在本机。你可以同时设置后续连接。":
+    "Primero se guardan las conversaciones en este dispositivo. Mientras tanto, puedes configurar las conexiones.",
+  "导入不会自动开放应用读取权限。配置模型后，才会开始生成记忆。":
+    "Importar no concede automáticamente acceso de lectura a las aplicaciones. Las memorias comenzarán a generarse cuando configures un modelo.",
+  onboardingHistoryWindow:
+    "Se ha detectado un gran volumen de conversaciones. Para controlar el uso y mantener coherentes las cronologías, solo se importarán los últimos 3 días de todas las aplicaciones.",
+  导入说明: "Información de importación",
+  正在导入你的会话: "Importando tus conversaciones",
+  "后台将持续为你导入，可以放心进入下一步":
+    "La importación continuará en segundo plano; puedes pasar al siguiente paso",
+  未开始的导入: "Importaciones no iniciadas",
+  "未能开始导入，其他已接受任务不受影响。":
+    "No se pudo iniciar la importación. Las demás tareas aceptadas no se ven afectadas.",
+  查看未导入的应用: "Ver aplicaciones sin importar",
+  让记忆继续生长: "Haz crecer tus memorias",
+  连接你的应用: "Conecta tus aplicaciones",
+  "适用于本次选择且支持的应用。":
+    "Solo para las apps seleccionadas y compatibles.",
+  一键接入应用: "Conectar con un clic",
+  "安装记忆连接，让所选应用用上 MemHub 中的相关记忆。":
+    "Instala la conexión para que las apps elegidas usen memorias relevantes de MemHub.",
+  "当前使用独立测试数据目录，不会修改本机应用的连接配置。":
+    "Se utiliza una carpeta independiente de datos de prueba. No se modificará la configuración de conexión de las aplicaciones locales.",
+  "点击底部按钮后，后台分别接入各应用；某个应用失败不影响其他应用。":
+    "Al continuar, cada app se conecta en segundo plano. Si una falla, las demás siguen.",
+  "暂时无法连接应用，当前不会安装连接。":
+    "No se pueden conectar aplicaciones por ahora. No se instalará ninguna conexión.",
+  onboardingBatchStopped:
+    "Se detuvieron las operaciones siguientes; las ya enviadas se comprobarán según sus confirmaciones.",
+  onboardingBatchResult: "Confirmadas: {confirmed}; sin confirmar: {failed}.",
+  "已确认项保留，请核对未确认任务后重试。":
+    "Se conservan las operaciones confirmadas. Comprueba las tareas sin confirmar antes de reintentar.",
+  本次应用导入进度: "Progreso de importación de las aplicaciones",
+  正在导入: "Importando",
+  已暂停: "En pausa",
+  已中断: "Interrumpida",
+  导入遇到问题: "Problema de importación",
+  已取消: "Cancelada",
+  已保存: "Guardada",
+  onboardingAppProgress: "Progreso de importación de {name}",
+  onboardingSavedMessages: "Mensajes guardados: {count}",
+  onboardingScannedMessages: "Mensajes examinados: {count}; guardando",
+  没有可保存的历史对话: "No hay conversaciones del historial para guardar",
+  状态待核对: "Estado pendiente de comprobar",
+  读取授权不可用: "Autorización de lectura no disponible",
+  onboardingReadErrors: " · Errores de lectura: {count}",
+  "配置详情，按需要调整": "Ajusta la configuración según tus necesidades",
+  "连接未通过，配置已保留": "La conexión falló; tu configuración se conserva",
+  "选好模型，让记忆开始沉淀": "Elige un modelo para crear memorias",
+  "连接设置已保存\n成功项保留，不重复执行。":
+    "Se guardaron los ajustes de conexión.\nSe conservan los cambios completados, sin repetirlos.",
+  "已选择：持续同步 · 一键接入":
+    "Seleccionado: sincronización continua · Conexión con un clic",
+  "沉淀记忆 · 使用你选择的模型": "Crea memorias · Con el modelo que elijas",
+  "当前无法启用模型，已填写内容保留。":
+    "No se puede habilitar el modelo por ahora. Los datos introducidos se conservan.",
+  "模型连接测试通过，可以启用并开始沉淀记忆。":
+    "La prueba de conexión fue satisfactoria. Puedes habilitar el modelo y empezar a crear memorias.",
+  "先测试模型连通性；测试通过后再启用。":
+    "Prueba primero la conexión del modelo. Habilítalo cuando la prueba sea satisfactoria.",
+  "跳过，先进入应用": "Omitir por ahora",
+  "正在测试模型…": "Probando el modelo…",
+  测试模型连通性: "Probar conexión",
+  "正在启用…": "Habilitando…",
+  确认启用: "Confirmar y habilitar",
+  核对提交状态: "Comprobar estado del envío",
+  模型配置: "Configuración del modelo",
+  模型参数: "Parámetros del modelo",
+  "选择服务商，填入 API Key。核对已有配置后再继续。":
+    "Selecciona un proveedor e introduce su API Key. Comprueba la configuración antes de continuar.",
+  模型服务商: "Proveedor del modelo",
+  选择服务商: "Seleccionar proveedor",
+  "已安全保存，留空保留":
+    "Guardada de forma segura; deja el campo vacío para conservarla",
+  "输入服务商提供的 API Key": "Introduce la API Key del proveedor",
+  "连接未通过，请检查 API Key、模型与接口地址后重试。配置已保留。":
+    "La conexión falló. Comprueba la API Key, el modelo y la dirección del servicio antes de reintentar. La configuración se conserva.",
+  "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”。":
+    "MemHub necesita acceso al llavero. Cuando el sistema lo solicite, selecciona «Permitir siempre».",
+  "留空保留已保存密钥；填写新密钥后需重新测试。":
+    "Deja el campo vacío para conservar la clave guardada. Si introduces otra clave, deberás repetir la prueba.",
+  "密钥保存在系统安全存储中，不写入对话或日志。":
+    "La clave se guarda en el almacenamiento seguro del sistema, no en conversaciones ni registros.",
+  配置详情与高级设置: "Detalles y configuración avanzada",
+  服务商待选择: "Proveedor pendiente de seleccionar",
+  模型待填写: "Modelo pendiente de introducir",
+  本地向量模型: "Modelo de embeddings local",
+  向量模型待填写: "Modelo de embeddings pendiente de introducir",
+  思考已关闭: "Razonamiento desactivado",
+  思考未关闭: "Razonamiento no desactivado",
+  "预设已填好，只有自定义服务或特殊需求才需要修改。":
+    "Los valores predefinidos ya están completos. Solo necesitas modificarlos para servicios personalizados o necesidades específicas.",
+  返回服务商选择: "Volver a seleccionar proveedor",
+  配置名称: "Nombre de la configuración",
+  模型名称: "Nombre del modelo",
+  协议: "Protocolo",
+  "Anthropic（暂不支持）": "Anthropic (aún no compatible)",
+  "HY 托管（当前不可用）": "HY administrado (no disponible)",
+  向量模型: "Modelo de embeddings",
+  "本地 ONNX · 内置": "ONNX local · Integrado",
+  自定义向量: "Embeddings personalizados",
+  "超时（秒）": "Tiempo de espera (segundos)",
+  最大并发: "Concurrencia máxima",
+  上下文窗口: "Ventana de contexto",
+  "自动 / 可选": "Automática / Opcional",
+  关闭思考模式: "Desactivar el modo de razonamiento",
+  "自定义向量配置可展开；远程向量服务须遵守凭据边界。":
+    "Puedes desplegar la configuración de embeddings personalizados. Los servicios remotos deben respetar los límites de las credenciales.",
+  "切换服务商或模型后，需要重新测试并启用。":
+    "Si cambias de proveedor o modelo, deberás repetir la prueba y habilitarlo de nuevo.",
+  向量模型名称: "Nombre del modelo de embeddings",
+  向量协议: "Protocolo de embeddings",
+  "同源 OpenAI-compatible（共用 Key）":
+    "OpenAI-compatible del mismo origen (clave compartida)",
+  "本机 Ollama": "Ollama local",
+  "向量 Base URL": "Base URL de embeddings",
+  "远程向量地址须与生成服务同源；本机地址仍需校验。":
+    "La dirección remota de embeddings debe compartir origen con el servicio de generación. Las direcciones locales también deben validarse.",
+  核对创建结果: "Comprobar resultado de la creación",
+  "放弃旧记录，重新配置":
+    "Descartar el registro anterior y configurar de nuevo",
+  模型提交状态: "Estado del envío del modelo",
+  "正在测试连接…": "Probando la conexión…",
+  "正在提交保存与启用，请等待回执…":
+    "Enviando la solicitud de guardado y habilitación. Espera la confirmación…",
+  "操作结果未确认，已填写内容保留，请核对后重试。":
+    "El resultado de la operación no está confirmado. Los datos introducidos se conservan. Compruébalo antes de reintentar.",
+  本次沉淀: "Creación de memorias",
+  让记忆从这里开始: "Tus memorias empiezan aquí",
+  对话来源: "Fuentes de conversaciones",
+  尚无已选来源: "No hay fuentes seleccionadas",
+  onboardingSourcesSummary: "{names} y otras aplicaciones ({count} en total)",
+  onboardingImportedConversations:
+    "Conversaciones importadas: {count}. Los controles de las fuentes siguen determinando qué contenido se sincroniza después en este dispositivo.",
+  "处理服务：": "Servicio de procesamiento: ",
+  待选择: "Pendiente de seleccionar",
+  "相关对话会发送给所选服务商。":
+    "Las conversaciones pertinentes se enviarán al proveedor seleccionado.",
+  "测试连接只发送测试内容。启用后会使用此模型整理已导入和之后同步的会话。":
+    "La prueba de conexión solo envía contenido de prueba. Al habilitarlo, este modelo procesará las conversaciones importadas y las que se sincronicen después.",
+  "当前不能在此启用模型。": "No se puede habilitar el modelo aquí por ahora.",
+  接口地址待核对: "Dirección del servicio pendiente de comprobar",
+  "配置已修改，需要重新测试。":
+    "La configuración cambió. Debes repetir la prueba.",
+  onboardingIntegerRange: "Introduce un número entero entre {min} y {max}.",
+  "请填写配置名称。": "Introduce un nombre para la configuración.",
+  "请填写实际可用的模型 ID。": "Introduce un ID de modelo disponible.",
+  "请填写有效的模型接口地址。":
+    "Introduce una dirección válida para el servicio del modelo.",
+  "请填写 API Key。": "Introduce una API Key.",
+  "请填写向量模型 ID。": "Introduce el ID del modelo de embeddings.",
+  "配置结果尚未确认，请在模型设置中核对后重试。":
+    "El resultado de la configuración no está confirmado. Compruébalo en la configuración del modelo antes de reintentar.",
+  "模型连接测试通过，可以启用。":
+    "La prueba de conexión fue satisfactoria. Puedes habilitar el modelo.",
+  "连接未通过，请核对模型、密钥和接收方。":
+    "La conexión falló. Comprueba el modelo, la clave y el destinatario.",
+  "配置或测试结果暂未确认，请核对后重试。":
+    "El resultado de la configuración o la prueba aún no está confirmado. Compruébalo antes de reintentar.",
+  "模型或内容权限未能确认启用，请在设置中核对。":
+    "No se pudo confirmar la habilitación del modelo o del permiso de contenido. Compruébalo en Configuración.",
+  自定义兼容服务: "Servicio compatible personalizado",
+  所选连接已启用: "Se habilitaron las conexiones seleccionadas",
+  本次未选择应用连接: "No se seleccionaron conexiones de aplicaciones",
+  尚未填写接收方: "Destinatario pendiente de introducir",
+  本机内置向量模型: "Modelo de embeddings integrado en este dispositivo",
+  "操作未确认，草稿已保留。":
+    "La operación no está confirmada. El borrador se conserva.",
+  "操作已完成，但配置列表暂未刷新。已保留操作回执，请刷新核对，不要重复保存。":
+    "La operación terminó, pero la lista no se actualizó. Se conservó la confirmación. Actualiza para comprobarla; no vuelvas a guardar.",
+  "暂时无法刷新模型配置，已确认的配置仍保留。请重试刷新。":
+    "No se puede actualizar la configuración de modelos. La configuración confirmada se conserva. Vuelve a actualizar.",
+  "请先核对上次模型测试结果，暂不修改或启用配置。":
+    "Comprueba primero el resultado de la última prueba. No modifiques ni habilites la configuración todavía.",
+  "未找到上次创建记录。确认放弃旧记录后可重新配置；系统不会自动重试。":
+    "No se encontró el registro de creación anterior. Puedes configurar de nuevo tras confirmar que lo descartas. No se reintentará automáticamente.",
+  "创建结果仍待核对，不会重复创建。请稍后再次核对。":
+    "El resultado de la creación sigue pendiente. No se repetirá la creación. Vuelve a comprobarlo más tarde.",
+  "本地恢复记录已变化，仍保持锁定。请重新打开后核对。":
+    "El registro local de recuperación cambió y sigue bloqueado. Vuelve a abrir para comprobarlo.",
+  "已发现模型配置，旧创建记录仍保留。请先核对已有配置。":
+    "Se encontró una configuración de modelo y se conserva el registro de creación anterior. Comprueba primero la configuración existente.",
+  "旧创建记录尚未安全解除，配置仍保持锁定。请重新核对。":
+    "El registro anterior aún no se ha liberado de forma segura. La configuración sigue bloqueada. Vuelve a comprobarlo.",
+  "配置未保存，请检查模型地址和参数后重试；已填写内容保留。":
+    "No se guardó la configuración. Comprueba la dirección y los parámetros del modelo antes de reintentar. Los datos introducidos se conservan.",
+  "创建结果尚未确认，请核对已保存结果，不要重复提交。":
+    "El resultado de la creación no está confirmado. Comprueba lo guardado; no repitas el envío.",
+  "模型配置已变化，旧测试结果不会用于启用，请重新核对配置。":
+    "La configuración del modelo cambió. No se usará la prueba anterior para habilitarlo. Comprueba de nuevo la configuración.",
+  "暂时无法核对测试服务，本次未发送测试，请恢复连接后重试。":
+    "No se puede comprobar el servicio de prueba. No se envió ninguna prueba. Restablece la conexión antes de reintentar.",
+  "另一个模型的测试结果尚未确认，请先在该模型上核对测试结果。":
+    "La prueba de otro modelo sigue sin confirmar. Comprueba primero el resultado de ese modelo.",
+  "测试结果尚未确认。再次点击测试连接将核对原操作，不会重复发送测试。":
+    "La prueba sigue sin confirmar. Al pulsar de nuevo se comprobará la operación original, sin repetir el envío.",
+  "请先点击测试连接，通过后再设为当前模型。":
+    "Prueba primero la conexión. Cuando sea satisfactoria, podrás seleccionar el modelo actual.",
+  "这是当前正在使用的模型，请先切换到别的模型再删除。":
+    "Este es el modelo en uso. Cambia a otro antes de eliminarlo.",
+  "模型配置操作未成功，请核对输入后重试。":
+    "La operación de configuración del modelo no se completó. Comprueba los datos antes de reintentar.",
+  "它没有 MCP 通道，无法发放可撤销的记忆凭证":
+    "No dispone de un canal MCP para emitir credenciales revocables de memorias",
+  当前安装不支持一键插入: "Esta instalación no admite la conexión con un clic",
+  桌面端的连接组件不可用:
+    "El componente de conexión de escritorio no está disponible",
+  安装后没有拿到安装回执: "No se recibió una confirmación después de instalar",
+  记忆使用权限没有获批: "No se aprobó el permiso para usar memorias",
+  配置文件被改过: "Se modificó el archivo de configuración",
+  "有无法确认的残留，需要人工核对":
+    "Quedan elementos sin confirmar que requieren revisión manual",
+  权限存储暂不可用: "El almacenamiento de permisos no está disponible",
+  应用控制通道暂不可用:
+    "El canal de control de la aplicación no está disponible",
+  "请先把 MemHub 拖到“应用程序”文件夹，再接入应用":
+    "Arrastra primero MemHub a la carpeta Aplicaciones para conectar aplicaciones",
+  本机运行时暂不可用: "El entorno de ejecución local no está disponible",
+  桌面端读取接入状态超时:
+    "Se agotó el tiempo de lectura del estado de conexión de escritorio",
+} as const;
+
+export const onboardingChineseMessages = {
+  ...(Object.fromEntries(
+    Object.keys(onboardingSpanishMessages).map((key) => [key, key]),
+  ) as Record<keyof typeof onboardingSpanishMessages, string>),
+  onboardingConnectionPartial:
+    "{success} 个应用已接入，{failed} 个未完成：{names}。可进入应用后单独处理。",
+  onboardingImportHistory: "导入 {name} 历史",
+  onboardingMoreApps: "向下查看更多 · 还有 {count} 个应用",
+  onboardingAllApps: "已显示全部 {count} 个应用",
+  onboardingImportRefused: "尚未获准导入（{reason}）。请核对来源后重试。",
+  onboardingConfirmHistory: "确认这是 {name} 的历史位置",
+  onboardingHistoryWindow:
+    "检测到会话数据量较大。为控制用量并保持各应用时间线一致，本次所有应用仅导入最近 3 天的对话。",
+  onboardingBatchStopped: "已停止后续操作；已发出的操作仍按回执核对。",
+  onboardingBatchResult: "已确认 {confirmed} 项，{failed} 项未确认。",
+  onboardingAppProgress: "{name} 导入进度",
+  onboardingSavedMessages: "已保存 {count} 条消息",
+  onboardingScannedMessages: "已扫描 {count} 条，正在保存",
+  onboardingReadErrors: " · {count} 条读取异常",
+  onboardingSourcesSummary: "{names} 等 {count} 个应用",
+  onboardingImportedConversations:
+    "已导入 {count} 条对话；来源开关继续控制之后同步到本机的内容。",
+  onboardingIntegerRange: "请输入 {min} 至 {max} 的整数。",
+  onboardingModelOperationFailed: "操作没成功：{code}",
+} as const;

memhub/packages/contracts/src/gui-i18n-recovery.test.ts

@@ -0,0 +1,23 @@
+import { expect, it } from "vitest";
+import { translate } from "./gui-i18n.js";
+import {
+  recoveryChineseMessages,
+  recoverySpanishMessages,
+} from "./gui-i18n-recovery.js";
+
+it("covers every recovery key in Spanish with identical interpolation parameters", () => {
+  const params = (message: string) =>
+    [...message.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)]
+      .map((match) => match[1])
+      .sort();
+  for (const key of Object.keys(
+    recoveryChineseMessages,
+  ) as (keyof typeof recoveryChineseMessages)[]) {
+    expect(recoverySpanishMessages[key], key).toBeTruthy();
+    expect(params(recoverySpanishMessages[key]), key).toEqual(
+      params(recoveryChineseMessages[key]),
+    );
+    expect(translate("es", key), key).toBe(recoverySpanishMessages[key]);
+    expect(translate("zh-CN", key), key).toBe(recoveryChineseMessages[key]);
+  }
+});

memhub/packages/contracts/src/gui-i18n-recovery.ts

@@ -0,0 +1,139 @@
+/** Recovery, diagnostics and native chrome. Never translate diagnostic payloads. */
+export const recoveryChineseMessages = {
+  startupReadError: "暂时无法读取启动状态，请重试。",
+  startupRetry: "重新读取",
+  startupOpening: "正在打开 MemHub…",
+  nativeHelp: "帮助",
+  nativeExportLogs: "导出日志（发给开发排查）",
+  nativeExportError: "日志未能导出，请稍后重试。",
+  nativeLogin: "登录时启动 {product}",
+  nativeTrialUnavailable: "（阶段包不可用）",
+  nativeCliManaged: "（由 CLI 管理）",
+  nativeStatusUnavailable: "（状态不可用）",
+  nativeDevelopmentUnavailable: "（开发模式不可用）",
+  nativeOpen: "打开 {product}",
+  nativeQuit: "退出 {product}（后台服务继续运行）",
+  nativeLoginError: "无法更改登录启动设置，请重试。",
+  nativeMoveTitle: "请先将 MemHub 拖到“应用程序”文件夹",
+  nativeMoveDetail:
+    "从“应用程序”重新打开后，MemHub 才会接入其他应用并安装命令行工具。",
+  nativeAcknowledge: "知道了",
+  graphWidthTitle: "现有记忆库和内置模型对不上",
+  graphWidthDescription:
+    "你现在的记忆库按 {stored} 维建的，内置模型出的是 {expected} 维。两者接不上，不选一个的话抽取会一直失败。",
+  graphWidthKeep:
+    "保留现有记忆库（默认）：继续用原来的 embedding 配置，{count} 条记忆和关系图都不动",
+  graphWidthRebuild:
+    "改用内置模型：现有关系图会被归档（不删除），{count} 条记忆的关系需要重新建一遍",
+  graphWidthExport: "先导出再决定：现在什么都不动，导出之后再回来选",
+  graphWidthExported: "已导出到 {path}。原库没有动，现在可以再选一次。",
+  graphWidthUnknown: "宽度选择尚未确认，现有记忆库未被改动。请重试。",
+  graphWidthConfirm: "就这么办",
+  importUserProgress:
+    "正在导入你的历史对话，已导入 {count} 个会话。记忆会陆续生成，你可以先正常使用。",
+  importUserModel: "模型还没有配置好，新的对话暂时不会整理成记忆。",
+  importUserIncomplete: "有些内容没有处理完成，请前往设置查看。",
+  importUserSettings: "去设置",
+  diagnosticExportDesktop: "请在桌面 App 中导出诊断信息。",
+  diagnosticExported: "日志已导出：{filename}",
+  diagnosticFile: "诊断文件",
+  diagnosticExportFailed: "诊断信息未能导出，请重试。",
+  debugTitle: "Debug 日志",
+  debugCount: "{count} 条，本次启动",
+  debugPause: "暂停实时刷新",
+  debugResume: "继续实时刷新",
+  debugRefresh: "立即刷新",
+  debugClose: "关闭 Debug 日志",
+  debugSearchPlaceholder: "搜索事件、组件、错误码或内容",
+  debugSearch: "搜索日志",
+  debugSource: "日志来源",
+  debugAllSources: "全部来源",
+  debugCapture: "采集级别",
+  debugDisplay: "显示级别",
+  debugAll: "全部",
+  debugMatches: "{count} 条匹配",
+  debugLive: "实时刷新",
+  debugPaused: "已暂停",
+  debugTruncated: "日志过多，已截断",
+  debugReadError: "读取失败",
+  debugLoading: "正在读取日志…",
+  debugEmpty: "没有匹配的日志",
+  debugOpened: "Debug 日志已打开",
+  debugOpen: "打开 Debug 日志",
+} as const;
+
+export const recoverySpanishMessages: Record<
+  keyof typeof recoveryChineseMessages,
+  string
+> = {
+  startupReadError: "No se pudo leer el estado de inicio. Inténtalo de nuevo.",
+  startupRetry: "Volver a leer",
+  startupOpening: "Abriendo MemHub…",
+  nativeHelp: "Ayuda",
+  nativeExportLogs: "Exportar registros (para diagnóstico)",
+  nativeExportError:
+    "No se pudieron exportar los registros. Inténtalo más tarde.",
+  nativeLogin: "Iniciar {product} al iniciar sesión",
+  nativeTrialUnavailable: " (no disponible en esta versión de prueba)",
+  nativeCliManaged: " (administrado por CLI)",
+  nativeStatusUnavailable: " (estado no disponible)",
+  nativeDevelopmentUnavailable: " (no disponible en desarrollo)",
+  nativeOpen: "Abrir {product}",
+  nativeQuit: "Salir de {product} (el servicio sigue en segundo plano)",
+  nativeLoginError:
+    "No se pudo cambiar el inicio de sesión. Inténtalo de nuevo.",
+  nativeMoveTitle: "Arrastra MemHub a la carpeta Aplicaciones primero",
+  nativeMoveDetail:
+    "Abre MemHub desde Aplicaciones para conectarlo con otras aplicaciones e instalar las herramientas de línea de comandos.",
+  nativeAcknowledge: "Entendido",
+  graphWidthTitle: "La biblioteca y el modelo integrado no coinciden",
+  graphWidthDescription:
+    "La biblioteca usa {stored} dimensiones y el modelo integrado produce {expected}. Son incompatibles: la extracción seguirá fallando hasta que elijas una opción.",
+  graphWidthKeep:
+    "Conservar la biblioteca actual (predeterminado): seguir con la configuración de embedding anterior; no se modifican las {count} memorias ni el grafo",
+  graphWidthRebuild:
+    "Usar el modelo integrado: el grafo actual se archivará (no se eliminará); será necesario reconstruir las relaciones de {count} memorias",
+  graphWidthExport:
+    "Exportar antes de decidir: no cambiar nada por ahora; volver a elegir después de exportar",
+  graphWidthExported:
+    "Se exportó a {path}. La biblioteca original no cambió; ahora puedes volver a elegir.",
+  graphWidthUnknown:
+    "La elección de dimensiones aún no está confirmada; la biblioteca actual no se ha modificado. Inténtalo de nuevo.",
+  graphWidthConfirm: "Confirmar esta elección",
+  importUserProgress:
+    "Importando tus conversaciones anteriores: {count} conversaciones importadas. Las memorias aparecerán gradualmente; puedes seguir usando la aplicación.",
+  importUserModel:
+    "El modelo aún no está configurado; las conversaciones nuevas no se convertirán en memorias por ahora.",
+  importUserIncomplete:
+    "Parte del contenido no terminó de procesarse. Consulta la configuración.",
+  importUserSettings: "Ir a configuración",
+  diagnosticExportDesktop:
+    "Exporta el diagnóstico desde la aplicación de escritorio.",
+  diagnosticExported: "Registros exportados: {filename}",
+  diagnosticFile: "archivo de diagnóstico",
+  diagnosticExportFailed:
+    "No se pudo exportar el diagnóstico. Inténtalo de nuevo.",
+  debugTitle: "Registros de depuración",
+  debugCount: "{count} registros en este inicio",
+  debugPause: "Pausar actualización en vivo",
+  debugResume: "Reanudar actualización en vivo",
+  debugRefresh: "Actualizar ahora",
+  debugClose: "Cerrar registros de depuración",
+  debugSearchPlaceholder:
+    "Buscar eventos, componentes, códigos de error o contenido",
+  debugSearch: "Buscar registros",
+  debugSource: "Origen de los registros",
+  debugAllSources: "Todos los orígenes",
+  debugCapture: "Nivel de captura",
+  debugDisplay: "Nivel mostrado",
+  debugAll: "Todos",
+  debugMatches: "{count} coincidencias",
+  debugLive: "Actualización en vivo",
+  debugPaused: "En pausa",
+  debugTruncated: "Demasiados registros; se truncaron",
+  debugReadError: "No se pudieron leer los registros",
+  debugLoading: "Leyendo registros…",
+  debugEmpty: "No hay registros coincidentes",
+  debugOpened: "Registros de depuración abiertos",
+  debugOpen: "Abrir registros de depuración",
+};

memhub/packages/contracts/src/gui-i18n-settings.test.ts

@@ -0,0 +1,22 @@
+import { expect, it } from "vitest";
+import { translate } from "./gui-i18n.js";
+import {
+  settingsChineseMessages,
+  settingsSpanishMessages,
+} from "./gui-i18n-settings.js";
+
+it("provides Spanish settings copy with matching interpolation parameters", () => {
+  for (const key of Object.keys(
+    settingsSpanishMessages,
+  ) as (keyof typeof settingsSpanishMessages)[]) {
+    const params = (value: string) =>
+      [...value.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)]
+        .map((match) => match[1])
+        .sort();
+    expect(settingsSpanishMessages[key], key).toBeTruthy();
+    expect(params(settingsSpanishMessages[key]), key).toEqual(
+      params(settingsChineseMessages[key]),
+    );
+    expect(translate("es", key), key).not.toMatch(/[\u3400-\u9fff]/);
+  }
+});

memhub/packages/contracts/src/gui-i18n-settings.ts

@@ -0,0 +1,383 @@
+/** GUI copy only: never apply this catalog to persisted memories or provider data. */
+export const settingsSpanishMessages = {
+  "请填写 API Key。": "Introduce la clave API.",
+  "这里需要 API Key，不是网址。请填写服务方提供的密钥。":
+    "Aquí se necesita una clave API, no una URL. Introduce la clave del proveedor.",
+  "服务商拒绝了这个 API Key（401）。请确认密钥属于当前填写的服务地址。":
+    "El proveedor rechazó la clave API (401). Comprueba que corresponda a la dirección del servicio.",
+  "服务商没有这个模型名，请对照服务商的模型列表核对。":
+    "El proveedor no reconoce este modelo. Comprueba su lista de modelos.",
+  "连不上接口地址，请检查网络和服务地址是否正确。":
+    "No se pudo conectar al servicio. Comprueba la red y la dirección.",
+  未提供接口地址: "No se indicó una dirección del servicio",
+  "请填写生成模型名。": "Introduce el identificador del modelo de generación.",
+  "请填写完整的 http:// 或 https:// 接口地址。":
+    "Introduce una dirección completa del servicio con http:// o https://.",
+  "请填写向量模型名。": "Introduce el identificador del modelo de embeddings.",
+  "请填写完整的向量模型接口地址。":
+    "Introduce la dirección completa del servicio de embeddings.",
+  "这份配置在测试期间被改过，刚才测的是改动后的版本。配置已保存但未启用，请重新测试并启用。":
+    "La configuración cambió durante la prueba; se probó la versión modificada. Está guardada, pero no habilitada. Vuelve a probarla y habilitarla.",
+  "测试结果来自这份配置更早的版本。配置已保存但未启用，请重新测试并启用。":
+    "La prueba corresponde a una versión anterior. La configuración está guardada, pero no habilitada. Vuelve a probarla y habilitarla.",
+  "配置已保存，连接测试未通过。请核对配置后重试，历史对话尚未发送。":
+    "Configuración guardada; la prueba de conexión falló. Compruébala y reintenta. No se han enviado conversaciones anteriores.",
+  "配置已保存，尚未确认启用成功。请核对配置后重试。":
+    "Configuración guardada; la activación aún no está confirmada. Compruébala y reintenta.",
+  "配置尚未完成测试和启用，请核对后重试。":
+    "La prueba y activación no se completaron. Comprueba la configuración y reintenta.",
+  "配置未保存，请检查模型地址和参数后重试；已填写内容保留。":
+    "No se guardó la configuración. Comprueba la dirección y los parámetros y reintenta; se conserva lo introducido.",
+  "配置尚未保存成功，已填写内容保留，可核对后重试。":
+    "No se confirmó el guardado. Se conserva lo introducido; compruébalo y reintenta.",
+  "只需配置生成模型。向量嵌入已内置在本机，不为 System 1、System 2 分开选模型。":
+    "Solo necesitas configurar el modelo de generación. Los embeddings están integrados localmente; System 1 y System 2 no requieren modelos separados.",
+  "无法读取测试恢复记录，暂不发送新的测试。":
+    "No se pudo leer el registro de recuperación de pruebas. No se enviarán nuevas pruebas por ahora.",
+  "上次模型测试结果待核对，暂不修改或启用配置。":
+    "El resultado de la última prueba está pendiente. No se modificará ni habilitará la configuración por ahora.",
+  核对测试结果: "Comprobar resultado de la prueba",
+  "未找到上次创建记录。确认放弃旧记录后可重新配置；系统不会自动重试。":
+    "No se encontró el registro de la última creación. Puedes descartarlo y volver a configurar; no se reintentará automáticamente.",
+  "上次模型创建结果待核对，暂不开始新的操作。":
+    "La última creación está pendiente de comprobar. No se iniciarán nuevas operaciones por ahora.",
+  核对创建结果: "Comprobar resultado de la creación",
+  "放弃旧记录，重新配置": "Descartar registro anterior y configurar de nuevo",
+  "配置已保存，正在测试连接…": "Configuración guardada. Probando conexión…",
+  "连接通过，正在启用模型…": "Conexión correcta. Habilitando modelo…",
+  刷新配置列表: "Actualizar configuraciones",
+  自定义一个模型: "Configurar un modelo personalizado",
+  已保存的模型配置: "Configuración de modelo guardada",
+  "已保存，已启用": "Guardada y habilitada",
+  "已保存，连接通过": "Guardada; conexión correcta",
+  "已保存，测试未通过": "Guardada; prueba fallida",
+  "已保存，待测试": "Guardada; pendiente de prueba",
+  版本: "Versión",
+  "需要允许 MemHub 访问钥匙串。系统询问时请选择“始终允许”；已保存的配置不会丢失。":
+    "MemHub necesita acceso al llavero. Cuando el sistema lo solicite, selecciona «Permitir siempre». La configuración guardada se conservará.",
+  "测试只向此接口发送测试内容，不发送历史对话。":
+    "La prueba solo envía contenido de prueba a este servicio, no conversaciones anteriores.",
+  重试测试并启用: "Reintentar prueba y habilitar",
+  测试并启用: "Probar y habilitar",
+  编辑配置: "Editar configuración",
+  新增配置: "Añadir configuración",
+  编辑: "Editar",
+  "。修改后需重新测试并设为当前模型，内容授权不会自动更新。":
+    ". Después de modificar, vuelve a probar y seleccionar el modelo actual. La autorización de contenido no se actualizará automáticamente.",
+  "配置已在其他位置变化，草稿已保留。请取消编辑后重新打开核对。":
+    "La configuración cambió en otro lugar. Se conserva el borrador. Cancela la edición y vuelve a abrirla para comprobarla.",
+  服务商预设: "Preajuste del proveedor",
+  自定义兼容服务: "Servicio compatible personalizado",
+  "只是帮你填好接口地址和一个模型名，不代表这个模型当前可用。 请对照服务商的模型列表核对后再保存。":
+    "Solo completa la dirección y un identificador de modelo; no garantiza su disponibilidad. Comprueba la lista del proveedor antes de guardar.",
+  协议: "Protocolo",
+  "与模型服务提供的接口协议保持一致。":
+    "Debe coincidir con el protocolo del servicio del modelo.",
+  配置名称: "Nombre de la configuración",
+  "用于区分配置，不影响模型请求。":
+    "Sirve para distinguir configuraciones; no afecta a las solicitudes al modelo.",
+  生成模型名: "Identificador del modelo de generación",
+  "例如：gpt-4o-mini…": "Por ejemplo: gpt-4o-mini…",
+  "填写服务方提供的完整模型标识。":
+    "Introduce el identificador completo que proporciona el proveedor.",
+  "高级：自行配置向量模型": "Avanzado: configurar embeddings",
+  向量配置模式: "Modo de configuración de embeddings",
+  本地内置: "Integrado localmente",
+  自定义向量模型: "Modelo de embeddings personalizado",
+  向量模型名: "Identificador del modelo de embeddings",
+  "例如：text-embedding-3-small…": "Por ejemplo: text-embedding-3-small…",
+  向量模型来源: "Proveedor de embeddings",
+  "本机 Ollama": "Ollama local",
+  "同源 OpenAI-compatible（共用 API Key）":
+    "OpenAI-compatible del mismo origen (comparte clave API)",
+  "向量模型 Base URL": "Base URL de embeddings",
+  "为避免凭据外泄，向量地址必须与生成模型同源。":
+    "Para evitar filtraciones de credenciales, la dirección de embeddings debe tener el mismo origen que la del modelo de generación.",
+  "使用内置本地向量模型；不会发送内容给远程向量服务。":
+    "Usa los embeddings locales integrados. No se envía contenido a un servicio remoto de embeddings.",
+  自定义向量: "Embeddings personalizados",
+  尚未填写模型: "Modelo sin indicar",
+  尚未填写地址: "Dirección sin indicar",
+  "填写服务接口地址，不是聊天网页地址。":
+    "Introduce la dirección del servicio, no la página web del chat.",
+  "（可选）": " (opcional)",
+  "保存后不会再次显示…": "No volverá a mostrarse después de guardar…",
+  "留空保留已保存密钥；填写新密钥后需重新测试和启用。":
+    "Déjala vacía para conservar la clave guardada. Si introduces otra, vuelve a probar y habilitar.",
+  "换了服务商后需要填写新的 API Key，已保存的密钥不会带到新地址。":
+    "Al cambiar de proveedor necesitas otra clave API. La clave guardada no se enviará a la nueva dirección.",
+  "保存在系统安全存储中，不随安装包分发。":
+    "Se guarda en el almacén seguro del sistema; no se distribuye con la aplicación.",
+  "关闭思考链（向支持的厂商下发 thinking-off 参数）":
+    "Desactivar razonamiento (envía thinking-off a proveedores compatibles)",
+  保存修改: "Guardar cambios",
+  保存配置: "Guardar configuración",
+  "正在测试连接…": "Probando conexión…",
+  "正在启用配置…": "Habilitando configuración…",
+  测试并完成配置: "Probar y completar configuración",
+  保存并测试启用: "Guardar, probar y habilitar",
+  取消编辑: "Cancelar edición",
+  "密钥保存在系统安全存储；测试仅发送测试内容。":
+    "La clave se guarda en el almacén seguro del sistema. La prueba solo envía contenido de prueba.",
+  当前使用: "En uso",
+  未启用: "No habilitada",
+  测试目标: "Destino de prueba",
+  "。仅发送测试内容，不发送历史对话。":
+    ". Solo se envía contenido de prueba, no conversaciones anteriores.",
+  测试连接: "Probar conexión",
+  设为当前模型: "Seleccionar como modelo actual",
+  删除: "Eliminar",
+  "粘贴 API Key": "Pegar clave API",
+  "密钥尚未保存成功，已填写内容保留，可重试。":
+    "No se confirmó el guardado de la clave. Se conserva lo introducido; puedes reintentar.",
+  生成接收方: "Destinatario de generación",
+  向量接收方: "Destinatario de embeddings",
+  本机: "Este dispositivo",
+  "。启用此配置后按上方选择处理历史及未来允许来源。":
+    ". Al habilitar, se procesarán las fuentes históricas y futuras autorizadas según la selección anterior.",
+  "保存 key": "Guardar clave",
+  "还没有 key？去申请": "¿No tienes clave? Solicítala",
+  删除这张卡: "Eliminar esta configuración",
+  "密钥已配置，当前读取状态待确认。":
+    "Clave configurada; su lectura está pendiente de confirmar.",
+  "等待 key：其余都已经填好了，贴上 key 就能用。":
+    "Falta la clave; los demás campos ya están completos.",
+  "key 已保存，还没测过这个模型能不能用。":
+    "Clave guardada; el modelo todavía no se ha probado.",
+  "Ollama（本机）": "Ollama (local)",
+  "内置 bge-small-zh-v1.5": "Integrado: bge-small-zh-v1.5",
+  通过: "Correcta",
+  "HY 托管模型尚不可用": "El modelo administrado de HY no está disponible",
+  "缺少 API Key": "Falta la clave API",
+  服务不可达: "Servicio inaccesible",
+  "认证失败；更新 key 后再检测，会自动接着处理":
+    "Autenticación fallida. Actualiza la clave y vuelve a comprobar para continuar el procesamiento",
+  请求频率受限: "Límite de solicitudes alcanzado",
+  "模型账户余额不足；充值或换 key 后再检测，会自动接着处理":
+    "Saldo insuficiente. Recarga o cambia la clave y comprueba de nuevo para continuar el procesamiento",
+  没有找到模型: "Modelo no encontrado",
+  "该网关不提供模型列表，已改由生成调用验证":
+    "Este servicio no ofrece una lista de modelos; se verificó mediante generación",
+  服务返回不符合协议: "Respuesta incompatible con el protocolo",
+  结构化输出未通过: "La salida estructurada no superó la prueba",
+  "需要填写 Embedding 模型": "Es necesario indicar un modelo de embeddings",
+  "Embedding 模型不可用": "Modelo de embeddings no disponible",
+  "操作已完成，但配置列表暂未刷新。已保留操作回执，请刷新核对，不要重复保存。":
+    "La operación terminó, pero no se actualizó la lista. Se conserva la confirmación; actualiza para comprobar sin volver a guardar.",
+  "暂时无法刷新模型配置，已确认的配置仍保留。请重试刷新。":
+    "No se pudo actualizar la configuración. Se conservan las configuraciones confirmadas. Reintenta la actualización.",
+  "请先核对上次模型测试结果，暂不修改或启用配置。":
+    "Comprueba primero el resultado de la última prueba. No modifiques ni habilites la configuración todavía.",
+  "创建结果仍待核对，不会重复创建。请稍后再次核对。":
+    "La creación sigue pendiente de comprobar; no se repetirá. Vuelve a comprobar más tarde.",
+  "本地恢复记录已变化，仍保持锁定。请重新打开后核对。":
+    "El registro local de recuperación cambió y sigue bloqueado. Vuelve a abrir para comprobarlo.",
+  "已发现模型配置，旧创建记录仍保留。请先核对已有配置。":
+    "Se encontró la configuración; el registro anterior se conserva. Comprueba primero la configuración existente.",
+  "旧创建记录尚未安全解除，配置仍保持锁定。请重新核对。":
+    "No se pudo descartar de forma segura el registro anterior. La configuración sigue bloqueada; compruébala de nuevo.",
+  "创建结果尚未确认，请核对已保存结果，不要重复提交。":
+    "La creación no está confirmada. Comprueba lo guardado sin volver a enviarlo.",
+  "模型配置已变化，旧测试结果不会用于启用，请重新核对配置。":
+    "La configuración cambió. La prueba anterior no se usará para habilitarla; compruébala de nuevo.",
+  "暂时无法核对测试服务，本次未发送测试，请恢复连接后重试。":
+    "No se pudo comprobar el servicio y no se envió la prueba. Recupera la conexión y reintenta.",
+  "另一个模型的测试结果尚未确认，请先在该模型上核对测试结果。":
+    "La prueba de otro modelo está pendiente. Comprueba primero su resultado.",
+  "测试结果尚未确认。再次点击测试连接将核对原操作，不会重复发送测试。":
+    "La prueba aún no está confirmada. Al pulsar de nuevo se comprobará la operación original, sin enviar otra prueba.",
+  "请先点击测试连接，通过后再设为当前模型。":
+    "Prueba la conexión primero. Selecciona el modelo actual después de superar la prueba.",
+  "这是当前正在使用的模型，请先切换到别的模型再删除。":
+    "Este es el modelo actual. Selecciona otro antes de eliminarlo.",
+  "模型配置操作未成功，请核对输入后重试。":
+    "La operación de configuración falló. Comprueba los datos y reintenta.",
+  测试结果: "Resultado de la prueba",
+  "暂不支持一键插入：它没有 MCP 通道，无法发放可撤销的记忆凭证。":
+    "No admite conexión directa: no tiene canal MCP y no se pueden emitir credenciales revocables de memoria.",
+  "它没有 MCP 通道，无法发放可撤销的记忆凭证":
+    "No tiene canal MCP y no se pueden emitir credenciales revocables de memoria",
+  当前安装不支持一键插入: "Esta instalación no admite conexión directa",
+  桌面端的连接组件不可用:
+    "El componente de conexión del escritorio no está disponible",
+  安装后没有拿到安装回执: "No se recibió una confirmación de instalación",
+  记忆使用权限没有获批: "No se aprobó el permiso de uso de memorias",
+  配置文件被改过: "El archivo de configuración cambió",
+  "有无法确认的残留，需要人工核对":
+    "Hay restos sin confirmar que requieren comprobación manual",
+  权限存储暂不可用: "El almacén de permisos no está disponible",
+  应用控制通道暂不可用:
+    "El canal de control de la aplicación no está disponible",
+  "请先把 MemHub 拖到“应用程序”文件夹，再接入应用":
+    "Arrastra MemHub a Aplicaciones antes de conectar aplicaciones",
+  本机运行时暂不可用: "El runtime local no está disponible",
+  桌面端读取接入状态超时:
+    "Se agotó el tiempo de lectura del estado de conexión",
+  "当前接入状态也未能重新读取，显示的可能不是最新状态。":
+    "Tampoco se pudo volver a leer la conexión; el estado mostrado podría no estar actualizado.",
+  原因: "Motivo",
+  模型: "Modelo",
+  连接其他应用: "Conectar otras aplicaciones",
+  帮助与诊断: "Ayuda y diagnóstico",
+  设置分组: "Secciones de configuración",
+  记忆模型: "Modelo de memorias",
+  当前模型: "Modelo actual",
+  "正在读取模型…": "Leyendo el modelo…",
+  模型状态暂不可读: "Estado del modelo no disponible",
+  尚未配置模型: "No hay un modelo configurado",
+  修改模型: "Modificar modelo",
+  配置模型: "Configurar modelo",
+  刷新模型状态: "Actualizar estado del modelo",
+  "本机 / 受管端点": "Servicio local / administrado",
+  接口地址待核对: "Dirección del servicio pendiente de comprobar",
+  "模型状态未能读取，请重试。":
+    "No se pudo leer el estado del modelo. Reintenta.",
+  "模型状态刷新未成功，仍显示上次确认的模型状态；请重试。":
+    "No se pudo actualizar el estado. Se muestra el último estado confirmado; reintenta.",
+  "模型配置暂时无法打开：正在处理上一次创建或测试，或本机存储暂时不可用。 请等待当前操作结束后重试；现有配置和原文不会被改动。":
+    "No se puede abrir la configuración: hay una creación o prueba pendiente, o el almacenamiento local no está disponible. Espera a que termine la operación y reintenta; no se modificarán la configuración ni los textos originales.",
+  模型配置表单: "Formulario de configuración del modelo",
+  "修改结果尚未确认，正在重新读取当前设置。":
+    "El cambio aún no está confirmado. Se está volviendo a leer la configuración actual.",
+  "部分运行状态暂时无法读取，当前显示最后读到的状态，请重试。":
+    "Algunos estados no están disponibles. Se muestra la última lectura; reintenta.",
+  "当前安装还不能设置登录后后台启动。":
+    "Esta instalación no permite configurar el inicio en segundo plano al iniciar sesión.",
+  "登录后后台启动设置未能确认，请重试。":
+    "No se pudo confirmar el inicio en segundo plano. Reintenta.",
+  "当前安装还不能退出界面，请从菜单栏退出。":
+    "Esta instalación no permite cerrar la interfaz desde aquí. Usa la barra de menús.",
+  "退出界面未能确认，请重试。":
+    "No se pudo confirmar el cierre de la interfaz. Reintenta.",
+  登录后启动后台服务: "Iniciar el servicio al iniciar sesión",
+  "无需打开界面，持续同步、整理和提供记忆。":
+    "Sincroniza, organiza y ofrece memorias sin abrir la interfaz.",
+  导出日志: "Exportar registros",
+  "把本机运行日志打包成一个文件，发给开发排查。":
+    "Empaqueta los registros locales en un archivo para su diagnóstico.",
+  "确定退出 One Memory 界面吗？": "¿Cerrar la interfaz de One Memory?",
+  "后台服务会继续同步、整理和提供记忆。":
+    "El servicio en segundo plano seguirá sincronizando, organizando y ofreciendo memorias.",
+  取消: "Cancelar",
+  退出界面: "Cerrar interfaz",
+  应用详情: "Detalles de la aplicación",
+  返回应用: "Volver a Aplicaciones",
+  应用设置: "Configuración de la aplicación",
+  同步开关: "Sincronización",
+  "开启后处理历史待办，并持续接收此应用的新会话。":
+    "Al activar, procesa el historial pendiente y recibe las nuevas conversaciones de esta aplicación.",
+  "正在读取已有对话，首次开启可能需要一两分钟，请不要重复点击。":
+    "Leyendo conversaciones existentes. El primer inicio puede tardar uno o dos minutos; no vuelvas a pulsar.",
+  "将补充冻结期间的新对话；原有 pending Job 继续处理。":
+    "Se incorporarán las conversaciones del periodo pausado; los trabajos pendientes existentes seguirán procesándose.",
+  一键插入应用: "Conectar aplicación",
+  "安装记忆连接，并默认允许此应用使用已授权记忆。":
+    "Instala la conexión y permite a esta aplicación usar las memorias autorizadas.",
+  允许使用记忆: "Permitir el uso de memorias",
+  连接状态: "Estado de conexión",
+  已接通: "Conectada",
+  "已安装，但取不到记忆": "Instalada, sin acceso a memorias",
+  未接通: "Sin conexión",
+  状态待核对: "Estado pendiente de comprobar",
+  检测中: "Detectando",
+  未开启关联: "Conexión no habilitada",
+  "正在开启处理…": "Activando procesamiento…",
+  "正在冻结处理…": "Pausando procesamiento…",
+  处理中: "Procesando",
+  已冻结: "En pausa",
+  "此应用的处理开关结果未能确认，其他应用不受影响。":
+    "No se pudo confirmar el cambio de procesamiento de esta aplicación. Las demás no se ven afectadas.",
+  "暂时无法刷新来源状态，请重试；未更改同步或读取权限。":
+    "No se pudo actualizar el estado de la fuente. Reintenta; no se modificaron los permisos de sincronización ni de lectura.",
+  "暂时无法读取连接状态，当前状态待核对；请重试。":
+    "No se pudo leer el estado de conexión. Está pendiente de comprobar; reintenta.",
+  "已接通。已经打开的对话不会中途出现这个工具，请新开一轮。":
+    "Conectada. La herramienta no aparecerá en conversaciones ya abiertas; inicia una nueva.",
+  "本次连接探测失败，当前状态待核对；未把上次读取当作本次成功。":
+    "La comprobación de conexión falló. El estado está pendiente; la lectura anterior no se considera un éxito actual.",
+  上次读取: "Última lectura",
+  appSettingsTitle: "Configuración de {name}",
+  appMemoryScope:
+    "Permite que {name} consulte las memorias dentro del alcance autorizado.",
+  appRestart:
+    "La herramienta de memorias no está en la conversación actual de {name}. Cierra completamente {name} y vuelve a abrirla; aparecerá en una conversación nueva.",
+  appConnectFailed:
+    "No se completó la conexión de esta aplicación. Las demás no se ven afectadas. {reason}",
+  appDisconnectFailed:
+    "No se pudo eliminar la conexión ni revocar el permiso. {name} aún puede usar memorias. Reintenta. {reason}",
+  appPermissionFailed:
+    "No se pudo confirmar el permiso de uso de memorias de esta aplicación. Reintenta. {reason}",
+  appRevokedModified:
+    "Se revocó el permiso; {name} ya no puede consultar memorias. El archivo de configuración cambió y MemHub no lo eliminó automáticamente. Quita manualmente la conexión de MemHub.",
+  appRevokedRetained:
+    "Se revocó el permiso; {name} ya no puede consultar memorias. No se eliminó el archivo de conexión. Compruébalo de nuevo.",
+  appRevokedReview:
+    "Se revocó el permiso; {name} ya no puede consultar memorias. No se pudo confirmar la eliminación completa de la conexión. Comprueba manualmente: {paths}.",
+  appRevoked: "Se revocó el permiso; {name} ya no puede consultar memorias. ",
+  appRemovalReview:
+    "No se pudo confirmar la eliminación completa de la conexión. Comprueba manualmente: {paths}.",
+  "配置文件被改过，MemHub 没有自动删除；请手动移除其中的 MemHub 连接。":
+    "El archivo de configuración cambió y MemHub no lo eliminó automáticamente. Quita manualmente la conexión de MemHub.",
+  "连接文件没有移除，请重新核对。":
+    "No se eliminó el archivo de conexión. Compruébalo de nuevo.",
+  "Cursor 的连接凭证已更新。请完全退出并重新打开 Cursor，再开始新对话。":
+    "Las credenciales de conexión de Cursor se actualizaron. Cierra completamente Cursor y vuelve a abrirlo; después, inicia una conversación nueva.",
+  连接其他工具: "Conectar otras herramientas",
+  "本机连接材料仅在桌面 App 中可用。":
+    "El material de conexión local solo está disponible en la aplicación de escritorio.",
+  "仅本机 MCP / 命令工具。纯网页聊天不支持直接连接本机。":
+    "Solo herramientas MCP / comandos locales. Los chats exclusivamente web no pueden conectarse directamente a este dispositivo.",
+  "列表内工具请用上方一键安装，此处仅供未列出的工具。":
+    "Para las herramientas de la lista, usa la instalación directa de arriba. Esta sección es para otras herramientas.",
+  "正在读取本机连接配置…": "Leyendo la configuración de conexión local…",
+  "未能读取连接配置。": "No se pudo leer la configuración de conexión.",
+  重试: "Reintentar",
+  连接材料格式: "Formato del material de conexión",
+  连接提示词: "Instrucciones de conexión",
+  "MCP 配置": "Configuración MCP",
+  命令: "Comando",
+  本机连接材料: "Material de conexión local",
+  "包含本机路径，不含记忆和密钥。片段会运行本机 MemHub 连接程序；粘贴前请确认，MemHub 需保持运行。":
+    "Incluye rutas locales, pero no memorias ni claves. Los fragmentos ejecutan el conector local de MemHub. Revísalos antes de pegarlos y mantén MemHub en ejecución.",
+  "已复制，尚未建立连接。":
+    "Copiado. La conexión todavía no se ha establecido.",
+  "复制失败，可在上方选中文本复制。":
+    "No se pudo copiar. Puedes seleccionar el texto de arriba y copiarlo manualmente.",
+  复制提示词: "Copiar instrucciones",
+  复制配置: "Copiar configuración",
+  复制命令: "Copiar comando",
+  记忆库分页: "Paginación de la biblioteca de memorias",
+  上一页: "Página anterior",
+  下一页: "Página siguiente",
+  memoryPageTotal: "{count} memorias en total",
+  memoryPageNumber: "Página {page}",
+} as const;
+
+const chineseOverrides: Partial<
+  Record<keyof typeof settingsSpanishMessages, string>
+> = {
+  appSettingsTitle: "{name} 应用设置",
+  appMemoryScope: "让 {name} 查询已授权范围内的记忆。",
+  appRestart:
+    "记忆工具没有进到 {name} 当前对话。完全退出 {name} 后重新打开，新对话里才会出现。",
+  appConnectFailed: "此应用的一键接入未完成，其他应用不受影响。{reason}",
+  appDisconnectFailed:
+    "连接未能移除，记忆权限也未能撤销，{name} 仍可使用记忆，请重试。{reason}",
+  appPermissionFailed: "此应用的记忆使用权限未能确认，请重试。{reason}",
+  appRevokedModified:
+    "已撤销记忆权限，{name} 已查不到记忆。配置文件被改过，MemHub 没有自动删除；请手动移除其中的 MemHub 连接。",
+  appRevokedRetained:
+    "已撤销记忆权限，{name} 已查不到记忆。连接文件没有移除，请重新核对。",
+  appRevokedReview:
+    "已撤销记忆权限，{name} 已查不到记忆。但无法确认连接已全部移除，需要你手动核对：{paths}。",
+  appRevoked: "已撤销记忆权限，{name} 已查不到记忆。",
+  appRemovalReview: "无法确认连接已全部移除，需要你手动核对：{paths}。",
+  memoryPageTotal: "共 {count} 条",
+  memoryPageNumber: "第 {page} 页",
+};
+export const settingsChineseMessages = Object.fromEntries(
+  Object.keys(settingsSpanishMessages).map((key) => [
+    key,
+    chineseOverrides[key as keyof typeof settingsSpanishMessages] ?? key,
+  ]),
+) as Record<keyof typeof settingsSpanishMessages, string>;

memhub/packages/contracts/src/gui-i18n.test.ts

@@ -0,0 +1,161 @@
+import { describe, expect, expectTypeOf, it, vi } from "vitest";
+
+import {
+  type GuiLocale,
+  isLanguagePreference,
+  isLanguageSnapshot,
+  type LanguagePreference,
+  type LanguageSnapshot,
+  type MessageKey,
+  resolveGuiLocale,
+  translate,
+} from "./gui-i18n.js";
+
+const messageKeys = [
+  "settings",
+  "languageTitle",
+  "languageLabel",
+  "languageSystem",
+  "languageChinese",
+  "languageSpanish",
+  "languageDescription",
+  "languageSaveError",
+  "languageLoadError",
+  "nativeErrorTitle",
+] as const satisfies readonly MessageKey[];
+
+describe("GUI language contracts", () => {
+  it("pins the language preference and snapshot types", () => {
+    expectTypeOf<LanguagePreference>().toEqualTypeOf<
+      "system" | "zh-CN" | "es"
+    >();
+    expectTypeOf<GuiLocale>().toEqualTypeOf<"zh-CN" | "es">();
+    expectTypeOf<LanguageSnapshot>().toEqualTypeOf<{
+      preference: LanguagePreference;
+      locale: GuiLocale;
+      revision: number;
+    }>();
+  });
+
+  it.each(["system", "zh-CN", "es"])("accepts preference %s", (value) => {
+    expect(isLanguagePreference(value)).toBe(true);
+  });
+
+  it.each([undefined, null, "", "en", "ES", "es-MX", {}, [], 1, true])(
+    "rejects invalid preferences: %j",
+    (value) => expect(isLanguagePreference(value)).toBe(false),
+  );
+
+  it("validates snapshots and nonnegative safe integer revisions", () => {
+    expect(
+      isLanguageSnapshot({ preference: "system", locale: "es", revision: 0 }),
+    ).toBe(true);
+    expect(
+      isLanguageSnapshot({
+        preference: "zh-CN",
+        locale: "zh-CN",
+        revision: Number.MAX_SAFE_INTEGER,
+      }),
+    ).toBe(true);
+    for (const value of [
+      undefined,
+      null,
+      [],
+      {},
+      { preference: "en", locale: "es", revision: 0 },
+      { preference: "es", locale: "zh-CN", revision: 0 },
+      { preference: "zh-CN", locale: "es", revision: 0 },
+      { preference: "system", locale: "system", revision: 0 },
+      { preference: "system", locale: "es" },
+      ...[-1, 0.5, NaN, Infinity, Number.MAX_SAFE_INTEGER + 1, "0"].map(
+        (revision) => ({ preference: "system", locale: "es", revision }),
+      ),
+    ]) {
+      expect(isLanguageSnapshot(value)).toBe(false);
+    }
+  });
+});
+
+describe("GUI locale resolution", () => {
+  it.each([
+    "es",
+    "es-ES",
+    "es-MX",
+    "ES-ar",
+    "es-419",
+    "es-Latn-ES",
+    "es-u-nu-latn",
+  ])("resolves Spanish primary language %s", (language) =>
+    expect(resolveGuiLocale("system", language)).toBe("es"),
+  );
+
+  it.each([
+    undefined,
+    "",
+    "en",
+    "zh",
+    "zh-TW",
+    "fr-ES",
+    "en-US-u-rg-eszzzz",
+    "es_MX",
+    "es--ES",
+    "es-",
+    " es ",
+    "es,en",
+    "not-a-locale!",
+  ])("falls back to Chinese for %j", (language) =>
+    expect(resolveGuiLocale("system", language)).toBe("zh-CN"),
+  );
+
+  it("prioritizes explicit preferences over the system language", () => {
+    expect(resolveGuiLocale("es", "zh-CN")).toBe("es");
+    expect(resolveGuiLocale("zh-CN", "es-MX")).toBe("zh-CN");
+    expect(resolveGuiLocale("es", "invalid_locale")).toBe("es");
+  });
+});
+
+describe("GUI messages", () => {
+  it.each(messageKeys)("provides Chinese and Spanish text for %s", (key) => {
+    expect(translate("zh-CN", key).length).toBeGreaterThan(0);
+    expect(translate("es", key).length).toBeGreaterThan(0);
+    expect(translate("es", key)).not.toBe(translate("zh-CN", key));
+  });
+
+  it("provides stable settings and language names", () => {
+    expect(translate("zh-CN", "settings")).toBe("设置");
+    expect(translate("es", "settings")).toBe("Configuración");
+    expect(translate("zh-CN", "nativeErrorTitle")).toBe("MemHub 无法启动");
+    expect(translate("es", "nativeErrorTitle")).toBe(
+      "MemHub no pudo iniciarse",
+    );
+    expect(translate("es", "languageSpanish")).toBe("Español");
+  });
+
+  it("falls back to Chinese with a partial Spanish catalog and interpolates plain text once", async () => {
+    vi.resetModules();
+    vi.doMock("./gui-i18n-messages.js", () => ({
+      chineseMessages: { settings: "中文 {name} {count} {missing} {toString}" },
+      spanishMessages: {},
+    }));
+    try {
+      const { translate: partialTranslate } = await import("./gui-i18n.js");
+      expect(partialTranslate("es", "settings")).toBe(
+        "中文 {name} {count} {missing} {toString}",
+      );
+      expect(
+        partialTranslate("es", "settings", {
+          name: "<img src=x onerror=alert(1)>$&{count}",
+          count: 2,
+        }),
+      ).toBe(
+        "中文 <img src=x onerror=alert(1)>$&{count} 2 {missing} {toString}",
+      );
+      expect(
+        partialTranslate("zh-CN", "settings", { name: "", count: 0 }),
+      ).toBe("中文  0 {missing} {toString}");
+    } finally {
+      vi.doUnmock("./gui-i18n-messages.js");
+      vi.resetModules();
+    }
+  });
+});

memhub/packages/contracts/src/gui-i18n.ts

@@ -0,0 +1,70 @@
+import { chineseMessages, spanishMessages } from "./gui-i18n-messages.js";
+
+export type LanguagePreference = "system" | "zh-CN" | "es";
+export type GuiLocale = "zh-CN" | "es";
+export type MessageKey = keyof typeof chineseMessages;
+
+export interface LanguageSnapshot {
+  preference: LanguagePreference;
+  locale: GuiLocale;
+  revision: number;
+}
+
+/** Check the exact preference values accepted across GUI process boundaries. */
+export function isLanguagePreference(
+  value: unknown,
+): value is LanguagePreference {
+  return value === "system" || value === "zh-CN" || value === "es";
+}
+
+/** Validate a resolved language snapshot and its nonnegative safe revision. */
+export function isLanguageSnapshot(value: unknown): value is LanguageSnapshot {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return false;
+  const snapshot = value as Record<string, unknown>;
+  return (
+    isLanguagePreference(snapshot.preference) &&
+    (snapshot.locale === "zh-CN" || snapshot.locale === "es") &&
+    (snapshot.preference === "system" ||
+      snapshot.preference === snapshot.locale) &&
+    typeof snapshot.revision === "number" &&
+    Number.isSafeInteger(snapshot.revision) &&
+    snapshot.revision >= 0
+  );
+}
+
+/** Resolve an explicitly supplied primary system language without reading global state. */
+export function resolveGuiLocale(
+  preference: LanguagePreference,
+  systemLanguage?: string,
+): GuiLocale {
+  if (preference !== "system") return preference;
+  if (!systemLanguage) return "zh-CN";
+  try {
+    const [canonicalLanguage] = Intl.getCanonicalLocales(systemLanguage);
+    return canonicalLanguage?.split("-")[0] === "es" ? "es" : "zh-CN";
+  } catch {
+    return "zh-CN";
+  }
+}
+
+/**
+ * Return plain text, falling back to Chinese for untranslated Spanish messages.
+ * Replace own {name} parameters once; missing parameters remain unchanged.
+ * This is not HTML: consumers must render the result as text, never innerHTML.
+ */
+export function translate(
+  locale: GuiLocale,
+  key: MessageKey,
+  params?: Record<string, string | number>,
+): string {
+  const message =
+    (locale === "es" ? spanishMessages[key] : undefined) ??
+    chineseMessages[key];
+  if (!params) return message;
+  return message.replace(
+    /\{([A-Za-z_][A-Za-z0-9_]*)\}/g,
+    (placeholder, name: string) =>
+      Object.hasOwn(params, name) ? String(params[name]) : placeholder,
+  );
+}