gamekit777 0.1.0

package/studio/app/lib/api.ts

@@ -0,0 +1,59 @@
+/* /studio/api 的类型化封装。页面和 node 侧同源，直接 fetch */
+import type { Artifact, GroupsSummary } from '../../src/build.ts';
+import type { CaseRecord, CaseResult } from '../../src/cases.ts';
+import type { Engine, PublishRequest } from '../../src/engine.ts';
+import type { Job } from '../../src/jobs.ts';
+import type { ProbeResult } from '../../src/probe.ts';
+import type { SolveReport, Targets } from '../../src/solver.ts';
+import type { TaskName, TaskResult } from '../../src/tasks.ts';
+
+const BASE = '/studio/api';
+
+async function call<T>(method: string, path: string, body?: unknown): Promise<T> {
+  const r = await fetch(`${BASE}${path}`, {
+    method, headers: body !== undefined ? { 'Content-Type': 'application/json' } : undefined,
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  });
+  const data = await r.json() as T & { error?: string };
+  if (!r.ok) throw new Error(data.error ?? `${method} ${path} → ${r.status}`);
+  return data;
+}
+
+export type Info = Awaited<ReturnType<Engine['info']>>;
+
+export const api = {
+  info: () => call<Info>('GET', '/info'),
+  probe: (o: { sims?: number } = {}) => call<Job<ProbeResult>>('POST', '/probe', o),
+  sample: (modes: string[] | null, sims: number | null) => call<Job>('POST', '/sample', { modes, sims }),
+  groups: (mode: string | null, sims: number | null) =>
+    call<GroupsSummary>('GET', `/groups?${new URLSearchParams({ ...(mode ? { mode } : {}), ...(sims ? { sims: String(sims) } : {}) })}`),
+  solve: (mode: string | null, sims: number | null, targets: Targets) => call<SolveReport & { mode: string; rtpRangePpm: [number, number] }>('POST', '/solve', { mode, sims, targets }),
+  build: (o: { modes?: string[] | null; sims?: number; rtpPpm?: number; segments?: unknown }) => call<Job<Artifact[]>>('POST', '/build', o),
+  artifacts: () => call<Artifact[]>('GET', '/artifacts'),
+  artifactTable: async (mode: string) => new Uint8Array(await (await fetch(`${BASE}/artifacts/${encodeURIComponent(mode)}/table`)).arrayBuffer()),
+  artifactBooks: (mode: string) => call<{ simId: number; frames: string }[]>('GET', `/artifacts/${encodeURIComponent(mode)}/books`),
+  jobs: () => call<Job[]>('GET', '/jobs'),
+  job: <T>(id: string) => call<Job<T>>('GET', `/jobs/${id}`),
+  task: (task: TaskName) => call<Job<TaskResult>>('POST', '/task', { task }),
+  cases: () => call<CaseRecord[]>('GET', '/cases'),
+  caseRun: (o: { ids?: string[]; model?: 'formula' | 'table' | 'both' } = {}) =>
+    call<{ total: number; pass: number; fail: number; skipped: number; error: number; results: CaseResult[] }>('POST', '/cases/run', o),
+  caseBless: (updates: { id: string; expect: CaseRecord['expect'] }[]) => call<{ blessed: number }>('POST', '/cases/bless', { updates }),
+  caseRemove: (id: string) => call<{ removed: boolean }>('DELETE', `/cases/${id}`),
+  publishList: () => call<PublishRequest[]>('GET', '/publish'),
+  publishRequest: (modes: string[] | null, note: string | null) => call<PublishRequest>('POST', '/publish/request', { modes, note }),
+  publishUpdate: (id: string, patch: Partial<PublishRequest>) => call<PublishRequest>('POST', `/publish/${id}`, patch),
+  previewCommand: <T>(cmd: unknown) => call<T>('POST', '/preview/command', cmd),
+  log: (msg: string, level: 'info' | 'warn' | 'error' = 'info') => call<unknown>('POST', '/log', { msg, level }),
+
+  /** 等一个 job 结束 */
+  async waitJob<T>(id: string, onProgress?: (msg: string) => void): Promise<Job<T>> {
+    let seen = 0;
+    for (;;) {
+      const j = await api.job<T>(id);
+      for (; seen < j.progress.length; seen++) onProgress?.(j.progress[seen]!);
+      if (j.status !== 'running') return j;
+      await new Promise((r) => setTimeout(r, 400));
+    }
+  },
+};

package/studio/app/lib/bus.svelte.ts

@@ -0,0 +1,44 @@
+/* 页面侧的总线订阅：SSE → runes。日志、任务、指纹、预览状态、发布请求都从这里进来 */
+import type { BusEvent } from '../../src/bus.ts';
+import type { PreviewState, PublishRequest } from '../../src/engine.ts';
+
+export interface LogLine { level: 'info' | 'warn' | 'error'; msg: string; at: number }
+
+class Bus {
+  connected = $state(false);
+  clients = $state(0);
+  logs = $state<LogLine[]>([]);
+  jobs = $state<Record<string, { kind: string; status: string; msg: string; at: number }>>({});
+  fingerprint = $state<string | null>(null);
+  preview = $state<PreviewState | null>(null);
+  publish = $state<Record<string, PublishRequest>>({});
+  casesVersion = $state(0);
+  buildVersion = $state(0);
+
+  #es: EventSource | null = null;
+
+  connect(): void {
+    if (this.#es) return;
+    const es = new EventSource('/studio/api/events?role=page');
+    this.#es = es;
+    es.onopen = () => { this.connected = true; };
+    es.onerror = () => { this.connected = false; };
+    es.onmessage = (e) => {
+      let m: BusEvent;
+      try { m = JSON.parse(String(e.data)) as BusEvent; } catch { return; }
+      switch (m.t) {
+        case 'hello': this.clients = m.clients; break;
+        case 'log': this.logs = [...this.logs.slice(-199), { level: m.level, msg: m.msg, at: m.at }]; break;
+        case 'job': this.jobs = { ...this.jobs, [m.id]: { kind: m.kind, status: m.status, msg: m.msg, at: Date.now() } }; break;
+        case 'fingerprint': this.fingerprint = m.hash; break;
+        case 'preview': this.preview = m.state as PreviewState; break;
+        case 'cases': this.casesVersion++; break;
+        case 'build': this.buildVersion++; break;
+        case 'publish': { const r = m.request as PublishRequest; this.publish = { ...this.publish, [r.id]: r }; break; }
+        default: break;
+      }
+    };
+  }
+}
+
+export const bus = new Bus();

package/studio/app/lib/upload.ts

@@ -0,0 +1,34 @@
+/* 浏览器里的发布：身份是页面上登录的那个人。
+ *
+ * 表字节从 /studio/api 取（node 侧建好的产物），描述配置由页面里 import 的游戏清单算——
+ * GameModule 本身就是一份 GameDefinition，上传流程原样复用 publish 的 upload-core：
+ * CLI 走的也是这一份，只是身份换成了浏览器 cookie。 */
+import { createClient, type GameKitClient } from 'gamekit777/client';
+import type { GameDefinition } from 'gamekit777/sdk';
+import { uploadTables, type UploadResult, type UploadTable } from 'gamekit777/publish/upload-core';
+import type { Artifact } from '../../src/build.ts';
+import { api } from './api.ts';
+
+/** 同源，cookie 由浏览器带。/v1 反代到平台后端 */
+export const client: GameKitClient = createClient({ baseUrl: '' });
+
+export interface PublishPlan {
+  spec: GameDefinition<object, unknown>;
+  tables: UploadTable[];
+}
+
+/** 把 node 侧的产物 + 页面里的游戏清单拼成 uploadTables 要的形状 */
+export async function planFromArtifacts(spec: GameDefinition<object, unknown>, arts: Artifact[]): Promise<PublishPlan> {
+  const tables: UploadTable[] = await Promise.all(arts.map(async (a) => ({
+    mode: a.mode,
+    bytes: await api.artifactTable(a.mode),
+    contentHash: a.contentHash, rowCount: a.rowCount, betCostCenti: a.betCostCenti,
+    books: a.hasBooks ? await api.artifactBooks(a.mode) : null,
+    verdict: { computedRtpPpm: a.computedRtpPpm },
+  })));
+  return { spec, tables };
+}
+
+export function runUpload(plan: PublishPlan, o: { publishModes?: string[]; onProgress: (m: string) => void }): Promise<UploadResult> {
+  return uploadTables(plan.spec, plan.tables, { client, publishModes: o.publishModes, onProgress: o.onProgress });
+}

package/studio/app/main.ts

@@ -0,0 +1,5 @@
+import { mount } from 'svelte';
+import 'gamekit777/dev-host/theme.css';
+import App from './App.svelte';
+
+mount(App, { target: document.body });

package/studio/app/panels/CasePanel.svelte

@@ -0,0 +1,83 @@
+<script lang="ts">
+  import { api, type Info } from '../lib/api.ts';
+  import { bus } from '../lib/bus.svelte.ts';
+  import type { CaseRecord, CaseResult } from '../../src/cases.ts';
+
+  let { info }: { info: Info } = $props();
+  let cases = $state<CaseRecord[]>([]);
+  let results = $state<Map<string, CaseResult[]>>(new Map());
+  let summary = $state<{ pass: number; fail: number; skipped: number; error: number } | null>(null);
+  let busy = $state(false);
+  let err = $state<string | null>(null);
+
+  $effect(() => { void bus.casesVersion; void api.cases().then((c) => { cases = c; }); });
+
+  const x = (c: number) => `${(c / 100).toFixed(2)}x`;
+
+  async function run(ids?: string[]) {
+    busy = true; err = null;
+    try {
+      const r = await api.caseRun({ ids, model: 'both' });
+      const m = new Map<string, CaseResult[]>();
+      for (const x of r.results) m.set(x.id, [...(m.get(x.id) ?? []), x]);
+      results = m; summary = r;
+    } catch (e) { err = e instanceof Error ? e.message : String(e); }
+    finally { busy = false; }
+  }
+
+  async function bless(ids: string[]) {
+    busy = true; err = null;
+    try {
+      const r = await api.caseRun({ ids, model: 'both' });
+      const byId = new Map<string, CaseRecord['expect']>();
+      for (const x of r.results) if (x.actual) byId.set(x.id, { ...(byId.get(x.id) ?? cases.find((c) => c.id === x.id)!.expect), ...x.actual });
+      await api.caseBless([...byId].map(([id, expect]) => ({ id, expect })));
+      await run(ids);
+    } catch (e) { err = e instanceof Error ? e.message : String(e); }
+    finally { busy = false; }
+  }
+
+  const failed = $derived([...new Set([...results.values()].flat().filter((r) => r.status === 'fail').map((r) => r.id))]);
+  const replay = (c: CaseRecord) => api.previewCommand({ t: 'set', config: c.config, bet: c.bet })
+    .then(() => api.previewCommand({ t: 'play', rounds: 1, seed: c.seed, simId: c.table?.simId }))
+    .catch((e: unknown) => { err = e instanceof Error ? e.message : String(e); });
+</script>
+
+<div class="card">
+  <h2>Case <span class="hint">{info.caseFile}</span></h2>
+  <p class="hint">一条 case 是一个局面：作者点一下就在预览里重演、AI 读它写单测、以及结果漂移的护栏——任何结果变化都是 fail；有意改的规则且这个 mode 没发布过，确认后 bless。文件可以直接手改，studio 会跟着重载。</p>
+  <div class="row">
+    <button class="pri" onclick={() => run()} disabled={busy || !cases.length}>{busy ? '…' : '跑全部'}</button>
+    {#if failed.length}<button class="sec" onclick={() => bless(failed)} disabled={busy}>接受 {failed.length} 条 fail 的新结果</button>{/if}
+    {#if summary}<span class="hint"><span class="ok">{summary.pass} 过</span> · <span class="bad">{summary.fail} 败</span> · {summary.skipped} 跳过 · {summary.error} 错</span>{/if}
+  </div>
+  {#if err}<p class="bad">{err}</p>{/if}
+  {#if !cases.length}<p class="hint">还没有 case。在预览的历史列表里点「存」，或让 AI 用 case_add。</p>{/if}
+  <table>
+    <thead><tr><th>id</th><th>标题</th><th>定位</th><th>期望</th><th>结果</th><th></th></tr></thead>
+    <tbody>
+      {#each cases as c (c.id)}
+        {@const rs = results.get(c.id) ?? []}
+        <tr>
+          <td class="mono hint">{c.id}</td>
+          <td>{c.title}{#if c.tags?.length}<span class="hint"> {c.tags.join(' ')}</span>{/if}</td>
+          <td class="mono hint">{c.table ? `${c.table.mode}#${c.table.simId}` : ''}{c.seed ? ' 种子' : ''}</td>
+          <td class="num">{x(c.expect.payoutCenti)}</td>
+          <td>{#each rs as r (r.model)}<span class:ok={r.status === 'pass'} class:bad={r.status === 'fail' || r.status === 'error'} title={r.detail}>{r.model[0]}:{r.status} </span>{/each}</td>
+          <td class="acts">
+            <button class="sec" onclick={() => replay(c)} disabled={!bus.preview?.connected} title="在预览里重演">演</button>
+            <button class="sec" onclick={() => run([c.id])} disabled={busy}>跑</button>
+            <button class="sec" onclick={() => api.caseRemove(c.id)}>删</button>
+          </td>
+        </tr>
+        {#each rs.filter((r) => r.status !== 'pass') as r (r.model)}<tr><td colspan="6" class="hint detail">[{r.model}] {r.detail}</td></tr>{/each}
+      {/each}
+    </tbody>
+  </table>
+</div>
+
+<style>
+  .row{display:flex;gap:10px;align-items:center;flex-wrap:wrap}
+  .acts{display:flex;gap:4px} .acts button{padding:2px 8px;font-size:11px}
+  .detail{font-size:11px;padding-left:24px}
+</style>

package/studio/app/panels/LogPanel.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+  import { bus } from '../lib/bus.svelte.ts';
+  const jobs = $derived(Object.entries(bus.jobs).sort((a, b) => b[1].at - a[1].at));
+</script>
+
+<div class="grid">
+  <div class="card">
+    <h2>任务</h2>
+    <table><thead><tr><th>id</th><th>类型</th><th>状态</th><th>最近进度</th></tr></thead><tbody>
+      {#each jobs as [id, j] (id)}<tr><td class="mono hint">{id}</td><td>{j.kind}</td><td class:ok={j.status === 'done'} class:bad={j.status === 'failed'} class:warn={j.status === 'running'}>{j.status}</td><td>{j.msg}</td></tr>{/each}
+    </tbody></table>
+  </div>
+  <div class="card">
+    <h2>日志</h2>
+    <pre>{bus.logs.map((l) => `${new Date(l.at).toLocaleTimeString()} [${l.level}] ${l.msg}`).join('\n') || '（空）'}</pre>
+  </div>
+</div>
+
+<style>.grid{display:grid;gap:14px}</style>

package/studio/app/panels/PreviewPanel.svelte

@@ -0,0 +1,33 @@
+<script lang="ts">
+  /* 预览的状态。机台本身在左边那一栏，这里只放它报上来的东西：哪张表、注额、报错，以及怎么用 MCP 驱动它 */
+  import type { Info } from '../lib/api.ts';
+  import { bus } from '../lib/bus.svelte.ts';
+  let { info }: { info: Info } = $props();
+  const p = $derived(bus.preview);
+</script>
+
+<div class="card">
+  <h2>预览状态</h2>
+  {#if p?.connected}
+    <p class="hint">表 <span class="mono">{p.mode}</span> · 注额 {p.bet !== null ? (p.bet / 100).toFixed(2) : '—'}</p>
+    {#if p.lastError}<p class="bad">{p.lastError}</p>{/if}
+    {#if p.consoleErrors?.length}
+      <details><summary class="warn">{p.consoleErrors.length} 条控制台报错</summary><pre>{p.consoleErrors.join('\n')}</pre></details>
+    {:else}
+      <p class="hint">控制台没有报错</p>
+    {/if}
+  {:else}
+    <p class="hint">预览页还没连上总线</p>
+  {/if}
+</div>
+
+<div class="card">
+  <h2>这块预览是什么</h2>
+  <p class="hint">本地表模型，和玩家站点同一台机器：有建好的表就用建好的，没有就在第一注时就地采样建表。
+    机台下面的「历史」里，每一局都可以存成 case。</p>
+  <p class="hint">MCP：<code>claude mcp add gamekit -- bunx gamekit777 studio</code><br>在 {info.gameDir} 里起 Claude Code 即可驱动这块预览。</p>
+</div>
+
+<style>
+  code{font-family:var(--mono);font-size:11px;background:var(--field);padding:1px 5px;border-radius:4px}
+</style>

package/studio/app/panels/PublishPanel.svelte

@@ -0,0 +1,111 @@
+<script lang="ts">
+  /* 发布：身份是这个页面上登录的人（/v1 同源反代，cookie 由浏览器带）。
+     node 侧只排队和记录；MCP 发起的请求也落在这里，作者点确认才真传。发布不可逆。 */
+  import { onMount } from 'svelte';
+  import type { GameModule } from 'gamekit777/sdk';
+  import type { SessionView } from 'gamekit777/protocol';
+  import game from 'virtual:studio/game';
+  import { api, type Info } from '../lib/api.ts';
+  import { bus } from '../lib/bus.svelte.ts';
+  import { client, planFromArtifacts, runUpload } from '../lib/upload.ts';
+
+  let { info }: { info: Info } = $props();
+  const spec = $derived(info.snapshot.spec);
+  let me = $state<SessionView | null>(null);
+  let meErr = $state<string | null>(null);
+  let note = $state('');
+  let running = $state<string | null>(null);
+  let log = $state<string[]>([]);
+
+  const reqs = $derived(Object.values(bus.publish).sort((a, b) => b.createdAt - a.createdAt));
+  const pct = (ppm: number) => `${(ppm / 1e4).toFixed(4)}%`;
+
+  async function whoami() {
+    try { me = await client.session.me(); meErr = null; }
+    catch (e) { me = null; meErr = e instanceof Error ? e.message : String(e); }
+  }
+  async function anon() {
+    try { me = await client.session.bootstrap(); meErr = null; }
+    catch (e) { meErr = e instanceof Error ? e.message : String(e); }
+  }
+  onMount(() => { void whoami(); void api.publishList().then((l) => { for (const r of l) bus.publish = { ...bus.publish, [r.id]: r }; }); });
+
+  const lowest = $derived(info.artifacts.reduce<number | null>((m, a) => (m === null || a.computedRtpPpm < m ? a.computedRtpPpm : m), null));
+  const localIssues = $derived.by(() => {
+    const out: string[] = [];
+    const declared = Math.round(spec.rtp * 1e6);
+    if (!info.artifacts.length) out.push('当前指纹下没有已建的表');
+    if (lowest !== null && lowest + 100 < declared) out.push(`最低实算 RTP ${pct(lowest)} 低于游戏声明 ${pct(declared)}，平台会拒`);
+    const miss = spec.modes.filter((m) => !info.artifacts.some((a) => a.mode === m.name));
+    if (miss.length) out.push(`未建：${miss.map((m) => m.name).join('、')}`);
+    return out;
+  });
+
+  async function approve(id: string) {
+    const req = bus.publish[id]; if (!req) return;
+    running = id; log = [];
+    const say = (m: string) => { log = [...log, m]; void api.publishUpdate(id, { progress: [...(bus.publish[id]?.progress ?? []), m] }); };
+    await api.publishUpdate(id, { status: 'running' });
+    try {
+      const arts = req.modes ? info.artifacts.filter((a) => req.modes!.includes(a.mode)) : info.artifacts;
+      if (!arts.length) throw new Error('没有可发布的表');
+      say(`拼装 ${arts.length} 张表…`);
+      const plan = await planFromArtifacts(game as GameModule<object, unknown>, arts);
+      const r = await runUpload(plan, { publishModes: req.modes ?? undefined, onProgress: say });
+      await api.publishUpdate(id, { status: 'published', result: { gameId: r.game.id, slug: r.game.slug, verifiedRtpPpm: r.game.verifiedRtpPpm, modes: r.tables.map((t) => t.mode) } });
+      say(`✅ 已发布 ${r.game.slug}（${r.game.id}）`);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      await api.publishUpdate(id, { status: 'failed', error: msg });
+      say(`✗ ${msg}`);
+    } finally { running = null; }
+  }
+  const reject = (id: string) => api.publishUpdate(id, { status: 'rejected' });
+  const request = () => api.publishRequest(null, note || null).then(() => { note = ''; });
+</script>
+
+<div class="grid">
+  <div class="card">
+    <h2>身份</h2>
+    {#if me}
+      <p>{me.user.isAnonymous ? '匿名用户' : me.user.id} <span class="mono hint">{me.user.id.slice(0, 8)}…</span> · 余额 {me.wallet.balanceCents}</p>
+      <p class="hint">发布出来的游戏归这个身份。cookie 不分端口——它和 apps/web 在 localhost 上共享。</p>
+    {:else}
+      <p class="hint">{meErr ?? '未登录'}</p>
+      <button class="sec" onclick={anon}>创建匿名会话</button>
+    {/if}
+  </div>
+
+  <div class="card">
+    <h2>本地体检</h2>
+    {#if localIssues.length}{#each localIssues as i (i)}<p class="bad">✗ {i}</p>{/each}{:else}<p class="ok">✓ {info.artifacts.length} 张表就绪，最低实算 RTP {lowest !== null ? pct(lowest) : '-'}</p>{/if}
+    <div class="row"><input placeholder="说明（可空）" bind:value={note} style="flex:1" /><button class="pri" onclick={request} disabled={!!localIssues.length}>发起发布请求</button></div>
+  </div>
+
+  <div class="card">
+    <h2>发布请求</h2>
+    {#if !reqs.length}<p class="hint">没有待处理的请求。AI 用 publish 工具发起的请求会出现在这里。</p>{/if}
+    {#each reqs as r (r.id)}
+      <div class="req" class:active={r.status === 'awaiting-approval'}>
+        <div class="row">
+          <b class="mono">{r.id}</b><span class="hint">来自 {r.from} · {new Date(r.createdAt).toLocaleTimeString()}</span>
+          <span class:ok={r.status === 'published'} class:bad={r.status === 'failed' || r.status === 'rejected'} class:warn={r.status === 'awaiting-approval'}>{r.status}</span>
+          <span style="flex:1"></span>
+          {#if r.status === 'awaiting-approval'}
+            <button class="pri" onclick={() => approve(r.id)} disabled={!!running || !me || !!localIssues.length} title="不可逆：已生效的 mode 不能再换表">确认发布{r.modes ? `（${r.modes.join('、')}）` : '（全部）'}</button>
+            <button class="sec" onclick={() => reject(r.id)}>拒绝</button>
+          {/if}
+        </div>
+        {#if r.note}<p class="hint">{r.note}</p>{/if}
+        {#if r.error}<p class="bad">{r.error}</p>{/if}
+        {#if running === r.id && log.length}<pre>{log.join('\n')}</pre>{:else if r.progress.length}<pre>{r.progress.join('\n')}</pre>{/if}
+      </div>
+    {/each}
+  </div>
+</div>
+
+<style>
+  .grid{display:grid;gap:14px;max-width:900px} .row{display:flex;gap:10px;align-items:center;flex-wrap:wrap}
+  .req{border:1px solid var(--line);border-radius:10px;padding:10px;display:flex;flex-direction:column;gap:6px}
+  .req.active{border-color:var(--accent-ink)}
+</style>

package/studio/app/panels/TablePanel.svelte

@@ -0,0 +1,64 @@
+<script lang="ts">
+  import { api, type Info } from '../lib/api.ts';
+  import { bus } from '../lib/bus.svelte.ts';
+  import type { Artifact } from '../../src/build.ts';
+
+  let { info }: { info: Info } = $props();
+  const spec = $derived(info.snapshot.spec);
+  // 只取初始值是刻意的：之后由总线的 build 事件刷新 arts，sims 是作者的选择
+  // svelte-ignore state_referenced_locally
+  let arts = $state<Artifact[]>(info.artifacts);
+  // svelte-ignore state_referenced_locally
+  let sims = $state(info.snapshot.spec.sims);
+  let log = $state<string[]>([]);
+  let busy = $state(false);
+  let err = $state<string | null>(null);
+
+  $effect(() => { void bus.buildVersion; void api.artifacts().then((a) => { arts = a; }); });
+
+  const pct = (ppm: number) => `${(ppm / 1e4).toFixed(4)}%`;
+  const x = (c: number) => `${(c / 100).toFixed(2)}x`;
+  const built = (m: string) => arts.find((a) => a.mode === m);
+
+  async function build(modes: string[] | null) {
+    busy = true; err = null; log = [];
+    try {
+      const job = await api.build({ modes, sims });
+      const done = await api.waitJob(job.id, (m) => { log = [...log, m]; });
+      if (done.status !== 'done') err = done.error ?? '建表失败';
+    } catch (e) { err = e instanceof Error ? e.message : String(e); }
+    finally { busy = false; }
+  }
+</script>
+
+<div class="card">
+  <h2>建表 <span class="hint">当前指纹 <span class="mono">{info.fingerprint}</span></span></h2>
+  <p class="hint">采样 → 求解 → 量化 → 编码 → 本地终验 → 落盘 .studio/build/&lt;指纹&gt;/。产物同时供表模型预览和发布，是同一份文件。改了 rules/ 指纹就变，这里的表全部作废。</p>
+  <div class="row">
+    <label>每张表采样 <input type="number" bind:value={sims} step="1000" min="1000" style="width:7em" /> 局</label>
+    <button class="pri" onclick={() => build(null)} disabled={busy}>{busy ? '建表中…' : `建全部 ${spec.modes.length} 张`}</button>
+  </div>
+  {#if err}<p class="bad">{err}</p>{/if}
+  {#if log.length}<pre>{log.join('\n')}</pre>{/if}
+  <table>
+    <thead><tr><th>mode</th><th>目标 RTP</th><th>状态</th><th>实算 RTP</th><th>行数</th><th>最大赔付</th><th>命中率</th><th>sha256</th><th></th></tr></thead>
+    <tbody>
+      {#each spec.modes as m (m.name)}
+        {@const a = built(m.name)}
+        <tr>
+          <td class="mono">{m.name}</td>
+          <td class="num">{pct(Math.round(spec.rtp * 1e6))}</td>
+          <td>{#if a}<span class="ok">已建</span>{#if a.stats.thin.length}<span class="warn" title={a.stats.thin.map((t) => `${x(t.payoutCenti)}×${t.samples}局`).join('、')}> ⚠{a.stats.thin.length}</span>{/if}{:else}<span class="hint">未建</span>{/if}</td>
+          <td class="num">{a ? pct(a.computedRtpPpm) : ''}</td>
+          <td class="num">{a ? a.rowCount.toLocaleString() : ''}</td>
+          <td class="num">{a ? x(a.maxPayoutCenti) : ''}</td>
+          <td class="num">{a ? pct(a.hitRatePpm) : ''}</td>
+          <td class="mono hint">{a ? a.contentHash.slice(0, 12) + '…' : ''}</td>
+          <td><button class="sec" onclick={() => build([m.name])} disabled={busy}>{a ? '重建' : '建'}</button></td>
+        </tr>
+      {/each}
+    </tbody>
+  </table>
+</div>
+
+<style>.row{display:flex;gap:10px;align-items:center;flex-wrap:wrap} label{display:flex;gap:6px;align-items:center;font-size:13px}</style>

package/studio/app/panels/TuningPanel.svelte

@@ -0,0 +1,140 @@
+<script lang="ts">
+  /* 调参：拖滑杆 → 每帧在浏览器里 solve（3~4ms）→ 实算与目标并排。
+     采样在 node 侧算一次缓存，这里只拿 groups 摘要。满意了就带着 segments 去建表。 */
+  import { api, type Info } from '../lib/api.ts';
+  import type { GroupsSummary } from '../../src/build.ts';
+  import { defaultSegments, rtpRangePpm, runSolve, type SegmentTarget, type SolveReport } from '../../src/solver.ts';
+
+  let { info }: { info: Info } = $props();
+  const spec = $derived(info.snapshot.spec);
+
+  // 只取初始值是刻意的：mode / sims 是作者在这个面板里的选择，不该跟着 info 刷新被重置
+  // svelte-ignore state_referenced_locally
+  let mode = $state(info.snapshot.spec.modes[0]?.name ?? 'base');
+  // svelte-ignore state_referenced_locally
+  let sims = $state(Math.min(info.snapshot.spec.sims, 50_000));
+  let g = $state<GroupsSummary | null>(null);
+  let loading = $state<string | null>(null);
+  let err = $state<string | null>(null);
+
+  let rtpPpm = $state(970_000);
+  let segs = $state<SegmentTarget[]>([]);
+  let report = $state<SolveReport | null>(null);
+  let building = $state(false);
+
+  const range = $derived(g ? rtpRangePpm(g.groups, g.betCostCenti) : [800_000, 990_000] as [number, number]);
+  const pct = (ppm: number) => `${(ppm / 1e4).toFixed(2)}%`;
+  const x = (c: number) => `${(c / 100).toFixed(2)}x`;
+
+  async function load() {
+    err = null; loading = '采样中（首次会慢，之后命中缓存）…';
+    try {
+      g = await api.groups(mode, sims);
+      rtpPpm = g.declaredRtpPpm;
+      segs = defaultSegments(g.groups);
+      solve();
+    } catch (e) { err = e instanceof Error ? e.message : String(e); }
+    finally { loading = null; }
+  }
+
+  let raf = 0;
+  function solve() {
+    if (!g) return;
+    cancelAnimationFrame(raf);
+    raf = requestAnimationFrame(() => { report = runSolve(g!.groups, { totalRtpPpm: rtpPpm, segments: segs }, g!.betCostCenti, g!.sims); });
+  }
+  $effect(() => { void rtpPpm; void JSON.stringify(segs); solve(); });
+
+  async function buildWithThese() {
+    if (!report?.ok) return;
+    building = true; err = null;
+    try {
+      const job = await api.build({ modes: [mode], sims, rtpPpm, segments: report.segments });
+      const done = await api.waitJob(job.id);
+      if (done.status !== 'done') err = done.error ?? '建表失败';
+    } catch (e) { err = e instanceof Error ? e.message : String(e); }
+    finally { building = false; }
+  }
+
+  const seg = (i: number, patch: Partial<SegmentTarget>) => { segs = segs.map((s, k) => (k === i ? { ...s, ...patch } : s)); };
+  const achieved = (name: string) => report?.achieved?.segments.find((s) => s.name === name);
+</script>
+
+<div class="grid">
+  <div class="card">
+    <h2>采样</h2>
+    <div class="row">
+      <label>mode <select bind:value={mode}>{#each spec.modes as m (m.name)}<option value={m.name}>{m.name}</option>{/each}</select></label>
+      <label>局数 <input type="number" bind:value={sims} min="1000" step="1000" style="width:7em" /></label>
+      <button class="pri" onclick={load} disabled={!!loading}>{loading ? '…' : g ? '重新采样' : '采样'}</button>
+    </div>
+    {#if loading}<p class="hint">{loading}</p>{/if}
+    {#if err}<p class="bad">{err}</p>{/if}
+    {#if g}
+      <p class="hint">{g.distinctPayouts} 种赔付 · 自然 RTP {pct(g.naturalRtpPpm)} · 命中 {pct(g.hitRatePpm)} · 最大 {x(g.maxPayoutCenti)} · 可达 RTP [{pct(range[0])}, {pct(range[1])}]</p>
+      <div class="bars">
+        {#each g.groups as gr (gr.payout)}
+          {@const w = report?.weights ? report.weights[g.groups.indexOf(gr)]! : gr.prior / g.sims}
+          <div class="bar" title="{x(gr.payout)}：自然 {(gr.prior / g.sims * 100).toFixed(3)}% → 求解 {(w * 100).toFixed(3)}%">
+            <i style="height:{Math.max(2, Math.sqrt(w) * 100)}%"></i><span>{x(gr.payout)}</span>
+          </div>
+        {/each}
+      </div>
+    {/if}
+  </div>
+
+  {#if g}
+  <div class="card">
+    <h2>目标</h2>
+    <label class="slider">总 RTP <b class="mono">{pct(rtpPpm)}</b>
+      <input type="range" min={range[0]} max={range[1]} step="100" bind:value={rtpPpm} />
+    </label>
+    <table>
+      <thead><tr><th>段</th><th>赔付区间</th><th>每 N 局中</th><th>RTP 份额</th><th>均值/中位</th><th>实算</th></tr></thead>
+      <tbody>
+        {#each segs as s, i (s.name)}
+          {@const a = achieved(s.name)}
+          <tr>
+            <td><input value={s.name} onchange={(e) => seg(i, { name: e.currentTarget.value })} style="width:5em" /></td>
+            <td class="num"><input type="number" value={s.payoutRange[0]} onchange={(e) => seg(i, { payoutRange: [+e.currentTarget.value, s.payoutRange[1]] })} style="width:5em" />–<input type="number" value={s.payoutRange[1]} onchange={(e) => seg(i, { payoutRange: [s.payoutRange[0], +e.currentTarget.value] })} style="width:5em" /></td>
+            <td><input type="number" step="0.1" value={s.oneIn ?? ''} placeholder="自由" onchange={(e) => seg(i, { oneIn: e.currentTarget.value ? +e.currentTarget.value : undefined })} style="width:5em" /></td>
+            <td><input type="number" step="1000" value={s.rtpPpm ?? ''} placeholder="自由" onchange={(e) => seg(i, { rtpPpm: e.currentTarget.value ? +e.currentTarget.value : undefined })} style="width:6em" /></td>
+            <td><input value={s.meanToMedian ? s.meanToMedian.join('-') : ''} placeholder="如 2-4" onchange={(e) => { const m = /^([\d.]+)\s*-\s*([\d.]+)$/.exec(e.currentTarget.value); seg(i, { meanToMedian: m ? [+m[1]!, +m[2]!] : undefined }); }} style="width:5em" /></td>
+            <td class="num hint">{#if a}每 {a.hitRate.toFixed(1)} 局 · {pct(Math.round(a.rtp * 1e6))} · {a.meanToMedian.toFixed(2)}{/if}</td>
+          </tr>
+        {/each}
+      </tbody>
+    </table>
+    <div class="row">
+      <button class="sec" onclick={() => segs = [...segs, { name: `段${segs.length + 1}`, payoutRange: [0, g!.maxPayoutCenti] }]}>加一段</button>
+      <button class="sec" onclick={() => segs = segs.slice(0, -1)} disabled={segs.length <= 1}>删末段</button>
+      <span style="flex:1"></span>
+      <button class="pri" onclick={buildWithThese} disabled={!report?.converged || building}>{building ? '建表中…' : '用这组参数建表'}</button>
+    </div>
+  </div>
+
+  <div class="card">
+    <h2>求解 {#if report}<span class:ok={report.converged} class:warn={report.ok && !report.converged} class:bad={!report.ok}>{report.failure ? '失败' : report.converged ? '收敛' : '未收敛'}</span>{/if}</h2>
+    {#if report?.failure}
+      <p class="bad">{report.failure.detail}</p>
+    {:else if report}
+      <p class="hint mono">残差 {report.residual.toExponential(2)} · {report.iterations} 次迭代 · {report.millis.toFixed(1)} ms · 实算 RTP {pct(Math.round((report.achieved?.rtp ?? 0) * 1e6))}</p>
+      {#if report.hardest}<p class="hint">最吃力的约束：<b>{report.hardest.label}</b>（θ={report.hardest.theta.toFixed(3)}）</p>{/if}
+      {#if report.dropped.length}<p class="warn">被判冗余丢弃：{report.dropped.join('、')}——这些目标没生效</p>{/if}
+      {#if report.thin.length}<p class="warn">{report.thin.length} 个档位样本不足（&lt;30 局）：{report.thin.slice(0, 6).map((t) => `${x(t.payoutCenti)}×${t.samples}`).join('、')}。它们的权重是从个位数样本外推的</p>{/if}
+      {#if report.distorted.length}<p class="warn">{report.distorted.length} 个档位被大幅改权：{report.distorted.slice(0, 6).map((t) => `${x(t.payoutCenti)} ×${t.distortion.toFixed(1)}`).join('、')}</p>{/if}
+    {/if}
+  </div>
+  {/if}
+</div>
+
+<style>
+  .grid{display:grid;grid-template-columns:1fr;gap:14px;max-width:1100px}
+  .row{display:flex;gap:10px;align-items:center;flex-wrap:wrap}
+  label{display:flex;gap:6px;align-items:center;font-size:13px}
+  .slider{display:grid;grid-template-columns:auto 1fr;gap:8px 12px;align-items:center} .slider input{grid-column:1/-1}
+  .bars{display:flex;gap:3px;align-items:flex-end;height:110px;padding-top:6px;overflow-x:auto}
+  .bar{flex:1;min-width:26px;display:flex;flex-direction:column;align-items:center;justify-content:flex-end;height:100%;font-size:9px;color:var(--dim)}
+  .bar i{display:block;width:100%;background:var(--accent-ink);border-radius:3px 3px 0 0;opacity:.85}
+  .bar span{margin-top:2px;white-space:nowrap}
+</style>

package/studio/app/virtual.d.ts

@@ -0,0 +1,6 @@
+/* `virtual:studio/game` 由 src/studio-plugin.ts 在 vite 里解析到游戏入口 */
+declare module 'virtual:studio/game' {
+  import type { GameModule } from 'gamekit777/sdk';
+  const game: GameModule<object, unknown>;
+  export default game;
+}