教学简化与工程实践对照
本表服务现有课程的解释、复习与面试回链。外部系统、平台接入和高级框架比较为延伸，按真实项目需要与批准条件实施；不能把阅读本表或跑过教师示例写成已完成生产部署。
| 周次 | 当前教学基线 | 工程中怎样延伸 | 最小可核对证据 |
|---|---|---|---|
| W01 | 字典、规则函数、交互 CLI、unittest | 规则随版本管理；将用户输出与诊断分开，类型提示在W02接续 | 同输入前后结果、状态不被半更新、规则变更提交 |
| W02 | JSON 原子写、分层、pytest | logging级别/固定字段；环境变量与依赖锁；CI在W03接上 | 损坏输入不覆盖、日志不污染JSON、干净环境重建 |
| W03 | FastAPI、MySQL事务、UoW、有限接口 | 身份提供方/OIDC、JWT验签与授权；分页上限；幂等键；版本合同；Redis cache-aside | 过期/越权/重放负例，缓存失效与并发事务测试；CORS不是登录 |
| W04 | 单轮Provider、结构校验、两项只读工具 | Token窗口预算、模型/Prompt版本、tool_choice与受控并行 | 每次调用来源、usage、预算；无效工具参数执行前阻断 |
| W05 | 会话隔离、SSE、Streamlit、内存状态 | 按租户的Redis/数据库会话、TTL/归档、Token裁剪；双向通信需要时评估WebSocket | 长文本、取消、断流、重启、并发与身份隔离 |
| W06 | exact/BM25/RRF、可核对引用 | pgvector或独立向量库、HNSW/IVF、神经重排、查询改写与评测器校准 | 同样本Recall/MRR、权限过滤、引用准确、端到端延迟 |
| W07 | 受限三工具Agent、模型候选、Host审批、MCP | 工具超时与有限重试；写操作查幂等结果；模型与工具分别设预算 | 越权/注入/重放/超时负例；真实MCP握手与工具结果 |
| W08 | 真实LangGraph与SQLite检查点、规则路由 | 多实例持久化、图版本迁移；需要时引入子图与并行、结构化分类 | 同thread跨进程恢复、审批绑定、幂等业务写；Docker另验 |
| W09 | 小矩阵、单神经元、手写向量、明确Replay | PyTorch自动求导、真实Embedding、vLLM等Serving、量化/缓存 | 数值检查；实际模型/硬件/样本/吞吐/显存单独测量 |
| W10 | 原理实验与四维选型指标 | 模型/Prompt版本回归；RAGAS等辅助评测；LangSmith/Langfuse或OTel追踪 | 相同问题集、费用口径、P99窗口、并发上限和质量底线 |
| W11 | 陌生ERP需求、Fixture、ADR与首条切片 | Frappe API/Hook、自主短迭代、Code Review、风险登记 | 需求例子→验收→diff→测试→评审；真实ERP版本/权限单独G0 |
| W12 | 发布门、交付示例、健康/故障/指标、Runbook | CI/CD环境审批、Prometheus/Grafana、灰度/蓝绿、回退与容量规划 | 同一制品、真实staging/production记录、告警闭环、非作者接手 |
W10 每日工具映射与取舍
| 日 | 原理对应实践 | 使用前先回答 |
|---|---|---|
| D01 训练全流程 | 数据版本、评测集隔离、模型卡与训练记录 | 数据授权与任务变化是否需要改参数？ |
| D02 LoRA / PEFT | PEFT工具实现适配器；保存基座版本与adapter配置 | 是稳定行为变化还是频繁事实更新？ |
| D03 RAG | Ragas/TruLens类评测器辅助校准；重排器与向量检索分层 | 分数是否与人工标注一致，错误发生在哪层？ |
| D04 Agent / Workflow | LangSmith/Langfuse或OpenTelemetry把模型、工具、人工等待分开追踪 | 能否用request/trace/call关联一次动作，并保护敏感数据？ |
| D05 选型 | 固定样本回归、延迟分布与预算表 | 改进是否同时满足质量、费用、尾延迟与容量约束？ |
工具是可选实现，不表示市场份额排名或企业普遍采用。平台版本、价格与部署方式以使用时的官方说明为准；不要为了补知识点强行部署所有工具。