feat(admin): i18n migration — extract hardcoded zh-CN strings via translate()

Move literal UI strings across all admin features into en-US/zh-CN
resource bundles and route them through the new `~/i18n/translate`
helper, enabling runtime locale switching via UI_LOCALE_STORAGE_KEY.

Author: Innei

apps/admin/src/api/auth.ts

@@ -1,5 +1,6 @@
 import type { TokenModel } from '~/models/token'
 
+import { translate } from '~/i18n/translate'
 import { authClient } from '~/utils/authjs/auth'
 
 import { getJson, postJson, requestJson } from './http'
@@ -52,7 +53,8 @@ export function authAsOwner() {
 
 export async function listPasskeys() {
   const result = await authClient.passkey.listUserPasskeys()
-  if (result.error) throw new Error(result.error.message || '获取 Passkey 失败')
+  if (result.error)
+    throw new Error(result.error.message || translate('api.error.passkeyFetch'))
 
   return (result.data ?? []).map((passkey: any) => ({
     createdAt: String(passkey.createdAt ?? new Date().toISOString()),
@@ -65,5 +67,8 @@ export async function listPasskeys() {
 
 export async function deletePasskey(id: string) {
   const result = await authClient.passkey.deletePasskey({ id })
-  if (result.error) throw new Error(result.error.message || '删除 Passkey 失败')
+  if (result.error)
+    throw new Error(
+      result.error.message || translate('api.error.passkeyDelete'),
+    )
 }

apps/admin/src/api/dependencies.ts

@@ -1,4 +1,5 @@
 import { API_URL } from '../constants/env'
+import { translate } from '../i18n/translate'
 import { getJson } from './http'
 
 export interface DependencyGraph {
@@ -36,7 +37,7 @@ export async function getNpmPackageLatest(name: string) {
   )
 
   if (!response.ok) {
-    throw new Error(`获取 ${name} 最新版本失败`)
+    throw new Error(translate('api.error.npmLatest', { name }))
   }
 
   return (await response.json()) as NpmPackageLatest

apps/admin/src/api/files.ts

@@ -1,4 +1,5 @@
 import { API_URL } from '~/constants/env'
+import { translate } from '~/i18n/translate'
 
 import { deleteJson, getJson, patchJson, requestJson } from './http'
 
@@ -129,7 +130,7 @@ export function uploadFileWithProgress(
       resolve(readUploadResponse(responseData))
     }
 
-    xhr.onerror = () => reject(new Error('上传失败'))
+    xhr.onerror = () => reject(new Error(translate('api.error.uploadFailed')))
     xhr.send(formData)
   })
 }

apps/admin/src/api/github-repo.ts

@@ -1,3 +1,5 @@
+import { translate } from '../i18n/translate'
+
 const endpoint = 'https://api.github.com/'
 
 export interface GithubRepo {
@@ -13,7 +15,7 @@ interface GithubReadme {
 
 export async function getRepoDetail(owner: string, repo: string) {
   const response = await fetch(`${endpoint}repos/${owner}/${repo}`)
-  if (!response.ok) throw new Error('获取 GitHub 仓库信息失败')
+  if (!response.ok) throw new Error(translate('api.error.githubRepo'))
 
   return response.json() as Promise<GithubRepo>
 }

apps/admin/src/api/github-snippets.ts

@@ -1,3 +1,5 @@
+import { translate } from '../i18n/translate'
+
 interface GitHubContentItem {
   download_url?: string | null
   html_url?: string | null
@@ -15,7 +17,7 @@ export async function fetchGitHubSnippetTree(path = '') {
   const response = await fetch(target)
 
   if (!response.ok) {
-    throw new Error('获取 GitHub Snippets 仓库失败')
+    throw new Error(translate('api.error.githubSnippets'))
   }
 
   return (await response.json()) as GitHubContentItem[] | GitHubContentItem
@@ -25,7 +27,7 @@ export async function fetchGitHubText(downloadUrl: string) {
   const response = await fetch(downloadUrl)
 
   if (!response.ok) {
-    throw new Error('获取文件内容失败')
+    throw new Error(translate('api.error.fetchFile'))
   }
 
   return response.text()

apps/admin/src/features/_shared/components/content-list-item.tsx

@@ -9,6 +9,7 @@ import type {
   Ref,
 } from 'react'
 
+import { useI18n } from '~/i18n'
 import { ContextMenuTrigger, showContextMenu } from '~/ui/overlay/context-menu'
 import { Checkbox } from '~/ui/primitives/checkbox'
 import { cn } from '~/utils/cn'
@@ -54,6 +55,7 @@ const INTERACTIVE_SELECTOR =
  * single / toggle (`$mod`+click) / range (`Shift`+click) selection.
  */
 export function ContentEntryListItem(props: ContentEntryListItemProps) {
+  const { t } = useI18n()
   const selectable = Boolean(props.checkboxLabel && props.onSelectedChange)
   const handleSelectedChange = props.onSelectedChange ?? (() => {})
 
@@ -154,7 +156,10 @@ export function ContentEntryListItem(props: ContentEntryListItemProps) {
           >
             <ExternalLink aria-hidden="true" className="size-4" />
           </ActionLink>
-          <ActionButton onClick={onMoreClick} title="更多操作">
+          <ActionButton
+            onClick={onMoreClick}
+            title={t('shared.contentListItem.moreActions')}
+          >
             <MoreHorizontal aria-hidden="true" className="size-4" />
           </ActionButton>
         </div>

apps/admin/src/features/_shared/components/content-list-toolbar.tsx

@@ -4,6 +4,7 @@ import { useEffect } from 'react'
 import type { FormEventHandler, ReactNode } from 'react'
 
 import { APP_SHELL_HEADER_HEIGHT_CLASS } from '~/constants/layout'
+import { useI18n } from '~/i18n'
 import { PortalLayerScope, useFloatingZ } from '~/ui/feedback/portal-layer'
 import { MobileHamburger } from '~/ui/layout/mobile-hamburger'
 import { useShellNav } from '~/ui/layout/shell-nav-context'
@@ -80,6 +81,7 @@ export function ContentListHeader(props: {
 }
 
 export function ContentListToolbar(props: ContentListToolbarProps) {
+  const { t } = useI18n()
   const selection = props.selection
   const selectedCount = selection?.selectedCount ?? 0
   const hasSelection = selectedCount > 0
@@ -111,7 +113,7 @@ export function ContentListToolbar(props: ContentListToolbarProps) {
         />
         {props.hasSearch ? (
           <button
-            aria-label="清除搜索"
+            aria-label={t('shared.contentListToolbar.clearSearch')}
             className="absolute right-3 top-1/2 inline-flex size-4 -translate-y-1/2 items-center justify-center rounded text-neutral-400 transition-colors hover:bg-neutral-100 hover:text-neutral-700 dark:hover:bg-neutral-800 dark:hover:text-neutral-200"
             onClick={props.onClearSearch}
             type="button"
@@ -211,6 +213,7 @@ interface SortMenuProps<TField extends string = string> {
 export function SortMenu<TField extends string = string>(
   props: SortMenuProps<TField>,
 ) {
+  const { t } = useI18n()
   const activeOption = props.options.find(
     (option) => option.value === props.field,
   )
@@ -220,7 +223,7 @@ export function SortMenu<TField extends string = string>(
   return (
     <Popover.Root>
       <Popover.Trigger
-        aria-label="排序"
+        aria-label={t('shared.sortMenu.label')}
         className={cn(
           'outline-hidden inline-flex h-7 shrink-0 items-center gap-1.5 rounded px-2 text-xs text-neutral-700 transition-colors hover:bg-neutral-100 focus-visible:ring-2 focus-visible:ring-[var(--color-primary-shallow)] disabled:cursor-not-allowed disabled:opacity-60 data-[popup-open]:bg-neutral-100 dark:text-neutral-200 dark:hover:bg-neutral-900 dark:data-[popup-open]:bg-neutral-900',
           props.className,
@@ -229,7 +232,9 @@ export function SortMenu<TField extends string = string>(
         type="button"
       >
         <ArrowUpDown aria-hidden="true" className="size-3.5 text-neutral-400" />
-        <span className="truncate">{activeOption?.label ?? '排序'}</span>
+        <span className="truncate">
+          {activeOption?.label ?? t('shared.sortMenu.label')}
+        </span>
         <OrderIcon aria-hidden="true" className="size-3 text-neutral-400" />
       </Popover.Trigger>
       <Popover.Portal>
@@ -242,7 +247,7 @@ export function SortMenu<TField extends string = string>(
           <PortalLayerScope depth={depth}>
             <Popover.Popup className="outline-hidden w-48 rounded border border-neutral-200 bg-white p-1 text-xs shadow-lg dark:border-neutral-800 dark:bg-neutral-950">
               <div className="px-2 py-1 text-[10px] font-medium uppercase tracking-wide text-neutral-400 dark:text-neutral-500">
-                字段
+                {t('shared.sortMenu.field')}
               </div>
               {props.options.map((option) => {
                 const active = option.value === props.field
@@ -272,21 +277,21 @@ export function SortMenu<TField extends string = string>(
               })}
               <div className="mx-1 my-1 border-t border-neutral-100 dark:border-neutral-800" />
               <div className="px-2 py-1 text-[10px] font-medium uppercase tracking-wide text-neutral-400 dark:text-neutral-500">
-                方向
+                {t('shared.sortMenu.direction')}
               </div>
               <div className="grid grid-cols-2 gap-1 p-1">
                 <SortOrderButton
                   active={props.order === 'desc'}
                   icon={<ArrowDown aria-hidden="true" className="size-3.5" />}
-                  label="降序"
+                  label={t('shared.sortMenu.desc')}
                   onClick={() =>
                     props.onChange({ field: props.field, order: 'desc' })
                   }
                 />
                 <SortOrderButton
                   active={props.order === 'asc'}
                   icon={<ArrowUp aria-hidden="true" className="size-3.5" />}
-                  label="升序"
+                  label={t('shared.sortMenu.asc')}
                   onClick={() =>
                     props.onChange({ field: props.field, order: 'asc' })
                   }

apps/admin/src/features/_shared/components/ip-info-popover.tsx

@@ -4,6 +4,7 @@ import { useState } from 'react'
 import type { ReactNode } from 'react'
 
 import { callBuiltInFunction } from '~/api/system'
+import { useI18n } from '~/i18n'
 import { PortalLayerScope, useFloatingZ } from '~/ui/feedback/portal-layer'
 
 interface IpInfo {
@@ -26,6 +27,7 @@ export function IpInfoPopover(props: {
   ip: string
   trigger?: ReactNode
 }) {
+  const { t } = useI18n()
   const [info, setInfo] = useState<IpInfo | null>(
     () => ipInfoCache.get(props.ip) ?? null,
   )
@@ -47,7 +49,11 @@ export function IpInfoPopover(props: {
       ipInfoCache.set(props.ip, result)
       setInfo(result)
     } catch (loadError) {
-      setError(loadError instanceof Error ? loadError.message : '获取失败')
+      setError(
+        loadError instanceof Error
+          ? loadError.message
+          : t('shared.ipInfo.fetchFailed'),
+      )
     } finally {
       setLoading(false)
     }
@@ -86,24 +92,32 @@ export function IpInfoPopover(props: {
           <PortalLayerScope depth={depth}>
             <Popover.Popup className="outline-hidden w-72 rounded border border-neutral-200 bg-white p-3 text-xs text-neutral-600 shadow-xl dark:border-neutral-800 dark:bg-neutral-950 dark:text-neutral-300">
               {loading ? (
-                <span className="text-neutral-400">获取中...</span>
+                <span className="text-neutral-400">
+                  {t('shared.ipInfo.loading')}
+                </span>
               ) : error ? (
                 <span className="text-red-500">{error}</span>
               ) : info ? (
                 <div className="grid gap-2">
                   <InfoRow label="IP" value={info.ip || props.ip} />
                   <InfoRow
-                    label="城市"
+                    label={t('shared.ipInfo.label.city')}
                     value={
                       [info.countryName, info.regionName, info.cityName]
                         .filter(Boolean)
                         .join(' - ') || 'N/A'
                     }
                   />
-                  <InfoRow label="ISP" value={info.ispDomain || 'N/A'} />
-                  <InfoRow label="组织" value={info.ownerDomain || 'N/A'} />
                   <InfoRow
-                    label="范围"
+                    label={t('shared.ipInfo.label.isp')}
+                    value={info.ispDomain || 'N/A'}
+                  />
+                  <InfoRow
+                    label={t('shared.ipInfo.label.org')}
+                    value={info.ownerDomain || 'N/A'}
+                  />
+                  <InfoRow
+                    label={t('shared.ipInfo.label.range')}
                     value={
                       info.range
                         ? [info.range.from, info.range.to]
@@ -114,7 +128,9 @@ export function IpInfoPopover(props: {
                   />
                 </div>
               ) : (
-                <span className="text-neutral-400">暂无信息</span>
+                <span className="text-neutral-400">
+                  {t('shared.ipInfo.empty')}
+                </span>
               )}
             </Popover.Popup>
           </PortalLayerScope>