第 8 章:引用与富内容
文字之外的三样东西决定了"这个答案能不能信":引用角标、数据图表、原始文件。它们的共同要求是——每个结论都能被点回来源。
学习目标
- 选对引用呈现方式(角标 / 脚注 / 侧栏)
- 让角标在流式过程中不打断排版
- 把图表、表格、文件卡片放进消息而不破坏会话结构
- 做出"点一下就回到原文第几页"的深链
8.1 三种引用呈现
| 方式 | 样子 | 适合 |
|---|---|---|
| 角标 | 句子末尾 [1],点击弹卡片 | 回答里引用很多处 |
| 脚注 | 段落下方集中列出 | 学术/报告类,少量引用 |
| 侧栏 | 右侧固定面板列出全部来源 | 深度阅读、需要对照 |
对话产品首选角标:它不占正文空间,一点就有细节。
8.2 角标的数据从哪来
引用不应该由前端"猜",而应该由后端随流一起给出:
json
{
"delta": { "content": "2024 年毛利率为 38.2%" },
"citations": [
{ "index": 1, "doc": "2024年报.pdf", "page": 37, "quote": "综合毛利率 38.2%", "url": "/files/2024.pdf#page=37" }
]
}前端把它塞进 parts:
ts
{ type: "citation", index: 1, source: { title: "2024年报", page: 37, url: "/files/2024.pdf#page=37" } }8.3 流式时角标不能把排版打乱
三种做法:
| 做法 | 问题 |
|---|---|
| 收到引用就立刻渲染成块 | 正文中间突然插入卡片,句子被切断 |
| 全部回答完再统一插入 | 用户读的时候没有引用,读完才补,割裂 |
| 先占位、后补内容 | 最平滑:角标立即出现,点击时数据已就绪 |
实现上就是"角标是行内的 [n],点击时才打开卡片",卡片内容可以是异步读的。
tsx
<span className="cite" onClick={() => openCitation(idx)}>[{idx}]</span>8.4 图表:别让 Markdown 承担
模型给的图表数据通常是 JSON,不是图片:
json
{ "type": "chart", "option": { "xAxis": {...}, "series": [...] } }四种渲染路径:
三条纪律:
- 图表容器必须有固定高度:否则数据一到,页面高度突变,正在看的位置会跳;
- 动画只做第一次:流式过程中反复
setOption会一直重播动画; - 图表也要能"回原文":每个系列最好带来源角标。
8.5 富内容的统一容器
不管什么类型,都放进统一的"附件/内容块",避免每种类型各写一套布局:
ts
type RichBlock =
| { kind: "chart"; option: unknown; caption?: string }
| { kind: "table"; columns: string[]; rows: string[][] }
| { kind: "file"; name: string; size: number; url: string }
| { kind: "image"; url: string; alt: string };好处:外层只有一个"块列表",渲染顺序、间距、折叠逻辑都只写一次。
8.6 深链要真能跳
| 内容类型 | 跳转方式 | 注意 |
|---|---|---|
#page=37 | 依赖浏览器内置阅读器,移动端支持不一 | |
| 网页 | #section-id 或文本片段 | 锚点可能被别人改掉 |
| 内部文档 | 应用内路由 + 高亮参数 | 最可控 |
| 图片 | 弹层 + 缩放 | 别直接新开标签 |
落地经验:如果原文是 PDF,最好在后端预先切好"段落级锚点",前端跳"文档第 N 段"而不是页码——页码会随重新排版漂移。
8.7 引用可信度的三个设计
| 设计 | 作用 |
|---|---|
| 摘录原文(不是标题) | 让用户能直接核对 |
| 标出"未找到出处" | 模型没有依据时明确说,而不是编一个角标 |
| 引用可关闭 | 有些场景(闲聊)不需要角标,别强制显示 |
第二条最重要:角标是承诺。给不出可靠来源时,宁可没有角标,也不要随便挂一个。
本章小结
| 要点 | 说明 |
|---|---|
| 呈现 | 角标优先,脚注/侧栏按场景 |
| 数据 | 引用随流到达,编号与来源一一对应 |
| 流式 | 角标先占位,卡片点击时再展开 |
| 图表 | 固定高度、只播一次动画、带来源 |
| 容器 | 统一 RichBlock,别每种类型各写布局 |
| 深链 | 优先段落级锚点,页码会漂 |
下一章
能显示、能引用之后,接下来是"出错的时候怎么办":中断、限流、断网与重试。