前言¶

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