mocode-pet-app 1.6.0 → 1.7.0

package/dist/e2e-mood-check.js

@@ -3,9 +3,26 @@
 // 模拟 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';
+//
+// 说明: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) {
@@ -15,7 +32,7 @@ const assert = (cond, msg) => {
     passed++;
     console.log('✓ ' + msg);
 };
-(async () => {
+try {
     // ── 场景1:agent 长时间停留在 thinking(同理 tool_call)触发 tired ─────────
     // 每 5000ms 上报一次 thinking,ts: 0..60000。默认 tiredMs=60000。
     {
@@ -125,4 +142,9 @@ const assert = (cond, msg) => {
         }
     }
     console.log(`\nOK: ${passed} passed, 0 failed`);
-})();
+}
+finally {
+    if (createdTempAssets) {
+        rmSync(tempAssetsDir, { recursive: true, force: true });
+    }
+}

package/dist/main.js

@@ -196,6 +196,10 @@ ipcMain.handle('pet:get-skin', () => ({
 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) {

package/dist/quips.js

@@ -1,5 +1,7 @@
 // 通用文案池:各 mood 对应的中文吐槽短句,以及随机选取逻辑。
 // 皮肤可提供自定义文案(skinQuips)覆盖某个 mood 的候选池;未覆盖或为空时回退到通用文案池。
+// 另提供 pickStateQuip:PetState 维度的文案(独立于 mood,见 protocol.ts)——
+// 让皮肤对"任务完成 / 用户中断 / 报错"等瞬时状态也能挂个性化吐槽。
 /** 每种 mood 的通用吐槽短句候选池,语气轻松幽默(赛博终端风机器人设定)。 */
 export const UNIVERSAL_QUIPS = {
     frustrated: [
@@ -43,3 +45,15 @@ export function pickQuip(mood, skinQuips, pool = UNIVERSAL_QUIPS) {
     const list = skinList && skinList.length > 0 ? skinList : pool[mood];
     return list[Math.floor(Math.random() * list.length)];
 }
+/**
+ * 根据 PetState 选一条吐槽文案(独立于 mood 系统,见 quips.ts 顶部注释)。
+ * 命中条件:stateQuips 里该 state 有非空候选列表 → 随机选一条;否则返回 null。
+ * 返回 null 表示"该 state 在该皮肤下没有专属文案",调用方据此跳过推送(不影响主流程)。
+ * 纯函数,唯一的非确定性来源是 Math.random()。
+ */
+export function pickStateQuip(state, stateQuips) {
+    const list = stateQuips?.[state];
+    if (!list || list.length === 0)
+        return null;
+    return list[Math.floor(Math.random() * list.length)];
+}

package/dist/quips.test.js

@@ -1,7 +1,8 @@
-// 单测:pickQuip 的回退逻辑(皮肤池覆盖 / 未覆盖 / 空数组 / 未传皮肤池)。
+// 单测:pickQuip 的回退逻辑(皮肤池覆盖 / 未覆盖 / 空数组 / 未传皮肤池)
 // 覆盖 5 种 MoodKind,并验证多次随机调用不会跑出候选池范围。
+// + pickStateQuip 的命中 / 跳过逻辑(独立于 mood 系统,见 quips.ts 顶部注释)。
 // 运行:npx tsx packages/pet-app/src/quips.test.ts
-import { pickQuip, UNIVERSAL_QUIPS } from './quips.js';
+import { pickQuip, pickStateQuip, UNIVERSAL_QUIPS } from './quips.js';
 let passed = 0;
 const assert = (cond, msg) => {
     if (!cond) {
@@ -54,4 +55,44 @@ for (let i = 0; i < 20; i++) {
     const r = pickQuip('tired');
     assert(UNIVERSAL_QUIPS.tired.includes(r), `第 ${i + 1} 次调用 pickQuip('tired')→ 返回值 ∈ UNIVERSAL_QUIPS.tired(实际:"${r}")`);
 }
+// ── 7) pickStateQuip:皮肤池覆盖该 state(单条)→ 必然返回那条 ───────────────
+{
+    const stateQuips = { done: ['Twinkle! 任务完成 ✨'] };
+    const r = pickStateQuip('done', stateQuips);
+    assert(r === 'Twinkle! 任务完成 ✨', `pickStateQuip 皮肤池覆盖 done(单条)→ 返回皮肤池文案(实际:"${r}")`);
+}
+// ── 8) pickStateQuip:皮肤池覆盖该 state(多条)→ 20 次随机都在候选池内 ───────
+{
+    const list = ['Twinkle! 任务完成 ✨', '✦ DONE ✦', '任务收工'];
+    const stateQuips = { done: list };
+    for (let i = 0; i < 20; i++) {
+        const r = pickStateQuip('done', stateQuips);
+        assert(list.includes(r ?? ''), `pickStateQuip done(多条)→ 返回值 ∈ 皮肤池(实际:"${r}")`);
+    }
+}
+// ── 9) pickStateQuip:皮肤池未配置该 state → 返回 null ─────────────────────
+{
+    const stateQuips = { aborted: ['再见'] };
+    const r = pickStateQuip('done', stateQuips);
+    assert(r === null, `pickStateQuip 皮肤池未配置 done → 返回 null(实际:${JSON.stringify(r)})`);
+}
+// ── 10) pickStateQuip:皮肤池该 state 是空数组 → 返回 null(视为未配置) ───
+{
+    const stateQuips = { done: [] };
+    const r = pickStateQuip('done', stateQuips);
+    assert(r === null, `pickStateQuip done 为空数组 → 返回 null(实际:${JSON.stringify(r)})`);
+}
+// ── 11) pickStateQuip:未传 stateQuips → 返回 null ────────────────────────
+{
+    const r = pickStateQuip('error');
+    assert(r === null, `pickStateQuip 未传 stateQuips → 返回 null(实际:${JSON.stringify(r)})`);
+}
+// ── 12) pickStateQuip:8 种 PetState 全部可作为 key 命中,未命中返回 null ────
+{
+    const ALL_STATES = ['idle', 'thinking', 'speaking', 'tool_call', 'done', 'aborted', 'error', 'waiting_human'];
+    for (const state of ALL_STATES) {
+        const r = pickStateQuip(state);
+        assert(r === null, `pickStateQuip('${state}') 在空配置下 → 返回 null(实际:${JSON.stringify(r)})`);
+    }
+}
 console.log(`\nOK: ${passed} passed, 0 failed`);

package/dist/renderer/dom-mood.js

@@ -2,8 +2,10 @@
 // 不 import 'electron',不引用真实的全局 window/document,只操作调用方传入的、符合
 // "最小 DOM 元素形状"接口(ElementLike/LinkElementLike)的对象,使这部分逻辑可以脱离真实浏览器
 // 环境(本项目未安装 jsdom)被单元测试覆盖——与任务 4 里 main.ts → mood-tracker.ts 的抽取方式同构。
-/** 气泡文案自动淡出隐藏前的展示时长(design.md "情绪 → 演出的驱动"默认假设)。 */
-export const QUIP_VISIBLE_MS = 3000;
+/** 气泡文案自动淡出隐藏前的默认展示时长(design.md "情绪 → 演出的驱动"默认假设);
+ *  运行期可由 MOCODE_PET_QUIP_VISIBLE_MS 环境变量(经 preload.ts → window.petBridge.quipVisibleMs)覆盖,
+ *  不用重新打包就能调"宠物说一句话停多久"。 */
+export const QUIP_VISIBLE_MS = 6000;
 export const ALL_MOOD_CLASSES = [
     'mood-tired',
     'mood-bored',

package/dist/renderer/preload.js

@@ -3,6 +3,15 @@
 // 不给渲染进程任何 Node/Electron API 访问权限,只转发一个只读回调注册接口)。
 Object.defineProperty(exports, "__esModule", { value: true });
 const electron_1 = require("electron");
+/** 与 mood.ts 同样的环境变量读法:取合法正数,非法/缺失回退默认值。 */
+function envNumber(name, defaultValue) {
+    const v = process.env[name];
+    const n = v ? Number(v) : NaN;
+    return Number.isFinite(n) && n > 0 ? n : defaultValue;
+}
+/** 气泡文案展示时长(ms),环境变量 MOCODE_PET_QUIP_VISIBLE_MS 覆盖,默认 6000(2x 老值 3000)。
+ *  渲染进程 renderer.ts 在模块顶层读取该值,后续 showQuip 调用都使用它——启动后变更需重启 pet-app 生效。 */
+const QUIP_VISIBLE_MS = envNumber('MOCODE_PET_QUIP_VISIBLE_MS', 6000);
 electron_1.contextBridge.exposeInMainWorld('petBridge', {
     onState: (callback) => {
         electron_1.ipcRenderer.on('pet:state', (_event, payload) => {
@@ -18,6 +27,8 @@ electron_1.contextBridge.exposeInMainWorld('petBridge', {
     },
     /** 启动时主动拉取当前皮肤(避免 did-finish-load 推送与监听器注册之间的时序竞争)。 */
     getInitialSkin: () => electron_1.ipcRenderer.invoke('pet:get-skin'),
+    /** 气泡文案展示时长(ms),renderer.ts 在模块顶层读取一次后用于所有 showQuip 调用。 */
+    quipVisibleMs: QUIP_VISIBLE_MS,
     /** 主进程推来的 mood 求值结果(见 main.ts pushMoodEvaluation),mood 为 null 表示当前无需展示情绪演出。 */
     onMood: (callback) => {
         electron_1.ipcRenderer.on('pet:mood', (_event, payload) => {

package/dist/renderer/renderer.js

@@ -1,7 +1,9 @@
 // 渲染进程:纯展示逻辑,不含业务判断。接收 preload 暴露的 petBridge.onState 回调,
 // 按 PetState 切换外层容器的 CSS class,驱动 style.css 里定义的 @keyframes 动画。
 // mascot.svg 本身的呼吸灯/眨眼动画(inline <animate>)始终运行,不受这里的 class 切换影响。
-import { applyMood, applySkinMotion, createBubbleController, QUIP_VISIBLE_MS } from './dom-mood.js';
+import { applyMood, applySkinMotion, createBubbleController } from './dom-mood.js';
+/** 气泡文案展示时长,从 preload 经 MOCODE_PET_QUIP_VISIBLE_MS 环境变量注入,默认 6000(见 dom-mood.ts QUIP_VISIBLE_MS)。 */
+const QUIP_VISIBLE_MS = window.petBridge.quipVisibleMs;
 const ALL_STATE_CLASSES = [
     'pet-idle',
     'pet-thinking',
@@ -78,7 +80,9 @@ window.addEventListener('DOMContentLoaded', async () => {
     window.petBridge.onSkin(({ assetPath, motionFile }) => swapSkin(petContainer, assetPath, motionFile));
     window.petBridge.onMood((mood, quip) => {
         applyMood(stage, mood);
-        if (mood !== null && quip)
+        // 状态文案(由 main.ts broadcastToRenderer 选 stateQuips 推送过来)和 mood 文案共用同一条 IPC;
+        // 状态文案的 mood 字段为 null,只要 quip 存在就展示;mood 文案按之前的语义(mood 命中)也展示。
+        if (quip)
             bubbleController.showQuip(bubbleEl, quip, QUIP_VISIBLE_MS);
     });
     // 拖拽放置:窗口默认鼠标穿透(见 main.ts setIgnoreMouseEvents(true,{forward:true})),

package/dist/skins.js

@@ -10,11 +10,14 @@ let cached = null;
 export function skinsDir() {
     return path.join(__dirname, 'assets', 'pets');
 }
-/** 从 manifest 里单个 pet 条目对象中,宽容解析出 motionFile/quips 两个可选字段。
+/** 从 manifest 里单个 pet 条目对象中,宽容解析出 motionFile/quips/stateQuips 三个可选字段。
  *  纯函数,不涉及文件 I/O,便于单元测试覆盖各种非法输入的容错行为。
  *  - motionFile:必须是 string,否则不设置该字段。
  *  - quips:必须是非 null 对象;逐个 key 校验 value 是否为 string[],非法 key 被跳过;
- *    若最终没有任何合法 key,则不设置 quips 字段。 */
+ *    若最终没有任何合法 key,则不设置 quips 字段。
+ *  - stateQuips:与 quips 同结构(只是 key 集合是 PetState 而非 MoodKind);
+ *    所有 key 都会被原样保留(parseClientMessage 已对 PetState 做合法性校验,这里不做二次校验
+ *    以避免重复维护合法状态列表),但仍逐个校验 value 必须是 string[]。 */
 export function parseSkinEntryExtras(pp) {
     const result = {};
     if (typeof pp.motionFile === 'string') {
@@ -33,6 +36,19 @@ export function parseSkinEntryExtras(pp) {
             result.quips = quips;
         }
     }
+    if (typeof pp.stateQuips === 'object' && pp.stateQuips !== null) {
+        const rawStateQuips = pp.stateQuips;
+        const stateQuips = {};
+        for (const key of Object.keys(rawStateQuips)) {
+            const value = rawStateQuips[key];
+            if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
+                stateQuips[key] = value;
+            }
+        }
+        if (Object.keys(stateQuips).length > 0) {
+            result.stateQuips = stateQuips;
+        }
+    }
     return result;
 }
 /** 读取 manifest.json 里的候选皮肤列表(带内存缓存,manifest 在运行期不会变化)。 */
@@ -64,6 +80,8 @@ export function listSkinEntries() {
                     entry.motionFile = extras.motionFile;
                 if (extras.quips !== undefined)
                     entry.quips = extras.quips;
+                if (extras.stateQuips !== undefined)
+                    entry.stateQuips = extras.stateQuips;
                 entries.push(entry);
             }
         }

package/dist/skins.test.js

@@ -1,4 +1,4 @@
-// 单测 parseSkinEntryExtras:对 manifest 单个 pet 条目里 motionFile/quips 字段的宽容解析。
+// 单测 parseSkinEntryExtras:对 manifest 单个 pet 条目里 motionFile/quips/stateQuips 字段的宽容解析。
 // 纯函数、无文件 I/O,覆盖各种合法/非法输入的容错行为。
 // 运行:npx tsx packages/pet-app/src/skins.test.ts
 import { parseSkinEntryExtras } from './skins.js';
@@ -70,4 +70,43 @@ const assert = (cond, msg) => {
     assert(r.quips === undefined, '其余字段解析不受影响时,quips 仍为 undefined');
     assert(Object.keys(r).length === 0, '两字段皆缺失时返回空对象 {}');
 }
+// ── stateQuips 字段解析覆盖 ────────────────────────────────────────────────
+// 10) stateQuips 是合法对象 → 保留
+{
+    const r = parseSkinEntryExtras({
+        stateQuips: { done: ['Twinkle! 任务完成 ✨'], aborted: ['再见'] },
+    });
+    assert(JSON.stringify(r.stateQuips) === JSON.stringify({ done: ['Twinkle! 任务完成 ✨'], aborted: ['再见'] }), 'stateQuips 为合法对象时按原样保留');
+}
+// 11) stateQuips 不是对象(字符串/数字/数组/null)→ 不设置
+{
+    assert(parseSkinEntryExtras({ stateQuips: 'foo' }).stateQuips === undefined, 'stateQuips 为字符串时不设置该字段');
+    assert(parseSkinEntryExtras({ stateQuips: 42 }).stateQuips === undefined, 'stateQuips 为数字时不设置该字段');
+    assert(parseSkinEntryExtras({ stateQuips: ['done'] }).stateQuips === undefined, 'stateQuips 为数组(无对象结构)时不设置该字段');
+    assert(parseSkinEntryExtras({ stateQuips: null }).stateQuips === undefined, 'stateQuips 为 null 时不设置该字段');
+}
+// 12) stateQuips 数组元素含非字符串 → 该 key 跳过,合法 key 保留
+{
+    const r = parseSkinEntryExtras({
+        stateQuips: { done: ['ok', 123], aborted: ['ok'] },
+    });
+    assert(r.stateQuips !== undefined, 'stateQuips 存在合法 key 时应设置该字段');
+    assert(r.stateQuips.done === undefined, 'stateQuips 非法 key(done)被跳过');
+    assert(JSON.stringify(r.stateQuips.aborted) === JSON.stringify(['ok']), 'stateQuips 合法 key(aborted)被保留');
+}
+// 13) stateQuips 是空对象 → 不设置
+{
+    assert(parseSkinEntryExtras({ stateQuips: {} }).stateQuips === undefined, 'stateQuips 为空对象(无 key)时不设置该字段');
+}
+// 14) 三字段同时存在 → 互不影响
+{
+    const r = parseSkinEntryExtras({
+        motionFile: '11.motion.css',
+        quips: { tired: ['困'] },
+        stateQuips: { done: ['完成'] },
+    });
+    assert(r.motionFile === '11.motion.css', '三字段同时存在时 motionFile 保留');
+    assert(JSON.stringify(r.quips) === JSON.stringify({ tired: ['困'] }), '三字段同时存在时 quips 保留');
+    assert(JSON.stringify(r.stateQuips) === JSON.stringify({ done: ['完成'] }), '三字段同时存在时 stateQuips 保留');
+}
 console.log(`\nOK: ${passed} passed, 0 failed`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-pet-app",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "mocode 桌宠:独立 Electron 悬浮窗,展示 agent 执行状态动画。作为 mocode-ai 的可选子包,不随主包安装强制拉取。",
   "private": false,
   "type": "module",