@steerable/agent-shell-web 0.6.53 → 0.6.55

package/src/lib/app-release.ts

@@ -1,3 +1,4 @@
+import { t } from '@/i18n';
 import type { AppReleasePhase, AppReleaseSnapshot } from './electron-bridge';
 
 export interface AppReleaseView {
@@ -20,21 +21,25 @@ export function sidebarUpdateLabel(
   if (!snap.enabled || snap.phase === 'disabled') return null;
   switch (snap.phase) {
     case 'checking':
-      return '检查中';
+      return t('Checking');
     case 'downloading':
-      return typeof snap.percent === 'number' ? `下载 ${Math.round(snap.percent)}%` : '下载中';
+      return typeof snap.percent === 'number'
+        ? t('Downloading {percent}%', { percent: Math.round(snap.percent) })
+        : t('Downloading…');
     case 'ready':
-      return snap.availableVersion ? `升级 ${snap.availableVersion}` : '升级';
+      return snap.availableVersion
+        ? t('Update to {version}', { version: snap.availableVersion })
+        : t('Update');
     case 'installing':
-      return '正在安装';
+      return t('Installing');
     case 'error':
-      return '重试';
+      return t('Retry');
     case 'idle':
-      if (snap.availableVersion) return `发现 ${snap.availableVersion}`;
+      if (snap.availableVersion) return t('{version} available', { version: snap.availableVersion });
       if (snap.message) return snap.message;
-      return confirmedCurrent ? '已是最新' : '检查更新';
+      return confirmedCurrent ? t('Up to date') : t('Check for updates');
     default:
-      return '检查更新';
+      return t('Check for updates');
   }
 }
 
@@ -43,9 +48,9 @@ export function sidebarUpdateTitle(snap: AppReleaseSnapshot): string | undefined
     return snap.message;
   }
   if (snap.phase === 'ready' && snap.availableVersion) {
-    return `重启并安装 ${snap.availableVersion}`;
+    return t('Restart and install {version}', { version: snap.availableVersion });
   }
-  if (snap.phase === 'downloading') return '正在下载更新';
+  if (snap.phase === 'downloading') return t('Downloading update');
   return undefined;
 }
 

package/src/lib/attachments.ts

@@ -9,6 +9,7 @@
  *   - BS/browser：File 没有路径，这里把字节读成 base64 走 HTTP 端点落盘。
  * 返回的落盘路径会重写消息正文里的文件引用与图像附件元数据。
  */
+import { t } from '@/i18n';
 import { getElectronBridge } from './electron-bridge';
 
 export interface AttachmentFile {
@@ -109,7 +110,7 @@ export async function saveChatAttachments(
         kept.push(file);
         return;
       }
-      failures.push({ name: file.name, error: entry?.error || '上传失败', file });
+      failures.push({ name: file.name, error: entry?.error || t('Upload failed'), file });
     });
     return { files: kept, failures };
   } catch (err) {
@@ -123,13 +124,21 @@ export async function saveChatAttachments(
   }
 }
 
-/** 把失败项拼成一条给用户看的中文提示（供各提交入口复用）。 */
+/** 把失败项拼成一条给用户看的提示（供各提交入口复用）。 */
 export function formatAttachmentFailures(failures: AttachmentSaveFailure[]): string {
   if (failures.length === 0) return '';
-  const detail = failures.map((f) => `${f.name}（${f.error}）`).join('；');
+  const detail = failures
+    .map((f) => t('{name} ({error})', { name: f.name, error: f.error }))
+    .join(t('; '));
   return failures.length === 1
-    ? `文件「${failures[0].name}」未能上传，本条消息未包含它：${failures[0].error}`
-    : `${failures.length} 个文件未能上传，本条消息未包含它们：${detail}`;
+    ? t('File "{name}" failed to upload and is not included in this message: {error}', {
+        name: failures[0].name,
+        error: failures[0].error,
+      })
+    : t('{count} files failed to upload and are not included in this message: {detail}', {
+        count: failures.length,
+        detail,
+      });
 }
 
 /**
@@ -142,8 +151,8 @@ export function appendAttachmentRefs(rawText: string, files: AttachmentFile[]):
   if (files.length === 0) return rawText;
   const refs = files.map((f) => `- \`${f.path}\``).join('\n');
   return rawText
-    ? `${rawText}\n\n---\n关联文件:\n${refs}`
-    : `关联文件:\n${refs}`;
+    ? `${rawText}\n\n---\n${t('Related files:')}\n${refs}`
+    : `${t('Related files:')}\n${refs}`;
 }
 
 /**

package/src/lib/browser-dev-electron-mock.ts

@@ -97,33 +97,33 @@ function createInitialState(): BrowserMockState {
     {
       id: 'coach',
       slug: 'coach',
-      name: '行动教练',
+      name: 'Action coach',
       icon: null,
       color: '#2563eb',
-      description: '把目标拆成可执行计划，适合调试标准聊天路径。',
-      rolePrompt: '你是一个行动教练。',
+      description: 'Breaks a goal into an executable plan. Useful for debugging the standard chat path.',
+      rolePrompt: 'You are an action coach.',
       isBuiltin: true,
       sortOrder: 1,
     },
     {
       id: 'tool-demo',
       slug: 'tool-demo',
-      name: '工具演示专家',
+      name: 'Tool demo',
       icon: null,
       color: '#7c3aed',
-      description: '模拟本地工具调用和执行摘要，适合调试工具卡片。',
-      rolePrompt: '你是工具演示智能体。',
+      description: 'Simulates local tool calls and execution summaries. Useful for debugging tool cards.',
+      rolePrompt: 'You are the tool-demo agent.',
       isBuiltin: true,
       sortOrder: 2,
     },
     {
       id: 'writer',
       slug: 'writer',
-      name: '文案顾问',
+      name: 'Writing advisor',
       icon: null,
       color: '#16a34a',
-      description: '偏长文本回复样例，适合调试 markdown 与滚动。',
-      rolePrompt: '你是一个文案顾问。',
+      description: 'Longer text replies, for debugging markdown and scrolling.',
+      rolePrompt: 'You are a writing advisor.',
       isBuiltin: true,
       sortOrder: 3,
     },
@@ -132,14 +132,14 @@ function createInitialState(): BrowserMockState {
   const chats = [
     createChatRecord({
       id: 'chat-browser-demo',
-      title: '浏览器 UI 调试样例',
+      title: 'Browser UI debug sample',
       agentId: 'coach',
       minutesAgo: 8,
       isPinned: true,
     }),
     createChatRecord({
       id: 'chat-tool-demo',
-      title: '工具调用卡片预览',
+      title: 'Tool-call card preview',
       agentId: 'tool-demo',
       minutesAgo: 64,
     }),
@@ -155,14 +155,14 @@ function createInitialState(): BrowserMockState {
           chatId: 'chat-browser-demo',
           role: 'assistant',
           content:
-            '可以在这里调试普通浏览器里的聊天 UI。这个回复来自 dev mock bridge，不依赖 Electron IPC。',
+            'You can debug the chat UI in a normal browser here. This reply comes from the dev mock bridge and does not use Electron IPC.',
           minutesAgo: 7,
         }),
         createMessage({
           id: 'msg-demo-user-1',
           chatId: 'chat-browser-demo',
           role: 'user',
-          content: '我想在浏览器里调试聊天界面。',
+          content: 'I want to debug the chat UI in the browser.',
           minutesAgo: 8,
         }),
       ],
@@ -171,7 +171,7 @@ function createInitialState(): BrowserMockState {
           id: 'msg-tool-assistant-1',
           chatId: 'chat-tool-demo',
           role: 'assistant',
-          content: '我已经模拟执行了一次本地命令，并把结果展示在工具卡片里。',
+          content: 'I simulated a local command and put the result in a tool card.',
           minutesAgo: 63,
           messageMetadata: JSON.stringify({
             executedActions: [
@@ -187,7 +187,7 @@ function createInitialState(): BrowserMockState {
           id: 'msg-tool-user-1',
           chatId: 'chat-tool-demo',
           role: 'user',
-          content: '帮我看一下最近的工具调用记录。',
+          content: 'Show me the recent tool-call records.',
           minutesAgo: 64,
         }),
       ],
@@ -201,9 +201,9 @@ function createInitialState(): BrowserMockState {
       maxTotalTokens: 60_000,
     },
     skills: [
-      { name: 'tool-demo', description: '模拟查询与回放工具。', builtin: true },
-      { name: 'local-exec', description: '模拟本地命令执行。', builtin: true },
-      { name: 'anti-deferred', description: '模拟防拖延执行策略。', builtin: true },
+      { name: 'tool-demo', description: 'Simulates query and replay tools.', builtin: true },
+      { name: 'local-exec', description: 'Simulates local command execution.', builtin: true },
+      { name: 'anti-deferred', description: 'Simulates the anti-deferral execution policy.', builtin: true },
     ],
     activeStreams: new Map(),
     source: 'fallback',
@@ -235,8 +235,8 @@ function createStateFromFixture(fixture: BrowserDevFixture): BrowserMockState |
       Array.isArray(fixture.skills) && fixture.skills.length > 0
         ? fixture.skills
         : [
-            { name: 'tool-demo', description: '查询与回放工具。', builtin: true },
-            { name: 'local-exec', description: '本地命令执行。', builtin: true },
+            { name: 'tool-demo', description: 'Query and replay tools.', builtin: true },
+            { name: 'local-exec', description: 'Local command execution.', builtin: true },
           ],
     activeStreams: new Map(),
     source: 'fixture',
@@ -318,7 +318,7 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
     const agent: LocalChatAgent = {
       id,
       slug: null,
-      name: (body.name || '新助手').trim() || '新助手',
+      name: (body.name || 'New assistant').trim() || 'New assistant',
       icon: null,
       color: body.color ?? '#4f46e5',
       description: body.description ?? null,
@@ -392,10 +392,10 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
   if (method === 'GET' && cleanPath === '/api/v2/chat-agents/tools') {
     return {
       tools: [
-        { name: 'local_exec_shell', description: '执行本地 shell 命令。', category: 'local' },
-        { name: 'local_read_file', description: '读取本地文本文件。', category: 'local' },
-        { name: 'local_write_file', description: '写入本地文件。', category: 'local' },
-        { name: 'web_search', description: '联网搜索。', category: 'local' },
+        { name: 'local_exec_shell', description: 'Run a local shell command.', category: 'local' },
+        { name: 'local_read_file', description: 'Read a local text file.', category: 'local' },
+        { name: 'local_write_file', description: 'Write a local file.', category: 'local' },
+        { name: 'web_search', description: 'Search the web.', category: 'local' },
       ],
     } as T;
   }
@@ -404,7 +404,7 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
     const body = input.body as { path?: string } | undefined;
     const name = body?.path?.split(/[\\/]/).filter(Boolean).pop() || 'browser-skill';
     if (!state.skills.some((skill) => skill.name === name)) {
-      state.skills.push({ name, description: '浏览器预览中导入的 mock skill。' });
+      state.skills.push({ name, description: 'Mock skill imported in the browser preview.' });
     }
     return { success: true, name } as T;
   }
@@ -444,7 +444,7 @@ async function request<T>(input: LocalBackendRequestInput): Promise<T> {
     const chatId = `chat-browser-${Date.now()}`;
     const chat = createChatRecord({
       id: chatId,
-      title: '新会话',
+      title: 'New chat',
       agentId,
       minutesAgo: 0,
     });
@@ -515,7 +515,7 @@ async function startStream(
   }
 
   const body = input.body as { message?: string } | undefined;
-  const message = body?.message?.trim() || '请演示一下浏览器 mock 回复。';
+  const message = body?.message?.trim() || 'Please demo a browser mock reply.';
   const streamId = `browser-stream-${Date.now()}`;
   state.activeStreams.set(streamId, []);
 
@@ -530,10 +530,10 @@ async function startStream(
   state.messagesByChatId[chatId] = [...(state.messagesByChatId[chatId] ?? []), userMessage];
 
   const reply =
-    `这是浏览器 dev mock 的流式回复。你刚才输入的是：「${message}」。` +
-    ' 这里可以调试消息气泡、滚动、停止按钮、工具执行卡片和后续状态。';
+    `This is a streaming reply from the browser dev mock. You wrote: "${message}".` +
+    ' Use it to debug message bubbles, scrolling, the stop button, tool cards, and later status.';
   const chunks = reply.match(/.{1,8}/g) ?? [reply];
-  const reasoning = '先调用一次 mock 工具，再把回复按调用流程交错显示。';
+  const reasoning = 'Call one mock tool, then interleave the reply with that call.';
   const mockAction = {
     id: 'browser-mock-1',
     tool: 'browser_mock',
@@ -580,7 +580,7 @@ async function startStream(
           { type: 'text', content: reply },
         ],
         durationMs: 1_200,
-        suggestedReplies: ['继续完善这份结果', '换一种呈现方式', '告诉我下一步怎么做'],
+        suggestedReplies: ['Keep improving this result', 'Try another presentation', 'Tell me the next step'],
       }),
     });
     assistantMessage.createdAt = new Date().toISOString();
@@ -593,7 +593,7 @@ async function startStream(
     pushSse(onEvent, '[DONE]');
     onEvent({ type: 'end', status: 200 });
     state.activeStreams.delete(streamId);
-    const suggestions = ['继续完善这份结果', '换一种呈现方式', '告诉我下一步怎么做'];
+    const suggestions = ['Keep improving this result', 'Try another presentation', 'Tell me the next step'];
     for (const listener of suggestedReplyListeners) {
       listener({ chatId, messageId: assistantMessage.id, suggestions });
     }
@@ -625,7 +625,7 @@ export function installBrowserDevElectronMock() {
       // 浏览器 dev 模式没有 Electron capturePage/clipboard，如实返回失败。
       captureScreenshot: async () => ({
         success: false as const,
-        error: '浏览器开发模式不支持窗口截图（需要 Electron 运行时）',
+        error: 'Browser dev mode cannot capture a window screenshot (it needs the Electron runtime).',
       }),
     },
     localBackend: {

package/src/lib/chat-title.ts

@@ -5,8 +5,9 @@
  * automation.py:_AUTOMATION_TITLE_PREFIX), so the same parser works for both.
  */
 
-export const AUTOMATION_TITLE_PREFIX = '[自动化] ';
-const BARE_BRACKET_PREFIX = '[自动化]';
+// 与后端 automation.py 的标题前缀是同一条持久化约定，不能按界面语言改写。
+export const AUTOMATION_TITLE_PREFIX = '[自动化] '; // i18n:allow
+const BARE_BRACKET_PREFIX = '[自动化]'; // i18n:allow
 
 export interface ParsedChatTitle {
   displayTitle: string;

package/src/lib/chat-transport.ts

@@ -53,6 +53,7 @@ import {
 } from '@steerable/agent-ui/state';
 import type { SSEEvent } from '@steerable/agent-protocol';
 import { getElectronBridge } from './electron-bridge';
+import { t } from '@/i18n';
 import {
   appendDelta,
   freezeReasoningDurations,
@@ -372,7 +373,7 @@ export async function regenerateChatMessage(
         if (frame.event !== 'error' || !frame.data) return;
         const parsed = parseSSEData(frame.data);
         const message = (parsed as { message?: unknown } | null)?.message;
-        refusal = typeof message === 'string' && message ? message : '重新生成失败';
+        refusal = typeof message === 'string' && message ? message : t('Regeneration failed');
       },
     });
     bridge.localBackend
@@ -388,7 +389,10 @@ export async function regenerateChatMessage(
             parser.end();
             settle(
               payload.status >= 400
-                ? new Error(refusal ?? `重新生成失败（HTTP ${payload.status}）`)
+                ? new Error(
+                    refusal ??
+                      t('Regeneration failed (HTTP {status})', { status: payload.status }),
+                  )
                 : undefined,
             );
           } else if (payload.type === 'error') settle(new Error(payload.error));

package/src/lib/date-groups.ts

@@ -1,34 +1,42 @@
 /**
  * Date-group helpers used by AgentSidebar to label chat groups
- * ("今天" / "昨天" / "N天前" / "M月D日" / "YYYY年M月D日"). Lifted verbatim
- * from `deeppath/apps/web/src/app/agent/AgentSidebar.tsx` so the visual
+ * ("Today" / "Yesterday" / "N days ago" / "M/D" / "M/D/YYYY"). Lifted from
+ * `deeppath/apps/web/src/app/agent/AgentSidebar.tsx` so the visual
  * grouping stays in lockstep.
  *
  * priority is used for ordering groups: smaller = newer = listed first.
+ * 标签走 t()，排序只看日期，不解析标签文本。
  */
+import { t } from '@/i18n';
 
-export function getDateGroupLabel(date: Date): string {
+function dayBuckets(date: Date): { diffDays: number; target: Date; today: Date } {
   const today = new Date();
   today.setHours(0, 0, 0, 0);
   const target = new Date(date);
   target.setHours(0, 0, 0, 0);
   const diffDays =
     (today.getTime() - target.getTime()) / (1000 * 60 * 60 * 24);
-  if (diffDays === 0) return '今天';
-  if (diffDays === 1) return '昨天';
-  if (diffDays < 4) return `${Math.floor(diffDays)}天前`;
-  const m = target.getMonth() + 1;
-  const d = target.getDate();
+  return { diffDays, target, today };
+}
+
+export function getDateGroupLabel(date: Date): string {
+  const { diffDays, target, today } = dayBuckets(date);
+  if (diffDays === 0) return t('Today');
+  if (diffDays === 1) return t('Yesterday');
+  if (diffDays < 4) return t('{count} days ago', { count: Math.floor(diffDays) });
+  const month = target.getMonth() + 1;
+  const day = target.getDate();
   if (target.getFullYear() !== today.getFullYear()) {
-    return `${target.getFullYear()}年${m}月${d}日`;
+    return t('{month}/{day}/{year}', { year: target.getFullYear(), month, day });
   }
-  return `${m}月${d}日`;
+  return t('{month}/{day}', { month, day });
 }
 
-export function getDateGroupPriority(label: string): number {
-  if (label === '今天') return 1;
-  if (label === '昨天') return 2;
-  if (label.endsWith('天前')) return 2 + parseInt(label, 10);
-  if (label.includes('年')) return 1000;
+export function getDateGroupPriority(date: Date): number {
+  const { diffDays, target, today } = dayBuckets(date);
+  if (diffDays === 0) return 1;
+  if (diffDays === 1) return 2;
+  if (diffDays < 4) return 2 + Math.floor(diffDays);
+  if (target.getFullYear() !== today.getFullYear()) return 1000;
   return 100;
 }

package/src/lib/electron-bridge.ts

@@ -1,11 +1,8 @@
 /**
  * Host-neutral bridge used by the renderer in desktop and browser modes.
  *
- * This file MUST stay a subset / aligned shape with `ElectronAPI` in
- * `../../../src/preload.ts`. We intentionally don't TypeScript-reference that
- * file across workspaces — it would drag the whole main-process source tree
- * into the renderer's compile graph. Treat this as a contract surface and
- * extend it lazily as apps/web starts using new bridge methods.
+ * Implementations are `tauri-bridge.ts` (desktop) and `http-bridge.ts`
+ * (browser server); both must satisfy {@link HostBridge}.
  *
  * `window.electron` and `getElectronBridge()` remain compatibility aliases for
  * existing products. New integrations should use `window.steerableHost` and
@@ -184,6 +181,8 @@ export interface HostBridge {
    * to clear the listener (otherwise multiple AgentSidebar mounts
    * during HMR would queue up duplicate callbacks).
    */
+  /** 把当前界面语言告诉主进程，以便重建应用菜单。浏览器预览里没有。 */
+  setLocale?: (locale: string) => void;
   onMenuNewChat?: (callback: () => void) => void;
   offMenuNewChat?: () => void;
   /**

package/src/lib/http-bridge.ts

@@ -23,6 +23,7 @@ import type {
   TerminalSession,
   TerminalSpawnOptions,
 } from './electron-bridge';
+import { t } from '@/i18n';
 
 interface BsBootstrap {
   platform: NodeJS.Platform;
@@ -225,7 +226,9 @@ export function createHttpBridge(): ElectronBridge {
       },
       captureScreenshot: async () => ({
         success: false as const,
-        error: '浏览器模式不支持窗口截图，请用系统截图工具。',
+        error: t(
+          'Browser mode cannot capture window screenshots. Use your system screenshot tool.',
+        ),
       }),
     },
 

package/src/lib/portable.ts

@@ -3,6 +3,7 @@
  * 界面档位和命令权限存在 localStorage，由这里并进配置包；其余段走本地后端。
  */
 
+import { t } from '@/i18n';
 import { getElectronBridge } from '@/lib/electron-bridge';
 import { listChats } from '@/lib/local-api';
 import { persistExecPolicy, readStoredExecPolicy, type ExecPolicy } from '@/lib/exec-policy';
@@ -69,9 +70,9 @@ export interface PortableChatImportResult {
 const CLIENT_SECTION_IDS = ['appearance', 'execPolicy'] as const;
 
 export function portableErrorMessage(err: unknown): string {
-  if (!(err instanceof Error)) return '操作失败';
+  if (!(err instanceof Error)) return t('Operation failed');
   const message = err.message.trim();
-  if (!message) return '操作失败';
+  if (!message) return t('Operation failed');
   try {
     const parsed = JSON.parse(message) as { detail?: unknown; error?: unknown };
     if (typeof parsed.detail === 'string' && parsed.detail.trim()) return parsed.detail;
@@ -86,13 +87,13 @@ export function parsePortableText(text: string): { ok: true; value: unknown } |
   try {
     return { ok: true, value: JSON.parse(text) as unknown };
   } catch {
-    return { ok: false, error: '文件不是 JSON' };
+    return { ok: false, error: t('The file is not JSON') };
   }
 }
 
 export function safeDownloadName(stem: string, suffix: string): string {
   const cleaned = stem.replace(/[\\/:*?"<>|]/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 40);
-  return `${cleaned || '导出'}-${suffix}.json`;
+  return `${cleaned || t('Export')}-${suffix}.json`;
 }
 
 export function readLocalSections(): { appearance: { thinkingDisplay: ThinkingDisplayMode }; execPolicy: { policy: ExecPolicy } } {
@@ -139,7 +140,7 @@ export function isClientSection(id: string): boolean {
 
 async function request<T>(method: string, path: string, body?: unknown): Promise<T> {
   const bridge = getElectronBridge();
-  if (!bridge) throw new Error('当前环境没有本地后端');
+  if (!bridge) throw new Error(t('No local backend in this environment'));
   return bridge.localBackend.request<T>(body === undefined ? { method, path } : { method, path, body });
 }
 
@@ -159,7 +160,7 @@ export async function listPortableChats(): Promise<Array<{ id: string; title: st
   for (;;) {
     const res = await listChats({ page, limit: 100 });
     for (const chat of res.chats) {
-      rows.push({ id: chat.id, title: chat.title.trim() || '未命名对话' });
+      rows.push({ id: chat.id, title: chat.title.trim() || t('Untitled chat') });
     }
     if (!res.pagination.hasMore || page >= 50) break;
     page += 1;
@@ -190,7 +191,7 @@ export async function saveJsonFile(filename: string, data: unknown): Promise<str
   const content = `${JSON.stringify(data, null, 2)}\n`;
   const save = getElectronBridge()?.local?.saveTextFile;
   if (save) {
-    const saved = await save({ title: '导出', defaultPath: filename, content });
+    const saved = await save({ title: t('Export'), defaultPath: filename, content });
     if (saved.canceled || !saved.filePath) return null;
     return saved.filePath;
   }

package/src/lib/show-thinking-content.ts

@@ -19,9 +19,21 @@ export const THINKING_DISPLAY_OPTIONS: ReadonlyArray<{
   label: string;
   hint: string;
 }> = [
-  { mode: 'hidden', label: '隐藏', hint: '不展示思考正文，只保留工作状态行。' },
-  { mode: 'peek', label: '显示5行', hint: '当前轮思考最多露出 5 行，不足不撑开；该轮结束后自动折叠。完整正文请用「完整显示」。' },
-  { mode: 'full', label: '完整显示', hint: '当前轮思考完整展开，该轮结束后自动折叠；工作行结束后仍自动折叠。' },
+  {
+    mode: 'hidden',
+    label: 'Hide',
+    hint: 'Hide the thinking text and keep only the work status line.',
+  },
+  {
+    mode: 'peek',
+    label: 'Show 5 lines',
+    hint: 'Show at most 5 lines of the current turn\'s thinking. Do not stretch the row when there is less, and collapse it when the turn ends. Use "Show all" for the full text.',
+  },
+  {
+    mode: 'full',
+    label: 'Show all',
+    hint: 'Expand the current turn\'s thinking, then collapse it when the turn ends. The work row still collapses when it finishes.',
+  },
 ];
 
 export function isThinkingDisplayMode(value: unknown): value is ThinkingDisplayMode {

package/src/main.tsx

@@ -2,6 +2,7 @@ import { StrictMode, lazy, Suspense, type ReactNode } from 'react';
 import { createRoot, type Root } from 'react-dom/client';
 import { createHashRouter, RouterProvider } from 'react-router-dom';
 import { AppShell } from './AppShell';
+import { I18nProvider, configureI18n, getLocale } from './i18n';
 import { AgentLayout } from './layouts/AgentLayout';
 import { AgentPage } from './pages/AgentPage';
 import { SettingsPage } from './pages/SettingsPage';
@@ -82,7 +83,9 @@ function renderApplication(root: Root): void {
 
   root.render(
     <StrictMode>
-      <RouterProvider router={router} />
+      <I18nProvider>
+        <RouterProvider router={router} />
+      </I18nProvider>
     </StrictMode>,
   );
 }
@@ -97,6 +100,12 @@ export async function bootstrap(): Promise<void> {
 
   // 标题与 favicon 在 bootstrap 时设置——此刻产品入口已完成包注册
   // （品牌 logo 由包经 setBrandLogoUrl 注入，见 brand.ts）。
+  configureI18n({
+    locales: parseLocales(import.meta.env.VITE_LOCALES),
+    defaultLocale: import.meta.env.VITE_DEFAULT_LOCALE || 'en',
+  });
+  document.documentElement.lang = getLocale() === 'zh' ? 'zh-CN' : getLocale();
+  window.electron?.setLocale?.(getLocale());
   document.title = BRAND_NAME;
   document.querySelector<HTMLLinkElement>('link[rel="icon"]')?.setAttribute('href', getBrandLogoUrl());
   installHostPaste();
@@ -117,7 +126,9 @@ export async function bootstrap(): Promise<void> {
     const Gate = gate.Component;
     root.render(
       <StrictMode>
-        <Gate onAuthenticated={onAuthenticated} />
+        <I18nProvider>
+          <Gate onAuthenticated={onAuthenticated} />
+        </I18nProvider>
       </StrictMode>,
     );
     return;
@@ -125,3 +136,15 @@ export async function bootstrap(): Promise<void> {
 
   renderApplication(root);
 }
+
+function parseLocales(raw: string | undefined): string[] {
+  if (!raw) return ['en'];
+  try {
+    const parsed = JSON.parse(raw) as unknown;
+    if (!Array.isArray(parsed)) return ['en'];
+    const locales = parsed.filter((item): item is string => typeof item === 'string' && item.length > 0);
+    return locales.length > 0 ? locales : ['en'];
+  } catch {
+    return ['en'];
+  }
+}