本地快速开始

1. 安装依赖#

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

corepack enable
pnpm install --frozen-lockfile

2. 启动本地开发栈#

在仓库根目录运行下面的命令，Ctrl+C 会一起停止子进程。

pnpm dev:all

它启动：

• 公开站点：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 启动。
• dictionary 模块 API：端口 4104，可单独用 pnpm dev:dictionary 启动。
• localization-jobs 模块 API：端口 4105，可单独用 pnpm dev:localization-jobs 启动。
• 开发代理：http://127.0.0.1:8000。
• 邮件 relay。

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

3. Agent 栈另行启动#

Agent 不在 pnpm dev: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、邮件或跨服务链路已经完成真实集成。