docs(zh): 修复 s20-s34 运行命令缺少 .env 加载，补充 .gitignore

- s20-s34 文档：npx tsx src/cli.tsx → npm run dev（已内置 --env-file=.env）
- 终端录制数据 s13-s26：同步更新模拟器中的启动命令
- .gitignore：补充 pnpm-lock.yaml / yarn.lock / bun.lockb

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: hashpanda

.gitignore

@@ -11,6 +11,9 @@ web/src/data/generated/
 
 # Agent lock files (generated on install)
 agents/*/package-lock.json
+agents/*/pnpm-lock.yaml
+agents/*/yarn.lock
+agents/*/bun.lockb
 
 # Build
 dist/

docs/zh/s20-basic-streaming.md

@@ -140,7 +140,7 @@ function StreamingMessage({ content }: { content: string }) {
 ## 验证
 
 ```bash
-cd agents/s20-basic-streaming && npx tsx src/cli.tsx
+cd agents/s20-basic-streaming && npm run dev
 ```
 
 1. 发送 "explain what streaming means" → 文字逐字出现

docs/zh/s21-advanced-streaming.md

@@ -178,7 +178,7 @@ function ThinkingMessage({ content, streaming }) {
 ## 验证
 
 ```bash
-cd agents/s21-advanced-streaming && npx tsx src/cli.tsx
+cd agents/s21-advanced-streaming && npm run dev
 ```
 
 1. 发送一个复杂问题 → 观察 💭 thinking 实时显示

docs/zh/s22-parallel-tools.md

@@ -177,7 +177,7 @@ const toolResults = await executor.executeAll();
 ## 验证
 
 ```bash
-cd agents/s22-parallel-tools && npx tsx src/cli.tsx
+cd agents/s22-parallel-tools && npm run dev
 ```
 
 1. 发送 "read package.json and tsconfig.json at the same time" → 观察两个 file_read 并行执行

docs/zh/s23-startup-perf.md

@@ -227,10 +227,10 @@ export function startPrefetch(cwd: string) {
 cd agents/s23-startup-perf
 
 # 快速路径测试
-npx tsx src/cli.tsx --version  # 应该立即输出版本号
+npm run dev -- --version  # 应该立即输出版本号
 
 # 性能分析
-npx tsx src/cli.tsx --profile  # 启动后查看 stderr 的性能报告
+npm run dev -- --profile  # 启动后查看 stderr 的性能报告
 ```
 
 ## 对照 Claude Code
@@ -269,6 +269,6 @@ cli.tsx (bootstrap)
 
 ## 练习
 
-1. 在你的机器上实际测量：`time npx tsx src/cli.tsx --version`，然后对比 `time npx tsx src/cli.tsx`（完整启动）
+1. 在你的机器上实际测量：`time npm run dev -- --version`，然后对比 `time npm run dev`（完整启动）
 2. 实现 `startDeferredPrefetches()`：在首次渲染 200ms 后执行一些低优先级初始化
 3. 添加一个缓存层：把 `detectProjectRoot` 的结果缓存到 `/tmp`，下次启动直接读取

docs/zh/s24-auto-compact.md

@@ -210,7 +210,7 @@ private async maybeCompact(onOutput): Promise<void> {
 cd agents/s24-auto-compact
 
 # 启动 Agent
-npx tsx src/cli.tsx
+npm run dev
 
 # 进行多轮对话，观察当 token 数接近阈值时自动压缩的行为
 # 压缩状态会通过 compact_status 类型输出显示

docs/zh/s25-multi-compact.md

@@ -179,7 +179,7 @@ await this.maybeAutoCompact(onOutput);
 cd agents/s25-multi-compact
 
 # 启动 Agent
-npx tsx src/cli.tsx
+npm run dev
 
 # 多次读取大文件，观察微压缩行为
 # 当工具结果数量超过 5 个时，旧的会被替换为占位符

docs/zh/s26-tool-result-budget.md

@@ -175,7 +175,7 @@ this.applyBudget(onOutput);  // 确保不超预算
 cd agents/s26-tool-result-budget
 
 # 启动 Agent
-npx tsx src/cli.tsx
+npm run dev
 
 # 让 Agent 读取一个大文件
 > 读取 node_modules/typescript/lib/typescript.d.ts

docs/zh/s27-todo-write.md

@@ -167,7 +167,7 @@ export const todoWriteTool = buildTool({
 
 ```bash
 cd agents/s27-todo-write
-npx tsx src/cli.tsx
+npm run dev
 
 # Agent 会在处理复杂任务时自动使用 TodoWrite
 # 观察任务状态从 pending → in_progress → completed 的流转

docs/zh/s28-subagent-basic.md

@@ -129,7 +129,7 @@ export const agentTool = buildTool({
 
 ```bash
 cd agents/s28-subagent-basic
-npx tsx src/cli.tsx
+npm run dev
 
 > 分析 src/ 目录的代码质量，同时搜索所有 TODO 注释
 # Agent 会创建子 Agent 来独立执行子任务