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

把踩过的坑固化成边界用例库

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

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

半年前那次事故的触发输入,今天能被自动检查出来吗?

踩过的坑要"固化",而不是"记住"

每次线上出问题,团队都会开个复盘 ✔ —— 结论常常是"以后注意" ✗。

三个月后同样的问题再来一次 ✔,因为结论没有变成可执行的检查 ✔。

把踩过的坑固化成"边界用例库" ✔:每条坑对应一个可复跑的用例 ✔。

一、一条用例要包含五样东西

```

① 输入(能复现问题的最小输入 ✔)

② 期望行为(正确的表现是什么 ✔)

③ 曾经的错误行为(当时发生了什么 ✔)

④ 关联信息(事故编号/日期/影响 ✔)

⑤ 归属(属于哪一类失败 ✔ —— 见失败分类那篇 ✔)

```

第 ③ 项很关键 ✗→✔:它让后人理解"为什么要有这条用例" ✔,

否则容易被当成"多余的测试"删掉 ✔。

二、用例从哪来(四个来源)

· 线上事故(每次事故至少一条 ✔);

· 人工审核的修改(审核员改得最多的类型 ✔ —— 见审核队列那篇 ✔);

· 用户反馈(点踩 + 人工确认过的 ✔ —— 见反馈回填那篇 ✔);

· 红队/对抗测试(注入、越权、极端输入 ✔ —— 见红队那篇 ✔)。

要点:来源要与"实际发生过"挂钩 ✗ ✔,而不是凭空设计 ✔。

三、怎么让它不腐烂

· 进评测集(每次改动都跑 ✔ —— 见评测接进 CI ✔);

· 有归属类别(同类坑集中看,能发现系统性原因 ✔);

· 定期复查(功能变了、用例过时了 → 更新或退役 ✔,但要留记录 ✔);

· 公开可见(谁都看得见"我们踩过哪些坑" ✔ —— 这对新人是极好的教材 ✔)。

四、三个反模式

· 复盘只写文档 ✗(没有可执行用例 ✔);

· 用例只增不整理 ✗(几千条跑不完,最后跳过 ✔);

· 用例没有"曾经的错误"说明 ✗(被当成冗余删掉 ✔)。

五、一个务实起点

```

① 把最近 3 次事故各写成 1 条用例(共 3 条 ✔)

② 接进冒烟集(30 秒能跑完 ✔)

③ 以后每次事故/重大修改都补 1 条 ✔

④ 每季度整理一次:合并同类、退役过时 ✔

```

一条判据

> 半年前那次事故的触发输入 ✔,今天能否自动被检查出来 ✔?

> 不能,说明复盘结论没有固化成用例 ✗。

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

相关文章

顺序阅读

← 上一篇:把上下文当缓存来管:前缀稳定与命中率
下一篇:把生成与校验分开部署:为什么不该互相影响 →

第 136 / 171 篇

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

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