第 2 篇 · 2.1 快速地图
学习目标
完成本节后，你将能够：
- 知道本地开发最常用的命令。
- 区分文档站点、Web 应用、Worker 的启动方式。
- 找到第一次读代码的入口文件。
2.1.1 最小命令
bash
pnpm install
pnpm run dev如果你要同时启动原 Langfuse repo 的 Web 和 Worker，需要回到 ../langfuse 运行：
bash
pnpm run dev:web
pnpm run dev:worker如果要完整本地环境：
bash
pnpm run infra:dev:up
pnpm run db:generate
pnpm run seed -- list2.1.2 三个入口别混淆
| 入口 | 命令 | 作用 |
|---|---|---|
| 本书站点 | pnpm run dev | 在 langfuse-guide 中在线阅读本教程 |
| Web 应用 | pnpm run dev:web | 在原 langfuse repo 中启动 Next.js UI + API |
| Worker | pnpm run dev:worker | 在原 langfuse repo 中启动 BullMQ consumers |
2.1.3 第一次打开哪些文件
| 目的 | 文件 |
|---|---|
| 看 package 结构 | pnpm-workspace.yaml |
| 看根命令 | package.json |
| 看 Turbo 任务 | turbo.json |
| 看 tRPC 聚合 | web/src/server/api/root.ts |
| 看 worker 注册 | worker/src/app.ts |
| 看队列契约 | packages/shared/src/server/queues.ts |