@clowder-ai/companion 0.1.0-alpha.6 → 0.1.0-alpha.8

package/NOTICE

@@ -1,7 +1,12 @@
-Companion imagery and theme tokens originate in Clowder AI (MIT).
-See source-lock.json for the exact public source revision and content hashes.
+The original companion atlases and theme tokens originate in Clowder AI (MIT).
+See source-lock.json for their exact public source revision and content hashes.
 The legacy ragdoll-v1 and yarn-ball stills are AI-assisted derivatives of the
 listed public reference, restoring the complete cat silhouette and transparent
 background. Their reference and resulting hashes are recorded separately.
+The living Xianxian layers and clips are F317 assets: CVO-generated source video,
+keyframes by codex-astra, and deterministic extraction/alignment by opus55.
+source-lock.json pins the 20 bundled distributable files, their geometry file,
+and the source package manifest digest. Source video and private workspace paths
+are not bundled.
 The conversation transport and controls continue the F317 companion implementation
 by the Clowder AI contributors. No private runtime data or pet metadata is included.

package/README.md

@@ -17,15 +17,22 @@ No second transcript database, credentials or selectable Host identity live here
 
 ## Host integration
 
-This surface requires the additive desktop bridge **1.1.0**. The Host computes
+This surface requires the additive desktop bridge **1.3.0**. The Host computes
 placement within the display work area, keeps the cat as its stable anchor, and
 owns bounded drag gestures and transparent-area hit testing. Older 1.0-only
 Hosts reject this manifest before installation. Media admission and capture
 remain in the trusted Host; this package receives neither streams nor provider
 SDP. Hiding releases media; the existing Clowder **聊聊** entry restores the cat.
 
-The original animated skin bytes remain unchanged. Public static skin derivatives
-and the shared color tokens retain their exact provenance in `source-lock.json`.
+Xianxian uses one layered sitting body or one VP9 clip at a time. Actual Host
+activity, durable answers and owner-scoped pending decisions select thought,
+delivery and waiting actions. Dragging selects the running clip; an explicit
+play gesture selects pounce. Reduced motion keeps the body static. Other cats
+retain their own skins. The v2 living assets and their hashes are pinned in
+`source-lock.json`; the installable renderer carries all 20 assets itself.
+
+The Host keeps a small transparent margin left of the pet hit target so the
+pounce's tail is visible without turning empty space into a click target.
 
 ## Verification
 

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "pluginId": "official.companion",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "contractVersion": "0.1.0",
   "name": "猫猫球",
   "icon": {
@@ -40,7 +40,7 @@
       "bridgeVersion": "1.3.0",
       "surface": {
         "entrypoint": "renderer/index.html",
-        "integrity": "sha256-s7/ld37FUql3GVoL0uRSVMJnL8IcY3S22GQEYGlvGJ0="
+        "integrity": "sha256-I7pGRaZJIHoBrsk0si+5MAm7VCAjc3AzQNjeo+ra3Is="
       },
       "presentation": {
         "width": 300,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clowder-ai/companion",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "description": "The desktop voice body for your Clowder companion",
   "license": "MIT",
   "type": "module",

package/plugin.yaml

@@ -1,6 +1,6 @@
 {
   "pluginId": "official.companion",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "contractVersion": "0.1.0",
   "name": "猫猫球",
   "icon": {
@@ -40,7 +40,7 @@
       "bridgeVersion": "1.3.0",
       "surface": {
         "entrypoint": "renderer/index.html",
-        "integrity": "sha256-s7/ld37FUql3GVoL0uRSVMJnL8IcY3S22GQEYGlvGJ0="
+        "integrity": "sha256-I7pGRaZJIHoBrsk0si+5MAm7VCAjc3AzQNjeo+ra3Is="
       },
       "presentation": {
         "width": 300,

package/renderer/index.html

@@ -13,7 +13,27 @@
   </svg>
   <main id="desktop" aria-label="猫猫球">
     <div id="anchor">
-      <button id="pet" aria-label="猫猫：点击交流，右键更多，拖动移动" aria-expanded="false" aria-controls="actions menu chat"></button>
+      <button id="pet" aria-label="猫猫：点击交流，右键更多，拖动移动" aria-expanded="false" aria-controls="actions menu chat">
+        <svg id="living-sit" viewBox="0 0 600 600" aria-hidden="true" hidden>
+          <defs>
+            <mask id="living-eye-left" maskUnits="userSpaceOnUse" x="0" y="0" width="600" height="600"><image href="./skins/xianxian-living/layers/whiteL.webp" width="600" height="600"/></mask>
+            <mask id="living-eye-right" maskUnits="userSpaceOnUse" x="0" y="0" width="600" height="600"><image href="./skins/xianxian-living/layers/whiteR.webp" width="600" height="600"/></mask>
+          </defs>
+          <g data-layer="tail"><image href="./skins/xianxian-living/layers/tail.webp" width="600" height="600"/></g>
+          <image href="./skins/xianxian-living/layers/body.webp" width="600" height="600"/>
+          <g data-layer="head">
+            <g data-layer="ear-left"><image href="./skins/xianxian-living/layers/earL.webp" width="600" height="600"/></g>
+            <g data-layer="ear-right"><image href="./skins/xianxian-living/layers/earR.webp" width="600" height="600"/></g>
+            <image href="./skins/xianxian-living/layers/head.webp" width="600" height="600"/>
+            <g mask="url(#living-eye-left)"><image data-layer="iris-left" href="./skins/xianxian-living/layers/irisL.webp" width="600" height="600"/></g>
+            <g mask="url(#living-eye-right)"><image data-layer="iris-right" href="./skins/xianxian-living/layers/irisR.webp" width="600" height="600"/></g>
+            <image data-layer="closed" href="./skins/xianxian-living/layers/closed.webp" width="600" height="600"/>
+            <image data-layer="mouth" href="./skins/xianxian-living/layers/mouth.webp" width="600" height="600"/>
+            <image data-layer="scared" href="./skins/xianxian-living/layers/scared.webp" width="600" height="600"/>
+          </g>
+        </svg>
+        <video id="living-video" muted playsinline preload="metadata" aria-hidden="true" hidden></video>
+      </button>
       <div id="indicators">
         <button id="call-badge" hidden aria-label="结束语音" title="结束语音"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="9" y="3" width="6" height="12" rx="3"/><path d="M5 11a7 7 0 0 0 14 0M12 18v4M8 22h8"/></svg></button>
         <button id="share-badge" hidden aria-label="停止共享" title="停止共享"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="3" y="4" width="18" height="13" rx="2"/><path d="M8 21h8M12 17v4"/></svg></button>
@@ -40,6 +60,7 @@
       <button data-action="history"><svg class="icon" aria-hidden="true"><use href="#i-history"/></svg><span>聊天记录</span></button>
       <button data-action="decisions"><span aria-hidden="true">◇</span><span>待你看</span><span id="menu-pending" class="menu-status">—</span></button>
       <button data-action="write"><svg class="icon" aria-hidden="true"><use href="#i-keyboard"/></svg><span>打字</span></button>
+      <button id="menu-play" data-action="play" hidden><span aria-hidden="true">✦</span><span>逗宪宪</span></button>
       <div class="menu-divider" role="separator"></div>
       <button id="speaker" data-action="speaker" hidden><svg class="icon" aria-hidden="true"><use href="#i-mic"/></svg><span class="label">关闭播音</span></button>
       <button id="menu-share" data-action="share" title="语音连接后可共享画面"><svg class="icon" aria-hidden="true"><use href="#i-screen"/></svg><span class="label">共享画面</span></button>

package/renderer/living-body.mjs

@@ -0,0 +1,84 @@
+// F317 living Xianxian package v1. All clips share the layered sit's ground line.
+// Values are the package-v1 CSS anchors scaled from its 290px stage to the Host pet.
+const scale = 120 / 290;
+const groundY = 10 + 262.5 * scale;
+const clips = {
+  'running-left': { name: 'trot', size: [265, 236], ground: 234.8, centre: 132.5, loop: true },
+  'running-right': { name: 'trot', size: [265, 236], ground: 234.8, centre: 132.5, loop: true },
+  running: { name: 'trot', size: [265, 236], ground: 234.8, centre: 132.5, loop: true },
+  play: { name: 'pounce', size: [304.8, 312.6], ground: 303.9, centre: 201.9, rate: 1.5 },
+  sleeping: { name: 'sleep', size: [468.5, 262.1], ground: 256.4, centre: 238.9, loop: true },
+  waking: { name: 'wake', size: [468.5, 262.1], ground: 256.4, centre: 238.9 },
+  peek: { name: 'peek', size: [153.5, 234.3], ground: 234.3, centre: 76.75, loop: true },
+  review: { name: 'carry', size: [344.3, 290.9], ground: 263, centre: 198.3 },
+  pending_decision: { name: 'wait', size: [197.9, 252.8], ground: 249.6, centre: 98.4, loop: true },
+  working: { name: 'think', size: [266.4, 256.9], ground: 253.7, centre: 132.1, loop: true },
+  staged_thought: { name: 'think', size: [266.4, 256.9], ground: 253.7, centre: 132.1, loop: true },
+};
+export const isLivingClip = action => Object.hasOwn(clips, action);
+const setHidden = (node, hidden) => {
+  // SVGElement.hidden is not consistently reflected to the HTML hidden
+  // attribute; the renderer's [hidden] rule reads the attribute itself.
+  node.toggleAttribute?.('hidden', hidden);
+  node.hidden = hidden;
+};
+
+/** One visible body: a layered sit or one muted clip, never both. */
+export class LivingBody {
+  constructor({ root, sit, video }) {
+    this.root = root;
+    this.sit = sit;
+    this.video = video;
+    this.action = '';
+    this.revision = 0;
+  }
+  show(action, { reducedMotion = false, onEnded = () => {} } = {}) {
+    const dockEdge = this.root.dataset.dockEdge;
+    if (this.action === action && this.reducedMotion === reducedMotion && this.dockEdge === dockEdge) return;
+    this.action = action;
+    this.reducedMotion = reducedMotion;
+    this.dockEdge = dockEdge;
+    const revision = ++this.revision;
+    const clip = !reducedMotion && clips[action];
+    this.root.dataset.pose = action === 'failed' ? 'scared' : action === 'waiting' ? 'listening' :
+      action === 'sleeping' ? 'sleeping' : action === 'pending_decision' ? 'pending' : 'sit';
+    this.root.dataset.direction = action === 'running-left' || (action === 'peek' && this.root.dataset.dockEdge === 'left') ? 'left' : 'right';
+    this.video.onended = null;
+    this.video.pause();
+    if (!clip) {
+      setHidden(this.video, true);
+      setHidden(this.sit, false);
+      return;
+    }
+    this.video.src = `./skins/xianxian-living/clips/${clip.name}.webm`;
+    this.video.loop = clip.loop === true;
+    this.video.playbackRate = clip.rate ?? 1;
+    this.video.style.width = `${clip.size[0] * scale}px`;
+    this.video.style.height = `${clip.size[1] * scale}px`;
+    this.video.style.left = action === 'peek'
+      ? `${this.root.dataset.dockEdge === 'left' ? -32 : 128 - clip.size[0] * scale}px`
+      : `${60 - clip.centre * scale}px`;
+    this.video.style.top = `${action === 'peek' ? 138 - clip.size[1] * scale : groundY - clip.ground * scale}px`;
+    try { this.video.currentTime = 0; } catch { /* New source is not yet seekable. */ }
+    this.video.onended = () => { if (revision === this.revision) onEnded(); };
+    setHidden(this.sit, true);
+    setHidden(this.video, false);
+    void this.video.play().catch(() => {
+      if (revision !== this.revision) return;
+      setHidden(this.video, true);
+      setHidden(this.sit, false);
+      onEnded();
+    });
+  }
+  close() {
+    this.revision++;
+    this.video.onended = null;
+    this.video.pause();
+  }
+  hide() {
+    this.close();
+    setHidden(this.video, true);
+    setHidden(this.sit, true);
+    this.action = '';
+  }
+}

package/renderer/living-edge.mjs

@@ -0,0 +1,10 @@
+/** Observe the Host window's current screen; never select or move a display. */
+export function detectDockedEdge(win, petRect) {
+  const left = win.screen?.availLeft;
+  const width = win.screen?.availWidth;
+  if (![win.screenX, left, width, petRect.left, petRect.width].every(Number.isFinite) || width <= 0) return null;
+  const petLeft = win.screenX + petRect.left;
+  if (petLeft - left <= 40) return 'left';
+  if (left + width - petLeft - petRect.width <= 40) return 'right';
+  return null;
+}

package/renderer/pet-motion.mjs

@@ -1,3 +1,5 @@
+import { isLivingClip } from './living-body.mjs';
+
 // F229 pet.json frame durations, plus the three F258 rows pinned in source-lock.json.
 const atlas = {
   idle: { row: 0, frames: [1200, 400, 400, 500, 500, 800] },
@@ -15,7 +17,7 @@ const additional = {
   working: { file: 'xianxian-working-row.png', frames: [520, 560, 520, 640, 520, 560, 520, 640] },
   staged_thought: { file: 'xianxian-staged-thought-row.png', frames: [1200, 500, 700, 900, 1200, 500] },
 };
-const signals = { connected: 'waving', received: 'jumping', answered: 'review', failed: 'failed' };
+const signals = { connected: 'waving', received: 'jumping', answered: 'review', failed: 'failed', play: 'play' };
 const staticSkins = { 'ragdoll-v1': 'ragdoll-v1.png', 'yarn-ball': 'yarn-ball.png' };
 
 /** All animation choices come from Host state or a completed local gesture. */
@@ -26,6 +28,7 @@ export class PetMotion {
     const clearTimer = options.clearTimer ?? globalThis.clearTimeout;
     this.setTimer = (callback, delay) => setTimer.call(globalThis, callback, delay);
     this.clearTimer = id => clearTimer.call(globalThis, id);
+    this.livingBody = options.livingBody;
     this.reducedMotion = options.reducedMotion ?? globalThis.matchMedia?.('(prefers-reduced-motion: reduce)').matches ?? false;
     this.skin = 'xianxian-codex';
     this.phase = 'idle';
@@ -34,25 +37,51 @@ export class PetMotion {
     this.frame = 0;
     this.moving = false;
     this.oneShot = false;
+    this.pendingDecision = false;
+    this.dockedEdge = null;
   }
   setContext({ skin, phase, nativeActivity, muted }) {
+    this.context = { skin, phase, nativeActivity, muted };
     const selectedSkin = ['xianxian-codex', 'yanyan-codex', ...Object.keys(staticSkins)].includes(skin) ? skin : 'xianxian-codex';
     const changedSkin = selectedSkin !== this.skin;
     const changedPhase = phase !== this.phase;
     this.skin = selectedSkin;
     this.phase = phase;
-    const requested = nativeActivity === 'tool_running' ? 'working' : nativeActivity === 'reasoning' ? 'staged_thought'
-      : ['talking', 'connecting'].includes(phase) && !muted ? 'waiting' : 'idle';
+    const requested = this.pendingDecision ? 'pending_decision' : nativeActivity === 'tool_running' ? 'working' : nativeActivity === 'reasoning' ? 'staged_thought'
+      : ['talking', 'connecting'].includes(phase) && !muted ? 'waiting' : this.dockedEdge ? 'peek' : 'idle';
     const nextBase = this.resolve(requested);
     const changedBase = nextBase !== this.base;
     this.base = nextBase;
     if (phase !== 'idle') this.cancelRest();
     if (phase === 'idle' && changedPhase) { this.moving = false; this.oneShot = false; }
-    if (!this.moving && !this.oneShot && (changedSkin || changedBase || changedPhase || !this.action)) this.play(this.base);
+    const waking = this.living() && !this.reducedMotion && this.action === 'sleeping' && this.base === 'waiting';
+    if (waking) { this.oneShot = true; this.play('waking'); }
+    else if (this.oneShot && this.action === 'waking' && ['working', 'staged_thought', 'pending_decision'].includes(this.base)) {
+      this.oneShot = false;
+      this.play(this.base);
+    } else if (!this.moving && !this.oneShot && (changedSkin || changedBase || changedPhase || !this.action)) this.play(this.base, changedSkin);
     if (phase === 'idle' && this.action === 'idle') this.armRest();
   }
+  setPendingDecision(value) {
+    if (this.pendingDecision === value) return;
+    this.pendingDecision = value;
+    if (this.context) this.setContext(this.context);
+    if (value === true && this.oneShot) {
+      this.oneShot = false;
+      this.play(this.base);
+    }
+  }
+  setDockedEdge(value) {
+    const edge = ['left', 'right'].includes(value) ? value : null;
+    if (this.dockedEdge === edge) return;
+    const previous = this.dockedEdge;
+    this.dockedEdge = edge;
+    if (this.context) this.setContext(this.context);
+    if (previous && edge && this.action === 'peek') this.play('peek', true);
+  }
   signal(kind) {
-    const requested = signals[kind];
+    const requested = kind === 'received' && this.living() && this.action === 'sleeping' ? 'waking' : signals[kind];
+    if (kind === 'play' && (this.pendingDecision || this.phase !== 'idle' || this.context?.nativeActivity !== 'none')) return;
     if (!requested || this.moving || this.reducedMotion || staticSkins[this.skin]) return;
     this.cancelRest();
     this.oneShot = true;
@@ -71,15 +100,18 @@ export class PetMotion {
     this.play(this.base);
     if (this.phase === 'idle') this.armRest();
   }
-  close() { this.cancelFrame(); this.cancelRest(); }
+  close() { this.cancelFrame(); this.cancelRest(); this.livingBody?.close(); }
+  living() { return this.skin === 'xianxian-codex' && Boolean(this.livingBody); }
   resolve(action) {
+    if (action === 'pending_decision' && !this.living()) return 'waiting';
+    if (action === 'peek' && !this.living()) return 'idle';
     if (staticSkins[this.skin]) return 'idle';
     if (this.skin !== 'xianxian-codex' && action in additional)
       return action === 'sleeping' ? 'idle' : 'review';
     return action;
   }
-  play(action) {
-    if (this.action === action) return;
+  play(action, force = false) {
+    if (this.action === action && !force) return;
     this.cancelFrame();
     this.action = action;
     this.frame = 0;
@@ -90,6 +122,13 @@ export class PetMotion {
     const { style, dataset } = this.element;
     dataset.skin = this.skin;
     dataset.action = this.action;
+    dataset.dockEdge = this.dockedEdge ?? 'none';
+    if (this.living()) {
+      style.backgroundImage = 'none';
+      this.livingBody.show(this.action, { reducedMotion: this.reducedMotion, onEnded: () => this.completeOneShot() });
+      return;
+    }
+    this.livingBody?.hide();
     const staticFile = staticSkins[this.skin];
     if (staticFile) {
       style.backgroundImage = `url("./skins/${staticFile}")`;
@@ -104,6 +143,11 @@ export class PetMotion {
   }
   scheduleFrame() {
     if (this.reducedMotion || staticSkins[this.skin]) return;
+    if (this.living()) {
+      if (isLivingClip(this.action) || !this.oneShot) return;
+      this.frameTimer = this.setTimer(() => { this.frameTimer = undefined; this.completeOneShot(); }, 700);
+      return;
+    }
     const frames = additional[this.action]?.frames ?? atlas[this.action]?.frames;
     if (!frames) return;
     this.frameTimer = this.setTimer(() => {
@@ -121,8 +165,15 @@ export class PetMotion {
     }, frames[this.frame]);
   }
   cancelFrame() { if (this.frameTimer !== undefined) this.clearTimer(this.frameTimer); this.frameTimer = undefined; }
+  completeOneShot() {
+    if (!this.oneShot) return;
+    this.oneShot = false;
+    this.action = '';
+    this.play(this.base);
+    if (this.phase === 'idle') this.armRest();
+  }
   armRest() {
-    if (this.restTimer !== undefined || this.action === 'sleeping') return;
+    if (this.restTimer !== undefined || this.action === 'sleeping' || this.pendingDecision || this.dockedEdge) return;
     this.restTimer = this.setTimer(() => {
       this.restTimer = undefined;
       if (this.phase === 'idle' && !this.moving && !this.oneShot) this.play(this.resolve('sleeping'));

package/renderer/skins/xianxian-living/layers/meta.json

@@ -0,0 +1,88 @@
+{
+ "canvas": 600,
+ "tailPivot": [
+  168.1,
+  456.1
+ ],
+ "earPivotL": [
+  218.9,
+  101.4
+ ],
+ "earPivotR": [
+  391.0,
+  100.2
+ ],
+ "neckPivot": [
+  300.0,
+  280.4
+ ],
+ "irisL": [
+  231.1,
+  156.5,
+  285.6,
+  213.4
+ ],
+ "irisR": [
+  339.7,
+  154.5,
+  388.0,
+  211.0
+ ],
+ "whiteL": [
+  230.6,
+  156.5,
+  294.3,
+  221.1
+ ],
+ "whiteR": [
+  331.1,
+  154.5,
+  391.4,
+  219.6
+ ],
+ "tail": [
+  47.8,
+  313.4,
+  178.9,
+  507.2
+ ],
+ "earL": [
+  169.4,
+  26.8,
+  258.4,
+  140.7
+ ],
+ "earR": [
+  345.9,
+  20.1,
+  437.8,
+  140.7
+ ],
+ "mouth": [
+  286.6,
+  221.5,
+  343.1,
+  256.9
+ ],
+ "areas_native": {
+  "tail": 78634,
+  "earL": 23228,
+  "earR": 23149,
+  "fearL": 9568,
+  "fearR": 9138,
+  "irisL": 7903,
+  "irisR": 7624,
+  "whiteL": 10967,
+  "whiteR": 10974,
+  "mouth": 4342
+ },
+ "collarTop_native": 580,
+ "sitFloorNative": 1135,
+ "runCropNative": [
+  27,
+  181,
+  1220,
+  1022
+ ],
+ "runFloorNative": 1016
+}

package/renderer/style.css

@@ -12,6 +12,34 @@ button:disabled { opacity: .45; cursor: default; }
 #anchor { position: absolute; left: 8px; top: 8px; width: 120px; height: 130px; }
 #pet { width: 120px; height: 130px; display: block; border: 0; padding: 0; background: url("./skins/xianxian-codex.webp") 0 0 / 960px 1170px; filter: drop-shadow(0 6px 4px #0002); touch-action: none; cursor: grab; }
 #pet.dragging { cursor: grabbing; }
+#pet[data-skin="xianxian-codex"] { position: relative; background-image: none; overflow: visible; }
+#living-sit { position: absolute; left: 0; bottom: 10px; width: 120px; height: 120px; overflow: visible; pointer-events: none; }
+#living-video { position: absolute; object-fit: fill; pointer-events: none; }
+#pet[data-direction="left"] #living-video { transform: scaleX(-1); }
+#living-sit [data-layer="tail"] { transform-box: view-box; transform-origin: 168px 456px; animation: living-tail 3.4s ease-in-out infinite; }
+#living-sit [data-layer="head"] { transform-box: view-box; transform-origin: 300px 280px; animation: living-head 5.5s ease-in-out infinite; }
+#living-sit [data-layer="ear-left"], #living-sit [data-layer="ear-right"] { transform-box: view-box; }
+#living-sit [data-layer="ear-left"] { transform-origin: 219px 101px; }
+#living-sit [data-layer="ear-right"] { transform-origin: 391px 100px; }
+#pet[data-pose="listening"] #living-sit [data-layer="ear-left"] { transform: rotate(-8deg); }
+#pet[data-pose="listening"] #living-sit [data-layer="ear-right"] { transform: rotate(8deg); }
+#living-sit [data-layer="closed"] { opacity: 0; animation: living-blink 5.8s linear infinite; }
+#pet[data-action="idle"] #living-sit [data-layer="tail"] { animation: living-idle-tail 4.8s ease-in-out infinite; }
+#pet[data-action="idle"] #living-sit [data-layer="head"] { animation: living-idle-head 6.8s ease-in-out infinite; }
+#pet[data-action="idle"] #living-sit [data-layer="ear-left"] { animation: living-idle-ear-left 8.1s ease-in-out infinite; }
+#pet[data-action="idle"] #living-sit [data-layer="ear-right"] { animation: living-idle-ear-right 7.3s ease-in-out infinite; }
+#pet[data-action="idle"] #living-sit [data-layer="closed"] { animation: living-idle-blink 5.8s steps(1, end) infinite; }
+#living-sit [data-layer="mouth"], #living-sit [data-layer="scared"] { opacity: 0; }
+#pet[data-pose="scared"] #living-sit [data-layer="scared"] { opacity: 1; }
+#pet[data-pose="sleeping"] #living-sit [data-layer="closed"] { opacity: 1; animation: none; }
+@keyframes living-tail { 50% { transform: rotate(5deg); } }
+@keyframes living-head { 50% { transform: rotate(2deg); } }
+@keyframes living-blink { 0%, 96%, 100% { opacity: 0; } 97%, 98% { opacity: 1; } }
+@keyframes living-idle-tail { 0%, 12%, 100% { transform: rotate(0); } 34% { transform: rotate(10deg); } 62% { transform: rotate(-8deg); } 80% { transform: rotate(3deg); } }
+@keyframes living-idle-head { 0%, 12%, 100% { transform: rotate(0); } 35% { transform: rotate(5deg); } 69% { transform: rotate(-3deg); } }
+@keyframes living-idle-ear-left { 0%, 68%, 76%, 100% { transform: rotate(0); } 71% { transform: rotate(-9deg); } 73% { transform: rotate(3deg); } }
+@keyframes living-idle-ear-right { 0%, 30%, 39%, 100% { transform: rotate(0); } 33% { transform: rotate(8deg); } 36% { transform: rotate(-3deg); } }
+@keyframes living-idle-blink { 0%, 24%, 30%, 74%, 80%, 100% { opacity: 0; } 25%, 29%, 75%, 79% { opacity: 1; } }
 #indicators { position: absolute; bottom: 0; right: 0; display: flex; gap: 4px; }
 #indicators button { width: 32px; height: 32px; border: 1px solid #fff9; border-radius: 50%; display: grid; place-items: center; background: #236b59; color: white; box-shadow: 0 2px 5px #0003; }
 #indicators button:hover { background: #ab4842; }
@@ -50,18 +78,22 @@ button:disabled { opacity: .45; cursor: default; }
 #chat header button { font-size: 12px; color: var(--cafe-text-secondary); }
 #transcript { height: 145px; overflow: auto; padding: 14px; line-height: 1.7; }
 #transcript p { margin: 0 0 10px; overflow-wrap: anywhere; white-space: pre-wrap; }
-#transcript p:not(.empty) { background: var(--accent-50); padding: 7px 10px; border-radius: 9px; }
+#transcript p:not(.empty) { width: fit-content; max-width: 92%; padding: 7px 10px; border-radius: 9px; }
+#transcript p.user { margin-left: auto; background: var(--accent-50); }
+#transcript p.assistant { margin-right: auto; background: var(--cafe-surface); border: 1px solid var(--cafe-border-subtle); }
 .empty { color: var(--cafe-text-muted); font-size: 13px; }
 #compose { display: flex; align-items: flex-end; padding: 10px; gap: 8px; border-top: 1px solid var(--cafe-border-subtle); }
 #message { resize: none; border: 0; min-width: 0; flex: 1; background: transparent; padding: 5px; color: inherit; line-height: 1.5; }
 #chat small { color: var(--cafe-text-muted); font-size: 10px; padding: 0 14px 10px; }
 .sr-only { position: absolute; width: 1px; height: 1px; clip-path: inset(50%); overflow: hidden; }
-@media (prefers-reduced-motion: reduce) { #pet, #indicators button { animation: none; } }
+@media (prefers-reduced-motion: reduce) {
+  #pet, #indicators button, #living-sit [data-layer], #pet[data-action="idle"] #living-sit [data-layer] { animation: none; }
+  #living-sit [data-layer="closed"] { opacity: 0; }
+}
 #pet[data-skin="yanyan-codex"] { background-image: url("./skins/yanyan-codex.webp"); }
 #pet[data-skin="ragdoll-v1"] { background-image: url("./skins/ragdoll-v1.png"); animation: none; background-size: contain; background-repeat: no-repeat; background-position: center; }
 #pet[data-skin="yarn-ball"] { background-image: url("./skins/yarn-ball.png"); animation: none; background-size: contain; background-repeat: no-repeat; background-position: center; }
 #transcript { height: 230px; font-size: 13px; }
-#transcript .assistant { background: transparent; }
 #transcript p[data-author]::before { content: attr(data-author); display: block; color: var(--cafe-text-muted); font-size: 10px; margin-bottom: 2px; }
 #transcript p[data-live="true"] { border-left: 2px solid var(--cafe-accent); }
 #history { padding: 0; font-size: 10px; color: var(--cafe-text-secondary); }

package/renderer/surface.mjs

@@ -6,6 +6,8 @@ import { ScreenShare } from './screen-share.mjs';
 import { TranscriptView } from './transcript-view.mjs';
 import { RecentBubble } from './recent-bubble.mjs';
 import { PetMotion } from './pet-motion.mjs';
+import { LivingBody } from './living-body.mjs';
+import { detectDockedEdge } from './living-edge.mjs';
 import { bindPetControls } from './pet-controls.mjs';
 import { decisionBadge, decisionRows } from './decision-view.mjs';
 
@@ -14,10 +16,14 @@ const label = (id, text) => { $(id).querySelector('.label').textContent = text;
 const status = text => { $('status').textContent = text; $('chat-status').textContent = text; $('announcement').textContent = text; };
 const transcript = new TranscriptView($('transcript'));
 const bubble = new RecentBubble([$('bubble-first'), $('bubble-second')]);
-const motion = new PetMotion($('pet'));
+const motion = new PetMotion($('pet'), { livingBody: new LivingBody({ root: $('pet'), sit: $('living-sit'), video: $('living-video') }) });
 let sharing = false, pendingScreen = false, loading = false, latestHistory, previousPhase = 'idle';
+let observedHistory = false, lastAssistantId;
+let resultPreviewUntil = 0;
+let didMove = false;
 let decisionLoading = false, decisionOffset = 0;
 let threadTitle;
+const showAmbient = active => (active || Date.now() < resultPreviewUntil) && bubble.hasContent();
 
 if (!window.clowderCompanion) {
   $('actions').hidden = false; $('status').hidden = false;
@@ -27,7 +33,13 @@ if (!window.clowderCompanion) {
   const client = createCompanionClient(window.clowderCompanion);
   const controls = bindPetControls(client, {
     error: error => status(explainError(error)),
-    moved: (dx, dy) => dx === 'stop' ? motion.stopMove() : motion.move(dx, dy),
+    moved: (dx, dy) => {
+      if (dx !== 'stop') { didMove = true; motion.move(dx, dy); return; }
+      motion.stopMove();
+      if (!didMove) return;
+      didMove = false;
+      setTimeout(() => motion.setDockedEdge(detectDockedEdge(window, $('pet').getBoundingClientRect())), 100);
+    },
     changed: panel => { if (panel === 'chat') void readHistory(); if (panel === 'decisions') void readDecisions(); },
     action(kind) {
       if (kind === 'begin') { transcript.reset(); bubble.reset(); void conversation.begin(); void controls.show('none'); }
@@ -37,6 +49,10 @@ if (!window.clowderCompanion) {
       if (kind === 'share') toggleScreen();
       if (kind === 'documents') void conversation.documents(conversation.identity?.documentsAllowed === false);
       if (kind === 'hide') void client.hide().catch(error => status(explainError(error)));
+      if (kind === 'play' && conversation.identity?.skin === 'xianxian-codex') {
+        void controls.show('none');
+        motion.signal('play');
+      }
     },
   });
   const screen = new ScreenShare({
@@ -73,7 +89,7 @@ if (!window.clowderCompanion) {
       if (previousPhase !== 'idle' && value.phase === 'idle') { transcript.reset(); bubble.reset(); void readHistory(); }
       previousPhase = value.phase;
       const active = value.phase !== 'idle';
-      void controls.setAmbient(active && bubble.hasContent());
+      void controls.setAmbient(showAmbient(active));
       $('begin').hidden = active; $('begin').disabled = !value.identity;
       label('begin', value.failed ? '重试语音' : '语音聊');
       $('mic').hidden = value.phase !== 'talking'; $('speaker').hidden = !active;
@@ -93,6 +109,7 @@ if (!window.clowderCompanion) {
       if (justConnected) motion.signal('connected');
       if (showFailure) motion.signal('failed');
       if (identity) {
+        $('menu-play').hidden = identity.skin !== 'xianxian-codex';
         $('chat-name').textContent = threadTitle ?? identity.displayName; $('menu-name').textContent = identity.displayName;
         $('pet').setAttribute('aria-label', `${identity.displayName}：点击交流，右键更多，拖动移动`);
         $('documents').querySelector('.menu-status').textContent = identity.documentsAllowed ? '开启' : '暂停';
@@ -103,15 +120,22 @@ if (!window.clowderCompanion) {
     },
   });
   async function readHistory() {
-    if (loading || (controls.panel !== 'chat' && conversation.phase === 'idle')) return;
+    if (loading) return;
     loading = true;
     try {
       const history = await client.readConversation();
+      const assistantId = history.messages.findLast(message => message.role === 'assistant')?.id;
+      if (observedHistory && assistantId && assistantId !== lastAssistantId) {
+        motion.signal('answered');
+        resultPreviewUntil = Date.now() + 12_000;
+      }
+      observedHistory = true;
+      lastAssistantId = assistantId;
       $('history').textContent = history.hasMore ? '更早聊天 ↗' : '完整聊天 ↗';
       threadTitle = history.threadTitle;
       $('chat-name').textContent = threadTitle;
       bubble.load(history.messages);
-      void controls.setAmbient(conversation.phase !== 'idle' && bubble.hasContent());
+      void controls.setAmbient(showAmbient(conversation.phase !== 'idle'));
       const serialized = JSON.stringify(history.messages);
       if (serialized !== latestHistory) { latestHistory = serialized; transcript.load(history.messages); }
     } catch { $('chat-status').textContent = '聊天记录暂未更新 · 正在说的话仍会显示'; }
@@ -133,6 +157,7 @@ if (!window.clowderCompanion) {
       const page = await client.readDecisions(more ? decisionOffset : 0, 10);
       if (page.status !== 'available') throw new Error('Decision source unavailable');
       showDecisionBadge(page);
+      motion.setPendingDecision(page.approvalCount + page.otherNeedsMeCount > 0);
       if (controls.panel !== 'decisions') return;
       const list = $('decision-list');
       if (!more) { list.replaceChildren(); list.scrollTop = 0; }
@@ -165,6 +190,7 @@ if (!window.clowderCompanion) {
       $('decision-more').hidden = !page.page.hasMoreApprovals && !page.page.hasMoreNeedsMe;
     } catch {
       showDecisionBadge(undefined);
+      motion.setPendingDecision(null);
       if (controls.panel === 'decisions') $('decision-status').textContent = '待决事项暂不可读 · 请稍后刷新';
     } finally { decisionLoading = false; }
   }
@@ -191,7 +217,7 @@ if (!window.clowderCompanion) {
   const statusMonitor = setInterval(() => void conversation.refresh(), 1000);
   const historyMonitor = setInterval(() => void readHistory(), 3000);
   const decisionMonitor = setInterval(() => { if (controls.panel !== 'decisions') void readDecisions(); }, 15000);
-  void conversation.refresh(); void readDecisions(); void controls.show('none');
+  void conversation.refresh(); void readHistory(); void readDecisions(); void controls.show('none');
   window.addEventListener('beforeunload', () => {
     clearInterval(statusMonitor); clearInterval(historyMonitor); clearInterval(decisionMonitor);
     unsubscribe(); motion.close(); void conversation.end();

package/source-lock.json

@@ -66,5 +66,96 @@
       "destination": "assets/skins/xianxian-staged-thought-row.png",
       "sha256": "e9286ce2c234911d9b45835849e1a2a853598d0d0260ecf7d24430a95847725f"
     }
-  ]
+  ],
+  "livingSkin": {
+    "package": "xianxian-living package-v2",
+    "manifestSha256": "08491ed557a82bc1860bbaeecd094f4a7e637479e78af8b411786f19a5164da0",
+    "creator": "opus55; keyframes by codex-astra; source videos by CVO",
+    "files": [
+      {
+        "destination": "assets/skins/xianxian-living/layers/body.webp",
+        "sha256": "39f8fae11b49d6fc8c7d0993a2ed867b6d863f1da580a711ff11d91aa8c6c233"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/head.webp",
+        "sha256": "18a7d34716448ceb70afd7b0e633ef6ab71c6717a96b73b8e39e7ee027d550cb"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/tail.webp",
+        "sha256": "d23c5c964e9084c6f44d4a6b8b42cbaff6678348bec87a8434a18967816cf4ff"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/earL.webp",
+        "sha256": "0d40004c7bbc592b76a4452c42740b6059697a1b313c9f9919bd16ef5a64b1d1"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/earR.webp",
+        "sha256": "1c2141ac3aa4d93ab4f4dfb14c5ec8c566db2e53444a730b008e00f65765b700"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/irisL.webp",
+        "sha256": "006b247e4fa8924b8f20198fc34d38a231dda0577ee45581a3d6d1fa74886533"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/irisR.webp",
+        "sha256": "929bd6c888860ac5ebe80f230a5793bc8c93b36eabdc9d18b3ef1fd7cb1ff095"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/whiteL.webp",
+        "sha256": "b4b2a539950376575ed9d61052b1a43f06812af6158244c86351d29ab935fde7"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/whiteR.webp",
+        "sha256": "9203fc92f5430d72deb56b1587a8cc79e9d7952fc6e5027adfc8507ed661a441"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/closed.webp",
+        "sha256": "adb354110fb952a3bb6d5f5fc11968b74c1cc2cf8d2e6dafc4b2b4ad7ca1d92b"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/mouth.webp",
+        "sha256": "f968f9afba93e6bf64a51e7c26f0ddfc2ed10fd18d65c38cf636b4e73eeb9b53"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/scared.webp",
+        "sha256": "1cb165fa0a116aea063b78aef64ac3d512d2ec71f0b3f169f57914aaa5a9f48a"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/trot.webm",
+        "sha256": "02660b4a57dfaca0e4b3d4a4d1e791715af8d01a831c56bd3ff9e30e4fc56900"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/pounce.webm",
+        "sha256": "65a380d993f53debb6ff761e586e9fdacce4cb2156c6bb461b4f3875926d5a00"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/sleep.webm",
+        "sha256": "e39554e7aca7b1c51b388b73f7dbc08e3fa7ddafef395cb28c1099d41a9b41d8"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/wake.webm",
+        "sha256": "73b455088e53edf2849e888e0ecb99953f7e5dba373592fb6232f9736b6da3a0"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/peek.webm",
+        "sha256": "adebecf89b724eec9852d097364e10bc328d006ce3bb3bd3f4b257c095d57a92"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/carry.webm",
+        "sha256": "4fa582ab6a18b538cfe815ab19e73da30c0da061ec661bb12e4060f8b3d2e600"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/wait.webm",
+        "sha256": "5e2a41e967eed178b8e540231e0b1733bbc388f955204a7b0b76b2aa7cfc4e45"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/clips/think.webm",
+        "sha256": "4ba9fa0f38076a4abd0d664dc75287b76def7b340dc763b6aab4ea15bbe8abc1"
+      },
+      {
+        "destination": "assets/skins/xianxian-living/layers/meta.json",
+        "sha256": "92fe5571b2f4b78c1138e199aaa29bb523b6f6ad7ab346fbd6407c8b557e220f"
+      }
+    ]
+  }
 }