dsh-live2d-pets

dsh-live2d-pets 🐾

English | 简体中文

给 DeepSeek Harness 请了个看板娘：你思考它歪头，你完成它撒花，还能摸头！

特性 模型加载：内置 5 条策展模型（Hiyori / Haru / Mao / Mark / Natori）+ 自定义条目；可用任意 .model3.json 的 https / http URL，或填写本机绝对路径（如 C:/models/foo/foo.model3.json，由插件 Host 转成同源 HTTP 加载）；自定义模型可配置动画映射，把模型原生动作组挂到状态/互动部位 状态镜像：宠物实时反映 agent 思考 / 空闲 / 出错 / 完成 / 交付 / 等审批（动画 + 气泡，SSE 推送） 人设台词：内置六种人设（傲娇 / 元气 / 天然呆 / 三无 / 温柔治愈 / 病娇），可在插件独有 JSONC 中自定义并热切换 互动陪伴：分部位触摸反应 / 鼠标跟随（头、眼、身体看向鼠标）/ 拖动停靠，任务完成庆祝；HitArea 不足时按包围盒五矩形空间回退分档 桌宠配置设置面板：DSH 设置 →「桌宠配置」，开关 / 尺寸 / 渲染帧率 / 人设 / 模型列表 / 开发者选项；标量设置写入 ~/.dsh/settings.yaml，自定义人设与自定义模型存于 ~/.dsh/live2d-pet/ 插件私有 JSONC 文件，即时生效 不打扰：默认右下角、小尺寸、可拖动、可隐藏、标签页隐藏暂停渲染、限帧渲染、低配降级静态头像 快速开始 方式一：复制提示词让 agent 安装（推荐）

把下面这段提示词复制给你的 DSH agent（在 Web GUI 对话中直接粘贴即可），它会自己安装并验证：

方式二：手动安装

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

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

浏览器打开后，右下角会出现默认宠物（尺寸 160px）。当前默认模型为 Hiyori（Live2D 官方示例模型），首次加载需联网。 互动 鼠标跟随：默认开启。鼠标在页面任意位置移动时，宠物的头、眼睛、身体会平滑看向鼠标；鼠标移出页面后复位正视前方。拖拽中不跟随，隐藏或页面失焦时自动暂停。 触摸互动：摸头 / 摸腿 / 摸手 / 摸身体各有专属台词与动作；模型 HitArea 不足时按包围盒空间分区回退。 拖动：按住宠物拖动到任意位置，松手后停靠并持久化。

自定义模型：打开设置 →「桌宠配置」→「我的模型」，填写名称与 .model3.json 地址（外网 CDN、自建静态站、本机 HTTP 服务，或本机绝对路径如 C:/models/foo/foo.model3.json 均可；本地路径由插件 Host 通过 /pet-local-models/... 同源路由加载）。可展开 「空间分区覆盖」 按字段微调五矩形（头/身/腿居中列 + 左右臂；0–1，留空用默认），或展开 「动画映射」 实时解析模型动作组，为状态/互动部位选择动作组；建议配合开发者选项「显示点击分区」对照色块。内置 Hiyori 已带居中分区预设。 配置设置

打开 DSH 设置 →「桌宠配置」，改完立刻生效，无需重启。 显示：开关宠物 尺寸：40–400px（默认 160） 渲染帧率：30 / 60 / 不限制（默认 30） 人设台词：切换内置或自定义人设；「自定义人设 ↗」编辑 $DSH_HOME/live2d-pet/personas.jsonc，改完点「↻ 重新读取」 模型：选内置策展模型，或在「我的模型」添加名称 + .model3.json URL（可选空间分区覆盖 / 动画映射）；自定义模型存于 $DSH_HOME/live2d-pet/custom-models.jsonc 开发者选项：总开关（默认关）；开启后可显示调试面板（含模型原生动画列表预览）、显示点击分区色块 卸载