本地快速开始

1. 安装依赖

在仓库根目录执行 frozen install，确保使用已审核的锁文件。

corepack enable
pnpm install --frozen-lockfile

2. 启动本地开发栈

在仓库根目录运行 pnpm dev:all。Ctrl+C 会一起停止。它启动：

• 公开站点 http://localhost:3001
• 控制台 http://localhost:3000
• Control API，端口 4000
• flow-table 模块 API，端口 4101
• data-exchange 模块 API，端口 4102
• data-exchange 的 sheet executor，仅回环 127.0.0.1:9102（pnpm dev:data-exchange-executor，已包含在 pnpm dev:all）
• dictionary 模块 API，端口 4104（pnpm dev:dictionary，已包含在 pnpm dev:all）
• localization-jobs 模块 API，端口 4105（pnpm dev:localization-jobs，已包含在 pnpm dev:all）
• 开发代理 http://127.0.0.1:8000
• 邮件 relay

前端的 NEXT_PUBLIC_API_BASE_URL 应为 http://127.0.0.1:8000。各服务也可用根 package.json 中的 dev:* 命令单独启动。

pnpm dev:all

3. Agent 栈另行启动

Agent 不在 pnpm dev:all 里。用 pnpm dev:agent-all 一次启动模块 API（:4103）、Temporal worker、outbox relay 和 agent 侧 sheet executor（默认仅回环 127.0.0.1:9101）。模块 API 需要 AGENT_MODEL_ENDPOINTS_FILE。启动前同样会跑上面的 Temporal 预检。

pnpm dev:agent-all

也可以分开启动：

pnpm dev:agent            # :4103
pnpm dev:agent-worker
pnpm dev:agent-relay
pnpm dev:sheet-executor

4. 运行源码验证

make www-check
pnpm --filter @platform/www build

这些命令验证 lint、类型和生产构建，不代表 Supabase、Temporal、邮件或跨服务链路已经完成真实集成。