From bdc57655d6dea1e2593f7a8e8e63fdf044797dfb Mon Sep 17 00:00:00 2001
From: qiongyu1999 <2694684348@qq.com>
Date: Thu, 21 May 2026 17:00:28 +0800
Subject: [PATCH] localize handoff editor button

---
 apps/web/src/components/HandoffButton.tsx     | 16 ++---
 apps/web/src/i18n/locales/ar.ts               |  6 ++
 apps/web/src/i18n/locales/de.ts               |  6 ++
 apps/web/src/i18n/locales/en.ts               |  6 ++
 apps/web/src/i18n/locales/es-ES.ts            |  6 ++
 apps/web/src/i18n/locales/fa.ts               |  6 ++
 apps/web/src/i18n/locales/fr.ts               |  6 ++
 apps/web/src/i18n/locales/hu.ts               |  6 ++
 apps/web/src/i18n/locales/id.ts               |  6 ++
 apps/web/src/i18n/locales/it.ts               |  6 ++
 apps/web/src/i18n/locales/ja.ts               |  6 ++
 apps/web/src/i18n/locales/ko.ts               |  6 ++
 apps/web/src/i18n/locales/pl.ts               |  6 ++
 apps/web/src/i18n/locales/pt-BR.ts            |  6 ++
 apps/web/src/i18n/locales/ru.ts               |  6 ++
 apps/web/src/i18n/locales/th.ts               |  6 ++
 apps/web/src/i18n/locales/tr.ts               |  6 ++
 apps/web/src/i18n/locales/uk.ts               |  6 ++
 apps/web/src/i18n/locales/zh-CN.ts            |  6 ++
 apps/web/src/i18n/locales/zh-TW.ts            |  6 ++
 apps/web/src/i18n/types.ts                    |  6 ++
 .../tests/components/HandoffButton.test.tsx   | 61 +++++++++++++++++++
 22 files changed, 190 insertions(+), 7 deletions(-)
 create mode 100644 apps/web/tests/components/HandoffButton.test.tsx

diff --git a/apps/web/src/components/HandoffButton.tsx b/apps/web/src/components/HandoffButton.tsx
index 966936c0a1..593188fc64 100644
--- a/apps/web/src/components/HandoffButton.tsx
+++ b/apps/web/src/components/HandoffButton.tsx
@@ -11,6 +11,7 @@ import type {
   HostEditorsResponse,
 } from '@open-design/contracts';
 import { fetchHostEditors, openProjectInEditor } from '../providers/registry';
+import { useT } from '../i18n';
 import { Icon } from './Icon';
 import { EditorIcon } from './EditorIcon';
 
@@ -42,6 +43,7 @@ function writePreferred(id: HostEditorId): void {
 }
 
 export function HandoffButton({ projectId, onRequestRevealInFinder }: Props) {
+  const t = useT();
   const [editors, setEditors] = useState<HostEditor[]>([]);
   const [platform, setPlatform] = useState<HostEditorsResponse['platform']>('unknown');
   const [loaded, setLoaded] = useState(false);
@@ -135,7 +137,7 @@ export function HandoffButton({ projectId, onRequestRevealInFinder }: Props) {
       <button
         type="button"
         className="handoff-trigger handoff-trigger--solo"
-        title={`No editors found on $PATH — opens in ${fallbackLabel}`}
+        title={t('handoff.fallbackTitle', { target: fallbackLabel })}
         onClick={() => onRequestRevealInFinder?.()}
       >
         <EditorIcon editorId={fallbackId} size={20} />
@@ -159,7 +161,7 @@ export function HandoffButton({ projectId, onRequestRevealInFinder }: Props) {
           type="button"
           className="handoff-trigger"
           data-testid="handoff-trigger"
-          title={primary ? `交付给 ${primary.label}` : '交付'}
+          title={primary ? t('handoff.toTarget', { target: primary.label }) : t('handoff.action')}
           onClick={() => {
             if (primary && busy !== primary.id) {
               void launch(primary);
@@ -173,20 +175,20 @@ export function HandoffButton({ projectId, onRequestRevealInFinder }: Props) {
             <>
               <EditorIcon editorId={primary.id} size={20} />
               <span className="handoff-trigger-label">
-                交付给 {primary.label}
+                {t('handoff.toTarget', { target: primary.label })}
               </span>
             </>
           ) : (
             <>
               <EditorIcon editorId="finder" size={20} />
-              <span className="handoff-trigger-label">交付</span>
+              <span className="handoff-trigger-label">{t('handoff.action')}</span>
             </>
           )}
         </button>
         <button
           type="button"
           className="handoff-caret"
-          aria-label="Choose hand-off target"
+          aria-label={t('handoff.chooseTargetAria')}
           data-testid="handoff-caret"
           onClick={() => setOpen((v) => !v)}
           disabled={busy !== null}
@@ -216,7 +218,7 @@ export function HandoffButton({ projectId, onRequestRevealInFinder }: Props) {
           {unavailable.length > 0 ? (
             <>
               <div className="handoff-menu-divider" />
-              <div className="handoff-menu-section">Not installed</div>
+              <div className="handoff-menu-section">{t('handoff.notInstalled')}</div>
               {unavailable.map((editor) => (
                 <button
                   key={editor.id}
@@ -226,7 +228,7 @@ export function HandoffButton({ projectId, onRequestRevealInFinder }: Props) {
                   data-testid={`handoff-menu-item-${editor.id}`}
                   onClick={() => void launch(editor)}
                   disabled={busy === editor.id}
-                  title={`${editor.label} — not detected on $PATH`}
+                  title={t('handoff.notDetectedTitle', { target: editor.label })}
                 >
                   <EditorIcon editorId={editor.id} size={20} />
                   <span>{editor.label}</span>
diff --git a/apps/web/src/i18n/locales/ar.ts b/apps/web/src/i18n/locales/ar.ts
index dfc62f54d3..2169ab27d0 100644
--- a/apps/web/src/i18n/locales/ar.ts
+++ b/apps/web/src/i18n/locales/ar.ts
@@ -15,6 +15,12 @@ export const ar: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "أمثلة",
   'homeHero.footer.designSystem': "النمط",
   'homeHero.footer.autoDesignSystem': "تلقائي",
diff --git a/apps/web/src/i18n/locales/de.ts b/apps/web/src/i18n/locales/de.ts
index ce098ff36a..2cc8f33161 100644
--- a/apps/web/src/i18n/locales/de.ts
+++ b/apps/web/src/i18n/locales/de.ts
@@ -15,6 +15,12 @@ export const de: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Beispiele",
   'homeHero.footer.designSystem': "Stil",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/en.ts b/apps/web/src/i18n/locales/en.ts
index 31af0158ec..32c3aa44d8 100644
--- a/apps/web/src/i18n/locales/en.ts
+++ b/apps/web/src/i18n/locales/en.ts
@@ -479,6 +479,12 @@ export const en: Dict = {
   'workingDirPicker.showInFileManager': 'Show in file manager',
   'workingDirPicker.replace': 'Clear and replace directory…',
   'workingDirPicker.recent': 'Recent directories',
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'designSystemPicker.select': 'Choose design system',
   'designSystemPicker.loading': 'Loading design systems…',
   'designSystemPicker.searchPlaceholder': 'Search design systems (title / category / summary)',
diff --git a/apps/web/src/i18n/locales/es-ES.ts b/apps/web/src/i18n/locales/es-ES.ts
index 4380061f74..077331e543 100644
--- a/apps/web/src/i18n/locales/es-ES.ts
+++ b/apps/web/src/i18n/locales/es-ES.ts
@@ -15,6 +15,12 @@ export const esES: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Ejemplos",
   'homeHero.footer.designSystem': "Estilo",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/fa.ts b/apps/web/src/i18n/locales/fa.ts
index 05e24d2935..c647411252 100644
--- a/apps/web/src/i18n/locales/fa.ts
+++ b/apps/web/src/i18n/locales/fa.ts
@@ -15,6 +15,12 @@ export const fa: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "نمونه‌ها",
   'homeHero.footer.designSystem': "سبک",
   'homeHero.footer.autoDesignSystem': "خودکار",
diff --git a/apps/web/src/i18n/locales/fr.ts b/apps/web/src/i18n/locales/fr.ts
index 4adfd0f82c..cbcc26ca89 100644
--- a/apps/web/src/i18n/locales/fr.ts
+++ b/apps/web/src/i18n/locales/fr.ts
@@ -15,6 +15,12 @@ export const fr: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Exemples",
   'homeHero.footer.designSystem': "Style",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/hu.ts b/apps/web/src/i18n/locales/hu.ts
index d24245a569..e365438825 100644
--- a/apps/web/src/i18n/locales/hu.ts
+++ b/apps/web/src/i18n/locales/hu.ts
@@ -15,6 +15,12 @@ export const hu: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Példák",
   'homeHero.footer.designSystem': "Stílus",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/id.ts b/apps/web/src/i18n/locales/id.ts
index 8dd1c55b5a..3fce1192b8 100644
--- a/apps/web/src/i18n/locales/id.ts
+++ b/apps/web/src/i18n/locales/id.ts
@@ -15,6 +15,12 @@ export const id: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Contoh",
   'homeHero.footer.designSystem': "Gaya",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/it.ts b/apps/web/src/i18n/locales/it.ts
index 04a28d9ac5..e61e973b2f 100644
--- a/apps/web/src/i18n/locales/it.ts
+++ b/apps/web/src/i18n/locales/it.ts
@@ -15,6 +15,12 @@ export const it: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Esempi",
   'homeHero.footer.designSystem': "Stile",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/ja.ts b/apps/web/src/i18n/locales/ja.ts
index dea137e32b..f57f4286ee 100644
--- a/apps/web/src/i18n/locales/ja.ts
+++ b/apps/web/src/i18n/locales/ja.ts
@@ -15,6 +15,12 @@ export const ja: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "例",
   'homeHero.footer.designSystem': "スタイル",
   'homeHero.footer.autoDesignSystem': "自動",
diff --git a/apps/web/src/i18n/locales/ko.ts b/apps/web/src/i18n/locales/ko.ts
index ac2a1bda95..6a29c39115 100644
--- a/apps/web/src/i18n/locales/ko.ts
+++ b/apps/web/src/i18n/locales/ko.ts
@@ -15,6 +15,12 @@ export const ko: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "예시",
   'homeHero.footer.designSystem': "스타일",
   'homeHero.footer.autoDesignSystem': "자동",
diff --git a/apps/web/src/i18n/locales/pl.ts b/apps/web/src/i18n/locales/pl.ts
index 0d83f4ec12..6610481fc2 100644
--- a/apps/web/src/i18n/locales/pl.ts
+++ b/apps/web/src/i18n/locales/pl.ts
@@ -15,6 +15,12 @@ export const pl: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Przykłady",
   'homeHero.footer.designSystem': "Styl",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/pt-BR.ts b/apps/web/src/i18n/locales/pt-BR.ts
index 34d75cef12..44f84c1415 100644
--- a/apps/web/src/i18n/locales/pt-BR.ts
+++ b/apps/web/src/i18n/locales/pt-BR.ts
@@ -15,6 +15,12 @@ export const ptBR: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Exemplos",
   'homeHero.footer.designSystem': "Estilo",
   'homeHero.footer.autoDesignSystem': "Auto",
diff --git a/apps/web/src/i18n/locales/ru.ts b/apps/web/src/i18n/locales/ru.ts
index f8a7b8d004..2b6b8ea5b4 100644
--- a/apps/web/src/i18n/locales/ru.ts
+++ b/apps/web/src/i18n/locales/ru.ts
@@ -15,6 +15,12 @@ export const ru: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Примеры",
   'homeHero.footer.designSystem': "Стиль",
   'homeHero.footer.autoDesignSystem': "Авто",
diff --git a/apps/web/src/i18n/locales/th.ts b/apps/web/src/i18n/locales/th.ts
index baf00c8de6..277bfd5bb7 100644
--- a/apps/web/src/i18n/locales/th.ts
+++ b/apps/web/src/i18n/locales/th.ts
@@ -15,6 +15,12 @@ export const th: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "ตัวอย่าง",
   'homeHero.footer.designSystem': "สไตล์",
   'homeHero.footer.autoDesignSystem': "อัตโนมัติ",
diff --git a/apps/web/src/i18n/locales/tr.ts b/apps/web/src/i18n/locales/tr.ts
index 5af5546ace..05af7cdac6 100644
--- a/apps/web/src/i18n/locales/tr.ts
+++ b/apps/web/src/i18n/locales/tr.ts
@@ -15,6 +15,12 @@ export const tr: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Örnekler",
   'homeHero.footer.designSystem': "Stil",
   'homeHero.footer.autoDesignSystem': "Otomatik",
diff --git a/apps/web/src/i18n/locales/uk.ts b/apps/web/src/i18n/locales/uk.ts
index 81ffee8bb6..43508c068f 100644
--- a/apps/web/src/i18n/locales/uk.ts
+++ b/apps/web/src/i18n/locales/uk.ts
@@ -15,6 +15,12 @@ export const uk: Dict = {
   'workingDirPicker.showInFileManager': "Show in file manager",
   'workingDirPicker.replace': "Clear and replace directory…",
   'workingDirPicker.recent': "Recent directories",
+  'handoff.toTarget': 'Hand off to {target}',
+  'handoff.action': 'Hand off',
+  'handoff.fallbackTitle': 'No editors found on $PATH - opens in {target}',
+  'handoff.chooseTargetAria': 'Choose hand-off target',
+  'handoff.notInstalled': 'Not installed',
+  'handoff.notDetectedTitle': '{target} - not detected on $PATH',
   'homeHero.promptExamples': "Приклади",
   'homeHero.footer.designSystem': "Стиль",
   'homeHero.footer.autoDesignSystem': "Авто",
diff --git a/apps/web/src/i18n/locales/zh-CN.ts b/apps/web/src/i18n/locales/zh-CN.ts
index cdb2b8905f..f963fd676f 100644
--- a/apps/web/src/i18n/locales/zh-CN.ts
+++ b/apps/web/src/i18n/locales/zh-CN.ts
@@ -479,6 +479,12 @@ export const zhCN: Dict = {
   'workingDirPicker.showInFileManager': '在文件管理器中显示',
   'workingDirPicker.replace': '清空并替换目录…',
   'workingDirPicker.recent': '最近使用的目录',
+  'handoff.toTarget': '交付给 {target}',
+  'handoff.action': '交付',
+  'handoff.fallbackTitle': '未找到编辑器 - 使用 {target} 打开',
+  'handoff.chooseTargetAria': '选择交付目标',
+  'handoff.notInstalled': '未安装',
+  'handoff.notDetectedTitle': '{target} - 未在 $PATH 中检测到',
   'designSystemPicker.select': '选择设计系统',
   'designSystemPicker.loading': '正在加载设计系统…',
   'designSystemPicker.searchPlaceholder': '搜索设计系统（标题 / 分类 / 摘要）',
diff --git a/apps/web/src/i18n/locales/zh-TW.ts b/apps/web/src/i18n/locales/zh-TW.ts
index de8b87d874..53c75db983 100644
--- a/apps/web/src/i18n/locales/zh-TW.ts
+++ b/apps/web/src/i18n/locales/zh-TW.ts
@@ -15,6 +15,12 @@ export const zhTW: Dict = {
   'workingDirPicker.showInFileManager': "在檔案管理器中顯示",
   'workingDirPicker.replace': "清空並替換目錄…",
   'workingDirPicker.recent': "最近使用的目錄",
+  'handoff.toTarget': '交付給 {target}',
+  'handoff.action': '交付',
+  'handoff.fallbackTitle': '未找到編輯器 - 使用 {target} 開啟',
+  'handoff.chooseTargetAria': '選擇交付目標',
+  'handoff.notInstalled': '未安裝',
+  'handoff.notDetectedTitle': '{target} - 未在 $PATH 中偵測到',
   'homeHero.promptExamples': "範例提示詞",
   'homeHero.footer.designSystem': "風格",
   'homeHero.footer.autoDesignSystem': "自動",
diff --git a/apps/web/src/i18n/types.ts b/apps/web/src/i18n/types.ts
index 5fcaee9ee8..e08405014c 100644
--- a/apps/web/src/i18n/types.ts
+++ b/apps/web/src/i18n/types.ts
@@ -786,6 +786,12 @@ export interface Dict {
   'workingDirPicker.showInFileManager': string;
   'workingDirPicker.replace': string;
   'workingDirPicker.recent': string;
+  'handoff.toTarget': string;
+  'handoff.action': string;
+  'handoff.fallbackTitle': string;
+  'handoff.chooseTargetAria': string;
+  'handoff.notInstalled': string;
+  'handoff.notDetectedTitle': string;
   'designSystemPicker.select': string;
   'designSystemPicker.loading': string;
   'designSystemPicker.searchPlaceholder': string;
diff --git a/apps/web/tests/components/HandoffButton.test.tsx b/apps/web/tests/components/HandoffButton.test.tsx
new file mode 100644
index 0000000000..5102619a57
--- /dev/null
+++ b/apps/web/tests/components/HandoffButton.test.tsx
@@ -0,0 +1,61 @@
+// @vitest-environment jsdom
+
+import { cleanup, fireEvent, render, screen } from '@testing-library/react';
+import type { HostEditor, HostEditorsResponse } from '@open-design/contracts';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { HandoffButton } from '../../src/components/HandoffButton';
+import { I18nProvider, type Locale } from '../../src/i18n';
+
+afterEach(() => {
+  cleanup();
+  vi.restoreAllMocks();
+  window.localStorage.clear();
+});
+
+function stubEditors(editors: HostEditor[], platform: HostEditorsResponse['platform'] = 'darwin') {
+  vi.stubGlobal('fetch', vi.fn<typeof fetch>(async (input) => {
+    if (String(input) === '/api/editors') {
+      return new Response(JSON.stringify({ editors, platform }), {
+        status: 200,
+        headers: { 'content-type': 'application/json' },
+      });
+    }
+    throw new Error(`unexpected fetch ${String(input)}`);
+  }));
+}
+
+function renderLocalized(locale: Locale) {
+  render(
+    <I18nProvider initial={locale}>
+      <HandoffButton projectId="project-1" />
+    </I18nProvider>,
+  );
+}
+
+describe('HandoffButton i18n', () => {
+  it('localizes the primary handoff label', async () => {
+    stubEditors([{ id: 'finder', label: 'Finder', available: true }]);
+
+    renderLocalized('en');
+
+    const trigger = await screen.findByTestId('handoff-trigger');
+    expect(trigger.getAttribute('title')).toBe('Hand off to Finder');
+    expect(trigger.textContent).toContain('Hand off to Finder');
+  });
+
+  it('localizes the unavailable editor section', async () => {
+    stubEditors([
+      { id: 'finder', label: 'Finder', available: true },
+      { id: 'cursor', label: 'Cursor', available: false },
+    ]);
+
+    renderLocalized('zh-CN');
+
+    fireEvent.click(await screen.findByTestId('handoff-caret'));
+
+    expect(await screen.findByText('未安装')).toBeTruthy();
+    expect(screen.getByTestId('handoff-menu-item-cursor').getAttribute('title'))
+      .toBe('Cursor - 未在 $PATH 中检测到');
+  });
+});