前言¶
DSH 的插件生态强调「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。dsh-BFF-pet 是其中一个桌面宠物插件：用透明悬浮窗和 WebM 动画显示真实 Agent 状态。它由 DSH 自动拉起，复用 DSH 自身的 127.0.0.1:3080，没有独立应用入口，也不需要额外端口。
这是什么¶
dsh-BFF-pet 由 anyuinlara-bit 维护，项目许可证为 MIT。它解决的是一个具体问题：DSH 的 Agent 在后台执行任务时，开发者希望在桌面上有一个低干扰的状态提示，而不是反复切窗口查看。
一句话定位：DSH 桌面宠物插件，透明悬浮窗 + WebM 动画，由真实 Agent 状态驱动。
核心能力¶
下面介绍已核实的几类能力。
透明悬浮桌宠¶
桌面只显示宠物本身，没有背景块。窗口置顶，可任意拖拽。
Agent 状态驱动¶
插件会根据 DSH 的 Agent 状态实时切换动画与气泡，覆盖以下状态：
- 空闲
- 思考中
- 工作中（区分搜索、编辑、测试、命令）
- 等待确认
- 完成
- 错误
状态气泡与彩蛋¶
状态气泡在宠物上方显示当前状态文字。
彩蛋调度包括：
- 空闲随机彩蛋
- 早/中/晚餐时间彩蛋
- 长时间工作吃 Token
互动与托盘控制¶
点击可触发互动动画，拖拽会反馈悬空动画。
系统托盘和右键菜单支持：
- 触发彩蛋
- 显示隐藏
- 气泡开关
- 透明度
- 大小缩放
- 复位位置
- 退出
健壮性¶
已核实能力包括：
- 断连检测
- 错误可视化
- 状态回落
运行环境¶
Node¶
Node 要求为：
>=22.19
Electron¶
运行需要 Electron 运行时。程序不打包，也不强制安装方式。
运行模式¶
支持：
- 纯 Windows
- WSL2
安装与启用¶
资料未给出官方安装命令，本文不拼接具体命令。启用前可以先确认环境：
1、Node 版本满足 >=22.19。
2、本机有可运行的 Electron。
3、按运行模式准备 Electron 路径。
启用后，插件由 DSH 自动拉起，无需额外端口，复用 DSH 的 127.0.0.1:3080。
典型用法¶
纯 Windows¶
纯 Windows 使用者可先执行：
npm install electron
这一步会在本地得到 Windows 可用的 Electron。程序启动时按以下顺序定位 Electron：
ELECTRON_PATH
node_modules/electron/dist/electron.exe
bin/win32-x64/electron.exe
程序只负责找到并配对路径，不打包，不强制安装方式。
注意：在 WSL 下执行 npm install electron 得到的是 Linux 版，无法驱动 Windows 桌宠。
WSL2¶
WSL2 场景下，需要将 Windows 版 Electron 放入：
bin/win32-x64/
helper 会把 runtime 与 bin/ 同步到：
C:\Users\<user>\AppData\Local\dsh-BFF-pet\
然后启动桌宠。
托盘菜单¶
通过系统托盘或右键菜单可以执行：
- 触发彩蛋
- 显示隐藏
- 气泡开关
- 透明度
- 大小缩放
- 复位位置
- 退出
测试¶
可使用以下命令：
npm test
npm test:helper
npm run smoke
素材与许可¶
动画素材来自 dsh-pet，项目参考了 dsh-dafeiyu。
资料说明：
- 本项目的架构与代码为独立实现
- 动画素材复用自
dsh-pet dsh-pet与dsh-dafeiyu均为 MIT License- 使用时需遵循各自的许可条款，并保留版权声明
适用场景与注意¶
适合希望在 Windows 桌面观察 DSH Agent 状态、并且希望界面尽量不占用的开发者。
需要注意：
- 该插件需要 Electron 运行时，程序本身不打包。
- WSL2 下不能使用 Linux 版 Electron 驱动 Windows 桌宠。
- 插件由 DSH 拉起，以当前 DSH 进程权限运行，并复用 DSH 的本地端口；安装前应检查源码与许可证。
- 资料未确认 DSH 兼容版本、星标数、分类和目录页地址，本文不写这些信息。
结尾¶
dsh-BFF-pet 的价值在于把 DSH 的 Agent 状态映射到桌面，用透明悬浮窗和低干扰动画提示当前进展，同时不引入额外端口。
资料未确认目录页地址；已核实的 GitHub 仓库地址如下：
- https://github.com/anyuinlara-bit/dsh-BFF-pet
