跳到正文
  • 首页
  • 插件说明
  • dsh-live2d-pets

cyanfish-x/dsh-live2d-pets

61最近提交 2026年8月15日

dsh-live2d-pets DSH 插件

dsh-live2d-pets 在 DSH Web GUI 中添加一只 Live2D 桌宠，实时反映 agent 状态（思考、空闲、出错、完成、待审批），带有动画和气泡。内置多种模型和六种人设，支持自定义模型和对话，提供触摸、拖拽等互动行为。

ui-productivity

如何安装 dsh-live2d-pets DSH 插件

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

复制不会执行命令。安装 dsh-live2d-pets DSH 插件前请核对仓库和版本。

dsh-live2d-pets DSH 插件数据来源

dsh-live2d-pets DSH 插件快照日期：2026年8月16日

discovered

dsh-live2d-pets DSH 插件能做什么

  • 加载内置模型（Hiyori、Haru、Mao、Mark、Natori）或通过 HTTPS/HTTP 地址或本地路径加载自定义 .model3.json 模型。
  • 通过 SSE 实时推送 agent 状态，以动画和气泡显示状态变化。
  • 内置六种人设（傲娇、元气、天然呆、三无、温柔治愈、病娇），支持在 JSONC 文件中自定义对话并热切换。
  • 触摸互动（头、手、身体、腿等部位，HitArea 不足时按包围盒回退），鼠标跟随（头、眼、身体看向鼠标），可拖动停靠。

dsh-live2d-pets DSH 插件适合哪些场景

  • 为 DSH agent 添加一个可爱的视觉伴侣，实时显示 agent 的工作状态。
  • 自定义桌宠的人设和模型，打造个性化陪伴。
  • 通过宠物的状态提示快速了解 agent 是否在等待审批或忙碌中。
  • 与桌宠互动（触摸、拖动），在工作间隙增添趣味。

dsh-live2d-pets DSH 插件适合谁

  • 希望为 DSH agent 增加视觉互动和陪伴感的用户。
  • 喜欢自定义 UI 和添加个性化元素的开发者或用户。

dsh-live2d-pets DSH 插件的限制

  • 仅在 DSH Web GUI 中可用，终端或无头模式不支持。
  • 首次加载模型需要网络（除非使用本地 HTTP 服务器提供自定义模型）。

dsh-live2d-pets DSH 插件的仓库 README 摘录

以下文字摘自 dsh-live2d-pets DSH 插件的上游仓库 cyanfish-x/dsh-live2d-pets 的 README，版权归原作者，仅作引用。

DSH（DeepSeek Harness）的 Live2D 桌宠插件：给 Agent 一只**有性格的陪伴**——状态跟着会话走，人设能换，模型可自带。 <p align="center"> <img src="docs/media/hero.jpg" alt="dsh-live2d-pets 主视觉" width="920" /> </p> ## 特性 - **模型加载**：内置 5 条策展模型（Hiyori / Haru / Mao / Mark / Natori）+ 自定义条目；可用任意 `.model3.json` 的 **https / http URL**，或本机可达的本地模型地址 - **状态镜像**：宠物实时反映 agent 思考 / 空闲 / 出错 / 完成 / 等审批（动画 + 气泡，SSE 推送） - **人设台词**：内置六种人设（傲娇 / 元气 / 天然呆 / 三无 / 温柔治愈 / 病娇），可在插件独有 JSONC 中自定义并热切换 - **互动陪伴**：分部位触摸反应 / 鼠标跟随（头、眼、身体看向鼠标）/ 拖动停靠，任务完成庆祝；HitArea 不足时按包围盒五矩形空间回退分档 - **桌宠配置设置面板**：DSH 设置 →「桌宠配置」，开关 / 尺寸 / 渲染帧率 / 人设 / 模型列表 / 开发者选项；写入 `~/.dsh/settings.yaml`，即时生效 - **不打扰**：默认右下角、小尺寸、可拖动、可隐藏、标签页隐藏暂停渲染、限帧渲染、低配降级静态头像 ## 快速开始 ### 方式一：复制提示词让 agent 安装（推荐） 把下面这段提示词复制给你的 DSH agent（在 Web GUI 对话中直接粘贴即可），它会自己安装并验证： ```text 请帮我安装 dsh-live2d-pets 插件（DSH 的 Live2D 桌宠插件）： 1. 执行 dsh plugin --profile web add dsh-live2d-pets 安装 2. 执行 dsh plugin --profile web list，确认 dsh-live2d-pets 出现在已安装列表中 3. 告诉我安装结果；如果失败，请附上错误信息 ``` ### 方式二：手动安装 在终端执行（`web` profile 首次使用时自动初始化）： ```sh dsh plugin --profile web add dsh-live2d-pets ``` 安装后插件默认启用。启动 DSH： ```sh dsh web ``` 浏览器打开后，右下角会出现默认宠物（尺寸 160px）。当前默认模型为 Hiyori（Live2D 官方示例模型），首次加载需联网。 ### 互动 - **鼠标跟随**：默认

阅读完整 README仓库未声明许可，使用前请先与作者确认。

dsh-live2d-pets DSH 插件常见问题

如何安装 dsh-live2d-pets？

你可以复制 README 中的提示词粘贴给 DSH agent，它会自动安装。或者手动在终端执行 `dsh plugin --profile web add dsh-live2d-pets`。安装后启动 DSH Web GUI，宠物会出现在右下角。

可以使用自己的 Live2D 模型吗？

可以。在 DSH 设置 →「桌宠配置」→「我的模型」中，添加名称和 .model3.json 的 URL（HTTPS/HTTP 或本地路径）。如有需要，还可以调整空间分区覆盖以优化触摸检测。

如何切换桌宠的人设？

在桌宠配置面板中，可以直接选择内置的六种人设（傲娇、元气等）。如需更个性化的对话，可以编辑 `$DSH_HOME/live2d-pet/personas.jsonc` 文件，然后点击设置中的「重新读取」即时生效。

宠物不显示怎么办？

首先确认插件已安装（`dsh plugin --profile web list` 查看列表）。然后检查 DSH 设置 →「桌宠配置」→「显示」开关是否打开。确保已启动 DSH Web GUI 且浏览器窗口处于活动状态。

桌宠会不会很耗性能？如何降低影响？

桌宠默认以 30 帧渲染，标签页隐藏时自动暂停，低配设备会降级为静态头像。你可以在设置中调整尺寸（40–400px）或降低帧率（30/60/不限制）来进一步节省性能。