快速开始
一键引导 Mock 或真实百炼配置,生成管理员令牌并启动本地服务
运行 pnpm start 即可完成首次配置并启动本地服务。可选择 Mock(无需百炼凭据)或
真实百炼;两种模式默认都使用成员登录。
安装并启动
准备 Node.js ≥ 24 与 pnpm 9.15.9,在仓库根目录执行:
pnpm install
pnpm start根目录没有 .env 时,终端会引导选择:
- Mock:直接回车或选择
1,无需云凭据,使用内置模拟网关。 - 真实百炼:选择
2,输入 API Key(输入不回显),然后填写 Workspace ID 或 Base URL。
启动器从 .env.example 创建 .env,自动生成 32 字节安全随机数作为管理员令牌(64 个十六进制字符),
并限制新文件仅当前用户可读写。引导完成后会先构建所需工作区依赖,再启动 server、体验页和管理端。
中途按 Ctrl+C 会取消引导,不生成半份配置;可重新运行 pnpm start。
已有 .env 时直接复用整个文件,不再询问模式、不替换令牌或补写字段。
已有配置不完整时请手动补齐;切换模式或修改配置后需重启服务。
根 .env 的非空值覆盖 shell 同名变量。填入 Workspace ID 或 Base URL 后,另一地址字段的显式空值
也会覆盖 shell 继承值。启动日志只打印被覆盖的变量名。
新生成的 Mock 配置使用 .scratch/local-demo/data,真实百炼配置使用 .data,用于隔离两种模式的数据。
重复体验时保留相应目录即可沿用已有模版和成员。
ADMIN_TOKEN 是管理端的登录密钥,相当于管理员密码。生成后请从本地根 .env 的
ADMIN_TOKEN 字段读取并用于登录;终端不会打印令牌原文。体验页使用在管理端创建的成员账号。
另开终端检查服务:
curl http://localhost:8787/healthz选择 Mock 时应显示 gateway=mock,真实百炼应显示 gateway=sdk。
默认入口如下,实际地址以启动日志为准:
| 入口 | 默认地址 |
|---|---|
| 管理端 | http://localhost:5174 |
| 体验页 | http://localhost:5173 |
| Kit Server | http://localhost:8787 |
此时管理端显示令牌登录页,体验页显示成员登录页。 健康检查只证明服务已启动,真实百炼凭据和云端对话仍需在实际使用时验证。
后续启动继续执行 pnpm start。需要指定目标时使用 pnpm start server web;
开发者也可使用 pnpm dev 启动默认四个目标(包含文档站 :3000),或用
pnpm dev server web console 只起应用。pnpm setup 是可选的 Git hooks 安装命令,不负责生成配置。
接下来
创建模版、上架和完成成员对话,请参照本地跑通完整 Demo。