cyanfish-x/dsh-live2d-pets

Name: cyanfish-x/dsh-live2d-pets
Author: cyanfish-x

Desktop桌面端 Native原生 ⭐ 27 Pets & Fun桌宠与娱乐 Prompts & Skills提示词与技能

Live2D 桌宠插件 for DeepSeek Harness：智能体状态镜像 + 互动陪伴，内置宽松许可预设模型

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a plugin built exclusively for DeepSeek Harness (DSH) that adds an interactive Live2D pet to DSH's web-based graphical user interface. It supports loading custom Live2D Cubism 4 models from remote HTTPS/HTTP URLs or local absolute file paths, and comes pre-loaded with 5 curated sample models from Live2D. The pet updates its animation and on-screen dialogue bubble to reflect the DSH agent's real-time status, including idle, thinking, error, and task completed states. It also adds a dedicated configuration panel directly within DSH's native settings menu for easy, in-app customization.

It is designed for DSH users who want to add a personalized, interactive companion element to their AI coding agent workflow. After installation, the pet appears by default in the bottom right corner of the browser window when you launch DSH's web interface. Users can toggle the pet on or off, adjust its size between 40 and 400 pixels, set a maximum render frame rate, switch between 6 built-in personality dialogue sets or add custom lines, and configure custom models with animation mapping and click area partitioning. All configuration changes take effect immediately without needing to restart DSH.

The plugin's source code is released under the open-source MIT license, and all built-in sample models are official Live2D demo assets that can be used for free for commercial purposes with proper copyright attribution. Any custom models added by users must follow the license terms set by the model's original creator. The plugin requires a Node.js environment to run, can be installed with a single command via DSH's built-in plugin manager, and includes performance optimizations like frame limiting and paused rendering when hidden to avoid excessive resource usage.

这是一款专为DeepSeek Harness（DSH）开发的原生插件，用于在DSH的网页GUI中添加一个可交互的Live2D桌宠。插件支持加载自定义Live2D Cubism 4模型，内置5个精选预设模型，可以实时反映agent的工作状态，还提供触摸反馈、鼠标跟随、拖动停靠等互动功能，并在DSH的设置菜单中新增了专属配置面板。

这款插件面向喜欢给开发工具添加个性化陪伴元素的DSH用户。安装后默认在浏览器打开DSH后右下角显示桌宠，用户可以通过设置面板调整桌宠的开关、尺寸、帧率，切换内置人设或添加自定义台词，还能添加自定义模型，配置动画映射和点击分区，修改后的配置即时生效无需重启。

插件代码基于MIT许可开源，内置预设模型均为Live2D官方示例，可免费商用但需要标注著作权，自定义模型需遵守对应模型的许可协议。插件依赖Node.js环境，通过DSH的插件管理器一键安装，支持低配机器限帧渲染、隐藏时暂停渲染，不会过度占用设备性能。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-live2d-pets（cyanfish-x/dsh-live2d-pets）
仓库：https://github.com/cyanfish-x/dsh-live2d-pets
本站详情页：https://www.yhbd.top/plugins/cyanfish-x-dsh-live2d-pets/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 27 · 最近提交 2026-09-24 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
27 stars - an early-stage project星标 27，属于早期项目
Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端：安装会下载可执行文件，请核对发布者与校验和

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

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

把 cyanfish-x/dsh-live2d-pets 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

7.2 KB · 缓存于 2026-09-24 22:08:58 · 7.2 KB

dsh-live2d-pets 🐾

English | 简体中文

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

dsh-live2d-pets 主视觉

特性

模型加载：内置 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 对话中直接粘贴即可），它会自己安装并验证：

请帮我安装 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 首次使用时自动初始化）：

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

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

dsh web

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

互动

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

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 cyanfish-x/dsh-live2d-pets 的 README.md。在 GitHub 查看原文 →