Sprite Pets

Sprite-Pets

本站前台默认是 spritesheet 桌宠，不是官方文档主推的 Live2D/Spine 看板娘。

	官方（05-扩展功能/Live2D-Spine模型.md）	本站
pioConfig Spine/Live2D	主题能力；文档详述	通常 enable: false
桌宠	无专章	spritePetConfig.enable: true

互斥规则

桌宠 · Spine · Live2D 最多开一个。
若多个 enable=true，运行时优先：桌宠 → Spine → Live2D。

配置入口

src/config/petConfig.ts（spritePetConfig）

键	含义（本站习惯）
enable	总开关
defaultPetId	浏览态默认宠（如 Maid）
postPetId	文章页固定宠（不随访客换皮覆盖）
pickerEnabled / pickerPetIds	访客换皮列表
position / offset / postOffset	位置；文章页加大 right 躲开浮动钮
size	显示宽度 px
responsive.hideOnMobilePost	窄屏文章页隐藏，避免挡正文

素材与许可：public/pets/ · public/pets/README.md
换皮/抓取说明：主仓 docs/knowledge/codex-pet-picker.md（若存在）。

点击桌宠弹问答浮窗

DEV 环境下，点击桌宠会弹出站点问答助手浮窗（MaxKB 驱动，基于博客内容回答问题）。生产当前 siteConfig.pages.ask = false，不挂载浮窗。

• 触发：MainGridLayout.astro 全局 click 委托 [data-pet-id] → pet:livechat:toggle
• 浮窗组件：LiveChatWidget.astro（全站挂载，默认隐藏，点桌宠才显形）
• 触发耦合：问答页开启但桌宠关闭时，独立 /ask/ 仍可用，桌宠浮窗没有入口。

详见 Ask-and-LiveChat。

想改回 Live2D/Spine？

1. 关 spritePetConfig.enable
2. 按官方 Live2D-Spine模型.md 配 pioConfig 与 public/pio/
3. 只开一种，本地验证 z-index 与移动端

官方文档怎么用

看板娘字段、模型路径、消息框 → 官方 Live2D 篇。
本站日常维护 → 只动 petConfig + public/pets/。