WorkspaceProps

Defined in: packages/ui-react/src/components/Workspace.tsx:73

Runtime 配置

Extends

UseLokvisOptions

Properties

enableOpfs?

optional enableOpfs?: boolean

Defined in: packages/runtime/src/types.ts:48

是否启用 OPFS（默认 true，降级时关闭）

Inherited from

UseLokvisOptions.enableOpfs

enableIndexedDB?

optional enableIndexedDB?: boolean

Defined in: packages/runtime/src/types.ts:50

是否启用 IndexedDB 元数据存储

Inherited from

UseLokvisOptions.enableIndexedDB

storageQuota?

optional storageQuota?: number

Defined in: packages/runtime/src/types.ts:52

存储配额（字节）

Inherited from

UseLokvisOptions.storageQuota

enableLog?

optional enableLog?: boolean

Defined in: packages/runtime/src/types.ts:54

是否启用日志

Inherited from

UseLokvisOptions.enableLog

engineStrategy?

optional engineStrategy?: EngineSelectionStrategy

Defined in: packages/runtime/src/types.ts:60

引擎选择策略(默认 ‘first’)。当多个引擎实现同一能力且未显式指定 preferredEngine 时,据此选择: ‘first’(注册顺序)/‘fastest’(性能最优)/‘balanced’(匹配能力声明性能,无则最快)。

Inherited from

UseLokvisOptions.engineStrategy

assetStore?

optional assetStore?: AssetStore

Defined in: packages/runtime/src/types.ts:66

注入自定义 AssetStore(测试或精细控制用)。默认由 createRuntime 通过 createAssetStore 工厂自动创建, 按 OPFS → IndexedDB → Memory 降级。

Inherited from

UseLokvisOptions.assetStore

historyStore?

optional historyStore?: HistoryStore

Defined in: packages/runtime/src/types.ts:72

注入自定义 HistoryStore(W7.2 历史持久化)。默认由 createRuntime 在 enableIndexedDB 时通过 createHistoryStore 自动创建; IndexedDB 不可用时为 undefined,历史退化为仅内存模式。

Inherited from

UseLokvisOptions.historyStore

historyStoreOptions?

optional historyStoreOptions?: HistoryStoreOptions

Defined in: packages/runtime/src/types.ts:77

HistoryStore 工厂选项(W7.2,仅 historyStore 未注入时生效)。测试可注入 kvStore 或自定义 dbName。

Inherited from

UseLokvisOptions.historyStoreOptions

isPro?

optional isPro?: boolean

Defined in: packages/runtime/src/types.ts:88

是否启用 Pro 模式(W6.2 / PROJECT_PLAN 17.4)。

false(默认):批量上限 10 文件、并发 4、workflow 槽位 5
true:批量无上限、并发 16、workflow 槽位无限由 cloud 侧 createLokvis({ auth }) 注入 session 后置为 true。

注:isPro 仅控制本地批量/槽位门控(四环)。AI 调用配额由 @lokvis/cloud-bridge 的 CloudBilling 据 plan 精确判定 (‘pro’ 解锁四环但 AI 配额为 0,需 ‘cloud_pro’ 才有 AI 配额)。

Inherited from

UseLokvisOptions.isPro

plan?

optional plan?: Plan

Defined in: packages/runtime/src/types.ts:99

用户订阅计划(G1)。比 isPro 更细粒度,用于 AI 调用计费判定。

‘free’(默认):免费用户,isPro=false
‘pro’:Pro 订阅($9/月),isPro=true(解锁四环),AI 配额=0
‘cloud_pro’:Cloud Pro 订阅,isPro=true,AI 配额=10/天
‘enterprise’:企业版,isPro=true,AI 配额=∞

由 SDK 据 auth.plan 注入;未传时默认 ‘free’。 isPro 派生自 plan !== 'free'(在 SDK resolvePlan 中计算)。

Inherited from

UseLokvisOptions.plan

memoryBudget?

optional memoryBudget?: number

Defined in: packages/runtime/src/types.ts:104

内存预算(字节,W3.3 MemoryGuard)。默认 512MB。BatchProcessor 据此在内存压力高时收缩并发槽位。

Inherited from

UseLokvisOptions.memoryBudget

title?

optional title?: string

Defined in: packages/ui-react/src/components/Workspace.tsx:75

顶部标题

locale?

optional locale?: "en" | "zh" | "ja" | "es" | "de" | "fr"

Defined in: packages/ui-react/src/components/Workspace.tsx:80

显式 UI 语言（优先级最高）。不传时依次回退:外层 WorkspaceI18nProvider → document.documentElement.lang → URL 路径前缀。

translations?

optional translations?: WorkspaceTranslations

Defined in: packages/ui-react/src/components/Workspace.tsx:85

翻译覆盖表（key → language → 文案）,部分覆盖包内 6 语言字典。不传时继承外层 WorkspaceI18nProvider 的 translations。

showStatusBar?

optional showStatusBar?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:87

是否显示状态栏（默认 true）

showHistoryPanel?

optional showHistoryPanel?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:89

是否显示历史面板（默认 true,W7.1）

enableGlobalDropzone?

optional enableGlobalDropzone?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:91

是否启用全屏拖拽导入（默认 true,W9.3）

enableCommandPalette?

optional enableCommandPalette?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:93

是否启用 Command Palette ⌘K（默认 true,W9.2）

enableThemeToggle?

optional enableThemeToggle?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:95

是否启用 ThemeToggle（默认 true,W9.7）

enableCompare?

optional enableCompare?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:97

是否启用 CompareSlider（默认 true,W9.4）

enableDownloadPanel?

optional enableDownloadPanel?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:99

是否启用 DownloadPanel（默认 true,W9.5）

enableWorkflowEditor?

optional enableWorkflowEditor?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:101

是否启用拖拽式 WorkflowEditor（默认 false,W10.4;关闭则用只读 PipelineBar）

enableProgressBar?

optional enableProgressBar?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:103

是否启用 ProgressBar + Cancel 按钮（默认 true,W11.6）

enableErrorBanner?

optional enableErrorBanner?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:105

是否启用 ErrorBanner 错误信息横幅（默认 true,W11.3）

enableShareLink?

optional enableShareLink?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:107

是否从 URL ?workflow= 参数加载分享工作流（默认 true,W11.5）

initialAssets?

optional initialAssets?: object[]

Defined in: packages/ui-react/src/components/Workspace.tsx:113

初始化时自动导入的资产列表。 Runtime 就绪后,通过 runtime.importAsset() 逐个导入。

blob

blob: Blob

name

name: string

initialCapability?

optional initialCapability?: string

Defined in: packages/ui-react/src/components/Workspace.tsx:117

初始化时预选的能力名称(自动添加到工作流节点)。

initialParams?

optional initialParams?: Record<string, unknown>

Defined in: packages/ui-react/src/components/Workspace.tsx:121

初始化时预填的参数(与 initialCapability 配合使用)。

mode?

optional mode?: "full" | "focused"

Defined in: packages/ui-react/src/components/Workspace.tsx:127

布局模式:

‘full’: 完整三栏布局(默认)
‘focused’: 精简模式,隐藏 AssetPanel 和 PipelineBar,适合单工具页跳转进入

showAssetPanel?

optional showAssetPanel?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:130

是否显示左侧资产面板(默认 true;focused 模式下始终隐藏)

showInspector?

optional showInspector?: boolean

Defined in: packages/ui-react/src/components/Workspace.tsx:132

是否显示右侧 Inspector 面板(默认 true;关闭后整列不渲染)

canvasSlot?

optional canvasSlot?: ReactNode

Defined in: packages/ui-react/src/components/Workspace.tsx:138

替换中央画布(整体替换内置 Canvas)。传入时内置 Canvas(含预览 / 对比 / 拖拽导入)不渲染; 三方需要完全自定义预览区时使用。渲染在 flex-1 容器内。

inspectorSlot?

optional inspectorSlot?: ReactNode

Defined in: packages/ui-react/src/components/Workspace.tsx:144

替换右侧 Inspector 内容(整体替换内置 Inspector)。传入时内置 Inspector(节点参数表单)不渲染,插件 Panel (inspector 位置)仍会在其下方渲染。渲染在 flex-1 容器内。

canvasEmptyState?

optional canvasEmptyState?: ReactNode

Defined in: packages/ui-react/src/components/Workspace.tsx:149

自定义画布空状态(无选中资产时),替换内置导入引导。透传给内置 Canvas 的 emptyState;canvasSlot 设置时本项无效。

className?

optional className?: string

Defined in: packages/ui-react/src/components/Workspace.tsx:151

plugins?

optional plugins?: PluginLoadEntry[]

Defined in: packages/ui-react/src/hooks/useLokvis.ts:35

预加载的插件列表

Inherited from

UseLokvisOptions.plugins

autoInit?

optional autoInit?: boolean

Defined in: packages/ui-react/src/hooks/useLokvis.ts:37

是否在挂载时自动初始化（默认 true）

Inherited from

UseLokvisOptions.autoInit

auth?

optional auth?: LokvisAuthSession

Defined in: packages/ui-react/src/hooks/useLokvis.ts:47

Cloud 注入的认证信息(W17.3 / W17.6)。

透传到 createLokvis({ auth }),SDK 据 presence 推导 isPro:

传入非空 session 或 token 且未显式 isPro: false → Pro 模式
不传 auth:保持 free 模式

详见 @lokvis/sdk 的 LokvisAuthSession 与 resolveIsPro() 文档。

Inherited from

UseLokvisOptions.auth