s17179XTY/dsh-BigfishPet
dsh-BigfishPet — DeepSeek Harness 桌宠插件
Project Overview项目介绍
This is a native desktop pet plugin built exclusively for DeepSeek Harness (DSH). It ports the popular Bigfish whale girl desktop pet into DSH as a first-class plugin, adding an interactive desktop pet that responds directly to DSH task status. DSH itself only runs as a web backend with a browser interface, so it lacks the ability to spawn native desktop windows. This plugin solves that gap by running a host inside the DSH backend that listens for standard session events, then spawns an independent transparent PySide6 window to display the pet, and it works out of the box after a one-line install.
The pet automatically changes its animation based on the current status of your DSH tasks. When a task is thinking or running, it shows a continuous eating animation; when the task is waiting, it naps; when a task completes successfully, it does a celebration animation; when there are no active tasks, it idles. After 3 minutes of idle time, it automatically goes to sleep, and you can wake it up by clicking it or when a new task starts. It supports dragging to reposition, random dialogue bubbles when clicked, and right-clicking to quickly minimize or restore the DSH host window, and is great for users who want a cute personalized decoration.
This plugin is released under the open-source MIT license. It requires Python and PySide6 to run the desktop helper window by default, but if your environment lacks these dependencies, you can use the included PowerShell build script to package the helper into a standalone EXE file that needs no extra dependencies. A common installation pitfall to avoid is manually adding duplicate loader entries to your profile configuration, which will cause a duplicate ID error and crash DSH on startup. Any changes require a restart to take effect, and all settings save automatically.
这是DeepSeek Harness(DSH)的原生桌宠插件,专为DSH添加可爱的鲸鱼娘桌宠功能。由于DSH本身不具备创建独立桌面窗口的能力,该插件运行于DSH后端,监听标准任务事件,派生独立的PySide6透明桌面窗口显示桌宠,仅需一行dsh plugin命令即可安装,安装完成后开箱即用。
该桌宠会根据DSH的实际任务状态切换动画:任务思考/运行时显示进食动画,等待时打盹,完成后庆祝,空闲时自动站立,空闲3分钟后自动进入睡眠。支持拖动调整位置,点击互动弹出随机台词,右键可以快速最小化或还原DSH宿主窗口,适合喜欢给DSH添加个性化桌面装饰的用户。
该插件遵循MIT开源许可协议,依赖Python和PySide6,若环境缺少依赖可使用内置脚本打包为独立exe使用。安装时请勿手动重复添加加载条目,否则会导致DSH启动崩溃,修改动画或配置后需要重启插件才能生效,状态和配置会自动保存到~/.dsh/pet.json文件中。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-BigfishPet(s17179XTY/dsh-BigfishPet)
仓库:https://github.com/s17179XTY/dsh-BigfishPet
本站详情页:https://www.yhbd.top/plugins/s17179xty-dsh-bigfishpet/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-08-19 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【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 更稳。
- Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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 github:s17179XTY/dsh-BigfishPet
把 s17179XTY/dsh-BigfishPet 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-BigfishPet — DeepSeek Harness 桌宠插件(鲸鱼娘 🐳)
这是针对 DeepSeek Harness 的通用桌宠插件,不是 Bigfish 应用或 DSH Desktop 的专属功能——Bigfish、DSH Desktop 都只是它运行于其中的壳。任何 DeepSeek Harness 环境只要执行一行 dsh plugin 命令即可安装:插件内置状态机 + 桌面 Helper(架构借鉴 dsh-dafeiyu),监听真实任务事件归约为 思考/工作/等待/完成/出错,通过 JSONL 协议驱动 PySide6 透明宠物窗口(runtime/helper.py)——窗口由插件自带并 spawn,与壳无关,装完即用。
桌宠原型来自 Bigfish(DeepSeek Harness 的第三方桌面壳),本插件把它插件化,成为 DSH 的一等公民:在 DSH 设置里直接调整,状态持久化、任务状态走真实信号。
这是什么
DeepSeek Harness 本身是 Web 后端 + 浏览器界面,没有创建桌面窗口的能力。本插件的 Host 跑在 DSH 后端里,监听标准 session/event 归约出真实状态,再 spawn 一个 PySide6 桌面 Helper(透明窗口)来显示鲸鱼娘:
| 部分 | 位置 | 职责 |
|---|---|---|
| DSH 插件(通用,必装) | 仓库根目录(lib/、package.json) |
DSH 设置里的「桌宠」页(显示/大小/气泡/活跃程度/走动冷却/减少动态/响应子 Agent/名字 等,即时保存);状态存 ~/.dsh/pet.json。内置状态机(lib/companion-reducer.js):session/event → 思考/工作/等待/完成/出错 + 阶段/待办/进度,输出 STATE/PULSE/TASK/TASKS 协议消息 |
| 桌面 Helper(自带,无需壳侧整合) | runtime/(PySide6)+ assets/(动画帧) |
透明置顶宠物窗口:大圆角状态卡、浅底深图形状态图标、程序化动作、拖动、右键 toggle 宿主、点击互动、空闲自动入睡。由插件 Host spawn,任何 DSH 环境都出现 |
功能
- 透明置顶窗口(
WA_TranslucentBackground,Qt 合成透明,本机已验证),鲸鱼娘悬浮桌面,Bigfish 隐藏/最小化也不消失; - 真实状态驱动:思考/工作/等待/完成/出错五态 + 阶段(查找/实现/验证/执行)+ 当前待办 + 真实进度(
已完成 3/5 步,无待办数据不编造);多任务时按 等待>出错>工作>思考 优先显示,≥2 个活跃会话时状态卡同时列出各任务; - 动画随状态:THINKING/WORKING(跑任务)→ eat 吃东西动画(持续循环);WAITING → sleep 打盹;SUCCESS → eat 庆祝;IDLE → idle 站立呼吸(待状态动作帧美术资源就位后可升级为每状态专属帧);
- 空闲自动入睡:IDLE 持续 3 分钟无任务 → 自动切 sleep 睡觉动画(与走动互斥,入睡后不再响应走动;任务消息到来或点击宠物立即唤醒切回 idle);可用环境变量
DSH_DAFEIYU_IDLE_SLEEP_MS调整(毫秒); - 鲸鱼公主台词库(旧版恢复):左键点击(摸头/尾巴/戳/双击)随机冒一句台词气泡;空闲时每 45–90 秒自言自语一句;
- 右键 = 打开/最小化宿主(无菜单):自动检测宿主进程(Bigfish.exe / DSH Desktop.exe)——找到则最小化/还原其主窗口;找不到(纯 WebUI 模式)则打开 WebUI(
http://127.0.0.1:3080/); - 状态卡气泡:常驻显示主文案 + detail 行(
项目 · 已完成 x/y 步 · 当前待办),dsh-dafeiyu 同款大卡片(30px 圆角白卡 + 浅灰细边框 + 右侧状态图标 + 原版阴影);显示规则由bubbleMode控制(常驻/隐藏/自定义状态); - 气泡贴住宠物:气泡底部按当前帧实际高度动态贴合宠物顶部(各状态帧高不同,不会离宠物过远);
- 拖动换位置(回写
~/.dsh/pet.json,设置页同步); - 设置页 dsh-dafeiyu 同款卡片式:每次改动即时保存,无「保存」按钮;底部只读展示当前状态机输出。
安装(一行命令)
插件是标准 DSH 插件,用 dsh plugin 命令安装(bundle 挂载):
# 在任意目录执行;profile 用你要装的目标环境(如 web)
dsh plugin --profile web add github:s17179XTY/dsh-BigfishPet
Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →
MemTensor/memmy-agent
OpenPetsHQ/openpets
QCYTSN/dsh-dafeiyu
vlln/whale-girl
ChisaAlter/WhaleIsle
Sutera-Diffusus/dsh-whale-musume
Yi-111-a/dsh-jingling
xiaoshihou514/dsh-desktop-pet