前言¶

DSH 生態強調「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對需要長時間運行 DSH 任務的使用者來說，只盯着終端不方便。seekmaid-pet 把 DSH 會話狀態接到 Windows 11 桌寵上，任務開始、任務完成、新消息、工具調用和任務清單變化時會有氣泡提示，也支持向當前 DSH 會話發送消息。

這是什麼¶

包名 seekmaid-pet，維護者爲 DoloresCaritasAngelus，許可證爲 MIT。它既是 Windows 原生桌寵，也是 DSH 插件：桌寵常駐桌面/系統托盤，並連接本機 DSH 終端；DSH 啓動時自動拉起桌寵，DSH 停止時自動關閉桌寵。

核心功能¶

• Windows 11 原生桌面寵物，常駐桌面/系統托盤並連接本機 DSH 終端
• 監控 DSH 會話狀態：任務開始、任務完成、新消息、工具調用、任務清單變化時氣泡提示
• 雙向通信：雙擊桌寵或右鍵菜單給當前 DSH 會話發送消息，DSH 回覆顯示在桌寵氣泡
• 長久運行：無控制檯窗口（pythonw）、單實例、關閉窗口只隱藏到托盤、可設置開機自啓
• DSH 插件模式：DSH 啓動時自動拉起桌寵，DSH 停止時自動關閉桌寵
• 插件自動檢測/複製 Windows 項目並自動初始化（零配置模式）
• 提供 self-heal.mjs，用於 DSH 升級/重裝後恢復插件註冊

安裝與啓用¶

運行環境¶

下面列出的環境來自插件資料，安裝前先確認本機是否滿足：

• Windows 11（10 也可嘗試）
• Python 3.10+
• PySide6 ≥ 6.6
• DSH ≥ 0.1.0-rc.6（推薦 rc.8+）
• @deepseek-ai/cordis ^4.0.1
• Node.js LTS
• Windows 側需可訪問 http://localhost:3080

如果 DSH 跑在 WSL/遠程 Linux，而桌寵要顯示在 Windows 桌面，插件需裝在 Windows 側的 DSH 上；Linux 側無法直接拉起 Windows GUI。

安裝插件¶

資料給出了本地目錄安裝和 GitHub 安裝兩種方式。下面按命令示例說明。

如果已經在 Windows 側拿到項目目錄，並在該目錄執行：

dsh plugin --profile web add "file:$(pwd)"

這條命令會把當前目錄作爲 seekmaid-pet 插件包安裝到 web profile。

如果不想先克隆到本地，也可以使用 GitHub 安裝命令：

dsh plugin --profile web add "git+https://github.com/DoloresCaritasAngelus/SeekMaid-pet.git"

經過上面的步驟後，啓動 DSH 時會自動拉起桌寵。

初始化與手動啓動¶

克隆到 Windows 後，不立即可用。倉庫不包含 .venv、wslg-xcb-libs、日誌、緩存等本地環境，因此需要先初始化。

先運行初始化腳本，它會創建 .venv 並安裝 PySide6：

setup_windows.bat

再運行啓動腳本，手動啓動桌寵：

run_pet.bat

也可以手動調用 Python 啓動：

.venv\Scripts\pythonw.exe deepseek_pet.py

典型用法¶

連接 DSH¶

桌寵連接本機 DSH 終端，Windows 側需可訪問 http://localhost:3080。如果 DSH 地址不同，可以編輯 config.json，通過 dsh_url 修改。

config.json 可設置以下監控參數：

• dsh_url
• session_id
• poll_interval

插件配置¶

在插件配置中可設置以下字段：

• windowsProject
• python
• script
• startupTimeoutMinutes

其中 python 用於 Python 不在 PATH 時指定路徑。插件默認使用 pythonw（Windows）或 python3（其他平臺）啓動桌寵。

開機自啓¶

可通過系統托盤右鍵菜單勾選開機自啓；也可以手動使用 reg add 寫入註冊表項：

HKCU\Software\Microsoft\Windows\CurrentVersion\Run

升級自愈¶

DSH 升級或重裝 node_modules 時，會移除本地安裝的插件，可能導致 profile bundle 解析失敗。此時需要恢復插件註冊。

倉庫提供 self-heal.mjs，用於 DSH 升級/重裝後恢復插件註冊。你可以在 DSH 啓動腳本中自動執行它，避免升級後桌寵無法被拉起。

適用場景與注意¶

適合在 Windows 桌面使用 DSH，並希望把任務開始、任務完成、新消息、工具調用、任務清單變化等狀態放到桌寵上查看的人。也適合需要臨時給當前 DSH 會話發消息，而不切回終端的場景。

注意：DSH 插件會在本機 DSH 環境中運行，並以當前 dsh 進程權限執行。安裝前應檢查源碼、依賴和 MIT 許可證。

結尾¶

seekmaid-pet 的價值比較具體：把 DSH 會話狀態接到 Windows 桌寵上，並讓 DSH 生命週期管理桌寵啓動與關閉。若你希望在 Windows 桌面查看 DSH 任務狀態並快速發消息，可以先檢查源碼，再按上面的步驟安裝。

• 目錄頁：https://www.skillhub.cn/plugins/DoloresCaritasAngelus/SeekMaid-pet
• GitHub：https://github.com/DoloresCaritasAngelus/SeekMaid-pet