前言¶
DeepSeek Harness（DSH）强调插件化扩展能力。whalebuddy 是一款桌面宠物插件，它将 DSH agent 会话的运行状态映射到桌面上的鲸鱼舷窗中。该插件包含感知层插件（运行在 DSH 进程中）和桌面壳（Tauri 应用），通过 WebSocket 实时同步状态。
核心功能¶
- 状态感知：宠物窗口实时反映 agent 会话状态。任务在跑时“干活”，空闲时“睡觉”，等待批准时“敲门”提醒。
- 交互管理：双击鲸鱼可管理当前聚焦工作区（项目）的待办清单。
- 个性化设置：支持设置开机自启动与更换皮肤。
- 透明置顶：桌面壳为透明置顶窗口，不遮挡主要操作区。
安装与启用¶
安装感知层插件需使用 DSH Plugin CLI。
dsh plugin --profile web add github:2DogsLee/dsh_whalebuddy
安装后，bundle 仅在 DSH 启动时加载，因此需要重启 DSH。
桌面壳（宠物窗口）是一个独立的 Tauri 程序（仅支持 Windows）。安装感知层后，克隆仓库并在 app/src-tauri 目录下执行构建。
cd app/src-tauri
cargo build
Start-Process .\target\debug\dsh-pet.exe
配置与使用¶
宠物窗口启动后，通过以下方式配置：
- DSH GUI 配置：在 DSH GUI 的「设置 → 插件 → 插件配置」中找到「🐋 桌面宠物 whalebuddy」卡片。
- 右键菜单：在宠物窗口上右键，选择「🐋 whalebuddy 设置…」。
配置项包括：
* autostart：开机自启动宠物（需宠物进程在线时保存以写入注册表）。
* launchOnDshStart：DSH 启动时自动启动宠物。
* petPath：宠物 exe 完整路径，留空则按注册表自动发现。
* skin：皮肤 ID，默认为 dsh-black-whale。
依赖与环境¶
- 平台支持：桌面壳目前仅支持 Windows 10/11。macOS/Linux 的感知层插件理论可用但未实测，桌面壳未适配。
- 运行时依赖：Windows 10/11 一般自带 WebView2 运行时。
- 构建依赖：
- Rust/MSVC：仅构建宠物壳时需要。
- Node.js：感知层插件依赖，版本需 ≥ 18。
注意事项¶
- 插件以当前 DSH 进程权限运行。
- 开机自启功能通过写入注册表
HKCU\...\Run\whalebuddy实现，需确保宠物进程在配置保存时处于在线状态。 - 端口发现依赖于
netstat命令，确保 DSH 进程正在运行且未更改默认端口配置。
