Skip to content
Lv5AI 对话前端进度 8 / 10

第 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" } }
一次点击,跨越四层回答文本"2024 年毛利率为 38.2% [1]"角标是行内元素,不单独占行引用数据{ doc, page, quote, url }随流一起到达,不额外请求悬浮卡片文档名 · 页码 · 原文摘录再点"查看原文"才跳转原文页面(深链)/files/2024.pdf#page=37用 URL fragment 直接定位页码/段落,不用重新检索三个必须做到的点角标编号与来源列表一一对应,不能"就近编号"摘录要能证明这句话,而不是泛泛的文档标题反例:角标点了只弹"来源:某年报"——这不叫引用,叫装饰。判断标准:用户能否在 3 秒内确认"这句话是不是原文说的"。

8.3 流式时角标不能把排版打乱 ​

三种做法:

做法问题
收到引用就立刻渲染成块正文中间突然插入卡片,句子被切断
全部回答完再统一插入用户读的时候没有引用,读完才补,割裂
先占位、后补内容最平滑:角标立即出现,点击时数据已就绪

实现上就是"角标是行内的 [n],点击时才打开卡片",卡片内容可以是异步读的。

tsx
<span className="cite" onClick={() => openCitation(idx)}>[{idx}]</span>

8.4 图表:别让 Markdown 承担 ​

模型给的图表数据通常是 JSON,不是图片:

json
{ "type": "chart", "option": { "xAxis": {...}, "series": [...] } }

四种渲染路径:

三条纪律:

  1. 图表容器必须有固定高度:否则数据一到,页面高度突变,正在看的位置会跳;
  2. 动画只做第一次:流式过程中反复 setOption 会一直重播动画;
  3. 图表也要能"回原文":每个系列最好带来源角标。

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 深链要真能跳 ​

内容类型跳转方式注意
PDF#page=37依赖浏览器内置阅读器,移动端支持不一
网页#section-id 或文本片段锚点可能被别人改掉
内部文档应用内路由 + 高亮参数最可控
图片弹层 + 缩放别直接新开标签

落地经验:如果原文是 PDF,最好在后端预先切好"段落级锚点",前端跳"文档第 N 段"而不是页码——页码会随重新排版漂移。


8.7 引用可信度的三个设计 ​

设计作用
摘录原文(不是标题)让用户能直接核对
标出"未找到出处"模型没有依据时明确说,而不是编一个角标
引用可关闭有些场景(闲聊)不需要角标,别强制显示

第二条最重要:角标是承诺。给不出可靠来源时,宁可没有角标,也不要随便挂一个。


本章小结 ​

要点说明
呈现角标优先,脚注/侧栏按场景
数据引用随流到达,编号与来源一一对应
流式角标先占位,卡片点击时再展开
图表固定高度、只播一次动画、带来源
容器统一 RichBlock,别每种类型各写布局
深链优先段落级锚点,页码会漂

下一章 ​

能显示、能引用之后,接下来是"出错的时候怎么办":中断、限流、断网与重试。

本文阅读--次|全站访问--次|访客--人