菜单
Launch the Flux exchange locally or with full production wiring. Use when asked to run, start, boot, or demo the app, the API, the workers, the frontend, or the whole stack, or to verify a change works in the real app. Covers the RUNTIME_MODE split, Prisma setup, required env vars, and ports.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/mangit955/flux --skill run命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | run |
| description | Launch the Flux exchange locally or with full production wiring. Use when asked to run, start, boot, or demo the app, the API, the workers, the frontend, or the whole stack, or to verify a change works in the real app. Covers the RUNTIME_MODE split, Prisma setup, required env vars, and ports. |
Two modes, selected by RUNTIME_MODE. Default to local unless the task specifically needs
Postgres, Redis, or real market data.
createApiApp() uses InMemoryApiRuntime + InMemoryStreamBus, and apps/api/src/index.ts
drives runtime.drain() on a setInterval, so matching and persistence run in-process.
bun run --filter api dev # http://localhost:3000, ws://localhost:3000/ws
bun run --filter web dev # http://localhost:3001
The API dev script loads ../../.env explicitly (bun --env-file=../../.env). There is no
root .env.example despite the README referencing one; local mode runs without it.
Worker cadence: WORKER_INTERVAL_MS (default 50ms for the API's in-process loop).
Frontend env — apps/web/.env.local:
NEXT_PUBLIC_API_URL=http://localhost:3000
NEXT_PUBLIC_WS_URL=ws://localhost:3000/ws
Without these it warns and falls back to those same defaults.
docker compose up -d postgres redis
Postgres perp:perp@localhost:5432/perp_v3, Redis . Both have healthchecks.
localhost:6379The schema lives at the repo root (prisma/schema.prisma) but the scripts live in
packages/db and pass --schema ../../prisma/schema.prisma. Run them from there:
cd packages/db
bun run prisma:generate
bun run prisma:deploy # or prisma:migrate for dev
bun run db:seed # psql "$DATABASE_URL" -f ../../prisma/seed.sql — needs psql on PATH
RUNTIME_MODE=production
DATABASE_URL=postgresql://perp:perp@localhost:5432/perp_v3
REDIS_URL=redis://localhost:6379
JWT_SECRET=dev-secret-change-me
SNAPSHOT_DIR=./snapshots
BINANCE_WS_URL=wss://fstream.binance.com
DATABASE_URL, JWT_SECRET, and REDIS_URL are hard-required — createProductionApiApp()
throws on startup if any is missing. The rest have defaults.
bun run --filter api dev # API only; does NOT run workers in this mode
bun run --filter workers dev # matching + persistence + outbox
bun run --filter market-data dev # Binance mark prices → Redis
WORKER_ROLE selects which workers run (matching, persistence, outbox, or all —
default all).
Run exactly one matching worker per market. The orderbook is in process memory and the
consumer name defaults to the constant "matching-engine-1", so two replicas split the command
stream and build divergent books writing to the same Redis cache key. Nothing prevents this
(TODO.md #16).
If Redis groups have not been created yet: bun run init:redis.
curl localhost:3000/health # {"ok":true}
curl localhost:3000/markets
curl -X POST localhost:3000/auth/guest # returns { token, userId }
curl localhost:3000/markets/BTC-PERP/orderbook
Authenticated calls take Authorization: Bearer <token>.
In local mode, POST /deposits is enabled only when NODE_ENV=development — use it to fund a
test account before submitting orders.
Submit an order:
curl -X POST localhost:3000/orders \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"marketId":"BTC-PERP","side":"BUY","type":"LIMIT","quantity":1,"price":65000,"timeInForce":"GTC"}'
Returns 202 on accept, 400 on reject. Orders are matched asynchronously — poll GET /orders
or subscribe over the websocket.
brew install k6
k6 run load-tests/perpetual-futures-load-test.js # API must already be running
Measures the HTTP submission path. Note it asserts latency, not correctness — it does not check
balance invariants, and the balance race (TODO.md #5) passes it.
db:seed fails → psql not on PATH.bun run init:redis). See the streams-diag skill.NEXT_PUBLIC_API_URL; /debug renders the resolved config.