mocode-pet-app 1.3.0 → 1.6.0

package/dist/assets/pets/09-robo-penguin.svg

@@ -36,11 +36,11 @@
   </g>
 
   <!-- Beak -->
-  <path d="M116 156 L128 172 L140 156 Z" fill="#ffb74d"/>
+  <path id="pet-mouth" d="M116 156 L128 172 L140 156 Z" fill="#ffb74d"/>
 
   <!-- Flipper arms(填充块面而非线条,贴身收成圆润小翼) -->
-  <path d="M42 146 Q16 162 22 190 Q26 204 42 202 Q50 200 46 188 Q40 168 46 150 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2"/>
-  <path d="M214 146 Q240 162 234 190 Q230 204 214 202 Q206 200 210 188 Q216 168 210 150 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2"/>
+  <path id="pet-arm-left" d="M42 146 Q16 162 22 190 Q26 204 42 202 Q50 200 46 188 Q40 168 46 150 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2"/>
+  <path id="pet-arm-right" d="M214 146 Q240 162 234 190 Q230 204 214 202 Q206 200 210 188 Q216 168 210 150 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2"/>
 
   <!-- Feet -->
   <ellipse cx="104" cy="234" rx="16" ry="8" fill="#ffb74d"/>

package/dist/assets/pets/10-robo-dino.svg

@@ -39,12 +39,12 @@
   </g>
 
   <!-- Jagged mouth -->
-  <path d="M108 148 L118 156 L128 148 L138 156 L148 148" stroke="#69f0ae" stroke-width="4" fill="none" stroke-linecap="round" filter="url(#glow)"/>
+  <path id="pet-mouth" d="M108 148 L118 156 L128 148 L138 156 L148 148" stroke="#69f0ae" stroke-width="4" fill="none" stroke-linecap="round" filter="url(#glow)"/>
 
   <!-- Small arms(填充块面而非线条,末端一颗圆球小手) -->
-  <ellipse cx="31" cy="142" rx="5.5" ry="15" fill="url(#accentGrad)" transform="rotate(-34 31 142)"/>
+  <ellipse id="pet-arm-left" cx="31" cy="142" rx="5.5" ry="15" fill="url(#accentGrad)" transform="rotate(-34 31 142)"/>
   <circle cx="25" cy="156" r="5" fill="url(#accentGrad)"/>
-  <ellipse cx="223" cy="142" rx="5.5" ry="15" fill="url(#accentGrad)" transform="rotate(34 223 142)"/>
+  <ellipse id="pet-arm-right" cx="223" cy="142" rx="5.5" ry="15" fill="url(#accentGrad)" transform="rotate(34 223 142)"/>
   <circle cx="231" cy="156" r="5" fill="url(#accentGrad)"/>
 
   <!-- Legs / feet -->

package/dist/assets/pets/11-slime-blob.motion.css

@@ -0,0 +1,44 @@
+/* 史莱姆(slime-blob)专属演出:利用"形变"这个史莱姆独有的视觉语言覆盖通用规则。
+ * 史莱姆没有 arm-left/right/tail 等 id,通用规则里依赖这些 id 的动画(如 tool_call 摆臂、
+ * flustered 摆臂)对它本来就不生效,这里改用挤压/压扁形变来填补对应状态的演出。 */
+
+/* ── mood-tired:身体压扁变矮,模拟疲惫瘫软,替代通用的"下沉" ── */
+@keyframes slime-tired-squash {
+  0%, 100% { transform: scaleY(1) scaleX(1); }
+  50% { transform: scaleY(0.82) scaleX(1.08); }
+}
+.mood-tired #pet-body-group {
+  animation: slime-tired-squash 3.6s ease-in-out infinite;
+  transform-origin: 128px 200px;
+}
+
+/* ── tool_call:挤压弹跳形变代替通用双臂摆动 ── */
+@keyframes slime-tool-bounce {
+  0%, 100% { transform: scaleY(1) scaleX(1); }
+  30% { transform: scaleY(0.85) scaleX(1.12); }
+  60% { transform: scaleY(1.12) scaleX(0.9); }
+}
+.pet-tool #pet-body-group {
+  animation: slime-tool-bounce 0.5s ease-in-out infinite;
+  transform-origin: 128px 200px;
+}
+
+/* ── idle:呼吸感的轻微鼓起收缩,比通用的上下浮动更软糯 ── */
+@keyframes slime-idle-breathe {
+  0%, 100% { transform: scale(1); }
+  50% { transform: scale(1.03); }
+}
+.pet-idle #pet-body-group {
+  animation: slime-idle-breathe 2.8s ease-in-out infinite;
+  transform-origin: 128px 138px;
+}
+
+/* ── mood-urging:急促地一颤一颤,像在催你快点 ── */
+@keyframes slime-urging-jiggle {
+  0%, 100% { transform: scaleY(1); }
+  50% { transform: scaleY(0.92); }
+}
+.mood-urging #pet-body-group {
+  animation: slime-urging-jiggle 0.45s ease-in-out infinite;
+  transform-origin: 128px 200px;
+}

package/dist/assets/pets/11-slime-blob.svg

@@ -8,7 +8,7 @@
       <feGaussianBlur stdDeviation="3" result="blur"/>
       <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
     </filter>
-  </defs>
+  </defs>
   <g id="pet-body-group">
 
   <!-- Blob body -->
@@ -31,7 +31,7 @@
   </g>
 
   <!-- Smile -->
-  <path d="M110 156 Q128 170 146 156" stroke="#0a1420" stroke-width="3.5" fill="none" stroke-linecap="round"/>
+  <path id="pet-mouth" d="M110 156 Q128 170 146 156" stroke="#0a1420" stroke-width="3.5" fill="none" stroke-linecap="round"/>
 
   <!-- Drips -->
   <path d="M84 216 Q84 232 92 232 Q100 232 96 216 Z" fill="url(#blobGrad)"/>
@@ -39,5 +39,5 @@
 
   <!-- Highlight -->
   <ellipse cx="92" cy="86" rx="18" ry="10" fill="#ffffff" fill-opacity="0.25"/>
-  </g>
+  </g>
 </svg>

package/dist/assets/pets/12-ghost-byte.svg

@@ -8,7 +8,7 @@
       <feGaussianBlur stdDeviation="3" result="blur"/>
       <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
     </filter>
-  </defs>
+  </defs>
   <g id="pet-body-group">
 
   <!-- Floating shadow -->
@@ -36,6 +36,6 @@
   </g>
 
   <!-- Mouth -->
-  <ellipse cx="128" cy="142" rx="10" ry="8" fill="#0a1420" fill-opacity="0.85"/>
-  </g>
+  <ellipse id="pet-mouth" cx="128" cy="142" rx="10" ry="8" fill="#0a1420" fill-opacity="0.85"/>
+  </g>
 </svg>

package/dist/assets/pets/13-cactus-bot.svg

@@ -26,8 +26,8 @@
   <rect x="48" y="150" width="160" height="70" rx="40" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="3"/>
 
   <!-- Spike arms(填充块面而非线条,细刺仍保留为短线装饰) -->
-  <path d="M62 108 Q26 112 24 142 Q22 156 38 158 Q50 158 48 144 Q44 122 62 118 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>
-  <path d="M194 108 Q230 112 232 142 Q234 156 218 158 Q206 158 208 144 Q212 122 194 118 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>
+  <path id="pet-arm-left" d="M62 108 Q26 112 24 142 Q22 156 38 158 Q50 158 48 144 Q44 122 62 118 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>
+  <path id="pet-arm-right" d="M194 108 Q230 112 232 142 Q234 156 218 158 Q206 158 208 144 Q212 122 194 118 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>
   <path d="M34 118 L24 108 M34 128 L22 124 M222 118 L232 108 M222 128 L234 124"
         stroke="url(#accentGrad)" stroke-width="3" stroke-linecap="round"/>
 

package/dist/assets/pets/15-satellite-bot.svg

@@ -18,7 +18,7 @@
   <!-- Antenna dish (kept 8px lower than original so the dish curve's peak stays clear
        of the viewBox top edge during the idle float animation's -6px translateY) -->
   <line x1="128" y1="24" x2="128" y2="54" stroke="url(#accentGrad)" stroke-width="4"/>
-  <path d="M100 24 Q128 4 156 24 Q128 36 100 24 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>
+  <path id="pet-antenna" d="M100 24 Q128 4 156 24 Q128 36 100 24 Z" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>
 
   <!-- Solar panel wings -->
   <rect x="4" y="88" width="50" height="70" rx="6" fill="url(#bodyGrad)" stroke="url(#accentGrad)" stroke-width="2.5"/>

package/dist/assets/pets/16-jellyfish-bot.svg

@@ -8,7 +8,7 @@
       <feGaussianBlur stdDeviation="3" result="blur"/>
       <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
     </filter>
-  </defs>
+  </defs>
   <g id="pet-body-group">
 
   <!-- Dome head -->
@@ -20,7 +20,7 @@
     <circle cx="102" cy="86" r="8" fill="#0a1420"/>
     <circle cx="154" cy="86" r="8" fill="#0a1420"/>
   </g>
-  <path d="M112 104 Q128 114 144 104" stroke="#0a1420" stroke-width="3" fill="none" stroke-linecap="round"/>
+  <path id="pet-mouth" d="M112 104 Q128 114 144 104" stroke="#0a1420" stroke-width="3" fill="none" stroke-linecap="round"/>
 
   <!-- Tentacles -->
   <path d="M64 110 Q56 150 66 190 Q72 210 62 232" stroke="#ba68c8" stroke-width="7" fill="none" stroke-linecap="round">
@@ -43,5 +43,5 @@
   <circle cx="66" cy="170" r="3" fill="#e040fb" filter="url(#glow)"/>
   <circle cx="132" cy="180" r="3" fill="#e040fb" filter="url(#glow)"/>
   <circle cx="196" cy="170" r="3" fill="#e040fb" filter="url(#glow)"/>
-  </g>
+  </g>
 </svg>

package/dist/assets/pets/18-star-bot.svg

@@ -8,7 +8,7 @@
       <feGaussianBlur stdDeviation="3" result="blur"/>
       <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
     </filter>
-  </defs>
+  </defs>
   <g id="pet-body-group">
 
   <!-- Star body: 5-point star -->
@@ -40,6 +40,6 @@
   </g>
 
   <!-- Smile -->
-  <path d="M114 148 Q128 158 142 148" stroke="#ffe082" stroke-width="3" fill="none" stroke-linecap="round"/>
-  </g>
+  <path id="pet-mouth" d="M114 148 Q128 158 142 148" stroke="#ffe082" stroke-width="3" fill="none" stroke-linecap="round"/>
+  </g>
 </svg>

package/dist/assets/pets/manifest.json

@@ -3,8 +3,20 @@
   "viewBox": "0 0 256 256",
   "style": "赛博终端风,深色机身(#1b263b/#0d1b2a)+ 屏幕脸(黑底彩色像素眼,呼吸/眨眼动画),与 assets/mascot.svg 视觉语言一致",
   "pets": [
-    { "id": "robo-cat",      "file": "01-robo-cat.svg",      "name": "机械猫",     "accent": "#2afadf" },
-    { "id": "robo-dog",      "file": "02-robo-dog.svg",      "name": "机械犬",     "accent": "#ffb74d" },
+    { "id": "robo-cat",      "file": "01-robo-cat.svg",      "name": "机械猫",     "accent": "#2afadf",
+      "motionFile": "01-robo-cat.motion.css",
+      "quips": {
+        "tired": ["猫猫要趴一下…", "喵…有点累了,尾巴都垂下来了"],
+        "bored": ["理理毛,顺便等你", "尾巴甩甩,好无聊喵"],
+        "urging": ["喵?还没好吗", "尾巴都等急了喵"]
+      } },
+    { "id": "robo-dog",      "file": "02-robo-dog.svg",      "name": "机械犬",     "accent": "#ffb74d",
+      "motionFile": "02-robo-dog.motion.css",
+      "quips": {
+        "bored": ["打了个哈欠,好无聊呀", "尾巴都不知道摇给谁看了"],
+        "urging": ["快点快点,舌头都伸出来啦", "汪!还在等你呢"],
+        "flustered": ["汪汪汪,有点忙不过来了", "尾巴摇得比脑子转得快"]
+      } },
     { "id": "robo-fox",      "file": "03-robo-fox.svg",      "name": "机械狐",     "accent": "#ff7043" },
     { "id": "robo-panda",    "file": "04-robo-panda.svg",    "name": "机械熊猫",   "accent": "#2afadf" },
     { "id": "robo-owl",      "file": "05-robo-owl.svg",      "name": "机械猫头鹰", "accent": "#7c4dff" },
@@ -13,7 +25,12 @@
     { "id": "robo-bear",     "file": "08-robo-bear.svg",     "name": "机械熊",     "accent": "#ffa726" },
     { "id": "robo-penguin",  "file": "09-robo-penguin.svg",  "name": "机械企鹅",   "accent": "#42a5f5" },
     { "id": "robo-dino",     "file": "10-robo-dino.svg",     "name": "机械龙",     "accent": "#00c853" },
-    { "id": "slime-blob",    "file": "11-slime-blob.svg",    "name": "史莱姆",     "accent": "#00acc1" },
+    { "id": "slime-blob",    "file": "11-slime-blob.svg",    "name": "史莱姆",     "accent": "#00acc1",
+      "motionFile": "11-slime-blob.motion.css",
+      "quips": {
+        "tired": ["软软地瘫下去了…", "身体有点撑不住形状了"],
+        "urging": ["晃一晃,还在等你哦", "抖一抖,催你一下"]
+      } },
     { "id": "ghost-byte",    "file": "12-ghost-byte.svg",    "name": "字节幽灵",   "accent": "#4dd0e1" },
     { "id": "cactus-bot",    "file": "13-cactus-bot.svg",    "name": "仙人掌兽",   "accent": "#66bb6a" },
     { "id": "crystal-bot",   "file": "14-crystal-bot.svg",   "name": "水晶精灵",   "accent": "#7c4dff" },

package/dist/e2e-mood-check.js

@@ -0,0 +1,128 @@
+// 任务 8:端到端逻辑验证(脚本化,不依赖真实 Electron/图形环境/真实 mocode CLI 进程)。
+// 直接调用已完成的纯逻辑模块 mood.ts / mood-tracker.ts / quips.ts / skins.ts,
+// 模拟 design.md 里描述的完整事件序列,断言 Mood 链路与皮肤个性化行为符合预期。
+// 本脚本只读验证,不修改被验证的任何模块。
+// 运行(在 f:\mocode 根目录):npx tsx packages/pet-app/src/e2e-mood-check.ts
+import { createMoodTracker } from './mood-tracker.js';
+import { listSkinEntries } from './skins.js';
+import { UNIVERSAL_QUIPS, pickQuip } from './quips.js';
+let passed = 0;
+const assert = (cond, msg) => {
+    if (!cond) {
+        console.error('✗ ' + msg);
+        process.exit(1);
+    }
+    passed++;
+    console.log('✓ ' + msg);
+};
+(async () => {
+    // ── 场景1:agent 长时间停留在 thinking(同理 tool_call)触发 tired ─────────
+    // 每 5000ms 上报一次 thinking,ts: 0..60000。默认 tiredMs=60000。
+    {
+        const tracker = createMoodTracker();
+        let reachedTired = false;
+        for (let ts = 0; ts <= 60000; ts += 5000) {
+            tracker.recordState('thinking', ts);
+            const res = tracker.evaluate(ts);
+            if (ts < 60000) {
+                assert(res === null, `场景1: ts=${ts} (<60000) 时不应推送 tired(evaluate 应返回 null,实际 ${JSON.stringify(res)})`);
+            }
+            else {
+                assert(res !== null && res.mood === 'tired', `场景1: ts=60000(达到 tiredMs 阈值)时 mood 应变为 tired(实际 ${JSON.stringify(res)})`);
+                reachedTired = true;
+            }
+        }
+        assert(reachedTired, '场景1: 已跑到 ts=60000 并验证 tired 触发');
+    }
+    // ── 场景2:10 秒内 5 次 tool_call 触发 flustered ─────────────────────────
+    // 默认 toolWindowMs=10000, toolCount=5。
+    {
+        const tracker = createMoodTracker();
+        for (const ts of [0, 2000, 4000, 6000, 8000]) {
+            tracker.recordState('tool_call', ts);
+        }
+        const res = tracker.evaluate(8000);
+        assert(res !== null && res.mood === 'flustered', `场景2: 10s 内 5 次 tool_call → mood 应为 flustered(实际 ${JSON.stringify(res)})`);
+    }
+    // ── 场景3:60 秒内 2 次 error 触发 frustrated ────────────────────────────
+    // 默认 errorWindowMs=60000, errorCount=2。
+    {
+        const tracker = createMoodTracker();
+        tracker.recordState('error', 0);
+        tracker.recordState('error', 30000);
+        const res = tracker.evaluate(30000);
+        assert(res !== null && res.mood === 'frustrated', `场景3: 60s 窗口内 2 次 error → mood 应为 frustrated(实际 ${JSON.stringify(res)})`);
+    }
+    // ── 场景4:waiting_human 超时触发 urging ─────────────────────────────────
+    // 默认 urgingMs=30000。
+    {
+        const tracker = createMoodTracker();
+        tracker.recordState('waiting_human', 0);
+        const res = tracker.evaluate(30000);
+        assert(res !== null && res.mood === 'urging', `场景4: waiting_human 持续 30000ms → mood 应为 urging(实际 ${JSON.stringify(res)})`);
+    }
+    // ── 场景5:idle 超时触发 bored ────────────────────────────────────────────
+    // 默认 boredMs=300000。
+    {
+        const tracker = createMoodTracker();
+        tracker.recordState('idle', 0);
+        const res = tracker.evaluate(300000);
+        assert(res !== null && res.mood === 'bored', `场景5: idle 持续 300000ms → mood 应为 bored(实际 ${JSON.stringify(res)})`);
+    }
+    // ── 场景6:多条件同时满足,只呈现最高优先级 mood ──────────────────────────
+    // 选用组合:frustrated(errorCount=2,errorWindowMs=60000) vs tired(tiredMs=60000)。
+    // 关键设计:tired/bored/urging 只看"末尾同状态连续段"的起始时间(currentStateSince),
+    // 而 frustrated/flustered 看的是"整个事件历史里落在滑动窗口内"的计数,两者不互斥。
+    // 序列:error@0, error@0, thinking@0 —— 末尾状态是 thinking,起始时间就是它自己的 ts=0;
+    // 同时前面两条 error 事件的 ts=0 仍落在以 now=60000、宽度 60000 的窗口 [0,60000] 内。
+    // 于是在 now=60000 时:tired 条件成立(60000-0>=60000)且 frustrated 条件成立(窗口内 2 条 error)。
+    // MOOD_PRIORITY = [frustrated, flustered, urging, tired, bored],frustrated 排在 tired 之前,
+    // 因此应最终呈现 frustrated 而不是 tired。
+    {
+        const tracker = createMoodTracker();
+        tracker.recordState('error', 0);
+        tracker.recordState('error', 0);
+        tracker.recordState('thinking', 0);
+        const res = tracker.evaluate(60000);
+        assert(res !== null && res.mood === 'frustrated', `场景6: frustrated(2次error@60000ms窗口内) 与 tired(thinking持续60000ms) 同时满足 → 应呈现优先级更高的 frustrated,不是 tired(实际 ${JSON.stringify(res)})`);
+    }
+    // ── 场景7:断开活跃连接重新连接后,mood 判定不受上一个会话历史事件影响 ────
+    {
+        const tracker = createMoodTracker();
+        tracker.recordState('thinking', 0);
+        const tiredRes = tracker.evaluate(60000);
+        assert(tiredRes !== null && tiredRes.mood === 'tired', `场景7: 会话A 先触发 tired 作为前置条件(实际 ${JSON.stringify(tiredRes)})`);
+        tracker.reset();
+        // 用同一个 now=60000 再 evaluate 一次:若 events 未被真正清空,tired 条件依旧成立且
+        // mood 与上次推送的 'tired' 相同 → evaluate 会因"未变化"返回 JS null(不会是 {mood:null})。
+        // 只有 events 真被清空,deriveMood([], 60000) 才会算出 null,与上次推送的 'tired' 不同,
+        // 从而触发一次"变化推送"返回 {mood:null}。用这个差异来验证 reset 确实清空了事件缓冲。
+        const afterReset = tracker.evaluate(60000);
+        assert(afterReset !== null && afterReset.mood === null, `场景7: reset() 后立即 evaluate 应返回 {mood:null}(证明 events 已清空,不是简单的"未变化"判定;实际 ${JSON.stringify(afterReset)})`);
+        // 新会话从零开始:只记一条 idle 事件,时间差远小于 boredMs(300000),不应触发任何 mood,
+        // 也不应因为旧会话的 tired 历史残留而误判。
+        tracker.recordState('idle', 60000);
+        const newSessionRes = tracker.evaluate(61000);
+        assert(newSessionRes === null, `场景7: 新会话记一条 idle、时间差(1000ms)远小于 boredMs → mood 应仍是 null(evaluate 返回 null,无残留旧 mood;实际 ${JSON.stringify(newSessionRes)})`);
+    }
+    // ── 场景8:定制皮肤展示专属文案,未定制皮肤正确回退通用池 ──────────────────
+    {
+        const entries = listSkinEntries();
+        const cat = entries.find((e) => e.id === 'robo-cat');
+        assert(!!cat, '场景8: manifest.json 中应存在 robo-cat 条目');
+        assert(!!cat?.quips && Array.isArray(cat.quips.tired) && Array.isArray(cat.quips.bored) && Array.isArray(cat.quips.urging), `场景8: robo-cat.quips 应包含 tired/bored/urging 数组字段(实际 ${JSON.stringify(cat?.quips)})`);
+        const catTired = cat.quips.tired;
+        for (let i = 0; i < 20; i++) {
+            const q = pickQuip('tired', cat.quips);
+            assert(catTired.includes(q), `场景8: robo-cat 的 tired 文案应从专属池选取(第 ${i + 1} 次得到 "${q}",专属池 ${JSON.stringify(catTired)})`);
+        }
+        const fox = entries.find((e) => e.id === 'robo-fox');
+        assert(!!fox, '场景8: manifest.json 中应存在 robo-fox 条目');
+        assert(fox?.quips === undefined, `场景8: robo-fox 未定制 quips,应解析为 undefined(实际 ${JSON.stringify(fox?.quips)})`);
+        for (let i = 0; i < 20; i++) {
+            const q = pickQuip('tired', fox.quips);
+            assert(UNIVERSAL_QUIPS.tired.includes(q), `场景8: robo-fox 未定制皮肤应回退通用池(第 ${i + 1} 次得到 "${q}",通用池 ${JSON.stringify(UNIVERSAL_QUIPS.tired)})`);
+        }
+    }
+    console.log(`\nOK: ${passed} passed, 0 failed`);
+})();

package/dist/main.js

@@ -8,6 +8,7 @@ import path from 'node:path';
 import { parseClientMessage, } from './protocol.js';
 import { loadConfig, saveConfig } from './config.js';
 import { listSkinEntries, resolveSkinPath } from './skins.js';
+import { createMoodTracker } from './mood-tracker.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 /** 默认端口;MOCODE_PET_PORT 环境变量覆盖(与 mocode 主包 src/pet/bridge.ts 保持一致的默认假设)。 */
 const DEFAULT_PORT = 47821;
@@ -21,6 +22,8 @@ const HEARTBEAT_CHECK_INTERVAL_MS = 15000;
 const HEARTBEAT_TIMEOUT_MS = 10000;
 /** 状态展示超时后自动回落(design.md 默认假设:done/aborted/error 短暂展示 1500ms)。 */
 const TRANSIENT_STATE_TIMEOUT_MS = 1500;
+/** Mood ticker 检查间隔(design.md 默认假设:2000ms,状态变化时另外立即求值一次,不必等 ticker)。 */
+const MOOD_CHECK_INTERVAL_MS = 2000;
 /** 全局连接表 + 唯一活跃连接引用("最新连接覆盖"算法的状态载体,见 design.md Low-Level)。 */
 const connections = new Map();
 let activeSocket = null;
@@ -29,6 +32,8 @@ let tray = null;
 let transientTimer = null;
 /** 当前生效的皮肤 id('default' = assets/mascot.svg);启动时从持久化配置读取,运行期随 set_skin/托盘菜单变化。 */
 let currentSkinId = 'default';
+/** Mood 判定与文案调度(纯逻辑,见 mood-tracker.ts);随活跃连接建立/断开重置,详见 onConnection/onDisconnect。 */
+const moodTracker = createMoodTracker();
 /** 把状态推给渲染进程(IPC)。渲染进程窗口未就绪时静默丢弃(下次状态到达会重推)。 */
 function broadcastToRenderer(state, meta) {
     if (!mainWindow || mainWindow.isDestroyed())
@@ -72,6 +77,7 @@ function onConnection(socket) {
     };
     connections.set(socket, record);
     activeSocket = socket;
+    moodTracker.reset(); // 新会话从空事件历史开始,不受上一个活跃连接遗留事件影响(design.md 事件缓冲生命周期)
     send(socket, { type: 'welcome', isActive: true, ts: Date.now() });
     broadcastToRenderer('idle'); // 新连接刚建立还没收到它的第一条 state,先归 idle 兜底
     socket.on('message', (data) => onMessage(socket, String(data)));
@@ -88,6 +94,7 @@ function onDisconnect(socket) {
     if (wasActive) {
         activeSocket = null; // 强制清空,不回退到任何仍 open 的连接
         broadcastToRenderer('idle');
+        moodTracker.reset(); // 避免下一个连接复用旧历史(design.md 事件缓冲生命周期)
     }
     // wasActive = false:该连接原本就被忽略,断开对当前状态源无影响
 }
@@ -119,6 +126,8 @@ function onMessage(socket, raw) {
             if (socket !== activeSocket)
                 return; // 非活跃连接的状态消息静默丢弃
             broadcastToRenderer(msg.state, msg.meta);
+            moodTracker.recordState(msg.state);
+            pushMoodEvaluation(moodTracker.evaluate(Date.now(), currentSkinQuips()));
             return;
         case 'shutdown':
             // 关闭桌宠(方案C的 CLI 入口):不要求发送方是活跃连接,任何已连接的 mocode 进程均可请求关闭。
@@ -156,6 +165,11 @@ function currentSkinAssetPath() {
     const abs = resolveSkinPath(currentSkinId);
     return abs ? `../assets/pets/${path.basename(abs)}` : '../assets/mascot.svg';
 }
+/** 当前皮肤的个性化动作覆盖 CSS 文件名(manifest.json 的 motionFile 字段);
+ *  'default' 或未定制该字段时返回 undefined,渲染进程据此清空 `#pet-skin-motion` 的 href(回退通用样式)。 */
+function currentSkinMotionFile() {
+    return listSkinEntries().find((e) => e.id === currentSkinId)?.motionFile;
+}
 /** 把当前皮肤推给渲染进程(运行期切换用,如托盘菜单点击 / CLI set_skin 消息)。
  *  注:启动时的初始皮肤不走这条路径——渲染进程通过 'pet:get-skin' invoke 主动拉取,
  *  避免 did-finish-load 与渲染进程异步注册监听器之间的时序竞争(IPC 消息不会缓冲,
@@ -164,14 +178,46 @@ function pushSkinToRenderer() {
     if (!mainWindow || mainWindow.isDestroyed())
         return;
     try {
-        mainWindow.webContents.send('pet:skin', { assetPath: currentSkinAssetPath() });
+        mainWindow.webContents.send('pet:skin', {
+            assetPath: currentSkinAssetPath(),
+            motionFile: currentSkinMotionFile(),
+        });
     }
     catch {
         // 静默:渲染进程未就绪时忽略,下次运行期切换会重新推送
     }
 }
 /** 渲染进程启动时主动拉取当前皮肤(同步于其自身初始化时机,不依赖 did-finish-load 的时序假设)。 */
-ipcMain.handle('pet:get-skin', () => ({ assetPath: currentSkinAssetPath() }));
+ipcMain.handle('pet:get-skin', () => ({
+    assetPath: currentSkinAssetPath(),
+    motionFile: currentSkinMotionFile(),
+}));
+/** 当前皮肤的专属文案池(manifest.json 的 quips 字段),供 mood-tracker 的 pickQuip 优先选取。 */
+function currentSkinQuips() {
+    return listSkinEntries().find((e) => e.id === currentSkinId)?.quips;
+}
+/** 把 mood-tracker 求值结果推给渲染进程(IPC 频道 pet:mood)。result 为 null 表示本次求值无需推送。
+ *  写法与 broadcastToRenderer 一致的 null/isDestroyed 检查 + try/catch 静默降级,不影响 Server 主流程。 */
+function pushMoodEvaluation(result) {
+    if (!result)
+        return;
+    if (!mainWindow || mainWindow.isDestroyed())
+        return;
+    try {
+        mainWindow.webContents.send('pet:mood', result);
+    }
+    catch {
+        // 静默:渲染进程尚未加载完毕或已崩溃,不影响 Server 侧状态机
+    }
+}
+/** Mood ticker:每 MOOD_CHECK_INTERVAL_MS 定时求值一次(状态变化时另有立即求值,见 onMessage 的 'state' 分支)。 */
+function startMoodTicker() {
+    const timer = setInterval(() => {
+        pushMoodEvaluation(moodTracker.evaluate(Date.now(), currentSkinQuips()));
+    }, MOOD_CHECK_INTERVAL_MS);
+    timer.unref?.();
+    return timer;
+}
 function send(socket, msg) {
     try {
         socket.send(JSON.stringify(msg));
@@ -420,6 +466,7 @@ app.whenReady().then(async () => {
     mainWindow = createPetWindow();
     tray = createTray();
     rebuildTrayMenu();
+    startMoodTicker();
 });
 // 不再监听 window-all-closed → app.quit():悬浮窗本身不可关闭(frame:false 且无关闭按钮),
 // 该事件设计上永不触发。退出统一走两个显式入口:托盘菜单"退出桌宠" 或 CLI 侧 shutdown 消息

package/dist/mood-current-state.test.js

@@ -0,0 +1,55 @@
+// currentStateSince 边界场景单测(mood.ts 内部辅助函数,已临时加 export 以便测试)。
+// 覆盖:空数组、单条事件、末尾多条同状态、末尾单条状态与前一条不同、
+//   中间有切换但末尾又切回同状态(不应误判 since)。
+// 运行:npx tsx packages/pet-app/src/mood-current-state.test.ts
+import { currentStateSince } from './mood.js';
+let passed = 0;
+const assert = (cond, msg) => {
+    if (!cond) {
+        console.error('✗ ' + msg);
+        process.exit(1);
+    }
+    passed++;
+    console.log('✓ ' + msg);
+};
+// 1) 空数组 → null
+{
+    const r = currentStateSince([]);
+    assert(r === null, '空数组 → 返回 null');
+}
+// 2) 单条事件 → { state, since } 就是该条自身
+{
+    const events = [{ state: 'idle', ts: 100 }];
+    const r = currentStateSince(events);
+    assert(r !== null && r.state === 'idle' && r.since === 100, "单条事件 [{state:'idle',ts:100}] → {state:'idle', since:100}");
+}
+// 3) 末尾多条同状态 → since 是这段连续区间里最早那条的 ts
+{
+    const events = [
+        { state: 'thinking', ts: 100 },
+        { state: 'thinking', ts: 200 },
+        { state: 'thinking', ts: 300 },
+    ];
+    const r = currentStateSince(events);
+    assert(r !== null && r.state === 'thinking' && r.since === 100, "末尾多条同状态(thinking x3, ts:100/200/300) → since:100(最早那条,不是300)");
+}
+// 4) 末尾单条状态与前一条不同 → since 就是该条自身的 ts,不把前一条算进去
+{
+    const events = [
+        { state: 'idle', ts: 100 },
+        { state: 'thinking', ts: 200 },
+    ];
+    const r = currentStateSince(events);
+    assert(r !== null && r.state === 'thinking' && r.since === 200, "末尾状态与前一条不同([idle@100, thinking@200]) → {state:'thinking', since:200}");
+}
+// 5) 中间有切换但末尾又切回同一状态 → 只看末尾连续同状态的最新一段,不被更早处同状态干扰
+{
+    const events = [
+        { state: 'idle', ts: 100 },
+        { state: 'thinking', ts: 200 },
+        { state: 'idle', ts: 300 },
+    ];
+    const r = currentStateSince(events);
+    assert(r !== null && r.state === 'idle' && r.since === 300, "末尾切回同状态但中间有切换([idle@100, thinking@200, idle@300]) → {state:'idle', since:300}(不误判为100)");
+}
+console.log(`\nOK: ${passed} passed, 0 failed`);

package/dist/mood-determinism.pbt.js

@@ -0,0 +1,66 @@
+// PBT: Property 2 (Mood 确定性,纯函数) —— packages/pet-app/src/mood.ts 的 deriveMood。
+// 覆盖 tasks.md 任务 2.2 / design.md Property 2:
+//   给定任意 (events, now, thresholds) 输入,连续多次调用 deriveMood 返回值恒定
+//   (无隐藏可变状态,纯函数),且调用过程不修改传入的 events 数组(无副作用)。
+// 运行:npx tsx packages/pet-app/src/mood-determinism.pbt.ts (在 f:\mocode 根目录下)
+import fc from 'fast-check';
+import { deriveMood, DEFAULT_MOOD_THRESHOLDS } from './mood.js';
+import { PET_STATES } from './protocol.js';
+let passed = 0;
+const assert = (cond, msg) => {
+    if (!cond) {
+        console.error('✗ ' + msg);
+        process.exit(1);
+    }
+    passed++;
+    console.log('✓ ' + msg);
+};
+// 任意单条 MoodEvent:state 从 8 个合法 PetState 里选,ts 为非负整数。
+const moodEventArb = fc.record({
+    state: fc.constantFrom(...PET_STATES),
+    ts: fc.integer({ min: 0, max: 10_000_000 }),
+});
+// 任意 MoodEvent[]:生成后按 ts 升序排序,满足 deriveMood 的前置条件(events 按 ts 非降序排列)。
+const moodEventsArb = fc
+    .array(moodEventArb, { maxLength: 40 })
+    .map((events) => [...events].sort((a, b) => a.ts - b.ts));
+// 任意正整数(用于自定义阈值的 7 个字段)。
+const positiveIntArb = fc.integer({ min: 1, max: 1_000_000 });
+// 任意 MoodThresholds:一半概率直接用 DEFAULT_MOOD_THRESHOLDS,一半概率用随机生成的自定义阈值。
+const thresholdsArb = fc.oneof(fc.constant(DEFAULT_MOOD_THRESHOLDS), fc.record({
+    tiredMs: positiveIntArb,
+    boredMs: positiveIntArb,
+    urgingMs: positiveIntArb,
+    errorWindowMs: positiveIntArb,
+    errorCount: positiveIntArb,
+    toolWindowMs: positiveIntArb,
+    toolCount: positiveIntArb,
+}));
+async function main() {
+    // Property 2: 对任意 (events, now, thresholds),多次调用 deriveMood 返回值恒定,且不修改 events。
+    try {
+        fc.assert(fc.property(moodEventsArb, fc.integer({ min: 0, max: 10_000_000 }), thresholdsArb, (events, now, thresholds) => {
+            const before = JSON.stringify(events);
+            const r1 = deriveMood(events, now, thresholds);
+            const r2 = deriveMood(events, now, thresholds);
+            const r3 = deriveMood(events, now, thresholds);
+            const after = JSON.stringify(events);
+            // 返回值恒定(===,mood 是字符串或 null,可直接比较)。
+            if (!(r1 === r2 && r2 === r3))
+                return false;
+            // events 数组未被修改(无副作用)。
+            if (before !== after)
+                return false;
+            return true;
+        }), { numRuns: 500 });
+        assert(true, 'Property 2 (Mood 确定性): 500 次随机样本,deriveMood 多次调用返回值恒定且不修改 events');
+    }
+    catch (e) {
+        console.error('✗ Property 2 (Mood 确定性) 失败:');
+        console.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+    console.log(`\nOK: ${passed} passed, 0 failed`);
+    process.exit(0);
+}
+main();