@linxin666/dsh-pet 0.3.19 → 0.3.21

package/lib/types/service.d.ts

@@ -117,6 +117,12 @@ export interface PetStateView {
     };
     /** The selected pet's display name (user rename or manifest default). */
     name: string;
+    /**
+     * The selected frames2d skin id for this pet (absent = the pet's default
+     * look). Persisted host-side, so a page reload or client restart restores
+     * the user's last choice instead of falling back to the default look.
+     */
+    skin?: string;
     /** Treat (小鱼干) stock snapshot. */
     treats: {
         /** Stocked treats now. */
@@ -308,6 +314,24 @@ export declare class PetService extends Service {
         ok: true;
         display: PetDisplayConfig;
     }>;
+    /**
+     * The persisted skin for one entry, when the manifest still declares it: a
+     * stale id (skin removed from the manifest, pet swapped) reads as "default"
+     * rather than pinning a track the browser half cannot resolve.
+     */
+    private persistedSkin;
+    /**
+     * RPC: select the current pet's frames2d skin (`undefined` restores the
+     * pet's default look). The choice is stored per pet, so every later state
+     * view (reload, client restart, pet re-selection) serves it back.
+     */
+    setSkin(skin: string | undefined): Promise<{
+        ok: true;
+        skin?: string;
+    } | {
+        ok: false;
+        error: string;
+    }>;
     /** RPC: update display config (size / position). Values are clamped to whole pixels. */
     setConfig(patch: Partial<PetDisplayConfig>): Promise<{
         ok: true;

package/lib/types/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"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"}

package/lib/types/service.js

@@ -13,7 +13,7 @@
  */
 import { Service } from '@deepseek-ai/cordis';
 import { announcementFresh, parseAnnouncement } from "./announce.js";
-import { emptyProjectionRuntime, isActivityPhase, projectOfficialEvent, } from "./event-projection.js";
+import { emptyProjectionRuntime, isActivityPhase, projectAssistantStreamFrame, projectOfficialEvent, } from "./event-projection.js";
 import { PetLedger } from "./ledger.js";
 import { DEFAULT_PET_NAME, DISPLAY_INSET_MAX, DISPLAY_SIZE_MAX, DISPLAY_SIZE_MIN, PET_NAME_MAX_LENGTH, loadPetPersist, petHomeDir, savePetPersist, } from "./persist.js";
 import { DEFAULT_DECORATION_ID, decorationView, loadPetRegistry, petEntryView, petPackageRoot, } from "./registry.js";
@@ -236,6 +236,16 @@ export class PetService extends Service {
                         this.rewardTurn(String(session.id), transition.completedTurn);
                     }
                 }),
+                this.ctx.on('agent/assistant-stream', ({ agent, frame }) => {
+                    const session = agent.session;
+                    const runtime = this.activityOf(session).runtime;
+                    const transition = projectAssistantStreamFrame(frame, runtime);
+                    if (transition === undefined)
+                        return;
+                    runtime.officialEventsSeen = true;
+                    this.officialEventSessions.add(session);
+                    this.applyActivity(session, transition.input, transition.whisper);
+                }),
                 this.ctx.on('session/disposed', (session) => {
                     this.ledger.forgetSession(String(session.id));
                     this.officialEventSessions.delete(session);
@@ -492,6 +502,36 @@ export class PetService extends Service {
         this.syncSettingsFromPet();
         return { ok: true, display: this.ledger.snapshot.display };
     }
+    /**
+     * The persisted skin for one entry, when the manifest still declares it: a
+     * stale id (skin removed from the manifest, pet swapped) reads as "default"
+     * rather than pinning a track the browser half cannot resolve.
+     */
+    persistedSkin(entry) {
+        const stored = this.ledger.petSkin(entry.id);
+        if (stored === undefined)
+            return undefined;
+        return entry.frames2d?.skins?.some(skin => skin.id === stored) === true ? stored : undefined;
+    }
+    /**
+     * RPC: select the current pet's frames2d skin (`undefined` restores the
+     * pet's default look). The choice is stored per pet, so every later state
+     * view (reload, client restart, pet re-selection) serves it back.
+     */
+    async setSkin(skin) {
+        const entry = this.activeEntry();
+        const declared = entry.frames2d?.skins ?? [];
+        if (skin === undefined) {
+            this.ledger.setPetSkin(entry.id, undefined);
+            this.flush();
+            return { ok: true };
+        }
+        if (!declared.some(candidate => candidate.id === skin))
+            return { ok: false, error: 'unknown-skin' };
+        this.ledger.setPetSkin(entry.id, skin);
+        this.flush();
+        return { ok: true, skin };
+    }
     /** RPC: update display config (size / position). Values are clamped to whole pixels. */
     async setConfig(patch) {
         const next = { ...this.ledger.snapshot.display, ...patch };
@@ -626,6 +666,7 @@ export class PetService extends Service {
         const announcement = this.announcement !== undefined && announcementFresh(this.announcement, Date.now())
             ? this.announcement
             : undefined;
+        const skin = this.persistedSkin(entry);
         return {
             animation: snapshot.animation,
             ...(snapshot.bubble === undefined ? {} : { bubble: snapshot.bubble }),
@@ -642,6 +683,7 @@ export class PetService extends Service {
                 description: entry.description,
             },
             name: this.petName(),
+            ...(skin === undefined ? {} : { skin }),
             treats: {
                 stocked: this.ledger.snapshot.treats.treats,
                 max: this.ledger.treatMax,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-pet",
   "description": "Multi-pet companion plugin for the dsh web GUI: a registry-driven floating pet that reacts to model activity, with per-pet naming, petting/feeding interactions and an affinity score",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -41,7 +41,7 @@
   "license": "Apache-2.0",
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.2-rc.1"
+      "dsh": ">=0.1.5-rc.1"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -66,18 +66,18 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^22.20.0",

package/src/client/PetDockEntry.test.tsx

@@ -84,6 +84,7 @@ function injected(): PetInjected {
       setMode: vi.fn(),
       workTick: vi.fn(),
       buy: vi.fn(),
+      setSkin: vi.fn(async () => ({ ok: true })),
     },
   }
 }

package/src/client/gameplay-hud.test.tsx

@@ -110,7 +110,7 @@ function petDefinition(): PetDefinition {
   }
 }
 
-function snapshot(view: PetGameplayStateView): PetStateView {
+function snapshot(view: PetGameplayStateView, skin?: string): PetStateView {
   return {
     animation: 'idle',
     phase: 'idle',
@@ -121,6 +121,7 @@ function snapshot(view: PetGameplayStateView): PetStateView {
     pet: { id: 'miku', displayName: 'Miku', description: '' },
     name: 'Miku',
     treats: { stocked: 0, max: 5 },
+    ...(skin === undefined ? {} : { skin }),
     gameplay: view,
   }
 }
@@ -128,7 +129,7 @@ function snapshot(view: PetGameplayStateView): PetStateView {
 interface Harness {
   store: PetStoreInstance
   bus: GameplayBus
-  api: GameplayApi & { touch: ReturnType<typeof vi.fn>; setMode: ReturnType<typeof vi.fn>; workTick: ReturnType<typeof vi.fn>; buy: ReturnType<typeof vi.fn> }
+  api: GameplayApi & { touch: ReturnType<typeof vi.fn>; setMode: ReturnType<typeof vi.fn>; workTick: ReturnType<typeof vi.fn>; buy: ReturnType<typeof vi.fn>; setSkin: ReturnType<typeof vi.fn> }
   setTrack: ReturnType<typeof vi.fn>
   drag: ReturnType<typeof createDragStream>
   setView: (view: PetGameplayStateView) => void
@@ -147,6 +148,7 @@ function harness(view: PetGameplayStateView = gameplayView()): Harness {
     setMode: vi.fn(async (mode: 'work' | 'sleep' | null) => ok({ view: gameplayView({ mode }) })),
     workTick: vi.fn(async () => ok({ outcome: 'success' as const, view: gameplayView({ mode: 'work' }) })),
     buy: vi.fn(async () => ok({ view: gameplayView() })),
+    setSkin: vi.fn(async () => ({ ok: true })),
   }
   const setView = (next: PetGameplayStateView): void => store.actions.setSnapshot(snapshot(next))
   render(<GameplayHud definition={petDefinition()} store={store} api={api} bus={bus} drag={drag} t={t} />)
@@ -284,6 +286,7 @@ describe('GameplayHud', () => {
     const api = {
       touch: vi.fn(async () => ({ ok: true, view: gameplayView() })),
       setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(),
+      setSkin: vi.fn(async () => ({ ok: true })),
     } as unknown as Harness['api']
     const setTrack = vi.fn()
     const bus: GameplayBus = { setTrack }
@@ -316,6 +319,7 @@ describe('GameplayHud', () => {
     const api = {
       touch: vi.fn(async () => ({ ok: true, view: gameplayView() })),
       setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(),
+      setSkin: vi.fn(async () => ({ ok: true })),
     } as unknown as Harness['api']
     const setTrack = vi.fn()
     const bus: GameplayBus = { setTrack }
@@ -335,6 +339,101 @@ describe('GameplayHud', () => {
     expect(api.touch).not.toHaveBeenCalledWith('head')
   })
 
+  it('restores the host-persisted skin and pushes its idle track on mount', () => {
+    // Reload / client restart: the state view carries the last choice, so the
+    // renderer repaints the selected skin without any interaction.
+    const def = petDefinition()
+    def.frames2d!.skins = [
+      { id: 'lanhainishang', label: '蓝海霓裳', idleTrack: 'lanhainishang-idle' },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView(), 'lanhainishang'))
+    const setSkin = vi.fn(async () => ({ ok: true }))
+    const api = { touch: vi.fn(), setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(), setSkin } as unknown as Harness['api']
+    const setIdleTrack = vi.fn()
+    const bus: GameplayBus = { setTrack: vi.fn(), setIdleTrack }
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    expect(setIdleTrack).toHaveBeenLastCalledWith('lanhainishang-idle')
+    // Latched on the bus too, so a later (re)mount re-applies it.
+    expect(bus.idleTrack).toBe('lanhainishang-idle')
+    // Restoring is read-only: mounting never writes the choice back.
+    expect(setSkin).not.toHaveBeenCalled()
+  })
+
+  it('persists the skin selection through the host API', async () => {
+    const def = petDefinition()
+    def.frames2d!.skins = [
+      { id: 'lanhainishang', label: '蓝海霓裳', idleTrack: 'lanhainishang-idle' },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView()))
+    const setSkin = vi.fn(async () => ({ ok: true }))
+    const api = { touch: vi.fn(), setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(), setSkin } as unknown as Harness['api']
+    const setIdleTrack = vi.fn()
+    const bus: GameplayBus = { setTrack: vi.fn(), setIdleTrack }
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    await act(async () => {
+      bus.openCard?.()
+    })
+    fireEvent.click(screen.getByText('皮肤'))
+    await act(async () => {
+      fireEvent.click(screen.getByText('蓝海霓裳'))
+    })
+    expect(setIdleTrack).toHaveBeenLastCalledWith('lanhainishang-idle')
+    expect(setSkin).toHaveBeenCalledWith('lanhainishang')
+  })
+
+  it('clears the persisted skin when the default look is picked', async () => {
+    const def = petDefinition()
+    def.frames2d!.skins = [
+      { id: 'lanhainishang', label: '蓝海霓裳', idleTrack: 'lanhainishang-idle' },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView(), 'lanhainishang'))
+    const setSkin = vi.fn(async () => ({ ok: true }))
+    const api = { touch: vi.fn(), setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(), setSkin } as unknown as Harness['api']
+    const setIdleTrack = vi.fn()
+    const bus: GameplayBus = { setTrack: vi.fn(), setIdleTrack }
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    await act(async () => {
+      bus.openCard?.()
+    })
+    fireEvent.click(screen.getByText('皮肤'))
+    await act(async () => {
+      fireEvent.click(screen.getByText('默认'))
+    })
+    expect(setSkin).toHaveBeenCalledWith(undefined)
+    expect(setIdleTrack).toHaveBeenLastCalledWith(undefined)
+  })
+
+  it('falls back to the served skin when the host rejects the choice', async () => {
+    const def = petDefinition()
+    def.frames2d!.skins = [
+      { id: 'lanhainishang', label: '蓝海霓裳', idleTrack: 'lanhainishang-idle' },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView()))
+    const setSkin = vi.fn(async () => ({ ok: false, error: 'unknown-skin' }))
+    const api = { touch: vi.fn(), setMode: vi.fn(), workTick: vi.fn(), buy: vi.fn(), setSkin } as unknown as Harness['api']
+    const setIdleTrack = vi.fn()
+    const bus: GameplayBus = { setTrack: vi.fn(), setIdleTrack }
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    await act(async () => {
+      bus.openCard?.()
+    })
+    fireEvent.click(screen.getByText('皮肤'))
+    await act(async () => {
+      fireEvent.click(screen.getByText('蓝海霓裳'))
+      // The rejected write settles on a later microtask; flush it so the
+      // rollback render reaches the bus before the assertion.
+      await Promise.resolve()
+      await Promise.resolve()
+    })
+    expect(setSkin).toHaveBeenCalledWith('lanhainishang')
+    // The rejected optimistic swap rolls back to what the host still serves.
+    expect(setIdleTrack).toHaveBeenLastCalledWith(undefined)
+  })
+
   it('runs the idle director: weighted act rolls on the interval', async () => {
     const h = harness()
     await act(async () => {
@@ -372,6 +471,70 @@ describe('GameplayHud', () => {
     expect(h.store.getSnapshot().snapshot?.gameplay?.mode).toBe('work')
   })
 
+  it('drops a late work adjudication once the mode has been left', async () => {
+    // #1495: the tick RPC can still be in flight when the user exits work mode;
+    // its result must not write the work view back or play the result track.
+    const h = harness(gameplayView({ mode: 'work' }))
+    let resolveTick: ((result: PetGameplayVerbResult) => void) | undefined
+    h.api.workTick.mockImplementationOnce(() => new Promise<PetGameplayVerbResult>((resolve) => { resolveTick = resolve }))
+    await act(async () => {
+      vi.advanceTimersByTime(10_000)
+    })
+    expect(h.api.workTick).toHaveBeenCalledTimes(1)
+    await act(async () => {
+      h.setView(gameplayView({ mode: null }))
+    })
+    await act(async () => {
+      resolveTick?.({ ok: true, outcome: 'success', view: gameplayView({ mode: 'work' }) })
+      await Promise.resolve()
+    })
+    expect(h.store.getSnapshot().snapshot?.gameplay?.mode).toBeNull()
+    expect(h.setTrack).not.toHaveBeenCalledWith('success')
+  })
+
+  it('drives the skin work loop and its skin result animation on the shared 10s rule', async () => {
+    // A skin supplies its own work / result art, but the adjudication rule
+    // (10s tick, 50% roll, result hold) stays the pet-level gameplay.work rule.
+    const def = petDefinition()
+    def.frames2d!.tracks['skin-work'] = { frames: ['/pet/miku/skin-work_1.webp'], durations: [200], loop: true }
+    def.frames2d!.tracks['skin-success'] = { frames: ['/pet/miku/skin-ok_1.webp'], durations: [200], loop: false, fallback: 'skin-work' }
+    def.frames2d!.skins = [
+      {
+        id: 'skin', label: 'Skin', idleTrack: 'idle',
+        // The override key is the manifest's successState ('success' in this fixture).
+        gameplayTracks: { work: 'skin-work', success: 'skin-success' },
+      },
+    ]
+    const store = createPetStore().create()
+    store.actions.setSnapshot(snapshot(gameplayView({ mode: 'work' }), 'skin'))
+    const setTrack = vi.fn()
+    const bus: GameplayBus = { setTrack }
+    const api = {
+      touch: vi.fn(), setMode: vi.fn(),
+      workTick: vi.fn(async () => ({ ok: true, outcome: 'success' as const, view: gameplayView({ mode: 'work' }) })),
+      buy: vi.fn(), setSkin: vi.fn(async () => ({ ok: true })),
+    } as unknown as Harness['api']
+    render(<GameplayHud definition={def} store={store} api={api} bus={bus} drag={createDragStream()} t={t} />)
+    // The mode hold uses the skin's own work loop, not the manifest track.
+    expect(setTrack).toHaveBeenCalledWith('skin-work')
+    await act(async () => {
+      vi.advanceTimersByTime(10_000)
+    })
+    // One adjudication per 10s window, then the skin's own result animation.
+    expect(api.workTick).toHaveBeenCalledTimes(1)
+    expect(setTrack).toHaveBeenCalledWith('skin-success')
+    await act(async () => {
+      vi.advanceTimersByTime(1300)
+    })
+    // The result holds for resultMs, then the skin work loop resumes ...
+    expect(setTrack).toHaveBeenLastCalledWith('skin-work')
+    await act(async () => {
+      vi.advanceTimersByTime(10_000)
+    })
+    // ... and the next 10s round adjudicates again.
+    expect(api.workTick).toHaveBeenCalledTimes(2)
+  })
+
   it('holds the sleep track and wakes on drag', async () => {
     const h = harness(gameplayView({ mode: 'sleep' }))
     expect(h.setTrack).toHaveBeenCalledWith('sleep')

package/src/client/gameplay-hud.tsx

@@ -25,6 +25,11 @@ export interface GameplayApi {
   setMode: (mode: 'work' | 'sleep' | null) => Promise<PetGameplayVerbResult>
   workTick: () => Promise<PetGameplayVerbResult>
   buy: (item: string) => Promise<PetGameplayVerbResult>
+  /**
+   * Persist the selected skin for the current pet (host-authoritative;
+   * `undefined` restores the pet's default look).
+   */
+  setSkin: (skin: string | undefined) => Promise<{ ok: boolean; error?: string }>
 }
 
 /**
@@ -37,6 +42,13 @@ export interface GameplayBus {
   setTrack?: (track?: string) => void
   /** Swap the pet's base idle track (skin switch); undefined restores default. */
   setIdleTrack?: (track?: string) => void
+  /**
+   * The base idle track the HUD wants right now, latched on the bus so a
+   * renderer that registers late (or remounts: hidden/summoned, StrictMode's
+   * double mount) still applies the restored skin instead of snapping back to
+   * the default look. Mutating it never requires a re-render.
+   */
+  idleTrack?: string
   tap?: (fx: number, fy: number) => void
   /**
    * Card open/close request from the chrome (the hover panel's 玩法 action):
@@ -70,6 +82,8 @@ export function GameplayHud(props: {
   const def = definition.gameplay
   const view = ui.snapshot?.gameplay
   const phase = ui.snapshot?.phase ?? 'idle'
+  // Host-persisted skin selection for this pet (undefined = default look).
+  const persistedSkin = ui.snapshot?.skin
 
   const [open, setOpen] = useState(false)
   const [page, setPage] = useState<HudPage>('root')
@@ -284,24 +298,32 @@ export function GameplayHud(props: {
 
   // Work loop: hold the work track, adjudicate one round per tick, play the
   // result track for its hold window, then resume. Leaving the mode
-  // releases the override so the phase mapping takes over.
+  // releases the override so the phase mapping takes over. A skin that
+  // declares gameplayTracks for the work states plays its own art instead.
   useEffect(() => {
     const work = def?.work
     if (def === undefined || work === undefined || view?.mode !== 'work') return undefined
-    bus.setTrack?.(work.state)
+    const skinGameplay = definition.frames2d?.skins?.find(skin => skin.id === skinIdRef.current)?.gameplayTracks
+    /** The state's track, swapped for the skin's override when it declares one. */
+    const trackOf = (state: string): string => skinGameplay?.[state] ?? state
+    bus.setTrack?.(trackOf(work.state))
     let resultTimer = 0
     const timer = window.setInterval(() => {
       if (busyRef.current) return
       busyRef.current = true
       void api.workTick().then((result) => {
         busyRef.current = false
+        // Leaving work mode while the adjudication is in flight drops the late
+        // result: writing it back would show work rewards and play the result
+        // track for a mode the user has already left (#1495).
+        if (modeRef.current !== 'work') return
         applyResult(result)
         if (result.ok !== true || result.outcome === undefined) return
-        const resultTrack = result.outcome === 'success' ? work.successState : work.failState
+        const resultTrack = trackOf(result.outcome === 'success' ? work.successState : work.failState)
         const hold = result.outcome === 'success' ? work.resultMs?.success ?? 1300 : work.resultMs?.fail ?? 1900
         bus.setTrack?.(resultTrack)
         resultTimer = window.setTimeout(() => {
-          if (modeRef.current === 'work') bus.setTrack?.(work.state)
+          if (modeRef.current === 'work') bus.setTrack?.(trackOf(work.state))
         }, hold)
       }, () => { busyRef.current = false })
     }, work.tickMs)
@@ -310,8 +332,8 @@ export function GameplayHud(props: {
       window.clearTimeout(resultTimer)
       bus.setTrack?.(undefined)
     }
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- the loop keys on the mode value
-  }, [definition.id, def, view?.mode])
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- the loop keys on the mode and the selected skin
+  }, [definition.id, def, view?.mode, skinId])
 
   // Sleep loop: hold the sleep track; restore is host-side (lazy settle).
   // While a skin with a gameplayTracks.sleep override is selected, the skin's
@@ -352,10 +374,44 @@ export function GameplayHud(props: {
     void api.setMode(next).then(applyResult, () => undefined)
   }
 
+  // Skin selection is persisted host-side (per pet): re-seed the menu from
+  // every fresh state view, so a page reload or client restart keeps the last
+  // choice instead of snapping back to the default look.
+  useEffect(() => {
+    setSkinId(persistedSkin)
+  }, [definition.id, persistedSkin])
+
+  // Push the resolved base idle track into the renderer whenever the pet or
+  // the selection changes. The value is latched on the bus first: the visual
+  // may register later, or remount later (hidden/summoned), and reads the
+  // latch back on activation so a restored skin never falls back to default.
+  useEffect(() => {
+    const skin = definition.frames2d?.skins?.find(candidate => candidate.id === skinId)
+    bus.idleTrack = skin?.idleTrack
+    bus.setIdleTrack?.(skin?.idleTrack)
+    // persistedSkin rides the deps so the host's value also re-pushes on
+    // arrival (a renderer that mounted early still converges).
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- one push per selection
+  }, [definition.id, skinId, persistedSkin])
+
   const skins = definition.frames2d?.skins
+  /** The base idle track one skin id resolves to (undefined = default look). */
+  const skinTrackOf = (id: string | undefined): string | undefined =>
+    id === undefined ? undefined : definition.frames2d?.skins?.find(candidate => candidate.id === id)?.idleTrack
+
   const selectSkin = (skin: PetSkinDefinition | undefined): void => {
     setSkinId(skin?.id)
     bus.setIdleTrack?.(skin?.idleTrack)
+    // The host owns the choice: a refusal (unknown skin) restores both the
+    // menu highlight and the renderer to the value it still serves.
+    const restore = (): void => {
+      setSkinId(persistedSkin)
+      bus.setIdleTrack?.(skinTrackOf(persistedSkin))
+    }
+    void api.setSkin(skin?.id).then((result) => {
+      if (result.ok) return
+      restore()
+    }, restore)
   }
 
   return (

package/src/client/index.ts

@@ -32,6 +32,7 @@ import type { PetDefinition } from '../registry.ts'
 import { createElement } from 'react'
 import { createRoot } from 'react-dom/client'
 import { createPetStore, type PetStoreInstance } from './pet-store.ts'
+import { createWorkTickGate } from './work-tick-gate.ts'
 import { PetDockEntry, type PetInjected } from './PetDockEntry.tsx'
 import { defaultPetRendererRegistry } from './renderers/registry.ts'
 import { live2dRenderer } from './renderers/live2d.ts'
@@ -51,6 +52,7 @@ interface PetHttpApi {
   setConfig(patch: Partial<PetDisplayConfig>): Promise<{ ok: true; display: PetDisplayConfig }>
   setName(name: string): Promise<{ ok: true; name: string } | { ok: false; error: string }>
   setPet(petId: string): Promise<{ ok: true; petId: string } | { ok: false; error: string }>
+  setSkin(skin?: string): Promise<{ ok: boolean; error?: string; skin?: string }>
   gameplayTouch(zone?: string): Promise<PetGameplayVerbResult>
   gameplaySetMode(mode: 'work' | 'sleep' | null): Promise<PetGameplayVerbResult>
   gameplayWorkTick(): Promise<PetGameplayVerbResult>
@@ -82,6 +84,7 @@ const petApi: PetHttpApi = {
   setConfig: (patch) => petFetch('/api/pet/set-config', patch),
   setName: (name) => petFetch('/api/pet/set-name', { name }),
   setPet: (petId) => petFetch('/api/pet/set-pet', { petId }),
+  setSkin: (skin) => petFetch('/api/pet/set-skin', skin === undefined ? {} : { skin }),
   gameplayTouch: (zone) => petFetch('/api/pet/gameplay/touch', zone === undefined ? {} : { zone }),
   gameplaySetMode: (mode) => petFetch('/api/pet/gameplay/mode', { mode }),
   gameplayWorkTick: () => petFetch('/api/pet/gameplay/work-tick', {}),
@@ -123,16 +126,19 @@ declare module '@deepseek-ai/cordis' {
  * @param ctx - client root context.
  */
 
+/** The page-wide work-tick gate; its window follows the active pet's cadence. */
+const workTickGate = createWorkTickGate()
+
 /**
- * Module-wide work-tick throttle (ms). Hot reloads can leave several
- * GameplayHud instances alive, each running its own 10s work interval;
- * without a shared gate every interval would call workTick and each stale
- * call re-rolls, re-grants treats and re-plays the success/fail track, so
- * the outcome appears to play several times per window. This shared marker
- * accepts the first adjudication of a window and silently suppresses the
- * duplicates that follow. Reset when (re-)entering work mode.
+ * The work cadence the active pet declares, when its registry entry is known.
+ * @param store - the pet store holding the host snapshot and the registry list.
+ * @returns the configured `gameplay.work.tickMs`, or undefined when unknown.
  */
-let lastWorkTickAt = 0
+function activeWorkTickMs(store: PetStoreInstance): number | undefined {
+  const state = store.getSnapshot()
+  const definition = state.pets.find((entry) => entry.id === state.snapshot?.pet.id)
+  return definition?.gameplay?.work?.tickMs
+}
 
 export function apply(ctx: ClientContext): void {
   // Anonymous install heartbeat (docs/telemetry.md): one beat per browser per
@@ -371,18 +377,22 @@ export function apply(ctx: ClientContext): void {
         },
         gameplay: {
           touch: (zone) => petApi.gameplayTouch(zone),
+          setSkin: (skin) => petApi.setSkin(skin).then((result) => {
+            if (result.ok) pollNow()
+            return result
+          }, () => ({ ok: false, error: 'transport' })),
+          
           setMode: async (mode) => {
-            if (mode === 'work') lastWorkTickAt = 0
+            if (mode === 'work') workTickGate.reset()
             return petApi.gameplaySetMode(mode)
           },
           workTick: async () => {
             // One adjudication per tick window, page-wide: suppress stale
-            // duplicate intervals (HMR) re-playing the result track.
-            const now = Date.now()
-            if (now - lastWorkTickAt < 8500) {
+            // duplicate intervals (HMR) re-playing the result track. The window
+            // is the pet's own cadence, so a shorter tickMs is not downgraded.
+            if (!workTickGate.allow(activeWorkTickMs(petStore))) {
               return { ok: true } as PetGameplayVerbResult
             }
-            lastWorkTickAt = now
             return petApi.gameplayWorkTick()
           },
           buy: (item) => petApi.gameplayBuy(item),

package/src/client/pet.module.css

@@ -46,7 +46,7 @@
   background: rgba(3, 105, 161, 0.95);
 }
 
-/* 状态气泡：皮肤底色玻璃 + 皮肤描边微光 + 进场浮现。
+/* 状态气泡：虎鲸蓝黑渐变玻璃 + DeepSeek 蓝描边微光 + 进场浮现。
    碎碎念不再单独渲染第二只气泡，也不换色调，而是以 .bubbleWhisper
    接管这同一只气泡的文案，气泡栈内所有气泡共用同一片玻璃。 */
 .bubbleStatus {