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

AI 功能的导出与留档:结果要能带走

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

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

中文 CSV 不带 BOM,Excel 打开就是乱码。

"结果带不走",等于白做

AI 功能常有个致命体验问题 ✗:结果只能在页面里看 ✔,想用还得手工复制 ✗。

用户做完了却带不走 ✔ → 一旦页面刷新或会话结束,成果就没了 ✔。

导出与留档是"结果的所有权" ✔ —— 要让用户觉得"这是我做出来的东西" ✔。

一、至少要支持的三件事

1. 复制(结构化结果支持"复制为 Markdown/JSON" ✔ —— 不要只给纯文本 ✔);

2. 下载(按类型给合适格式:文本 .md / 表格 .csv / 数据 .json ✔);

3. 留档(历史记录可查、可重命名、可删除 ✔)。

要点:导出格式要考虑下游 ✗ ✔(用户拿去干什么?填表、进表格、发同事 ✔)。

二、导出内容的三个细节

· 带上来源与时间 ✔(尤其带引用的回答 ✔ —— 便于追溯 ✔);

· 带上生成信息(模型版本、生成时间 ✔ —— 可选但有用 ✔;注意不要泄露内部信息 ✔);

· 批量导出要有限制(体积上限 ✔ + 明确提示 ✔ —— 见长尾输入那篇的拒绝文案 ✔)。

三、留档要合规

· 保留期限明确 ✔("保留 30 天" ✔ 而不是"永久" ✗);

· 可删除 ✔(单条删除 + 全部清除 ✔);

· 导出即脱敏 ✔(导出内容里不应包含映射表等内部数据 ✔ —— 见脱敏那篇 ✔);

· 跨设备可见(若产品多端 ✔)—— 至少不要"换台设备就找不到" ✗。

四、三个常见反模式

· 只能截图 ✗(用户最常抱怨的一类 ✔);

· 导出乱码 ✗(CSV 不带 BOM,Excel 打开是乱码 ✔ —— 中文场景高频 ✔);

· 导出丢结构 ✗(表格导出成一段文字 ✔ —— 下游没法用 ✔)。

五、一个小检查清单

```

□ 一键复制(Markdown / JSON 可选)

□ 下载(md / csv / json,中文 CSV 带 BOM ✔)

□ 历史可查、可重命名、可删除

□ 导出含来源与时间

□ 体积上限与超限提示

□ 多端可见(或至少提示"仅本设备")

```

一条判据

> 用户做完一件事后,能否在 10 秒内把结果变成"可以黏到别处用"的东西 ✔?

> 不能,说明结果的所有权还在产品手里 ✗。

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

相关文章

顺序阅读

← 上一篇:上下文里的示例变成数据:小心少样本污染
下一篇:AI 功能怎么验收:把验收标准写进需求 →

第 98 / 171 篇

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

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