@khorsheed/dsh-game 0.1.0 → 0.1.1

package/lib/types/client/ProjectSwitcher.js

@@ -7,7 +7,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * element kinds and style), so it writes an opener into the composer.
  */
 import { useEffect, useState } from 'react';
-import { artStyleLabel } from "../project.js";
+import { artStyleLabel, artStyleName } from "../project.js";
 import { failureOf } from "./contract.js";
 import css from './GameTab.module.css';
 /** "3 分钟前" style relative time. */
@@ -70,6 +70,6 @@ export function ProjectSwitcher({ t, api, sessionId, currentId, rev, onChoose, o
                 }
                 return _jsxs("div", { className: css.projectCardWrap, children: [_jsxs("button", { type: "button", className: css.projectCard, "aria-current": current ? 'true' : undefined, title: card.root, onClick: () => { onChoose(card.id); }, children: [_jsxs("span", { className: css.projectThumb, children: [card.thumb !== undefined
                                             ? _jsx("img", { src: `data:image/webp;base64,${card.thumb}`, alt: "" })
-                                            : _jsx("span", { className: css.projectInitial, children: card.title.slice(0, 1) }), current && _jsx("span", { className: css.projectHere, children: t('switcher.here') })] }), _jsxs("span", { className: css.projectBody, children: [_jsx("strong", { className: css.projectTitle, children: card.title }), _jsxs("span", { className: css.projectChips, children: [_jsx("span", { className: css.headChip, "data-tone": card.version === null ? 'muted' : 'ok', children: card.version === null ? t('switcher.noVersion') : `v${card.version}` }), card.artStyle !== '' && _jsx("span", { className: css.headChip, children: artStyleLabel(card.artStyle) }), _jsx("span", { className: css.headChip, children: t('switcher.elements', { count: card.elements }) })] }), card.pitch !== '' && _jsx("span", { className: css.projectPitch, children: card.pitch }), _jsxs("span", { className: css.metaLine, children: [ago(t, card.updatedAt), " \u00B7 ", folderOf(card.root)] })] })] }), _jsx("button", { type: "button", className: css.projectDelete, "aria-label": t('switcher.delete', { title: card.title }), title: t('switcher.delete', { title: card.title }), onClick: () => { setConfirming({ id: card.id }); }, children: "\u00D7" })] }, card.id);
+                                            : _jsx("span", { className: css.projectInitial, children: card.title.slice(0, 1) }), current && _jsx("span", { className: css.projectHere, children: t('switcher.here') })] }), _jsxs("span", { className: css.projectBody, children: [_jsx("strong", { className: css.projectTitle, children: card.title }), _jsxs("span", { className: css.projectChips, children: [_jsx("span", { className: css.headChip, "data-tone": card.version === null ? 'muted' : 'ok', children: card.version === null ? t('switcher.noVersion') : `v${card.version}` }), card.artStyle !== '' && _jsx("span", { className: css.headChip, title: artStyleLabel(card.artStyle), children: artStyleName(card.artStyle) }), _jsx("span", { className: css.headChip, children: t('switcher.elements', { count: card.elements }) })] }), card.pitch !== '' && _jsx("span", { className: css.projectPitch, children: card.pitch }), _jsxs("span", { className: css.metaLine, children: [ago(t, card.updatedAt), " \u00B7 ", folderOf(card.root)] })] })] }), _jsx("button", { type: "button", className: css.projectDelete, "aria-label": t('switcher.delete', { title: card.title }), title: t('switcher.delete', { title: card.title }), onClick: () => { setConfirming({ id: card.id }); }, children: "\u00D7" })] }, card.id);
             })] });
 }

package/lib/types/client/contract.d.ts

@@ -5,7 +5,8 @@
 import type { SessionId } from '@deepseek-ai/dsh-api-remotes/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
-import type { BundleFile, CommitResult, DeleteProjectResult, WorkingChanges, GameResult, PlayBundle, ProjectCard, SessionGameState, TurnReport, VersionDiff } from '../types.ts';
+import type { Reveal } from './reveal.ts';
+import type { BundleFile, LiveVersion, CommitResult, DeleteProjectResult, WorkingChanges, GameResult, PlayBundle, ProjectCard, SessionGameState, TurnReport, VersionDiff } from '../types.ts';
 type R<T> = Promise<RemoteResult<T>>;
 type Ok<T extends object = object> = GameResult<{
     readonly ok: true;
@@ -13,6 +14,7 @@ type Ok<T extends object = object> = GameResult<{
 /** Every call the panel makes, already bound to the Remote. */
 export interface GameApi {
     state: (sid: SessionId) => R<SessionGameState>;
+    liveVersion: (sid: SessionId) => R<LiveVersion | null>;
     projectCards: () => R<ProjectCard[]>;
     turnReport: (sid: SessionId, turn: number) => R<TurnReport | null>;
     bind: (sid: SessionId, projectId: string | null) => R<Ok>;
@@ -97,6 +99,8 @@ export interface GameTabInjected {
     subscribeSessionEvents: (listener: (sessionId: string) => void) => () => void;
     /** Tell every game surface of this page that a session's state moved. */
     touch: (sessionId: SessionId) => void;
+    /** Carries out the agent's 「请用户看这里」 (page-wide). */
+    reveal: Reveal;
 }
 /** Full props of the game tab body. */
 export type GameTabProps = PropsRuntime<'sidebar.right.pane.tab'> & InjectFace<GameTabInjected> & PropsLocale<'game'>;
@@ -115,6 +119,8 @@ export interface ViewProps {
     readonly refresh: () => void;
     /** Show a short confirmation line at the panel's foot. */
     readonly toast: (text: string) => void;
+    /** Carries out the agent's 「请用户看这里」 (page-wide). */
+    readonly reveal: Reveal;
 }
 /** A Remote call's game-level failure code, or undefined on success. */
 export declare function failureOf(result: RemoteResult<{

package/lib/types/client/index.js

@@ -1,6 +1,7 @@
 import gameRemote from '@khorsheed/dsh-game/remote';
 import { GAME_CHAT_KIND, GameChatRow, gameMessageDefinition } from "./chat-node.js";
 import { gameTurnDefinition, GameTurnCard } from "./TurnCard.js";
+import { Reveal } from "./reveal.js";
 import { encodeGameRef, GAME_REF_SOURCE, gameRefCodec } from "./refs.js";
 import { GAME_KIND, GAME_TAB_ID, gameDefinition } from "./definition.js";
 import { GameTab } from "./GameTab.js";
@@ -49,6 +50,7 @@ export async function apply(ctx) {
     }, 'game: tab type visibility');
     const api = {
         state: sid => remote.state(sid),
+        liveVersion: sid => remote.liveVersion(sid),
         projectCards: () => remote.projectCards(),
         turnReport: (sid, turn) => remote.turnReport(sid, { turn }),
         bind: (sid, projectId) => remote.bind(sid, { projectId }),
@@ -118,6 +120,7 @@ export async function apply(ctx) {
     };
     const navListeners = new Set();
     let parkedNav = null;
+    const reveal = new Reveal(target => { face.openAt(target); });
     const face = {
         openAt: (target) => {
             parkedNav = target;
@@ -183,7 +186,38 @@ export async function apply(ctx) {
             return () => { listeners.delete(listener); };
         },
         touch: sessionId => { emit(sessionId); },
+        reveal,
     };
+    // The page follows the agent: game_publish leaves a 「请用户看这里」 request the host cannot push,
+    // so the page polls the on-screen session's bound project while visible (session events nudge
+    // it early). The same read notices a binding made with no event (a room member's game_open) and
+    // refreshes the tab — refresh only; where to go is the agent's to say.
+    const lastBound = new Map();
+    let lastLook = 0;
+    const look = () => {
+        const now = Date.now();
+        if (now - lastLook < 3000)
+            return;
+        lastLook = now;
+        const sid = mainSessionId(ctx.sessions.list.getSnapshot());
+        if (sid === undefined)
+            return;
+        void api.liveVersion(sid).then(r => {
+            if (!r.ok)
+                return;
+            const bound = r.value?.projectId ?? null;
+            const before = lastBound.get(sid);
+            lastBound.set(sid, bound);
+            if (before !== undefined && before !== bound)
+                emit(sid);
+            if (r.value?.show !== undefined)
+                reveal.request(r.value.projectId, r.value.show);
+        }).catch(() => { });
+    };
+    listeners.add(() => { look(); });
+    const pollTimer = setInterval(() => { if (document.visibilityState === 'visible')
+        look(); }, 6000);
+    disposers.push(async () => { clearInterval(pollTimer); });
     ctx.effect(() => ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register({
         name: 'sidebar.right.pane.tab',
         key: GAME_TAB_ID,

package/lib/types/client/locales.d.ts

@@ -128,6 +128,7 @@ export declare const zh: {
     'fields.note': string;
     'design.onePager': string;
     'design.style': string;
+    'design.styleFull': string;
     'design.noPitch': string;
     'design.pillars': string;
     'design.noPillars': string;
@@ -360,6 +361,8 @@ export declare const zh: {
     'gltf.boneSearch': string;
     'gltf.rotate': string;
     'gltf.moreBones': string;
+    'nav.go': string;
+    'nav.dismiss': string;
 };
 /** English dictionary. */
 export declare const en: Record<keyof typeof zh, string>;

package/lib/types/client/locales.js

@@ -128,6 +128,7 @@ export const zh = {
     'fields.note': '改完离开输入框即保存；提交成新版本后进游戏。',
     'design.onePager': '一页纸',
     'design.style': '风格 · {style}',
+    'design.styleFull': '画风：{style}',
     'design.noPitch': '还没有一句话玩法。',
     'design.pillars': '设计支柱',
     'design.noPillars': '还没定支柱：和 agent 聊出 2–3 条「这个游戏一定要做到的体验」。',
@@ -360,6 +361,8 @@ export const zh = {
     'gltf.boneSearch': '找骨头…',
     'gltf.rotate': '旋转',
     'gltf.moreBones': '另有 {count} 根，搜索名字找',
+    'nav.go': '去看看',
+    'nav.dismiss': '不用了',
 };
 /** English dictionary. */
 export const en = {
@@ -490,6 +493,7 @@ export const en = {
     'fields.note': 'Saved when you leave the box; reaches the game once you commit it as a new version.',
     'design.onePager': 'One-pager',
     'design.style': 'Style · {style}',
+    'design.styleFull': 'Look: {style}',
     'design.noPitch': 'No pitch yet.',
     'design.pillars': 'Design pillars',
     'design.noPillars': 'No pillars yet: find 2–3 experiences this game must deliver with the agent.',
@@ -722,6 +726,8 @@ export const en = {
     'gltf.boneSearch': 'Find a bone…',
     'gltf.rotate': 'Rotation',
     'gltf.moreBones': '{count} more; search by name',
+    'nav.go': 'Show me',
+    'nav.dismiss': 'Not now',
 };
 /** The dictionary namespace this view binds. */
 export const NS = 'game';

package/lib/types/client/preview-entry.d.ts

@@ -18,7 +18,7 @@ export declare const PREVIEW_ID = "__preview";
 export declare const PREVIEW_YAW = 35;
 export declare const PREVIEW_PITCH = 18;
 /** The preview entry module (it runs in the frame). */
-export declare const PREVIEW_MAIN = "\nconst { createWorld, build, THREE } = await import('dsh3d')\ntry { await import('../src/looks.js') } catch (e) {}\nconst mode = (await (await fetch('_preview/mode.json')).json()).mode\nconst world = createWorld({ canvas: document.querySelector('canvas') })\nconst cam = new THREE.PerspectiveCamera(32, 1, 0.05, 500)\nworld.setCamera(cam)\nconst deg = Math.PI / 180\nlet model = null, yaw = 35, pitch = 18, radius = 4, focusY = 0.5, drag = null, spinning = mode === 'spin', viewKey = null\nconst lookNow = () => window.dshElements['__preview'].look\n/** The look's own preview angle, taken again only when it changes (an edit must not reset a dragged view). */\nfunction viewFrom(look) {\n  const p = (look && look.preview) || {}, key = JSON.stringify(p)\n  if (key === viewKey) return\n  viewKey = key\n  yaw = Number.isFinite(p.yaw) ? p.yaw : 35\n  pitch = Number.isFinite(p.pitch) ? p.pitch : 18\n}\nfunction aim() {\n  pitch = Math.max(-10, Math.min(80, pitch))\n  const p = pitch * deg, y = yaw * deg\n  cam.position.set(Math.cos(p) * Math.cos(y) * radius, focusY + Math.sin(p) * radius, Math.cos(p) * Math.sin(y) * radius)\n  cam.lookAt(0, focusY, 0)\n}\n/** Stand the model on the origin and back the camera off far enough to frame it. */\nfunction place() {\n  model.position.set(0, 0, 0)\n  model.updateMatrixWorld(true)\n  const box = new THREE.Box3().setFromObject(model)\n  if (box.isEmpty()) return\n  const center = box.getCenter(new THREE.Vector3()), size = box.getSize(new THREE.Vector3())\n  model.position.set(-center.x, -box.min.y, -center.z)\n  focusY = size.y / 2\n  const r = Math.max(0.3, box.getBoundingSphere(new THREE.Sphere()).radius)\n  radius = r / Math.sin(cam.fov * deg / 2) * 1.08\n  aim()\n}\nasync function fit() {\n  if (model) world.remove(model)\n  const look = lookNow()\n  viewFrom(look)\n  // From the look object, not the id: the world's own rebuild-by-element must not touch the preview.\n  model = build(look)\n  world.add(model, { id: '__preview' })\n  place()\n  // A glTF look fills in later: measure again once it has, then say what it can be tuned by.\n  if (model.userData.loaded) { await model.userData.loaded; place() }\n  parent.postMessage({ gamedev: 'preview-clips', names: model.userData.animations ?? [], parts: model.userData.parts?.() ?? null }, '*')\n}\n/** What a rebuild depends on; anything else (tint, bones, morphs, angle, clip) is retuned in place. */\nconst rebuildKey = look => JSON.stringify(look && look.kind === 'gltf' ? [look.src, look.material, look.outline, look.scale] : look)\nlet builtKey = null\nfunction edited() {\n  const look = lookNow(), key = rebuildKey(look)\n  if (model && key === builtKey && model.userData.retune) { model.userData.retune(look); viewFrom(look); return }\n  builtKey = key\n  fit()\n}\naddEventListener('message', e => {\n  const d = e.data\n  if (!d || !model) return\n  if (d.gamedev === 'preview-play') model.userData.play?.(d.name)\n  if (d.gamedev === 'preview-view') { yaw = d.yaw; if (Number.isFinite(d.pitch)) pitch = d.pitch; spinning = false; aim(); world.render() }\n})\nbuiltKey = rebuildKey(lookNow())\nawait fit()\naddEventListener('dshelements', () => { setTimeout(edited) })\nconst canvas = world.canvas\ncanvas.addEventListener('pointerdown', e => { drag = { x: e.clientX, y: e.clientY }; spinning = false; canvas.setPointerCapture(e.pointerId) })\ncanvas.addEventListener('pointermove', e => {\n  if (drag === null) return\n  yaw -= (e.clientX - drag.x) * 0.5\n  pitch += (e.clientY - drag.y) * 0.35\n  drag = { x: e.clientX, y: e.clientY }\n})\ncanvas.addEventListener('pointerup', () => { drag = null })\nworld.onUpdate(dt => { if (spinning && drag === null) yaw += dt * 18; aim() })\n// The checks (and specs) can drive this page like a game.\nwindow.dshGame = { ready: true, step: dt => world.step(dt), input() {}, state: () => ({ yaw, pitch, radius, focusY, perspective: world.camera === cam, spinning }) }\nif (mode === 'still') {\n  world.step(0.4)\n  parent.postMessage({ gamedev: 'preview', png: canvas.toDataURL('image/png') }, '*')\n} else world.start()\n";
+export declare const PREVIEW_MAIN = "\nconst { createWorld, build, THREE } = await import('dsh3d')\ntry { await import('../src/looks.js') } catch (e) {}\nconst mode = (await (await fetch('_preview/mode.json')).json()).mode\nconst world = createWorld({ canvas: document.querySelector('canvas') })\nconst cam = new THREE.PerspectiveCamera(32, 1, 0.05, 500)\nworld.setCamera(cam)\nconst deg = Math.PI / 180\nlet model = null, yaw = 35, pitch = 18, radius = 4, focusY = 0.5, drag = null, spinning = mode === 'spin', viewKey = null\nconst lookNow = () => window.dshElements['__preview'].look\n/** The look's own preview angle, taken again only when it changes (an edit must not reset a dragged view). */\nfunction viewFrom(look) {\n  const p = (look && look.preview) || {}, key = JSON.stringify(p)\n  if (key === viewKey) return\n  viewKey = key\n  yaw = Number.isFinite(p.yaw) ? p.yaw : 35\n  pitch = Number.isFinite(p.pitch) ? p.pitch : 18\n}\nfunction aim() {\n  pitch = Math.max(-10, Math.min(80, pitch))\n  const p = pitch * deg, y = yaw * deg\n  cam.position.set(Math.cos(p) * Math.cos(y) * radius, focusY + Math.sin(p) * radius, Math.cos(p) * Math.sin(y) * radius)\n  cam.lookAt(0, focusY, 0)\n}\n/** Stand the model on the origin and back the camera off far enough to frame it. */\nfunction place() {\n  model.position.set(0, 0, 0)\n  model.updateMatrixWorld(true)\n  const box = new THREE.Box3().setFromObject(model)\n  if (box.isEmpty()) return\n  const center = box.getCenter(new THREE.Vector3()), size = box.getSize(new THREE.Vector3())\n  model.position.set(-center.x, -box.min.y, -center.z)\n  focusY = size.y / 2\n  const r = Math.max(0.3, box.getBoundingSphere(new THREE.Sphere()).radius)\n  radius = r / Math.sin(cam.fov * deg / 2) * 1.08\n  aim()\n}\nasync function fit() {\n  if (model) world.remove(model)\n  const look = lookNow()\n  viewFrom(look)\n  // From the look object, not the id: the world's own rebuild-by-element must not touch the preview.\n  model = build(look)\n  world.add(model, { id: '__preview' })\n  place()\n  // A glTF look fills in later: measure again once it has, then say what it can be tuned by.\n  if (model.userData.loaded) { await model.userData.loaded; place() }\n  parent.postMessage({ gamedev: 'preview-clips', names: model.userData.animations ?? [], parts: model.userData.parts?.() ?? null }, '*')\n}\n/** What a rebuild depends on; anything else (tint, bones, morphs, angle, clip) is retuned in place. */\nconst rebuildKey = look => JSON.stringify(look && look.kind === 'gltf' ? [look.src, look.material, look.outline, look.scale] : look)\nlet builtKey = null\nfunction edited() {\n  const look = lookNow(), key = rebuildKey(look)\n  if (model && key === builtKey && model.userData.retune) { model.userData.retune(look); viewFrom(look); return }\n  builtKey = key\n  fit()\n}\naddEventListener('message', e => {\n  const d = e.data\n  if (!d || !model) return\n  if (d.gamedev === 'preview-play') model.userData.play?.(d.name)\n  if (d.gamedev === 'preview-view') { yaw = d.yaw; if (Number.isFinite(d.pitch)) pitch = d.pitch; spinning = false; aim(); world.render() }\n})\nbuiltKey = rebuildKey(lookNow())\nawait fit()\naddEventListener('dshelements', () => { setTimeout(edited) })\nconst canvas = world.canvas\ncanvas.addEventListener('pointerdown', e => {\n  drag = { x: e.clientX, y: e.clientY }; spinning = false; canvas.setPointerCapture(e.pointerId)\n  parent.postMessage({ gamedev: 'preview-turned' }, '*')\n})\ncanvas.addEventListener('pointermove', e => {\n  if (drag === null) return\n  yaw -= (e.clientX - drag.x) * 0.5\n  pitch += (e.clientY - drag.y) * 0.35\n  drag = { x: e.clientX, y: e.clientY }\n})\ncanvas.addEventListener('pointerup', () => { drag = null })\nworld.onUpdate(dt => { if (spinning && drag === null) yaw += dt * 18; aim() })\n// The checks (and specs) can drive this page like a game.\nwindow.dshGame = { ready: true, step: dt => world.step(dt), input() {}, state: () => ({ yaw, pitch, radius, focusY, perspective: world.camera === cam, spinning }) }\nif (mode === 'still') {\n  world.step(0.4)\n  parent.postMessage({ gamedev: 'preview', png: canvas.toDataURL('image/png') }, '*')\n} else world.start()\n";
 /** The preview page: a full-size canvas and the entry above. */
 export declare const PREVIEW_HTML: string;
 //# sourceMappingURL=preview-entry.d.ts.map

package/lib/types/client/preview-entry.js

@@ -86,7 +86,10 @@ builtKey = rebuildKey(lookNow())
 await fit()
 addEventListener('dshelements', () => { setTimeout(edited) })
 const canvas = world.canvas
-canvas.addEventListener('pointerdown', e => { drag = { x: e.clientX, y: e.clientY }; spinning = false; canvas.setPointerCapture(e.pointerId) })
+canvas.addEventListener('pointerdown', e => {
+  drag = { x: e.clientX, y: e.clientY }; spinning = false; canvas.setPointerCapture(e.pointerId)
+  parent.postMessage({ gamedev: 'preview-turned' }, '*')
+})
 canvas.addEventListener('pointermove', e => {
   if (drag === null) return
   yaw -= (e.clientX - drag.x) * 0.5

package/lib/types/client/reveal.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The game tab follows the agent: `game_publish` says where the user should
+ * look (the play area, an element's page, the element grid…), the page picks
+ * the request up on its poll, and this controller carries it out — unless the
+ * user is busy in the panel (a game running, a touch in the last 20 s), in
+ * which case it waits as a notice. The page itself never decides where to go.
+ *
+ * Each request is carried out once; one found on a reload is history. Every
+ * decision leaves a `[game:reveal]` console line.
+ * @module @khorsheed/dsh-game/client
+ */
+import type { NavTarget } from './contract.ts';
+import type { ShowRequest } from '../types.ts';
+/** A request held back while the user was busy. */
+export interface RevealNotice {
+    readonly text: string;
+    readonly target: NavTarget;
+}
+/** The page-wide controller. */
+export declare class Reveal {
+    private readonly open;
+    private lastTouch;
+    private playing;
+    private mounted;
+    private noticeNow;
+    private readonly listeners;
+    /** The last request sequence carried out per project. */
+    private readonly done;
+    /** @param open - opens the game tab at a place (the plugin's openAt). */
+    constructor(open: (target: NavTarget) => void);
+    get notice(): RevealNotice | null;
+    dismiss(): void;
+    follow(): void;
+    /** The tab mounted; the result unmounts it. A mounted tab is navigated at any width. */
+    mount(): () => void;
+    touched(): void;
+    setPlaying(on: boolean): void;
+    subscribe(listener: () => void): () => void;
+    private changed;
+    /** The agent's request for a project, as the poll returned it. */
+    request(projectId: string, request: ShowRequest, now?: number): 'opened' | 'notice' | 'skipped' | null;
+}
+//# sourceMappingURL=reveal.d.ts.map

package/lib/types/client/reveal.js

@@ -0,0 +1,73 @@
+/** A touch this recent means the user is busy in the panel. */
+const BUSY_MS = 20_000;
+/** Below this window width a closed panel is not opened: it would cover the conversation. */
+const WIDE_PX = 820;
+/** A request older than this, seen first on this page, is history (a reload). */
+const FRESH_MS = 90_000;
+/** The page-wide controller. */
+export class Reveal {
+    open;
+    lastTouch = 0;
+    playing = false;
+    mounted = 0;
+    noticeNow = null;
+    listeners = new Set();
+    /** The last request sequence carried out per project. */
+    done = new Map();
+    /** @param open - opens the game tab at a place (the plugin's openAt). */
+    constructor(open) {
+        this.open = open;
+    }
+    get notice() { return this.noticeNow; }
+    dismiss() { this.noticeNow = null; this.changed(); }
+    follow() {
+        const n = this.noticeNow;
+        this.dismiss();
+        if (n !== null)
+            this.open(n.target);
+    }
+    /** The tab mounted; the result unmounts it. A mounted tab is navigated at any width. */
+    mount() {
+        this.mounted++;
+        return () => { this.mounted--; };
+    }
+    touched() { this.lastTouch = Date.now(); }
+    setPlaying(on) { this.playing = on; }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    changed() { for (const l of this.listeners)
+        l(); }
+    /** The agent's request for a project, as the poll returned it. */
+    request(projectId, request, now = Date.now()) {
+        const seen = this.done.get(projectId);
+        this.done.set(projectId, Math.max(request.seq, seen ?? 0));
+        if (seen !== undefined ? request.seq <= seen : now - Date.parse(request.at) > FRESH_MS)
+            return null;
+        const target = {
+            view: request.target.view,
+            ...(request.target.elementId === undefined ? {} : { elementId: request.target.elementId }),
+            ...(request.target.chapterId === undefined ? {} : { chapterId: request.target.chapterId }),
+        };
+        const busy = this.playing ? 'a game is running' : now - this.lastTouch < BUSY_MS ? 'the panel was just used' : null;
+        const narrow = this.mounted === 0 && (typeof window === 'undefined' || window.innerWidth < WIDE_PX);
+        const outcome = busy !== null ? 'notice' : narrow ? 'skipped' : 'opened';
+        try {
+            console.info(`[game:reveal] #${request.seq} ${request.note} → ${outcome}${busy === null ? '' : ` (${busy})`}${narrow && busy === null ? ' (closed panel, narrow window)' : ''}`, target);
+        }
+        catch {
+            // No console.
+        }
+        if (outcome === 'notice') {
+            this.noticeNow = { text: request.note, target };
+            this.changed();
+        }
+        if (outcome === 'opened') {
+            this.noticeNow = null;
+            this.open(target);
+            this.changed();
+        }
+        return outcome;
+    }
+}

package/lib/types/project.d.ts

@@ -29,6 +29,12 @@ export declare function listOf(value: readonly string[] | string | undefined): s
 export declare function resolveArtStyle(value: string | undefined, styles?: readonly ArtStyle[]): string | undefined;
 /** The style's human label (`custom:` keeps the user's own words). */
 export declare function artStyleLabel(id: string): string;
+/**
+ * A style's short name for tight places (tags, chips): a custom description's
+ * lead — up to its first dash, colon, comma or bracket — at most 10 characters.
+ * The full label stays for the model and for hover text.
+ */
+export declare function artStyleName(id: string): string;
 /** The kit a create request asks for: `3d` / `3d-three` → 3D, anything else 2D. */
 export declare function requestedKit(runtime: string | undefined): KitId;
 /** The example styles a kit offers. */

package/lib/types/project.js

@@ -40,6 +40,16 @@ export function artStyleLabel(id) {
         return id.slice('custom:'.length);
     return [...ART_STYLES, ...ART_STYLES_3D].find(style => style.id === id)?.label ?? id;
 }
+/**
+ * A style's short name for tight places (tags, chips): a custom description's
+ * lead — up to its first dash, colon, comma or bracket — at most 10 characters.
+ * The full label stays for the model and for hover text.
+ */
+export function artStyleName(id) {
+    const full = artStyleLabel(id).trim();
+    const lead = full.split(/——|—|--|[:：,，;；(（]/)[0]?.trim() || full;
+    return [...lead].length > 10 ? `${[...lead].slice(0, 10).join('')}…` : lead;
+}
 /** The kit a create request asks for: `3d` / `3d-three` → 3D, anything else 2D. */
 export function requestedKit(runtime) {
     return /^3d/i.test((runtime ?? '').trim()) ? '3d-three' : '2d-canvas';

package/lib/types/remote.d.ts

@@ -8,7 +8,7 @@
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import type { BundleFile, CommitResult, DeleteProjectResult, WorkingChanges, GameResult, PlayBundle, ProjectCard, SessionGameState, TurnReport, VersionDiff } from './types.ts';
+import type { BundleFile, LiveVersion, CommitResult, DeleteProjectResult, WorkingChanges, GameResult, PlayBundle, ProjectCard, SessionGameState, TurnReport, VersionDiff } from './types.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         /** The game panel's Remote face. */
@@ -29,6 +29,8 @@ export declare class GameRemoteService extends TypertRemoteService<GameRemoteCon
     private get store();
     /** The session's bound project (full view) and the project list. */
     state(sessionId: SessionId): Promise<SessionGameState>;
+    /** The bound project's newest version (cheap; the page polls it). */
+    liveVersion(sessionId: SessionId): Promise<LiveVersion | null>;
     /** What one of the session's turns changed (null when nothing, or not recorded). */
     turnReport(sessionId: SessionId, request: {
         turn: number;

package/lib/types/remote.js

@@ -39,6 +39,7 @@ let GameRemoteService = (() => {
     let _classSuper = TypertRemoteService;
     let _instanceExtraInitializers = [];
     let _state_decorators;
+    let _liveVersion_decorators;
     let _turnReport_decorators;
     let _projectCards_decorators;
     let _deleteProject_decorators;
@@ -68,6 +69,7 @@ let GameRemoteService = (() => {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
             _state_decorators = [Remote('state')];
+            _liveVersion_decorators = [Remote('liveVersion')];
             _turnReport_decorators = [Remote('turnReport')];
             _projectCards_decorators = [Remote('projectCards')];
             _deleteProject_decorators = [Remote('deleteProject')];
@@ -94,6 +96,7 @@ let GameRemoteService = (() => {
             _checkShot_decorators = [Remote('checkShot')];
             _versionBundle_decorators = [Remote('versionBundle')];
             __esDecorate(this, null, _state_decorators, { kind: "method", name: "state", static: false, private: false, access: { has: obj => "state" in obj, get: obj => obj.state }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _liveVersion_decorators, { kind: "method", name: "liveVersion", static: false, private: false, access: { has: obj => "liveVersion" in obj, get: obj => obj.liveVersion }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _turnReport_decorators, { kind: "method", name: "turnReport", static: false, private: false, access: { has: obj => "turnReport" in obj, get: obj => obj.turnReport }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _projectCards_decorators, { kind: "method", name: "projectCards", static: false, private: false, access: { has: obj => "projectCards" in obj, get: obj => obj.projectCards }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _deleteProject_decorators, { kind: "method", name: "deleteProject", static: false, private: false, access: { has: obj => "deleteProject" in obj, get: obj => obj.deleteProject }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -137,6 +140,10 @@ let GameRemoteService = (() => {
         state(sessionId) {
             return this.store.sessionState(sessionId);
         }
+        /** The bound project's newest version (cheap; the page polls it). */
+        liveVersion(sessionId) {
+            return this.store.liveVersion(sessionId);
+        }
         /** What one of the session's turns changed (null when nothing, or not recorded). */
         turnReport(sessionId, request) {
             return this.store.turnReport(sessionId, request.turn);

package/lib/types/skills.js

@@ -89,6 +89,7 @@ game_read 的总览会列出用户改过、你还没看过的东西（看过一
 - 不通过：工具返回问题清单，修好再调用；修好之前别请用户试玩。
 - 一个功能写完、能玩了就可以发，不必等到这一轮最后；文件还没写完时别调。
 - 纯设计问题（不需要玩）直接问，不用发版。
+- **发版会把用户的右栏带到结果那里**：默认去这一版改的那个元素（改了好几个就是元素列表，改了代码就是试玩）。想指定就给 game_publish 加 \`show\`（\`play\`、\`versions\`、\`elements\`、\`elements:元素id或名字\`、\`design:章节\`）和 \`note\`（一句看什么，如「看看太阳船的船壳」）。用户正在面板里操作或试玩时，右栏只提示，不硬跳。
 - 和 Claude Code 这类成员一起做时：成员手里没有发版工具。它说改完了，你马上 game_publish 再回复用户；给成员写交接说明时写「改完告诉我，我来发版」，别写「发版不归你管」。
 - 用户也能在右栏点「检查并发版」，那样出的版本标「用户发布」，是用户认可过的，别随手改回去。
 

package/lib/types/store.d.ts

@@ -3,7 +3,7 @@ import type { Session } from '@deepseek-ai/dsh-session';
 import { type BrowserChecker } from './checks.ts';
 import { type TrashMover } from './trash.ts';
 import { type CreateRequest } from './project.ts';
-import { type BundleFile, type CommitResult, type VersionSource, type WorkingChanges, type DeleteProjectResult, type CheckRecord, type GameResult, type PlayBundle, type ProjectCard, type ProjectRow, type ProjectView, type TurnReport, type SessionGameState, type VersionDiff, type VersionRecord } from './types.ts';
+import { type BundleFile, type CommitResult, type VersionSource, type WorkingChanges, type LiveVersion, type DeleteProjectResult, type CheckRecord, type GameResult, type PlayBundle, type ProjectCard, type ProjectRow, type ProjectView, type TurnReport, type SessionGameState, type VersionDiff, type VersionRecord } from './types.ts';
 /** Plugin config; every key optional. */
 export interface GameConfig {
     /** Registry root override (default `$DSH_HOME/state/game`). */
@@ -149,6 +149,27 @@ export declare class GameService {
     /** Elements the waiting candidate changed or added against the live version (null without both). */
     private candidateDiff;
     /** The tab's state for one session. */
+    /**
+     * The bound project's newest version (the waiting candidate, else the live
+     * one), read from two small files: the page polls it to announce a version
+     * the moment it lands, whoever's turn cut it. Version 0 means none yet.
+     */
+    liveVersion(sessionId: string): Promise<LiveVersion | null>;
+    /** The agent's latest 「请用户看这里」 per project (in memory: a request is for the moment, not history). */
+    private readonly shows;
+    private showSeq;
+    /**
+     * After a passing `game_publish`: leave the pages showing this project a
+     * request to take their game tab to the result. `show` is the agent's choice
+     * (play, versions, elements, elements:<id or name>, design:<chapter>); left
+     * out — or not found — the version decides: the one element it changed, the
+     * grid when several, else the play area (a candidate always opens play,
+     * where it waits for the user's OK). Pages pick it up on their poll.
+     * @returns a line for the tool's answer.
+     */
+    showAfterPublish(sessionId: string, version: number, candidate: boolean, show?: string, note?: string): Promise<string>;
+    /** Where a version's change is: the one element it changed, the grid for several, else play (code, assets, a first version). */
+    private changedBy;
     sessionState(sessionId: string): Promise<SessionGameState>;
     /**
      * One build file as it is in the working folder now (a model the user just

package/lib/types/store.js

@@ -458,7 +458,11 @@ export class GameService {
             manifest,
             ...(manifestText === undefined ? { manifestError: `${MANIFEST_FILE} 不见了` } : parsed?.ok === false ? { manifestError: parsed.error } : {}),
             chapters,
-            elements,
+            // Each element carries its file's last change, so the panel can list the newest first.
+            elements: await Promise.all(elements.map(async (e) => {
+                const info = await stat(join(row.root, e.file)).catch(() => undefined);
+                return info === undefined ? e : { ...e, updatedAt: info.mtimeMs };
+            })),
             elementErrors: failures,
             current: (await readJson(join(state, 'current.json'))) ?? null,
             candidate: (await readJson(join(state, 'candidate.json'))) ?? null,
@@ -493,6 +497,100 @@ export class GameService {
         return { changed, added };
     }
     /** The tab's state for one session. */
+    /**
+     * The bound project's newest version (the waiting candidate, else the live
+     * one), read from two small files: the page polls it to announce a version
+     * the moment it lands, whoever's turn cut it. Version 0 means none yet.
+     */
+    async liveVersion(sessionId) {
+        const row = await this.boundProject(sessionId);
+        if (row === undefined)
+            return null;
+        const state = join(row.root, STATE_DIR);
+        const candidate = await readJson(join(state, 'candidate.json'));
+        const record = candidate ?? (await readJson(join(state, 'current.json')));
+        const show = this.shows.get(row.id);
+        const extra = show === undefined ? {} : { show };
+        if (record === undefined)
+            return { projectId: row.id, version: 0, kind: 'none', at: null, ...extra };
+        return { projectId: row.id, version: record.version, kind: candidate !== undefined ? 'candidate' : 'deployed', at: record.at, ...(record.by === undefined ? {} : { by: record.by }), ...extra };
+    }
+    /** The agent's latest 「请用户看这里」 per project (in memory: a request is for the moment, not history). */
+    shows = new Map();
+    showSeq = 0;
+    /**
+     * After a passing `game_publish`: leave the pages showing this project a
+     * request to take their game tab to the result. `show` is the agent's choice
+     * (play, versions, elements, elements:<id or name>, design:<chapter>); left
+     * out — or not found — the version decides: the one element it changed, the
+     * grid when several, else the play area (a candidate always opens play,
+     * where it waits for the user's OK). Pages pick it up on their poll.
+     * @returns a line for the tool's answer.
+     */
+    async showAfterPublish(sessionId, version, candidate, show, note) {
+        const row = await this.boundProject(sessionId);
+        const project = row === undefined ? undefined : await this.view(row.id);
+        if (row === undefined || project === undefined)
+            return '';
+        let target = null;
+        let refused = '';
+        const asked = (show ?? '').trim();
+        if (asked !== '') {
+            const [view, ...rest] = asked.split(':');
+            const name = rest.join(':').trim();
+            if (view === 'play' || view === 'versions' || (view === 'elements' && name === ''))
+                target = { view };
+            else if (view === 'elements') {
+                const e = project.elements.find(x => x.id === name || x.name === name);
+                if (e !== undefined)
+                    target = { view, elementId: e.id };
+            }
+            else if (view === 'design') {
+                const c = project.chapters.find(x => x.id === name || x.title === name);
+                if (c !== undefined)
+                    target = { view, chapterId: c.id };
+            }
+            if (target === null)
+                refused = `（show「${asked}」找不到，改用默认位置）`;
+        }
+        let changedNames = [];
+        if (target === null) {
+            const decided = candidate ? { target: { view: 'play' }, names: [] } : await this.changedBy(row.root, version);
+            target = decided.target;
+            changedNames = decided.names;
+        }
+        const words = (note ?? '').trim();
+        const text = words !== '' ? words
+            : candidate ? `v${version} 等你确认上线`
+                : changedNames.length > 0 ? `v${version}：改了${changedNames.slice(0, 3).join('、')}${changedNames.length > 3 ? ` 等 ${changedNames.length} 个` : ''}`
+                    : `v${version} 已上线`;
+        this.shows.set(row.id, { seq: ++this.showSeq, target, note: text.slice(0, 120), at: new Date().toISOString() });
+        this.notify(row.id);
+        const where = target.view === 'play' ? '试玩' : target.view === 'versions' ? '版本' : target.view === 'design' ? `策划·${target.chapterId}` : target.elementId === undefined ? '元素列表' : `元素「${target.elementId}」`;
+        return `右栏会打开：${where}${refused}。`;
+    }
+    /** Where a version's change is: the one element it changed, the grid for several, else play (code, assets, a first version). */
+    async changedBy(root, version) {
+        const earlier = (await this.readVersions(root)).map(v => v.version).filter(v => v < version);
+        const play = { target: { view: 'play' }, names: [] };
+        if (earlier.length === 0)
+            return play;
+        const prev = Math.max(...earlier);
+        const dir = (v) => join(root, STATE_DIR, 'versions', String(v));
+        if (!await stat(dir(prev)).then(() => true, () => false))
+            return play;
+        const [before, after] = await Promise.all([this.elementIndex(dir(prev)), this.elementIndex(dir(version))]);
+        const changed = [...after].filter(([id, e]) => before.get(id)?.json !== e.json);
+        const others = async (v) => new Map((await walk(dir(v), p => !p.startsWith('elements/'))).map(f => [f.path, f.data.toString('base64')]));
+        const [a, b] = await Promise.all([others(prev), others(version)]);
+        const otherChanged = a.size !== b.size || [...b].some(([p, d]) => a.get(p) !== d);
+        const names = changed.map(([, e]) => e.name);
+        if (otherChanged || changed.length === 0)
+            return { target: { view: 'play' }, names };
+        if (changed.length === 1)
+            return { target: { view: 'elements', elementId: changed[0][0] }, names };
+        return { target: { view: 'elements' }, names };
+    }
     async sessionState(sessionId) {
         const bound = await this.boundProject(sessionId);
         return {

package/lib/types/tools.js

@@ -2,8 +2,8 @@
  * The game mode's model tools, registered by the `./agent` entry:
  * `game_open` (list, switch to, create or adopt a project — the light gate
  * lives here), `game_read` (the bound project's state), `game_propose` (look
- * variants) and `game_publish` (run the checks now and put a passing build
- * into the play area). There is no write tool: the agent writes project files
+ * variants) and `game_publish` (run the checks now, put a passing build into
+ * the play area, and take the user's game tab to it). There is no write tool: the agent writes project files
  * with the ordinary fs tools. The checks also run by themselves at the end of
  * every turn — but a turn can stay open for a long time (asking the user a
  * question does not close it), so `game_publish` is how a build reaches the
@@ -247,13 +247,19 @@ export function gameToolDefinitions(store) {
         description: 'Run the checks on this session\'s game project now (data validation → load and a 2-second smoke run → tests/) and, '
             + 'when they pass, cut a new version into the play area (or a candidate when auto-confirm is off). Call it whenever a '
             + 'playable build is ready and ALWAYS before asking the user to play or try something: asking a question does not end '
-            + 'the turn, so without it the play area still shows the previous version. A failure lists what to fix.',
-        parameters: {},
+            + 'the turn, so without it the play area still shows the previous version. A failure lists what to fix. A passing '
+            + 'publish also takes the user\'s game tab to the result: say where with show (play, versions, elements, '
+            + 'elements:<element id or name>, design:<chapter id or title>) and what to look at with note; left out, it opens '
+            + 'the one element this version changed, the element grid when it changed several, else the play area.',
+        parameters: {
+            show: { type: 'string', description: 'Where the user\'s game tab goes after a pass (see above). Optional.' },
+            note: { type: 'string', description: 'What to look at, a short phrase shown with it (e.g. 看看阿努比斯的头饰). Optional.' },
+        },
         output: {
             schema: { type: 'string' },
             render: (_args, value) => [{ type: 'text', text: String(value) }],
         },
-        execute: async (_args, exec) => {
+        execute: async (args, exec) => {
             const session = exec.agent?.session;
             if (session === undefined)
                 return '失败：这次调用没有会话。';
@@ -277,10 +283,12 @@ export function gameToolDefinitions(store) {
             }
             if (outcome.kind === 'pass') {
                 const tail = outcome.record.skipped === undefined ? '' : `（${outcome.record.skipped}）`;
+                const cut = outcome.deployed ?? outcome.candidate;
+                const shown = cut === null ? '' : await store.showAfterPublish(session.id, cut.version, outcome.candidate !== null, args.show, args.note);
                 if (outcome.deployed !== null)
-                    return `完成：v${outcome.deployed.version} 通过检查${outcome.record.passed > 0 ? `（${outcome.record.passed} 个用例）` : ''}，已进试玩区，可以请用户试玩了。${tail}`;
+                    return `完成：v${outcome.deployed.version} 通过检查${outcome.record.passed > 0 ? `（${outcome.record.passed} 个用例）` : ''}，已进试玩区，可以请用户试玩了。${shown}${tail}`;
                 if (outcome.candidate !== null)
-                    return `完成：v${outcome.candidate.version} 通过检查，作为候选等用户在右栏确认（自动上线关着或是换风格的版本）；确认后才进试玩区。${tail}`;
+                    return `完成：v${outcome.candidate.version} 通过检查，作为候选等用户在右栏确认（自动上线关着或是换风格的版本）；确认后才进试玩区。${shown}${tail}`;
                 return `检查通过，但这个会话是只读模式，没有生成版本。${tail}`;
             }
             // Skipped: no entry yet, or the build is the one already checked.