@linxin666/dsh-pet 0.3.17 → 0.3.19

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: ffee16de7b99b507daad27a7c8b8a8838ddcfbb2
-README.zh.md: c6f82762211fa7361ae27bb6fbb2d5fe066b284d
+README.md: f19d0d949df444336ce190e997225d1c055f44f0
+README.zh.md: 6cfd8504d95081b9399f1dc132c6854228515879

package/README.md

@@ -164,7 +164,9 @@ Model licensing: the official Live2D sample models (Hiyori, Haru, and friends) a
 
 Frames2d pets ship directory-style frame sequences instead of an atlas: `thumb/<track>/<frame>.webp`, with per-frame durations from an optional `_<ms>` filename tail or the track's `frameMs` list (default 200 ms, bounds 16–5000). The manifest maps the activity phases onto tracks; a `drag` track follows the chrome's drag gesture, and non-looping tracks settle into their `fallback` (default the idle track), so intro/loop splits (sleep-intro → sleep) are plain manifest data.
 
-A frames2d pet may declare a `gameplay` block — an opt-in mini-game layer generalized from the miku desktop pet: decaying stat bars (`stats` with per-minute decay, a working variant and an idle variant), the unified treat (小鱼干) currency — gameplay income and shop spending ride the same panel treat stock (capped at 20): `work` success, `passiveIncome` and lottery prizes grant treats, and shop items are priced and paid in treats, with no separate wallet page — a weighted `idleDirector` (rolls an act every `intervalMs`, `maxMiss` forces one after consecutive idle rolls), `touch` zones inside a `hitBox` (roll branches with effects, a track hold and phrase bubbles), a `work` loop (host-adjudicated ticks with success/fail result tracks), a `sleep` loop (lazy stat restore), `passiveIncome`, and a `shop` whose items carry effects or tiered lotteries. All rolls and bookkeeping are host-authoritative (`POST /api/pet/gameplay/*`); state persists per pet in `pet.json` and settles lazily on the treats-economy discipline. The browser half renders the menu card (stat bars, work/sleep toggles, shop grid) automatically for any pet that declares the block.
+A frames2d block may also declare **skins**: an optional array of `{ id, label, idleTrack }` entries. Selecting a skin swaps the pet's base idle target (the idle phase, unmapped phases and every fallback back to idle) onto `idleTrack`, so the resting look changes while gameplay tracks (shy/work/sleep…) stay attached to the default assets. Each skin may further declare `clickActions` — probability-rolled tap reactions exclusive to that skin (`{ track, probability, phrases? }`): while the skin is active, a tap rolls each action in declared order and plays the winner's track once on a hit, falling back to the plain click boost on a miss (never the default touch zones).
+
+A frames2d pet may declare a `gameplay` block — an opt-in mini-game layer generalized from the miku desktop pet: decaying stat bars (`stats` with per-minute decay, a working variant and an idle variant), the unified treat (小鱼干) currency — gameplay income and shop spending ride the same panel treat stock (capped at 20): `work` success, `passiveIncome` and lottery prizes grant treats, and shop items are priced and paid in treats, with no separate wallet page — a weighted `idleDirector` (rolls an act every `intervalMs`, `maxMiss` forces one after consecutive idle rolls), `touch` zones inside a `hitBox` (roll branches with effects, a track hold and phrase bubbles), a `work` loop (host-adjudicated ticks with success/fail result tracks), a `sleep` loop (lazy stat restore), `passiveIncome`, and a `shop` whose items carry effects or tiered lotteries. All rolls and bookkeeping are host-authoritative (`POST /api/pet/gameplay/*`); state persists per pet in `pet.json` and settles lazily on the treats-economy discipline. The browser half renders the menu card (stat bars, work/sleep toggles, skin picker, shop grid) automatically for any pet that declares the block. The sprite display size range is 32–1024 px.
 
 The **Miku pet** (contributed by stushansusu under MIT; Hatsune Miku character rights belong to Crypton Future Media under the Piapro Character License — see THIRD_PARTY_NOTICES.md) is the reference frames2d gameplay pet. It ships through the **Workshop** only (not the npm bundle): install it from the Workshop's pet list and it lands in `$DSH_HOME/pets/miku/`.
 
@@ -204,6 +206,8 @@ Host-side sibling plugins can push one structured announcement through the `pet`
 
 | Registry id | Selector label | Source |
 |---|---|---|
+| `blue-throated-bee-eater` | 蓝喉蜂虎 | Companion art contributed by the repository contributor under Apache-2.0 (12 AI-illustrated pose references in the palette of the blue-throated-bee-eater skin; composed by docs/archive/blue-throated-bee-eater-pet/gen-pet.py with per-track standalone poses: perched, flight, front hover, waving, landing, droop, tilt, review; ship 小蜜蜂 as the treat name) |
+| `jyn` | 女仆鲸鱼娘 | Frames2d gameplay pet (contributed by stushansusu under MIT): maid-whale desktop pet with work/sleep/touch gameplay and three selectable skins (暗夜鎏金 / 蓝海霓裳 / 冰晶公主), each with a probability-rolled click action; 暗夜鎏金 also swaps its own rest loop into the sleep gameplay | (docs(dsh-pet): list three jyn skins in the registry rows and re-record pairing)
 | `ouo-neko` | OUO Neko | Pink-sakura cat-eared companion contributed by `Pessimist0906` under MIT |
 | `whale-girl` | 鲸鱼娘（原版） | The repository's original whale-girl atlas |
 | `whale-girl-refined` | 鲸鱼娘（精致版） | An AI-assisted derivative with repaired and refined details, based on the whale-girl design direction |
@@ -224,6 +228,16 @@ Sprite pets use 8-column atlases with 192×208 cells generated by the [hatch-pet
 |---|---|---|---|
 | ![waving](assets/whale/previews/waving.gif) | ![review](assets/whale/previews/review.gif) | ![failed](assets/whale/previews/failed.gif) | ![running-left](assets/whale/previews/running-left.gif) ![running-right](assets/whale/previews/running-right.gif) |
 
+The built-in **Blue-throated Bee-eater** pet carries the same preview set:
+
+| idle | waiting | running | jumping |
+|---|---|---|---|
+| ![idle](assets/blue-throated-bee-eater/previews/idle.gif) | ![waiting](assets/blue-throated-bee-eater/previews/waiting.gif) | ![running](assets/blue-throated-bee-eater/previews/running.gif) | ![jumping](assets/blue-throated-bee-eater/previews/jumping.gif) |
+
+| waving | review | failed | move left/right |
+|---|---|---|---|
+| ![waving](assets/blue-throated-bee-eater/previews/waving.gif) | ![review](assets/blue-throated-bee-eater/previews/review.gif) | ![failed](assets/blue-throated-bee-eater/previews/failed.gif) | ![running-left](assets/blue-throated-bee-eater/previews/running-left.gif) ![running-right](assets/blue-throated-bee-eater/previews/running-right.gif) |
+
 The community **Starry Doll** pet (Workshop-only, contributed by Theater-ahyeon under CC-BY-NC-SA-4.0) ships the same preview set:
 
 | idle | waiting | running | jumping |
@@ -259,6 +273,7 @@ dsh-pet/
 |-- assets/whale/            # built-in original whale-girl (manifest + atlas + previews)
 |-- assets/whale-refined/    # built-in refined whale-girl registry variant
 |-- assets/ouo-neko/         # built-in OUO Neko v2 pet (11-row atlas + previews)
+|-- assets/blue-throated-bee-eater/  # built-in Blue-throated Bee-eater pet (9-row atlas + previews)
 `-- cordis.patch.yml         # bundle patch: inserts the pet plugin row
 ```
 

package/README.zh.md

@@ -164,7 +164,9 @@ Live2D 清单把七个活动相位映射到模型的动作组：
 
 frames2d 宠物不用图集，直接交付目录式帧序列：`thumb/<track>/<frame>.webp`，帧时长取文件名 `_<ms>` 尾缀或轨道的 `frameMs` 列表（默认 200ms，范围 16–5000）。清单把七个活动相位映射到轨道；`drag` 轨道跟随外壳的拖拽手势；非循环轨道播完进入 `fallback`（默认 idle 轨道），入睡/睡熟这类"引子 + 循环"拆分（sleep-intro → sleep）就是纯清单数据。
 
-frames2d 宠物可声明 `gameplay` 块——从 miku 桌宠泛化而来的可选玩法层：属性条（`stats`，按分钟衰减，另有打工中与空闲变体）、统一的小鱼干货币（玩法收入与商店支出都走宠物面板那条小鱼干库存，上限 20 条：`work` 成功、`passiveIncome` 与彩票奖品发放小鱼干，商品也以小鱼干标价扣款，无独立钱包页）、加权 `idleDirector`（每 `intervalMs` 掷骰演出小动作，连续落空 `maxMiss` 次必演）、`hitBox` 内的 `touch` 触摸分区（分支掷骰：效果 + 轨道保持 + 台词气泡）、`work` 打工循环（宿主裁决 tick，成功/失败结果轨道）、`sleep` 睡觉循环（惰性恢复）、`passiveIncome` 被动收入，以及 `shop` 商店（商品可带效果或分档抽奖）。所有掷骰与记账由宿主权威裁决（`POST /api/pet/gameplay/*`），状态按宠物持久化在 `pet.json`，沿用小鱼干经济的惰性结算纪律。浏览器半侧为声明了该块的宠物自动渲染玩法菜单卡（属性条、打工/睡觉开关、商店网格）。
+frames2d 块还可声明 **skins**（皮肤）：可选的 `{ id, label, idleTrack }` 数组。选中某皮肤后，宠物"回待机"的目标（idle 相位、未映射相位、以及一切回 idle 的 fallback）都切到该皮肤的 `idleTrack`——休息外观随皮肤切换，而玩法轨道（shy/work/sleep…）仍挂在默认资产上。每个皮肤还可声明 `clickActions`——仅对该皮肤生效的概率掷骰点击反应（`{ track, probability, phrases? }`）：皮肤激活时点击按声明顺序依次掷骰，命中则播一次命中轨道，未命中回落普通点击加成（绝不落入默认触摸分区）。
+
+frames2d 宠物可声明 `gameplay` 块——从 miku 桌宠泛化而来的可选玩法层：属性条（`stats`，按分钟衰减，另有打工中与空闲变体）、统一的小鱼干货币（玩法收入与商店支出都走宠物面板那条小鱼干库存，上限 20 条：`work` 成功、`passiveIncome` 与彩票奖品发放小鱼干，商品也以小鱼干标价扣款，无独立钱包页）、加权 `idleDirector`（每 `intervalMs` 掷骰演出小动作，连续落空 `maxMiss` 次必演）、`hitBox` 内的 `touch` 触摸分区（分支掷骰：效果 + 轨道保持 + 台词气泡）、`work` 打工循环（宿主裁决 tick，成功/失败结果轨道）、`sleep` 睡觉循环（惰性恢复）、`passiveIncome` 被动收入，以及 `shop` 商店（商品可带效果或分档抽奖）。所有掷骰与记账由宿主权威裁决（`POST /api/pet/gameplay/*`），状态按宠物持久化在 `pet.json`，沿用小鱼干经济的惰性结算纪律。浏览器半侧为声明了该块的宠物自动渲染玩法菜单卡（属性条、打工/睡觉开关、皮肤选择、商店网格）。精灵显示尺寸范围为 32–1024 px。
 
 **Miku 宠物**（stushansusu 涂山苏苏以 MIT 贡献；初音未来角色权利归 Crypton Future Media，受 Piapro 角色许可约束——见 THIRD_PARTY_NOTICES.md）是 frames2d 玩法的参考实现。它只经**创意工坊**分发（不打进 npm 包）：从工坊宠物列表安装后落在 `$DSH_HOME/pets/miku/`。
 
@@ -204,6 +206,8 @@ frames2d 宠物可声明 `gameplay` 块——从 miku 桌宠泛化而来的可
 
 | 注册表 id | 选择器名称 | 来源 |
 |---|---|---|
+| `blue-throated-bee-eater` | 蓝喉蜂虎 | 贡献者以 Apache-2.0 贡献的伙伴插画（12 张同角色 AI 立绘素材，配色取蓝喉蜂虎皮肤同源；由 docs/archive/blue-throated-bee-eater-pet/gen-pet.py 组装，各轨道独立姿态：栖枝/飞行/正面悬停/挥翅/降落/垂头/歪头/昂首；饲料以「小蜜蜂」命名） |
+| `jyn` | 女仆鲸鱼娘 | frames2d 玩法宠物（stushansusu 以 MIT 贡献）：带打工/睡觉/触摸玩法与三款可选皮肤（暗夜鎏金 / 蓝海霓裳 / 冰晶公主）的女仆鲸鱼同桌宠，每款皮肤各带一个概率掷骰点击动作；暗夜鎏金另将专属休息循环换入睡觉玩法 | (docs(dsh-pet): list three jyn skins in the registry rows and re-record pairing)
 | `ouo-neko` | OUO Neko | `Pessimist0906` 以 MIT 许可证贡献的粉色樱花猫耳伙伴 |
 | `whale-girl` | 鲸鱼娘（原版） | 仓库原有的鲸鱼娘图集 |
 | `whale-girl-refined` | 鲸鱼娘（精致版） | 以鲸鱼娘设计方向为基础，经 AI 辅助二次创作、修复和细节精修的衍生版本 |
@@ -224,6 +228,16 @@ Miku 宠物有意不随包内置：它是 frames2d 玩法宠物，经创意工
 |---|---|---|---|
 | ![waving](assets/whale/previews/waving.gif) | ![review](assets/whale/previews/review.gif) | ![failed](assets/whale/previews/failed.gif) | ![running-left](assets/whale/previews/running-left.gif) ![running-right](assets/whale/previews/running-right.gif) |
 
+内置的**蓝喉蜂虎**宠物随附同一套状态预览：
+
+| idle | waiting | running | jumping |
+|---|---|---|---|
+| ![idle](assets/blue-throated-bee-eater/previews/idle.gif) | ![waiting](assets/blue-throated-bee-eater/previews/waiting.gif) | ![running](assets/blue-throated-bee-eater/previews/running.gif) | ![jumping](assets/blue-throated-bee-eater/previews/jumping.gif) |
+
+| waving | review | failed | 左右移动 |
+|---|---|---|---|
+| ![waving](assets/blue-throated-bee-eater/previews/waving.gif) | ![review](assets/blue-throated-bee-eater/previews/review.gif) | ![failed](assets/blue-throated-bee-eater/previews/failed.gif) | ![running-left](assets/blue-throated-bee-eater/previews/running-left.gif) ![running-right](assets/blue-throated-bee-eater/previews/running-right.gif) |
+
 社区贡献的**星夜人偶**宠物（仅经创意工坊分发，Theater-ahyeon 以 CC-BY-NC-SA-4.0 贡献）随附同一套状态预览：
 
 | idle | waiting | running | jumping |
@@ -259,6 +273,7 @@ dsh-pet/
 |-- assets/whale/            # 内置原版鲸鱼娘（manifest + 图集 + 预览）
 |-- assets/whale-refined/    # 内置精致版鲸鱼娘注册表变体
 |-- assets/ouo-neko/         # 内置 OUO Neko v2 宠物（11 行图集 + 预览）
+|-- assets/blue-throated-bee-eater/  # 内置蓝喉蜂虎宠物（9 行图集 + 预览）
 `-- cordis.patch.yml         # bundle 补丁：插入宠物插件行
 ```
 

package/assets/blue-throated-bee-eater/pet.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://schemas.linxin666.org/dsh-pet/pet-manifest-v2.schema.json",
+  "petManifestVersion": 2,
+  "id": "blue-throated-bee-eater",
+  "displayName": "蓝喉蜂虎",
+  "author": "dsh-web",
+  "version": "1.0.0",
+  "description": "A chibi flat-illustration Blue-throated Bee-eater (Merops philippinus): azure throat, teal-green plumage and a chestnut crown, matched to the blue-throated-bee-eater skin palette. A perch-loving flyer that waves its wing, hops to catch bees and tilts its head to review your code.",
+  "license": "Apache-2.0",
+  "renderer": "sprite2d",
+  "sprite2d": {
+    "spritesheetPath": "spritesheet.webp",
+    "cell": {
+      "width": 192,
+      "height": 208
+    },
+    "columns": 8,
+    "atlasRows": 9,
+    "frames": [
+      6,
+      8,
+      8,
+      4,
+      5,
+      8,
+      6,
+      6,
+      6
+    ],
+    "tracks": {
+      "idle": {
+        "durations": [
+          500,
+          500,
+          600,
+          500,
+          500,
+          600
+        ]
+      },
+      "running-right": {
+        "durations": [
+          300,
+          300,
+          300,
+          300,
+          300,
+          300,
+          300,
+          400
+        ]
+      },
+      "running-left": {
+        "durations": [
+          300,
+          300,
+          300,
+          300,
+          300,
+          300,
+          300,
+          400
+        ]
+      },
+      "waving": {
+        "durations": [
+          450,
+          450,
+          450,
+          450
+        ]
+      },
+      "jumping": {
+        "durations": [
+          400,
+          400,
+          400,
+          450,
+          450
+        ]
+      },
+      "failed": {
+        "durations": [
+          550,
+          550,
+          550,
+          600,
+          650,
+          700,
+          550,
+          550
+        ]
+      },
+      "waiting": {
+        "durations": [
+          550,
+          550,
+          600,
+          550,
+          550,
+          600
+        ]
+      },
+      "running": {
+        "durations": [
+          330,
+          330,
+          330,
+          330,
+          330,
+          400
+        ]
+      },
+      "review": {
+        "durations": [
+          650,
+          650,
+          650,
+          650,
+          650,
+          650
+        ]
+      }
+    }
+  },
+  "sequences": {
+    "idle": [
+      "idle",
+      "waving",
+      "idle",
+      "waiting",
+      "idle",
+      "idle"
+    ],
+    "waiting": [
+      "waiting",
+      "idle",
+      "waving",
+      "waiting",
+      "idle",
+      "waiting"
+    ],
+    "thinking": [
+      "waiting",
+      "running",
+      "idle",
+      "running",
+      "waiting",
+      "running"
+    ],
+    "tool": [
+      "running-right",
+      "running",
+      "running-left",
+      "running",
+      "running-right"
+    ],
+    "review": [
+      "review",
+      "waiting",
+      "review",
+      "running",
+      "review",
+      "idle"
+    ],
+    "done": [
+      "jumping",
+      "waving",
+      "idle",
+      "waving",
+      "idle",
+      "waving"
+    ],
+    "failed": [
+      "failed",
+      "waiting",
+      "failed",
+      "idle",
+      "waiting",
+      "failed"
+    ]
+  },
+  "remarks": {
+    "pet": [
+      "挠挠头顶的栗红羽冠……舒服。",
+      "喉咙的湛蓝是向晴空借的颜色。",
+      "（警惕地看了看你手里有没有蜜蜂。）"
+    ],
+    "petCooldown": [
+      "刚刚才挠过啦。",
+      "羽冠要留给我自己理。"
+    ],
+    "feed": [
+      "嘿嘿，小蜜蜂！谢啦！",
+      "最爱的小蜜蜂来啦～"
+    ],
+    "feedCooldown": [
+      "吃饱啦，翅膀都收起来了。"
+    ],
+    "noTreats": [
+      "小蜜蜂没了……那我自己去抓两只吧。"
+    ]
+  }
+}

package/assets/blue-throated-bee-eater/voice.json

@@ -0,0 +1,13 @@
+{
+  "voicePackVersion": 1,
+  "panel": {
+    "stats": {
+      "treats": "小蜜蜂 {n}"
+    },
+    "actions": [
+      "feed",
+      "rename",
+      "hide"
+    ]
+  }
+}

package/contracts/pet-manifest-v2.schema.json

@@ -319,6 +319,90 @@
             "done": { "type": "string", "minLength": 1 },
             "failed": { "type": "string", "minLength": 1 }
           }
+        },
+        "skins": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "description": "Optional selectable skins: each swaps the base idle target (idle phase, unmapped phases and every fallback back to idle) to its own looping idle track. Gameplay tracks (shy/work/sleep...) are not replaced.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "label",
+              "idleTrack"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 24,
+                "pattern": "^[a-z0-9][a-z0-9-]*$",
+                "description": "Lowercase kebab skin id."
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 40,
+                "description": "User-facing skin name."
+              },
+              "idleTrack": {
+                "type": "string",
+                "minLength": 1,
+                "description": "A declared looping track that becomes the base idle while selected."
+              },
+              "clickActions": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 8,
+                "description": "Optional click-triggered actions exclusive to this skin: while selected, a tap rolls each action by probability (in order) and plays its track once if hit; misses fall through to the regular touch zones.",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "track",
+                    "probability"
+                  ],
+                  "properties": {
+                    "track": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "A declared track played once on hit (usually non-looping)."
+                    },
+                    "probability": {
+                      "type": "number",
+                      "exclusiveMinimum": 0,
+                      "maximum": 1,
+                      "description": "Hit probability for this action."
+                    },
+                    "phrases": {
+                      "type": "array",
+                      "minItems": 1,
+                      "maxItems": 5,
+                      "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 120
+                      },
+                      "description": "Optional lines spoken when the action fires."
+                    }
+                  }
+                }
+              },
+              "gameplayTracks": {
+                "type": "object",
+                "minProperties": 1,
+                "maxProperties": 8,
+                "description": "Optional gameplay-state overrides: gameplay state name (e.g. 'sleep' or 'work') -> a declared frames2d track swapped in while this skin is selected (e.g. a skin variant of the sleep loop).",
+                "additionalProperties": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "A declared frames2d track."
+                }
+              }
+            }
+          }
         }
       }
     },