前言¶

DSH 的理念是「一切皆插件」。在 Web GUI 场景中，除了命令执行和对话界面，也可以加入轻量交互组件。yuhao-pet 是一个 DSH Web 插件，由 dlpufan 维护，许可证为 MIT。它把一只叫「宇昊」的桌面宠物放进 DSH Web 桌面右下角，支持拖拽、投喂、洗澡、学习、打工等动作，并把 token 消耗转化为积分，用于购买道具。下面介绍它的核心功能、安装命令和典型用法。

这里写的是社区插件目录中的插件；社区目录是独立站点，与 DeepSeek 或幻方无官方从属关系，不是官方应用商店。

这是什么¶

一句话定位：DSH Web GUI 桌面宠物插件。

它主要解决三件事：

• 在 DSH Web 桌面里提供一个常驻、可拖拽、可隐藏的互动角色。
• 用五项状态、动作、道具和商店，把日常交互做成一个轻量养成流程。
• 把 token 消耗转化为积分，并允许积分购买食物、玩具、药品、学习、家具、特殊类道具。

立绘与角色设定来自 FurryBar 角色百科（画师 香瓜）。

核心功能¶

常驻、移动与隐藏¶

• 常驻 DSH Web 桌面右下角。
• 可拖拽，可隐藏。
• 隐藏时，如果装了赛博朋克主题插件，可收进右上角 HUD；否则收在右下角。

状态与动作¶

• 可执行投喂、玩耍、洗澡、吃药、学习、打工、睡觉等动作。
• 饱食、清洁、心情、健康、精力五项状态会随时间衰减。
• 状态变化会影响宠物表现，宠物会生病、会睡觉。
• 提供等级与经验，以及积分商店。

积分与背包¶

• 消耗 token 会自动攒积分。
• 积分商店包含食物、玩具、药品、学习、家具、特殊。
• 购买后的道具会进入背包，并在对应动作中使用。

AI 对话¶

• 可以主动搭话，并和 DeepSeek AI 对话。
• 对话历史记录本地持久化，并标注每条回复的触发来源。
• 配合赛博朋克主题插件时，切歌会评论新歌；在对话里说「切歌」可帮助切歌。

需要填写的配置项为：

DeepSeek API Key

立绘、表情与换装¶

• Spine 逐帧呼吸动态立绘，耳朵、头、尾巴、身体自然摆动。
• 7 种表情会随状态自动切换，也可被对话中的情绪词临时触发。
• 可切换旧版 Q 版立绘。
• 立绘大小支持大、中、小三档。
• 换装：穿衣、脱衣一键切换，立绘实时变化。
• 随机小动作：打喷嚏、左右张望眨眼、偷一些小东西。

互动工具¶

• 提供羽毛、手指、手掌、番茄四种互动工具。
• 点击身体不同部位会触发不同反应。

安装与启用¶

先在插件源码目录中切换到 yuhao-pet，再添加插件：

cd yuhao-pet
dsh plugin --profile web add .

安装完成后，重启并刷新：

dsh web

如果需要卸载：

dsh plugin --profile web remove yuhao-pet

宠物状态保留在以下路径：

<dshHome>/data/yuhao-pet/state.json

重装可继续；想彻底清除，需要手动删除该目录。

典型用法¶

1、左键点击宠物：打开属性面板。

2、右键点击宠物：打开菜单，可进入对话、商店、设置或执行各动作。

3、按住拖动：移动宠物位置。

4、互动：在菜单「互动」中选择羽毛、手指、手掌或番茄，再点击宠物身体部位。

5、AI 对话：在菜单「设置」中填写 DeepSeek API Key，然后在「对话」里聊，或点气泡下「回复」。

适用场景与注意¶

适合：

• 已经在用 DSH Web GUI，希望桌面里多一点轻量互动。
• 想用一个积分/道具机制感知 token 消耗。
• 想给对话、切歌、隐藏等场景加一层宠物交互。

注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码、行为与许可证。
• AI 对话需要配置 DeepSeek API Key。
• 切歌评论、说「切歌」切歌、隐藏时收进右上角 HUD 等功能，依赖赛博朋克主题插件。
• 本文只写已核实能力，不引用未核实的数据或字段。

链接¶

• 目录页：https://www.skillhub.cn/plugins/dlpufan/yuhao-pet
• GitHub：https://github.com/dlpufan/yuhao-pet