前言¶
用 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 不在前台则还原置前；已在前台则最小化。
环境要求¶
| 项 | 要求 |
|---|---|
| 系统 | Windows 10 / 11 |
| 运行时 | Windows PowerShell 5.1（系统自带） |
| Harness | DeepSeek Harness Desktop（desktop profile） |
| 依赖 | 无第三方 npm 依赖 |
安装与启用¶
资料中的安装步骤为先取得仓库目录，再用 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）。
典型用法¶
- 在 Windows 上安装并启用 desktop profile 的 DSH，按上文命令添加插件。
- 保持默认配置或按需修改
port、sound后重启/重载插件。 - 发起 Harness 根会话任务：观察桌面鲸鱼游动；需要细节时将鼠标悬停在鲸鱼上查看进度卡。
- 根会话结束时留意跳动、绿点与提示音；需要回到 Harness 时点击气泡切换主窗口前后台。
- 本地调试完成提醒时，可对回环地址调用 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。
