前言¶
在 DSH 上做智能体开发时，最常见的交付物是一个文件、一段命令或者一个工具调用记录。想让桌面多少有点「在场感」，以前的做法是去找官方的 dsh-dafeiyu 一类桌宠，再想办法和现有 profile 调和窗口、端口、动作分组。dsh-dafeiyu-pet 把这件事切成了一个自带运行时和素材的独立插件：你装它，桌面就多一个蓝色鲸鱼娘，不装官方桌宠也不影响使用。
下面介绍这个由 lilulj 维护、社区目录归类为「趣味换装」的插件：定位、安装命令、配置字段、调用方式，以及它和 dsh-dafeiyu 的关系。
这是一个什么插件¶
一句话定位：dsh-dafeiyu-pet 是给 DSH 的 Windows 桌面加一个桌宠窗口的插件，自带 104 个动作、msedge-tts 语音和桌宠运行时，不依赖官方 dsh-dafeiyu。
- 维护者：lilulj
- 最新版本：1.0.4（见其
package.json） - 依赖：仅
msedge-tts（^2.1.1） - 许可：插件代码 MIT；素材来自
PC2005-cloud/dsh-pet（MIT）；运行时基于dsh-dafeiyu（MIT）改造 - 平台：Windows x64
它在社区目录中的分类是「趣味换装」。仓库里明确写了：本插件是非官方粉丝作品，与 DeepSeek 无关。社区目录本身也是独立站点，与 DeepSeek / 幻方没有官方从属关系，不是官方应用商店。
能做什么¶
按 README 的说明，能力分四块。
- 桌宠本身：出现在桌面上，透明背景、可拖动、有右键菜单和状态气泡。
- 跟随 DSH 的状态：在 DSH 里思考、调工具、完成、出错时，插件切对应动画。
- 动作：104 个动作，覆盖吃喝、玩乐、节日、情绪、工作、特效等大类，右键「播放动作」分 11 组。
- 语音：msedge-tts 合成，本机播放；配好 QQ 机器人可以把语音发成语音条。
它不需要 key。按 README 的说法，除了 QQ 语音条那一项需要填机器人配置，其余开箱即用。
安装前要留意的条件¶
README 列了三条前置条件，值得先看一遍再动手。
| 条件 | 说明 |
|---|---|
| Windows x64 | helper 是 Windows 可执行文件，本机播放用 MediaPlayer COM |
| 已装 DSH | 0.1.7 及以上 |
| 网络 | 首次启动要下载约 580MB 素材，国内建议开代理 |
这里有一处容易踩的坑。README 专门说明：官方桌宠 dsh-dafeiyu 不是 DSH 自带的，只有你以前装过才会有。如果装过，需要先禁用它，否则两只同时开会抢 7799 控制口、屏幕上出现两只。没装过的可以直接跳到挂载插件那一步。
安装与启用¶
安装分三步：装插件、（只对装过官方桌宠的人）禁用 dsh-dafeiyu、挂上引用、重启。命令和配置都取自 README。
1. 装插件¶
三种方式任选。下面这条是从 npm 装，也是 README 推荐的方式。
dsh plugin --profile desktop add dsh-dafeiyu-pet
也可以在 DSH 里走 设置 → 插件 → 添加插件，搜 dsh-dafeiyu-pet。想直接从 GitHub 拉则用：
dsh plugin --profile desktop add github:lilulj/dsh-dafeiyu-pet
手动方式是把整个 dsh-dafeiyu-pet 目录复制到 <DSH 数据目录>\profiles\desktop\node_modules\ 下。
第一次启动会自动下载约 580MB 素材（104 个动作加桌宠运行时），日志里有进度，只下一次。下载卡住时要注意：插件用系统 curl 下载，会自动走系统代理，所以先确认代理是开着的。
2. 装过官方桌宠才需要：禁用它¶
没装过 dsh-dafeiyu 的跳过这一步。装过的，编辑 <DSH 数据目录>\profiles\desktop\cordis.patch.yml，找到 dsh-dafeiyu 那一条，加一行 disabled: true：
- id: dsh-dafeiyu
name: dsh-dafeiyu
disabled: true # ← 加这一行
config:
...
3. 挂上插件¶
在同一个文件的末尾加引用：
- insert:
- id: dafeiyu-pet
name: dsh-dafeiyu-pet
用 dsh plugin add 装的话，这一步 DSH 通常会自动完成。装完检查一下文件里有没有这条，没有就手动加。
4. 重启 DSH¶
完全退出再打开，托盘里的进程也要退。第一次启动会慢十几秒，因为要把 Qt 运行库解压到数据目录。见到桌宠就成功了。
配置¶
两个入口，功能一样：DSH 设置里的左侧「大肥鱼桌宠」，或者浏览器打开 http://127.0.0.1:7811/。
必须先配的东西：没有。不填任何东西，桌宠、104 个动作、本机语音都正常。
想让语音发到 QQ 语音条，才需要填三项：AppID、AppSecret、OpenID。AppID 从 q.qq.com 创建的机器人拿，AppSecret 是创建时显示的那串且只显示一次，OpenID 是收语音条的人的 openid 而不是 QQ 号，在机器人日志的 Processing: scope=c2c peerId=... 里找。README 提醒每个人要用自己的机器人，AppSecret 不能共用。
其余选项都有默认值，默认配置一般不用动：
| 项 | 默认 | 什么时候改 |
|---|---|---|
| 待机活跃度 | 活泼（12–22 秒动一下） | 嫌闹改「安静」（45–90 秒） |
| 角色大小 / 气泡大小 | 0.6 / 0.8 | 觉得太大太小 |
| 动作延时 | 4500 毫秒 | 她话没说完就动 → 调大 |
| 自动触发动作 | 开 | 只想手动叫她 → 关掉 |
| 音色 / 语速 / 音调 | XiaoyiNeural / 1.08 / +6Hz | 声音不满意 |
保存后语音和动作在下次调用生效；角色大小、启用开关要重启 DSH 才生效。
怎么让桌宠动起来¶
按 README，有四条入口，覆盖手动、自动和跨端：
| 方式 | 说明 |
|---|---|
| 右键桌宠 | 「播放动作」子菜单，11 个分组 |
| 对话触发 | 插件往系统提示注入规则，你回完话她自己动 |
| 手动调用 | 向本机 7799 端口发请求 |
| QQ 里聊天 | 需要另装 @tencent-connect/dsh-qqbot |
手动调用的具体写法：
POST http://127.0.0.1:7799/play
{"clip":"ext_cat"}
想在 PowerShell 里列出全部可用动作，可以查它的健康接口：
Invoke-RestMethod http://127.0.0.1:7799/health | Select-Object -ExpandProperty clips
适用场景与注意¶
适合谁：用 DSH 0.1.7 及以上、想在 Windows 桌面上有一点动态反馈，或者想给智能体加一个会随工具调用状态切换的桌宠的人。如果你已经在用 dsh-dafeiyu，或者不想下载 580MB 素材，这个插件未必合适。
安装前应该做的检查：
- 看源码和许可。插件代码、角色素材、运行时三部分许可各不相同（MIT、MIT、基于 MIT 改造），光标素材来自 Chromium 项目、为 BSD-3-Clause。装之前确认你接受这些条款。
- 知道它以当前 dsh 进程的权限运行。插件在 DSH 进程内执行，helper 是 Windows 可执行文件，会创建桌面窗口、读本机语音设备、下载素材到数据目录。请先阅读源码再决定是否安装。
- 配置里有明文凭证。
<DSH 数据目录>\dafeiyu-pet\config.json保存设置，含 QQ AppSecret 明文，不要外发。 - 数据都在本地：该目录下还有
layout.json（窗口位置）、helper.log（桌宠日志）、voice/（最近 10 条语音临时文件）、tmp/（Qt 解压目录）。删掉整个目录即恢复默认设置和位置。
排障时先看两处日志：桌宠不出现，查 <DSH 数据目录>\dafeiyu-pet\helper.log 和 logs\desktop-next.log 里 dafeiyu-pet 相关行。第一次启动慢、右键菜单缺动作，也先看这两个文件和是否重启过 DSH。设置页 7811 打不开时，可以把环境变量 DAFEIYU_PET_SETTINGS_PORT 设成别的端口。
结尾¶
dsh-dafeiyu-pet 把桌宠做成一个自带动作、语音和运行时的独立插件，省掉了和官方 dsh-dafeiyu 抢端口、调素材这一步。如果你用的是 Windows x64、能接受首次下载约 580MB 素材，它基本是装完即用。目录页在 skillhub.cn，源码在 GitHub。
