组件
129 个无框架组件,9 个分组。全部消费同一套设计令牌——切换右上角的预设、明暗与风格,每张卡片即刻换装。 卡角 Core = 1.0 冻结轨道;Beta = 图表 / AI / 知识库演进层,随 minor 快速迭代。
基础
11 Core 界面图标 icon 同一套精确绘制的 SVG 图标:操作、方向与状态通用,可输出服务端 HTML 或原生 DOM。 Core 外观切换 theme-switcher 外观切换控件:主题、原语、明暗共享全局状态,六种展示 × 四档尺寸。 Core 按钮 btn 动作触发控件:5 变体 × 3 尺寸,覆盖图标、加载、错误与通栏形态。 Core 面板 panel 承载一组相关内容的卡片容器:标题栏、副标题、底栏与可折叠变体。 Core 徽章 pill 行内状态徽章:仅绿 / 黄 / 红三档语义色 + 品牌 accent。 Core 标签 tag 中性展示标签:可关闭、可选中、可带图标,五档配色 × 三档尺寸。 Core 标签页 tabs 分区内容导航:滑动墨水条、完整键盘契约,激活态可同步地址栏。 Core 指标卡 stat 关键指标数值卡 + 自适应网格:趋势 delta、图标、进度环与骨架态。 Core 轻提示 toast 瞬时轻提示:角落滑入、自动消散,success / error / warn / info 四态语义色。 Core 工具条 toolbar 横向承载按钮与控件的宽松容器:分组、分隔、弹性占位与换行。 Core 分栏拖拽 split-pane 可拖拽分栏容器:水平 / 垂直两向,双击复位,键盘可微调。
AI 原生
15 Beta AI 总览 ai-overview AI 族总览:一段可播放的完整对话,把全部能力按真实工作流串起来。 Beta AI 会话 ai-chat AI 会话容器:滚动跟随、消息操作与流式渲染的门面组件。 Beta AI 消息 ai-message 消息行基元:四种角色气泡,多模态部件任意组合。 Beta AI 推理 ai-reasoning 推理块:流式思考的折叠区块,完成后自动收起并回填耗时。 Beta AI 输入台 ai-composer 一个安静、有层次的 AI 输入台:技能、工具、文件与命令触手可及。 Beta AI 工具调用 ai-tool-call 工具调用卡:kind 驱动图标与色调,7 态状态机 + 内联审批。 Beta AI 子智能体 ai-subagent 子智能体卡:递归渲染嵌套活动流,层级用缩进与引导线表达。 Beta AI 差异审阅 ai-diff 差异审阅卡:解析 unified diff,逐文件接受或拒绝。 Beta AI 文件标签 ai-files 文件 chips:增删改三态 × 七类文件修饰的纯 CSS 小组件。 Beta AI 任务清单 ai-todo 任务清单:进度条 + 7 态条目,进行中条目用进行时文案。 Beta AI 用量条 ai-usage 上下文用量双形态:分段条 + 常驻环形指示器,配套审计面板。 Beta AI 上下文面板 ai-context 上下文抽屉:右侧滑入的用量、审计、文件与 MCP 状态总览。 Beta 会话列表 ai-threads AI 会话列表,支持分组(可折叠、归档沉底)与平铺两种模式。 Beta 回答反馈 ai-feedback 回答级反馈组件,有帮助 / 无帮助双钮加踩后原因枚举与提交终态。 Beta 分支切换 ai-branch 回答分支版本切换器「‹ 2/3 ›」,页码加边界方向钮。
知识库
32 Beta 知识库总览 kb kb 族伞形入口:呈现「知识从哪来、可信吗、怎么用」的证据界面,覆盖 7 域 31 个组件。 Beta 行内引用 kb-citation 行内引用角标 + hover 引用卡:把含 `[n]` 的答案文本渲染成「文本 + 角标」混合流。 Beta 来源列表 kb-sources 来源列表:答案上方横排 / 侧栏纵列两种布局,徽标覆盖官方 / 过期 / 受限。 Beta 原文定位 kb-passage 原文定位查看器:右侧抽屉滑入打开来源正文,支持定位、高亮与上下文展开。 Beta 来源冲突 kb-conflict 来源冲突组:同一主张的多版本对勘,claim 警示行 + 版本卡横排。 Beta 解析管线 kb-pipeline 文档解析管线时间线:折叠摘要行 + 步骤列表 + 失败错误区,六态状态机。 Beta 分段编辑器 kb-chunks chunk 编辑器:行内编辑正文与关键词、启停开关、全文 / 语义双通道搜索。 Beta 分段策略 kb-segment 分段策略编辑器:左侧参数表单 + 右侧实时预览,真实切分非估算。 Beta 数据源连接 kb-connector 数据源连接器卡:健康模型映射色条与状态点,信号行 + 凭证徽标。 Beta 元数据 kb-metadata 元数据管理:字段定义表 + 值绑定行内编辑 + 自定义字段增删。 Beta QA 对 kb-qa 认证问答对编辑器:Q / A 两列表格行内编辑,增删行与 CSV 导入。 Beta 检索调试台 kb-retrieval 检索调试 playground:向量 / 关键词 / 混合三模式,参数栏 + 命中列表。 Beta 过滤构建器 kb-filter 行式过滤器构建器:规则行 + AND/OR 组嵌套 + DSL 双表示镜像。 Beta 重排对比 kb-rerank 重排对比三列视图(重排前 | Δ | 重排后),名次变化与双分数一屏看全。 Beta 召回测试 kb-hittest 召回回归测试集:问题列表 + 期望 chunk + 统计头,一键运行全部。 Beta SQL 卡片 kb-sql 生成 SQL 卡片:着色代码 + 引用表 chips + 编辑重跑 + 修正 diff。 Beta 问数答案 kb-answer 问数答案组合容器:快照渲染,认证徽章、正文角标、结果表、图表各槽有才渲。 Beta 澄清反问 kb-clarify 澄清反问卡:选项 chips 点选作答,答后锁定并回显解析结果。 Beta 口径解释 kb-explain 口径解释折叠面板:拆解数字的表 / 列 / 筛选 / 聚合与指标口径。 Beta 调用链追踪 kb-trace RAG/LLM 调用链 span 树,覆盖查询、检索、重排、生成、工具等节点的嵌套耗时展示。 Beta 标注队列 kb-review 人工标注审查队列,左侧队列加右侧审查卡,支持选项打分与数值滑杆。 Beta 无答案分析 kb-gap 无答案 / 未命中查询分析,含趋势柱与零结果 Top 表。 Beta 评估对比 kb-eval 评估 run 对比表(Braintrust 心智),覆盖判级汇总、指标对比与双栏 diff。 Beta 双栏工作台 kb-canvas Agent 双栏工作台画布,覆盖对话流、文档栏、内联 diff、版本轴与划词 AI 工具条。 Beta 检查点 kb-checkpoint Agent 检查点时间轴,点击弹出恢复菜单按范围回滚。 Beta 沙箱工具容器 kb-sandbox MCP App 沙箱工具容器(MCP Apps 对齐),iframe 隔离加 JSON-RPC 双向桥。 Beta 工具链条 kb-chain Agent 工具链条横向摘要条,一屏看完检索到引用核对的整链状态。 Beta 文档权限面板 kb-acl SharePoint 权限页范式的资源级 ACL 面板,覆盖继承、授权行、链接与过度授权警示。 Beta 有效权限检查器 kb-who-can SharePoint「Check Permissions」范式的 view-as 检查器,结论加扁平原因链。 Beta 访问申请流 kb-access Google Drive「请求访问」范式的访问申请流,含被拒页、申请表单与状态机徽章。 Beta 权限审计时间线 kb-audit Purview / Box 范式的权限审计时间线,含通道过滤、权限异味与 break-glass 警示。 Beta 检索可见性对照器 kb-visibility admin / 审计专用的检索可见性对照器:固定身份集 × 同一查询的命中对照网格。
表单
14 Core 表单布局 form 表单的纵向字段布局:标签、辅助提示、错误信息与页面级结果横幅。 Core 输入框 input 单行与多行输入的外壳族:前后缀、清除钮、密码切换、计数与掩码。 Core 选择器 select 自定义下拉选择:单选、可搜索、多选上限,选项可放任意内容。 Core 滑块 slider 数值滑块:单值与双值区间两种形态,样式自由、键盘可达。 Core 标签输入 tag-input 把零散词句收成标签的输入控件:回车、逗号或粘贴成词条,重复与超限有明确反馈。 Core 开关与选择 switch 开关、勾选框、单选行组三件套:纯 CSS 状态组件。 Core 分段选择 segmented 四件紧凑小控件:分段选择、切换组、数字步进器、验证码格。 Core 上传 upload 文件上传:点击或拖拽入区,自动渲染文件列表与校验错误。 Core 日期选择 date-picker 日历选日期:单选、范围、禁用与清除,键盘可全程操作。 Core 表单校验 form-validate 原生约束优先的零依赖校验层:HTML5 属性即 schema,submit 优先策略 + 可异步具名校验。 Core 级联选择 cascader 路径型级联选择:多级面板逐级展开,支持跨级搜索与完整键盘操作。 Core 树选择 tree-select 层级树选择:组织架构 / 权限树的单选或多选,父子联动、搜索与已选 chips。 Core 提及输入 mentions 提及输入:@ 触发成员建议;提及渲染为原子 token(光标不可进入、整体删除),目录与自定义两种模式,数据是对象数组而非字符串猜测。 Core 自动补全 autocomplete 自动补全:输入联想同步或异步建议,支持自由输入、自定义行与失败原地重试。
数据展示
17 Core 卡片 card 内容卡片:四种表面变体 + 悬停浮起与选中态。 Core 空状态 empty 空状态:图标 + 标题 + 引导动作,五种场景预设。 Core 头像 avatar 头像:五档尺寸,文字兜底或图片填充。 Core 媒体卡 media-card 媒体卡:2/3 封面 + 悬停上浮与底部信息条。 Core 评分 rating 评分:实星 / 半星两档精度,warning 色。 Core 键盘键 kbd 键帽与行内代码片:键盘按键和行内代码的排版件。 Core 代码块 code-block 代码块:高亮、行号、折叠、复制与 diff 着色,浏览器与构建期双入口。 Core 列表 list 分隔列表:行间细分隔线 + 悬停底色的纵向条目。 Core 折叠面板 accordion 手风琴:分区展开收起,支持单开模式。 Core 时间线 timeline 时间线:语义色圆点 + 连接线,时间右对齐等宽数字。 Core 描述列表 desc 描述列表:格线分明的键值对排版,列数与跨列可控。 Core 树形 tree 树形列表:多层可折叠、叶子单选、禁用节点。 Core 轮播 carousel 轮播:箭头、圆点、滑动、键盘四条通道同一个切换引擎。 Core 徽标 badge 角标徽标:数字计数或纯圆点,挂在外层元素的角上。 Core 滚动容器 scroll-area 显式滚动区:给「可滚动」一个看得见的边界。 Core 表格 table 基础表格:窄屏横向滚动、行悬停、斑马纹与首列粘滞。 Core 数据表格 datatable `createTable` 重度数据表格:对齐 AG Grid 社区版核心心智,零依赖函数式 API。
图表
20 Beta 图表总览 charts 图表族总览:零依赖纯 SVG 渲染,14 种图型共用一份 JSON 规格。 Beta 折线图 chart-line 折线趋势图:面积渐变 + 网格 + 数据点,多系列可切换。 Beta 柱状图 chart-bar 柱状与条形图:垂直、水平两种形态同一入口。 Beta 饼图 chart-pie 环形分割图:多段占比 + 图例百分比。 Beta 雷达图 chart-radar 蛛网雷达图:N 轴多维对比,多系列叠加。 Beta 热力图 chart-heatmap 贡献热力格:GitHub 式 7 行 × N 周,5 档色阶。 Beta 面积图 chart-area 面积趋势图:与折线同族,填充更厚重。 Beta 堆叠条 chart-stack 100% 堆叠条形图:各部分占比一目了然。 Beta 仪表盘 chart-gauge 环形仪表盘:中心百分比,适合 KPI 完成率。 Beta 迷你趋势 chart-sparkline 迷你趋势线:无轴小图,嵌进指标卡与表格单元格。 Beta 散点气泡 chart-scatter 散点与气泡图:坐标域自动取整,第三维映射气泡半径。 Beta 贡献日历 chart-calendar 贡献日历:GitHub 提交图同款,按周自动布局。 Beta 知识图谱 chart-graph `renderGraph`:GraphRAG 实体关系力导向 node-link 图,支持簇着色与节点拖拽。 Beta 嵌入地图 chart-map `renderMap`:embedding 2D 投影地图,是 `renderScatter` 的去轴变体。 Beta 降采样(LTTB) charts-downsample LTTB 视觉保形降采样:大点数折线 / 面积 / 散点渲染前抽样,spec 数据保持全量。 Beta 缩放 / 刷选 charts-zoom 图表拖选缩放:拖出选区按类目区间切片重渲,可一键复原。 Beta 标记线 / 标记点 charts-marks 纯 JSON 图表标记:水平 / 垂直参考线与系列标记点,语义色 + 尾部标签。 Beta 流式追加 charts-append 流式追加:`handle.append` 推送一拍并重渲,滑动窗口自动淘汰头部。 Beta 导出 PNG charts-todataurl 导出 PNG:`handle.toDataURL` 将 SVG 图表光栅化为 dataURL,支持缩放与缓存。 Beta 加载态 charts-loading 加载骨架态:`spec.loading` 时以 shimmer 骨架替代数据渲染,优先于空态。
浮层
6反馈
7 Core 警示 alert 页面内嵌的警示条:info / success / warning / error 四态,可关闭。 Core 结果页 result 操作终态的全幅展示:成功、失败、警告、信息四种收场。 Core 进度条 progress 线性进度条:轨道 + 填充 + 等宽数字标签,宽度变化平滑过渡。 Core 加载指示 spinner 旋转加载指示:sm / 默认 / lg 三档。 Core 骨架屏 skeleton 加载占位:呼吸脉冲的灰块,拼出内容轮廓。 Core 复制按钮 copy 一键复制:文本、透明、图标三种按钮形态共用同一复制行为。 Core 通知栈 notification 工程级持久通知栈:进度、多按钮、已读未读、localStorage 持久化。