前言¶

用 DeepSeek Harness Desktop（desktop profile）跑长任务时，主窗口可能被其他应用盖住，或者你习惯最小化窗口专心写代码。Harness 里的 turn、工具调用仍在进行，但桌面上缺少一个始终可见、又不打断当前焦点的状态入口。

社区插件 dsh-whale-bubble（维护者 Arashi1012）在 Windows 桌面上提供一只官方小鲸鱼造型的透明悬浮窗：空闲时只占 62×62 像素，工作时尾巴游动；悬停可看进度，根会话完成时有视觉与可选提示音，点击可在还原 DSH 与最小化之间切换。下面介绍它的定位、能力与安装方式。

这是什么¶

dsh-whale-bubble 是 DeepSeek Harness 的客户端类插件：Host 侧用 Cordis 监听会话事件，本机暴露状态 HTTP 服务；气泡本体由 Windows PowerShell 5.1 + WPF 绘制，无第三方 npm 依赖、无构建步骤。插件 API 基于 @deepseek-ai/cordis 4.x，需已安装 DeepSeek Harness Desktop。

与「只靠任务栏图标或切回主窗口看日志」相比，它把 Harness 根会话的进行中 / 完成态映射到桌面一角，且不抢焦点、不进任务栏，透明区域可点击穿透。

核心功能¶

桌面悬浮窗¶

• 常驻 62×62 透明置顶窗口：不抢焦点、不进任务栏、点击穿透（仅鲸鱼与卡片不透明像素可点、可拖）。
• 位置可拖动，写入 %LOCALAPPDATA%\dsh-whale-bubble\position.json 记忆。

工作与完成态¶

• 工作时游动：整鲸为一条闭合路径，尾巴在根部做弯曲形变摆动（与官方 whale.svg 轮廓一致，静止时与 logo 对齐）。
• 悬停显示进度卡：标题、第 N 步与用时、当前动作摘要、细进度条；移开自动收起。空闲时悬停不会弹出空卡片。
• 完成时提醒（仅根会话）：鲸鱼跳一下、左上角小绿点、可选提示音（配置项 sound）。子智能体会话结束不触发完成提醒。

与 DSH 窗口联动¶

点击气泡：DSH 不在前台则还原置前；已在前台则最小化。

环境要求¶

安装与启用¶

资料中的安装步骤为先取得仓库目录，再用 desktop profile 本地添加。安装后插件立即生效并自动拉起桌面气泡；重启 DSH 会自动加载。

git clone https://github.com/Arashi1012/dsh-whale-bubble.git
dsh plugin --profile desktop add "<克隆下来的目录绝对路径>"

也可通过插件管理器的 install_bundle 指向该目录安装（与 README 说明一致）。

卸载：

dsh plugin --profile desktop remove dsh-whale-bubble

插件以当前 DSH 进程权限运行；安装前请自行查看 GitHub 仓库 源码与 MIT LICENSE。鲸鱼图形素材来源见仓库 NOTICE.md；本插件与 DeepSeek 官方无隶属关系。

配置¶

在插件包内的 cordis.patch.yml 中，whale-bubble 条目下的 config 可调本机状态服务端口与完成提示音：

- insert:
    - id: whale-bubble
      name: 'dsh-whale-bubble'
      config:
        port: 43980    # 本机状态服务端口，被占用时自动顺延
        sound: true    # 完成任务时是否播放提示音

Host 在 127.0.0.1 上暴露 /state；气泡脚本轮询该接口渲染动画与卡片。调试端点（仅回环）还包括 GET /health、/log、/screenshot、/demo（演示完成提醒）、POST /quit。运行时日志与快照位于 %LOCALAPPDATA%\dsh-whale-bubble\（如 plugin.log、bubble.log）。

典型用法¶

1. 在 Windows 上安装并启用 desktop profile 的 DSH，按上文命令添加插件。
2. 保持默认配置或按需修改 port、sound 后重启/重载插件。
3. 发起 Harness 根会话任务：观察桌面鲸鱼游动；需要细节时将鼠标悬停在鲸鱼上查看进度卡。
4. 根会话结束时留意跳动、绿点与提示音；需要回到 Harness 时点击气泡切换主窗口前后台。
5. 本地调试完成提醒时，可对回环地址调用 README 中的 /demo（具体 host/port 以当前 port 配置为准）。

适用场景与注意¶

适合：主要在 Windows 上使用 DSH Desktop、希望桌面有轻量状态指示、又不想被全屏窗口挡住的开发者。

限制（来自 README）：

• 仅 Windows（WPF + Win32）。
• 只跟踪根会话；子智能体结束不会触发完成提醒。
• 进度卡片仅在悬停且会话有内容时展示。

DeepSeek Harness 生态强调「一切皆插件」；社区目录 skillhub.cn 上的 dsh-whale-bubble 页 与 GitHub 仓库为独立维护入口，并非 DeepSeek 官方应用商店。

结尾¶

dsh-whale-bubble 把 Harness 根会话状态接到桌面一角：游动、悬停进度、完成提醒与一键切换主窗口，适合作为 Desktop 用户的常驻挂件。进一步了解可访问 插件目录页 与 GitHub：Arashi1012/dsh-whale-bubble。