交互与用户体验 / 系统课时
设计来源预览与原文跳转
设计来源预览与原文跳转
一条带引用的 AI 回答,需要让读者看见依据,并能准确抵达原文。本课以退货期限查询为例,设计从回答中的引用标记,到来源片段预览,再到文档原文定位的完整交互路径,同时处理访问权限不足、文档版本变化和来源失效等情况。
学习目标
- 根据引用内容的长度和使用场景,选择悬浮预览、侧边面板或独立页面。
- 设计包含文档标题、引用片段、定位信息和原文入口的来源卡片。
- 为权限不足、定位失败和来源失效定义明确的界面反馈与恢复方式。
定义来源卡片需要展示的信息
假设用户询问:购买商品后多久可以申请退货?AI 回答:签收后 7 天内可以申请退货,并在句末显示引用标记 [1]。用户点击 [1] 后,应当立即看到支撑这句话的原文,而不是只有一个无法判断内容的文档链接。
以下使用虚构的《退货规则 v3》作为教学样例。来源卡片至少包含五项信息:
| 信息 | 示例 | 设计目的 |
|---|---|---|
| 文档标题 | 退货规则 v3 | 识别来源文件 |
| 文档位置 | 第 2 节 · 申请期限 | 交代引用所处上下文 |
| 原文片段 | 商品签收后 7 天内可申请退货 | 核对回答是否忠于原文 |
| 版本信息 | v3 · 更新于 2026-09-01 | 判断内容是否可能过期 |
| 操作入口 | 查看原文 | 进入可独立核验的阅读视图 |
原文片段建议显示被引用句及必要的前后文,默认控制在 80~160 个汉字。片段过长时截断显示,并提供展开操作;不得通过截断省略改变条件含义,例如只留下“7 天内退货”而隐藏“未使用且包装完整”的限制。
引用标记应紧邻对应事实。多个独立结论分别关联各自的证据。同一位置确实支持多条结论时,沿用同一个编号,而不是把全部来源堆在回答末尾。来源数据还需保留稳定的文档标识、版本标识与片段定位信息,供后续跳转使用。
选择悬浮预览、侧边面板与独立页面
三种容器解决不同的阅读任务,不宜只因为桌面空间充足就全部使用侧边面板。
| 方式 | 适用条件 | 推荐布局与行为 |
|---|---|---|
| 悬浮预览 | 单条短引用、快速核对 | 桌面宽约 360 px;显示标题、简短原文和跳转入口 |
| 侧边面板 | 同时比较 2 条以上引用 | 右侧宽约 400 px;支持切换来源、展开片段 |
| 独立页面 | 阅读长文、复杂表格或完整 PDF | 展示全文、当前位置与返回对话入口 |
这些尺寸是原型设计起点,不是固定的设备规范。例如在 1440 px 宽的桌面视口中,可以分配约 400 px 给来源面板,其余空间保留消息阅读区;如果消息列被压缩到不足 640 px,应考虑覆盖式抽屉而非继续挤压正文。

悬浮预览不能只依赖鼠标悬停。桌面端用点击或键盘激活打开预览,避免只移动焦点就打开模态层。悬停预览需可关闭,交互面板应支持 Escape 关闭。移动端没有稳定的悬停行为,应改为点击引用后弹出底部抽屉。可以把抽屉最大高度设置为屏高的 70%,超过时仅在抽屉内容区滚动。
当用户点击“查看原文”时,无论来自哪一种预览容器,都应进入同一套原文定位逻辑,避免不同入口跳到不同版本的文档。
让原文跳转准确命中引用片段
只打开文档首页并不等于完成来源定位。对于几十页的 PDF 或包含大量章节的知识库,用户仍然可能无法找到引用依据。
建议把跳转设计成四个可检查的步骤:
- 确定来源:引用标记关联稳定的文档 ID 和版本 ID,不能仅凭显示标题查找,因为可能存在同名文档。
- 保存定位器:网页文档优先使用稳定的段落锚点;PDF 保存页码,并结合被引文本进行精确匹配。检索片段还应记录其原始引用文本。
- 打开并高亮:通过权限校验后打开对应文档与版本,滚动到命中的段落,将真正被引用的文字高亮显示。不要高亮整页来冒充精确定位。
- 支持返回:提供“返回对话”,恢复离开前的消息滚动位置、引用上下文和键盘焦点。
例如回答引用《退货规则 v3》第 2 节中的“商品签收后 7 天内可申请退货”。点击“查看原文”后,原文视图应定位第 2 节,并高亮这句话。如果只能找到章节而无法精确匹配句子,应明确提示“已定位到相关章节,未能精确匹配原文”。
如果来源已经更新,不应把旧版本第 5 段直接映射成新版本第 5 段。正确做法是优先读取引用时对应的可访问版本;无法取得旧版时,提示“来源版本已更新,引用位置可能变化”,允许用户打开新版相关章节,但不得伪装成精确命中。
处理访问权限与来源失效
来源预览也属于文档访问行为。即使 AI 回答已经生成,用户也不一定仍然拥有打开原文件的权限。预览接口与原文打开接口都需要重新校验授权,不能只根据前端是否显示按钮判断访问资格。
| 来源状态 | 界面反馈 | 可执行操作 |
|---|---|---|
| 可访问 | 显示标题、原文和定位信息 | 预览、查看原文 |
| 需要登录 | 提示需要验证身份,不展示受保护片段 | 登录后重新校验 |
| 无访问权限 | 显示“无权访问此来源”,不泄露受限标题及原文 | 返回回答、申请权限(如系统支持) |
| 来源已删除 | 显示“来源已失效,无法核验” | 返回回答或重新检索 |
| 文档仍在但定位失败 | 显示“无法定位原引用片段” | 打开可访问的文档或相关章节 |
来源失效不代表之前生成的回答自动变成错误,但用户已经无法独立验证其依据。界面应保留原回答,并标记引用当前不可核验;不要继续显示“已核实”之类的确定性状态。
还有一种容易遗漏的情况:用户在打开侧边面板后,管理员撤销了文档权限。再次展开片段或点击原文时,服务端重新授权;前端收到拒绝或撤销事件后清除已缓存的受保护片段。已读取的内容无法从用户设备上收回,因此还需限制缓存与有时效的链接。单纯隐藏跳转按钮无法阻止旧数据泄露。
可运行的预览与跳转
将片段保存为 HTML。两个预览均使用本地模拟资料。来源 1 能定位引用版本的精确段落。来源 2 只能定位可访问的相关章节。模拟撤销来源 2 后,预览和原文操作都会重新校验。生产中用已授权的来源接口取代 fixture,返回允许展示的内容和经验证的跳转目标。请求体只携带稳定来源 ID。
<style>
dialog { max-inline-size: min(32rem, calc(100% - 2rem)); max-block-size: 70dvh; overflow: auto; }
dialog p { overflow-wrap: anywhere; }
button { min-block-size: 44px; }
</style>
<h1 id="answer" tabindex="-1">退货期限</h1>
<p>适用条件见
<button type="button" data-source="rules" aria-label="查看来源 1">[1]</button>
<button type="button" data-source="help" aria-label="查看来源 2">[2]</button>。
</p>
<label><input id="revoke" type="checkbox"> 模拟来源 2 权限撤销</label>
<dialog id="source" aria-labelledby="source-heading">
<h2 id="source-heading">来源预览</h2>
<p id="feedback" role="status"></p>
<div id="excerpt"></div>
<button id="original" type="button" hidden>查看原文</button>
<form method="dialog"><button autofocus>关闭</button></form>
</dialog>
<section id="full" hidden>
<h2 id="full-heading" tabindex="-1">原文</h2>
<p id="full-content"></p>
<button id="back" type="button">返回回答</button>
</section>
<script>
const byId = id => document.getElementById(id);
const dialog = byId("source");
const records = {
rules: { title: "退货规则 v3", excerpt: "未使用且包装完整的商品可在签收后 7 天内申请退货。", precise: true },
help: { title: "售后帮助 v2", excerpt: "退货入口和条件见售后章节。", precise: false },
};
let request = 0, currentId, trigger, navigating = false;
async function readSource(id) {
await new Promise(resolve => setTimeout(resolve, id === "rules" ? 80 : 20));
return id === "help" && byId("revoke").checked ? null : records[id] ?? null;
}
function clearPreview() {
byId("excerpt").replaceChildren();
byId("original").hidden = true;
}
async function preview(button) {
trigger = button;
currentId = button.dataset.source;
const version = ++request;
clearPreview();
byId("full").hidden = true;
byId("full-content").replaceChildren();
byId("feedback").textContent = "正在载入来源。";
if (!dialog.open) dialog.showModal();
const row = await readSource(currentId);
if (version !== request || !dialog.open) return;
if (!row) {
byId("feedback").textContent = "当前无法查看此来源。";
return;
}
byId("excerpt").textContent = row.title + "。 " + row.excerpt;
byId("feedback").textContent = row.precise ? "已加载可定位来源。" : "原版本无法精确定位,可查看相关章节。";
byId("original").hidden = false;
}
document.querySelectorAll("[data-source]").forEach(button => {
button.addEventListener("click", () => preview(button));
});
byId("original").addEventListener("click", async () => {
const version = ++request;
clearPreview();
dialog.querySelector("[autofocus]").focus({ preventScroll: true });
byId("feedback").textContent = "正在核验原文权限。";
const row = await readSource(currentId);
if (version !== request || !dialog.open) return;
if (!row) {
byId("feedback").textContent = "当前无法查看此来源。";
return;
}
const content = byId("full-content");
const span = document.createElement(row.precise ? "mark" : "span");
span.textContent = row.excerpt;
content.replaceChildren(span);
byId("full-heading").textContent = row.title + (row.precise ? ",已定位" : ",相关章节");
byId("full").hidden = false;
navigating = true;
dialog.close();
byId("full-heading").focus();
});
dialog.addEventListener("close", () => {
if (dialog.open) return;
clearPreview();
if (!navigating) (trigger?.isConnected ? trigger : byId("answer")).focus({ preventScroll: true });
navigating = false;
});
byId("back").addEventListener("click", () => {
byId("full").hidden = true;
byId("full-content").replaceChildren();
(trigger?.isConnected ? trigger : byId("answer")).focus();
});
</script>示例不会读取任意外部链接。异步回执同时检查请求标识和弹层状态,旧响应不能填入新预览。生产中如果跳到外部原文,使用服务端解析并校验的 HTTPS 目标。源标题和摘录按文本渲染,避免来自模型或文档的 HTML 改变界面。
用完整任务验证引用交互
可以在原型中准备一条包含两个引用的 AI 回答,并用桌面和手机分别完成下面的检查:
- 在 1440 px 桌面视口点击 [1],来源卡片显示正确标题、摘录和章节;再点击 [2],显示另一份来源,不串用片段。
- 使用 Tab 聚焦引用并按 Enter 打开预览,按 Escape 关闭;焦点应返回刚才的引用标记,而不是跳到页面顶部。
- 在 390 px 手机视口点击引用,底部抽屉可滚动,关闭后仍停留在原消息附近,不出现横向溢出。
- 点击“查看原文”,确认打开的是引用时对应的文档版本,且高亮文本与预览片段一致;返回后仍能继续阅读原回答。
- 模拟权限被撤销、来源删除以及版本发生变化,分别验证敏感内容隐藏、失效提示和定位降级行为。
验收时可以把“打开引用预览”和“打开原文”视作两次独立操作:前者负责快速判断依据是否相关,后者负责让用户核验完整上下文。只有标题、摘录、权限和定位信息在这两步之间保持一致,引用体验才真正具备可追溯性。