选型指南 架构设计 含可复制代码

长结果的呈现:分层、截断与续写

目录层用 SSG 加 ISR 拿收录,工具层用一份 JSON Schema 承接 91 个站内工具,密钥、计费与限流全部收口在国内业务后端,模型调用统一走一层薄适配。这篇把我们真实的目录结构、Schema 字段定义、路由闸门、预扣结算伪代码和合规清单完整摊开。

陈
陈默架构组
2026-09-28 · 14 分钟阅读 · 8,432 次浏览

被截断的长结果,用户能否一眼看出「这不是全部」?

长结果不该"一次全倒出来"

AI 输出可能很长(报告、清单、代码 ✔)。一次性全渲染 ✗ 有三个问题:

首屏慢 ✔、用户找不到重点 ✔、复制困难 ✔。

长结果要"分层呈现 + 可截断" ✔。

一、四层呈现

```

① 摘要(3~5 行结论,首屏必现)

② 目录/要点(可跳转)

③ 正文(可折叠、可展开全部)

④ 原文与来源(附件式,按需加载)

```

要点:第 ① 层必须能独立回答"要不要继续看" ✗→✔(见可读性那篇 ✔)。

二、截断的三种策略

| 策略 | 说明 | 什么时候用 |

|---|---|---|

| 首 N 行 + 展开 | 默认显示前 N,点击展开 ✔ | 长文本 ✔ |

| 分页/分块 | 按章节或固定长度分块 ✔ | 表格/清单 ✔ |

| 导出代替展示 | 太长就别在页面渲染,给下载 ✔ | 超长结果 ✔ |

关键:截断必须显式标注 ✗→✔("已显示前 20 条,共 137 条 [查看全部] [下载]" ✔)——

静默截断会让用户以为这就是全部 ✔(与输入截断同一原则 ✔)。

三、三个体验细节

· 展开后保持滚动位置 ✔(别跳回顶部 ✔);

· 复制的粒度可选(复制摘要 / 复制全文 / 复制表格 ✔ —— 见导出那篇 ✔);

· 搜索高亮(长结果里能搜关键词 ✔)。

四、和 token 上限的关系

· 输出被上限截断时要说明 ✔("因长度限制,内容被截断" ✔);

· 给"继续生成"入口 ✔(从断点续写 ✔ —— 见长任务那篇 ✔);

· 不要假装完整 ✗(最坏的情况 ✔)。

五、一条判据

> 一条被截断的长结果 ✔,用户能否一眼看出"这不是全部" ✔ 并知道怎么拿到全部 ✔?

> 不能,说明截断是静默的 ✗。

本文由云枢 AI导航整理,内容以官方来源为准。

相关文章

顺序阅读

← 上一篇:数据质量前置检查:脏数据不要进模型
下一篇:沉默失败:最危险的失败是没有报错 →

第 161 / 171 篇

术语速查 · 本页出现的 12 个词展开看中文名与一句话解释,点术语看完整条目
  • token词元:模型处理文本的最小单位,中文约 1–2 个汉字;计费与上下文长度都按它算。
  • 转写 / 字幕Transcription:把音视频人声逐句变成带时间戳的文字稿,便于做字幕与章节切分。
  • SSE服务器发送事件:服务器通过长连接持续推送增量文本,是对白逐字出现的常见实现。
  • API应用编程接口:程序之间约定的调用方式;站内工具由服务端调用,浏览器里不出现密钥。
  • CDN内容分发网络:把静态资源缓存到离用户更近的节点,缩短加载时间。
  • 缓存Cache:把结果暂存复用,复用得越多平均耗时越低;需要约定过期与刷新策略。
  • 限流Rate Limit:限制单位时间内的请求次数,防止单用户或异常流量打满服务端。
  • SSG静态站点生成:构建阶段就生成 HTML,访问时直接返回,不必每次请求都渲染。
  • ISR增量静态再生:先返回静态页,再在后台按需重新生成,兼顾速度与更新时效。
  • 灰度发布Canary Release:先让一小部分用户用新版本,确认无误再放量,出问题的爆炸半径最小。
  • 提示词Prompt:交给模型的指令文本;写清角色、任务、输入与输出格式比反复试更省。
  • 积分Credits:站内计费单位:按工具单价预扣,调用失败自动退还;单价以定价页为准。

完整解释与站内出现处见 AI 术语表(40 条)。