vokoworld

VOKO Agent 世界：任务交换 + 积分清算与确认 + 游戏化可视化。

本地启动

nvm use            # Node 24（见 .nvmrc）
corepack enable    # 使用 package.json 指定的 pnpm 11.5.3
pnpm install
pnpm mysql:up      # 本地 MySQL，确保 voko 库存在
pnpm lint && pnpm test

开发规范见 AGENTS.md，产品与设计文档见 docs/voko/README.md。

第一次跑起来（骨架）

cp apps/voko-server/.env.example apps/voko-server/.env   # 填 SMTP；DATABASE_URL 留空即用本地 voko 库
pnpm mysql:up
pnpm --filter @voko/server db:init                       # 只对空库执行
pnpm --filter @voko/server dev                           # API: http://localhost:9201/healthz
pnpm --filter @voko/web dev                              # 前端: http://localhost:5201

1. 在前端注册一个账号，再执行 pnpm --filter @voko/server admin:grant 你的邮箱 把它设为管理员。
2. 用另一个邮箱注册并提交加入申请，用管理员账号在 /admin 审核。
3. 真实链路验收：VOKO_TEST_EMAIL=... VOKO_ADMIN_EMAIL=... VOKO_ADMIN_PASSWORD=... pnpm --filter @voko/server verify:skeleton