dsh-pet-live2d 2.1.0 → 2.3.0

package/lib/index.js

@@ -274,6 +274,88 @@ function normaliseSlots(raw) {
   return out
 }
 
+/**
+ * 名字里带这些字的部件算"头"：作者在 cdi3 里给每个部件起了中文名
+ * （`Part46` = 脸蛋、`Part57/58` = 眼睛、`Part14` = 头发、`Part45/68` = 耳朵…）。
+ */
+const HEAD_PART_NAME_HINTS = /头|脸|面|眼|眉|嘴|耳|发|eye|face|hair|head|ear|brow|mouth|cheek|nose/i
+
+/**
+ * 名字里带这些字的部件算"尾巴/翅膀"（这只宠物有 15 个：狐狸尾 / 猫尾 / 狼尾 / 大翅膀…，
+ * 都是可换的配件，同一时刻只有一个是显形的）。
+ */
+const TAIL_PART_NAME_HINTS = /尾|鳍|翅|翼|fin|tail|wing/i
+
+/**
+ * 从 cdi3 里按名字挑部件。
+ *
+ * 为什么要读 cdi3：摸头/摸尾巴要知道"哪些 drawable 是头、是尾巴"。原来浏览器半区用的是
+ * 写死的英文正则（`face|eye|mouth|…`），而这只模型的 drawable id 是 `Part46` 这种 ——
+ * **一个都匹配不上**，于是判定静默退化成"点哪都算头"。作者自己的中文名才是权威分类。
+ *
+ * @returns {string[]} 部件 id；没有 cdi3 或没挑到就是空数组（浏览器半区会退回旧行为）。
+ */
+function readPartsMatching(dir, modelPath, hints) {
+  try {
+    const base = modelPath.replace(/\.model3\.json$/i, '')
+    const file = findCdi3(dir, base)
+    if (file === undefined) return []
+    const cdi3 = readJson(file)
+    const parts = cdi3?.Parts
+    if (!Array.isArray(parts)) return []
+    const out = []
+    for (const part of parts) {
+      if (part === null || typeof part !== 'object') continue
+      const id = typeof part.Id === 'string' ? part.Id : undefined
+      if (id === undefined || id === '') continue
+      const name = typeof part.Name === 'string' ? part.Name : ''
+      if (!hints.test(name) && !hints.test(id)) continue
+      out.push(id)
+    }
+    return out
+  } catch {
+    return []
+  }
+}
+
+/**
+ * 找 cdi3.json。
+ *
+ * 它**不在** model3.json 的引用里（那是 Cubism Editor 的元数据，运行时不读），所以只能
+ * 按约定找：与模型同名的 `<base>.cdi3.json` 优先，其次模型旁边、再其次宠物目录和它的
+ * 直接子目录 —— 这只宠物就放在 `model/` 子目录里，只在根目录找会一个都挑不到。
+ */
+function findCdi3(dir, base) {
+  const direct = [join(dir, base + '.cdi3.json'), join(dir, 'model', base + '.cdi3.json')]
+  for (const file of direct) {
+    if (existsSync(file)) return file
+  }
+  const roots = [dir]
+  try {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (entry.isDirectory() && entry.name !== 'node_modules') roots.push(join(dir, entry.name))
+    }
+  } catch {
+    /* 读不了就只用 dir 本身 */
+  }
+  for (const root of roots) {
+    try {
+      const hit = readdirSync(root).find((name) => name.toLowerCase().endsWith('.cdi3.json'))
+      if (hit !== undefined) return join(root, hit)
+    } catch {
+      /* 跳过读不了的目录 */
+    }
+  }
+  return undefined
+}
+
+/**
+ * 互动反应候选：一串标签（动作的中文名，或表情名）。非字符串/空的都丢掉。
+ */
+function readReactionList(value) {
+  return Array.isArray(value) ? value.filter((name) => typeof name === 'string' && name !== '') : []
+}
+
 /** Scan one pet directory into a catalog entry, or undefined when unusable. */
 export function scanPet(dir, id) {
   const manifestFile = join(dir, 'pet.json')
@@ -426,6 +508,17 @@ export function scanPet(dir, id) {
     // premise is missing (a selfie with no phone out, a spray with no whale)
     // must not play at all, from ANY path: the panel, a fidget or a phase.
     motionGuards: typeof block.motionGuards === 'object' && block.motionGuards !== null ? block.motionGuards : {},
+    // 头部 / 尾巴部件（部件 id）：摸头、摸尾巴按这些部件的**真实几何**判定。
+    // 空数组 = 没 cdi3 或没挑到，浏览器半区退回旧行为。
+    headParts: readPartsMatching(dir, modelPath, HEAD_PART_NAME_HINTS),
+    tailParts: readPartsMatching(dir, modelPath, TAIL_PART_NAME_HINTS),
+    // 台词：宠物自己的声音（问候 / 点击 / 摸头 / 摸尾巴 / 转晕 / 归位 / 每个相位）。
+    // 用户能在设置里逐条改，改过的存浏览器；这里是**默认值**。
+    lines: typeof block.lines === 'object' && block.lines !== null ? block.lines : {},
+    // 互动反应候选（标签：动作的中文名或表情名）。摸头 / 摸尾巴 / 转晕各一组。
+    patReactions: readReactionList(block.patReactions),
+    tailReactions: readReactionList(block.tailReactions),
+    spinReactions: readReactionList(block.spinReactions),
     // 摸鱼默认盯哪几个槽位。以前这六个是**写死在浏览器半区**的（"宠物自己的身子"），
     // 但宠物作者（和用户）会想改：这只宠物把「自拍」也放进了摸鱼池。写在这里之后，
     // "默认集合"也成了宠物自己声明的东西，用户加的槽位照样覆盖在上面。
@@ -624,6 +717,12 @@ function catalogRoute() {
           expressionSlots: pet.expressionSlots,
           looksByPhase: pet.looksByPhase,
           motionGuards: pet.motionGuards,
+          headParts: pet.headParts,
+          tailParts: pet.tailParts,
+          lines: pet.lines,
+          patReactions: pet.patReactions,
+          tailReactions: pet.tailReactions,
+          spinReactions: pet.spinReactions,
           fidgetSlots: pet.fidgetSlots,
           hiddenMotions: pet.hiddenMotions,
           motionOptions: pet.motionOptions,
@@ -803,11 +902,16 @@ function runtimeRoute() {
 // comment frame.
 
 /** The activity phases the browser half understands. */
-export const ACTIVITY_PHASES = ['idle', 'thinking', 'waiting', 'tool', 'done', 'failed']
+export const ACTIVITY_PHASES = [
+  'idle', 'thinking', 'waiting', 'asking', 'tool', 'helper', 'queued', 'done', 'failed',
+]
 
 /** How long the 'done' celebration is held before falling back to idle. */
 const DONE_HOLD_MS = 3500
 
+/** "你的消息排队了"给一个短促的收到反应，然后回到原来在演的东西。 */
+const QUEUED_HOLD_MS = 1600
+
 /** SSE keep-alive interval. */
 const SSE_PING_MS = 30000
 
@@ -820,7 +924,7 @@ export class ActivityHub {
     this.phase = 'idle'
     this.detail = ''
     this.listeners = new Set()
-    this.doneTimer = undefined
+    this.holdTimer = undefined
   }
 
   /** Current snapshot (sent as the first frame of every stream). */
@@ -841,19 +945,30 @@ export class ActivityHub {
     this.emit()
   }
 
+  /**
+   * 演一个**短促反应**相位，过一会儿自动回落到 `fallback`。
+   *
+   * `done`（庆祝）和 `queued`（收到你排队的消息）都是这一类：宠物演一下，然后回到
+   * 它该在的地方。回落之前会确认相位没被别人接管 —— 这段时间里工具开始了、或者
+   * 新一轮说话了，就不要再把它拽回旧的 fallback。
+   */
+  hold(phase, ms, fallback = 'idle') {
+    if (this.holdTimer !== undefined) clearTimeout(this.holdTimer)
+    this.set(phase, '')
+    this.holdTimer = setTimeout(() => {
+      this.holdTimer = undefined
+      if (this.phase === phase) this.set(fallback, '')
+    }, ms)
+    // Keep the process free to exit; the timer is purely cosmetic.
+    this.holdTimer?.unref?.()
+  }
+
   /**
    * Enter the 'done' celebration and fall back to idle after a hold, so the
    * pet visibly finishes a turn instead of snapping straight back.
    */
   celebrate() {
-    if (this.doneTimer !== undefined) clearTimeout(this.doneTimer)
-    this.set('done', '')
-    this.doneTimer = setTimeout(() => {
-      this.doneTimer = undefined
-      this.set('idle', '')
-    }, DONE_HOLD_MS)
-    // Keep the process free to exit; the timer is purely cosmetic.
-    this.doneTimer?.unref?.()
+    this.hold('done', DONE_HOLD_MS, 'idle')
   }
 
   emit() {
@@ -868,9 +983,9 @@ export class ActivityHub {
   }
 
   dispose() {
-    if (this.doneTimer !== undefined) {
-      clearTimeout(this.doneTimer)
-      this.doneTimer = undefined
+    if (this.holdTimer !== undefined) {
+      clearTimeout(this.holdTimer)
+      this.holdTimer = undefined
     }
     this.listeners.clear()
   }
@@ -958,6 +1073,53 @@ export function attachActivityEvents(ctx, hub) {
     }, TOOL_IDLE_MS)
     return next()
   })
+
+  // ---- DSH 0.1.7 里另外三个值得接的状态 --------------------------------------
+  //
+  // 事件词汇表在 0.1.7 里已经不小（`*.d.ts` 里声明了 100 个可订阅事件），但只有一部分
+  // 能翻译成"宠物该演什么"。挑的标准是**它填的是不是一个真实的空档**：
+  //
+  //   asking  ← user-questions/request：以前"在等你回答问题"这段时间宠物还在演"干活"，
+  //             看着像它没停过 ✗ —— 这是最大的一个空档；
+  //   helper  ← subagent/start|end：子代理是**长活**（几分钟），和一次普通工具调用
+  //             混在一起看不出区别；
+  //   queued  ← agent/inbox/inserted：你发的话在它忙的时候插进来，现在至少给个"收到"。
+  //
+  // 没接的（评估过，不值得）：`fs/write-intent` / `edit-intent` —— 宠物在 tool 相位已经
+  // 演「写本本」了，再拆一个 editing 和它重复；`workflow/*` —— 工作流本身是工具调用，
+  // 已被 tool 覆盖（`workflow/phase` 的标题倒是可以当 detail，但宠物目前不显示 detail）；
+  // `agent/status` 只有 idle / running 两个值，给不出更细的东西。
+
+  // `user-questions/request` 是 waterfall：链一直挂到**你把问题答完**才 resume，所以
+  // 这个相位正好等于"卡在等你"的那段，不用自己计时。
+  onWaterfall('user-questions/request', (_request, next) => {
+    hub.set('asking', '')
+    const answered = typeof next === 'function' ? next() : undefined
+    const back = () => {
+      if (hub.phase === 'asking') hub.set('thinking', '')
+    }
+    if (answered !== null && typeof answered?.then === 'function') {
+      answered.then(back, back)
+      return answered
+    }
+    back()
+    return answered
+  })
+  on('subagent/start', (info) => {
+    const label = typeof info?.name === 'string'
+      ? info.name
+      : (typeof info?.label === 'string' ? info.label : '')
+    hub.set('helper', label)
+  })
+  on('subagent/end', () => {
+    if (hub.phase === 'helper') hub.set('thinking', '')
+  })
+  on('agent/inbox/inserted', () => {
+    // 回到"刚才在演的那个"（可能是 tool / asking，也可能是 idle）——不要一律回 idle，
+    // 那会让一个正在跑工具的回合看起来停了。
+    const previous = hub.phase
+    hub.hold('queued', QUEUED_HOLD_MS, previous === 'queued' ? 'thinking' : previous)
+  })
 }
 
 /** The activity stream + snapshot route. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pet-live2d",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Live2D 桌宠插件：为 DSH Web GUI 挂一只可拖动、会跟随鼠标、能换动作与表情的 Live2D 宠物。",
   "type": "module",
   "main": "lib/index.js",

package/pets/ds-whale-girl/pet.json

@@ -568,6 +568,22 @@
         "lhand": "橡皮",
         "symbol": "问号"
       },
+      "asking": {
+        "whale": "头顶鲸",
+        "rhand": "双手比耶",
+        "mood": "开心兴奋",
+        "symbol": "问号"
+      },
+      "helper": {
+        "whale": "头顶鲸",
+        "rhand": "喵喵手",
+        "mood": "调皮"
+      },
+      "queued": {
+        "whale": "头顶鲸",
+        "mood": "开心兴奋",
+        "symbol": "感叹号"
+      },
       "done": {
         "whale": "头顶鲸",
         "lhand": "橡皮",
@@ -594,6 +610,64 @@
         ]
       }
     },
+    "lines": {
+      "greet": [
+        "你好呀，我是鲸鱼娘～",
+        "今天也一起加油吧！",
+        "终于见到你了",
+        "摸鱼时间到？"
+      ],
+      "click": [
+        "呀！",
+        "痒痒的～",
+        "干嘛呀",
+        "摸摸头？",
+        "嘿嘿"
+      ],
+      "pat": [
+        "嘿嘿，好舒服～",
+        "再摸一下嘛",
+        "唔…头发要乱了"
+      ],
+      "tail": [
+        "呀！尾巴不能乱摸！",
+        "尾巴…痒痒的",
+        "别拽尾巴啦"
+      ],
+      "spin": [
+        "呜…转晕了…",
+        "别转了别转了"
+      ],
+      "reset": [
+        "表情归位～",
+        "清清爽爽"
+      ],
+      "loadFailed": [
+        "呜呜，模型加载失败了"
+      ],
+      "phase": {
+        "thinking": "让我想想…",
+        "tool": "正在忙…",
+        "waiting": "需要你确认一下",
+        "asking": "在等你回答哦",
+        "helper": "叫了帮手一起弄",
+        "queued": "收到，记下了",
+        "done": "搞定！",
+        "failed": "呜…出错了"
+      }
+    },
+    "patReactions": [
+      "重锤出击",
+      "问号",
+      "星星眼"
+    ],
+    "tailReactions": [
+      "吐魂",
+      "问号"
+    ],
+    "spinReactions": [
+      "晕晕"
+    ],
     "hiddenMotions": [
       "OpenCase",
       "BubbleGum"