本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-live2d-pets

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-live2d-pets

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 状态镜像：宠物实时反映 agent 思考 / 空闲 / 出错 / 完成 / 等审批（动画 + 气泡，SSE 推送）
• 人设台词：内置六种人设（傲娇 / 元气 / 天然呆 / 三无 / 温柔治愈 / 病娇），可在插件独有 JSONC 中自定义并热切换
• 互动陪伴：分部位触摸反应 / 鼠标跟随（头、眼、身体看向鼠标）/ 拖动停靠，任务完成庆祝；HitArea 不足时按包围盒五矩形空间回退分档
• 桌宠配置设置面板：DSH 设置 →「桌宠配置」，开关 / 尺寸 / 渲染帧率 / 人设 / 模型列表 / 开发者选项；标量设置写入 ~/.dsh/settings.yaml，自定义人设与自定义模型存于 ~/.dsh/live2d-pet/ 插件私有 JSONC 文件，即时生效
• 不打扰：默认右下角、小尺寸、可拖动、可隐藏、标签页隐藏暂停渲染、限帧渲染、低配降级静态头像

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

首次启动看不到宠物怎么办？

默认模型 Hiyori 从 jsDelivr CDN 拉取，需要联网；若失败宠物会显示静态头像占位，可去「桌宠配置」切换到内置 Haru/Mao/Mark/Natori 或换自定义模型。

怎么自定义人设台词？

打开设置 → 桌宠配置 → 人设区点「自定义人设 ↗」编辑 $DSH_HOME/live2d-pet/personas.jsonc，保存后回设置页点「↻ 重新读取」即时生效，无需重启。

怎么加自己的 Live2D 模型？

设置 → 桌宠配置 → 我的模型：填名称 + .model3.json 的 HTTP URL，或填写本机绝对路径（如 C:/models/foo/foo.model3.json），插件宿主会通过同源路由加载。

宠物会拖慢页面吗？

标签页隐藏或窗口失焦时自动暂停渲染；渲染帧率默认 30fps，可在设置面板改为 60 或不限制；低配机器加载失败时降级为静态头像。

拖动后位置会保存吗？

会的。拖动宠物到任意位置松手后停靠位置会持久化到 $DSH_HOME/live2d-pet.json，下次启动还在原位置。

只支持 Web GUI 吗？

是的。该插件的 dsh 清单声明 platform=web、inject=slots，需要 DSH Web GUI 与 host 路由；不适用于 headless/CLI 形态。

怎么卸载？

终端执行 dsh plugin --profile web remove dsh-live2d-pets；卸载后 ~$DSH_HOME/live2d-pet/ 下的个性化文件可手动清理。

第三方模型在本插件的许可风险如何？

插件默认 Hiyori 是 Live2D 官方示例模型，免费商用可、需标注著作权；自定义模型由用户自备，请遵守模型作者许可，非商用模型会被标注为"仅限非商用"。

— 源: plugin_wiki.faq_json

兼容性

• DSH: @deepseek-ai/cordis ^4.0.1 + dsh-client-runtime/dsh-host-webserver/dsh-client-ui-slots/dsh-settings ^0.1.0-rc.6
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则