dsh-pet-live2d-viola 1.0.0

package/assets/voice/README.txt

@@ -0,0 +1,139 @@
+# 内置语音
+
+这些文件随插件一起发布，播放时从**本地磁盘**读取，不依赖网络。
+
+| 文件 | 游戏内 cue | 台词 | 时长 | 触发时机 |
+|---|---|---|---|---|
+| `listening.opus` | `VoiceLive_14/Live_Miyako_Start_01` | 準備はできてます / 准备已经做好了 | 1.23 s | 收到消息（`listening` 阶段） |
+| `idle-marukun.opus` | `VoiceSystem_14/BandTop_Miyako_Common_03` | まるくんは私のお友達なんです / 丸君是我的朋友 | 2.57 s | 待机漂移，仅丸君动作可抽 |
+| `idle-common02.opus` | `VoiceSystem_14/BandTop_Miyako_Common_02` | よし、今週分は提出完了。次は宣伝イラスト / 好，这周的份提交了。再来是宣传插图。 | 4.57 s | 待机漂移，任何动作 |
+| `idle-levelup.opus` | `VoiceSystem_14/Growth_Miyako_LevelUP_01` | もっと鍛えなければ……！ / 要再多加锻炼才行……！ | 1.56 s | 待机漂移，任何动作 |
+| `thinking-comon.opus` | `VoiceLive_14/Live_Miyako_Combo_Comon_Call_01` | 気を抜いてはいけませんよ / 不可以松懈哦 | 1.52 s | `thinking`，30% 概率二选一 |
+| `thinking-gekisou.opus` | `VoiceLive_14/Live_Miyako_GekisouStart_Just_01` | 全神経を集中させて……！ / 必须全神贯注才行……！ | 1.95 s | 同上 |
+| `working-training.opus` | `VoiceSystem_14/Growth_Miyako_SpecialTraining_01` | フン！　戦の準備、できました！ / 哼！已经做好战斗的准备了！ | 3.08 s | `working`，30% 概率三选一 |
+| `working-combo.opus` | `VoiceLive_14/Live_Miyako_Combo_Comon_Res_01` | ここまで来たらあとは根性……！ / 事已至此就只能靠毅力了……！ | 1.99 s | 同上 |
+| `working-skill.opus` | `VoiceLive_14/Live_Miyako_LiveSkill_Comon_Res_01` | お任せください！ / 请交给我吧！ | 1.09 s | 同上 |
+| `done-fc.opus` | `VoiceLive_14/Live_Miyako_Finish_FC_01` | 練習した甲斐がありました / 平时的苦练总算没白费 | 1.73 s | `done`，每次完成必说，二选一 |
+| `done-score.opus` | `VoiceSystem_14/Result_Miyako_Score_SS_01` | すごく……楽しかった……！ / 真的……超开心……！ | 2.37 s | 同上 |
+
+## 触发逻辑
+
+### 待机漂移（12 秒一次）
+
+每个槽位从**一个加权集合**里抽一句，**可能抽到静默**：
+
+| 台词 | 权重 | 每小时 | 占位比 | 可抽条件 |
+|---|---|---|---|---|
+| `idle-marukun.opus` | 15（`chance` 0.45） | 10.7 | 3.6% | **仅**丸君动作（`mtn_mal_*`） |
+| `idle-common02.opus` | 15 | 39.4 | 13.1% | 任何动作 |
+| `idle-levelup.opus` | 15 | 39.4 | 13.1% | 任何动作 |
+| *（静默）* | 75 | — | 70.1% | 让槽位能不出声 |
+
+**有声合计 89.6 句/小时**（占 29.9% 的动作位）。数字由 `idle-voice-weights.mjs`
+从源码和模型的真实动作权重重算，并用 `verify-idle-model.mjs`（代数 vs 模拟）与
+`verify-idle-rate.mjs`（浏览器里真实抽取 3 万次）双向校验 —— **不要手改这张表**。
+
+**静默是必需的**：`pickPreferred` 对所有候选取归一化，所以没有静默候选的话，权重只能决定分配比例，
+她会在每个槽位都开口。`SILENCE_WEIGHT` 是「整体说得太频繁」的旋钮，它对每条台词一视同仁。
+
+**丸君台词为什么要额外的 `chance` 门**：它只在 63.6% 的槽位可抽（丸君动作占比），
+三条台词又共用同一个 `SILENCE_WEIGHT`，所以它的权重**表达不了**「就这一条，少说点」——
+降低它的权重只会把概率让给另外两条，降低静默权重会一起降。0.45 的二次门只作用于它自己。
+
+> ⚠️ 这张表曾经长期错误：算丸君台词的概率时分母**漏掉了它自己的权重**，把它高估了 14%
+> （12.3 而不是 10.7）。代数上看起来完全合理，是浏览器实测对不上才发现的。
+> 所以现在两个校验脚本都在，`verify-idle-model.mjs` 里还有一步专门断言「漏掉权重会被容差抓住」。
+
+### 每条台词借用的表情
+
+播放时切换表情，**播完变回原来那张脸**：
+
+| 台词 | 表情 | 说明 |
+|---|---|---|
+| `idle-marukun.opus` | 微笑 1 + 丸君微笑 | 合成表情 `exp_pair_smile_maru_smile.exp3` |
+| `idle-common02.opus` | 耍帅 1 + 丸君耍帅 1 | 合成表情 `exp_pair_kime_maru_kime.exp3` |
+
+两张脸（都子 + 丸君）要**同时**变，而运行时的 `ExpressionManager` 只维护**一个**当前表情，
+所以两个表情文件被**合并成一个**（由 `make-combined-expression.mjs` 生成，并注册进 `model3.json`）。
+两个源表情的参数集完全不相交（94 个面部参数 + 32 个 `ParamMaru*`），所以拼接不会冲突。
+
+计时用 `holdMs`（音频实测长度），**不用音频的 `ended` 事件** —— 后者在后台标签页不可靠，
+一旦不触发她就会一直保持那个表情。播放中用户手动选表情不会被恢复定时器覆盖。
+
+### thinking / working（每次动画）
+
+这两个阶段各有 **5%** 概率说一句，同一阶段内各条等概率，并且有两层间隔限制：
+
+```
+thinking  → thinking-comon  或  thinking-gekisou              （各 50%）
+working   → working-training 或 working-combo 或 working-skill （各 33%）
+```
+
+| 限制 | 量 | 作用 |
+|---|---|---|
+| `rate` | 5% / 每次动画 | 控制**总量** |
+| `PHASE_LINE_QUIET_MS` | 30 秒（**逐阶段**） | 播完该阶段自己的台词后，该阶段静默 30 秒 |
+
+**逐阶段静默窗**（`QUIET_PHASES = {thinking, working}`）的三个要点：
+
+- **从音频播完开始算**，不是从开始播算 —— 否则长句会吃掉自己的静默期
+- **逐阶段独立**，所以 `thinking` 说过话不影响 `working`
+- **只作用于这两个阶段**。`done` 刻意排除：它每次完成必说，若被这个窗拦下，会出现「有时候不说话」的难查故障
+
+> 曾经还有一个 **60 秒共享冷却**，现已移除。它强制任意两句之间间隔 60 秒，会让 `thinking` 和
+> `working` **无缘无故地互相压制**；而它本来要消除的「成串出现」已经由逐阶段静默窗解决了。
+
+**静默窗比比例更重要。** 比例是**按每次动画**算的，而连续的工具调用每两秒就重新进入 `working` ——
+每次都是独立掷骰，所以单靠比例会**成串出现**。静默窗从结构上消除了这一点（同一阶段 30 秒内不可能说第二次）。
+
+它不影响待机漂移的台词（那些由 12 秒的漂移节奏控制）。
+
+### done（每次完成）
+
+**每次完成必说一句**，两条等概率：
+
+```
+done → done-fc  或  done-score    （各 50%）
+```
+
+一次完成是一个回合的结束，不会像工具调用那样每两秒重复，所以**没有突发需要抑制**。
+它在 `PHASE_LINES` 里写作 `rate: 1`，
+否则刚说过话的 `thinking`/`working` 会把它静默掉。
+
+## 气泡时长
+
+**按各条音频的实际长度单独设置**（`VOICE_LINES` 里的 `holdMs` = 音频长度 + 约 0.33 秒），
+不是共用常量 —— 九条时长差 **4 倍**（1.09 s ~ 4.57 s），共用一个值会把长句截断、或让短句滞留。
+
+**每条语音都必须有 `VOICE_LINES` 条目**，否则会「听得到声音但看不到字」——
+`verify-thinking-voice` 会枚举文件与条目比对，漏了就失败。
+
+## 来源
+
+来自游戏资源，与 yatta.moe 角色页播放的是同一批文件：
+
+```
+https://bdon.yatta.moe/Resources/en/cri_assets_cri/sound/
+  voicelive_14/Live_Miyako_Start_01.opus            (11,910 字节)
+  voicesystem_14/BandTop_Miyako_Common_03.opus      (23,293 字节)
+  voicesystem_14/BandTop_Miyako_Common_02.opus      (35,942 字节)
+  voicesystem_14/Growth_Miyako_LevelUP_01.opus      (16,345 字节)
+  voicelive_14/Live_Miyako_Combo_Comon_Call_01.opus (14,161 字节)
+  voicelive_14/Live_Miyako_GekisouStart_Just_01.opus(19,448 字节)
+  voicesystem_14/Growth_Miyako_SpecialTraining_01.opus (24,010 字节)
+  voicelive_14/Live_Miyako_Combo_Comon_Res_01.opus  (20,766 字节)
+  voicelive_14/Live_Miyako_LiveSkill_Comon_Res_01.opus (12,223 字节)
+```
+
+URL 规则：把 cue 按 `/` 切开，**第一段转小写**，再接上
+`/Resources/en/cri_assets_cri/sound/`，最后加 `.opus`。
+
+## 格式
+
+Ogg Opus（`OggS` 容器，`content-type: audio/ogg`）。浏览器原生支持，无需解码库。
+时长可从 Ogg 最后一页的 granule position 推出（÷48000），校验脚本就是这么测的。
+
+## 版权
+
+语音版权归其原始权利人所有（Bushiroad / Craft Egg 及其许可方）。
+随本包提供仅供**个人、非商业的桌宠用途**，**不得再分发或用于商业目的**。

package/cordis.patch.yml

@@ -0,0 +1,18 @@
+# dsh-pet-live2d-viola bundle patch: inserts the plugin row into the web plugin roster.
+#
+# One row mounts both halves:
+#   - host half  (lib/index.js): the pet state machine, the session-activity
+#     bridge, the persisted display config and the asset/API routes.
+#   - client half (lib/client.js): the floating Live2D stage, plus the
+#     package-local runtime chunk lib/client.live2d.js, which the
+#     client-module loader serves from /plugins/dsh-pet-live2d-viola/.
+#
+# The row id must equal the exported plugin name in lib/index.js. The row name must equal the package
+# name AND the id the client module registers with, because the loader builds /plugins/<name>/ from it.
+#
+# Everything this pet owns is namespaced on that id -- /api/pet-live2d-viola, /pet-live2d-viola/assets
+# and ~/.dsh/pet-live2d/pet-live2d-viola.json -- so it can be installed alongside the other Live2D pet
+# without the two fighting over one route table and one saved record.
+- insert:
+    - id: pet-live2d-viola
+      name: dsh-pet-live2d-viola