全课程术语与证据速查
用于解释已有课件术语和跨周差异，沿用原周次、项目与验收目标。首次使用先在当天正文讲清机制，本表用于回查，不代替教学。
| 术语 | 全称与含义 | 课程定位/容易混淆处 |
|---|---|---|
| Type hint | 类型提示 | 说明参数与返回值，通常不自动验证运行时数据 |
| CRUD | Create / Read / Update / Delete，增删改查 | 描述数据操作，不是固定目录名 |
| UoW | Unit of Work，工作单元 | 一次用例的事务；W03 当前用协议与 MySQL/Fake 实现 |
| DI | Dependency Injection，依赖注入 | W03 的应用工厂与闭包负责装配；Depends 是另一种入口 |
| Protocol | Python 结构化类型协议 | 不要求显式继承，不代替运行时校验 |
| Annotated | 附带元数据的类型注解 | Pydantic 可使用其序列化/校验元数据，具体取决于元数据类型 |
| Origin / CORS | 来源；Cross-Origin Resource Sharing，跨源资源共享 | scheme+host+port 决定 Origin；CORS 不等于鉴权 |
| SSE | Server-Sent Events，服务端推送事件 | W05 Provider 将网络数据转为内部事件 |
| stream interruption | 流中断 | 未正常结束的流；区别于主动取消 |
| rerun / Session State | 脚本重新运行/会话状态 | Streamlit 的界面机制，不代表持久化数据库 |
| fallback | 降级路径 | 必须保留来源；不把失败伪装为真实成功 |
| TTL | Time To Live，存活时间 | 到期失效机制，仍需明确删除和归档策略 |
| ANN | Approximate Nearest Neighbor，近似最近邻 | 比较召回质量与速度的索引方法类别 |
| HNSW | Hierarchical Navigable Small World，分层近邻图 | 使用图搜索近邻 |
| IVF | Inverted File，倒排分区 | 按分区缩小搜索范围 |
| RRF | Reciprocal Rank Fusion，倒数排名融合 | 合并排名，k=60为原论文实验选择 |
| Grounding | 基于可核对证据生成 | 相关文本不自动等于足够事实 |
| HITL | Human-in-the-Loop，人工参与闭环 | W07/W08 对特定写操作进行人工审批 |
| MCP | Model Context Protocol，模型上下文协议 | 真实握手/工具发现与旧教学 JSONL 分开 |
| Evidence Gate | 本课程的证据门组织用语 | 区分学习证据与本人真实执行证据，非统一框架 API |
| effect / permission | 副作用类别/权限 | read/write 是副作用类别，不能替代身份与业务授权 |
| StateGraph | LangGraph 状态图构建器 | W08 当前真实使用；关键词策略不是模拟框架 |
| Checkpoint | 检查点 | 保存运行状态，不自动保证外部写操作恰好一次 |
| MHA / KV Cache | Multi-Head Attention，多头注意力 / Key-Value Cache，键值缓存 | W09 小矩阵演算不能当作真实模型性能结论 |
| LoRA | Low-Rank Adaptation，低秩适配 | 小矩阵参数更新，不适合维护实时库存 |
| PEFT | Parameter-Efficient Fine-Tuning，参数高效微调 | 一类节省训练参数的方法，LoRA 是其中之一 |
| Reflection | 反思修订 | 有触发条件、次数/成本上限与质量停止条件 |
| Trace / Span | 执行轨迹/一个执行片段 | W10 顺序汇总与生产并发追踪的字段不可混用 |
| ADR | Architecture Decision Record，架构决策记录 | 记录背景、候选、取舍、后果与证据 |
| Spike | 限时探索实验（非缩写） | 先定最高风险假设与通过/失败条件 |
| Walking Skeleton | 最小可运行骨架 | 先贯通边界，尚未证明业务价值 |
| Thin Slice | 最小业务切片 | 跨输入、规则和输出交付一条验收价值 |
| CI / CD | Continuous Integration / Continuous Delivery or Deployment | 持续集成/交付或部署，说明人工审批关口 |
| RC | Release Candidate，发布候选 | 唯一提交与制品，不等于发布通过 |
| Canary / Blue-green | 金丝雀发布/蓝绿部署 | 流量逐步放量/两套环境切换，均需回退验证 |
| fail closed | 条件不明时拒绝继续 | 记录原因，不静默伪造成功 |
| P50 / P99 | 第50/99百分位 | 说明窗口、样本与估计方法；不平均实例百分位 |
| SLI / SLO / SLA | Service Level Indicator / Objective / Agreement | 服务等级指标/目标/协议，不相互代签 |
| Runbook | 运行手册 | 接手者能执行的启动、检查、故障、停止、恢复步骤 |
同一意思不保证字段同名
W04 LLMCallMetric 使用 evidence_layer；W06 LocalReranker 使用 evidence_level；W07 Planner metric 使用 source；W10 汇总返回 source=REPLAY。按模块真实合同读取，不能统一替换成某个猜测字段。
证据分层
| 层次 | 能证明 | 不能证明 |
|---|---|---|
| 静态检查 | 文件、接口、链接与语法匹配 | 程序已运行 |
| 单元/合同测试 | 在指定输入和替身下行为满足断言 | 真实 ERP、MySQL 或网络可用 |
| Replay / Mock / Fixture | 可重复机制与错误分支 | 本人真实模型调用 |
| 真实框架/SQLite/子进程 | 相应框架与本地恢复实测 | Docker、生产并发、外部系统 |
| 真实外部环境 | 实际运行过的 API/MySQL/Docker/浏览器结果 | 未执行的其他环境和学生能力 |
| 学生现场与全日演练 | 本人操作与相应教学流程证据 | 就业、薪资或生产上线保证 |