Citation
标识回答中的来源与引用范围。中文惯用名：引用标注。
稳定本期新增已接入
元信息
| 字段 | 值 |
|---|---|
| 规范 ID | component.citation |
| 名称 | Citation |
| 二级分类 | AI 与会话（ai-chat） |
| 用途 | 标识回答中的来源与引用范围 |
| 描述 | 中文惯用名：引用标注。 |
预览
静态结构：行内 [n] 编号组（align-super，编号从 start 起）；每个编号经 vendored HoverCard 悬浮展开来源卡（标题 / line-clamp-3 片段 / 链接新窗口打开）。
DSL 结构
{
"type": "Citation",
"props": {
"items": [
{
"title": "2026 年 Q3 销售数据",
"url": "https://example.com/sales-q3"
},
{
"title": "市场分析报告",
"snippet": "华东区环比增长 12.4%…"
}
],
"start": 1
}
}何时用
何时使用
- 标识回答中的来源与引用范围：RAG 回答的出处标记。
何时不用
- 普通外链：使用 Link。
- 长参考文献列表：用 List / Table。
变体
| 变体 | 视觉形态 | 适用场景 |
|---|---|---|
| 连续编号 | [1] [2] 上标 | 句末出处 |
| 自定义起始 | start 偏移 | 跨消息连续编号 |
API 属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
items | CitationItem[] | [] | 来源：{ title, url?, snippet? } |
start | number | 1 | 起始编号 |
className / style | string / CSSProperties | — | 通用：根节点 class 合并 / 内联样式 |
使用规范
- 编号与来源一一对应，顺序与正文出现顺序一致。
正例
- ✓ RAG 回答：句末 [1][2] 悬浮查看检索片段与原文链接。
反例
- ✕ 用 Citation 做脚注长文（应保持简短来源卡）。
Design Token 映射
不适用：组件 tokenRefs 为空：样式 Token 数据尚未接入，三层映射（Primitive → Semantic → Component）待样式 Token 接入后回填。