前言¶

在 DeepSeek Harness（DSH）里挂小鲸鱼 overlay 或桌面桌宠，常见做法是分别装网页版插件和独立桌面 exe。维护两套入口、改显示方式时要分别处理，对日常开发环境不够省事。社区里已有仿 dsh-pet 的双模式思路：同一份全功能代码，用配置决定只开网页、只开桌面，或两者同时存在。下面介绍维护者 sarate-s 发布的 dsh-whale-widget-dual，它把原 dsh-whale-widget 全功能收进一个插件，由 display 字段统一控制。

这是什么¶

dsh-whale-widget-dual 是 DSH 客户端类插件（GitHub：sarate-s/dsh-whale-widget-dual，目录页：skillhub.cn 条目）。一句话定位：小鲸鱼 web 页面 overlay 与 desktop Electron 桌宠 双模式并存，显示范围由 display 决定，默认网页一只、桌面一只。

插件代码在 dsh-whale-widget（MIT，MeteorNOX/DeepSeek-Balance-Whale-Widget）基础上改造；package.json 当前版本为 1.0.0，许可证 MIT。

核心功能¶

display 四种模式¶

改配置后需重载插件或重启 DSH（网页注入在启动时收集；桌面进程在 apply 时拉起）。

代码结构（照 dsh-pet）¶

lib/web-host.js   原 dsh-whale-widget 宿主（未改）
lib/index.js      双模式外壳：按 display 决定 apply web / spawn desktop
desktop/          原桌面桌宠应用（全功能，未改）
assets/           原插件素材（气泡图/音效等）

• 网页半侧：web-host.apply(root) → /dsh-whale/* 路由与页面注入。
• 桌面半侧：spawn desktop/；需要本机存在 ~/.dsh/electron/electron.exe，或通过环境变量 DSH_WHALE_ELECTRON_PATH 指定 Electron 可执行文件。
• 使用 pid 文件去重；插件卸载或 DSH 退出时对子进程执行 taskkill /T /F（Windows 环境）。

desktop/ 对应此前 DSH-Whale-Widget-Desktop.exe 的源码；桌宠窗口行为（透明、置顶、点击穿透、拖动、托盘）与独立 exe 一致。

安装与启用¶

从 GitHub 安装（DSH 自带 CLI，命令以 README 原文为准）：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
    plugin --profile desktop add "github:sarate-s/dsh-whale-widget-dual"

装完完全退出并重新打开 DSH。

本地目录离线安装（将 <本目录绝对路径> 换成插件解压后的实际路径）：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" `
    plugin --profile desktop add "link:<本目录绝对路径>"

插件通过 Cordis patch 接入 DSH（见仓库内 cordis.patch.yml）。

典型用法¶

配置文件¶

路径：

%USERPROFILE%\.dsh\dsh-whale-widget-dual.json

示例（默认双开）：

{"display":"both"}

只做页面 overlay 时改为 "web"；只要桌面桌宠时改为 "desktop"；临时全部关闭用 "none"。修改 display 后按上文说明重载或重启 DSH。

适用场景与注意¶

适合已经在用或小鲸鱼 dsh-whale-widget 全功能、又希望用一份插件切换「仅网页 / 仅桌面 / 双开 / 全关」的 DSH 桌面 profile 用户。桌面模式依赖 Electron 路径，部署前确认 ~/.dsh/electron/electron.exe 或 DSH_WHALE_ELECTRON_PATH 可用。

DSH 生态强调「一切皆插件」；社区目录站点与 DeepSeek、幻方无官方从属关系，安装前请自行阅读仓库 LICENSE、PROVENANCE 与源码。插件以当前 DSH 进程权限运行，安装与启用前应完成信任与合规检查。

结尾¶

dsh-whale-widget-dual 把原小鲸鱼全功能收进双模式外壳，用 display 统一管理网页 overlay 与 Electron 桌宠，结构对齐 dsh-pet，便于在同一套 DSH 环境里按需切换展示方式。

• 目录页：https://www.skillhub.cn/plugins/sarate-s/dsh-whale-widget-dual
• GitHub：https://github.com/sarate-s/dsh-whale-widget-dual