0.2 学习路线与使用约定
0.2 学习路线与使用约定
本节摘要：本节交代三件出发前的事：一，速成（40 分钟）与体系化两条学习路线怎么选；二，运行环境——所有示例代码内嵌在小节 markdown 中，需要
TYPESAFE_API_KEY，第 9 章校准脚本另有无 Key 的 MOCK 模式；三，信息可靠性声明——本教程区分官方事实、厂商自报数据、独立批评与教学归纳四类信息，Jev 处于早期访问阶段，细节以官方文档为准。
学习目标
阅读完本节，你应当能够：
- 选定自己的学习路线并列出要读的章节。
- 完成 API Key 申请与环境准备。
- 知道教程中数字与结论的可靠级别。
一、两条学习路线
路线 A · 速成（约 40 分钟）：读第 04 章，跑通第一个调用，然后按需查第 67 章的模式。适合手头就有需求要落地的人。
路线 B · 体系化（建议）：顺序读完第 1~10 章。每章先读支柱页（00-支柱页.md）建立地图，再进小节；小节末尾的"要点回顾 + 过渡段"负责把线索交给下一节。
按需跳读速查：
- 10 分钟跑通第一个调用 → 第 4 章（前置：第 3 章问题类型）
- 分类/路由/护栏需求 → 第 6~7 章对应模式
- 准备上生产 → 第 8~9 章
- 技术选型 → 第 1、2、10 章
- 查参数/限制 → 附录 B（API 速查表）
二、运行环境与代码约定
-
API Key：在 console.typesafe.ai 申请（目前为早期访问阶段），导出为环境变量：
export TYPESAFE_API_KEY=... # Linux / macOS set TYPESAFE_API_KEY=... # Windows cmd $env:TYPESAFE_API_KEY="..." # PowerShell -
语言环境：Python ≥ 3.10（
pip install requests，第 4 章起）；Node ≥ 20（第 4.2 节）。 -
代码分发约定：本教程所有示例代码内嵌在小节 markdown 中，代码块首行注释标注来源文件名（如
# 02_choice_intent_routing.py），拷出即用，无需找仓库。 -
无 Key 也能学的部分：第 9 章校准脚本内置 MOCK 数据源，可本地跑通"可靠性曲线 + ECE"算法演示。
三、信息可靠性声明
本教程的事实性内容来自三类来源（完整清单见教程总纲末尾），阅读时请区分四个可靠级别：
| 级别 | 内容 | 例 |
|---|---|---|
| ① 官方事实 | API 结构、问题类型、定价规则 | "输入 $0.042/百万 token，输出免费" |
| ② 自报数据 | 性能与成本倍数（官方自己标注为"真实收益偏高端"） | "快 193.6 倍、便宜 444.6 倍" |
| ③ 独立实测/批评 | 第三方延迟实测、失败模式、批评观点 | "多数调用 ~100ms"；"约束形状≠约束判断" |
| ④ 教学归纳 | 本教程为教学组织的概括与命名 | "智能 if 语句的心智模型"、"影子模式四步法"的步骤化 |
⚠️ 时效提醒：Jev 发布于 2026-09-15，教程信息截至 2026-09-21。早期访问阶段限速动态调整、模型行为随版本变化、图像输入"暂未支持"。生产使用前，请以 docs.typesafe.ai 与你按第 9 章方法自测的结果为准。
本节要点回顾
- 路线：速成走 0→4 章；体系化顺序通读，支柱页先行。
- 环境：
TYPESAFE_API_KEY+ Python/Node；代码全内嵌，拷出即用。 - 可靠性：分清官方事实、自报数据、独立批评与教学归纳四类信息。
钥匙领好了。从下一章起进入正文——先回到 2026 年 9 月 15 日之前：模型聊天已经超越人类好几年了，自动化到底在哪里？