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文件中。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • 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 →

← 上一个 Prev Hermes-to-DSH 下一个 Next dsh-monitor →