组件/理念总览

理念总览

Tuffex 的理念、套件与完整组件索引

Verified自 0.3.9

Tuffex(@talex-touch/tuffex)是服务 CoreBox、插件界面与本文档站的 Vue 3 组件库。

理念

页面内容
安装与引入三种引入方式与样式文件
设计基础G2 曲率、琉光折射、暗色光学、13-14px 排版与 Token 体系
设计工程概念手册18 篇深度专栏:物理曲率、着色器色散、微动效与流式防抖
主题定制覆盖 token、深色与高对比度
图标体系TxIcon 如何解析与加载图标
无障碍焦点、动效、对比度与 ARIA 约定
Utils 工具函数层级、提示、对话框与动画工具
Sound 交互音效默认关闭的合成反馈音
组件变更历程版本历程与 Since 索引

套件总览

套件分组页数引入入口
理念安装、设计规则、概念手册与工具27纯文档
模板应用框架 / 内容运营 / AI 应用 / 数据与流程25组合现有入口
基础套件通用 / 表单 / 布局 / 导航 / 数据展示 / 反馈 / 状态占位100@talex-touch/tuffex/base
进阶套件高级交互 / 视觉效果 / 底层原语41@talex-touch/tuffex/pro
AI 套件对话 / 智能体 / 推理与生成 / 上下文与洞察36@talex-touch/tuffex/ai
数据套件图表 / 可视化12@talex-touch/tuffex/pro + /charts
流程套件流程编排1@talex-touch/tuffex/ai
动效套件按钮、轮播、加载、文字、转场等 10 组12@talex-touch/tuffex/pro + /charts
  • 页数按文档条目计,不含套件总览页,不等于导出组件数。
  • 套件入口只有 base、pro、ai 三个;数据、流程、动效是文档分类,图表另有 @talex-touch/tuffex/charts。

组合示例

发布工作台

Dashboard / Admin 页面的组合基线

Loading demo...

教程路径

  • 先读《Tuffex 组合界面教程》,按「操作区 → 状态区 → 数据区」切分页面。
  • 整页场景先看下方的「模板」一节。每个模板都是一整页的现成组合,先套用它的结构,再替换为真实数据。
  • 列表页用 TxSearchInput、TxSearchSelect、TxSearchEmpty 串起搜索与无结果恢复,TxDataTable + TxPagination 承载数据。
  • 数据区同时设计加载、空态与错误:TxLoadingState、TxEmptyState、TxErrorState。
  • 后台页组合 TxDataTable、TxStatusBadge、TxProgressBar 与图表,不手写一次性 SVG 或状态 UI;设置页用 TxTabs 分区、TxDrawer 承载高密度配置。

迁移状态看板

已确认:人工审阅完成;已迁移:AI 迁移,建议对照源码;迁移中 / 未迁移:示例与 API 仍可能调整。侧边栏只标出仍需关注的页面。

ComponentSync Status
3D carousel— Not migrated
Accessibility— Not migrated
Account— Not migrated
Agent Chat— Not migrated
Agents— Not migrated
AgentScreen— Not migrated
AgentTrace— Not migrated
AI Answer— Not migrated
AI Elements— Not migrated
AI Suite— Not migrated
Alert— Not migrated
AllocationBar— Not migrated
ApprovalCard— Not migrated
Attachment Tray— Not migrated
Automation— Not migrated
AutoSizer— Not migrated
Avatar— Not migrated
Avatar Variants— Not migrated
Badge— Not migrated
BaseAnchor— Not migrated
BaseSurface— Not migrated
Basics Suite— Not migrated
BlankSlate— Not migrated
BorderBeam— Not migrated
BotAvatar— Not migrated
Breadcrumb— Not migrated
Button— Not migrated
Card— Not migrated
Card spread— Not migrated
CardItem— Not migrated
Cascader— Not migrated
CellLink— Not migrated
Chain of Thought— Not migrated
Chart Colors— Not migrated
Charts— Not migrated
Chat— Not migrated
ChatComposer— Not migrated
Checkbox— Not migrated
ChoiceCard— Not migrated
CMS— Not migrated
CodeEditor— Not migrated
CodeStream— Not migrated
Collapse— Not migrated
CommandPalette— Not migrated
Component Changelog & Lifecycle— Not migrated
Container— Not migrated
Context Indicator— Not migrated
ContextCards— Not migrated
ContextMenu— Not migrated
Conversation Stream— Not migrated
CornerOverlay— Not migrated
Custom Chart— Not migrated
Dashboard— Not migrated
Data Suite— Not migrated
DataTable— Not migrated
DatePicker— Not migrated
Descriptions— Not migrated
Design Foundations— Not migrated
Dialog— Not migrated
DiffTable— Not migrated
DitherChart— Not migrated
Divider— Not migrated
Docs— Not migrated
DotIndicator— Not migrated
Drawer— Not migrated
DrawerForm— Not migrated
DropdownMenu— Not migrated
ECharts Family— Not migrated
EdgeFadeMask— Not migrated
Empty— Not migrated
EmptyState— Not migrated
ErrorState— Not migrated
Experiments— Not migrated
Files— Not migrated
FileUploader— Not migrated
FilterChips— Not migrated
FineTuneCard— Not migrated
FlatDropdown— Not migrated
FlatRadio— Not migrated
FlatSelect— Not migrated
Flex— Not migrated
Flip book— Not migrated
FlipOverlay— Not migrated
Floating— Not migrated
Flow Suite— Not migrated
Flowchart— Not migrated
FlowLight— Not migrated
Form— Not migrated
Fusion— Not migrated
FusionSurface— Not migrated
Gallery— Not migrated
GlassSurface— Not migrated
GlowText— Not migrated
GradientBorder— Not migrated
GradualBlur— Not migrated
Grid— Not migrated
GridLayout— Not migrated
GroupBlock— Not migrated
GuideState— Not migrated
Icon— Not migrated
IconChip— Not migrated
IconMorph— Not migrated
IconPicker— Not migrated
Icons— Not migrated
ImageGallery— Not migrated
ImageGeneration— Not migrated
ImagePreview— Not migrated
ImageStudio— Not migrated
ImageUploader— Not migrated
Inbox— Not migrated
InlineCitation— Not migrated
Input— Not migrated
InsightCards— Not migrated
Installation— Not migrated
Kanban— Not migrated
Kbd— Not migrated
KeyframeStrokeText— Not migrated
Launcher— Not migrated
LayoutSkeleton— Not migrated
LearningCurve— Not migrated
Liquid— Not migrated
LoadingOverlay— Not migrated
LoadingState— Not migrated
Maps— Not migrated
MarkdownEditor— Not migrated
MarkdownView Markdown— Not migrated
Message Actions— Not migrated
MetalFx— Not migrated
Miko Desktop Companion— Not migrated
Modal— Not migrated
ModalForm— Not migrated
ModeChip— Not migrated
MonoChart— Not migrated
Morph— Not migrated
Motion— Not migrated
Motion dock— Not migrated
Motion loader— Not migrated
Motion Suite— Not migrated
MotionButton— Not migrated
MotionControl— Not migrated
MotionForm— Not migrated
MotionMetric— Not migrated
MotionText— Not migrated
MotionToggle— Not migrated
MotionTransition— Not migrated
NavBar— Not migrated
NoData— Not migrated
NoSelection— Not migrated
Notes— Not migrated
NumberInput— Not migrated
OfflineState— Not migrated
Onboarding— Not migrated
OutlineBorder— Not migrated
Pagination— Not migrated
PermissionState— Not migrated
Physics motion— Not migrated
Picker— Not migrated
Popover— Not migrated
PrismGlow— Not migrated
Pro Suite— Not migrated
Progress— Not migrated
ProgressBar— Not migrated
PromptBar— Not migrated
Radio— Not migrated
Rating— Not migrated
Reasoning Disclosure— Not migrated
RecommendationCard— Not migrated
Release— Not migrated
Research— Not migrated
ResizeBox— Not migrated
SankeyChart— Not migrated
Scroll— Not migrated
ScrubField— Not migrated
Search results— Not migrated
SearchEmpty— Not migrated
SearchInput— Not migrated
SearchPanel— Not migrated
SearchSelect— Not migrated
SegmentedSlider— Not migrated
Select— Not migrated
SelectionActions— Not migrated
SensitiveInput— Not migrated
Settings— Not migrated
Shell— Not migrated
Showcase— Not migrated
SidebarNav— Not migrated
SignalMeter— Not migrated
Skeleton— Not migrated
Slider— Not migrated
SortableList— Not migrated
Sound— Not migrated
Sources— Not migrated
SparkChart— Not migrated
Spinner— Not migrated
Splitter— Not migrated
Stack— Not migrated
Stagger— Not migrated
StatCard— Not migrated
StatusBadge— Not migrated
StatusHint— Not migrated
Steps— Not migrated
StepsForm— Not migrated
Store— Not migrated
Stream Markdown— Not migrated
StreamElement— Not migrated
StreamText— Not migrated
Suggestion Chips— Not migrated
Switch— Not migrated
TabBar— Not migrated
Tabs— Not migrated
Tag— Not migrated
TagInput— Not migrated
TaskRows— Not migrated
Terminal— Not migrated
Text— Not migrated
Textarea— Not migrated
TextMorph— Not migrated
TextTransformer— Not migrated
Theming— Not migrated
Thinking Orb— Not migrated
Timeline— Not migrated
TimeseriesChart— Not migrated
Toast— Not migrated
ToastPanel— Not migrated
Tool Call Card— Not migrated
Tool Confirmation— Not migrated
ToolChips— Not migrated
Tooltip— Not migrated
TouchSurface— Not migrated
Transfer— Not migrated
Transition— Not migrated
Tree— Not migrated
TreeSelect— Not migrated
TuffLogoStroke— Not migrated
TypingIndicator— Not migrated
Utils— Not migrated
VersionCapsule— Not migrated
VirtualList— Not migrated
Voice— Not migrated
VoiceBeam— Not migrated
VoiceClip— Not migrated
Workbench— Not migrated
WorkingIndicator— Not migrated

模板

模板是整页组合:用现有组件拼成一个完整页面,放在统一的舞台里展示。模板只存在于文档中,不是可导入的组件。

应用框架

  • 应用外壳:侧栏、命令面板、通知与看板组成的应用外壳
  • 启动器:仿 CoreBox、带实时预览的键盘优先启动器
  • 设置:分区导航、分组设置行、改动即时保存的设置中心
  • 引导:从登录、工作区、偏好到系统权限的五步首启引导
  • 插件工作台:带文件树、代码编辑器、终端与热重载预览的插件开发工作台
  • 账户中心:资料、安全、会话与通知,删除会话需确认

内容运营

  • CMS:带状态筛选、批量操作与抽屉编辑的内容后台
  • 图库:带合集、三种布局与作品详情的作品墙
  • 收件箱:带键盘快捷键与新邮件提示的三栏收件箱
  • 文件:带文件夹树、多选、右键菜单与拖入上传的文件管理器
  • 商店:带精选、搜索、权限详情与安装流程的插件商店
  • 文档:带目录树、本页目录与 ⌘K 检索的帮助中心阅读器
  • 协作笔记:带笔记本目录、所见即所得编辑与多人协作的笔记应用
  • 版本亮点:用动效标题、卡片轮播与指标讲清一次版本更新的发布页
  • 搜索结果:带类型与时间筛选、分页的搜索结果页

AI 应用

  • 智能体对话:带权限闸门、实时计划与改动面板的编码智能体会话
  • AI 回答:流式写出、带编号引用与追问的多轮问答
  • 研究:带研究过程、编号引用与证据栏的研究助手
  • 语音速记:边录边转写、录完生成摘要与待办的语音速记
  • 图像工作室:带风格参数、生成占位与大图预览的图像生成工作室

数据与流程

  • 仪表盘:带指标卡、趋势图与热门插件表的产品数据看板
  • 自动化:带流程画布、节点配置与运行日志的自动化编辑器
  • 发布:从 CI 构建到灰度放量、由人审批的发布控制台
  • 训练实验:对比多次训练运行的曲线、超参扫描与配置的实验看板
  • Kanban 任务看板:四列任务看板,拖拽换列,方向键也能移动卡片

基础组件

通用

表单

布局

导航

数据展示

反馈

状态占位

进阶套件

高级交互

视觉效果

底层原语

AI 套件

部分移植自 Beautiful UI(MIT)。

对话

智能体

推理与生成

上下文与洞察

数据

图表

可视化

流程

流程编排

动效

按钮

卡片展开

3D 轮播

加载动效

抖动图表

文字

物理动效

悬停、指针与滚动

切换控件

转场

技术实现

  • 导出组件 slug 集合:packages/tuffex/packages/components/src/components.ts;本页须链接每个已文档化的导出组件,由 apps/nexus/test/docs/tuffex-component-docs-coverage.test.ts 校验。
  • 演示注册表:apps/nexus/app/components/content/demo-registry.ts;套件预览网格:apps/nexus/app/components/docs/DocsComponentsGallery.vue(suite 必填)。