feat(i18n): localize tool display names in TUI and web-shell badges

packages/cli/src/i18n/index.test.ts

@@ -153,3 +153,35 @@ describe('supported language resolution', () => {
     expect(resolveSupportedLanguage('zh-HK')).toBe('zh');
   });
 });
+
+describe('localizeToolDisplayName', () => {
+  beforeEach(() => {
+    vi.resetModules();
+  });
+
+  it('translates tool badges without colliding with generic UI strings', async () => {
+    const { setLanguageAsync, localizeToolDisplayName, t } = await import(
+      './index.js'
+    );
+    await setLanguageAsync('zh');
+
+    // The namespaced `toolDisplayName.*` key translates the badge...
+    expect(localizeToolDisplayName('Shell')).toBe('终端');
+    expect(localizeToolDisplayName('TodoWrite')).toBe('任务清单');
+    expect(localizeToolDisplayName('Lsp')).toBe('语言服务');
+    // ...while a same-spelled standalone UI string keeps its own value.
+    expect(t('Shell')).toBe('Shell');
+  });
+
+  it('falls back to the English display name for untranslated tools', async () => {
+    const { setLanguageAsync, localizeToolDisplayName } = await import(
+      './index.js'
+    );
+    await setLanguageAsync('en');
+
+    expect(localizeToolDisplayName('TodoWrite')).toBe('TodoWrite');
+    expect(localizeToolDisplayName('Shell')).toBe('Shell');
+    // An unknown tool name passes through unchanged.
+    expect(localizeToolDisplayName('MysteryTool')).toBe('MysteryTool');
+  });
+});

packages/cli/src/i18n/index.ts

@@ -272,6 +272,19 @@ export function t(key: string, params?: Record<string, string>): string {
   return interpolate(translation, params);
 }
 
+/**
+ * Locale-aware tool display name for chat-stream badges. Looks up the
+ * `toolDisplayName.<English display name>` key so tool labels never collide
+ * with same-spelled generic UI strings (e.g. a standalone "Shell" label that
+ * intentionally stays English). Falls back to the English display name when the
+ * active locale has no entry, so English and untranslated tools are unaffected.
+ */
+export function localizeToolDisplayName(displayName: string): string {
+  const key = `toolDisplayName.${displayName}`;
+  const translated = t(key);
+  return translated === key ? displayName : translated;
+}
+
 /**
  * Get a translation that is an array of strings.
  * @param key The translation key

packages/cli/src/i18n/locales/en.js

@@ -8,6 +8,50 @@
 // The key serves as both the translation key and the default English text
 
 export default {
+  // ============================================================================
+  // Tool display names (chat-stream badge labels)
+  // ----------------------------------------------------------------------------
+  // Namespaced `toolDisplayName.<English display name>` keys (from core
+  // `ToolDisplayNames`). Per this file's key-is-default-text convention each
+  // English entry maps to itself; `localizeToolDisplayName` detects that
+  // self-mapping and returns the bare display name. Localized values live in
+  // zh.js / zh-TW.js; other locales fall back to the English display name.
+  // ============================================================================
+  'toolDisplayName.Edit': 'toolDisplayName.Edit',
+  'toolDisplayName.WriteFile': 'toolDisplayName.WriteFile',
+  'toolDisplayName.ReadFile': 'toolDisplayName.ReadFile',
+  'toolDisplayName.Grep': 'toolDisplayName.Grep',
+  'toolDisplayName.Glob': 'toolDisplayName.Glob',
+  'toolDisplayName.Shell': 'toolDisplayName.Shell',
+  'toolDisplayName.Shell Command': 'toolDisplayName.Shell Command',
+  'toolDisplayName.TodoWrite': 'toolDisplayName.TodoWrite',
+  'toolDisplayName.SaveMemory': 'toolDisplayName.SaveMemory',
+  'toolDisplayName.Agent': 'toolDisplayName.Agent',
+  'toolDisplayName.Skill': 'toolDisplayName.Skill',
+  'toolDisplayName.EnterPlanMode': 'toolDisplayName.EnterPlanMode',
+  'toolDisplayName.ExitPlanMode': 'toolDisplayName.ExitPlanMode',
+  'toolDisplayName.WebFetch': 'toolDisplayName.WebFetch',
+  'toolDisplayName.WebSearch': 'toolDisplayName.WebSearch',
+  'toolDisplayName.ListFiles': 'toolDisplayName.ListFiles',
+  'toolDisplayName.Lsp': 'toolDisplayName.Lsp',
+  'toolDisplayName.AskUserQuestion': 'toolDisplayName.AskUserQuestion',
+  'toolDisplayName.CronCreate': 'toolDisplayName.CronCreate',
+  'toolDisplayName.CronList': 'toolDisplayName.CronList',
+  'toolDisplayName.CronDelete': 'toolDisplayName.CronDelete',
+  'toolDisplayName.TaskCreate': 'toolDisplayName.TaskCreate',
+  'toolDisplayName.TaskUpdate': 'toolDisplayName.TaskUpdate',
+  'toolDisplayName.TaskList': 'toolDisplayName.TaskList',
+  'toolDisplayName.TaskStop': 'toolDisplayName.TaskStop',
+  'toolDisplayName.TeamCreate': 'toolDisplayName.TeamCreate',
+  'toolDisplayName.TeamDelete': 'toolDisplayName.TeamDelete',
+  'toolDisplayName.SendMessage': 'toolDisplayName.SendMessage',
+  'toolDisplayName.StructuredOutput': 'toolDisplayName.StructuredOutput',
+  'toolDisplayName.Monitor': 'toolDisplayName.Monitor',
+  'toolDisplayName.NotebookEdit': 'toolDisplayName.NotebookEdit',
+  'toolDisplayName.ToolSearch': 'toolDisplayName.ToolSearch',
+  'toolDisplayName.EnterWorktree': 'toolDisplayName.EnterWorktree',
+  'toolDisplayName.ExitWorktree': 'toolDisplayName.ExitWorktree',
+  'toolDisplayName.Workflow': 'toolDisplayName.Workflow',
   // ============================================================================
   // Help / UI Components
   // ============================================================================

packages/cli/src/i18n/locales/zh-TW.js

@@ -9,6 +9,49 @@
 // then extensively hand-corrected for Taiwan vocabulary conventions.
 // This file is the authoritative source — do not overwrite with auto-generated output.
 export default {
+  // ============================================================================
+  // Tool display names (chat-stream badge labels)
+  // ----------------------------------------------------------------------------
+  // Keyed by `toolDisplayName.<English display name>` (from core
+  // `ToolDisplayNames`); a missing key falls back to the English display name
+  // via `localizeToolDisplayName`. A product name (e.g. `Notebook`) is kept
+  // verbatim inside an otherwise-translated label.
+  // ============================================================================
+  'toolDisplayName.Edit': '編輯',
+  'toolDisplayName.WriteFile': '寫入檔案',
+  'toolDisplayName.ReadFile': '讀取檔案',
+  'toolDisplayName.Grep': '搜尋',
+  'toolDisplayName.Glob': '比對檔案',
+  'toolDisplayName.Shell': '終端',
+  'toolDisplayName.Shell Command': '終端指令',
+  'toolDisplayName.TodoWrite': '任務清單',
+  'toolDisplayName.SaveMemory': '儲存記憶',
+  'toolDisplayName.Agent': '智慧體',
+  'toolDisplayName.Skill': '技能',
+  'toolDisplayName.EnterPlanMode': '進入計畫模式',
+  'toolDisplayName.ExitPlanMode': '退出計畫模式',
+  'toolDisplayName.WebFetch': '網路擷取',
+  'toolDisplayName.WebSearch': '網路搜尋',
+  'toolDisplayName.ListFiles': '列出檔案',
+  'toolDisplayName.Lsp': '語言服務',
+  'toolDisplayName.AskUserQuestion': '詢問使用者',
+  'toolDisplayName.CronCreate': '建立定時任務',
+  'toolDisplayName.CronList': '定時任務清單',
+  'toolDisplayName.CronDelete': '刪除定時任務',
+  'toolDisplayName.TaskCreate': '建立任務',
+  'toolDisplayName.TaskUpdate': '更新任務',
+  'toolDisplayName.TaskList': '任務列表',
+  'toolDisplayName.TaskStop': '停止任務',
+  'toolDisplayName.TeamCreate': '建立團隊',
+  'toolDisplayName.TeamDelete': '刪除團隊',
+  'toolDisplayName.SendMessage': '傳送訊息',
+  'toolDisplayName.StructuredOutput': '結構化輸出',
+  'toolDisplayName.Monitor': '監控',
+  'toolDisplayName.NotebookEdit': '編輯 Notebook',
+  'toolDisplayName.ToolSearch': '工具搜尋',
+  'toolDisplayName.EnterWorktree': '進入工作樹',
+  'toolDisplayName.ExitWorktree': '退出工作樹',
+  'toolDisplayName.Workflow': '工作流程',
   '↑ to manage attachments': '↑ 管理附件',
   '← → select, Delete to remove, ↓ to exit': '← → 選擇，Delete 刪除，↓ 退出',
   'Attachments: ': '附件：',

packages/cli/src/i18n/locales/zh.js

@@ -7,6 +7,50 @@
 // Chinese translations for Qwen Code CLI
 
 export default {
+  // ============================================================================
+  // Tool display names (chat-stream badge labels)
+  // ----------------------------------------------------------------------------
+  // Keyed by `toolDisplayName.<English display name>` (from core
+  // `ToolDisplayNames`). The namespace prevents collisions with same-spelled
+  // generic UI strings (e.g. a standalone "Shell"). A missing key falls back to
+  // the English display name via `localizeToolDisplayName`. A product name is
+  // kept verbatim inside an otherwise-translated label (e.g. `Notebook`).
+  // ============================================================================
+  'toolDisplayName.Edit': '编辑',
+  'toolDisplayName.WriteFile': '写入文件',
+  'toolDisplayName.ReadFile': '读取文件',
+  'toolDisplayName.Grep': '搜索',
+  'toolDisplayName.Glob': '匹配文件',
+  'toolDisplayName.Shell': '终端',
+  'toolDisplayName.Shell Command': '终端命令',
+  'toolDisplayName.TodoWrite': '任务清单',
+  'toolDisplayName.SaveMemory': '保存记忆',
+  'toolDisplayName.Agent': '智能体',
+  'toolDisplayName.Skill': '技能',
+  'toolDisplayName.EnterPlanMode': '进入计划模式',
+  'toolDisplayName.ExitPlanMode': '退出计划模式',
+  'toolDisplayName.WebFetch': '网络抓取',
+  'toolDisplayName.WebSearch': '网络搜索',
+  'toolDisplayName.ListFiles': '列出文件',
+  'toolDisplayName.Lsp': '语言服务',
+  'toolDisplayName.AskUserQuestion': '询问用户',
+  'toolDisplayName.CronCreate': '创建定时任务',
+  'toolDisplayName.CronList': '定时任务列表',
+  'toolDisplayName.CronDelete': '删除定时任务',
+  'toolDisplayName.TaskCreate': '创建任务',
+  'toolDisplayName.TaskUpdate': '更新任务',
+  'toolDisplayName.TaskList': '任务列表',
+  'toolDisplayName.TaskStop': '停止任务',
+  'toolDisplayName.TeamCreate': '创建团队',
+  'toolDisplayName.TeamDelete': '删除团队',
+  'toolDisplayName.SendMessage': '发送消息',
+  'toolDisplayName.StructuredOutput': '结构化输出',
+  'toolDisplayName.Monitor': '监控',
+  'toolDisplayName.NotebookEdit': '编辑 Notebook',
+  'toolDisplayName.ToolSearch': '工具搜索',
+  'toolDisplayName.EnterWorktree': '进入工作树',
+  'toolDisplayName.ExitWorktree': '退出工作树',
+  'toolDisplayName.Workflow': '工作流',
   // ============================================================================
   // Help / UI Components
   // ============================================================================

packages/cli/src/ui/components/background-view/BackgroundTasksDialog.tsx

@@ -42,7 +42,7 @@ import {
   type DreamDialogEntry,
   entryId,
 } from '../../hooks/useBackgroundTaskView.js';
-import { t } from '../../../i18n/index.js';
+import { localizeToolDisplayName, t } from '../../../i18n/index.js';
 
 // `DialogEntry['status']` widens the shell status union with the agent-only
 // `paused` state, so dialog handlers can switch on a single combined enum.
@@ -57,7 +57,7 @@ const TOOL_DISPLAY_BY_NAME: Record<string, string> = Object.fromEntries(
 );
 
 function formatActivityLabel(name: string, description: string | undefined) {
-  const display = TOOL_DISPLAY_BY_NAME[name] ?? name;
+  const display = localizeToolDisplayName(TOOL_DISPLAY_BY_NAME[name] ?? name);
   const singleLineDesc = description
     ? description.replace(/\s*\n\s*/g, ' ').trim()
     : '';

packages/cli/src/ui/components/background-view/LiveAgentPanel.tsx

@@ -34,6 +34,7 @@ import {
   ToolDisplayNames,
   ToolNames,
 } from '@qwen-code/qwen-code-core';
+import { localizeToolDisplayName } from '../../../i18n/index.js';
 import {
   useBackgroundTaskViewActions,
   useBackgroundTaskViewState,
@@ -137,7 +138,9 @@ const TOOL_DISPLAY_BY_NAME: Record<string, string> = Object.fromEntries(
 function activityLabel(entry: AgentDialogEntry): string {
   const last = entry.recentActivities?.at(-1);
   if (!last) return '';
-  const display = TOOL_DISPLAY_BY_NAME[last.name] ?? last.name;
+  const display = localizeToolDisplayName(
+    TOOL_DISPLAY_BY_NAME[last.name] ?? last.name,
+  );
   const desc = last.description?.replace(/\s*\n\s*/g, ' ').trim();
   return desc ? `${display} ${desc}` : display;
 }

packages/cli/src/ui/components/messages/CompactToolGroupDisplay.tsx

@@ -11,7 +11,7 @@ import { ToolCallStatus } from '../../types.js';
 import type { AnsiOutputDisplay } from '@qwen-code/qwen-code-core';
 import { SHELL_COMMAND_NAME, SHELL_NAME } from '../../constants.js';
 import { theme } from '../../semantic-colors.js';
-import { t } from '../../../i18n/index.js';
+import { localizeToolDisplayName, t } from '../../../i18n/index.js';
 import { ToolStatusIndicator } from '../shared/ToolStatusIndicator.js';
 import { ToolElapsedTime } from '../shared/ToolElapsedTime.js';
 
@@ -166,7 +166,7 @@ export const CompactToolGroupDisplay: React.FC<
             {compactLabel
               ? renderSummaryHeader(compactLabel, toolCalls.length)
               : renderDefaultHeader(
-                  activeTool.name,
+                  localizeToolDisplayName(activeTool.name),
                   activeToolDescription,
                   toolCalls.length,
                 )}

packages/cli/src/ui/components/messages/InlineParallelAgentsDisplay.tsx

@@ -32,6 +32,7 @@ import { ConfigContext } from '../../contexts/ConfigContext.js';
 import { theme } from '../../semantic-colors.js';
 import { formatDuration, formatTokenCount } from '../../utils/formatters.js';
 import { escapeAnsiCtrlCodes } from '../../utils/textUtils.js';
+import { localizeToolDisplayName } from '../../../i18n/index.js';
 
 interface InlineParallelAgentsDisplayProps {
   toolCalls: readonly IndividualToolCallDisplay[];
@@ -108,7 +109,9 @@ function activityLabel(row: RowData): string {
   // registry's live array.
   const last = row.recentActivity;
   if (!last) return '';
-  const display = TOOL_DISPLAY_BY_NAME[last.name] ?? last.name;
+  const display = localizeToolDisplayName(
+    TOOL_DISPLAY_BY_NAME[last.name] ?? last.name,
+  );
   const desc = last.description?.replace(/\s*\n\s*/g, ' ').trim();
   return desc ? `${display} ${desc}` : display;
 }

packages/cli/src/ui/components/messages/ToolMessage.test.tsx

@@ -930,3 +930,44 @@ describe('<ToolMessage />', () => {
     expect(output).toContain('- Step 2');
   });
 });
+
+describe('<ToolMessage /> localized badge', () => {
+  const localizedProps: ToolMessageProps = {
+    callId: 'tool-i18n',
+    name: 'ReadFile',
+    description: '',
+    resultDisplay: '',
+    status: ToolCallStatus.Success,
+    contentWidth: 80,
+    confirmationDetails: undefined,
+    emphasis: 'medium',
+    config: {} as Config,
+  };
+
+  afterEach(async () => {
+    const { setLanguageAsync } = await import('../../../i18n/index.js');
+    await setLanguageAsync('en');
+  });
+
+  it('shows the localized display name under the zh locale', async () => {
+    const { setLanguageAsync } = await import('../../../i18n/index.js');
+    await setLanguageAsync('zh');
+    const { lastFrame } = renderWithContext(
+      <ToolMessage {...localizedProps} />,
+      StreamingState.Idle,
+    );
+    const output = lastFrame() ?? '';
+    expect(output).toContain('读取文件');
+    expect(output).not.toContain('ReadFile');
+  });
+
+  it('keeps the English display name under the en locale', async () => {
+    const { setLanguageAsync } = await import('../../../i18n/index.js');
+    await setLanguageAsync('en');
+    const { lastFrame } = renderWithContext(
+      <ToolMessage {...localizedProps} />,
+      StreamingState.Idle,
+    );
+    expect(lastFrame() ?? '').toContain('ReadFile');
+  });
+});

packages/cli/src/ui/components/messages/ToolMessage.tsx

@@ -28,6 +28,7 @@ import { ToolConfirmationMessage } from './ToolConfirmationMessage.js';
 import { PlanSummaryDisplay } from '../PlanSummaryDisplay.js';
 import { ShellInputPrompt } from '../ShellInputPrompt.js';
 import { SHELL_COMMAND_NAME, SHELL_NAME } from '../../constants.js';
+import { localizeToolDisplayName } from '../../../i18n/index.js';
 import { formatDuration, formatTokenCount } from '../../utils/formatters.js';
 import { theme } from '../../semantic-colors.js';
 import { useSettings } from '../../contexts/SettingsContext.js';
@@ -800,7 +801,7 @@ const ToolInfo: React.FC<ToolInfo> = ({
         strikethrough={status === ToolCallStatus.Canceled}
       >
         <Text color={nameColor} bold>
-          {name}
+          {localizeToolDisplayName(name)}
         </Text>{' '}
         <Text color={theme.text.secondary}>{description}</Text>
       </Text>

packages/web-shell/client/components/messages/TasksStatusMessage.tsx

@@ -8,7 +8,7 @@ import { useDelayedGlobalKeyDown } from '../../hooks/useDelayedGlobalKeyDown';
 import { useI18n } from '../../i18n';
 import { formatRuntime } from '../../utils/formatRuntime';
 import { createSentinelSerializer } from '../../utils/sentinelMessage';
-import { formatToolDisplayName } from './toolFormatting';
+import { localizeToolDisplayName } from './toolFormatting';
 import styles from './TasksStatusMessage.module.css';
 
 const ACTIVE_EVENT = 'web-shell:tasks-panel-active';
@@ -147,8 +147,12 @@ function windowTasks(
   };
 }
 
-function formatActivityLabel(name: string, description: string | undefined) {
-  const display = formatToolDisplayName(name);
+function formatActivityLabel(
+  name: string,
+  description: string | undefined,
+  t: ReturnType<typeof useI18n>['t'],
+) {
+  const display = localizeToolDisplayName(name, t);
   const singleLineDescription = description
     ? description.replace(/\s*\n\s*/g, ' ').trim()
     : '';
@@ -634,7 +638,7 @@ function TaskDetail({
             </div>
             {task.recentActivities.slice(-5).map((a, i, arr) => {
               const isLast = i === arr.length - 1;
-              const desc = formatActivityLabel(a.name, a.description);
+              const desc = formatActivityLabel(a.name, a.description, t);
               return (
                 <div
                   key={`${a.at}-${i}`}