dsh-live2d-pets：为 DeepSeek Harness 添加一只 Live2D 桌宠

dsh-live2d-pets 是 DeepSeek Harness（DSH）的 Live2D 桌宠插件（DSH plugin），由 cyanfish-x 维护，采用 MIT 协议，最近更新于 2026-08。它给 Agent 一只“有性格的陪伴”——宠物状态实时跟随会话，人设可换，模型可自带，让开发调试不再枯燥。核心能力包括：内置 5 条策展模型（Hiyori / Haru / Mao / Mark / Natori）并支持任意 .model3.json 的 URL 或本地地址；状态镜像（思考 / 空闲 / 出错 / 完成 / 等审批）通过 SSE 推送动画与气泡；六种人设台词（傲娇 / 元气 / 天然呆 / 三无 / 温柔治愈 / 病娇）可在 JSONC 中自定义并热切换；互动陪伴（分部位触摸、鼠标跟随、拖动停靠、任务庆祝）；以及不打扰设计（默认右下角、小尺寸、可隐藏、限帧渲染、低配降级静态头像）。

dsh-live2d-pets 这个 DSH plugin 支持哪些核心特性？

• 模型加载：内置策展模型 + 自定义条目，可用任意 .model3.json 的 https/http URL 或本机地址。
• 状态镜像：宠物实时反映 agent 状态（思考 / 空闲 / 出错 / 完成 / 等审批），动画 + 气泡，SSE 推送。
• 人设台词：内置六种人设，可在插件独有 JSONC 中自定义并热切换。
• 互动陪伴：分部位触摸反应、鼠标跟随（头、眼、身体）、拖动停靠、任务完成庆祝；HitArea 不足时按包围盒五矩形空间回退分档。
• 桌宠配置设置面板：DSH 设置 →「桌宠配置」，开关 / 尺寸 / 渲染帧率 / 人设 / 模型列表 / 开发者选项，写入 ~/.dsh/settings.yaml，即时生效。
• 不打扰：默认右下角、小尺寸、可拖动、可隐藏、标签页隐藏暂停渲染、限帧渲染、低配降级静态头像。

dsh-live2d-pets 怎么安装？

在终端执行（web profile 首次使用时自动初始化）：

dsh plugin --profile web add github:cyanfish-x/dsh-live2d-pets

安装后插件默认启用。启动 DSH：

dsh web

浏览器打开后，右下角会出现默认宠物（尺寸 160px）。当前默认模型为 Hiyori（Live2D 官方示例模型），首次加载需联网。

dsh-live2d-pets 怎么配置和使用？

打开 DSH 设置 →「桌宠配置」，改完立刻生效，无需重启。可配置：显示开关、尺寸（40–400px，默认 160）、渲染帧率（30 / 60 / 不限制，默认 30）、人设台词（切换内置或自定义，编辑 $DSH_HOME/live2d-pet-personas.json 后点「↻ 重新读取」）、模型（选内置或添加名称 + .model3.json URL，可选空间分区覆盖）、开发者选项（调试面板、显示点击分区色块）。

dsh-live2d-pets 的互动方式有哪些？

• 鼠标跟随：默认开启，鼠标移动时宠物的头、眼、身体平滑看向鼠标；移出页面后复位。拖拽中不跟随，隐藏或页面失焦时自动暂停。
• 触摸互动：摸头 / 摸腿 / 摸手 / 摸身体各有专属台词与动作；HitArea 不足时按包围盒空间分区回退。
• 拖动：按住宠物拖动到任意位置，松手后停靠并持久化。

dsh-live2d-pets 兼容哪些 DeepSeek Harness 版本和平台？

该插件基于 pixi-live2d-display 0.4.0 + PixiJS 6.5.10 + Cubism Core 4，客户端渲染于 DSH Web GUI 的 shell.overlay 悬浮层，设置页注册于 settings.section。状态推送通过 Host 订阅 agent/* 事件 → 同源 SSE /api/live2d-pet/events；设置持久化走 ctx.settings（~/.dsh/settings.yaml）。技术栈要求 Node.js 环境，支持现代浏览器（WebGL）。

dsh-live2d-pets 的许可和模型清单如何？

插件代码采用 MIT 协议。模型清单一律 URL 直载、不随包分发；清单门槛为「许可可标注」——每条记录许可类型与链接，NC（禁止商用）模型标注“仅限非商用”。

查看更多 DSH 插件，访问 dsh-plugin.org