@liujitcn/kratos-admin-system 0.0.27 → 0.0.29

package/dist/package/src/views/base/dict/index.vue

@@ -20,9 +20,9 @@
       @confirm="handleSubmit"
       @close="handleCloseDialog"
     >
-      <template #translations>
-        <DynamicTranslationEditor
-          v-model="translationValues"
+      <template #i18ns>
+        <DynamicI18nEditor
+          v-model="i18nValues"
           :source="formData.name"
           :maxlength="50"
         />
@@ -50,17 +50,17 @@ import { loadEnabledBaseLanguages } from "@liujitcn/kratos-admin-system/api/syst
 import type { BaseDict, BaseDictForm, PageBaseDictRequest } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_dict";
 import router, { navigateTo } from "@liujitcn/kratos-admin-core/navigation";
 import { Status } from "@liujitcn/kratos-admin-system/rpc/common/v1/enum";
-import { TranslationTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
+import { I18nTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
 import { buildPageRequest, normalizeSelectedIds } from "@liujitcn/kratos-admin-core/table";
 import { t } from "@liujitcn/kratos-admin-core";
-import DynamicTranslationEditor from "@liujitcn/kratos-admin-system/components/DynamicTranslationEditor.vue";
-import DynamicTranslationCell from "@liujitcn/kratos-admin-system/components/DynamicTranslationCell.vue";
+import DynamicI18nEditor from "@liujitcn/kratos-admin-system/components/DynamicI18nEditor.vue";
+import DynamicI18nCell from "@liujitcn/kratos-admin-system/components/DynamicI18nCell.vue";
 import {
-  normalizeDynamicTranslations,
-  serializeDynamicTranslations,
-  type DynamicTranslationRecord,
-  type DynamicTranslationValue
-} from "@liujitcn/kratos-admin-system/components/dynamicTranslation";
+  normalizeDynamicI18ns,
+  serializeDynamicI18ns,
+  type DynamicI18nRecord,
+  type DynamicI18nValue
+} from "@liujitcn/kratos-admin-system/components/dynamicI18n";
 
 defineOptions({
   name: "BaseDict",
@@ -70,7 +70,7 @@ defineOptions({
 const { BUTTONS } = useAuthButtons();
 const proTable = ref<ProTableInstance>();
 const formDialogRef = ref<InstanceType<typeof FormDialog>>();
-const translationValues = ref<DynamicTranslationValue[]>(normalizeDynamicTranslations(undefined, "name"));
+const i18nValues = ref<DynamicI18nValue[]>(normalizeDynamicI18ns(undefined, "name"));
 const dialog = reactive({
   editing: false,
   visible: false
@@ -84,7 +84,7 @@ const formData = reactive<BaseDictForm>({
   /** 字典名称 */
   name: "",
   /** 非主语言翻译 */
-  translations: [],
+  i18ns: [],
   /** 状态 */
   status: Status.STATUS_ENABLE
 });
@@ -134,18 +134,18 @@ const formFields = computed<ProFormField[]>(() => [
     component: "input",
     props: { placeholder: t("system.base.dict.placeholder.code") }
   },
-  { prop: "translations", label: t("system.base.translation.field.translations"), component: "slot", slotName: "translations" },
+  { prop: "i18ns", label: t("system.base.i18n.field.i18ns"), component: "slot", slotName: "i18ns" },
   { prop: "status", label: t("common.field.status"), component: "radio-group", options: statusOptions.value }
 ]);
 
 /** 渲染字典名称翻译预览，并复用当前页面的编辑弹窗。 */
 function renderDictNameCell(scope: RenderScope<BaseDict>) {
   const row = scope.row;
-  return h(DynamicTranslationCell, {
+  return h(DynamicI18nCell, {
     source: row.name,
-    targetType: TranslationTargetType.TRANSLATION_TARGET_TYPE_BASE_DICT,
+    targetType: I18nTargetType.I18N_TARGET_TYPE_BASE_DICT,
     targetId: row.id,
-    translations: row.translations
+    i18ns: row.i18ns
   });
 }
 
@@ -261,7 +261,7 @@ async function handleOpenDialog(dictId?: number) {
 
   const data = await defBaseDictService.GetBaseDict({ id: dictId });
   Object.assign(formData, data);
-  translationValues.value = normalizeDynamicTranslations(data.translations as DynamicTranslationRecord[], "name");
+  i18nValues.value = normalizeDynamicI18ns(data.i18ns as DynamicI18nRecord[], "name");
 }
 
 /**
@@ -281,9 +281,9 @@ function resetForm() {
   formData.id = 0;
   formData.code = "";
   formData.name = "";
-  formData.translations = [];
+  formData.i18ns = [];
   formData.status = Status.STATUS_ENABLE;
-  translationValues.value = normalizeDynamicTranslations(undefined, "name");
+  i18nValues.value = normalizeDynamicI18ns(undefined, "name");
 }
 
 /**
@@ -294,9 +294,9 @@ function handleSubmit() {
     if (!isValid) return;
 
     const submitData = JSON.parse(JSON.stringify(formData)) as BaseDictForm;
-    submitData.translations = serializeDynamicTranslations(
-      translationValues.value,
-      TranslationTargetType.TRANSLATION_TARGET_TYPE_BASE_DICT,
+    submitData.i18ns = serializeDynamicI18ns(
+      i18nValues.value,
+      I18nTargetType.I18N_TARGET_TYPE_BASE_DICT,
       submitData.id
     );
     const request = submitData.id

package/dist/package/src/views/base/dict/item.vue

@@ -35,9 +35,9 @@
           </el-radio-group>
         </div>
       </template>
-      <template #translations>
-        <DynamicTranslationEditor
-          v-model="translationValues"
+      <template #i18ns>
+        <DynamicI18nEditor
+          v-model="i18nValues"
           :source="formData.label"
           :maxlength="100"
         />
@@ -69,17 +69,17 @@ import type {
   PageBaseDictItemRequest
 } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_dict";
 import { Status } from "@liujitcn/kratos-admin-system/rpc/common/v1/enum";
-import { TranslationTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
+import { I18nTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
 import { buildPageRequest, normalizeSelectedIds } from "@liujitcn/kratos-admin-core/table";
 import { t } from "@liujitcn/kratos-admin-core";
-import DynamicTranslationEditor from "@liujitcn/kratos-admin-system/components/DynamicTranslationEditor.vue";
-import DynamicTranslationCell from "@liujitcn/kratos-admin-system/components/DynamicTranslationCell.vue";
+import DynamicI18nEditor from "@liujitcn/kratos-admin-system/components/DynamicI18nEditor.vue";
+import DynamicI18nCell from "@liujitcn/kratos-admin-system/components/DynamicI18nCell.vue";
 import {
-  normalizeDynamicTranslations,
-  serializeDynamicTranslations,
-  type DynamicTranslationRecord,
-  type DynamicTranslationValue
-} from "@liujitcn/kratos-admin-system/components/dynamicTranslation";
+  normalizeDynamicI18ns,
+  serializeDynamicI18ns,
+  type DynamicI18nRecord,
+  type DynamicI18nValue
+} from "@liujitcn/kratos-admin-system/components/dynamicI18n";
 
 defineOptions({
   name: "BaseDictItem",
@@ -90,7 +90,7 @@ const route = useRoute();
 const { BUTTONS } = useAuthButtons();
 const proTable = ref<ProTableInstance>();
 const formDialogRef = ref<InstanceType<typeof FormDialog>>();
-const translationValues = ref<DynamicTranslationValue[]>(normalizeDynamicTranslations(undefined, "label"));
+const i18nValues = ref<DynamicI18nValue[]>(normalizeDynamicI18ns(undefined, "label"));
 
 const dictId = ref(Number(route.query.dictId ?? 0));
 
@@ -109,7 +109,7 @@ const formData = reactive<BaseDictItemForm>({
   /** 字典项标签 */
   label: "",
   /** 非主语言翻译 */
-  translations: [],
+  i18ns: [],
   /** 标签类型 */
   tag_type: "",
   /** 排序 */
@@ -158,10 +158,10 @@ const formFields = computed<ProFormField[]>(() => [
     props: { placeholder: t("system.base.dict.item.placeholder.value") }
   },
   {
-    prop: "translations",
-    label: t("system.base.translation.field.translations"),
+    prop: "i18ns",
+    label: t("system.base.i18n.field.i18ns"),
     component: "slot",
-    slotName: "translations",
+    slotName: "i18ns",
     colSpan: 24
   },
   {
@@ -202,11 +202,11 @@ function renderTagTypeCell(scope: RenderScope<BaseDictItem>) {
 /** 渲染字典项标签翻译预览，并复用当前页面的编辑弹窗。 */
 function renderDictItemLabelCell(scope: RenderScope<BaseDictItem>) {
   const row = scope.row;
-  return h(DynamicTranslationCell, {
+  return h(DynamicI18nCell, {
     source: row.label,
-    targetType: TranslationTargetType.TRANSLATION_TARGET_TYPE_BASE_DICT_ITEM,
+    targetType: I18nTargetType.I18N_TARGET_TYPE_BASE_DICT_ITEM,
     targetId: row.id,
-    translations: row.translations
+    i18ns: row.i18ns
   });
 }
 
@@ -330,7 +330,7 @@ async function handleOpenDialog(dictItemId?: number) {
 
   const data = await defBaseDictService.GetBaseDictItem({ id: dictItemId });
   Object.assign(formData, data);
-  translationValues.value = normalizeDynamicTranslations(data.translations as DynamicTranslationRecord[], "label");
+  i18nValues.value = normalizeDynamicI18ns(data.i18ns as DynamicI18nRecord[], "label");
 }
 
 /**
@@ -351,11 +351,11 @@ function resetForm() {
   formData.dict_id = dictId.value;
   formData.value = "";
   formData.label = "";
-  formData.translations = [];
+  formData.i18ns = [];
   formData.tag_type = "";
   formData.sort = 1;
   formData.status = Status.STATUS_ENABLE;
-  translationValues.value = normalizeDynamicTranslations(undefined, "label");
+  i18nValues.value = normalizeDynamicI18ns(undefined, "label");
 }
 
 /**
@@ -367,9 +367,9 @@ function handleSubmit() {
 
     formData.dict_id = dictId.value;
     const submitData = JSON.parse(JSON.stringify(formData)) as BaseDictItemForm;
-    submitData.translations = serializeDynamicTranslations(
-      translationValues.value,
-      TranslationTargetType.TRANSLATION_TARGET_TYPE_BASE_DICT_ITEM,
+    submitData.i18ns = serializeDynamicI18ns(
+      i18nValues.value,
+      I18nTargetType.I18N_TARGET_TYPE_BASE_DICT_ITEM,
       submitData.id
     );
     const request = submitData.id

package/dist/package/src/views/base/menu/index.vue

@@ -31,9 +31,9 @@
         <SelectIcon v-model:icon-value="menuIconValue" :placeholder="t('system.base.menu.placeholder.icon')" />
       </template>
 
-      <template #translations>
-        <DynamicTranslationEditor
-          v-model="translationValues"
+      <template #i18ns>
+        <DynamicI18nEditor
+          v-model="i18nValues"
           :source="formData.meta.title"
           :maxlength="100"
         />
@@ -79,17 +79,17 @@ import type {
 } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_menu";
 import { Status } from "@liujitcn/kratos-admin-system/rpc/common/v1/enum";
 import { BaseMenuType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/common";
-import { TranslationTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
+import { I18nTargetType } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
 import { normalizeSelectedIds } from "@liujitcn/kratos-admin-core/table";
 import { t } from "@liujitcn/kratos-admin-core";
-import DynamicTranslationEditor from "@liujitcn/kratos-admin-system/components/DynamicTranslationEditor.vue";
-import DynamicTranslationCell from "@liujitcn/kratos-admin-system/components/DynamicTranslationCell.vue";
+import DynamicI18nEditor from "@liujitcn/kratos-admin-system/components/DynamicI18nEditor.vue";
+import DynamicI18nCell from "@liujitcn/kratos-admin-system/components/DynamicI18nCell.vue";
 import {
-  normalizeDynamicTranslations,
-  serializeDynamicTranslations,
-  type DynamicTranslationRecord,
-  type DynamicTranslationValue
-} from "@liujitcn/kratos-admin-system/components/dynamicTranslation";
+  normalizeDynamicI18ns,
+  serializeDynamicI18ns,
+  type DynamicI18nRecord,
+  type DynamicI18nValue
+} from "@liujitcn/kratos-admin-system/components/dynamicI18n";
 
 defineOptions({
   name: "BaseMenu",
@@ -113,7 +113,7 @@ const menuOptions = ref<ProFormOption[]>([]);
 const parentMenuTypeMap = ref(new Map<number, BaseMenuType>());
 const appMenuIds = ref(new Set<number>([APP_MENU_ROOT_ID]));
 const apiList = ref<BaseApi[]>([]);
-const translationValues = ref<DynamicTranslationValue[]>(normalizeDynamicTranslations(undefined, "title"));
+const i18nValues = ref<DynamicI18nValue[]>(normalizeDynamicI18ns(undefined, "title"));
 
 const dialog = reactive({
   editing: false,
@@ -159,7 +159,7 @@ function createDefaultMenuForm(): MenuFormState {
     redirect: "",
     meta: createDefaultMenuMeta(),
     api: [],
-    translations: [],
+    i18ns: [],
     sort: 1,
     status: Status.STATUS_ENABLE
   };
@@ -294,11 +294,11 @@ function renderHiddenCell(scope: RenderScope<BaseMenu>) {
 /** 渲染菜单标题翻译预览，并复用当前页面的编辑弹窗。 */
 function renderMenuTitleCell(scope: RenderScope<BaseMenu>) {
   const row = scope.row;
-  return h(DynamicTranslationCell, {
+  return h(DynamicI18nCell, {
     source: row.meta?.title ?? "",
-    targetType: TranslationTargetType.TRANSLATION_TARGET_TYPE_BASE_MENU,
+    targetType: I18nTargetType.I18N_TARGET_TYPE_BASE_MENU,
     targetId: row.id,
-    translations: row.translations
+    i18ns: row.i18ns
   });
 }
 
@@ -468,10 +468,10 @@ const formFields = computed<ProFormField[]>(() => [
     })
   },
   {
-    prop: "translations",
-    label: t("system.base.translation.field.translations"),
+    prop: "i18ns",
+    label: t("system.base.i18n.field.i18ns"),
     component: "slot",
-    slotName: "translations",
+    slotName: "i18ns",
     colSpan: 24
   },
   {
@@ -999,9 +999,9 @@ function buildMenuOptions(menuList: BaseMenu[] = []) {
 /** 根据菜单类型清理无效字段，避免提交脏数据。 */
 function buildSubmitPayload(): BaseMenuForm {
   const payload = normalizeMenuForm(formData);
-  payload.translations = serializeDynamicTranslations(
-    translationValues.value,
-    TranslationTargetType.TRANSLATION_TARGET_TYPE_BASE_MENU,
+  payload.i18ns = serializeDynamicI18ns(
+    i18nValues.value,
+    I18nTargetType.I18N_TARGET_TYPE_BASE_MENU,
     payload.id
   );
   // 一级菜单在表单中保持空白，提交时仍按接口约定传回根节点标识。
@@ -1145,7 +1145,7 @@ function resetForm(data?: Partial<BaseMenuForm>) {
   formDialogRef.value?.resetFields();
   formDialogRef.value?.clearValidate();
   Object.assign(formData, normalizeMenuForm(data));
-  translationValues.value = normalizeDynamicTranslations(data?.translations as DynamicTranslationRecord[] | undefined, "title");
+  i18nValues.value = normalizeDynamicI18ns(data?.i18ns as DynamicI18nRecord[] | undefined, "title");
 }
 
 /** 提交菜单表单，并在成功后关闭弹窗、刷新表格。 */

package/dist/package/src/views/tool/api-doc/index.vue

@@ -27,15 +27,16 @@
 <script setup lang="ts">
 import SwaggerUIBundle from "swagger-ui-dist/swagger-ui-bundle.js";
 import "swagger-ui-dist/swagger-ui.css";
+import { DEFAULT_LOCALE, t, useLocaleStore } from "@liujitcn/kratos-admin-core";
 import { getLocaleRequestHeaders, getRequestAccessToken } from "@liujitcn/kratos-admin-core/request";
 import { defBaseApiService } from "@liujitcn/kratos-admin-system/api/system/base_api";
 import type { OpenApiServiceOption } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_api";
-import { t } from "@liujitcn/kratos-admin-core";
 
 const swaggerRootRef = ref<HTMLElement>();
 const loading = ref(true);
 const documents = ref<OpenApiServiceOption[]>([]);
 const selectedDocumentKey = ref("");
+const { locale } = useLocaleStore();
 
 /** 初始化携带当前登录令牌的 Swagger UI。 */
 function initializeSwaggerUI(documentKey: string) {
@@ -44,9 +45,10 @@ function initializeSwaggerUI(documentKey: string) {
 
   loading.value = true;
   swaggerRoot.replaceChildren();
+  const localePath = locale.value === DEFAULT_LOCALE ? "" : `/${encodeURIComponent(locale.value)}`;
   SwaggerUIBundle({
     domNode: swaggerRoot,
-    url: `/api/docs/openapi/${encodeURIComponent(documentKey)}`,
+    url: `/api/docs/openapi/${encodeURIComponent(documentKey)}${localePath}`,
     deepLinking: true,
     displayOperationId: true,
     displayRequestDuration: true,
@@ -84,16 +86,18 @@ function handleDocumentChange(documentKey: string) {
 
 /** 加载可访问的 OpenAPI 文档并初始化默认文档。 */
 async function loadOpenAPIDocuments() {
+  loading.value = true;
   try {
     const response = await defBaseApiService.OptionOpenApiService({});
     documents.value = response.list;
-    const defaultDocument = response.list[0];
-    if (!defaultDocument) {
+    const selectedDocument = response.list.find(document => document.key === selectedDocumentKey.value) ?? response.list[0];
+    if (!selectedDocument) {
+      selectedDocumentKey.value = "";
       loading.value = false;
       return;
     }
-    selectedDocumentKey.value = defaultDocument.key;
-    initializeSwaggerUI(defaultDocument.key);
+    selectedDocumentKey.value = selectedDocument.key;
+    initializeSwaggerUI(selectedDocument.key);
   } catch {
     loading.value = false;
   }
@@ -103,6 +107,10 @@ onMounted(() => {
   loadOpenAPIDocuments();
 });
 
+watch(locale, () => {
+  loadOpenAPIDocuments();
+});
+
 onBeforeUnmount(() => {
   swaggerRootRef.value?.replaceChildren();
 });

package/dist/package/src/views/tool/code-gen/code-preview/index.vue

@@ -60,7 +60,7 @@ const table = ref<CodeGenTableForm>();
 const files = ref<CodeGenPreviewFile[]>([]);
 const loading = ref(false);
 const previewError = ref("");
-const missingTranslations = ref<string[]>([]);
+const missingI18ns = ref<string[]>([]);
 const progressTaskId = ref(typeof window === "undefined" ? "" : (window.sessionStorage.getItem(codeGenTaskStorageKey) ?? ""));
 const progressDialogVisible = ref(
   !!progressTaskId.value &&
@@ -94,7 +94,7 @@ async function loadCodePreview() {
   table.value = undefined;
   files.value = [];
   previewError.value = "";
-  missingTranslations.value = [];
+  missingI18ns.value = [];
   if (!tableId.value) return;
   loading.value = true;
   try {
@@ -103,10 +103,10 @@ async function loadCodePreview() {
     try {
       const preview = await defCodeGenService.PreviewCodeGen({ table_id: tableId.value, output_paths: undefined });
       files.value = preview.files ?? [];
-      missingTranslations.value = preview.missing_translations ?? [];
-      if (missingTranslations.value.length) {
-        previewError.value = t("system.code.gen.preview.message.missing_translations", {
-          items: missingTranslations.value.join(t("system.code.gen.preview.value.list_separator"))
+      missingI18ns.value = preview.missing_i18ns ?? [];
+      if (missingI18ns.value.length) {
+        previewError.value = t("system.code.gen.preview.message.missing_i18ns", {
+          items: missingI18ns.value.join(t("system.code.gen.preview.value.list_separator"))
         });
       }
       if (!files.value.length && !previewError.value) previewError.value = t("system.code.gen.preview.message.no_preview_files");
@@ -134,6 +134,23 @@ async function handleGenerate() {
     ElMessage.warning(t("system.code.gen.table.message.disabled", { name: table.value.name }));
     return;
   }
+  if (missingI18ns.value.length) {
+    try {
+      await ElMessageBox.alert(
+        t("system.code.gen.preview.message.missing_i18ns", {
+          items: missingI18ns.value.join(t("system.code.gen.preview.value.list_separator"))
+        }),
+        t("common.title.warning"),
+        {
+          confirmButtonText: t("common.action.close"),
+          type: "warning"
+        }
+      );
+    } catch {
+      // 关闭提示框与点击关闭按钮语义一致。
+    }
+    return;
+  }
   try {
     await ElMessageBox.confirm(
       t("system.code.gen.table.dialog.generate_one", { name: table.value.name }),

package/dist/package/src/views/tool/code-gen/columns/index.vue

@@ -557,7 +557,7 @@ import type {
 } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_column";
 import type { CodeGenDatabaseTable, CodeGenTableForm } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_table";
 import CodeGenLocaleEditor from "../components/CodeGenLocaleEditor.vue";
-import { getEditableLanguageOptions } from "@liujitcn/kratos-admin-system/components/dynamicTranslation";
+import { getEditableLanguageOptions } from "@liujitcn/kratos-admin-system/components/dynamicI18n";
 import {
   copyCodeGenOptionToEmptyMatches,
   copyFirstMatchingCodeGenOption,

package/dist/package/src/views/tool/code-gen/components/CodeGenLocaleEditor.vue

@@ -17,26 +17,57 @@
           {{ t("system.code.gen.i18n.status.missing") }}
         </el-tag>
       </div>
-      <el-input
-        :model-value="localeValue(locale.value).comment"
-        :placeholder="t('system.code.gen.i18n.placeholder.comment', { source: sourceComment || '-' })"
-        maxlength="255"
-        @update:model-value="value => updateLocale(locale.value, 'comment', value)"
-      />
-      <el-input
-        v-if="showLeftTreeComment"
-        :model-value="localeValue(locale.value).left_tree_comment"
-        :placeholder="t('system.code.gen.i18n.placeholder.left_tree_comment', { source: sourceLeftTreeComment || '-' })"
-        maxlength="255"
-        @update:model-value="value => updateLocale(locale.value, 'left_tree_comment', value)"
-      />
+      <div class="code-gen-locale-editor__control">
+        <el-input
+          :model-value="localeValue(locale.value).comment"
+          :placeholder="t('system.code.gen.i18n.placeholder.comment', { source: sourceComment || '-' })"
+          :disabled="isTranslating(locale.value, 'comment')"
+          maxlength="255"
+          @update:model-value="value => updateLocale(locale.value, 'comment', value)"
+        />
+        <el-button
+          class="code-gen-locale-editor__translate"
+          link
+          type="primary"
+          size="small"
+          :icon="Promotion"
+          :loading="isTranslating(locale.value, 'comment')"
+          :disabled="!canTranslate(locale.value, 'comment', sourceComment)"
+          @click="handleTranslate(locale.value, 'comment', sourceComment, locale.label)"
+        >
+          {{ t("system.base.i18n.action.translate") }}
+        </el-button>
+      </div>
+      <div v-if="showLeftTreeComment" class="code-gen-locale-editor__control">
+        <el-input
+          :model-value="localeValue(locale.value).left_tree_comment"
+          :placeholder="t('system.code.gen.i18n.placeholder.left_tree_comment', { source: sourceLeftTreeComment || '-' })"
+          :disabled="isTranslating(locale.value, 'left_tree_comment')"
+          maxlength="255"
+          @update:model-value="value => updateLocale(locale.value, 'left_tree_comment', value)"
+        />
+        <el-button
+          class="code-gen-locale-editor__translate"
+          link
+          type="primary"
+          size="small"
+          :icon="Promotion"
+          :loading="isTranslating(locale.value, 'left_tree_comment')"
+          :disabled="!canTranslate(locale.value, 'left_tree_comment', sourceLeftTreeComment)"
+          @click="handleTranslate(locale.value, 'left_tree_comment', sourceLeftTreeComment, locale.label)"
+        >
+          {{ t("system.base.i18n.action.translate") }}
+        </el-button>
+      </div>
     </div>
   </div>
 </template>
 
 <script setup lang="ts">
-import { computed } from "vue";
+import { computed, ref } from "vue";
+import { Promotion } from "@element-plus/icons-vue";
 import { t } from "@liujitcn/kratos-admin-core";
+import { defBaseI18nService } from "@liujitcn/kratos-admin-system/api/system/base_i18n";
 import { loadEnabledBaseLanguages, useEnabledBaseLanguages } from "@liujitcn/kratos-admin-system/api/system/base_language";
 import type { CodeGenLocaleConfig } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_i18n";
 
@@ -63,6 +94,7 @@ const emit = defineEmits<{
 }>();
 
 const { languages } = useEnabledBaseLanguages();
+const translatingField = ref("");
 void loadEnabledBaseLanguages();
 
 const editableLocales = computed(() =>
@@ -92,6 +124,33 @@ function updateLocale(locale: string, field: keyof CodeGenLocaleConfig, value: s
   next.set(locale, { ...localeValue(locale), [field]: value });
   emit("update:modelValue", next);
 }
+
+/** 判断指定语言字段是否正在翻译。 */
+function isTranslating(locale: string, field: keyof CodeGenLocaleConfig) {
+  return translatingField.value === `${locale}:${field}`;
+}
+
+/** 判断指定语言字段当前是否允许自动翻译。 */
+function canTranslate(locale: string, field: keyof CodeGenLocaleConfig, source: string) {
+  return Boolean(source) && !localeValue(locale)[field] && !translatingField.value;
+}
+
+/** 翻译指定语言的单个代码生成描述。 */
+async function handleTranslate(locale: string, field: keyof CodeGenLocaleConfig, source: string, language: string) {
+  if (!canTranslate(locale, field, source)) return;
+  translatingField.value = `${locale}:${field}`;
+  try {
+    const response = await defBaseI18nService.DraftBaseI18n({ source, locale });
+    const i18n = response.i18ns.find(item => item.locale === locale)?.i18n;
+    if (!i18n) throw new Error("i18n not found");
+    updateLocale(locale, field, i18n);
+    ElMessage.success(t("system.base.i18n.message.translate_success", { language }));
+  } catch {
+    ElMessage.error(t("system.base.i18n.message.translate_failed", { language }));
+  } finally {
+    translatingField.value = "";
+  }
+}
 </script>
 
 <style scoped lang="scss">
@@ -115,4 +174,27 @@ function updateLocale(locale: string, field: keyof CodeGenLocaleConfig, value: s
   font-weight: 600;
   color: var(--el-text-color-primary);
 }
+
+.code-gen-locale-editor__control {
+  position: relative;
+  display: flex;
+  align-items: center;
+  width: 100%;
+}
+
+.code-gen-locale-editor__control :deep(.el-input) {
+  flex: 1;
+}
+
+.code-gen-locale-editor__control :deep(.el-input__suffix) {
+  padding-right: 78px;
+}
+
+.code-gen-locale-editor__translate {
+  position: absolute;
+  z-index: 1;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+}
 </style>

package/dist/package/src/views/tool/code-gen/table/index.vue

@@ -212,7 +212,7 @@ const formFields = computed<ProFormField[]>(() => [
   },
   {
     prop: "i18n_config",
-    label: t("system.code.gen.i18n.field.translations"),
+    label: t("system.code.gen.i18n.field.i18ns"),
     component: "slot",
     slotName: "tableI18nConfig",
     colSpan: 24,
@@ -588,6 +588,38 @@ async function handleGenerate(selected: CodeGenGenerateTarget) {
     ElMessage.warning(t("system.code.gen.table.message.disabled", { name: disabledTable.name }));
     return;
   }
+  generating.value = true;
+  let missingI18ns: string[] = [];
+  try {
+    const previewEntries = await Promise.all(
+      tables.map(async table => ({
+        table,
+        preview: await defCodeGenService.PreviewCodeGen({ table_id: table.id, output_paths: undefined })
+      }))
+    );
+    missingI18ns = previewEntries.flatMap(({ table, preview }) =>
+      (preview.missing_i18ns ?? []).map(item => (tables.length === 1 ? item : `${table.name}: ${item}`))
+    );
+  } finally {
+    generating.value = false;
+  }
+  if (missingI18ns.length) {
+    try {
+      await ElMessageBox.alert(
+        t("system.code.gen.preview.message.missing_i18ns", {
+          items: missingI18ns.join(t("system.code.gen.preview.value.list_separator"))
+        }),
+        t("common.title.warning"),
+        {
+          confirmButtonText: t("common.action.close"),
+          type: "warning"
+        }
+      );
+    } catch {
+      // 关闭提示框与点击关闭按钮语义一致。
+    }
+    return;
+  }
   const message =
     tables.length === 1
       ? t("system.code.gen.table.dialog.generate_one", { name: tables[0].name })