这里记录外部 API 集成、批量数据管道和长时间任务中可复用的可靠性设计。
HTTP 接口与故障定位
- HTTP 路由与异常速记：NestJS 路由兜底 404、异常通知与请求来源的判断边界。
- SSE 提前结束与协议完成：连接关闭、收到正文与正常完成是不同信号。
- HTTP 分块与 UTF-8 解码：中文、emoji 的字节跨块时，合并 Buffer 或用同一个 StringDecoder 保留完整字符。
- 草稿与提交、执行校验：区分合法保存与业务完整，复用字段定义并避免把
.partial()当作放宽已填写内容的校验。 - 接口数据归一化与资源身份：区分缺失数值与真实零值，保留来源限定 ID 的命名空间。
身份认证与云资源
- 应用标识与平台注册：区分正式AppID、指定测试值与认证凭据。
- LangSmith 的 PAT、Service Key 与 Tracing Only：个人身份、服务身份与只写追踪凭据的选择。
- Vercel 改名与 OIDC 身份联合：区分令牌声明、云端信任策略、静态密钥认证与域名引用的影响。
模型 API 与凭据接入
- 用户自带 API Key 的模型接入边界：额度归属、协议兼容、密钥托管与自定义 URL 的 SSRF 风险。
- JSON Schema、Function Calling 与工具选择：回答正文与工具参数的区别、默认 auto 策略，以及原生约束和本地校验的边界。
数据库与数据生命周期
- Hive 列顺序与动态分区写入：静态分区值省略、动态分区值在 SELECT 末尾按位置映射。
- Hive 半连接的列可见性：右表在 ON 中可读，但不进入输出列和 WHERE 的作用域。
- 缓存命中率与节省成本：区分成本感知、缓存准入与替换，以及策略自身的执行开销。
- 日志回放与逆序撤销：Redo 与 Undo 的区别、不可逆修改，以及历史版本恢复所需的信息。
- 后端与数据库易忘知识点：软删除、回收站、外部文件与 CDN 清理的边界。
数据采集与覆盖范围
- 批量采集器要区分空数据与真正失败
- 事件时间、信息可用时间与延迟标签：回放和离线评测不能提前使用最终聚合、选择结果或尚未成熟的反馈。
- RSS 与上游访问条件：区分开源转换工具、上游授权和整条通知流程的成本。
本地数据产品
长任务与质量验证
- Workflow 与 Agent 的决策权边界：动态拆解、执行调度与步数护栏的职责。
- LangGraph 消息状态、审批恢复与 LangSmith 分工：消息 ID 的更新语义、interrupt 重入，以及追踪和 Studio 的区别。
- 长时间 CLI 任务要报告真实阶段进度
- 让 Agent 评测结果值得相信：单测/E2E 与评测的关系、Trace 补评与重新执行、执行证据、评分口径及平台复用边界。
本地端口、pnpm、Node.js 子进程和 macOS 后台任务已经归入 工程工具与系统。