mulmoclaude 0.1.2 → 0.4.0

package/src/lang/zh.ts

@@ -0,0 +1,537 @@
+// Simplified Chinese dictionary. Mirror the shape of src/lang/en.ts —
+// missing keys fall back to English per createI18n's fallbackLocale.
+//
+// ⚠️ 包含 `<name>` 等尖括号的字符串会触发 vue-i18n 的 XSS
+// 检测,输出 "Detected HTML in '…' message" 警告。此类文案必须
+// 改用 **函数形式**。详见 en.ts 的头部注释。
+
+const zhMessages = {
+  common: {
+    save: "保存",
+    cancel: "取消",
+    loading: "加载中...",
+    close: "关闭",
+    dismiss: "关闭",
+    add: "添加",
+    remove: "移除",
+    saving: "保存中...",
+    saved: "已保存",
+    noResultsYet: "暂无结果",
+    noImageYet: "暂无图片",
+  },
+  sessionTabBar: {
+    newSession: "新建会话",
+    sessionHistory: "会话历史",
+    // 中文无单复数之分，但仍保留 `|` 分隔符以对齐 vue-i18n 的 pluralization 约定。
+    activeSessions: "{count} 个活动会话（代理运行中）",
+    unreadReplies: "{count} 条未读回复",
+  },
+  chatInput: {
+    placeholder: "输入任务,或拖放 / 粘贴 / 附加文件…",
+    expandEditor: "展开编辑器",
+    composeMessage: "撰写消息",
+    sendHint: "Cmd+Enter 发送",
+    send: "发送",
+    attachFile: "附加文件",
+    fileTooLarge: "文件过大（{sizeMB} MB）。上限为 30 MB。",
+    unsupportedFileType: "不支持的文件类型。支持:图像、PDF、DOCX、XLSX、PPTX、文本文件。",
+  },
+  sessionHistoryPanel: {
+    filters: {
+      all: "全部",
+      unread: "未读",
+      human: "人工",
+      scheduler: "调度器",
+      skill: "技能",
+      bridge: "桥接",
+    },
+    failedToRefresh: "⚠ 刷新失败: {error}",
+    showingLastKnown: " — 正在显示上一次成功加载的列表。",
+    noSessions: "暂无会话。",
+    noMatching: "没有匹配的会话。",
+    running: "运行中",
+    unread: "未读",
+    noMessages: "(无消息)",
+  },
+  notificationBell: {
+    notifications: "通知",
+    markAllRead: "全部标为已读",
+    noNotifications: "暂无通知",
+    dismiss: "关闭",
+  },
+  sidebarHeader: {
+    home: "前往最新对话",
+    toolCallHistory: "工具调用历史",
+    settings: "设置",
+  },
+  rightSidebar: {
+    toggleSystemPrompt: "切换系统提示词",
+    systemPrompt: "系统提示词",
+    availableTools: "可用工具",
+    toggleToolDescription: "切换工具说明",
+    toolCallHistory: "工具调用历史",
+    noToolCalls: "还没有工具调用",
+    arguments: "参数",
+    error: "错误",
+    result: "结果",
+    running: "运行中...",
+  },
+  fileTreePane: {
+    sort: "排序:",
+    sortByName: "按名称排序",
+    name: "名称",
+    sortByRecent: "按修改日期排序(最新在前)",
+    recent: "最近",
+    reference: "引用",
+    // "RO" = Read-Only. 保留英文缩写作为紧凑徽章。
+    readOnlyBadge: "RO",
+  },
+  fileTree: {
+    workspace: "(工作区)",
+    recentlyChanged: "最近修改",
+  },
+  lockStatusPopup: {
+    sandboxEnabledTooltip: "沙箱已启用 (Docker)",
+    noSandboxTooltip: "未启用沙箱 (未找到 Docker)",
+    sandboxEnabledLabel: "沙箱已启用:",
+    sandboxEnabledBody: "Docker 正在运行。文件系统访问已隔离。",
+    noSandboxLabel: "未启用沙箱:",
+    noSandboxBodyPrefix: "Claude 可以访问你计算机上的所有文件。请安装",
+    noSandboxBodySuffix: "以启用文件系统隔离。",
+    dockerDesktop: "Docker Desktop",
+    hostCredentials: "已附加的宿主凭据:",
+    credsLoading: "加载中…",
+    sshAgent: "SSH 代理:",
+    forwarded: "已转发",
+    notForwarded: "未转发",
+    mountedConfigs: "挂载的配置:",
+    none: "无",
+    testIsolation: "测试沙箱隔离:",
+  },
+  settingsModal: {
+    title: "设置",
+    tabs: {
+      tools: "允许的工具",
+      mcp: "MCP 服务器",
+      dirs: "目录",
+      refs: "引用目录",
+    },
+    toolNamesLabel: "工具名称",
+    invalidToolNamesPrefix: "以下工具名看起来不符合规范(预期前缀",
+    invalidToolNamesSuffix: "):",
+    mcpToolsError: "⚠ 无法获取 MCP 工具状态: {error}。无论是否启用,均显示所有工具。",
+    changesHint: "修改在下一次发送消息时生效,无需重启。",
+    cannotSaveTooltip: "设置加载失败前无法保存",
+    saving: "保存中…",
+    loadingLabel: "加载中…",
+  },
+  canvasViewToggle: {
+    stackViewTooltip: "堆叠视图 · 点击切换到单一视图 (⌘1)",
+    singleViewTooltip: "单一视图 · 点击切换到堆叠视图 (⌘2)",
+    switchToSingle: "切换到单一视图",
+    switchToStack: "切换到堆叠视图",
+  },
+  settingsWorkspaceDirs: {
+    explanation: "自定义用于在 {dataDir} 和 {artifactsDir} 下组织文件的目录。Claude 会参照这些来决定文件保存路径。",
+    noEntries: "未配置自定义目录。",
+    addDirTitle: "添加目录",
+    pathPlaceholder: "data/clients 或 artifacts/reports",
+    descPlaceholder: "说明(这个文件夹里放什么)",
+    errPathRequired: "路径不能为空",
+    errMustStartWith: "必须以 data/ 或 artifacts/ 开头",
+    errAlreadyExists: "已存在",
+  },
+  settingsReferenceDirs: {
+    explanation: "Claude 可读取但不能修改的外部目录。Docker 模式下以只读方式挂载。适合引用 Obsidian 仓库、项目代码或文档文件夹。",
+    noEntries: "未配置引用目录。",
+    addDirTitle: "添加引用目录",
+    pathPlaceholder: "/Users/me/ObsidianVault 或 ~/Documents/notes",
+    labelPlaceholder: "标签(可选 — 默认为文件夹名)",
+    readOnlyBadge: "只读",
+    errPathRequired: "路径不能为空",
+    errMustBeAbsolute: "必须为绝对路径或以 ~/ 开头",
+    errAlreadyExists: "已存在",
+    errLabelConflict: '标签 "{label}" 已存在',
+  },
+  pluginLauncher: {
+    todos: { label: "待办", title: "打开待办 (⌘4)" },
+    scheduler: { label: "日程", title: "打开日程 (⌘5)" },
+    wiki: { label: "百科", title: "打开 Wiki (⌘6)" },
+    skills: { label: "技能", title: "打开技能 (⌘7)" },
+    roles: { label: "角色", title: "打开角色 (⌘8)" },
+    files: { label: "文件", title: "打开工作区文件 (⌘3)" },
+  },
+  fileContentHeader: {
+    showRendered: "显示渲染后的 Markdown",
+    showRaw: "显示原始源代码",
+    rendered: "已渲染",
+    raw: "原始",
+    closeFile: "关闭文件",
+  },
+  fileContentRenderer: {
+    selectFile: "请选择一个文件",
+    htmlPreview: "HTML 预览",
+    pdfPreview: "PDF 预览",
+    parseError: "解析错误",
+  },
+  settingsMcpTab: {
+    explanation:
+      "添加外部 MCP 服务器。HTTP 服务器在所有模式下都可用。Stdio 服务器使用沙箱镜像中的 {npx} / {node} / {tsx};启用 Docker 时,路径必须位于工作区内。",
+    localhostRewrite: "Docker 模式下 {localhost} 会被改写为 {hostDockerInternal}。",
+    noServers: "尚未配置 MCP 服务器。",
+    enabled: "已启用",
+    urlLabel: "URL:",
+    commandLabel: "命令:",
+    dockerNonWorkspaceWarning: "⚠ 包含工作区外部的路径 — 在 Docker 内无法解析。",
+    addServerButton: "+ 添加 MCP 服务器",
+    nameLabel: "名称",
+    namePlaceholder: "my-server",
+    typeHttp: "HTTP",
+    typeStdio: "Stdio(命令)",
+    urlFieldLabel: "URL",
+    urlPlaceholder: "https://example.com/mcp",
+    commandFieldLabel: "命令",
+    argsLabel: "参数(每行一个)",
+    // Message function form — 跳过 vue-i18n 的消息编译器,
+    // 避免字面量 `@` 被解析为 linked message 引用。
+    argsPlaceholder: () => "-y\n@modelcontextprotocol/server-filesystem\n/workspace/path",
+    errNoName: "请填写名称,或输入可用于推断名称的 URL / 参数。",
+    errBadName: "名称必须以小写字母开头,且仅包含 [a-z0-9_-]。",
+    errIdExists: '服务器 id "{id}" 已存在。',
+    errBadHttpUrl: "HTTP URL 必须以 http:// 或 https:// 开头",
+  },
+  pluginScheduler: {
+    prev: "上一个",
+    today: "今天",
+    goToday: "跳到今天",
+    next: "下一个",
+    deleteItem: "删除项目",
+    closeEditor: "关闭编辑器",
+    apiError: "⚠ 更新调度器失败: {error}",
+    tabCalendar: "日历",
+    tabTasks: "任务",
+    heading: "调度器",
+    itemCount: "{count} 个项目",
+    noScheduled: "没有计划中的项目",
+    unscheduled: "未安排",
+    editItem: "编辑项目",
+    update: "更新",
+    editSource: "编辑源",
+    applyChanges: "应用更改",
+    propLabel: "{key}:",
+    moreCount: "+还有 {count} 个",
+    previewIcon: "📅",
+    previewUpcoming: "即将 {count} 个",
+    previewMore: "+ 还有 {count} 个…",
+  },
+  pluginSchedulerTasks: {
+    recommendedFrequencies: "推荐频率",
+    tableTaskType: "任务类型",
+    tableSuggestedSchedule: "建议的计划",
+    noTasks: "没有计划任务",
+    runNow: "立即运行",
+    enable: "启用",
+    disable: "停用",
+    delete: "删除",
+    nextRun: "下次: {time}",
+    originSystem: "系统",
+    originUser: "用户",
+    originSkill: "技能",
+    runFailed: "运行失败: {error}",
+    toggleFailed: "切换失败: {error}",
+    deleteFailed: "删除失败: {error}",
+  },
+  pluginCanvas: {
+    undo: "撤销",
+    redo: "重做",
+    clear: "清除",
+    styleLabel: "样式:",
+  },
+  pluginChart: {
+    untitled: "图表",
+    chartCount: "{count} 个图表",
+    chartTitle: "图表 {num}",
+    png: "PNG",
+  },
+  pluginTodo: {
+    clearFilters: "清除所有筛选",
+    deleteItem: "删除项目",
+    apiError: "⚠ 更新待办失败: {error}",
+    heading: "待办列表",
+    completedRatio: "{done}/{total} 已完成",
+    filter: "筛选:",
+    noItems: "还没有待办项",
+    noMatchingFilter: "没有项目匹配当前筛选",
+    update: "更新",
+    clearCompleted: "清除已完成",
+    clearButton: "清除 ✕",
+    deleteSymbol: "✕",
+  },
+  todoExplorer: {
+    heading: "待办",
+    doneRatio: "{done}/{total} 完成",
+    addButton: "+ 添加",
+    addColumnButton: "+ 列",
+    labels: "标签:",
+    searchPlaceholder: "搜索...",
+    clearButton: "清除 ✕",
+    clearFiltersTitle: "清除标签筛选",
+    emptyHint: '还没有待办项。点击 "+ 添加" 新建一个。',
+    addColumn: "添加列",
+    newColumnLabelField: "标签",
+    newColumnPlaceholder: "Review",
+    noMatchingFilter: "没有项目匹配当前筛选",
+  },
+  todoPreview: {
+    completedRatio: "{done}/{total} 已完成",
+    moreItems: "+ 还有 {count} 项…",
+    headerIcon: "☑",
+    doneIcon: "✓",
+    pendingIcon: "○",
+    moreLabels: "+{count}",
+  },
+  todoDialogs: {
+    addTitle: "添加待办",
+    editTitle: "编辑待办",
+    deleteButton: "删除",
+    deleteTitle: "删除此项",
+    noneOption: "— 无 —",
+    fieldText: "文本",
+    fieldNote: "备注",
+    fieldStatus: "状态",
+    fieldPriority: "优先级",
+    fieldDueDate: "截止日期",
+    fieldLabels: "标签",
+    fieldLabelsCommaSeparated: "标签(逗号分隔)",
+    textPlaceholder: "要做什么?",
+    labelsPlaceholder: "工作, 紧急",
+  },
+  todoKanban: {
+    rename: "重命名",
+    alreadyDoneColumn: "已经是完成列",
+    markAsDoneColumn: "设为完成列",
+    deleteColumn: "删除列",
+    columnActions: "列操作",
+    addCard: "+ 添加卡片",
+  },
+  todoTableList: {
+    noMatchingFilter: "没有项目匹配当前筛选",
+  },
+  pluginWiki: {
+    backToIndex: "返回目录",
+    pdf: "PDF",
+    pdfFailed: "⚠ PDF 失败",
+    tabIndex: "目录",
+    tabLog: "日志",
+    tabLint: "Lint",
+    empty: "Wiki 为空。请让 Wiki 管理器采集一个数据源。",
+    previewMore: "+ 还有 {count} 项…",
+    chatPlaceholder: "就本页提问…",
+    chatSend: "就本页开启新对话",
+  },
+  pluginPresentHtml: {
+    saveAsPdf: "另存为 PDF(打开打印对话框)",
+    pdf: "PDF",
+    untitled: "HTML 页面",
+    hideSource: "隐藏源代码 <>",
+    showSource: "显示源代码 <>",
+  },
+  pluginManageSource: {
+    titlePlaceholder: "标题(可选)",
+    heading: "信息源",
+    sourceCount: "{count} 个信息源",
+    addButton: "添加",
+    rebuildNow: "立即重建",
+    rebuilding: "重建中…",
+    typeField: "类型",
+    addingLabel: "添加中…",
+    addAndRebuild: "添加并重建",
+    emptyPickPack: "尚未注册任何信息源。可以从下方的初始包挑选、点击上方的 {addBold},或让 Claude 帮你注册。",
+    emptyAddStrong: "+ 添加",
+    registering: "注册并抓取中…",
+    removeLabel: "移除",
+    removingLabel: "移除中…",
+    todaysBrief: "今日简报",
+    todaysBriefLoading: "正在加载今日简报…",
+    briefNone: "还没有写入当天的简报。请点击 立即重建。",
+    briefEmpty: "今天的简报为空。",
+    briefLoadFailed: "简报加载失败",
+    lastRebuildSummary: "上次重建({date}): 从 {planned} 个信息源得到 {itemCount} 项,丢弃重复项 {duplicates} 个。",
+    archiveErrorsSuffix: "(归档错误 {count} 个)",
+    kindRss: "RSS",
+    kindGithubRel: "GitHub 发布",
+    kindGithubIss: "GitHub 议题",
+    kindArxiv: "arXiv",
+    kindGithubReleases: "GitHub 发布",
+    kindGithubIssues: "GitHub 议题",
+    briefDateLabel: "({date})",
+    primaryRssPlaceholder: "https://news.ycombinator.com/rss",
+    primaryGithubPlaceholder: "https://github.com/owner/repo (或 owner/repo)",
+    primaryArxivPlaceholder: "cat:cs.CL",
+    primaryRssHint: "Feed URL(RSS 2.0 / Atom / RDF)",
+    primaryGithubRelHint: "GitHub 仓库 URL 或 owner/repo — 抓取 releases",
+    primaryGithubIssHint: "GitHub 仓库 URL 或 owner/repo — 抓取 issues",
+    primaryArxivHint: "arXiv 搜索表达式(例如 cat:cs.CL 或 au:hinton)",
+    confirmRemove: '要移除信息源 "{slug}" 吗?',
+    flashRegistered: "已注册。正在抓取新项目…",
+    flashRebuildReady: "就绪: 从 {planned} 个信息源得到 {itemCount} 项。",
+    flashRebuildComplete: "重建完成: 从 {planned} 个信息源得到 {itemCount} 项。",
+    flashRebuildFailed: "重建失败: {error}",
+    flashRegisterFailed: "注册信息源失败",
+    flashRegisterSucceededRebuildFailed: "注册成功但重建失败: {error}",
+    flashRemoved: '已移除 "{slug}"。',
+    flashRemoveFailed: "移除失败: {error}",
+    flashRefreshListFailed: "刷新信息源列表失败: {error}",
+    flashPresetAlreadyRegistered: '"{label}" 中的所有信息源均已注册。',
+    flashPresetRegistered: '已从 "{label}" 注册 {count} 个信息源。正在抓取…',
+    flashPresetPartial: "已注册 {ok}/{total}。错误: {errors}",
+  },
+  pluginManageSkills: {
+    deleteProjectSkill: "删除此项目级技能",
+    heading: "技能",
+    previewCount: "{count} 个技能",
+    previewMore: "+还有 {count} 个",
+    // 使用函数形式绕过 vue-i18n 的消息编译器,否则 `<name>`
+    // 会被当作 HTML 片段,每次挂载都会触发
+    // "Detected HTML in '…' message" 警告。
+    subheading: ({ named }: { named: (key: string) => unknown }) => `${named("count")} 个可用 · 点击查看 · "Run" 会以 /<name> 的形式调用`,
+    emptyWithPath: "未找到技能。请在 {path} 下添加技能文件夹。",
+    emptySkillPath: "~/.claude/skills/",
+    selectHint: "在左侧选择一个技能以查看其 SKILL.md。",
+    loading: "加载中…",
+    fieldDescription: "说明",
+    fieldBody: "正文 (Markdown)",
+    emptyBody: "(正文为空)",
+    btnEdit: "编辑",
+    btnDelete: "删除",
+    btnRun: "运行",
+    errListFailed: "加载技能列表失败: {error}",
+    errDetailFailed: "加载技能详情失败: {error}",
+    errSaveFailed: "保存失败: {error}",
+    errDeleteFailed: "删除失败",
+    confirmDelete: '要删除技能 "{name}" 吗?将会移除 ~/mulmoclaude/.claude/skills/{name}/SKILL.md。',
+  },
+  pluginManageRoles: {
+    heading: "自定义角色",
+    roleCount: "{count} 个角色",
+    previewCount: "{count} 个自定义角色",
+    addButton: "+ 添加",
+    createPanel: "创建新角色",
+    fieldId: "ID",
+    fieldName: "名称",
+    fieldIcon: "图标",
+    fieldPrompt: "提示词",
+    fieldPlugins: "插件",
+    fieldStarterQueries: "启动提问",
+    onePerLine: "(每行一个)",
+    helpLink: "?",
+    idFormatted: "({id})",
+    missingEnv: "(缺少 {env})",
+    requiresEnv: "需要在 .env 中设置 {env}",
+    collapse: "折叠",
+    expand: "展开",
+    idPlaceholder: "unique-id",
+    creating: "创建中…",
+    create: "创建",
+    updating: "更新中…",
+    update: "更新",
+    cancel: "取消",
+    delete: "删除",
+    emptyHint: '还没有自定义角色。点击 "+ 添加" 或让 Claude 帮你创建一个。',
+    errIdRequired: "ID 不能为空。",
+    errIdInvalid: "ID 只能包含字母、数字、'-' 和 '_'。",
+    errNameRequired: "名称不能为空。",
+    errIdDuplicate: "已存在 ID 为 '{id}' 的角色。",
+    errCreateFailed: "创建失败",
+    errSaveFailed: "保存失败",
+    errDeleteFailed: "删除失败",
+    errNetworkError: "网络错误",
+    errServerError: "服务器错误: {status}",
+  },
+  pluginUiImage: {
+    promptLabel: "{label}:",
+  },
+  pluginMulmoScript: {
+    beatCount: "{count} 个 beat",
+    movie: "视频",
+    generating: "生成中…",
+    rendering: "渲染中…",
+    saving: "保存中…",
+    update: "更新",
+    characters: "角色",
+    drop: "拖放",
+    gen: "生成",
+    play: "▶ 播放",
+    stop: "■ 停止",
+    errPrefix: "⚠ 错误",
+    noBeats: "脚本中没有找到 beat",
+    editSource: "编辑脚本源",
+    applyChanges: "应用更改",
+    generateAll: "全部生成",
+    orDropImage: "或拖入图片",
+    generate: "生成",
+    generateAudio: "♪ 生成",
+    saveErrorInvalidJson: "⚠ JSON 无效: {error}",
+    saveErrorSaveFailed: "⚠ 保存失败: {error}",
+  },
+  pluginMarkdown: {
+    loading: "正在加载文档...",
+    loadFailed: "⚠ 加载文档失败: {error}",
+    refreshFailed: "⚠ 刷新文档失败: {error} — 正在显示上次成功加载的内容。",
+    noContent: "没有可用的 Markdown 内容",
+    pdf: "PDF",
+    pdfFailedShort: "⚠ PDF 失败",
+    editSource: "编辑 Markdown 源",
+    saving: "保存中...",
+    applyChanges: "应用更改",
+    cancel: "取消",
+    saveFailed: "保存失败: {error}",
+    saveError: "⚠ 保存失败: {error}",
+    copyLabel: "复制",
+    copiedLabel: "已复制!",
+  },
+  pluginTextResponse: {
+    pdf: "PDF",
+    pdfFailed: "⚠ PDF 失败",
+    editContent: "编辑文本内容",
+    applyChanges: "应用更改",
+    copyLabel: "复制",
+    copiedLabel: "已复制!",
+    cancel: "取消",
+  },
+  pluginSpreadsheet: {
+    previewLabel: "📊 电子表格",
+    previewUntitled: "电子表格",
+    previewSheets: "{count} 个工作表",
+    untitled: "电子表格",
+    excel: "Excel",
+    valuePlaceholder: "值",
+    valueOrFormulaPlaceholder: "值或公式(例如 100 或 SUM(B2:B11))",
+    formatPlaceholder: "格式(例如 $#,##0.00)",
+    loading: "正在加载电子表格...",
+    noData: "没有可用的电子表格数据",
+    editData: "编辑电子表格数据",
+    applyChanges: "应用更改",
+    update: "更新",
+    stringType: "字符串",
+    formulaType: "公式",
+  },
+  app: {
+    // `<i18n-t>` 插槽 — 命名为 `envKey` / `envFile`,在 App.vue 中作为
+    // 行内 `<code>` 渲染,因此字面的变量名和文件名保持不翻译。
+    geminiRequired: "图像生成需要 {envKey}。请将它加入 {envFile} 并重启应用。",
+    startConversation: "开始对话",
+  },
+  suggestionsPanel: {
+    suggestions: "建议",
+    sendEditHint: "点击发送 · shift+点击可编辑",
+  },
+  settingsToolsTab: {
+    // 通过 <i18n-t> 以命名插槽 `allowedTools` 和 `claudeMcp` 渲染,
+    // 以便保留 `<code>` 标签的样式,同时文本可本地化。
+    explanation:
+      "要通过 {allowedTools} 传递给 Claude 的额外工具名。每行一个。适用于在 {claudeMcp} 完成授权后,调用 Claude Code 内置的 MCP 服务器(如 Gmail / Google 日历)。",
+  },
+};
+
+export default zhMessages;

package/src/lib/vue-i18n.ts

@@ -0,0 +1,97 @@
+// vue-i18n setup.
+//
+// Locale resolution priority (highest → lowest):
+//   1. `VITE_LOCALE` env var — explicit build-time / dev override
+//      (e.g. `VITE_LOCALE=ja yarn dev`)
+//   2. Browser language list (`navigator.languages` falling back to
+//      `navigator.language`) — the browser inherits this from the OS,
+//      so Japanese-machine users get Japanese automatically without
+//      extra config. First entry that matches a supported locale wins.
+//   3. Hard default `"en"`
+//
+// Language tags like `"ja-JP"` are matched by primary subtag, so
+// `ja-JP`, `ja-Hira-JP`, etc. all collapse to `"ja"`. Unknown tags
+// (`"fr-FR"`) skip to the next candidate.
+//
+// `legacy: false` switches vue-i18n to the Composition API mode, so
+// components call `const { t } = useI18n()` instead of relying on
+// the Options API `this.$t`. CLAUDE.md mandates Composition API.
+
+import { createI18n } from "vue-i18n";
+import enMessages from "../lang/en";
+import jaMessages from "../lang/ja";
+import zhMessages from "../lang/zh";
+import koMessages from "../lang/ko";
+import esMessages from "../lang/es";
+import ptBRMessages from "../lang/pt-BR";
+import frMessages from "../lang/fr";
+import deMessages from "../lang/de";
+
+// Schema generic on createI18n — this is what makes `t("common.save")`
+// calls across the whole app compile-time checked (the module
+// augmentation in src/types/vue-i18n.d.ts alone is not enough; vue-i18n
+// v11's `t` overloads still fall back to `string` unless the schema is
+// threaded through here).
+type MessageSchema = typeof enMessages;
+type Locale = "en" | "ja" | "zh" | "ko" | "es" | "pt-BR" | "fr" | "de";
+
+const SUPPORTED_LOCALES: readonly Locale[] = ["en", "ja", "zh", "ko", "es", "pt-BR", "fr", "de"] as const;
+const DEFAULT_LOCALE: Locale = "en";
+
+function isSupported(tag: string): tag is Locale {
+  return (SUPPORTED_LOCALES as readonly string[]).includes(tag);
+}
+
+// Match the full tag first (so `pt-BR` resolves exactly), then collapse
+// `ja-JP`, `ja-Hira-JP`, etc. to their primary subtag. Returns null when
+// neither the full tag nor the primary subtag is supported.
+function primarySubtagIfSupported(tag: string): Locale | null {
+  if (isSupported(tag)) return tag;
+  const lower = tag.toLowerCase();
+  for (const supported of SUPPORTED_LOCALES) {
+    if (supported.toLowerCase() === lower) return supported;
+  }
+  const primary = lower.split("-")[0];
+  return isSupported(primary) ? primary : null;
+}
+
+function detectLocale(): Locale {
+  // 1. explicit env override
+  const envLocale = import.meta.env.VITE_LOCALE;
+  if (typeof envLocale === "string" && isSupported(envLocale)) {
+    return envLocale;
+  }
+
+  // 2. browser / OS preference list
+  if (typeof navigator !== "undefined") {
+    const preferred = navigator.languages && navigator.languages.length > 0 ? navigator.languages : [navigator.language];
+    for (const tag of preferred) {
+      if (typeof tag !== "string") continue;
+      const match = primarySubtagIfSupported(tag);
+      if (match) return match;
+    }
+  }
+
+  // 3. hard default
+  return DEFAULT_LOCALE;
+}
+
+const locale = detectLocale();
+
+const i18n = createI18n<[MessageSchema], Locale>({
+  legacy: false,
+  locale,
+  fallbackLocale: "en",
+  messages: {
+    en: enMessages,
+    ja: jaMessages,
+    zh: zhMessages,
+    ko: koMessages,
+    es: esMessages,
+    "pt-BR": ptBRMessages,
+    fr: frMessages,
+    de: deMessages,
+  },
+});
+
+export default i18n;

package/src/main.ts

@@ -2,6 +2,7 @@ import { createApp } from "vue";
 import App from "./App.vue";
 import router from "./router/index";
 import { installGuards } from "./router/guards";
+import i18n from "./lib/vue-i18n";
 import { setAuthToken } from "./utils/api";
 import { readAuthTokenFromMeta } from "./utils/dom/authTokenMeta";
 import "./index.css";
@@ -22,4 +23,5 @@ installGuards(router);
 
 const app = createApp(App);
 app.use(router);
+app.use(i18n);
 app.mount("#app");