opencode-i18n 0.1.0

package/i18n/locales/zh-Hant.json

@@ -0,0 +1,277 @@
+{
+  "name": "繁體中文",
+  "language_picker": {
+    "question": "選擇 OpenCode 介面語言",
+    "option_descriptions": {
+      "en": "切換到英文介面",
+      "zh-Hans": "切換到簡體中文介面",
+      "zh-Hant": "切換到繁體中文介面",
+      "ko": "切換到韓語介面",
+      "de": "切換到德語介面",
+      "es": "切換到西班牙語介面",
+      "fr": "切換到法語介面",
+      "da": "切換到丹麥語介面",
+      "ja": "切換到日語介面",
+      "pl": "切換到波蘭語介面",
+      "ru": "切換到俄語介面",
+      "uk": "切換到烏克蘭語介面",
+      "bs": "切換到波士尼亞語介面",
+      "ar": "切換到阿拉伯語介面",
+      "no": "切換到挪威語介面",
+      "pt-BR": "切換到巴西葡萄牙語介面",
+      "th": "切換到泰語介面",
+      "tr": "切換到土耳其語介面"
+    }
+  },
+  "commands": {
+    "Suggested": {
+      "Share session": "分享會話",
+      "Switch session": "切換會話",
+      "New session": "新增會話",
+      "Switch model": "切換模型",
+      "Connect provider": "連結模型提供者"
+    },
+    "Session": {
+      "Share session": "分享會話",
+      "Copy share link": "複製分享連結",
+      "Rename session": "重新命名會話",
+      "Jump to message": "跳至訊息",
+      "Fork session": "分叉會話",
+      "Compact session": "壓縮會話上下文",
+      "Unshare session": "取消分享會話",
+      "Undo previous message": "復原上一則訊息",
+      "Redo": "重做",
+      "Hide sidebar": "隱藏側邊欄",
+      "Show sidebar": "顯示側邊欄",
+      "Disable code concealment": "停用程式碼隱藏",
+      "Enable code concealment": "啟用程式碼隱藏",
+      "Hide timestamps": "隱藏時間戳記",
+      "Show timestamps": "顯示時間戳記",
+      "Collapse thinking": "折疊思考過程",
+      "Expand thinking": "展開思考過程",
+      "Hide tool details": "隱藏工具詳細資訊",
+      "Show tool details": "顯示工具詳細資訊",
+      "Toggle session scrollbar": "切換會話捲動條",
+      "Hide generic tool output": "隱藏一般工具輸出",
+      "Show generic tool output": "顯示一般工具輸出",
+      "Copy last assistant message": "複製最後一則助理回覆",
+      "Copy session transcript": "複製會話記錄",
+      "Export session transcript": "匯出會話記錄",
+      "Switch session": "切換會話",
+      "New session": "新增會話",
+      "Page up": "向上翻頁",
+      "Page down": "向下翻頁",
+      "Line up": "向上移動一行",
+      "Line down": "向下移動一行",
+      "Half page up": "向上捲動半頁",
+      "Half page down": "向下捲動半頁",
+      "First message": "第一則訊息",
+      "Last message": "最後一則訊息",
+      "Jump to last user message": "跳至最後一則使用者訊息",
+      "Next message": "下一則訊息",
+      "Previous message": "上一則訊息",
+      "Background subagents": "背景子代理",
+      "Go to child session": "進入子會話",
+      "Go to parent session": "返回父會話",
+      "Next child session": "下一個子會話",
+      "Previous child session": "上一個子會話",
+      "Switch to session in quick slot 1": "切換到快速槽位 1 的會話",
+      "Switch to session in quick slot 2": "切換到快速槽位 2 的會話",
+      "Switch to session in quick slot 3": "切換到快速槽位 3 的會話",
+      "Switch to session in quick slot 4": "切換到快速槽位 4 的會話",
+      "Switch to session in quick slot 5": "切換到快速槽位 5 的會話",
+      "Switch to session in quick slot 6": "切換到快速槽位 6 的會話",
+      "Switch to session in quick slot 7": "切換到快速槽位 7 的會話",
+      "Switch to session in quick slot 8": "切換到快速槽位 8 的會話",
+      "Switch to session in quick slot 9": "切換到快速槽位 9 的會話",
+      "Open editor": "開啟編輯器",
+      "Move session": "移動會話",
+      "Interrupt session": "中斷會話",
+      "View subagents": "檢視子代理",
+      "Manage queued prompts": "管理佇列中的提示詞",
+      "Warp": "切換工作區"
+    },
+    "Agent": {
+      "Switch model": "切換模型",
+      "Switch agent": "切換 AI 代理",
+      "Toggle MCPs": "切換 MCP",
+      "Variant cycle": "下一個變體",
+      "Switch model variant": "切換模型變體",
+      "Model cycle": "下一個模型",
+      "Model cycle reverse": "上一個模型",
+      "Favorite cycle": "下一個收藏項",
+      "Favorite cycle reverse": "上一個收藏項",
+      "Agent cycle": "下一個 AI 代理",
+      "Agent cycle reverse": "上一個 AI 代理"
+    },
+    "Provider": {
+      "Connect provider": "連結模型提供者",
+      "Switch org": "切換組織"
+    },
+    "System": {
+      "Show command palette": "顯示指令面板",
+      "View status": "檢視狀態",
+      "Switch theme": "切換主題",
+      "Switch to light mode": "切換到淺色模式",
+      "Switch to dark mode": "切換到深色模式",
+      "Lock theme mode": "鎖定主題模式",
+      "Unlock theme mode": "解鎖主題模式",
+      "Help": "說明",
+      "Open docs": "開啟說明文件",
+      "Exit the app": "結束應用程式",
+      "Toggle debug panel": "切換除錯面板",
+      "Toggle console": "切換主控台",
+      "Write heap snapshot": "寫入堆積快照",
+      "Suspend terminal": "暫停終端機",
+      "Disable terminal title": "停用終端機標題",
+      "Enable terminal title": "啟用終端機標題",
+      "Disable animations": "停用動畫",
+      "Enable animations": "啟用動畫",
+      "Disable file context": "停用檔案上下文",
+      "Enable file context": "啟用檔案上下文",
+      "Disable diff wrapping": "停用差異換行",
+      "Enable diff wrapping": "啟用差異換行",
+      "Disable paste summary": "停用貼上摘要",
+      "Enable paste summary": "啟用貼上摘要",
+      "Disable session directory filtering": "停用會話目錄篩選",
+      "Enable session directory filtering": "啟用會話目錄篩選",
+      "Disable auto-approve permissions": "停用自動核准權限",
+      "Enable auto-approve permissions": "啟用自動核准權限",
+      "Open command palette": "開啟指令面板",
+      "Plugins": "外掛",
+      "Install plugin": "安裝外掛",
+      "Show tips": "顯示提示",
+      "Hide tips": "隱藏提示",
+      "Show key bindings": "顯示快捷鍵",
+      "First key binding": "第一個快捷鍵",
+      "Last key binding": "最後一個快捷鍵",
+      "Previous key binding group": "上一組快捷鍵",
+      "Next key binding group": "下一組快捷鍵",
+      "Page key bindings up": "快捷鍵列表向上翻頁",
+      "Page key bindings down": "快捷鍵列表向下翻頁",
+      "Scroll key bindings up": "快捷鍵列表向上捲動",
+      "Scroll key bindings down": "快捷鍵列表向下捲動",
+      "Toggle key bindings layout": "切換快捷鍵面板版面",
+      "Toggle pending key preview": "切換待輸入按鍵預覽"
+    },
+    "Workspace": {
+      "Copy worktree path": "複製工作樹路徑",
+      "Manage workspaces": "管理工作區"
+    },
+    "Autocomplete": {
+      "Previous autocomplete item": "上一個補全項",
+      "Next autocomplete item": "下一個補全項",
+      "Hide autocomplete": "隱藏補全選單",
+      "Select autocomplete item": "選取目前補全項",
+      "Complete autocomplete item": "補全目前項目"
+    },
+    "Prompt": {
+      "Skills": "技能",
+      "Clear prompt": "清空提示詞",
+      "Clear prompt or exit": "清空提示詞或結束",
+      "Submit prompt": "送出提示詞",
+      "Remove editor context": "移除編輯器上下文",
+      "Paste": "貼上",
+      "Stash prompt": "暫存提示詞",
+      "Stash pop": "還原暫存的提示詞",
+      "Stash list": "暫存提示詞列表",
+      "Previous prompt history": "上一則提示詞歷史",
+      "Next prompt history": "下一則提示詞歷史"
+    },
+    "VCS": {
+      "Open diff viewer": "開啟差異視圖",
+      "Close diff viewer": "關閉差異視圖",
+      "Move diff viewer up": "向上移動差異視圖",
+      "Move diff viewer down": "向下移動差異視圖",
+      "Page diff viewer up": "向上翻頁差異視圖",
+      "Page diff viewer down": "向下翻頁差異視圖",
+      "Toggle diff viewer item": "切換差異項目",
+      "Expand diff viewer item": "展開差異項目",
+      "Expand all diff viewer folders": "展開所有差異視圖資料夾",
+      "Collapse diff viewer item": "折疊差異項目",
+      "Jump to next diff hunk": "跳至下一個差異區塊",
+      "Jump to previous diff hunk": "跳至上一個差異區塊",
+      "Jump to next diff file": "跳至下一個差異檔案",
+      "Jump to previous diff file": "跳至上一個差異檔案",
+      "Toggle selected diff file reviewed": "切換所選差異檔案已審閱狀態",
+      "Switch diff viewer focus": "切換差異視圖焦點",
+      "Toggle diff viewer file tree": "切換差異視圖檔案樹",
+      "Toggle single patch view": "切換單一 Patch 視圖",
+      "Switch diff viewer source": "切換差異來源",
+      "Toggle diff viewer split or unified view": "切換分欄/統一視圖",
+      "Show more diff viewer shortcuts": "顯示更多差異視圖快捷鍵"
+    },
+    "Dialog": {
+      "Previous item": "上一項",
+      "Next item": "下一項",
+      "First item": "第一項",
+      "Last item": "最後一項",
+      "Select item": "選取項目",
+      "Submit dialog prompt": "送出對話框輸入"
+    },
+    "Permission": {
+      "Cancel permission rejection": "取消拒絕權限",
+      "Reject permission": "拒絕權限",
+      "Toggle permission fullscreen": "切換權限全螢幕"
+    },
+    "Question": {
+      "Clear answer edit": "清空答案編輯內容",
+      "Reject question": "拒絕回答"
+    },
+    "Model": {
+      "Cycle model variant": "下一個模型變體"
+    },
+    "Providers": {
+      "Other": "其他"
+    }
+  },
+  "slash_commands": {
+    "/connect": "連結模型提供者",
+    "/compact": "壓縮會話上下文（別名: /summarize）",
+    "/details": "切換工具詳細資訊顯示",
+    "/diff": "開啟差異視圖",
+    "/editor": "開啟外部編輯器",
+    "/exit": "結束應用程式（別名: /quit, /q）",
+    "/export": "匯出會話記錄",
+    "/help": "顯示說明",
+    "/init": "建立或更新 AGENTS.md",
+    "/models": "列出可用模型（別名: /mo）",
+    "/new": "新增會話（別名: /clear）",
+    "/redo": "重做",
+    "/sessions": "切換會話（別名: /resume, /continue）",
+    "/share": "分享會話",
+    "/themes": "切換主題",
+    "/thinking": "切換思考過程可見性（別名: /toggle-thinking）",
+    "/undo": "復原上一則訊息",
+    "/unshare": "取消分享",
+    "/rename": "重新命名會話",
+    "/timeline": "跳至訊息",
+    "/fork": "分叉會話",
+    "/copy": "複製會話記錄",
+    "/agents": "切換 AI 代理",
+    "/mcps": "切換 MCP",
+    "/skills": "選擇技能",
+    "/variants": "切換模型變體",
+    "/status": "檢視狀態",
+    "/org": "切換組織（別名: /orgs, /switch-org）",
+    "/warp": "切換目前會話使用的工作區",
+    "/move": "將會話移動到另一個專案目錄",
+    "/workspaces": "管理工作區"
+  },
+  "descriptions": {
+    "Move session": "移動到另一個專案目錄",
+    "Warp": "切換目前會話使用的工作區",
+    "Previous key binding group": "顯示上一組快捷鍵提示",
+    "Next key binding group": "顯示下一組快捷鍵提示",
+    "Scroll key bindings up": "向上捲動快捷鍵提示面板",
+    "Scroll key bindings down": "向下捲動快捷鍵提示面板",
+    "Page key bindings up": "向上翻頁快捷鍵提示面板",
+    "Page key bindings down": "向下翻頁快捷鍵提示面板",
+    "First key binding": "跳至第一個快捷鍵",
+    "Last key binding": "跳至最後一個快捷鍵",
+    "Show tips": "切換提示層",
+    "Show key bindings": "切換快捷鍵提示層",
+    "Toggle key bindings layout": "在停駐和覆蓋模式之間切換快捷鍵提示",
+    "Toggle pending key preview": "在覆蓋模式下自動顯示待輸入按鍵序列的快捷鍵提示"
+  }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "opencode-i18n",
+  "version": "0.1.0",
+  "description": "OpenCode TUI i18n plugin — localize the interface into 简体中文 / 繁體中文 and more, with one-command install.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "./tui": "./plugins/i18n/index.ts",
+    "./server": "./plugins/i18n/server.ts"
+  },
+  "files": [
+    "plugins",
+    "i18n",
+    "tools",
+    "commands",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "opencode": ">=1.18.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.14.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "typescript": "^6.0.3"
+  }
+}

package/plugins/i18n/index.ts

@@ -0,0 +1,241 @@
+import type { TuiPlugin, TuiPluginApi, TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { readConfigSync, readStateSync, resolveLocale, type I18nLocaleConfig } from "../../i18n/lib.ts"
+
+type TranslationSnapshot = {
+  enabled: boolean
+  translations: Map<string, string>
+  descriptions: Map<string, string>
+  slashDescriptions: Map<string, string>
+}
+
+type KeymapCommand = {
+  name: string
+  title?: unknown
+  desc?: unknown
+  [key: string]: unknown
+}
+
+type CommandEntry = {
+  command: KeymapCommand
+  [key: string]: unknown
+}
+
+type CommandQuery = {
+  search?: unknown
+  searchIn?: unknown
+  limit?: unknown
+  filter?: unknown
+  [key: string]: unknown
+}
+
+const KEYMAP_PATCHED = "__opencodeI18nPatched"
+
+type PatchableKeymap = {
+  getCommands(query?: CommandQuery): readonly KeymapCommand[]
+  getCommandEntries(query?: CommandQuery): readonly CommandEntry[]
+}
+
+type PatchedKeymap = PatchableKeymap & {
+  [KEYMAP_PATCHED]?: boolean
+}
+
+function readEnabled() {
+  return readStateSync().enabled
+}
+
+function readLocaleConfig() {
+  const config = readConfigSync()
+  const state = readStateSync()
+  const locale = resolveLocale(config, state)
+  return locale ? config?.locales?.[locale] : undefined
+}
+
+function readTranslations(localeConfig: I18nLocaleConfig | undefined) {
+  const translations = new Map<string, string>()
+
+  for (const [category, commands] of Object.entries(localeConfig?.commands ?? {})) {
+    for (const [english, chinese] of Object.entries(commands)) {
+      if (!english || english.startsWith("_")) continue
+      if (!chinese.trim()) continue
+
+      if (translations.has(english) && category !== "Suggested") continue
+
+      translations.set(english, chinese.trim())
+    }
+  }
+
+  return translations
+}
+
+function readStringMap(values: Record<string, string> | undefined) {
+  const result = new Map<string, string>()
+
+  for (const [key, value] of Object.entries(values ?? {})) {
+    if (!key || key.startsWith("_")) continue
+    if (!value.trim()) continue
+
+    result.set(key, value.trim())
+  }
+
+  return result
+}
+
+function normalizeSlashName(name: string) {
+  const trimmed = name.trim()
+  if (!trimmed) return ""
+
+  return trimmed.startsWith("/") ? trimmed : `/${trimmed}`
+}
+
+function readSlashDescriptions(localeConfig: I18nLocaleConfig | undefined) {
+  const descriptions = new Map<string, string>()
+
+  for (const [slash, description] of Object.entries(localeConfig?.slash_commands ?? {})) {
+    if (!slash || slash.startsWith("_")) continue
+    if (!description.trim()) continue
+
+    const normalized = normalizeSlashName(slash)
+    if (normalized) descriptions.set(normalized, description.trim())
+  }
+
+  return descriptions
+}
+
+function readSnapshot(): TranslationSnapshot {
+  if (!readEnabled()) {
+    return {
+      enabled: false,
+      translations: new Map(),
+      descriptions: new Map(),
+      slashDescriptions: new Map(),
+    }
+  }
+
+  const localeConfig = readLocaleConfig()
+  const translations = readTranslations(localeConfig)
+  const descriptions = readStringMap(localeConfig?.descriptions)
+  const slashDescriptions = readSlashDescriptions(localeConfig)
+
+  return {
+    enabled: true,
+    translations,
+    descriptions,
+    slashDescriptions,
+  }
+}
+
+function commandSlashNames(command: KeymapCommand) {
+  const names: string[] = []
+
+  if (typeof command.slashName === "string") names.push(command.slashName)
+
+  if (Array.isArray(command.slashAliases)) {
+    for (const alias of command.slashAliases) {
+      if (typeof alias === "string") names.push(alias)
+    }
+  }
+
+  const slash = command.slash
+  if (slash && typeof slash === "object") {
+    const legacy = slash as { name?: unknown; aliases?: unknown }
+    if (typeof legacy.name === "string") names.push(legacy.name)
+
+    if (Array.isArray(legacy.aliases)) {
+      for (const alias of legacy.aliases) {
+        if (typeof alias === "string") names.push(alias)
+      }
+    }
+  }
+
+  return names.map(normalizeSlashName).filter(Boolean)
+}
+
+function slashDescription(command: KeymapCommand, snapshot: TranslationSnapshot) {
+  for (const name of commandSlashNames(command)) {
+    const description = snapshot.slashDescriptions.get(name)
+    if (description) return description
+  }
+
+  return undefined
+}
+
+function titleDescription(command: KeymapCommand, snapshot: TranslationSnapshot) {
+  const english = typeof command.title === "string" ? command.title : command.name
+  return snapshot.descriptions.get(english)
+}
+
+function translateCommand(command: KeymapCommand, snapshot: TranslationSnapshot) {
+  if (!snapshot.enabled) return command
+
+  const english = typeof command.title === "string" ? command.title : command.name
+  const entry = snapshot.translations.get(english)
+  const originalDescription = typeof command.desc === "string" && command.desc.trim() ? command.desc : undefined
+  const description = originalDescription ? titleDescription(command, snapshot) ?? slashDescription(command, snapshot) : undefined
+  if (!entry && !description) return command
+
+  return {
+    ...command,
+    ...(entry
+      ? {
+          title: entry,
+          i18nOriginalTitle: english,
+        }
+      : {}),
+    ...(description
+      ? {
+          desc: description,
+          i18nOriginalDesc: originalDescription,
+        }
+      : {}),
+  }
+}
+
+function translateEntries(entries: readonly CommandEntry[], snapshot: TranslationSnapshot) {
+  if (!snapshot.enabled) return entries
+
+  return entries.map((entry) => ({
+    ...entry,
+    command: translateCommand(entry.command, snapshot),
+  }))
+}
+
+function patchKeymap(api: TuiPluginApi) {
+  const keymap = api.keymap as unknown as PatchedKeymap
+  if (keymap[KEYMAP_PATCHED]) return
+
+  const getCommands = keymap.getCommands
+  const getCommandEntries = keymap.getCommandEntries
+
+  keymap.getCommands = (query?: CommandQuery) => {
+    const snapshot = readSnapshot()
+    if (!snapshot.enabled) return getCommands(query)
+
+    return getCommands(query).map((command) => translateCommand(command, snapshot))
+  }
+
+  keymap.getCommandEntries = (query?: CommandQuery) => {
+    const snapshot = readSnapshot()
+    if (!snapshot.enabled) return getCommandEntries(query)
+
+    return translateEntries(getCommandEntries(query), snapshot)
+  }
+
+  keymap[KEYMAP_PATCHED] = true
+
+  api.lifecycle.onDispose(() => {
+    keymap.getCommands = getCommands
+    keymap.getCommandEntries = getCommandEntries
+    keymap[KEYMAP_PATCHED] = false
+  })
+}
+
+const tui: TuiPlugin = async (api) => {
+  patchKeymap(api)
+}
+
+const plugin = {
+  id: "opencode-i18n",
+  tui,
+} satisfies TuiPluginModule
+
+export default plugin

package/plugins/i18n/server.ts

@@ -0,0 +1,17 @@
+import type { Plugin, PluginModule } from "@opencode-ai/plugin"
+import i18nStateTool from "../../tools/i18n-state.ts"
+
+const server: Plugin = async () => {
+  return {
+    tool: {
+      "i18n-state": i18nStateTool,
+    },
+  }
+}
+
+const plugin: PluginModule & { id: string } = {
+  id: "opencode-i18n",
+  server,
+}
+
+export default plugin