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

界面文案:把技术词翻译成人话

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

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

用户需要据此做决定吗?需要就必须翻译成人话。

技术词直接摆到界面上,用户就懵了

界面里常见的技术词 ✗:token、上下文窗口、temperature、embedding、向量检索 ✔ ——

工程内部用没问题 ✔,但用户看到就不知道该怎么办 ✔(见输出可读性那篇的同理 ✔)。

把技术词翻译成"用户能判断的东西" ✔。

一、常见词的人话对照

| 技术词 | 用户看到的应该是 |

|---|---|

| token 上限 | 「最长约 X 字」(并说明超了会怎样 ✔) |

| temperature | 「更稳妥 / 更有创意」(二选一或滑杆 ✔) |

| 上下文窗口 | 「它能记住多长的对话」(给轮数或时长 ✔) |

| 向量检索 | 「在资料库里查找相关内容」(不暴露实现 ✔) |

| 模型版本号 | 「快速模式 / 精确模式」(版本号放详情里 ✔) |

| 幻觉/编造 | 「可能给出不准确的内容,请核对来源」 ✔ |

| 嵌入/索引 | 「资料已准备好 / 还在准备」 ✔ |

要点:给"能判断的选项"而不是"要调参的旋钮" ✗→✔。

二、三处最该翻译的位置

1. 设置页(参数名最容易直接暴露 ✔);

2. 错误与限制提示("超出 context window" ✗ → "内容太长,请拆分后提交" ✔);

3. 等待状态("正在 embedding" ✗ → "正在准备资料" ✔)。

三、术语一致(与术语表配合)

· 界面词进术语表 ✔(见术语一致性那篇 ✔);

· 同一个概念全站一个词 ✔(不要一处"模型"一处"引擎" ✔);

· 英文缩写首次出现给中文 ✔(RAG → 检索增强 ✔)。

四、什么时候可以保留技术词

· 面向开发者的功能(API 文档、参数说明 ✔);

· 高级模式(明确标注"高级设置" ✔ —— 用户自己选择深入 ✔);

· 法律/合规必要表述 ✔。

判断标准 ✔:用户需要据此做决定吗? ✔

需要 → 必须翻译成人话 ✔;不需要 → 不必暴露 ✔。

五、三个反模式

· 把参数名当功能名 ✗("温度设置" ✔);

· 翻译过头 ✗(把"检索"说成"魔法" ✔ —— 失去可信度 ✔);

· 同一个界面混用两套说法 ✗。

六、一条判据

> 让一个不懂技术的用户读完设置页 ✔,他能否说出"我该选哪个、为什么" ✔?

> 不能,说明界面还是工程视角 ✗。

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

相关文章

顺序阅读

← 上一篇:把成本上限做成产品能力:让用户自己设
下一篇:把检索结果做成可对话的:追问与下钻 →

第 153 / 171 篇

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

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