@linxin666/dsh-pet 0.1.19 → 0.2.0

package/src/client/index.ts

@@ -11,7 +11,7 @@
  * @module @linxin666/dsh-pet/client
  */
 
-import type { ClientContext, SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext, ISessions, SessionId, SettingsScope, SettingsScopeSpec } from '@deepseek-ai/dsh-client-runtime/client'
 // Type-only: pulls the locale plugin's Context merge (ctx.locale).
 import type {} from '@deepseek-ai/dsh-client-locale/client'
 // Type-only: pulls the settings-surface Context merge (ctx.settingsScope).
@@ -72,8 +72,8 @@ const POLL_MS = 2000
 /** Settings namespace the pet settings card edits (the Host plugin registers it). */
 const PET_SETTINGS_NS = 'pet'
 
-/** Required services. */
-export const inject = ['slots', 'locale', 'connection', 'settingsScope', 'remote']
+/** Required services (sessions powers bubble-to-session navigation). */
+export const inject = ['slots', 'locale', 'connection', 'settingsScope', 'remote', 'sessions']
 
 /** Re-exported for consumers that type against the injected face. */
 export type { PetInjected, PetDockEntryProps } from './PetDockEntry.tsx'
@@ -152,6 +152,11 @@ export function apply(ctx: ClientContext): void {
       // tick tries again. After it lands, one list feeds both the sprite and
       // the settings card's choices.
       let petsLoaded = false
+      // Latest-wins guard: the 2s tick, visibility recovery, and
+      // interaction-triggered refreshes can overlap; only the newest
+      // response may publish, so a slow older one can never roll the
+      // snapshot back.
+      let stateSeq = 0
       const pollNow = (): void => {
         if (!petsLoaded) {
           petApi.pets().then((list) => {
@@ -161,9 +166,13 @@ export function apply(ctx: ClientContext): void {
             // Retry on the next poll tick.
           })
         }
+        const seq = stateSeq + 1
+        stateSeq = seq
         petApi.state().then((snapshot) => {
+          if (seq !== stateSeq) return
           setSnapshot(snapshot)
         }, () => {
+          if (seq !== stateSeq) return
           setState('error', 'pet.state transport error')
         })
       }
@@ -202,9 +211,23 @@ export function apply(ctx: ClientContext): void {
         }
       }, 'pet: poll')
 
+      // Clicking a session bubble jumps the GUI to that session. A bubble
+      // can outlive its disposed session by one poll tick, and the sessions
+      // service fails loud on unknown ids, so consult the live list first.
+      // The pet's type program also loads the host-side dsh-session package
+      // through the service types, whose Context merge declares a different
+      // 'sessions' face; pin the browser runtime's outward face here.
+      const sessions = ctx.sessions as unknown as ISessions
+      const openSession = (sessionId: string): void => {
+        const list = sessions.list.getSnapshot()
+        if (list.byId[sessionId as SessionId] === undefined) return
+        sessions.open(sessionId as SessionId)
+      }
+
       const injected = (): PetInjected => ({
         store: petStore,
         ensure: pollNow,
+        openSession,
         pet: () => {
           petApi.interact('pet').then((result) => {
             setFeedback({

package/src/client/locales.ts

@@ -19,6 +19,7 @@ export const zh = {
   'pet.treats': '小鱼干 ×{n}',
   'pet.state.loading': '宠物正在赶来…',
   'pet.state.error': '宠物迷路了（连接失败）',
+  'pet.openSessionHint': '点击跳转到对应会话',
   // 一级设置页（settings.section 席位）。
   'settings.title': '宠物',
   'settings.description': '选择宠物并调整它的显示布局。',
@@ -64,6 +65,7 @@ export const en = {
   'pet.treats': 'Treats ×{n}',
   'pet.state.loading': 'The pet is on its way…',
   'pet.state.error': 'The pet is lost (connection failed)',
+  'pet.openSessionHint': 'Click to jump to this session',
   // First-level settings section (the `settings.section` seat).
   'settings.title': 'Pet',
   'settings.description': 'Pick a pet and tune its display layout.',

package/src/client/pet-css.test.ts

@@ -0,0 +1,42 @@
+import { readFileSync } from 'node:fs'
+import { describe, expect, it } from 'vitest'
+
+const css = readFileSync(new URL('./pet.module.css', import.meta.url), 'utf8')
+
+describe('pet hover panel css', () => {
+  it('anchors the panel below the pet', () => {
+    const panel = css.match(/\.panel\s*\{([^}]*)\}/)?.[1] ?? ''
+    expect(panel).toContain('top: 100%')
+    expect(panel).toContain('margin-top: 8px')
+    expect(panel).not.toContain('right: 100%')
+  })
+
+  it('extends the hover bridge upward across the panel gap', () => {
+    const bridge = css.match(/\.panel::after\s*\{([^}]*)\}/)?.[1] ?? ''
+    expect(bridge).toContain('bottom: 100%')
+    expect(bridge).toContain('height: 14px')
+  })
+
+  it('styles the whisper bubble as a distinct non-interactive inner voice', () => {
+    const whisper = css.match(/\.bubbleWhisper\s*\{([^}]*)\}/)?.[1] ?? ''
+    expect(whisper).toContain('font-style: italic')
+    expect(whisper).toContain('pointer-events: none')
+    expect(css).toContain('@keyframes pet-whisper-in')
+  })
+
+  it('gives the panel and status bubbles entrance animations', () => {
+    expect(css).toContain('@keyframes pet-panel-in')
+    expect(css).toContain('@keyframes pet-bubble-in')
+    const panel = css.match(/\.panel\s*\{([^}]*)\}/)?.[1] ?? ''
+    expect(panel).toContain('animation: pet-panel-in')
+  })
+
+  it('can place the panel above and bridge the lower gap', () => {
+    const panel = css.match(/\.panelAbove\s*\{([^}]*)\}/)?.[1] ?? ''
+    expect(panel).toContain('bottom: 100%')
+    expect(panel).toContain('margin-bottom: 8px')
+    const bridge = css.match(/\.panelAbove::after\s*\{([^}]*)\}/)?.[1] ?? ''
+    expect(bridge).toContain('top: 100%')
+    expect(bridge).toContain('bottom: auto')
+  })
+})

package/src/client/pet.module.css

@@ -37,18 +37,63 @@
   background: rgba(56, 189, 248, 0.92);
 }
 
+/* 状态气泡：深色渐变玻璃 + 青色描边辉光 + 进场浮现，
+   让工作汇报从“标签”升级为“会呼吸的状态条”。 */
 .bubbleStatus {
   max-width: min(280px, calc(100vw - 24px));
   overflow: hidden;
   text-overflow: ellipsis;
-  background: rgba(15, 23, 42, 0.9);
-  border: 1px solid rgba(125, 211, 252, 0.5);
-  animation: none;
+  background: linear-gradient(160deg, rgba(30, 41, 59, 0.88), rgba(15, 23, 42, 0.92));
+  border: 1px solid rgba(125, 211, 252, 0.55);
+  box-shadow:
+    0 4px 14px rgba(2, 6, 23, 0.4),
+    0 0 0 1px rgba(125, 211, 252, 0.12),
+    0 0 18px rgba(56, 189, 248, 0.18);
+  backdrop-filter: blur(8px);
+  letter-spacing: 0.02em;
+  animation: pet-bubble-in 240ms ease-out;
+}
+
+/* 碎碎念气泡：宠物的内心悄悄话。紫粉渐变玻璃、虚线描边与斜体，
+   配合「」引号，与青色的工作状态气泡一眼区分；不可点击、自动消散。 */
+.bubbleWhisper {
+  position: relative;
+  max-width: min(260px, calc(100vw - 24px));
+  padding: 4px 12px;
+  border-radius: 999px;
+  font-size: 11.5px;
+  font-style: italic;
+  line-height: 1.45;
+  letter-spacing: 0.03em;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  color: #f5d0fe;
+  background: linear-gradient(150deg, rgba(88, 28, 135, 0.52), rgba(157, 23, 77, 0.44));
+  border: 1px dashed rgba(240, 171, 252, 0.55);
+  box-shadow:
+    0 3px 12px rgba(46, 16, 101, 0.4),
+    0 0 14px rgba(217, 70, 239, 0.16);
+  backdrop-filter: blur(8px);
+  pointer-events: none;
+  animation: pet-whisper-in 320ms cubic-bezier(0.22, 1, 0.36, 1);
+}
+
+.bubbleWhisper::before {
+  content: '「';
+  margin-right: 2px;
+  opacity: 0.75;
+}
+
+.bubbleWhisper::after {
+  content: '」';
+  margin-left: 2px;
+  opacity: 0.75;
 }
 
 /* 多会话气泡栈：并行会话各自一个气泡，自精灵头顶向上堆叠，
    最近更新的会话在最上。栈内气泡改流入列布局，不再绝对定位
-   互相覆盖。 */
+   互相覆盖。气泡可点击：点击跳转到对应会话。 */
 .bubbleStack {
   position: absolute;
   bottom: 100%;
@@ -56,13 +101,68 @@
   flex-direction: column;
   align-items: center;
   gap: 4px;
-  pointer-events: none;
+  pointer-events: auto;
 }
 
 .bubbleStack .bubble {
   position: relative;
   bottom: auto;
   margin-bottom: 0;
+  pointer-events: auto;
+}
+
+.bubbleClickable {
+  cursor: pointer;
+  font: inherit;
+  text-align: center;
+  appearance: none;
+  transition: filter 120ms ease, box-shadow 120ms ease;
+}
+
+.bubbleClickable:hover {
+  filter: brightness(1.12);
+}
+
+.bubbleClickable:focus-visible {
+  outline: none;
+  /* 2px accent ring on the pet's own palette, theme-agnostic. */
+  box-shadow: 0 0 0 2px rgba(56, 189, 248, 0.85);
+}
+
+@keyframes pet-bubble-in {
+  from {
+    opacity: 0;
+    transform: translateY(6px) scale(0.96);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+
+@keyframes pet-whisper-in {
+  0% {
+    opacity: 0;
+    transform: translateY(8px) scale(0.9);
+  }
+  60% {
+    transform: translateY(-1px) scale(1.02);
+  }
+  100% {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+
+@keyframes pet-panel-in {
+  from {
+    opacity: 0;
+    transform: translateY(4px) scale(0.97);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
 }
 
 @keyframes pet-bubble-pop {
@@ -86,37 +186,58 @@
   }
 }
 
+/* 悬浮面板默认位于精灵脚下，不再占据精灵上方的空间：
+   会话气泡栈独占精灵头顶区域，两者互不遮挡 —— 气泡因此可以始终
+   显示并保持可点击，不必在 hover 时让位给面板。仅当视口底部空间
+   不足时，面板才回退到精灵上方。 */
 .panel {
   position: absolute;
-  bottom: 100%;
-  background: rgba(15, 23, 42, 0.92);
-  border: 1px solid rgba(148, 163, 184, 0.35);
-  border-radius: 10px;
-  padding: 8px 10px;
+  top: 100%;
+  margin-top: 8px;
+  background: linear-gradient(165deg, rgba(30, 41, 59, 0.94), rgba(15, 23, 42, 0.96));
+  border: 1px solid rgba(148, 163, 184, 0.4);
+  border-radius: 12px;
+  padding: 10px 12px;
   color: #e2e8f0;
   font-size: 12px;
-  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.35);
-  backdrop-filter: blur(6px);
+  box-shadow:
+    0 8px 24px rgba(2, 6, 23, 0.45),
+    0 0 0 1px rgba(125, 211, 252, 0.08),
+    inset 0 1px 0 rgba(226, 232, 240, 0.08);
+  backdrop-filter: blur(10px);
   display: flex;
   flex-direction: column;
-  gap: 6px;
-  min-width: 132px;
+  gap: 7px;
+  min-width: 148px;
+  animation: pet-panel-in 200ms cubic-bezier(0.22, 1, 0.36, 1);
+  transform-origin: 50% 0;
 }
 
-/* 面板底边与图标顶边之间的 hover 桥接（issue #49）：
-   面板绝对定位在图标上方（bottom: 100%），若两者之间存在哪怕几个
-   像素的间隙，指针滑过间隙时会触发容器的 pointerleave，面板在指针
-   抵达按钮前就收起。这段透明伪元素把命中区向下延伸、覆盖图标顶部，
-   使指针在图标与按钮之间始终停留在 hover 区域内。 */
+/* 面板顶边与精灵底边之间的 hover 桥接（issue #49）：
+   面板在精灵下方留有 8px 间隙，透明伪元素向上覆盖间隙，
+   使指针在精灵与按钮之间始终停留在 hover 区域。 */
 .panel::after {
   content: '';
   position: absolute;
-  top: 100%;
+  bottom: 100%;
   left: 0;
   right: 0;
   height: 14px;
 }
 
+.panelAbove {
+  top: auto;
+  bottom: 100%;
+  margin-top: 0;
+  margin-bottom: 8px;
+  transform-origin: 50% 100%;
+}
+
+.panelAbove::after {
+  top: 100%;
+  bottom: auto;
+}
+
 .rankRow {
   display: flex;
   justify-content: space-between;
@@ -126,6 +247,28 @@
 
 .nameCell {
   font-weight: 600;
+  letter-spacing: 0.02em;
+  background: linear-gradient(90deg, #7dd3fc, #38bdf8 60%, #818cf8);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}
+
+/* 面板数值的专属配色：称号紫、小鱼干青、亲密度琥珀，
+   让两行数据扫一眼就能分辨。 */
+.statRank {
+  color: #c4b5fd;
+  font-weight: 600;
+}
+
+.statTreats {
+  color: #7dd3fc;
+  font-weight: 600;
+}
+
+.statPoints {
+  color: #fcd34d;
+  font-weight: 600;
 }
 
 .renameRow {
@@ -166,15 +309,20 @@
   cursor: pointer;
   color: #0f172a;
   background: linear-gradient(180deg, #7dd3fc, #38bdf8);
-  transition: filter 120ms ease, box-shadow 120ms ease;
+  box-shadow: 0 2px 6px rgba(56, 189, 248, 0.25);
+  transition: filter 120ms ease, box-shadow 120ms ease, transform 120ms ease;
 }
 
 .action:hover {
   filter: brightness(1.08);
+  transform: translateY(-1px);
+  box-shadow: 0 4px 10px rgba(56, 189, 248, 0.35);
 }
 
 .action:active {
   filter: brightness(0.94);
+  transform: translateY(0);
+  box-shadow: 0 1px 4px rgba(56, 189, 248, 0.25);
 }
 
 .action:focus-visible {
@@ -215,7 +363,10 @@
 /* Reduced motion: freeze the reaction bubble and kill the overlay transitions
    so the pet's motion is static or minimal without hiding interaction. */
 @media (prefers-reduced-motion: reduce) {
-  .bubble {
+  .bubble,
+  .bubbleStatus,
+  .bubbleWhisper,
+  .panel {
     animation: none;
     opacity: 1;
   }

package/src/client/sequences.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'vitest'
+import type { PetTrackDef } from '../registry.ts'
+import type { PetAnimation } from '../state.ts'
+import { sequenceFrameAt } from './sequences.ts'
+
+const track = (durations: number[]): PetTrackDef => ({
+  frames: durations.map((_, index) => index),
+  durations,
+  loop: true,
+})
+
+const tracks = {
+  running: track([100, 200]),
+  waiting: track([300, 100]),
+} as Record<PetAnimation, PetTrackDef>
+
+describe('sequenceFrameAt', () => {
+  const sequence: PetAnimation[] = ['running', 'waiting']
+
+  it('finishes every frame of one track before advancing', () => {
+    expect(sequenceFrameAt(sequence, tracks, 0)).toEqual({ animation: 'running', frameIndex: 0 })
+    expect(sequenceFrameAt(sequence, tracks, 100)).toEqual({ animation: 'running', frameIndex: 1 })
+    expect(sequenceFrameAt(sequence, tracks, 299)).toEqual({ animation: 'running', frameIndex: 1 })
+    expect(sequenceFrameAt(sequence, tracks, 300)).toEqual({ animation: 'waiting', frameIndex: 0 })
+    expect(sequenceFrameAt(sequence, tracks, 600)).toEqual({ animation: 'waiting', frameIndex: 1 })
+  })
+
+  it('loops the whole sequence and preserves overshoot', () => {
+    expect(sequenceFrameAt(sequence, tracks, 700)).toEqual({ animation: 'running', frameIndex: 0 })
+    expect(sequenceFrameAt(sequence, tracks, 850)).toEqual({ animation: 'running', frameIndex: 1 })
+    expect(sequenceFrameAt(sequence, tracks, 1_420)).toEqual({ animation: 'running', frameIndex: 0 })
+  })
+})

package/src/client/sequences.ts

@@ -0,0 +1,33 @@
+/** Pure timing helpers for manifest-defined scene animation sequences. */
+
+import type { PetTrackDef } from '../registry.ts'
+import type { PetAnimation } from '../state.ts'
+
+export interface SequenceFrame {
+  animation: PetAnimation
+  frameIndex: number
+}
+
+/** Resolve the active track and frame after elapsed milliseconds of a looping sequence. */
+export function sequenceFrameAt(
+  sequence: readonly PetAnimation[],
+  tracks: Record<PetAnimation, PetTrackDef>,
+  elapsedMs: number,
+): SequenceFrame {
+  const itemDurations = sequence.map(animation => tracks[animation].durations.reduce((sum, value) => sum + value, 0))
+  const sequenceDuration = itemDurations.reduce((sum, value) => sum + value, 0)
+  let offset = Math.max(0, elapsedMs) % sequenceDuration
+  let itemIndex = 0
+  while (itemIndex < sequence.length - 1 && offset >= itemDurations[itemIndex]!) {
+    offset -= itemDurations[itemIndex]!
+    itemIndex += 1
+  }
+  const animation = sequence[itemIndex]!
+  const track = tracks[animation]
+  let frameIndex = 0
+  while (frameIndex < track.frames.length - 1 && offset >= track.durations[frameIndex]!) {
+    offset -= track.durations[frameIndex]!
+    frameIndex += 1
+  }
+  return { animation, frameIndex }
+}

package/src/client/spritesheet.ts

@@ -7,7 +7,7 @@
  * @module @linxin666/dsh-pet/client/spritesheet
  */
 
-import type { PetAnimation } from '../state.ts'
+import { rowOf, type PetAnimation } from '../state.ts'
 import type { PetCell, PetTrackDef } from '../registry.ts'
 
 /** Animation track shape the frame loop consumes. */
@@ -15,18 +15,8 @@ export type TrackDef = PetTrackDef
 
 /** Row index of one animation track (the fixed 9-row contract). */
 export function rowOfTrack(animation: PetAnimation): number {
-  const rows: Record<PetAnimation, number> = {
-    idle: 0,
-    'running-right': 1,
-    'running-left': 2,
-    waving: 3,
-    jumping: 4,
-    failed: 5,
-    waiting: 6,
-    running: 7,
-    review: 8,
-  }
-  return rows[animation]
+  // The table itself lives in state.ts (rowOf) — the single source of truth.
+  return rowOf(animation)
 }
 
 /**

package/src/event-projection.ts

@@ -3,11 +3,17 @@
  * vocabulary onto the pet's visual phases and carries an optional completed-
  * turn reward for the ledger. Holds no state of its own; callers keep a
  * {@link ProjectionRuntime} per session and feed events in arrival order.
+ *
+ * Status copy comes from the chatter voice (big rotating pools, per-tool
+ * families, real-argument hints), and streamed model output feeds the murmur
+ * engine so the pet can whisper its inner voice (碎碎念). The wall clock is
+ * injected by the caller, keeping every projection reproducible.
  * @module @linxin666/dsh-pet/event-projection
  */
 
 import type { SessionEvent } from '@deepseek-ai/dsh-session'
 import type { PetStateInput } from './state.ts'
+import { StatusVoice, toolArgHint, WhisperEngine } from './chatter.ts'
 
 /** Runtime shape of the optional legacy activity event. */
 export interface ActivityStatusEventLike {
@@ -21,23 +27,35 @@ export interface ProjectionRuntime {
   activeTools: Set<string>
   officialEventsSeen: boolean
   stepHadFailure: boolean
+  /** Round-robin status copy voice (scene-stable, cadence-rotated). */
+  voice: StatusVoice
+  /** Inner-whisper engine fed by the model's own streamed output. */
+  whispers: WhisperEngine
 }
 
 /** One official event projection, optionally carrying a completed turn reward. */
 export interface PetActivityTransition {
   input: PetStateInput
   completedTurn?: number
+  /** A fresh inner whisper woken by this event's model output, when any. */
+  whisper?: string
 }
 
 /** Fresh projection runtime for a newly seen session. */
 export function emptyProjectionRuntime(): ProjectionRuntime {
-  return { activeTools: new Set(), officialEventsSeen: false, stepHadFailure: false }
+  return {
+    activeTools: new Set(),
+    officialEventsSeen: false,
+    stepHadFailure: false,
+    voice: new StatusVoice(),
+    whispers: new WhisperEngine(),
+  }
 }
 
 /** Keep tool names readable inside the compact status bubble. */
 function displayToolName(name: string): string {
   const compact = name.replace(/\s+/g, ' ').trim() || '工具'
-  return compact.length <= 24 ? compact : `${compact.slice(0, 21)}...`
+  return compact.length <= 24 ? compact : compact.slice(0, 21) + '...'
 }
 
 /** Whether a legacy phase is part of the pet's supported vocabulary. */
@@ -48,38 +66,53 @@ export function isActivityPhase(phase: string): phase is PetStateInput['phase']
 /**
  * Project the durable DSH session vocabulary into the pet's visual phases.
  * Unknown and log-only events do not disturb the last meaningful activity.
+ * @param nowMs - injected wall clock for copy rotation and whisper pacing.
  */
 export function projectOfficialEvent(
   event: SessionEvent,
   runtime: ProjectionRuntime,
+  nowMs: number = Date.now(),
 ): PetActivityTransition | undefined {
   switch (event.type) {
     case 'turn/start':
       runtime.activeTools.clear()
       runtime.stepHadFailure = false
-      return { input: { phase: 'waiting', line: '准备开始' } }
+      return { input: { phase: 'waiting', line: runtime.voice.scene('prepare', nowMs) } }
     case 'step/start':
       runtime.activeTools.clear()
       runtime.stepHadFailure = false
-      return { input: { phase: 'waiting', line: '等待模型响应' } }
+      return { input: { phase: 'waiting', line: runtime.voice.scene('waiting', nowMs) } }
     case 'assistant/chunk': {
       const { chunk } = event.data
       if (chunk.type === 'reasoning-delta' && chunk.text.length > 0) {
-        return { input: { phase: 'thinking', line: '正在思考' } }
+        const whisper = runtime.whispers.feed(chunk.text, nowMs)
+        return {
+          input: { phase: 'thinking', line: runtime.voice.scene('thinking', nowMs) },
+          ...(whisper === undefined ? {} : { whisper }),
+        }
       }
       if (chunk.type === 'text-delta' && chunk.text.length > 0) {
-        return { input: { phase: 'review', line: '整理回复中' } }
+        const whisper = runtime.whispers.feed(chunk.text, nowMs)
+        return {
+          input: { phase: 'review', line: runtime.voice.scene('review', nowMs) },
+          ...(whisper === undefined ? {} : { whisper }),
+        }
       }
       return undefined
     }
     case 'assistant/message':
-      return { input: { phase: 'review', line: '整理回复中' } }
+      return { input: { phase: 'review', line: runtime.voice.scene('review', nowMs) } }
     case 'tool/call':
       runtime.activeTools.add(String(event.data.callId))
       return {
         input: {
           phase: 'tool',
-          line: `正在使用 ${displayToolName(event.data.name)}`,
+          line: runtime.voice.tool(
+            event.data.name,
+            displayToolName(event.data.name),
+            toolArgHint(event.data.name, event.data.arguments),
+            nowMs,
+          ),
         },
       }
     case 'tool/result': {
@@ -90,30 +123,30 @@ export function projectOfficialEvent(
         return {
           input: {
             phase: 'tool',
-            line: `还有 ${runtime.activeTools.size} 个工具运行中`,
+            line: runtime.voice.toolRemaining(runtime.activeTools.size, nowMs),
           },
         }
       }
       return runtime.stepHadFailure
-        ? { input: { phase: 'failed', line: '工具执行失败' } }
-        : { input: { phase: 'thinking', line: '处理工具结果' } }
+        ? { input: { phase: 'failed', line: runtime.voice.scene('toolFailed', nowMs) } }
+        : { input: { phase: 'thinking', line: runtime.voice.scene('toolResult', nowMs) } }
     }
     case 'turn/end': {
       runtime.activeTools.clear()
       switch (event.data.reason.kind) {
         case 'completed':
           return {
-            input: { phase: 'done', line: '完成啦' },
+            input: { phase: 'done', line: runtime.voice.scene('done', nowMs) },
             completedTurn: event.data.turn,
           }
         case 'error':
-          return { input: { phase: 'failed', line: '执行失败' } }
+          return { input: { phase: 'failed', line: runtime.voice.scene('failed', nowMs) } }
         case 'max-tokens':
-          return { input: { phase: 'failed', line: '达到输出上限' } }
+          return { input: { phase: 'failed', line: runtime.voice.scene('maxTokens', nowMs) } }
         case 'interrupted':
-          return { input: { phase: 'failed', line: '执行意外中断' } }
+          return { input: { phase: 'failed', line: runtime.voice.scene('interrupted', nowMs) } }
         case 'blocked':
-          return { input: { phase: 'waiting', line: '等待继续' } }
+          return { input: { phase: 'waiting', line: runtime.voice.scene('blocked', nowMs) } }
         case 'aborted':
           // A stopped session settles to idle without a bubble: the pet
           // visibly calms down and the session drops out of the bubble stack.

package/src/index.ts

@@ -19,6 +19,7 @@ import { PetService, PET_SETTINGS_NAMESPACE, type PetConfig, type PetSettingsSec
 import { makePetRoutes } from './routes.ts'
 import { loadPetRegistry, petPackageRoot } from './registry.ts'
 import { DISPLAY_INSET_MAX, DISPLAY_SIZE_MAX, DISPLAY_SIZE_MIN } from './persist.ts'
+import { mountOnce } from './mount-once.ts'
 
 export { PetService, MAX_SESSION_BUBBLES } from './service.ts'
 export type {
@@ -137,7 +138,9 @@ export function makePetSettingsSchema(fallbackPetId: string) {
 }
 
 /** Register the pet service and its API + asset routes on the context. */
-export function apply(ctx: Context, config: PetConfig = {}): void {
+export const apply = mountOnce('@linxin666/dsh-pet', applyImpl)
+
+function applyImpl(ctx: Context, config: PetConfig = {}): void {
   const registry = config.registry
     ?? loadPetRegistry({
       packageRoot: petPackageRoot(import.meta.url),