feat: TUI 16-language i18n framework + Dashboard zh coverage / TUI 16 语言国际化框架 + Dashboard 中文覆盖

hermes_cli/web_server.py

@@ -4104,6 +4104,7 @@ def _discover_dashboard_plugins() -> list:
                 plugins.append({
                     "name": name,
                     "label": data.get("label", name),
+                    "labelKey": data.get("labelKey"),
                     "description": data.get("description", ""),
                     "icon": data.get("icon", "Puzzle"),
                     "version": data.get("version", "0.0.0"),

plugins/example-dashboard/dashboard/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "example",
   "label": "Example",
-  "description": "Example dashboard plugin — used by test suite for auth coverage",
+  "description": "Example dashboard plugin \u2014 used by test suite for auth coverage",
   "icon": "Sparkles",
   "version": "1.0.0",
   "tab": {
@@ -10,5 +10,6 @@
   },
   "slots": [],
   "entry": "dist/index.js",
-  "api": "plugin_api.py"
+  "api": "plugin_api.py",
+  "labelKey": "example"
 }

plugins/hermes-achievements/dashboard/manifest.json

@@ -4,8 +4,12 @@
   "description": "Steam-style achievements for vibe coding and agentic Hermes workflows.",
   "icon": "Star",
   "version": "0.4.0",
-  "tab": { "path": "/achievements", "position": "after:analytics" },
+  "tab": {
+    "path": "/achievements",
+    "position": "after:analytics"
+  },
   "entry": "dist/index.js",
   "css": "dist/style.css",
-  "api": "plugin_api.py"
+  "api": "plugin_api.py",
+  "labelKey": "achievements"
 }

plugins/kanban/dashboard/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "kanban",
   "label": "Kanban",
-  "description": "Multi-agent collaboration board — drag-drop cards across columns, read comment threads, see which profile is running what",
+  "description": "Multi-agent collaboration board \u2014 drag-drop cards across columns, read comment threads, see which profile is running what",
   "icon": "Package",
   "version": "1.0.0",
   "tab": {
@@ -10,5 +10,6 @@
   },
   "entry": "dist/index.js",
   "css": "dist/style.css",
-  "api": "plugin_api.py"
+  "api": "plugin_api.py",
+  "labelKey": "kanban"
 }

tests/test_tui_gateway_server.py

@@ -1536,6 +1536,48 @@ def test_complete_slash_includes_tui_mouse_command():
     assert any(item["text"] == "/mouse" for item in resp["result"]["items"])
 
 
+def test_complete_slash_tui_extra_meta_respects_language(monkeypatch):
+    monkeypatch.setattr(server, "resolve_language", lambda: "en")
+    resp_en = server.handle_request(
+        {"id": "1", "method": "complete.slash", "params": {"text": "/com"}}
+    )
+    assert isinstance(resp_en, dict)
+    result_en = resp_en.get("result")
+    assert isinstance(result_en, dict)
+
+    compact_en = next(item for item in result_en["items"] if item["text"] == "/compact")
+    assert compact_en["meta"] == "Toggle compact display mode"
+
+    monkeypatch.setattr(server, "resolve_language", lambda: "zh")
+    resp_zh = server.handle_request(
+        {"id": "2", "method": "complete.slash", "params": {"text": "/com"}}
+    )
+    assert isinstance(resp_zh, dict)
+    result_zh = resp_zh.get("result")
+    assert isinstance(result_zh, dict)
+
+    compact_zh = next(item for item in result_zh["items"] if item["text"] == "/compact")
+    assert compact_zh["meta"] == "切换紧凑显示模式"
+
+
+def test_commands_catalog_tui_extra_meta_respects_language(monkeypatch):
+    monkeypatch.setattr(server, "resolve_language", lambda: "en")
+    resp_en = server.handle_request(
+        {"id": "1", "method": "commands.catalog", "params": {}}
+    )
+    tui_en = next(c for c in resp_en["result"]["categories"] if c["name"] == "TUI")
+    compact_en = next(item for item in tui_en["pairs"] if item[0] == "/compact")
+    assert compact_en[1] == "Toggle compact display mode"
+
+    monkeypatch.setattr(server, "resolve_language", lambda: "zh")
+    resp_zh = server.handle_request(
+        {"id": "2", "method": "commands.catalog", "params": {}}
+    )
+    tui_zh = next(c for c in resp_zh["result"]["categories"] if c["name"] == "TUI")
+    compact_zh = next(item for item in tui_zh["pairs"] if item[0] == "/compact")
+    assert compact_zh[1] == "切换紧凑显示模式"
+
+
 def test_complete_slash_details_args():
     resp_root = server.handle_request(
         {"id": "0", "method": "complete.slash", "params": {"text": "/details"}}

tui_gateway/entry.py

@@ -17,7 +17,7 @@
 import traceback
 
 from tui_gateway import server
-from tui_gateway.server import _CRASH_LOG, dispatch, resolve_skin, write_json
+from tui_gateway.server import _CRASH_LOG, dispatch, resolve_language, resolve_skin, write_json
 from tui_gateway.transport import TeeTransport
 
 
@@ -219,7 +219,7 @@ def main():
     if not write_json({
         "jsonrpc": "2.0",
         "method": "event",
-        "params": {"type": "gateway.ready", "payload": {"skin": resolve_skin()}},
+        "params": {"type": "gateway.ready", "payload": {"language": resolve_language(), "skin": resolve_skin()}},
     }):
         _log_exit("startup write failed (broken stdout pipe before first event)")
         sys.exit(0)

tui_gateway/server.py

@@ -772,6 +772,15 @@ def resolve_skin() -> dict:
         return {}
 
 
+def resolve_language() -> str:
+    """Resolve the language code used by TUI-facing gateway metadata."""
+    try:
+        from agent.i18n import get_language
+        return get_language()
+    except Exception:
+        return "en"
+
+
 def _resolve_model() -> str:
     env = (
         os.environ.get("HERMES_MODEL", "")
@@ -4399,12 +4408,28 @@ def _(rid, params: dict) -> dict:
     }
 )
 
-_TUI_EXTRA: list[tuple[str, str, str]] = [
-    ("/compact", "Toggle compact display mode", "TUI"),
-    ("/logs", "Show recent gateway log lines", "TUI"),
-    ("/mouse", "Toggle mouse/wheel tracking [on|off|toggle]", "TUI"),
+_TUI_EXTRA_META: dict[str, tuple[str, str]] = {
+    "/compact": ("Toggle compact display mode", "切换紧凑显示模式"),
+    "/details": ("Control agent detail visibility", "控制 Agent 详情可见性"),
+    "/logs": ("Show recent gateway log lines", "显示最近的网关日志"),
+    "/mouse": (
+        "Toggle mouse/wheel tracking [on|off|toggle]",
+        "切换鼠标/滚轮追踪 [on|off|toggle]",
+    ),
+}
+
+_TUI_EXTRA: list[tuple[str, str]] = [
+    ("/compact", "TUI"),
+    ("/logs", "TUI"),
+    ("/mouse", "TUI"),
 ]
 
+
+def _tui_extra_meta(command: str) -> str:
+    """Return localized metadata for TUI-only slash commands."""
+    en, zh = _TUI_EXTRA_META[command]
+    return zh if resolve_language().lower().startswith("zh") else en
+
 # Commands that queue messages onto _pending_input in the CLI.
 # In the TUI the slash worker subprocess has no reader for that queue,
 # so slash.exec rejects them → TUI falls through to command.dispatch.
@@ -4456,7 +4481,8 @@ def _(rid, params: dict) -> dict:
                 cat_order.append(cat)
             cat_map[cat].append([c, desc])
 
-        for name, desc, cat in _TUI_EXTRA:
+        for name, cat in _TUI_EXTRA:
+            desc = _tui_extra_meta(name)
             all_pairs.append([name, desc])
             if cat not in cat_map:
                 cat_map[cat] = []
@@ -5262,26 +5288,8 @@ def _(rid, params: dict) -> dict:
         ][:30]
         text_lower = text.lower()
         extras = [
-            {
-                "text": "/compact",
-                "display": "/compact",
-                "meta": "Toggle compact display mode",
-            },
-            {
-                "text": "/details",
-                "display": "/details",
-                "meta": "Control agent detail visibility",
-            },
-            {
-                "text": "/logs",
-                "display": "/logs",
-                "meta": "Show recent gateway log lines",
-            },
-            {
-                "text": "/mouse",
-                "display": "/mouse",
-                "meta": "Toggle mouse/wheel tracking [on|off|toggle]",
-            },
+            {"text": command, "display": command, "meta": _tui_extra_meta(command)}
+            for command in _TUI_EXTRA_META
         ]
         for extra in extras:
             if extra["text"].startswith(text_lower) and not any(

tui_gateway/ws.py

@@ -125,7 +125,7 @@ async def handle_ws(ws: Any) -> None:
             "method": "event",
             "params": {
                 "type": "gateway.ready",
-                "payload": {"skin": server.resolve_skin()},
+                "payload": {"language": server.resolve_language(), "skin": server.resolve_skin()},
             },
         }
     )

ui-tui/src/__tests__/clipboard.test.ts

@@ -2,6 +2,8 @@ import { describe, expect, it, vi } from 'vitest'
 
 import { isUsableClipboardText, readClipboardText, writeClipboardText } from '../lib/clipboard.js'
 
+const POWERSHELL_READ_CLIPBOARD = '[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; Get-Clipboard -Raw'
+
 describe('readClipboardText', () => {
   it('reads text from pbpaste on macOS', async () => {
     const run = vi.fn().mockResolvedValue({ stdout: 'hello world\n' })
@@ -20,7 +22,7 @@ describe('readClipboardText', () => {
     await expect(readClipboardText('win32', run)).resolves.toBe('from windows\r\n')
     expect(run).toHaveBeenCalledWith(
       'powershell',
-      ['-NoProfile', '-NonInteractive', '-Command', 'Get-Clipboard -Raw'],
+      ['-NoProfile', '-NonInteractive', '-Command', POWERSHELL_READ_CLIPBOARD],
       expect.objectContaining({ encoding: 'utf8', maxBuffer: 4 * 1024 * 1024, windowsHide: true })
     )
   })
@@ -33,7 +35,7 @@ describe('readClipboardText', () => {
     )
     expect(run).toHaveBeenCalledWith(
       'powershell.exe',
-      ['-NoProfile', '-NonInteractive', '-Command', 'Get-Clipboard -Raw'],
+      ['-NoProfile', '-NonInteractive', '-Command', POWERSHELL_READ_CLIPBOARD],
       expect.objectContaining({ encoding: 'utf8', maxBuffer: 4 * 1024 * 1024, windowsHide: true })
     )
   })

ui-tui/src/__tests__/constants.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest'
 
 import { FACES } from '../content/faces.js'
-import { HOTKEYS } from '../content/hotkeys.js'
+import { HOTKEY_DEFS } from '../content/hotkeys.js'
 import { PLACEHOLDERS } from '../content/placeholders.js'
 import { TOOL_VERBS, VERBS } from '../content/verbs.js'
 import { ROLE } from '../domain/roles.js'
@@ -19,17 +19,17 @@ describe('constants', () => {
     }
   })
 
-  it('HOTKEYS are [key, desc] pairs', () => {
-    HOTKEYS.forEach(([k, d]) => {
+  it('HOTKEY_DEFS are [key, TranslationKey] pairs', () => {
+    HOTKEY_DEFS.forEach(([k, d]) => {
       expect(typeof k).toBe('string')
       expect(typeof d).toBe('string')
     })
   })
 
   it('documents Ctrl/Cmd+L as non-destructive redraw', () => {
-    const hotkey = HOTKEYS.find(([k]) => k.endsWith('+L'))
+    const hotkey = HOTKEY_DEFS.find(([k]) => k.endsWith('+L'))
     expect(hotkey).toBeDefined()
-    expect(hotkey?.[1]).toBe('redraw / repaint')
+    expect(hotkey?.[1]).toBe('hotkey.redraw')
   })
 
   it('TOOL_VERBS maps known tools (verb-only, no emoji)', () => {

ui-tui/src/__tests__/createSlashHandler.test.ts

@@ -271,7 +271,7 @@ describe('createSlashHandler', () => {
     expect(createSlashHandler(ctx)('/voice on')).toBe(true)
     await vi.waitFor(() => {
       expect(ctx.transcript.sys).toHaveBeenCalledWith('Voice mode enabled')
-      expect(ctx.transcript.sys).toHaveBeenCalledWith('  Alt+R to start/stop recording')
+      expect(ctx.transcript.sys).toHaveBeenCalledWith('Alt+R to start/stop recording')
     })
     expect(ctx.voice.setVoiceRecordKey).toHaveBeenCalledWith(expect.objectContaining({ ch: 'r', mod: 'alt' }))
   })

ui-tui/src/__tests__/gatewayClient.test.ts

@@ -248,9 +248,9 @@ describe('GatewayClient websocket attach mode', () => {
     const next = gw.request('session.create', {})
 
     await expect(stale).rejects.toThrow(/gateway attach url changed/)
-    await vi.waitFor(() => expect(FakeWebSocket.instances).toHaveLength(2))
+    await vi.waitFor(() => expect(FakeWebSocket.instances.length).toBeGreaterThanOrEqual(2))
 
-    const secondSocket = FakeWebSocket.instances[1]!
+    const secondSocket = FakeWebSocket.instances.at(-1)!
     expect(secondSocket.url).toContain('gateway-new.test')
 
     secondSocket.open()

ui-tui/src/__tests__/statusBarTicker.test.ts

@@ -1,12 +1,12 @@
 import { describe, expect, it } from 'vitest'
 
-import { padVerb, VERB_PAD_LEN } from '../components/appChrome.js'
+import { displayWidth, padVerb, VERB_PAD_LEN } from '../components/appChrome.js'
 import { VERBS } from '../content/verbs.js'
 
 describe('FaceTicker verb padding', () => {
   it('pads every verb to the same width', () => {
     for (const verb of VERBS) {
-      expect(padVerb(verb)).toHaveLength(VERB_PAD_LEN)
+      expect(displayWidth(padVerb(verb))).toBe(VERB_PAD_LEN)
     }
   })
 

ui-tui/src/app.tsx

@@ -5,21 +5,24 @@ import { $uiState } from './app/uiStore.js'
 import { useMainApp } from './app/useMainApp.js'
 import { AppLayout } from './components/appLayout.js'
 import type { GatewayClient } from './gatewayClient.js'
+import { I18nProvider } from './i18n.js'
 
 export function App({ gw }: { gw: GatewayClient }) {
   const { appActions, appComposer, appProgress, appStatus, appTranscript, gateway } = useMainApp(gw)
-  const { mouseTracking } = useStore($uiState)
+  const { locale, mouseTracking } = useStore($uiState)
 
   return (
     <GatewayProvider value={gateway}>
-      <AppLayout
-        actions={appActions}
-        composer={appComposer}
-        mouseTracking={mouseTracking}
-        progress={appProgress}
-        status={appStatus}
-        transcript={appTranscript}
-      />
+      <I18nProvider locale={locale}>
+        <AppLayout
+          actions={appActions}
+          composer={appComposer}
+          mouseTracking={mouseTracking}
+          progress={appProgress}
+          status={appStatus}
+          transcript={appTranscript}
+        />
+      </I18nProvider>
     </GatewayProvider>
   )
 }