@lark-apaas/client-toolkit 1.2.35-alpha.2 → 1.2.35-alpha.3

package/lib/apis/tools/storage.js

@@ -1,4 +1,5 @@
 function getDefaultBucketId() {
-    return window._bucket_id;
+    const w = window;
+    return w._bucket_id ?? w.__platform__?.appPublished?.app_runtime_extra?.bucket?.default_bucket_id;
 }
 export { getDefaultBucketId };

package/lib/components/AppContainer/index.js

@@ -1,5 +1,5 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import react, { Suspense, useEffect, useMemo, useState } from "react";
 import { ConfigProvider } from "antd";
 import { MiaodaInspector } from "@lark-apaas/miaoda-inspector";
 import zh_CN from "antd/locale/zh_CN";
@@ -10,20 +10,33 @@ import { reportTeaEvent } from "./utils/tea.js";
 import { useAppInfo } from "../../hooks/index.js";
 import { TrackKey } from "../../types/tea.js";
 import { slardar } from "@lark-apaas/internal-slardar";
-import safety from "./safety.js";
 import { getAppId } from "../../utils/getAppId.js";
 import { isNewPathEnabled } from "../../utils/apiPath.js";
 import QueryProvider from "../QueryProvider/index.js";
 import { AuthProvider } from "@lark-apaas/auth-sdk";
 import "../../runtime/index.js";
+const Safety = /*#__PURE__*/ react.lazy(()=>import("./safety.js"));
 const isMiaodaPreview = window.IS_MIAODA_PREVIEW;
-const readCssVarColor = (varName, fallback)=>{
+const readAllCssVarColors = ()=>{
     try {
-        if ('undefined' == typeof document) return fallback;
-        const value = getComputedStyle(document.documentElement).getPropertyValue(varName).trim();
-        return value || fallback;
+        if ('undefined' == typeof document) return {};
+        const styles = getComputedStyle(document.documentElement);
+        const read = (name)=>styles.getPropertyValue(name).trim() || void 0;
+        return {
+            background: read('--background'),
+            destructive: read('--destructive'),
+            primary: read('--primary'),
+            foreground: read('--foreground'),
+            warning: read('--warning'),
+            success: read('--success'),
+            muted: read('--muted'),
+            mutedForeground: read('--muted-foreground'),
+            border: read('--border'),
+            popover: read('--popover'),
+            accent: read('--accent')
+        };
     } catch  {
-        return fallback;
+        return {};
     }
 };
 const appFlags = process.env.APP_FLAGS || {};
@@ -69,13 +82,17 @@ const App = (props)=>{
     }, []);
     const appId = getAppId();
     const permissionApiUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/permissions/roles` : `/spark/app/${appId}/runtime/api/v1/permissions/roles`;
-    return /*#__PURE__*/ jsxs(AuthProvider, {
-        config: {
+    const authConfig = useMemo(()=>({
             enable: enableAuth,
             permissionApi: {
                 url: permissionApiUrl
             }
-        },
+        }), [
+        enableAuth,
+        permissionApiUrl
+    ]);
+    return /*#__PURE__*/ jsxs(AuthProvider, {
+        config: authConfig,
         children: [
             !disableToaster && true !== appFlags.customToaster && /*#__PURE__*/ jsx(Toaster, {}),
             'production' !== process.env.NODE_ENV && /*#__PURE__*/ jsx(MiaodaInspector, {}),
@@ -88,19 +105,7 @@ const App = (props)=>{
 };
 const AppContainer_AppContainer = (props)=>{
     const { children } = props;
-    const [cssColors, setCssColors] = useState(()=>({
-            background: readCssVarColor('--background'),
-            destructive: readCssVarColor('--destructive'),
-            primary: readCssVarColor('--primary'),
-            foreground: readCssVarColor('--foreground'),
-            warning: readCssVarColor('--warning'),
-            success: readCssVarColor('--success'),
-            muted: readCssVarColor('--muted'),
-            mutedForeground: readCssVarColor('--muted-foreground'),
-            border: readCssVarColor('--border'),
-            popover: readCssVarColor('--popover'),
-            accent: readCssVarColor('--accent')
-        }));
+    const [cssColors, setCssColors] = useState(readAllCssVarColors);
     useEffect(()=>{
         if ('production' === process.env.NODE_ENV) return ()=>{};
         const observer = new MutationObserver((mutations)=>{
@@ -119,19 +124,7 @@ const AppContainer_AppContainer = (props)=>{
                     const maxRetries = 10;
                     const retryDelay = 400;
                     const updateColors = ()=>{
-                        const newColors = {
-                            background: readCssVarColor('--background'),
-                            destructive: readCssVarColor('--destructive'),
-                            primary: readCssVarColor('--primary'),
-                            foreground: readCssVarColor('--foreground'),
-                            warning: readCssVarColor('--warning'),
-                            success: readCssVarColor('--success'),
-                            muted: readCssVarColor('--muted'),
-                            mutedForeground: readCssVarColor('--muted-foreground'),
-                            border: readCssVarColor('--border'),
-                            popover: readCssVarColor('--popover'),
-                            accent: readCssVarColor('--accent')
-                        };
+                        const newColors = readAllCssVarColors();
                         setCssColors((currentColors)=>{
                             if (JSON.stringify(currentColors) !== JSON.stringify(newColors)) {
                                 retryCount = 0;
@@ -203,7 +196,10 @@ const AppContainer_AppContainer = (props)=>{
     };
     return /*#__PURE__*/ jsxs(Fragment, {
         children: [
-            /*#__PURE__*/ jsx(safety, {}),
+            /*#__PURE__*/ jsx(Suspense, {
+                fallback: null,
+                children: /*#__PURE__*/ jsx(Safety, {})
+            }),
             /*#__PURE__*/ jsx(QueryProvider, {
                 children: /*#__PURE__*/ jsx(ConfigProvider, {
                     locale: zh_CN,

package/lib/components/AppContainer/safety.js

@@ -1,59 +1,58 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { Popover, PopoverContent, PopoverTrigger } from "../ui/popover.js";
-import { getCsrfToken } from "../../utils/getCsrfToken.js";
 import { getAppId } from "../../utils/getAppId.js";
+import { getCsrfToken } from "../../utils/getCsrfToken.js";
 import { isNewPathEnabled } from "../../utils/apiPath.js";
 import { useIsMobile } from "../../hooks/index.js";
 import { X } from "lucide-react";
 import { Sheet, SheetContent, SheetTrigger } from "../ui/drawer.js";
+import { t } from "../../locales/index.js";
 const Component = ()=>{
     const HasClosedKey = `miaoda-creatByMiaoda-has-closed-${getAppId()}`;
     const [visible, setVisible] = useState(!window.localStorage?.getItem(HasClosedKey));
     const [open, setOpen] = useState(false);
     const isMobile = useIsMobile();
-    const [userinfo, setUserinfo] = useState(null);
-    const [isInternetVisible, setIsInternetVisible] = useState(false);
-    const [showBadge, setShowBadge] = useState(true);
-    const [badgeLoaded, setBadgeLoaded] = useState(false);
     const timeoutRef = useRef(null);
+    const platformData = window.__platform_data__ || window.__platform__ || {};
+    const appId = getAppId() || platformData.appId;
+    const showBadge = false !== platformData.showBadge;
+    const [tenantName, setTenantName] = useState('');
+    const [isInternetVisible, setIsInternetVisible] = useState(false);
     useEffect(()=>{
-        const appId = getAppId();
+        if (!showBadge || !visible) return;
+        const csrfToken = getCsrfToken() ?? '';
         const csrfHeaders = {
-            'X-Suda-Csrf-Token': getCsrfToken()
+            'X-Suda-Csrf-Token': csrfToken
         };
         const tenantInfoUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/tenant_info` : `/spark/b/${appId}/tenant_info`;
         fetch(tenantInfoUrl, {
             headers: csrfHeaders
         }).then((res)=>res.json()).then((data)=>{
-            setUserinfo(data?.data?.tenant_info);
-            setIsInternetVisible(data?.data?.is_internet_visible);
-        }).catch(()=>{});
-        const getPublishedUrl = isNewPathEnabled() ? `/app/${appId}/__runtime__/api/v1/studio/get_published` : `/spark/b/${appId}/get_published`;
-        fetch(getPublishedUrl, {
-            headers: csrfHeaders
-        }).then((res)=>res.json()).then((data)=>{
-            const badge = data?.data?.app_info?.show_badge;
-            setShowBadge(false !== badge);
-        }).catch(()=>{
-            setShowBadge(true);
-        }).finally(()=>{
-            setBadgeLoaded(true);
+            if (data?.status_code === '0' || data?.code === 0) {
+                setTenantName(data?.data?.tenant_info?.name || '');
+                setIsInternetVisible(data?.data?.is_internet_visible || false);
+            }
+        }).catch((e)=>{
+            console.warn('Failed to fetch tenant info:', e);
         });
-    }, []);
+    }, [
+        appId,
+        showBadge,
+        visible
+    ]);
     useEffect(()=>{
         if (isMobile) {
             const link = document.createElement('link');
             link.rel = 'preload';
             link.as = 'image';
-            link.href = 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-mobile.png';
+            link.href = t('safety.cover.mobile');
             document.head.appendChild(link);
         }
     }, [
         isMobile
     ]);
     if ('production' !== process.env.NODE_ENV) return null;
-    if (!badgeLoaded) return null;
     if (!showBadge) return null;
     if (!visible) return null;
     if (isMobile) return /*#__PURE__*/ jsxs(Sheet, {
@@ -74,7 +73,7 @@ const Component = ()=>{
                         }),
                         /*#__PURE__*/ jsx("p", {
                             className: "shrink-0 min-w-[28px] m-0! text-[#EBEBEB]",
-                            children: "妙搭"
+                            children: t('safety.badge.label')
                         })
                     ]
                 })
@@ -90,7 +89,7 @@ const Component = ()=>{
                             onClick: ()=>setOpen(false)
                         }),
                         /*#__PURE__*/ jsx("img", {
-                            src: "https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-mobile.png",
+                            src: t('safety.cover.mobile'),
                             alt: "",
                             className: "w-full h-full",
                             onClick: ()=>{
@@ -110,12 +109,11 @@ const Component = ()=>{
                                                     src: "https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/icon/icon_company_outlined.svg",
                                                     className: "shrink-0 w-[14px] h-[14px]"
                                                 }),
-                                                /*#__PURE__*/ jsxs("p", {
+                                                /*#__PURE__*/ jsx("p", {
                                                     className: "shrink-0 min-w-[96px] m-0! text-[#646A73] text-sm",
-                                                    children: [
-                                                        userinfo?.name,
-                                                        "运营"
-                                                    ]
+                                                    children: t('safety.tenant.operated', {
+                                                        name: tenantName
+                                                    })
                                                 })
                                             ]
                                         }),
@@ -128,7 +126,7 @@ const Component = ()=>{
                                                 }),
                                                 /*#__PURE__*/ jsx("p", {
                                                     className: "shrink-0 min-w-[163px] m-0! text-[#646A73] text-sm",
-                                                    children: "包含 AI 生成内容，请注意甄别"
+                                                    children: t('safety.ai.disclaimer')
                                                 })
                                             ]
                                         })
@@ -146,14 +144,14 @@ const Component = ()=>{
                                                 setTimeout(()=>setVisible(false), 200);
                                                 window.localStorage?.setItem(HasClosedKey, 'true');
                                             },
-                                            children: "不再展示"
+                                            children: t('safety.button.dontShowAgain')
                                         }),
                                         /*#__PURE__*/ jsx("div", {
                                             className: "flex-1 flex rounded-[99px] items-center justify-center border-[0.5px] border-black bg-black text-white cursor-pointer text-lg py-[12px]",
                                             onClick: ()=>{
                                                 window.open('https://miaoda.feishu.cn/landing', '_blank');
                                             },
-                                            children: "了解更多"
+                                            children: t('safety.button.learnMore')
                                         })
                                     ]
                                 })
@@ -186,7 +184,7 @@ const Component = ()=>{
                         }),
                         /*#__PURE__*/ jsx("p", {
                             className: "shrink-0 min-w-[60px] m-0! text-[#EBEBEB]",
-                            children: "由妙搭搭建"
+                            children: t('safety.badge.builtWith')
                         })
                     ]
                 })
@@ -210,7 +208,7 @@ const Component = ()=>{
                     className: "flex flex-col bg-[#1A1A1A]",
                     children: [
                         /*#__PURE__*/ jsx("img", {
-                            src: "https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover.png",
+                            src: t('safety.cover.pc'),
                             alt: "",
                             className: "w-[286px] h-[128px] cursor-pointer",
                             onClick: ()=>{
@@ -230,12 +228,11 @@ const Component = ()=>{
                                                     src: "https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/icon/icon_company_outlined.svg",
                                                     className: "shrink-0 w-[12px] h-[12px]"
                                                 }),
-                                                /*#__PURE__*/ jsxs("p", {
+                                                /*#__PURE__*/ jsx("p", {
                                                     className: "shrink-0 min-w-[96px] m-0! text-[#a6a6a6]",
-                                                    children: [
-                                                        userinfo?.name,
-                                                        "运营"
-                                                    ]
+                                                    children: t('safety.tenant.operated', {
+                                                        name: tenantName
+                                                    })
                                                 })
                                             ]
                                         }),
@@ -248,7 +245,7 @@ const Component = ()=>{
                                                 }),
                                                 /*#__PURE__*/ jsx("p", {
                                                     className: "shrink-0 min-w-[163px] m-0! text-[#a6a6a6]",
-                                                    children: "包含 AI 生成内容，请注意甄别"
+                                                    children: t('safety.ai.disclaimer')
                                                 })
                                             ]
                                         })
@@ -266,7 +263,7 @@ const Component = ()=>{
                                                 setVisible(false);
                                                 window.localStorage?.setItem(HasClosedKey, 'true');
                                             },
-                                            children: "不再展示"
+                                            children: t('safety.button.dontShowAgain')
                                         }),
                                         /*#__PURE__*/ jsx("div", {
                                             className: "flex-1 flex rounded-[8px] items-center justify-center h-[34px] border-[0.5px] border-solid border-[#ffffff1c] hover:border-[#ffffff33] bg-[#ffffff08] hover:bg-[#ffffff14] cursor-pointer text-[#ebebeb]",
@@ -274,7 +271,7 @@ const Component = ()=>{
                                             onClick: ()=>{
                                                 window.open('https://miaoda.feishu.cn/landing', '_blank');
                                             },
-                                            children: "了解更多"
+                                            children: t('safety.button.learnMore')
                                         })
                                     ]
                                 })

package/lib/components/ErrorRender/index.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 declare const RenderError: React.FC<{
-    error: Error;
-    resetErrorBoundary?: () => void;
+    error: unknown;
+    resetErrorBoundary?: (...args: unknown[]) => void;
 }>;
 export default RenderError;

package/lib/components/ErrorRender/index.js

@@ -3,6 +3,7 @@ import { useEffect } from "react";
 import { logger } from "../../logger/index.js";
 import { getHmrApi } from "../../utils/hmr-api.js";
 import { submitPostMessage } from "../../utils/postMessage.js";
+import { t } from "../../locales/index.js";
 const RenderError = (props)=>{
     const { error, resetErrorBoundary } = props;
     useEffect(()=>{
@@ -46,7 +47,7 @@ const RenderError = (props)=>{
                 }),
                 /*#__PURE__*/ jsx("p", {
                     className: "text-l/[22px] text-[14px] text-[#1F2329] font-medium",
-                    children: "页面出错了"
+                    children: t('errorRender.title')
                 })
             ]
         })

package/lib/components/NotFoundRender/index.js

@@ -2,16 +2,21 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useLocation } from "react-router-dom";
 import { useEffect } from "react";
 import { logger } from "../../logger/index.js";
+import { t } from "../../locales/index.js";
 const NotFound = ()=>{
     const location = useLocation();
     useEffect(()=>{
         logger.log({
             level: 'error',
             args: [
-                `页面 ${location.pathname} 不存在`
+                t('notFound.logger.pageNotExist', {
+                    path: location.pathname
+                })
             ],
             meta: {
-                repairMessage: `页面 ${location.pathname} 不存在，帮我创建对应页面，并配置到"client/src/app.tsx"路由表中`,
+                repairMessage: t('notFound.logger.repairMessage', {
+                    path: location.pathname
+                }),
                 noStacktrace: true,
                 stacktrace: [],
                 type: 'not-found'
@@ -30,7 +35,7 @@ const NotFound = ()=>{
             }),
             /*#__PURE__*/ jsx("p", {
                 className: "text-l/[22px] text-[14px] text-[#1F2329] font-medium",
-                children: "页面不存在"
+                children: t('notFound.pageNotExist')
             })
         ]
     });

package/lib/components/PagePlaceholder/index.js

@@ -1,6 +1,10 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import "react";
-const PagePlaceholder = ({ title = '页面待开发', description = '页面暂未开发，请耐心等待...' })=>/*#__PURE__*/ jsxs("div", {
+import { t } from "../../locales/index.js";
+const PagePlaceholder_PagePlaceholder = ({ title, description })=>{
+    const defaultTitle = t('pagePlaceholder.title');
+    const defaultDescription = t("pagePlaceholder.description");
+    return /*#__PURE__*/ jsxs("div", {
         className: "flex flex-col items-center justify-center px-6 w-full h-[calc(100vh-64px)] text-center",
         children: [
             /*#__PURE__*/ jsx("img", {
@@ -12,13 +16,14 @@ const PagePlaceholder = ({ title = '页面待开发', description = '页面暂
             }),
             /*#__PURE__*/ jsx("div", {
                 className: "text-center text-foreground text-base font-medium mb-1 leading-6",
-                children: title
+                children: title ?? defaultTitle
             }),
             /*#__PURE__*/ jsx("div", {
                 className: "text-center text-muted-foreground text-base leading-6 line-clamp-2 sm:max-w-[480px]",
-                children: description
+                children: description ?? defaultDescription
             })
         ]
     });
-const components_PagePlaceholder = PagePlaceholder;
-export { components_PagePlaceholder as default };
+};
+const PagePlaceholder = PagePlaceholder_PagePlaceholder;
+export { PagePlaceholder as default };

package/lib/components/User/UserProfile/UserProfileUI.js

@@ -3,6 +3,7 @@ import { useState } from "react";
 import { clsxWithTw } from "../../../utils/utils.js";
 import { getChatAppLink } from "./utils.js";
 import { OverflowTooltipText } from "../../ui/overflow-tooltip-text.js";
+import { t } from "../../../locales/index.js";
 function UserProfileUI({ user }) {
     const [avatarError, setAvatarError] = useState(false);
     const canShowAvatar = Boolean(user.avatar) && !avatarError;
@@ -52,7 +53,7 @@ function UserProfileUI({ user }) {
                                         }),
                                         'inactive' === user.status && /*#__PURE__*/ jsx("span", {
                                             className: "shrink-0 inline-flex items-center rounded-sm bg-destructive px-2 py-0.5 text-xs font-medium text-white",
-                                            children: "暂停使用"
+                                            children: t('userProfile.status.inactive')
                                         })
                                     ]
                                 }),
@@ -75,7 +76,7 @@ function UserProfileUI({ user }) {
                                                     fill: "currentColor"
                                                 })
                                             }),
-                                            "消息"
+                                            t('userProfile.button.message')
                                         ]
                                     })
                                 }) : null
@@ -90,7 +91,7 @@ function UserProfileUI({ user }) {
                                 children: [
                                     /*#__PURE__*/ jsx("span", {
                                         className: "min-w-[74px] text-sm text-muted-foreground",
-                                        children: "部门"
+                                        children: t('userProfile.label.department')
                                     }),
                                     /*#__PURE__*/ jsx("span", {
                                         className: clsxWithTw('flex-1 break-all text-sm text-foreground', {
@@ -105,7 +106,7 @@ function UserProfileUI({ user }) {
                                 children: [
                                     /*#__PURE__*/ jsx("span", {
                                         className: "min-w-[74px] text-sm text-muted-foreground",
-                                        children: "邮箱"
+                                        children: t('userProfile.label.email')
                                     }),
                                     user.email ? /*#__PURE__*/ jsx("a", {
                                         href: `mailto:${user.email}`,

package/lib/components/User/UserSelectUI/UserSelectUI.js

@@ -7,7 +7,9 @@ import { MultipleSelectionTags } from "./MultipleSelectionTags.js";
 import { SingleSelectionPreview } from "./SingleSelectionPreview.js";
 import { ActionButtons } from "./ActionButtons.js";
 import { Dropdown } from "./Dropdown.js";
-const UserSelectUI = ({ mode = 'single', value, onChange, placeholder = '请选择用户', disabled = false, allowClear = true, onSearch, loading = false, options = [] })=>{
+import { t } from "../../../locales/index.js";
+const UserSelectUI = ({ mode = 'single', value, onChange, placeholder, disabled = false, allowClear = true, onSearch, loading = false, options = [] })=>{
+    const defaultPlaceholder = t('userSelect.placeholder');
     const [isOpen, setIsOpen] = useState(false);
     const [searchText, setSearchText] = useState('');
     const [searchResults, setSearchResults] = useState([]);
@@ -135,7 +137,7 @@ const UserSelectUI = ({ mode = 'single', value, onChange, placeholder = '请选
     const singleSelectedUser = 'single' === mode && hasSelection ? selectedUsers[0] : void 0;
     const showSingleSelection = !!singleSelectedUser && 0 === searchText.length;
     const canClear = allowClear && hasSelection && !disabled;
-    const inputPlaceholder = hasSelection ? '' : placeholder;
+    const inputPlaceholder = hasSelection ? '' : placeholder ?? defaultPlaceholder;
     const focusInputAtStart = ()=>{
         const input = inputRef.current;
         if (!input) return;

package/lib/components/ui/confirm.js

@@ -4,11 +4,15 @@ import { createRoot } from "react-dom/client";
 import { Content, Description, Overlay, Portal, Root, Title } from "@radix-ui/react-dialog";
 import { Button } from "./button.js";
 import { clsxWithTw } from "../../utils/utils.js";
+import { t } from "../../locales/index.js";
 function showConfirm(options) {
     const opts = 'string' == typeof options ? {
         message: options
     } : options;
-    const { title = '提示', message, confirmText = '确认', cancelText = '取消', variant = 'default' } = opts;
+    const { title, message, confirmText, cancelText, variant = 'default' } = opts;
+    const defaultTitle = t('confirm.title');
+    const defaultConfirmText = t('confirm.confirmText');
+    const defaultCancelText = t('confirm.cancelText');
     return new Promise((resolve)=>{
         const container = document.createElement('div');
         document.body.appendChild(container);
@@ -26,10 +30,10 @@ function showConfirm(options) {
             resolve(false);
         }
         root.render(/*#__PURE__*/ jsx(ConfirmDialog, {
-            title: title,
+            title: title ?? defaultTitle,
             message: message,
-            confirmText: confirmText,
-            cancelText: cancelText,
+            confirmText: confirmText ?? defaultConfirmText,
+            cancelText: cancelText ?? defaultCancelText,
             variant: variant,
             onConfirm: handleConfirm,
             onCancel: handleCancel

package/lib/index.js

@@ -4,6 +4,7 @@ import { getAppId } from "./utils/getAppId.js";
 import { isNewPathEnabled } from "./utils/apiPath.js";
 import { logger } from "./logger/index.js";
 import { showToast } from "./components/ui/toast.js";
+import { t } from "./locales/index.js";
 import { version } from "../package.json";
 import { showConfirm } from "./components/ui/confirm.js";
 const _appId = getAppId();
@@ -20,7 +21,7 @@ const capabilityClient = createClient({
     },
     logger: logger,
     onRateLimitError: ()=>{
-        showToast('应用额度已耗尽，请联系应用开发者');
+        showToast(t('index.rateLimitError'));
     }
 });
 const src = {

package/lib/integrations/dataloom.d.ts

@@ -1,4 +1,4 @@
-declare const createDataLoomClient: (url?: string, pat?: string) => import("@lark-apaas/dataloom").DataloomClient;
+declare const createDataLoomClient: (url?: string, pat?: string) => import("@data-loom/js").DataloomClient<any, "public", any>;
 /** 获取dataloom实例 */
 export declare function getDataloom(): Promise<ReturnType<typeof createDataLoomClient>>;
 export {};

package/lib/integrations/dataloom.js

@@ -1,7 +1,7 @@
 import { splitWorkspaceUrl } from "../utils/url.js";
-import { createClient } from "@lark-apaas/dataloom";
+import { createClient } from "@data-loom/js";
 import { getAppId } from "../utils/getAppId.js";
-import { getInitialInfo } from "../utils/getInitialInfo.js";
+import { getAppPublished } from "../utils/getInitialInfo.js";
 const createDataLoomClient = (url, pat)=>{
     const { baseUrl, workspace } = url ? splitWorkspaceUrl(url) : {
         baseUrl: '',
@@ -13,7 +13,12 @@ const createDataLoomClient = (url, pat)=>{
             enableDataloomLog: 'production' !== process.env.NODE_ENV,
             requestRateLimit: 'production' !== process.env.NODE_ENV ? 100 : void 0,
             brandName: 'miaoda',
-            appId
+            appId,
+            onError: (error, dataloomInstance)=>{
+                if (error?.status === 401) {
+                    if (error?.code === 'k_ident_013001') dataloomInstance.service.session.redirectToLogin();
+                }
+            }
         }
     });
 };
@@ -22,7 +27,7 @@ let pendingPromise = null;
 function getDataloom() {
     if (dataloom) return Promise.resolve(dataloom);
     if (pendingPromise) return pendingPromise;
-    pendingPromise = getInitialInfo().then((info)=>{
+    pendingPromise = getAppPublished().then((info)=>{
         const DATALOOM_CLIENT_URL = info?.app_runtime_extra?.url;
         const DATALOOM_PAT = info?.app_runtime_extra?.token;
         dataloom = createDataLoomClient(DATALOOM_CLIENT_URL, DATALOOM_PAT);

package/lib/locales/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 获取当前语言环境下的翻译文案。
+ *
+ * 支持 `{key}` 形式的变量替换：
+ * ```ts
+ * t('safety.tenant.operated', { name: '字节' })
+ * // zh → "字节运营"
+ * // en → "Operated by 字节"
+ * ```
+ *
+ * 如果 key 不存在，fallback 到中文；中文也没有则返回 key 本身。
+ */
+export declare function t(key: string, params?: Record<string, string>): string;
+export { getLocale } from '../utils/locale';
+export type { Locale } from '../utils/locale';

package/lib/locales/index.js

@@ -0,0 +1,10 @@
+import messages from "./messages.js";
+import { getLocale } from "../utils/locale.js";
+function t(key, params) {
+    const locale = getLocale();
+    const entry = messages[key];
+    let text = entry?.[locale] ?? entry?.zh ?? key;
+    if (params) for (const [k, v] of Object.entries(params))text = text.replace(`{${k}}`, v);
+    return text;
+}
+export { getLocale, t };

package/lib/locales/messages.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 中英文文案源（统一管理）。
+ *
+ * 每条文案同时包含 zh 和 en，方便对照和维护。
+ * Key 规则：`{组件}.{区域}.{标识}`
+ * 文案来源：https://bytedance.larkoffice.com/wiki/BJCQwv9auiP9erkudMfcVIIGnRg
+ */
+declare const messages: Record<string, {
+    zh: string;
+    en: string;
+}>;
+export default messages;

package/lib/locales/messages.js

@@ -0,0 +1,108 @@
+const messages_messages = {
+    'safety.badge.label': {
+        zh: '妙搭',
+        en: 'Spark'
+    },
+    'safety.badge.builtWith': {
+        zh: '由妙搭搭建',
+        en: 'Built with Spark'
+    },
+    'safety.ai.disclaimer': {
+        zh: '包含 AI 生成内容，请注意甄别',
+        en: 'AI-generated content. Use with care.'
+    },
+    'safety.tenant.operated': {
+        zh: '{name}运营',
+        en: 'Operated by {name}'
+    },
+    'safety.button.dontShowAgain': {
+        zh: '不再展示',
+        en: "Don't show again"
+    },
+    'safety.button.learnMore': {
+        zh: '了解更多',
+        en: 'Learn more'
+    },
+    'safety.cover.pc': {
+        zh: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover.png',
+        en: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-weben.png'
+    },
+    'safety.cover.mobile': {
+        zh: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-mobile.png',
+        en: 'https://lf3-static.bytednsdoc.com/obj/eden-cn/LMfspH/ljhwZthlaukjlkulzlp/logo/miaodacover-mobileen.png'
+    },
+    'index.rateLimitError': {
+        zh: '应用额度已耗尽，请联系应用开发者',
+        en: 'Application quota exhausted, please contact the app developer'
+    },
+    'theme.themeColors.title': {
+        zh: '主题色',
+        en: 'Theme Color'
+    },
+    'theme.themeRadius.title': {
+        zh: '圆角',
+        en: 'Border Radius'
+    },
+    'theme.themeSpaces.title': {
+        zh: '间距',
+        en: 'Spacing'
+    },
+    'errorRender.title': {
+        zh: '页面出错了',
+        en: 'Something went wrong'
+    },
+    'notFound.pageNotExist': {
+        zh: '页面不存在',
+        en: 'Page not found'
+    },
+    'notFound.logger.pageNotExist': {
+        zh: '页面 {path} 不存在',
+        en: 'Page {path} does not exist'
+    },
+    'notFound.logger.repairMessage': {
+        zh: '页面 {path} 不存在，帮我创建对应页面，并配置到"client/src/app.tsx"路由表中',
+        en: 'Page {path} does not exist, help me create the corresponding page and configure it in the "client/src/app.tsx" routing table'
+    },
+    'pagePlaceholder.title': {
+        zh: '页面待开发',
+        en: 'Page coming soon'
+    },
+    "pagePlaceholder.description": {
+        zh: '页面暂未开发，请耐心等待...',
+        en: 'This page is under development, please wait...'
+    },
+    'confirm.title': {
+        zh: '提示',
+        en: 'Confirm'
+    },
+    'confirm.confirmText': {
+        zh: '确认',
+        en: 'Confirm'
+    },
+    'confirm.cancelText': {
+        zh: '取消',
+        en: 'Cancel'
+    },
+    'userSelect.placeholder': {
+        zh: '请选择用户',
+        en: 'Select user'
+    },
+    'userProfile.status.inactive': {
+        zh: '暂停使用',
+        en: 'Inactive'
+    },
+    'userProfile.button.message': {
+        zh: '消息',
+        en: 'Message'
+    },
+    'userProfile.label.department': {
+        zh: '部门',
+        en: 'Department'
+    },
+    'userProfile.label.email': {
+        zh: '邮箱',
+        en: 'Email'
+    }
+};
+const messages = messages_messages;
+export { messages as default };

package/lib/utils/getInitialInfo.d.ts

@@ -13,6 +13,13 @@ interface AppRuntimePublished {
 interface BucketConfig {
     default_bucket_id?: string;
 }
+/**
+ * 从API获取已发布的应用信息（仅全栈沙箱模式下使用）
+ */
+export declare function getAppPublished(): Promise<{
+    app_info?: AppRuntimePublished;
+    app_runtime_extra?: AppRuntimeExtra;
+} | undefined>;
 declare let initialInfo: {
     app_info?: AppRuntimePublished;
     app_runtime_extra?: AppRuntimeExtra;

package/lib/utils/getInitialInfo.js

@@ -1,6 +1,11 @@
 import { getAppId } from "./getAppId.js";
 import { getCsrfToken } from "./getCsrfToken.js";
 import { isNewPathEnabled } from "./apiPath.js";
+function syncBucketIdToWindow(info) {
+    if (!info) return;
+    const bucketId = info.app_runtime_extra?.bucket?.default_bucket_id;
+    if (bucketId) window._bucket_id = bucketId;
+}
 async function getAppPublished() {
     try {
         const headers = {
@@ -18,24 +23,40 @@ async function getAppPublished() {
             credentials: 'include'
         });
         const res = await response.json();
-        if (0 === res.code || '0' === res.status_code) return res.data;
+        if (0 === res.code || '0' === res.status_code) {
+            syncBucketIdToWindow(res.data);
+            return res.data;
+        }
         console.error('Error fetching published app info:', res);
     } catch (error) {
         console.error('Error fetching published app info:', error);
     }
 }
+function getPreloadedInfo() {
+    try {
+        const platformData = window.__platform__?.appPublished;
+        if (platformData && 'object' == typeof platformData) return platformData;
+    } catch  {}
+}
 let initialInfo;
 let pendingPromise = null;
 function getInitialInfo(refresh = false) {
     if (initialInfo && !refresh) return Promise.resolve(initialInfo);
+    if (!initialInfo && !refresh) {
+        const preloaded = getPreloadedInfo();
+        if (preloaded) {
+            initialInfo = preloaded;
+            syncBucketIdToWindow(initialInfo);
+            return Promise.resolve(initialInfo);
+        }
+    }
     if (pendingPromise && !refresh) return pendingPromise;
     pendingPromise = getAppPublished().then((info)=>{
         initialInfo = info;
-        if (initialInfo) window._bucket_id = initialInfo.app_runtime_extra?.bucket?.default_bucket_id;
         return initialInfo;
     }).finally(()=>{
         pendingPromise = null;
     });
     return pendingPromise;
 }
-export { getInitialInfo };
+export { getAppPublished, getInitialInfo };

package/lib/utils/locale.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 统一的语言判断方法。
+ *
+ * 生产环境（`process.env.NODE_ENV === 'production'`）：
+ *   只看浏览器容器语言（navigator.language）。
+ *
+ * 非生产环境（沙箱预览场景）：
+ *   优先级 query > localStorage > navigator。
+ *   URL query `locale`（值为 `zh_CN` / `en_US`）由宿主平台（miaoda）
+ *   通过 iframe src 透传，确保产物内的语言与宿主一致；
+ *   读到 query 时会同步写入 localStorage，便于后续无 query 的跳转/刷新场景使用。
+ *
+ * 返回标准化 locale code：'zh' | 'en'。
+ * 目前只区分中英文，未来扩展时在此调整。
+ */
+export type Locale = 'zh' | 'en';
+export declare function getLocale(): Locale;

package/lib/utils/locale.js

@@ -0,0 +1,41 @@
+const STORAGE_KEY = 'miaoda:preview-locale';
+function toLocale(value) {
+    const lang = value ?? 'zh';
+    return lang.toLowerCase().startsWith('zh') ? 'zh' : 'en';
+}
+function readLocaleFromQuery() {
+    if ('undefined' == typeof window) return null;
+    try {
+        const value = new URLSearchParams(window.location.search).get('locale');
+        return value && value.length > 0 ? value : null;
+    } catch  {
+        return null;
+    }
+}
+function readLocaleFromStorage() {
+    if ('undefined' == typeof window) return null;
+    try {
+        const value = window.localStorage?.getItem(STORAGE_KEY);
+        return value && value.length > 0 ? value : null;
+    } catch  {
+        return null;
+    }
+}
+function writeLocaleToStorage(value) {
+    if ('undefined' == typeof window) return;
+    try {
+        window.localStorage?.setItem(STORAGE_KEY, value);
+    } catch  {}
+}
+function getLocale() {
+    if ('production' === process.env.NODE_ENV) return toLocale(navigator.language);
+    const fromQuery = readLocaleFromQuery();
+    if (fromQuery) {
+        writeLocaleToStorage(fromQuery);
+        return toLocale(fromQuery);
+    }
+    const fromStorage = readLocaleFromStorage();
+    if (fromStorage) return toLocale(fromStorage);
+    return toLocale(navigator.language);
+}
+export { getLocale };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/client-toolkit",
-  "version": "1.2.35-alpha.2",
+  "version": "1.2.35-alpha.3",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.js",
   "files": [
@@ -98,10 +98,10 @@
   "dependencies": {
     "@ant-design/colors": "^7.2.1",
     "@ant-design/cssinjs": "^1.24.0",
+    "@data-loom/js": "0.4.13",
     "@lark-apaas/aily-web-sdk": "^0.0.9",
     "@lark-apaas/auth-sdk": "^0.1.4",
     "@lark-apaas/client-capability": "^0.1.6",
-    "@lark-apaas/dataloom": "0.1.1-alpha.1",
     "@lark-apaas/internal-slardar": "^0.0.3",
     "@lark-apaas/miaoda-inspector": "^1.0.23",
     "@lark-apaas/observable-web": "^1.0.6",