dsh-pet-live2d 1.23.0

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "dsh-pet-live2d",
+  "version": "1.23.0",
+  "description": "Live2D 桌宠插件：为 DSH Web GUI 挂一只可拖动、会跟随鼠标、能换动作与表情的 Live2D 宠物。",
+  "type": "module",
+  "main": "lib/index.js",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "live2d",
+    "desktop-pet",
+    "桌宠"
+  ],
+  "files": [
+    "lib",
+    "src",
+    "docs",
+    "pets",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build:vendor": "esbuild src/vendor-entry.ts --bundle --format=iife --outfile=lib/live2d-vendor.js --minify --target=es2020"
+  },
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.1.5-rc.1"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.10",
+    "pixi.js": "8.19.0",
+    "untitled-pixi-live2d-engine": "1.3.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/A8Chann/dsh-pet-live2d.git"
+  },
+  "homepage": "https://github.com/A8Chann/dsh-pet-live2d#readme",
+  "bugs": {
+    "url": "https://github.com/A8Chann/dsh-pet-live2d/issues"
+  }
+}

package/pets/ds-whale-girl/LICENSE

@@ -0,0 +1,37 @@
+DS鲸鱼娘 — Live2D 模型素材
+================================================================================
+
+本目录下的一切美术内容（c_0120.moc3 / 贴图 / expressions / motions / model /
+catalog.json / 截图）采用：
+
+    CC BY-NC-SA 4.0
+    https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh
+
+    署名 — 非商业性使用 — 相同方式共享
+
+版权所有人
+--------------------------------------------------------------------------------
+  上善无形（上善）  鲸鱼娘角色形象原作，原创 OC「溟月」
+                    https://www.pixiv.net/users/62155430
+                    https://b23.tv/8h5L4xz
+
+  ZipZipPipe        加入 DeepSeek 元素的女仆鲸鱼娘二次设计
+                    https://www.pixiv.net/users/18604994
+                    https://b23.tv/Pnw6nG8
+
+  氵六青            本模型（Live2D 绑定 / 动作 / 表情）
+                    https://space.bilibili.com/11272072
+
+你可以：分享、改编。
+你必须：署名（并说明是否修改）、非商业性使用、以同一协议分发你的改编。
+
+注意
+--------------------------------------------------------------------------------
+Live2D 作者 氵六青 已授权本项目转载与开源本模型，但该授权**不能覆盖基础版权**：
+角色形象本身由 上善无形 与 ZipZipPipe 以 CC BY-NC-SA 4.0 发布，
+因此**非商业（NC）与相同方式共享（SA）条款依然有效**。
+
+商业使用需**分别**取得上述版权所有人的授权。
+
+Live2D Cubism Core（live2dcubismcore.min.js）为 Live2D Inc. 专有软件，
+不在本目录、也不在本仓库内。

package/pets/ds-whale-girl/README.md

@@ -0,0 +1,67 @@
+# DS鲸鱼娘 · Live2D 桌宠
+
+DSh 桌宠（`@linxin666/dsh-pet`）的 Live2D 宠物包。
+
+- 渲染器：`live2d`（Cubism 3/4）
+- 动作组：Idle / Hammer / BubbleGum / SprayWater / OpenCase / Selfie / SelfieQuick / Ketchup
+- 表情：44 个（情绪 20 / 配件 9 / 道具 15）
+- 许可：**CC BY-NC-SA 4.0**（署名 · **非商业** · 相同方式共享）—— 见本目录 `LICENSE`
+- 版权链：**上善无形**（角色原作「溟月」）→ **ZipZipPipe**（DeepSeek 女仆二创）→ **氵六青**（本模型，交流群 645169617）
+
+## 装扮槽位（状态切换分类）
+
+44 个表情现在**全部**归入 **17 个**槽位。其中六个是**装扮**（眼镜 / 发饰 / 魔爪 / 桌面摆设=巴菲 / 桌布 / 其他=手机换色）：
+它们跨启动记着，「归位」和会话相位都不动它们。其余槽位（手、眼、情绪、嘴、符号、氛围、脸红）是随时可换的表情。
+它们全部由模型的「通用按键 / C款动作开关」参数驱动，一个参数开一块美术；
+同时点亮两个不会「叠加」，只会打架。所以按**槽位**归类，每个槽位单选，
+选新的自动摘掉旧的：
+
+| 槽位 | 不选 | 可选项 |
+|---|---|---|
+| 眼镜 | 无 | 圆眼镜 / 方眼镜 / 椭圆眼镜 / 墨镜 |
+| 贴纸 | 无 | 猫猫 / 兔兔 / 蝴蝶结 |
+| 发饰 | 戴着 | 摘掉发箍 / 单边马尾 |
+| 桌布 | 白色 | 黑色 |
+| 魔爪 | 无 | 粉魔爪 / 白魔爪 |
+| 鲸鱼 | 无 | 头顶鲸 / 放桌上 |
+| 桌面摆设 | 无 | 巴菲 |
+| 右手 | 无 | 掏出手机 / 喵喵手 / 双手比耶 / 挤番茄酱 / 写本本 |
+| 左手 | 无 | 撤回 / 画笔 / 橡皮 / 蛋包饭 |
+| 眼部 | 默认 | 星星眼 / 爱心眼 / 呆呆眼 / 晕晕 / 阴暗 |
+| 情绪 | 平静 | 开心兴奋 / 悲伤 / 大哭 / 生气 / 调皮 / 闭眼口水 / 吐魂 |
+| 嘴部 | 闭嘴 | 吐舌 / 吹泡泡糖 |
+| 符号 | 无 | 问号 / 感叹号 / 流汗 |
+| 氛围 | 无 | 情绪花花 / 心跳 / 冒爱心 |
+| 脸红 | 否 | 脸红 |
+| 其他 | 无 | 手机换色 |
+| 点菜 | 无 | 点菜按下 |
+
+分类依据是**模型作者自己在 cdi3 里写的分组和中文名**，不是按文件名猜的：
+`ParamGroup29` 被作者命名为「C款动作开关（集中放置方便检查」，
+里面正好是 `point`(点菜板) / `danbaofan`(蛋包饭) / `phone`(手机手) /
+`phone7`(双手比耶) / `maoshou`(猫手) —— 一组互斥的手部状态。
+
+剩下 25 个是**可以叠加的情绪表情**（脸红 + 汗 + 问号 是合理的漫画组合），
+保持自由开关。
+
+引擎的表情管理器一次只持有**一个**表情（`currentExpression`），所以跨槽位叠加不能
+交给它。插件改成**自己按帧写参数**：在每个表达式 .exp3.json 声明的通道上做 Add 叠加，
+写入点是 `coreModel.saveParameters()` 之后——正是引擎自己那套表情流程所在的位置。
+
+关键在挂钩点：写在 `loadParameters()` 之后会被下一帧的 `saveParameters()` 一起快照进
+基线，于是「关不掉」（实测开关永远停在 1）；写在 `saveParameters()` 之后才是干净的一层，
+取消选择时下一帧自然就摘掉了。
+
+所以**六个槽位可以同时生效**，跟参考面板一致。
+
+槽位定义写在 `pet.json` 的 `live2d.expressionSlots`，换个宠物改这里就行。
+
+## 前置：Cubism Core
+
+Live2D 专有许可不允许再分发 Core 运行时，需要自行放置：
+
+```
+%DSH_HOME%\pets\.runtime\live2dcubismcore.min.js
+```
+
+从 Live2D 官方 Cubism SDK for Web 获取（`https://cubism.live2d.com/sdk-web/cubismcore/live2dcubismcore.min.js`）。

package/pets/ds-whale-girl/c_0120.model3.json

@@ -0,0 +1,249 @@
+{
+  "Version": 3,
+  "FileReferences": {
+    "Moc": "model/c_0120.moc3",
+    "Textures": [
+      "textures/texture_00.png",
+      "textures/texture_01.png"
+    ],
+    "Physics": "model/c_0120.physics3.json",
+    "DisplayInfo": "model/c_0120.cdi3.json",
+    "Motions": {
+      "Idle": [
+        {
+          "File": "motions/idle.motion3.json"
+        }
+      ],
+      "Hammer": [
+        {
+          "File": "motions/hammer.motion3.json"
+        }
+      ],
+      "BubbleGum": [
+        {
+          "File": "motions/bubble-gum.motion3.json"
+        }
+      ],
+      "SprayWater": [
+        {
+          "File": "motions/spray-water.motion3.json"
+        }
+      ],
+      "OpenCase": [
+        {
+          "File": "motions/open-case.motion3.json"
+        }
+      ],
+      "Selfie": [
+        {
+          "File": "motions/selfie.motion3.json"
+        }
+      ],
+      "SelfieQuick": [
+        {
+          "File": "motions/selfie-quick.motion3.json"
+        }
+      ],
+      "Ketchup": [
+        {
+          "File": "motions/ketchup.motion3.json"
+        }
+      ]
+    },
+    "Expressions": [
+      {
+        "Name": "脸红",
+        "File": "expressions/facial-red.exp3.json"
+      },
+      {
+        "Name": "爱心眼",
+        "File": "expressions/love-eyes.exp3.json"
+      },
+      {
+        "Name": "星星眼",
+        "File": "expressions/star-eyes.exp3.json"
+      },
+      {
+        "Name": "情绪花花",
+        "File": "expressions/sparkle.exp3.json"
+      },
+      {
+        "Name": "心跳",
+        "File": "expressions/heartbeat.exp3.json"
+      },
+      {
+        "Name": "开心兴奋",
+        "File": "expressions/excited.exp3.json"
+      },
+      {
+        "Name": "悲伤",
+        "File": "expressions/sad.exp3.json"
+      },
+      {
+        "Name": "大哭",
+        "File": "expressions/cry.exp3.json"
+      },
+      {
+        "Name": "生气",
+        "File": "expressions/angry.exp3.json"
+      },
+      {
+        "Name": "晕晕",
+        "File": "expressions/dizzy.exp3.json"
+      },
+      {
+        "Name": "流汗",
+        "File": "expressions/sweat.exp3.json"
+      },
+      {
+        "Name": "问号",
+        "File": "expressions/question.exp3.json"
+      },
+      {
+        "Name": "感叹号",
+        "File": "expressions/exclaim.exp3.json"
+      },
+      {
+        "Name": "阴暗",
+        "File": "expressions/gloomy.exp3.json"
+      },
+      {
+        "Name": "调皮",
+        "File": "expressions/naughty.exp3.json"
+      },
+      {
+        "Name": "闭眼口水",
+        "File": "expressions/drool.exp3.json"
+      },
+      {
+        "Name": "吐魂",
+        "File": "expressions/soul-out.exp3.json"
+      },
+      {
+        "Name": "吐舌",
+        "File": "expressions/tongue-out.exp3.json"
+      },
+      {
+        "Name": "呆呆眼",
+        "File": "expressions/blank-eyes.exp3.json"
+      },
+      {
+        "Name": "冒爱心",
+        "File": "expressions/heart-pop.exp3.json"
+      },
+      {
+        "Name": "圆眼镜",
+        "File": "expressions/glasses-round.exp3.json"
+      },
+      {
+        "Name": "方眼镜",
+        "File": "expressions/glasses-square.exp3.json"
+      },
+      {
+        "Name": "椭圆眼镜",
+        "File": "expressions/glasses-oval.exp3.json"
+      },
+      {
+        "Name": "墨镜",
+        "File": "expressions/sunglasses.exp3.json"
+      },
+      {
+        "Name": "头箍",
+        "File": "expressions/headband.exp3.json"
+      },
+      {
+        "Name": "单边马尾",
+        "File": "expressions/ponytail.exp3.json"
+      },
+      {
+        "Name": "蝴蝶结贴纸",
+        "File": "expressions/sticker-bow.exp3.json"
+      },
+      {
+        "Name": "猫猫贴纸",
+        "File": "expressions/sticker-cat.exp3.json"
+      },
+      {
+        "Name": "兔兔贴纸",
+        "File": "expressions/sticker-rabbit.exp3.json"
+      },
+      {
+        "Name": "头顶鲸",
+        "File": "expressions/whale.exp3.json"
+      },
+      {
+        "Name": "鲸鱼放桌上",
+        "File": "expressions/whale-on-desk.exp3.json"
+      },
+      {
+        "Name": "桌面巴菲",
+        "File": "expressions/parfait.exp3.json"
+      },
+      {
+        "Name": "蛋包饭",
+        "File": "expressions/omurice.exp3.json"
+      },
+      {
+        "Name": "桌面粉魔爪",
+        "File": "expressions/claw.exp3.json"
+      },
+      {
+        "Name": "魔爪换色",
+        "File": "expressions/claw-recolor.exp3.json"
+      },
+      {
+        "Name": "双手比耶",
+        "File": "expressions/hands-peace.exp3.json"
+      },
+      {
+        "Name": "喵喵手",
+        "File": "expressions/cat-paws.exp3.json"
+      },
+      {
+        "Name": "手机换色",
+        "File": "expressions/phone-recolor.exp3.json"
+      },
+      {
+        "Name": "深色桌布",
+        "File": "expressions/dark-tablecloth.exp3.json"
+      },
+      {
+        "Name": "画笔",
+        "File": "expressions/draw-brush.exp3.json"
+      },
+      {
+        "Name": "橡皮",
+        "File": "expressions/draw-eraser.exp3.json"
+      },
+      {
+        "Name": "撤回",
+        "File": "expressions/draw-undo.exp3.json"
+      },
+      {
+        "Name": "点菜按下",
+        "File": "expressions/menu-press.exp3.json"
+      },
+      {
+        "Name": "挤番茄酱",
+        "File": "expressions/ketchup-squeeze.exp3.json"
+      }
+    ]
+  },
+  "Groups": [
+    {
+      "Target": "Parameter",
+      "Name": "EyeBlink",
+      "Ids": [
+        "ParamEyeLOpen",
+        "ParamEyeROpen"
+      ]
+    },
+    {
+      "Target": "Parameter",
+      "Name": "LipSync",
+      "Ids": [
+        "ParamMouthOpenY"
+      ]
+    }
+  ]
+}