理念总览
Tuffex 的理念、套件与完整组件索引
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 仍可能调整。侧边栏只标出仍需关注的页面。
| Component | Sync 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 任务看板:四列任务看板,拖拽换列,方向键也能移动卡片
基础组件
通用
- Button 按钮
- Icon 图标
- Avatar 头像
- Avatar Variants 头像变体
- Tag 标签
- Badge 徽标
- StatusBadge 状态徽标
- IconChip 图标角标
- Kbd 快捷键
- Divider 分割线
- Text 文本
表单
- Form 表单
- ModalForm 弹窗表单
- DrawerForm 抽屉表单
- StepsForm 分步表单
- Input 输入
- SensitiveInput 敏感输入框
- Textarea 多行输入
- NumberInput 数字输入
- SearchInput 搜索输入框
- TagInput 标签输入
- ScrubField 拖拽数值域
- Select 选择器
- FlatSelect 扁平选择
- SearchSelect 搜索选择器
- TreeSelect 树选择器
- Cascader 级联选择
- Picker 滚轮选择
- DatePicker 日期选择
- IconPicker 图标选择器
- Radio 单选框
- FlatRadio 平铺单选
- Checkbox 复选框
- Switch 开关
- Slider 滑块
- SegmentedSlider 分段滑块
- Rating 评分
- FileUploader 文件上传
- ImageUploader 图片上传
布局
- Container 容器
- Flex 弹性布局
- Grid 栅格
- GridLayout 网格布局
- Stack 堆叠
- Splitter 分割面板
- Scroll 滚动
- Collapse 折叠
- Card 卡片
- CardItem 卡片项
- GroupBlock 分组块
导航
- Tabs 标签页
- TabBar 底部导航
- NavBar 导航栏
- SidebarNav 侧边导航
- Breadcrumb 面包屑
- Steps 步骤条
- Pagination 分页
- DropdownMenu 下拉菜单
- FlatDropdown 扁平下拉
- ContextMenu 右键菜单
数据展示
- DataTable 数据表格
- Descriptions 描述列表
- Tree 树形
- SortableList 拖拽排序
- Timeline 时间线
- Transfer 穿梭框
- StatCard 指标卡片
- CellLink 单元格链接
- DotIndicator 圆点指示器
- FilterChips 筛选胶囊
- MarkdownView Markdown 渲染
- ImageGallery 图片画廊
- ImagePreview 图片预览
反馈
- Dialog 弹窗
- Modal 模态框
- Drawer 抽屉
- Popover 弹出层
- Tooltip 提示
- Toast 提示
- ToastPanel 浮出面板
- Alert 提示条
- StatusHint 状态提示
- Progress 进度
- ProgressBar 进度条
- Spinner 加载
- LoadingOverlay 加载遮罩
- SelectionActions 划词工具条
状态占位
- Empty 空状态
- EmptyState 空态引导
- NoData 无数据
- NoSelection 未选择
- SearchEmpty 搜索空态
- ErrorState 错误状态
- OfflineState 离线
- PermissionState 权限不足
- GuideState 引导状态
- BlankSlate 空白页
- LoadingState 加载态
- Skeleton 骨架屏
- LayoutSkeleton 布局骨架
进阶套件
高级交互
- CommandPalette 命令面板
- SearchPanel 内联搜索面板
- MarkdownEditor Markdown 编辑器
- CodeEditor 代码编辑器
- Terminal 终端显示
- VirtualList 虚拟列表
- VersionCapsule 版本胶囊
- MotionForm 动效表单
- MotionControl 复合控件
- MotionMetric 复合指标
视觉效果
- GlassSurface 玻璃拟态
- TouchSurface 触摸表面
- GradientBorder 渐变边框
- OutlineBorder 描边容器
- BorderBeam 流光边框
- PrismGlow 棱镜光
- CornerOverlay 角标容器
- GradualBlur 渐变模糊
- EdgeFadeMask 边缘渐隐遮罩
- GlowText 扫光
- KeyframeStrokeText 关键帧描边
- TuffLogoStroke Logo 描边
- TextMorph 文本形变
- IconMorph 图标形变
- Morph 形变容器
- TextTransformer 文本变换
- Transition 动效
- Stagger 依次进入
- Fusion 交融
- FusionSurface 融合表面
- FlowLight 流光底
- Liquid 液态流体
- FlipOverlay 翻转遮罩
- ImageGeneration 生图占位
- MetalFx 液态金属
- VoiceBeam 语音光束
底层原语
AI 套件
部分移植自 Beautiful UI(MIT)。
对话
- Chat 消息列表
- ChatComposer 消息输入
- PromptBar 提示条
- AttachmentTray 附件区
- ModeChip 模式芯片
- MessageActions 消息操作条
- SuggestionChips 建议胶囊
- ChoiceCard 选项卡片
- TypingIndicator 打字中
- ConversationStream 会话流
- VoiceClip 语音条
智能体
- Agents 智能体列表
- AgentScreen 智能体屏幕
- AgentTrace 智能体轨迹
- TaskRows 任务行
- ToolCallCard 工具调用卡片
- ToolChips 工具调用流
- ToolConfirmation 工具授权
- ApprovalCard 澄清问卷卡
- WorkingIndicator 工作指示器
- BotAvatar 机器人头像
- Miko 桌面伴侣猫
推理与生成
- AI Elements AI 对话元素
- ChainOfThought 推理时间线
- ReasoningDisclosure 推理过程
- ThinkingOrb 思考指示球
- StreamElement 流式回答
- StreamText 流式文字
- StreamMarkdown 流式 Markdown
- CodeStream 流式代码块
- InlineCitation 行内引用
- Sources 引用来源
上下文与洞察
数据
图表
- Charts 图表
- Chart Colors 图表色板
- ECharts 图表
- TimeseriesChart 时序图
- LearningCurve 学习曲线
- Maps 地图
- MonoChart 单色图表
- SankeyChart 桑基图
- Custom Chart 自定义图表
可视化
流程
流程编排
动效
按钮
卡片展开
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必填)。