Skip to content
  • Home
  • Plugin manual
  • dsh-live2d-pets

cyanfish-x/dsh-live2d-pets

61Last commit Aug 15, 2026

dsh-live2d-pets DSH plugin

dsh-live2d-pets adds a Live2D desktop pet to your DSH Web GUI. The pet reflects the agent's state (thinking, idle, error, completed, awaiting approval) with animations and speech bubbles. It supports multiple built-in models and custom models, offers six preset personas, and allows interactive touch and drag behaviors.

ui-productivity

How to install the dsh-live2d-pets DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-live2d-pets DSH plugin.

dsh-live2d-pets DSH plugin data source

dsh-live2d-pets DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-live2d-pets DSH plugin can do

  • Loads Live2D models from built-in presets (Hiyori, Haru, Mao, Mark, Natori) or custom .model3.json URLs (HTTPS/HTTP/local).
  • Real-time state mirroring of agent status (thinking, idle, error, completed, awaiting approval) with animations and speech bubbles via SSE.
  • Six preset personas with customizable dialogue, hot-swappable via JSONC configuration.
  • Interactive touch responses (head, hands, body, legs) with bounding box fallback, smooth mouse following, and draggable docking.

Where the dsh-live2d-pets DSH plugin fits

  • Enhance the DSH Web GUI with a cute pet that shows the agent's current activity.
  • Customize the pet's personality and model to create a unique companion.
  • Use the pet's state mirroring to quickly see if the agent is waiting for approval or busy.
  • Interact with the pet via touch and drag for a playful experience during idle time.

Who the dsh-live2d-pets DSH plugin is for

  • DSH users who want a visual and interactive companion for their agent.
  • Developers or users who enjoy customizing UI elements and adding personality to tools.

dsh-live2d-pets DSH plugin limitations

  • Only available in the DSH Web GUI; not supported in terminal or headless modes.
  • Requires network access for initial model loading (unless using a local HTTP server for custom models).

dsh-live2d-pets DSH plugin: from the repository README

Quoted from the cyanfish-x/dsh-live2d-pets README, the upstream source of the dsh-live2d-pets DSH plugin. Copyright remains with the original authors.

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 官方示例模型），首次加载需联网。 ### 互动 - **鼠标跟随**：默认

Read the full READMEThe repository declares no license. Check with the authors before using it.

dsh-live2d-pets DSH plugin questions

How do I install dsh-live2d-pets?

You can copy the prompt from the README and paste it into your DSH agent conversation, which will automatically install the plugin. Alternatively, run the command `dsh plugin --profile web add dsh-live2d-pets` in your terminal. After installation, start DSH with `dsh web` and the pet will appear in the bottom-right corner.

Can I use my own Live2D model?

Yes, you can add custom models. Open DSH Settings, go to 'Pet Configuration', then 'My Models'. Enter a name and the URL (HTTPS/HTTP) or local path to a `.model3.json` file. You can also optionally adjust spatial partition overlays for proper touch detection.

How do I change the pet's personality?

In the Pet Configuration panel, you can select one of the six built-in personas (tsundere, genki, etc.). For more customization, edit the file `$DSH_HOME/live2d-pet/personas.jsonc` and click 'Reload' in the settings to apply changes.

The pet is not showing up. What should I do?

First, ensure the plugin is installed by running `dsh plugin --profile web list`. Then check that the pet is enabled in DSH Settings > Pet Configuration > Show. Also make sure you are running the DSH Web GUI (`dsh web`) and the browser window is active.

Is the pet resource-heavy? Can I reduce performance impact?

The pet is designed to be lightweight. It uses a default frame rate of 30 FPS, auto-pauses when the tab is hidden, and falls back to a static avatar on low-end devices. You can also reduce the size (40–400px) or lower the frame rate in the settings to improve performance.