mocode-pet-app 1.4.0 → 1.7.0

package/dist/assets/pets/manifest.json

@@ -1,25 +1,139 @@
-{
-  "_description": "候选桌宠素材索引,供未来 desktop-pet '选皮' 功能读取。当前 packages/pet-app 实现仅使用 assets/mascot.svg(单一形象+CSS状态动画),这些素材是为后续换皮功能预留的候选库。",
-  "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-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" },
-    { "id": "robo-bunny",    "file": "06-robo-bunny.svg",    "name": "机械兔",     "accent": "#ff6ec7" },
-    { "id": "robo-frog",     "file": "07-robo-frog.svg",     "name": "机械蛙",     "accent": "#00e676" },
-    { "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": "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" },
-    { "id": "satellite-bot", "file": "15-satellite-bot.svg", "name": "卫星兽",     "accent": "#42a5f5" },
-    { "id": "jellyfish-bot", "file": "16-jellyfish-bot.svg", "name": "水母兽",     "accent": "#ba68c8" },
-    { "id": "mushroom-bot",  "file": "17-mushroom-bot.svg",  "name": "菌菇兽",     "accent": "#c62828" },
-    { "id": "star-bot",      "file": "18-star-bot.svg",      "name": "星星兽",     "accent": "#ff8f00" }
-  ]
-}
+{
+  "_description": "候选桌宠素材索引,供未来 desktop-pet '选皮' 功能读取。当前 packages/pet-app 实现仅使用 assets/mascot.svg(单一形象+CSS状态动画),这些素材是为后续换皮功能预留的候选库。",
+  "viewBox": "0 0 256 256",
+  "style": "赛博终端风,深色机身(#1b263b/#0d1b2a)+ 屏幕脸(黑底彩色像素眼,呼吸/眨眼动画),与 assets/mascot.svg 视觉语言一致",
+  "pets": [
+    { "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",
+      "motionFile": "03-robo-fox.motion.css",
+      "quips": {
+        "thinking": ["嗅嗅…好像有什么线索喵…不对,狐狐嗅嗅"],
+        "bored": ["尾巴都扫累了,还是没动静"],
+        "urging": ["喂喂,狐狸都急得直摇尾巴了"]
+      } },
+    { "id": "robo-panda",    "file": "04-robo-panda.svg",    "name": "机械熊猫",   "accent": "#2afadf",
+      "motionFile": "04-robo-panda.motion.css",
+      "quips": {
+        "tired": ["呜…竹子嚼完了,想眯一会儿"],
+        "bored": ["翻个身…啊,翻不动"],
+        "urging": ["嗯…?完了吗?让我再翻个身想想"]
+      } },
+    { "id": "robo-owl",      "file": "05-robo-owl.svg",      "name": "机械猫头鹰", "accent": "#7c4dff",
+      "motionFile": "05-robo-owl.motion.css",
+      "quips": {
+        "bored": ["咕咕…360° 巡视中", "夜里都飞完了,白天可困"],
+        "urging": ["扇翅膀提示你,别再让我咕咕了"]
+      } },
+    { "id": "robo-bunny",    "file": "06-robo-bunny.svg",    "name": "机械兔",     "accent": "#ff6ec7",
+      "motionFile": "06-robo-bunny.motion.css",
+      "quips": {
+        "tired": ["耳朵都耷拉下来了…"],
+        "bored": ["蹦跶蹦跶!…啊,又没意思了"],
+        "urging": ["蹦蹦蹦!好了没呀"]
+      } },
+    { "id": "robo-frog",     "file": "07-robo-frog.svg",     "name": "机械蛙",     "accent": "#00e676",
+      "motionFile": "07-robo-frog.motion.css",
+      "quips": {
+        "thinking": ["呱…再想想"],
+        "bored": ["蹲得腿都麻了呱…"],
+        "urging": ["呱呱呱!快跳到下一题了呱"]
+      } },
+    { "id": "robo-bear",     "file": "08-robo-bear.svg",     "name": "机械熊",     "accent": "#ffa726",
+      "motionFile": "08-robo-bear.motion.css",
+      "quips": {
+        "tired": ["冬眠时间快到了…zzZ"],
+        "bored": ["蜂蜜都被我吃完了,无聊"],
+        "urging": ["熊!都!要!等!不!住!了!"]
+      } },
+    { "id": "robo-penguin",  "file": "09-robo-penguin.svg",  "name": "机械企鹅",   "accent": "#42a5f5",
+      "motionFile": "09-robo-penguin.motion.css",
+      "quips": {
+        "bored": ["左右摇,左右摇…站久了脚好冷"],
+        "urging": ["嘎嘎!鳍都拍红了!"],
+        "tired": ["南极了,太冷,想躺平"]
+      } },
+    { "id": "robo-dino",     "file": "10-robo-dino.svg",     "name": "机械龙",     "accent": "#00c853",
+      "motionFile": "10-robo-dino.motion.css",
+      "quips": {
+        "frustrated": ["嗷呜!侏罗纪的怒火在燃烧!"],
+        "urging":    ["跺脚!跺脚!小短腿都跺出火星了!"]
+      },
+      "stateQuips": {
+        "done":    ["哼,这次算你过关,本龙勉强点头"],
+        "aborted": ["嗷!本龙还没出手呢!"],
+        "error":   ["本龙摔了一跤,爬起来继续"]
+      } },
+    { "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",
+      "motionFile": "12-ghost-byte.motion.css",
+      "quips": {
+        "tired": ["电量耗尽了…要散了…"],
+        "bored": ["飘来飘去,连 bug 都飘光了"],
+        "urging": ["呜——呜——快看我一眼"]
+      } },
+    { "id": "cactus-bot",    "file": "13-cactus-bot.svg",    "name": "仙人掌兽",   "accent": "#66bb6a",
+      "motionFile": "13-cactus-bot.motion.css",
+      "quips": {
+        "bored": ["晒太阳晒到刺都软了"],
+        "tired": ["缺水…缺人理…"],
+        "urging": ["刺都竖起来了,快点快点"]
+      } },
+    { "id": "crystal-bot",   "file": "14-crystal-bot.svg",   "name": "水晶精灵",   "accent": "#7c4dff",
+      "motionFile": "14-crystal-bot.motion.css",
+      "quips": {
+        "bored": ["折射中…请勿直视"],
+        "tired": ["光谱变暗了…能量要充电"],
+        "urging": ["折射出警示光!快!快!"]
+      } },
+    { "id": "satellite-bot", "file": "15-satellite-bot.svg", "name": "卫星兽",     "accent": "#42a5f5",
+      "motionFile": "15-satellite-bot.motion.css",
+      "quips": {
+        "bored": ["轨道上只剩我一只,寂寞"],
+        "tired": ["太阳能板收起来了,需要补光"],
+        "urging": ["哔哔哔!信号强到溢出!"]
+      } },
+    { "id": "jellyfish-bot", "file": "16-jellyfish-bot.svg", "name": "水母兽",     "accent": "#ba68c8",
+      "motionFile": "16-jellyfish-bot.motion.css",
+      "quips": {
+        "tired": ["随波逐流,飘到没力气"],
+        "bored": ["深海里一只水母,在发呆"],
+        "urging": ["刺一下!刺一下!…啊我没有刺"]
+      } },
+    { "id": "mushroom-bot",  "file": "17-mushroom-bot.svg",  "name": "菌菇兽",     "accent": "#c62828",
+      "motionFile": "17-mushroom-bot.motion.css",
+      "quips": {
+        "tired": ["菌盖都瘪了,要孢子休了"],
+        "bored": ["在森林角落,洒了一把无聊的孢子"],
+        "urging": ["蹦!蹦!蹦!Q弹到爆!"]
+      } },
+    { "id": "star-bot",      "file": "18-star-bot.svg",      "name": "星星兽",     "accent": "#ff8f00",
+      "motionFile": "18-star-bot.motion.css",
+      "quips": {
+        "frustrated": ["星芒都烧起来了!急!急!"],
+        "urging":     ["一闪一闪亮晶晶,催你快回应"]
+      },
+      "stateQuips": {
+        "done":    ["Twinkle! 任务完成 ✨"],
+        "aborted": ["流星中途熄灭了…"],
+        "error":   ["星星也黯淡了一瞬,别慌,会再亮起来的"]
+      } }
+  ]
+}

package/dist/e2e-mood-check.js

@@ -0,0 +1,150 @@
+// 任务 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
+//
+// 说明:skins.ts 的 skinsDir() 按"该模块自身文件所在目录 + assets/pets"解析 manifest.json 路径
+// (设计意图见 skins.ts 注释:生产环境下 dist/skins.js 与 dist/assets/ 同级)。用 tsx 直接运行本脚本时,
+// 模块的 import.meta.url 指向 src/skins.ts,同级并无 assets/ 目录(真实素材放在 packages/pet-app/assets/,
+// 由构建脚本 copy-static.mjs 复制到 dist/assets/)。为了不修改 skins.ts 就能让 listSkinEntries() 在此
+// 场景下"真实读取"到 manifest.json,这里在调用前临时把 ../assets 镜像到 ./assets(与构建产物的目录关系
+// 完全一致),验证结束后在 finally 里删除,不在仓库里留下任何新增/改动的痕迹。
+import { cpSync, existsSync, rmSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const tempAssetsDir = path.join(__dirname, 'assets');
+const realAssetsDir = path.join(__dirname, '..', 'assets');
+const createdTempAssets = !existsSync(tempAssetsDir);
+if (createdTempAssets) {
+    cpSync(realAssetsDir, tempAssetsDir, { recursive: true });
+}
+const { createMoodTracker } = await import('./mood-tracker.js');
+const { listSkinEntries } = await import('./skins.js');
+const { UNIVERSAL_QUIPS, pickQuip } = await import('./quips.js');
+let passed = 0;
+const assert = (cond, msg) => {
+    if (!cond) {
+        console.error('✗ ' + msg);
+        process.exit(1);
+    }
+    passed++;
+    console.log('✓ ' + msg);
+};
+try {
+    // ── 场景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`);
+}
+finally {
+    if (createdTempAssets) {
+        rmSync(tempAssetsDir, { recursive: true, force: true });
+    }
+}

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,50 @@ 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;
+}
+/** 当前皮肤的状态专属文案池(manifest.json 的 stateQuips 字段),供 broadcastToRenderer 的 pickStateQuip 选取。 */
+function currentSkinStateQuips() {
+    return listSkinEntries().find((e) => e.id === currentSkinId)?.stateQuips;
+}
+/** 把 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 +470,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();

package/dist/mood-tracker-timing.test.js

@@ -0,0 +1,70 @@
+// createMoodTracker().evaluate() 的"立即求值"与"定时刷新文案"时序单测。
+// 覆盖 mood-tracker.ts 的四条分支(见该文件 evaluate 内部逻辑):
+//   1) mood 从 null → 非 null(“进入”新 mood):立即返回 {mood, quip}(不等 ticker)。
+//   2) mood 不变且非 null,未到 QUIP_REFRESH_MS(15000ms):返回 null(不重复推送)。
+//   3) mood 不变且非 null,达到 QUIP_REFRESH_MS(>=):返回新的 {mood(不变), quip(新文案)}。
+//   4) mood 从非 null → null(“退出”mood):立即返回 {mood: null}(不等 ticker);
+//      之后 mood 仍为 null 与上次一致 → 直接 return null(mood 为 null 时不进入文案刷新判断分支)。
+// pickQuip 内部用 Math.random() 挑文案,内容不可预测,只断言"是否有新结果"与 mood/quip 类型。
+// 运行:npx tsx packages/pet-app/src/mood-tracker-timing.test.ts
+import { createMoodTracker } from './mood-tracker.js';
+let passed = 0;
+const assert = (cond, msg) => {
+    if (!cond) {
+        console.error('✗ ' + msg);
+        process.exit(1);
+    }
+    passed++;
+    console.log('✓ ' + msg);
+};
+// ── 场景1:mood “进入”立即产生推送(不必等 ticker)───────────────────────
+// 注:flustered 判定是"滑动窗口"(见 mood.ts countInWindow,toolWindowMs 默认 10000ms),
+// 不是"状态持续不变"型判定(那类是 tired/urging/bored,用 currentStateSince,天然会随时间推移
+// 一直保持成立)。若只记 5 条 ts=0..4000 的 tool_call,窗口会在 now 推进过程中把早期事件滑出去
+// (例如 now=10001 时窗口 [1,10001] 只剩 4 条,已跌破阈值 5,mood 会提前变回 null,
+// 与场景2/3"mood 在 4000~19001 期间应保持 flustered 不变"的前提矛盾)。
+// 因此这里持续每隔 1000ms 记一条 tool_call 直到 ts=19000,以确保 flustered 的滑动窗口在
+// 整个测试所需的时间跨度内始终 ≥5 条,从而让 mood 保持不变、只测"文案刷新"这一件事。
+const tracker = createMoodTracker();
+for (let t = 0; t <= 19000; t += 1000) {
+    tracker.recordState('tool_call', t);
+}
+{
+    const r = tracker.evaluate(4000);
+    assert(r !== null && r.mood === 'flustered' && typeof r.quip === 'string', '场景1: 5 次 tool_call(10s 窗口内达阈值)→ evaluate 立即返回 {mood: "flustered", quip: string}');
+}
+// ── 场景2:mood 保持不变,未到 QUIP_REFRESH_MS(15000ms)→ 应返回 null ──────
+{
+    const r = tracker.evaluate(4001);
+    assert(r === null, '场景2a: mood 不变(仍 flustered),仅过 1ms(远小于 15000ms)→ evaluate 返回 null');
+}
+{
+    const r = tracker.evaluate(4000 + 15000 - 1); // 18999
+    assert(r === null, '场景2b: mood 不变,距上次推文案差 1ms 未到 15000ms 刷新阈值 → evaluate 返回 null');
+}
+// ── 场景3:mood 不变但达到 QUIP_REFRESH_MS(>=)→ 应重新推送新文案 ──────────
+{
+    const r = tracker.evaluate(4000 + 15000); // 19000,刚好达到刷新阈值(>=)
+    assert(r !== null && r.mood === 'flustered' && typeof r.quip === 'string', '场景3a: mood 不变,刚好达到 15000ms 刷新阈值(>=)→ evaluate 返回新的 {mood: "flustered", quip: string}');
+}
+{
+    const r = tracker.evaluate(19001);
+    assert(r === null, '场景3b: 刚刚才刷新过文案,立即再 evaluate(仅过 1ms)→ 返回 null');
+}
+// ── 场景4:mood 消失时也应立即推送一次 {mood: null},不等定时器 ────────────
+const tracker2 = createMoodTracker();
+tracker2.recordState('error', 0);
+tracker2.recordState('error', 100);
+{
+    const r = tracker2.evaluate(100);
+    assert(r !== null && r.mood === 'frustrated', '场景4a: 60s 窗口内 2 次 error(达阈值)→ evaluate 返回 {mood: "frustrated", ...}');
+}
+{
+    const r = tracker2.evaluate(100 + 60001); // 两次 error 事件均已滑出 60000ms 窗口
+    assert(r !== null && r.mood === null, '场景4b: error 事件滑出窗口,mood 从 frustrated 变为 null → evaluate 立即返回 {mood: null}(不等定时器)');
+}
+{
+    const r = tracker2.evaluate(100 + 60002);
+    assert(r === null, '场景4c: mood 仍为 null(与上次推送一致)→ evaluate 直接返回 null(mood 为 null 时不检查文案刷新)');
+}
+console.log(`\nOK: ${passed} passed, 0 failed`);