阶段：G0-环境搭建与验证 ｜ 预计耗时：30-40 分钟 ｜ 前置：G0-01 环境验证 已就位：
langgraph.json（Studio 配置）+examples/g0_studio_demo.py（最小演示图） 2026-11-11 实测记录：首次启动报错ConsoleRenderer with colors=True on Windows requires colorama，装 colorama 后修复；demo 图已在 dev server 注册成功。
学习目标
- 会启动
langgraph dev并在浏览器 Studio 里看到自己的图 - 会单步执行：看状态在节点之间怎么流动——这是理解 G1 所有概念的视觉基础
- 知道 Studio 的定位：它不是玩具，是你以后调 bug 的主力 debugger
核心知识
1. langgraph dev 的三件套
启动后它会给你三个地址：
- API：http://127.0.0.1:2024——本地开发服务器（内存态，重启即清空）
- Studio UI：https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024——浏览器打开的可视化界面（远程页面连你本地服务器，图数据不出机器）
- API Docs：http://127.0.0.1:2024/docs——本地服务器的 HTTP 接口文档（G6 会用到）
2. langgraph.json：Studio 怎么知道你的图在哪
{
"dependencies": ["./"],
"graphs": { "demo": "./examples/g0_studio_demo.py:graph" }
}
graphs的键是图的名字，值是文件路径:变量名- 以后每写一个新图，就在这里加一行——Studio 下拉框里就能切换
- ⚠️ 陷阱：指向的文件顶层代码会在加载时执行——所以演示图不能在顶层写
invoke（会花掉 API 额度），要么用if __name__ == "__main__":保护，要么只给 Studio 专用图
3. 本机踩坑实录（已修复）
| 症状 | 根因 | 解法 |
|---|---|---|
启动即崩 Unable to configure formatter 'simple' |
structlog 在 Windows 需要色显支持包 | pip install colorama（2026-11-11 已装） |
| 浏览器打不开 Studio | 端口被防火墙拦 | langgraph dev --port 3000 换端口 |
实验任务
任务 1：启动并打开 Studio（15 分钟）
cd /e/zcode/DeepTraining/langgraph-learn
.venv/Scripts/langgraph.exe dev
浏览器打开命令行里显示的 Studio UI 地址，左侧下拉选 demo 图。
任务 2：单步执行观察状态（15 分钟）
- 点
+ Input，输入{"question": "你好", "log": []}，提交 - 观察图上先后亮起 ask → polish 两个节点
- 点每个节点看它的输入/输出状态：answer 怎么变的？log 怎么从 1 条变 2 条？
- 用
langgraph dev的"重跑/回放"功能再看一遍
任务 3：改图再观察（10 分钟）
在 g0_studio_demo.py 里给 polish 和 END 之间插一个新节点 translate（把 answer 加个英文后缀即可），重启 dev，确认图上出现三个节点——Studio 里看到的就是你代码里写的。
验收标准
衔接下一阶段
会"看"图了 → G1-01 第一个 Agent 解剖：把已经跑通的计算器 agent 逐行拆开。