前言¶

使用 DeepSeek Harness（DSH）运行智能体任务时，任务状态通常来自 session/event。如果希望在桌面直接看到“思考 / 工作 / 等待 / 完成 / 出错”，可以把它做成 DSH 插件，而不是单独维护一个桌面应用。

dsh-BigfishPet 是针对 DeepSeek Harness 的通用桌宠插件。仓库归属 s17179XTY，许可证为 MIT。它可运行于任意 DSH 环境，通过 DSH 设置页和 PySide6 桌面 Helper 显示鲸鱼娘。

这是什么¶

dsh-BigfishPet 是一个 DSH 插件，提供两类能力：

• DSH 设置侧：提供桌宠配置卡片，改动即时保存。
• 桌宠展示侧：通过 JSONL 协议驱动 PySide6 透明桌面 Helper，显示鲸鱼娘。

状态持久化到 ~/.dsh/pet.json。如果目标环境缺少 Python/PySide6，Helper/宠物窗口不会出现，但设置页仍可正常使用。

核心功能¶

真实状态驱动¶

插件内置状态机，将 session/event 归约为以下状态：

• 思考
• 工作
• 等待
• 完成
• 出错

多任务时按以下优先级显示：

等待 > 出错 > 工作 > 思考

动画¶

动画随状态切换：

• 思考：eat
• 工作：eat
• 成功：eat
• 等待：sleep
• 空闲：idle

交互¶

• 左键点击触发随机台词。
• 空闲时每 45–90 秒自言自语。
• 空闲持续 3 分钟无任务时自动入睡，点击宠物可唤醒。
• 右键打开或最小化宿主；找不到宿主时打开 WebUI。

宿主检测涉及的进程名为：

Bigfish.exe
DSH Desktop.exe

找不到宿主时打开的 WebUI 地址为：

http://127.0.0.1:3080/

配置与文件¶

DSH 设置里提供桌宠配置卡片，即时保存。插件会创建/读取以下文件：

~/.dsh/pet.json
~/.dsh/bigfish-completions.jsonl

安装与启用¶

下面命令用于安装到 web profile：

dsh plugin --profile web add github:s17179XTY/dsh-BigfishPet

命令执行后，重启对应的 Harness 客户端，让插件加载。

注意：插件已通过 bundle 挂载时，不要往 profile 的 cordis.patch.yml 手动追加：

- insert: id: bigfish-pet

这样可能导致同一 entry 被应用两次，出现：

duplicate loader entry id: bigfish-pet

典型用法¶

调整空闲自动入睡¶

环境变量用于调整空闲自动入睡毫秒数：

DSH_DAFEIYU_IDLE_SLEEP_MS

该配置项接受毫秒值，具体数值按目标环境需要设置。

缺 Python/PySide6 时打包 Helper¶

目标环境缺少 Python/PySide6 时，可用仓库内脚本打包 exe：

scripts/build-helper.ps1

打包出的 exe 可随插件分发，避免目标环境依赖 Python/PySide6。

排查宠物不显示¶

按顺序检查：

1、重启 DSH。

2、检查 ~/.dsh/pet.json 中的字段：

display.visible

该字段是否为 true。

3、检查 PySide6 是否可用：

py -3 -c "import PySide6"

4、手动运行 Helper：

py -3 runtime/helper.py

改动动画/状态后，Helper 只在启动时读取 manifest；需要重启 Helper 后才生效。

适用场景与注意¶

适合：

• 在任意 DSH 环境中显示桌宠状态。
• 使用真实 session/event 驱动桌宠动画和状态。
• 通过 DSH 设置页调整桌宠配置。

注意：

• 插件以当前 dsh 进程权限运行。
• 安装前建议检查 GitHub 仓库源码与 MIT 许可证。
• 目标环境缺少 Python/PySide6 时，宠物窗口不会出现；设置页仍可用。
• 改动动画/状态后需要重启 Helper，因为 Helper 只在启动时读取 manifest。

链接¶

• GitHub 仓库：https://github.com/s17179XTY/dsh-BigfishPet
• 目录页：已核实资料未提供 URL，本文不补充链接。