前言¶

使用 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，本文不補充鏈接。