@liujitcn/kratos-admin-core 0.0.49 → 0.0.50

package/README.md

@@ -67,7 +67,7 @@ packages/core
 | `src/request.ts`                       | 业务模块使用的请求客户端入口。                                                 |
 | `src/security.ts`                      | OAuth、密码加密、密码强度和 WebAuthn 入口。                                    |
 | `src/table.ts`                         | ProTable 请求和选择值处理入口。                                                |
-| `src/tenant.ts`                        | 租户选项入口。                                                                 |
+| `src/tenant.ts`                        | 租户上下文、租户选项、查询范围转换以及租户列/表单字段生成入口。                 |
 | `src/components/ProTable.ts`           | ProTable 对外 Adapter，稳定组件入口为 `components/ProTable`。                  |
 | `src/bootstrap.ts`                     | 创建 Vue 应用，注册 core 与宿主选择的业务模块后挂载。                          |
 | `src/App.vue`                          | 根组件和路由出口。                                                             |
@@ -96,6 +96,8 @@ packages/core
 | `src/components/SvgIcon/`              | SVG 图标渲染。                                                                 |
 | `src/components/SwitchDark/`           | 明暗主题切换。                                                                 |
 | `src/components/TreeFilter/`           | 树形筛选器。                                                                   |
+| `src/components/TenantSelect/`         | 默认租户租户选择器，普通租户自动隐藏。                                         |
+| `src/components/TenantText/`           | 租户名称展示组件，支持名称选项和租户 ID 兜底。                                  |
 | `src/components/Upload/`               | 单/多文件和单/多图片上传组件。                                                 |
 | `src/components/WangEditor/`           | 富文本编辑器封装。                                                             |
 | `src/config/index.ts`                  | 默认应用配置。                                                                 |
@@ -164,6 +166,7 @@ core 通过 `ADMIN_STATIC_VIEWS` 注册全部默认静态页面，后注册业
 | 运行时 Store     | `@liujitcn/kratos-admin-core/stores/runtime`                |
 | ProTable Adapter | `@liujitcn/kratos-admin-core/components/ProTable`           |
 | ProTable 类型    | `@liujitcn/kratos-admin-core/components/ProTable/interface` |
+| SearchForm       | `@liujitcn/kratos-admin-core/components/SearchForm/index.vue` |
 
 其他 Vue 组件以 `package.json#exports` 中的明确白名单为准。禁止使用 `components/ProTable/index.vue`、`utils/*`、`hooks/*`、`stores/modules/*` 等实现路径。发布构建会把内部 `@/` 别名转换成包内相对路径，内部实现不占用公共子路径。
 

package/dist/package/declarations/src/api/system/admin/v1/base_tenant.d.ts

@@ -1,9 +1,11 @@
 import type { SelectOptionResponse } from "../../../../rpc/common/v1/common";
-import type { OptionBaseTenantRequest } from "../../../../rpc/system/admin/v1/base_tenant";
+import type { OptionBaseTenantRequest, PageBaseTenantRequest, PageBaseTenantResponse } from "../../../../rpc/system/admin/v1/base_tenant";
 /** BaseTenantServiceImpl 管理端运行壳租户服务。 */
 export declare class BaseTenantServiceImpl {
     /** 查询租户选项。 */
     OptionBaseTenant(request: OptionBaseTenantRequest): Promise<SelectOptionResponse>;
+    /** 查询租户分页列表，供编码筛选和名称解析使用。 */
+    PageBaseTenant(request: PageBaseTenantRequest): Promise<PageBaseTenantResponse>;
 }
 /** defBaseTenantService 管理端运行壳租户服务实例。 */
 export declare const defBaseTenantService: BaseTenantServiceImpl;

package/dist/package/declarations/src/components/Dialog/FormDialog.vue.d.ts

@@ -59,11 +59,11 @@ declare const __VLS_base: import("vue").DefineComponent<FormDialogProps, {
     confirmText: string;
     cancelText: string;
     confirmLoading: boolean;
+    colSpan: number;
     rules: FormRules;
     labelWidth: string;
     labelPosition: ProFormLabelPosition;
     gutter: number;
-    colSpan: number;
     formProps: Record<string, any>;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/package/declarations/src/components/Grid/components/GridItem.vue.d.ts

@@ -17,12 +17,12 @@ type __VLS_Slots = {} & {
 declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     offset: number;
     span: number;
-    suffix: boolean;
     xs: Responsive;
     sm: Responsive;
     md: Responsive;
     lg: Responsive;
     xl: Responsive;
+    suffix: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/package/declarations/src/components/ProForm/components/ProFormItem.vue.d.ts

@@ -7,20 +7,20 @@ interface ProFormItemProps {
 declare var __VLS_10: string, __VLS_11: {
     field: ProFormField;
     model: Record<string, any>;
-}, __VLS_133: string, __VLS_134: {
+}, __VLS_139: string, __VLS_140: {
     option: import("element-plus").TransferDataItem;
     field: ProFormField;
     model: Record<string, any>;
-}, __VLS_179: string, __VLS_180: {
+}, __VLS_185: string, __VLS_186: {
     field: ProFormField;
     model: Record<string, any>;
 };
 type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
 } & {
-    [K in NonNullable<typeof __VLS_133>]?: (props: typeof __VLS_134) => any;
+    [K in NonNullable<typeof __VLS_139>]?: (props: typeof __VLS_140) => any;
 } & {
-    [K in NonNullable<typeof __VLS_179>]?: (props: typeof __VLS_180) => any;
+    [K in NonNullable<typeof __VLS_185>]?: (props: typeof __VLS_186) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<ProFormItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ProFormItemProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/package/declarations/src/components/ProForm/index.vue.d.ts

@@ -22,11 +22,11 @@ declare const __VLS_base: import("vue").DefineComponent<ProFormProps, {
     resetFields: typeof resetFields;
     clearValidate: typeof clearValidate;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ProFormProps> & Readonly<{}>, {
+    colSpan: number;
     rules: FormRules;
     labelWidth: string;
     labelPosition: ProFormLabelPosition;
     gutter: number;
-    colSpan: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/package/declarations/src/components/ProForm/interface/index.d.ts

@@ -1,7 +1,7 @@
 import type { FormItemRule } from "element-plus";
 import type { Component } from "vue";
 /** ProForm 支持的字段组件类型。 */
-export type ProFormComponentType = "input" | "password" | "textarea" | "input-number" | "color-picker" | "segmented" | "switch" | "checkbox" | "select" | "dict" | "radio-group" | "checkbox-group" | "tree-select" | "date-picker" | "cron-expression" | "transfer" | "image-upload" | "images-upload" | "file-upload" | "files-upload" | "rich-text" | "dynamic-list" | "kv-list" | "slot";
+export type ProFormComponentType = "input" | "password" | "textarea" | "input-number" | "color-picker" | "segmented" | "switch" | "checkbox" | "select" | "tenant-select" | "dict" | "radio-group" | "checkbox-group" | "tree-select" | "date-picker" | "cron-expression" | "transfer" | "image-upload" | "images-upload" | "file-upload" | "files-upload" | "rich-text" | "dynamic-list" | "kv-list" | "slot";
 /** ProForm 标签布局方向。 */
 export type ProFormLabelPosition = "left" | "right" | "top";
 /** ProForm 选择型字段选项。 */

package/dist/package/declarations/src/components/ProTable/interface/index.d.ts

@@ -16,7 +16,7 @@ export interface EnumProps {
 /** Element Plus 表格内置列类型。 */
 export type TypeProps = "index" | "selection" | "radio" | "expand" | "sort";
 /** ProTable 搜索表单支持的控件类型。 */
-export type SearchType = "input" | "input-number" | "select" | "select-v2" | "tree-select" | "cascader" | "date-picker" | "time-picker" | "time-select" | "switch" | "slider";
+export type SearchType = "input" | "input-number" | "select" | "tenant-select" | "select-v2" | "tree-select" | "cascader" | "date-picker" | "time-picker" | "time-select" | "radio" | "switch" | "slider";
 /** ProTable 组件属性。 */
 export interface ProTableProps {
     columns: ColumnProps[];

package/dist/package/declarations/src/components/SearchForm/components/SearchFormItem.vue.d.ts

@@ -6,9 +6,9 @@ interface SearchFormItem {
         [key: string]: any;
     };
 }
-declare var __VLS_27: {};
+declare var __VLS_46: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_27) => any;
+    default?: (props: typeof __VLS_46) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<SearchFormItem, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SearchFormItem> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/package/declarations/src/components/TenantSelect/index.vue.d.ts

@@ -0,0 +1,23 @@
+import type { SelectOptionResponse_Option } from "../../rpc/common/v1/common";
+/** 租户选择组件属性。 */
+interface TenantSelectProps {
+    /** 当前选择的租户。 */
+    modelValue?: number | string;
+    /** 外部传入的租户选项。 */
+    options?: SelectOptionResponse_Option[];
+    /** 是否显示加载状态。 */
+    loading?: boolean;
+}
+declare const __VLS_export: import("vue").DefineComponent<TenantSelectProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: string | number | undefined) => any;
+    change: (value: string | number | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<TenantSelectProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | number | undefined) => any) | undefined;
+    onChange?: ((value: string | number | undefined) => any) | undefined;
+}>, {
+    options: SelectOptionResponse_Option[];
+    modelValue: number | string;
+    loading: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/components/TenantText/index.vue.d.ts

@@ -0,0 +1,13 @@
+import type { SelectOptionResponse_Option } from "../../rpc/common/v1/common";
+/** 租户展示组件属性。 */
+interface TenantTextProps {
+    /** 租户ID。 */
+    tenantId?: number | string;
+    /** 已知的租户名称。 */
+    tenantName?: string;
+    /** 外部传入的租户选项。 */
+    options?: SelectOptionResponse_Option[];
+}
+declare const __VLS_export: import("vue").DefineComponent<TenantTextProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TenantTextProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/index.d.ts

@@ -9,3 +9,4 @@ export { defLanguageService } from "./api/base/v1/language";
 export { setAdminDocumentTitle } from "./documentTitle";
 export { kratosAdminModule } from "./modules/kratosAdmin";
 export { bootstrapAdminApp } from "./bootstrap";
+export { refreshAdminRuntimeConfig } from "./stores/modules/config";

package/dist/package/declarations/src/locales/generated.d.ts

@@ -340,6 +340,7 @@ export declare const LOCALE_MESSAGES: {
         "common.field.sort": string;
         "common.field.status": string;
         "common.field.tenant": string;
+        "common.field.project": string;
         "common.field.updated_at": string;
         "common.field.user": string;
         "common.message.create_success": string;
@@ -705,6 +706,7 @@ export declare const LOCALE_MESSAGES: {
         "common.field.sort": string;
         "common.field.status": string;
         "common.field.tenant": string;
+        "common.field.project": string;
         "common.field.updated_at": string;
         "common.field.user": string;
         "common.message.create_success": string;
@@ -1070,6 +1072,7 @@ export declare const LOCALE_MESSAGES: {
         "common.field.sort": string;
         "common.field.status": string;
         "common.field.tenant": string;
+        "common.field.project": string;
         "common.field.updated_at": string;
         "common.field.user": string;
         "common.message.create_success": string;
@@ -1435,6 +1438,7 @@ export declare const LOCALE_MESSAGES: {
         "common.field.sort": string;
         "common.field.status": string;
         "common.field.tenant": string;
+        "common.field.project": string;
         "common.field.updated_at": string;
         "common.field.user": string;
         "common.message.create_success": string;

package/dist/package/declarations/src/locales/index.d.ts

@@ -24,6 +24,12 @@ export declare const adminI18n: import("vue-i18n").I18n<{}, {}, {}, "zh-CN" | "e
 export declare function normalizeLocale(value?: string): SupportedLocale;
 /** 注册模块语言包并校验语言键、占位符和命名空间。 */
 export declare function registerLocaleMessages(modules: AdminModule[]): void;
+/** 应用全部语言的数据库自定义翻译覆盖项。 */
+export declare function applyCustomLocaleMessages(customs: Array<{
+    locale?: string;
+    key?: string;
+    value?: string;
+}>): void;
 /** 初始化持久化语言偏好并同步日期库。 */
 export declare function initializeLocale(): SupportedLocale;
 /** 应用后端语言配置，并在当前语言不可用时回退到接口第一项。 */
@@ -44,6 +50,8 @@ export declare function registerLocaleChangeHandler(handler: () => void | Promis
 export declare function t(key: string, params?: LocaleParams): string;
 /** 从指定语言包读取固定文案，供第三方组件配置和跨语言兼容判断使用。 */
 export declare function getLocaleText(locale: SupportedLocale, key: string): string;
+/** 从代码语言包读取未应用数据库覆盖的默认文案。 */
+export declare function getDefaultLocaleText(locale: SupportedLocale, key: string): string;
 /** 管理端响应式语言状态。 */
 export declare function useLocaleStore(): {
     locale: Readonly<globalThis.Ref<"zh-CN" | "en-US" | "ja-JP" | "zh-TW", "zh-CN" | "en-US" | "ja-JP" | "zh-TW">>;

package/dist/package/declarations/src/rpc/base/v1/config.d.ts

@@ -29,6 +29,17 @@ export interface GetConfigResponse {
     configs: ConfigItem[];
     /** AI 助手是否可用 */
     ai_enabled: boolean;
+    /** 全部语言的自定义国际化覆盖项 */
+    i18n_customs: I18nCustomItem[];
+}
+/** 全部语言的自定义国际化覆盖项。 */
+export interface I18nCustomItem {
+    /** 语言区域 */
+    locale: string;
+    /** 国际化语言键 */
+    key: string;
+    /** 自定义翻译内容 */
+    value: string;
 }
 /** Base系统配置公共服务 */
 export interface ConfigService {

package/dist/package/declarations/src/rpc/system/admin/v1/base_tenant.d.ts

@@ -36,6 +36,15 @@ export interface CreateBaseTenantRequest {
     /** 租户表单 */
     base_tenant: BaseTenantForm | undefined;
 }
+/** 创建租户响应参数 */
+export interface CreateBaseTenantResponse {
+    /** 租户编号 */
+    tenant_code: string;
+    /** 租户管理员账号 */
+    admin_user_name: string;
+    /** 租户管理员初始密码，仅在随机生成时返回 */
+    initial_password: string;
+}
 /** 更新租户请求参数 */
 export interface UpdateBaseTenantRequest {
     /** 租户表单 */
@@ -102,7 +111,7 @@ export interface BaseTenantService {
     /** 查询租户 */
     GetBaseTenant(request: GetBaseTenantRequest): Promise<BaseTenantForm>;
     /** 创建租户 */
-    CreateBaseTenant(request: CreateBaseTenantRequest): Promise<Empty>;
+    CreateBaseTenant(request: CreateBaseTenantRequest): Promise<CreateBaseTenantResponse>;
     /** 更新租户 */
     UpdateBaseTenant(request: UpdateBaseTenantRequest): Promise<Empty>;
     /** 删除租户 */

package/dist/package/declarations/src/stores/modules/config.d.ts

@@ -24,3 +24,5 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"admin-conf
         background: string;
     }>;
 }>;
+/** 刷新当前管理端语言和站点运行配置。 */
+export declare function refreshAdminRuntimeConfig(): Promise<void>;

package/dist/package/declarations/src/tenant.d.ts

@@ -1 +1,66 @@
+import { type ComputedRef, type Ref } from "vue";
+import type { ProFormField } from "./components/ProForm/interface";
+import type { ColumnProps, EnumProps, RenderScope, SearchType } from "./components/ProTable/interface";
+import type { SelectOptionResponse_Option } from "./rpc/common/v1/common";
 export * from "./utils/tenant";
+/** 查询租户编码筛选选项，值为租户编码而不是租户 ID。 */
+export declare function requestTenantCodeOptions(): Promise<{
+    data: EnumProps[];
+}>;
+/** 租户上下文状态。 */
+export interface TenantScope {
+    /** 当前账号是否为默认租户。 */
+    isDefaultTenant: ComputedRef<boolean>;
+    /** 当前账号可用的租户选项。 */
+    tenantOptions: Ref<SelectOptionResponse_Option[]>;
+    /** 租户选项名称映射。 */
+    tenantNameMap: ComputedRef<Map<string, string>>;
+    /** 加载默认租户可选择的租户。 */
+    loadTenantOptions: (includeCurrentTenant?: boolean) => Promise<void>;
+    /** 将页面租户筛选值转换成后端请求值。 */
+    toRequestTenantId: (value: unknown) => number | undefined;
+    /** 创建默认租户可见的表单字段。 */
+    tenantFormField: (options: TenantFormFieldOptions) => ProFormField;
+    /** 创建默认租户可见的表格租户列。 */
+    tenantColumns: (options: TenantColumnOptions) => ColumnProps[];
+    /** 将行数据转换成租户名称。 */
+    resolveTenantLabel: (row: Record<string, any>, field?: string, options?: SelectOptionResponse_Option[]) => string;
+}
+/** 租户表单字段配置。 */
+export interface TenantFormFieldOptions {
+    /** 字段绑定名称。 */
+    prop?: string;
+    /** 字段标签。 */
+    label: string;
+    /** 表单控件附加属性。 */
+    props?: Record<string, any>;
+    /** 是否允许编辑态修改租户。 */
+    disabledOnEdit?: boolean;
+}
+/** 租户表格列配置。 */
+export interface TenantColumnOptions {
+    /** 列绑定字段。 */
+    prop?: string;
+    /** 列标题。 */
+    label: string;
+    /** 查询字段排序。 */
+    order?: number;
+    /** 查询参数字段，默认使用列字段。 */
+    searchKey?: string;
+    /** 列最小宽度。 */
+    minWidth?: number | string;
+    /** 是否在表格中显示，隐藏时仍可保留查询项。 */
+    isShow?: boolean;
+    /** 是否允许在列设置中切换。 */
+    isSetting?: boolean;
+    /** 是否带租户查询项。 */
+    searchable?: boolean;
+    /** 自定义租户选项来源。 */
+    enum?: ColumnProps["enum"];
+    /** 查询控件类型。 */
+    searchEl?: SearchType;
+    /** 自定义单元格展示。 */
+    render?: (scope: RenderScope) => ReturnType<NonNullable<ColumnProps["render"]>>;
+}
+/** 创建租户范围能力，统一默认租户和普通租户的前端行为。 */
+export declare function useTenantScope(): TenantScope;

package/dist/package/src/api/system/admin/v1/base_tenant.ts

@@ -1,6 +1,6 @@
 import service from "../../../../utils/request";
 import type { SelectOptionResponse } from "../../../../rpc/common/v1/common";
-import type { OptionBaseTenantRequest } from "../../../../rpc/system/admin/v1/base_tenant";
+import type { OptionBaseTenantRequest, PageBaseTenantRequest, PageBaseTenantResponse } from "../../../../rpc/system/admin/v1/base_tenant";
 
 const BASE_TENANT_URL = "/v1/admin/base/tenant";
 
@@ -14,6 +14,15 @@ export class BaseTenantServiceImpl {
       params: request
     });
   }
+
+  /** 查询租户分页列表，供编码筛选和名称解析使用。 */
+  PageBaseTenant(request: PageBaseTenantRequest): Promise<PageBaseTenantResponse> {
+    return service<PageBaseTenantRequest, PageBaseTenantResponse>({
+      url: BASE_TENANT_URL,
+      method: "get",
+      params: request
+    });
+  }
 }
 
 /** defBaseTenantService 管理端运行壳租户服务实例。 */

package/dist/package/src/components/ProForm/components/ProFormItem.vue

@@ -42,6 +42,8 @@
     </el-option>
   </el-select>
 
+  <TenantSelect v-else-if="field.component === 'tenant-select'" v-model="fieldValue" v-bind="fieldProps" />
+
   <el-radio-group v-else-if="field.component === 'radio-group'" v-model="fieldValue" v-bind="fieldProps">
     <el-radio v-for="option in fieldOptions" :key="String(option.value)" :value="option.value" :disabled="option.disabled">
       {{ option.label }}
@@ -96,6 +98,7 @@ import { computed, defineAsyncComponent } from "vue";
 import type { UploadUserFile } from "element-plus";
 import type { ProFormField, ProFormOption } from "../../../components/ProForm/interface";
 import Dict from "../../../components/Dict/index.vue";
+import TenantSelect from "../../../components/TenantSelect/index.vue";
 
 // 非基础表单控件按需加载，避免 ProForm 基础包携带上传、富文本、Cron 等重组件。
 const CronExpression = defineAsyncComponent(() => import("../../../components/CronExpression/index.vue"));

package/dist/package/src/components/ProForm/interface/index.ts

@@ -12,6 +12,7 @@ export type ProFormComponentType =
   | "switch"
   | "checkbox"
   | "select"
+  | "tenant-select"
   | "dict"
   | "radio-group"
   | "checkbox-group"

package/dist/package/src/components/ProTable/interface/index.ts

@@ -24,12 +24,14 @@ export type SearchType =
   | "input"
   | "input-number"
   | "select"
+  | "tenant-select"
   | "select-v2"
   | "tree-select"
   | "cascader"
   | "date-picker"
   | "time-picker"
   | "time-select"
+  | "radio"
   | "switch"
   | "slider";
 

package/dist/package/src/components/SearchForm/components/SearchFormItem.vue

@@ -10,12 +10,34 @@
   />
   <ElSelect
     v-else-if="column.search?.el === 'select' && !column.search?.render"
-    v-bind="{ ...handleSearchProps, ...placeholder, searchParam: _searchParam, clearable }"
+    v-bind="{ ...handleSearchProps, ...placeholder, clearable }"
     v-model="_searchParam[column.search?.key ?? handleProp(column.prop!)]"
     :style="handleSearchStyle"
   >
     <el-option v-for="(col, index) in columnEnum" :key="index" :label="col[fieldNames.label]" :value="col[fieldNames.value]" />
   </ElSelect>
+  <ElRadioGroup
+    v-else-if="column.search?.el === 'radio' && !column.search?.render"
+    v-bind="handleRadioProps"
+    v-model="_searchParam[column.search?.key ?? handleProp(column.prop!)]"
+    :style="handleSearchStyle"
+  >
+    <component
+      :is="radioOptionType === 'button' ? ElRadioButton : ElRadio"
+      v-for="(col, index) in columnEnum"
+      :key="index"
+      :value="col[fieldNames.value]"
+      :disabled="col.disabled"
+    >
+      {{ col[fieldNames.label] }}
+    </component>
+  </ElRadioGroup>
+  <TenantSelect
+    v-else-if="column.search?.el === 'tenant-select' && !column.search?.render"
+    v-bind="{ ...handleSearchProps, ...placeholder, clearable }"
+    v-model="_searchParam[column.search?.key ?? handleProp(column.prop!)]"
+    :style="handleSearchStyle"
+  />
   <component
     v-else
     :is="searchComponent"
@@ -38,6 +60,9 @@ import {
   ElDatePicker,
   ElInput,
   ElInputNumber,
+  ElRadio,
+  ElRadioButton,
+  ElRadioGroup,
   ElSelect,
   ElSelectV2,
   ElSlider,
@@ -47,6 +72,7 @@ import {
   ElTreeSelect
 } from "element-plus";
 import Dict from "../../../components/Dict/index.vue";
+import TenantSelect from "../../../components/TenantSelect/index.vue";
 import { handleProp } from "../../../utils";
 import { ColumnProps, SearchType } from "../../../components/ProTable/interface";
 import { useLocaleStore } from "../../../locales";
@@ -67,12 +93,14 @@ const searchComponentMap: Record<SearchType, Component> = {
   input: ElInput,
   "input-number": ElInputNumber,
   select: ElSelect,
+  "tenant-select": TenantSelect,
   "select-v2": ElSelectV2,
   "tree-select": ElTreeSelect,
   cascader: ElCascader,
   "date-picker": ElDatePicker,
   "time-picker": ElTimePicker,
   "time-select": ElTimeSelect,
+  radio: ElRadioGroup,
   switch: ElSwitch,
   slider: ElSlider
 };
@@ -149,6 +177,15 @@ const handleSearchProps = computed(() => {
   return searchProps;
 });
 
+/** 处理 radio 选项类型，避免将渲染辅助参数透传给 Element Plus。 */
+const radioOptionType = computed(() => (props.column.search?.props?.optionType === "button" ? "button" : "default"));
+
+/** 过滤 radio 专用渲染参数后透传给 radio-group。 */
+const handleRadioProps = computed(() => {
+  const { optionType: _optionType, ...searchProps } = props.column.search?.props ?? {};
+  return searchProps;
+});
+
 // 处理默认 placeholder
 const placeholder = computed(() => {
   const search = props.column.search;
@@ -168,6 +205,6 @@ const placeholder = computed(() => {
 // 是否有清除按钮 (当搜索项有默认值时，清除按钮不显示)
 const clearable = computed(() => {
   const search = props.column.search;
-  return search?.props?.clearable ?? (search?.defaultValue == null || search?.defaultValue == undefined);
+  return search?.props?.clearable ?? (search?.defaultValue == null || false);
 });
 </script>

package/dist/package/src/components/TenantSelect/index.vue

@@ -0,0 +1,57 @@
+<template>
+  <el-select
+    v-if="isDefaultTenant"
+    :model-value="modelValue"
+    v-bind="$attrs"
+    :loading="isLoading"
+    @update:model-value="value => emit('update:modelValue', value)"
+    @change="value => emit('change', value)"
+  >
+    <el-option v-for="option in options" :key="String(option.value)" :label="option.label" :value="option.value" :disabled="option.disabled" />
+  </el-select>
+</template>
+
+<script setup lang="ts">
+import { computed, onMounted, ref } from "vue";
+import type { SelectOptionResponse_Option } from "../../rpc/common/v1/common";
+import { useTenantScope } from "../../tenant";
+
+defineOptions({ name: "TenantSelect", inheritAttrs: false });
+
+/** 租户选择组件属性。 */
+interface TenantSelectProps {
+  /** 当前选择的租户。 */
+  modelValue?: number | string;
+  /** 外部传入的租户选项。 */
+  options?: SelectOptionResponse_Option[];
+  /** 是否显示加载状态。 */
+  loading?: boolean;
+}
+
+const props = withDefaults(defineProps<TenantSelectProps>(), {
+  modelValue: undefined,
+  options: undefined,
+  loading: false
+});
+const emit = defineEmits<{
+  /** 更新当前租户。 */
+  (event: "update:modelValue", value: number | string | undefined): void;
+  /** 租户发生变化。 */
+  (event: "change", value: number | string | undefined): void;
+}>();
+
+const { isDefaultTenant, tenantOptions, loadTenantOptions } = useTenantScope();
+const internalLoading = ref(false);
+const options = computed(() => props.options ?? tenantOptions.value);
+const isLoading = computed(() => props.loading || internalLoading.value);
+
+onMounted(async () => {
+  if (!isDefaultTenant.value || props.options) return;
+  internalLoading.value = true;
+  try {
+    await loadTenantOptions();
+  } finally {
+    internalLoading.value = false;
+  }
+});
+</script>

package/dist/package/src/components/TenantText/index.vue

@@ -0,0 +1,28 @@
+<template>
+  <span>{{ label }}</span>
+</template>
+
+<script setup lang="ts">
+import { computed } from "vue";
+import type { SelectOptionResponse_Option } from "../../rpc/common/v1/common";
+import { useTenantScope } from "../../tenant";
+
+defineOptions({ name: "TenantText" });
+
+/** 租户展示组件属性。 */
+interface TenantTextProps {
+  /** 租户ID。 */
+  tenantId?: number | string;
+  /** 已知的租户名称。 */
+  tenantName?: string;
+  /** 外部传入的租户选项。 */
+  options?: SelectOptionResponse_Option[];
+}
+
+const props = defineProps<TenantTextProps>();
+const { resolveTenantLabel } = useTenantScope();
+const label = computed(() => {
+  if (props.tenantName) return props.tenantName;
+  return resolveTenantLabel({ tenant_id: props.tenantId }, "tenant_id", props.options);
+});
+</script>

package/dist/package/src/index.ts

@@ -10,3 +10,4 @@ export { defLanguageService } from "./api/base/v1/language";
 export { setAdminDocumentTitle } from "./documentTitle";
 export { kratosAdminModule } from "./modules/kratosAdmin";
 export { bootstrapAdminApp } from "./bootstrap";
+export { refreshAdminRuntimeConfig } from "./stores/modules/config";

package/dist/package/src/locales/en-US.json

@@ -335,6 +335,7 @@
   "common.field.sort": "Sort order",
   "common.field.status": "Status",
   "common.field.tenant": "Tenant",
+  "common.field.project": "Project",
   "common.field.updated_at": "Updated at",
   "common.field.user": "User",
   "common.message.create_success": "{resource} created",

package/dist/package/src/locales/index.ts

@@ -37,6 +37,8 @@ export const LOCALE_STORAGE_KEY = "kratos-admin:locale";
 const mutableLocale = ref<SupportedLocale>(DEFAULT_LOCALE);
 const mutableLanguageOptions = ref<LocaleOption[]>([]);
 const localeChangeHandlers = new Set<() => void | Promise<void>>();
+const defaultLocaleMessages = new Map<SupportedLocale, LocaleMessages>();
+const customLocaleMessages = new Map<SupportedLocale, LocaleMessages>();
 
 /** 管理端 Vue I18n 实例。 */
 export const adminI18n = createI18n({
@@ -100,7 +102,25 @@ export function registerLocaleMessages(modules: AdminModule[]): void {
     });
   });
 
-  SUPPORTED_LOCALES.forEach(locale => adminI18n.global.setLocaleMessage(locale, merged.get(locale) ?? {}));
+  SUPPORTED_LOCALES.forEach(locale => {
+    const messages = { ...(merged.get(locale) ?? {}) };
+    defaultLocaleMessages.set(locale, messages);
+    customLocaleMessages.set(locale, messages);
+    adminI18n.global.setLocaleMessage(locale, messages);
+  });
+}
+
+/** 应用全部语言的数据库自定义翻译覆盖项。 */
+export function applyCustomLocaleMessages(customs: Array<{ locale?: string; key?: string; value?: string }>): void {
+  SUPPORTED_LOCALES.forEach(locale => {
+    const messages = { ...(defaultLocaleMessages.get(locale) ?? {}) };
+    customs.forEach(item => {
+      if (!item.locale || normalizeLocale(item.locale) !== locale || !item.key || !item.value || !Object.prototype.hasOwnProperty.call(messages, item.key)) return;
+      messages[item.key] = item.value;
+    });
+    customLocaleMessages.set(locale, messages);
+    adminI18n.global.setLocaleMessage(locale, messages);
+  });
 }
 
 /** 初始化持久化语言偏好并同步日期库。 */
@@ -177,6 +197,11 @@ export function getLocaleText(locale: SupportedLocale, key: string): string {
   return messages[key] ?? fallbackMessages[key] ?? "";
 }
 
+/** 从代码语言包读取未应用数据库覆盖的默认文案。 */
+export function getDefaultLocaleText(locale: SupportedLocale, key: string): string {
+  return defaultLocaleMessages.get(locale)?.[key] ?? defaultLocaleMessages.get(DEFAULT_LOCALE)?.[key] ?? "";
+}
+
 /** 管理端响应式语言状态。 */
 export function useLocaleStore() {
   return {
@@ -203,6 +228,7 @@ function fallbackNativeLanguageName(languageCode: SupportedLocale): string {
 }
 
 function applyLocale(locale: SupportedLocale): void {
+  adminI18n.global.setLocaleMessage(locale, { ...(customLocaleMessages.get(locale) ?? defaultLocaleMessages.get(locale) ?? {}) });
   mutableLocale.value = locale;
   adminI18n.global.locale.value = locale;
   const dayjsLocale = DAYJS_LOCALE_MAP[locale];

package/dist/package/src/locales/ja-JP.json

@@ -335,6 +335,7 @@
   "common.field.sort": "並べ替え",
   "common.field.status": "ステータス",
   "common.field.tenant": "テナント",
+  "common.field.project": "プロジェクト",
   "common.field.updated_at": "更新時間",
   "common.field.user": "ユーザー",
   "common.message.create_success": "{resource} が正常に追加されました",

package/dist/package/src/locales/zh-CN.json

@@ -335,6 +335,7 @@
   "common.field.sort": "排序",
   "common.field.status": "状态",
   "common.field.tenant": "租户",
+  "common.field.project": "项目",
   "common.field.updated_at": "更新时间",
   "common.field.user": "用户",
   "common.message.create_success": "新增{resource}成功",

package/dist/package/src/locales/zh-TW.json

@@ -335,6 +335,7 @@
   "common.field.sort": "排序",
   "common.field.status": "狀態",
   "common.field.tenant": "租戶",
+  "common.field.project": "專案",
   "common.field.updated_at": "更新時間",
   "common.field.user": "使用者",
   "common.message.create_success": "新增{resource}成功",

package/dist/package/src/rpc/base/v1/config.ts

@@ -40,6 +40,18 @@ export interface GetConfigResponse {
   configs: ConfigItem[];
   /** AI 助手是否可用 */
   ai_enabled: boolean;
+  /** 全部语言的自定义国际化覆盖项 */
+  i18n_customs: I18nCustomItem[];
+}
+
+/** 全部语言的自定义国际化覆盖项。 */
+export interface I18nCustomItem {
+  /** 语言区域 */
+  locale: string;
+  /** 国际化语言键 */
+  key: string;
+  /** 自定义翻译内容 */
+  value: string;
 }
 
 /** Base系统配置公共服务 */

package/dist/package/src/rpc/system/admin/v1/base_tenant.ts

@@ -51,6 +51,16 @@ export interface CreateBaseTenantRequest {
   base_tenant: BaseTenantForm | undefined;
 }
 
+/** 创建租户响应参数 */
+export interface CreateBaseTenantResponse {
+  /** 租户编号 */
+  tenant_code: string;
+  /** 租户管理员账号 */
+  admin_user_name: string;
+  /** 租户管理员初始密码，仅在随机生成时返回 */
+  initial_password: string;
+}
+
 /** 更新租户请求参数 */
 export interface UpdateBaseTenantRequest {
   /** 租户表单 */
@@ -124,7 +134,7 @@ export interface BaseTenantService {
   /** 查询租户 */
   GetBaseTenant(request: GetBaseTenantRequest): Promise<BaseTenantForm>;
   /** 创建租户 */
-  CreateBaseTenant(request: CreateBaseTenantRequest): Promise<Empty>;
+  CreateBaseTenant(request: CreateBaseTenantRequest): Promise<CreateBaseTenantResponse>;
   /** 更新租户 */
   UpdateBaseTenant(request: UpdateBaseTenantRequest): Promise<Empty>;
   /** 删除租户 */

package/dist/package/src/stores/modules/config.ts

@@ -4,6 +4,7 @@ import { BaseConfigSite } from "../../rpc/base/v1/config";
 import type { LoginCaptchaConfig, SiteConfigState, SiteDisplayConfig } from "../../stores/interface";
 import defaultLogoUrl from "../../assets/images/logo.svg";
 import defaultBackgroundUrl from "../../assets/images/login_left.png";
+import { applyCustomLocaleMessages } from "../../locales";
 
 const CAPTCHA_TYPE_KEY = "captchaType";
 const SHOW_TENANT_CODE_KEY = "showTenantCode";
@@ -117,6 +118,7 @@ export const useConfigStore = defineStore("admin-config", {
       });
       const configMap = buildConfigMap(configResponse.configs ?? []);
 
+      applyCustomLocaleMessages(configResponse.i18n_customs ?? []);
       this.setDisplayConfig(normalizeSiteDisplayConfig(configMap));
       this.setLoginCaptchaConfig(normalizeLoginCaptchaConfig(configMap));
       this.showTenantCode = !["false", "0"].includes((configMap[SHOW_TENANT_CODE_KEY] ?? "true").toLowerCase());
@@ -126,3 +128,8 @@ export const useConfigStore = defineStore("admin-config", {
     }
   }
 });
+
+/** 刷新当前管理端语言和站点运行配置。 */
+export async function refreshAdminRuntimeConfig(): Promise<void> {
+  await useConfigStore().loadDisplayConfig();
+}

package/dist/package/src/tenant.ts

@@ -1 +1,158 @@
+import { computed, ref, type ComputedRef, type Ref } from "vue";
+import type { ProFormField } from "./components/ProForm/interface";
+import type { ColumnProps, EnumProps, RenderScope, SearchType } from "./components/ProTable/interface";
+import { defBaseTenantService } from "./api/system/admin/v1/base_tenant";
+import type { SelectOptionResponse_Option } from "./rpc/common/v1/common";
+import { useUserStore } from "./stores/runtime";
+import { DEFAULT_TENANT_CODE, requestTenantOptions as requestTenantOptionData } from "./utils/tenant";
+
 export * from "./utils/tenant";
+
+/** 查询租户编码筛选选项，值为租户编码而不是租户 ID。 */
+export async function requestTenantCodeOptions() {
+  const options: EnumProps[] = [];
+  const pageSize = 100;
+  for (let pageNum = 1; ; pageNum += 1) {
+    const response = await defBaseTenantService.PageBaseTenant({ code: "", name: "", page_num: pageNum, page_size: pageSize });
+    const tenants = response.base_tenants ?? [];
+    options.push(...tenants.map(tenant => ({ value: tenant.code, label: tenant.name })));
+    if (options.length >= response.total || tenants.length === 0) break;
+  }
+  return { data: options };
+}
+
+/** 租户上下文状态。 */
+export interface TenantScope {
+  /** 当前账号是否为默认租户。 */
+  isDefaultTenant: ComputedRef<boolean>;
+  /** 当前账号可用的租户选项。 */
+  tenantOptions: Ref<SelectOptionResponse_Option[]>;
+  /** 租户选项名称映射。 */
+  tenantNameMap: ComputedRef<Map<string, string>>;
+  /** 加载默认租户可选择的租户。 */
+  loadTenantOptions: (includeCurrentTenant?: boolean) => Promise<void>;
+  /** 将页面租户筛选值转换成后端请求值。 */
+  toRequestTenantId: (value: unknown) => number | undefined;
+  /** 创建默认租户可见的表单字段。 */
+  tenantFormField: (options: TenantFormFieldOptions) => ProFormField;
+  /** 创建默认租户可见的表格租户列。 */
+  tenantColumns: (options: TenantColumnOptions) => ColumnProps[];
+  /** 将行数据转换成租户名称。 */
+  resolveTenantLabel: (row: Record<string, any>, field?: string, options?: SelectOptionResponse_Option[]) => string;
+}
+
+/** 租户表单字段配置。 */
+export interface TenantFormFieldOptions {
+  /** 字段绑定名称。 */
+  prop?: string;
+  /** 字段标签。 */
+  label: string;
+  /** 表单控件附加属性。 */
+  props?: Record<string, any>;
+  /** 是否允许编辑态修改租户。 */
+  disabledOnEdit?: boolean;
+}
+
+/** 租户表格列配置。 */
+export interface TenantColumnOptions {
+  /** 列绑定字段。 */
+  prop?: string;
+  /** 列标题。 */
+  label: string;
+  /** 查询字段排序。 */
+  order?: number;
+  /** 查询参数字段，默认使用列字段。 */
+  searchKey?: string;
+  /** 列最小宽度。 */
+  minWidth?: number | string;
+  /** 是否在表格中显示，隐藏时仍可保留查询项。 */
+  isShow?: boolean;
+  /** 是否允许在列设置中切换。 */
+  isSetting?: boolean;
+  /** 是否带租户查询项。 */
+  searchable?: boolean;
+  /** 自定义租户选项来源。 */
+  enum?: ColumnProps["enum"];
+  /** 查询控件类型。 */
+  searchEl?: SearchType;
+  /** 自定义单元格展示。 */
+  render?: (scope: RenderScope) => ReturnType<NonNullable<ColumnProps["render"]>>;
+}
+
+/** 创建租户范围能力，统一默认租户和普通租户的前端行为。 */
+export function useTenantScope(): TenantScope {
+  const userStore = useUserStore();
+  const isDefaultTenant = computed(() => userStore.userInfo.tenant_code === DEFAULT_TENANT_CODE);
+  const tenantOptions = ref<SelectOptionResponse_Option[]>([]);
+  const tenantNameMap = computed(() => new Map(tenantOptions.value.map(item => [String(item.value), item.label] as const)));
+
+  async function loadTenantOptions(includeCurrentTenant = false) {
+    if (!includeCurrentTenant && !isDefaultTenant.value) return;
+    if (tenantOptions.value.length) return;
+    const response = await defBaseTenantService.OptionBaseTenant({ keyword: "" });
+    tenantOptions.value = response.list ?? [];
+  }
+
+  function toRequestTenantId(value: unknown) {
+    if (!isDefaultTenant.value || value === undefined || value === null || value === "") return undefined;
+    const tenantId = Number(value);
+    return Number.isFinite(tenantId) && tenantId > 0 ? tenantId : undefined;
+  }
+
+  function tenantFormField(options: TenantFormFieldOptions): ProFormField {
+    const prop = options.prop ?? "tenant_id";
+    return {
+      prop,
+      label: options.label,
+      component: "tenant-select",
+      props: (model: Record<string, any>) => ({
+        filterable: true,
+        ...(options.disabledOnEdit ? { disabled: Boolean(model.id) } : {}),
+        ...options.props
+      }),
+      visible: () => isDefaultTenant.value,
+    };
+  }
+
+  function tenantColumns(options: TenantColumnOptions): ColumnProps[] {
+    if (!isDefaultTenant.value) return [];
+    const prop = options.prop ?? "tenant_id";
+    return [
+      {
+        prop,
+        label: options.label,
+        minWidth: options.minWidth ?? 140,
+        isShow: options.isShow,
+        isSetting: options.isSetting,
+        align: "left",
+        showOverflowTooltip: true,
+        search:
+          options.searchable === false
+            ? undefined
+            : { el: options.searchEl ?? "tenant-select", key: options.searchKey ?? prop, props: { filterable: true }, order: options.order },
+        enum: options.enum ?? requestTenantOptionData,
+        render: options.render ?? (scope => resolveTenantLabel(scope.row, prop))
+      }
+    ];
+  }
+
+  function resolveTenantLabel(row: Record<string, any>, field = "tenant_id", options = tenantOptions.value) {
+    const directLabel = row.tenant_name ?? row[`${field}_name`];
+    if (directLabel) return String(directLabel);
+    const value = row[field];
+    if (value === undefined || value === null || value === "") return "";
+    const nameMap = new Map(options.map(item => [String(item.value), item.label] as const));
+    return nameMap.get(String(value)) ?? String(value);
+  }
+
+  return {
+    isDefaultTenant,
+    tenantOptions,
+    tenantNameMap,
+    loadTenantOptions,
+    toRequestTenantId,
+    tenantFormField,
+    tenantColumns,
+    resolveTenantLabel
+  };
+}

package/dist/package/src/views/login/components/LoginForm.vue

@@ -551,10 +551,10 @@ const getOauthLoginRedirectURL = () => {
   return resolveFrontendRouteURL(router, { path: route.path, query });
 };
 
-/** 查询配置启用的三方登录方式。 */
+/** 查询配置启用的三方登录方式，空列表字段省略时不展示三方登录。 */
 const loadOauthProviders = async () => {
   const result = await defOauthService.ListOauthProvider({});
-  oauthProviders.value = result.providers.map(withOauthProviderDisplay);
+  oauthProviders.value = (result.providers ?? []).map(withOauthProviderDisplay);
 };
 
 /** 发起三方登录授权跳转。 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@liujitcn/kratos-admin-core",
   "private": false,
-  "version": "0.0.49",
+  "version": "0.0.50",
   "type": "module",
   "description": "kratos-admin frontend runtime and base modules",
   "author": {
@@ -153,6 +153,10 @@
       "types": "./dist/package/declarations/src/components/ProTable/interface/index.d.ts",
       "default": "./dist/package/src/components/ProTable/interface/index.ts"
     },
+    "./components/SearchForm/index.vue": {
+      "types": "./dist/package/declarations/src/components/SearchForm/index.vue.d.ts",
+      "default": "./dist/package/src/components/SearchForm/index.vue"
+    },
     "./components/SelectIcon/index.vue": {
       "types": "./dist/package/declarations/src/components/SelectIcon/index.vue.d.ts",
       "default": "./dist/package/src/components/SelectIcon/index.vue"
@@ -161,6 +165,14 @@
       "types": "./dist/package/declarations/src/components/TreeFilter/index.vue.d.ts",
       "default": "./dist/package/src/components/TreeFilter/index.vue"
     },
+    "./components/TenantSelect/index.vue": {
+      "types": "./dist/package/declarations/src/components/TenantSelect/index.vue.d.ts",
+      "default": "./dist/package/src/components/TenantSelect/index.vue"
+    },
+    "./components/TenantText/index.vue": {
+      "types": "./dist/package/declarations/src/components/TenantText/index.vue.d.ts",
+      "default": "./dist/package/src/components/TenantText/index.vue"
+    },
     "./components/Upload/Img.vue": {
       "types": "./dist/package/declarations/src/components/Upload/Img.vue.d.ts",
       "default": "./dist/package/src/components/Upload/Img.vue"