DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.
import type { ComponentType, ReactNode, SVGProps } from 'react'
import { useTranslation } from 'react-i18next'
import { If } from 'react-if-lite'
import { Panel } from '@/components/panel'
import { button } from '@/components/primitives'
/** 图标组件类型(@gravity-ui/icons 均为 SVG 组件) */
export type IconComponent = ComponentType<SVGProps<SVGSVGElement>>
/**
* 通用加载/安装界面。
*
* 不传任何 props 时,渲染结果与官方 web shell 的 boot 加载页
* (packages/client/web 的 AppRoot + AppRoot.module.css)逐项一致:
* wordmark(16px/600/0.08em)+ 20px 2px 单色 spinner(0.8s 旋转,
* 顶弧取 brand-primary,明暗主题下即黑/白)+ 12px/18px hint,16px gap。
* 颜色通过 load-* 系列主题变量精确对应官方 dsw alias token。
* spinner 动画直接抄官方(.animate-load-spin + @keyframes load-spin),
* 不用 Tailwind animate-spin,避免 var() 间接层在 WebView2 下不旋转。
* 传入 icon/title/subtitle/percentage/logs/errorMsg/onRetry 后按需扩展。
*/
export interface LoadableProps {
/** 状态图标(@gravity-ui/icons 组件),仅失败态显示;加载态已有 spinner,不再叠加图标(官方 boot 页无图标) */
icon?: IconComponent
/** wordmark 位文案,默认官网的 "HARNESS" */
title?: string
/** hint 位文案,默认官网的 "Loading plugins…" */
subtitle?: string
/** 进度百分比(0-100),传入则显示进度条 */
percentage?: number
/** 安装日志行,传入则显示日志面板(空数组显示"等待日志"占位) */
logs?: readonly string[]
/** 错误信息,传入则切换为失败态(隐藏 spinner) */
errorMsg?: string
/** 失败态时的重试按钮回调 */
onRetry?: () => void
/** 根节点 `data-testid`(E2E 定位用;不传则不渲染该属性) */
testId?: string
/** 附加内容,渲染在提示文字之后 */
children?: ReactNode
}
export function Loadable({
icon: Icon,
title,
subtitle,
percentage,
logs,
errorMsg,
onRetry,
testId,
children,
}: LoadableProps) {
const { t } = useTranslation()
const error = errorMsg != null
const wordmark = title ?? t('app.wordmark')
const hint = error ? errorMsg : subtitle ?? t('status.loading_plugins')
const hasLogs = logs != null
const showPanel = hasLogs || percentage != null
return (
<div className="flex h-full items-center justify-center bg-startup w-full" data-testid={testId}>
<div className="flex w-[min(460px,88vw)] flex-col items-center gap-4 text-center -mt-[1px]">
{/* 加载态显示 spinner 时隐藏图标(官方 boot 页即无图标),避免与 spinner 重复突兀;仅失败态显示 */}
{/* 加载态显示 spinner 时隐藏图标(官方 boot 页即无图标),避免与 spinner 重复突兀;仅失败态显示 */}
<If cond={error && Icon != null}>
{Icon != null && <Icon className="size-7 text-load-ink" />}
</If>
<span className="text-base leading-6 font-semibold tracking-[0.08em] text-load-ink truncate">{wordmark}</span>
<If
cond={error}
else={(
<>
<span className="h-5 w-5 animate-load-spin rounded-full border-2 border-load-ring border-t-load-ink" />
<p className="min-h-[18px] text-xs leading-[18px] break-all text-load-muted">{hint}</p>
</>
)}
>
{/* 失败态:官方 failed 展示样式(代码字体错误信息) */}
<p className="min-h-[18px] max-w-full font-mono text-xs leading-[18px] break-all text-load-muted">{hint}</p>
</If>
<If cond={onRetry != null}>
<button
className={button({ tone: 'primary' })}
onClick={onRetry}
>
{t('app.retry')}
</button>
</If>
<If cond={showPanel}>
<div className="flex w-full flex-col gap-4">
<Panel.Progress percentage={percentage} logs={logs} />
</div>
</If>
{children}
</div>
</div>
)
}