延伸阅读导览

前面的指南解决“怎么搭起来”，这个板块解决“搭起来之后怎么判断、怎么维护”。这里的文章不是 API 说明，也不新增合同；它们把已有接口放进真实业务的取舍里，给出可以验证、可以调整的做法。

硬约束与软约定

类型	例子	位置
合同	预算超限拒绝、未授权不执行、取消传播、来源不可伪造、校验失败抛错	API 手册与各 Kit 页面
建议	预算取值、切块粒度、候选数量、日志字段、降级顺序、上线检查项	本板块

软约定不改变权限、预算、取消和输入输出合同。它们不是 SDK 的强制校验，也不应被写成“只要照做就一定正确”。采用前先确认它解决的是你当前真实存在的问题。

阅读路径

文章	解决什么	什么时候读
MockGPT 离线验证	不接真实模型验证协议、工具选择、流式与失败	写测试、调工具循环、复现故障
RAG 资料搭建	判断整篇、章节还是切块，并搭出可核验的检索链	资料变大、整篇装不下
检索质量评估	用真实问题判断检索是否真的更好	准备引入或调整检索
配置与软约定	管住不受类型保护的配置、默认值与启动自检	项目开始、准备上线
降级与容错	模型、工具、检索失败时怎么退	接入真实依赖之后
工作流图与执行链	审查流程定义、核对实际运行，区分开发观测与业务能力	开发调试、流程评审、搭建观测界面或演示
上线前的软性检查	发布前逐项确认证据，而不是凭感觉	每次发布前

一条共同原则

先用真实数据和真实调用判断，再增加机制。每项建议都应能回答三个问题：它解决什么问题、怎么观察它有效、失效时退到哪里。回答不了时，先不要加。

需要精确签名、参数和异常时，回到 API 手册；需要可运行的小例子时，看 场景示例。