yunxiiQwQ/dsh-maid-whale-webUI

dsh-maid-whale-webUI

Awesome DSH Plugin

DeepSeek Harness Web UI 的鲸鱼女仆主题插件：提供亮暗双主题、海洋插画壁纸、手绘边框，以及随 DSH 启停的原生 Windows 鲸鱼桌宠。

主题和 Pet 预览

以下图片均由本仓库当前版本实际运行后重新截取。

| 亮色模式 | 暗色模式 |
| --- | --- |
| 无对话页面的亮色主题 | 无对话页面的暗色主题 |

Pet 预览

[](maid-whale-webui/preview/pet-working.png)

安装说明

环境要求

- 可正常运行的 DSH（DeepSeek Harness）Web UI。
- Windows 10/11 x64：原生桌宠仅支持 Windows；单独使用 Web UI 主题不受此限制。
- 无需另外安装 Python 或 Node：桌宠帮助程序已包含在插件包中。

让 DSH 安装

直接对 DSH 说：

安装一下这个皮肤包：https://github.com/yunxiiQwQ/dsh-maid-whale-webUI/tree/main/maid-whale-webui

手动安装

1. 完全退出 DSH（包括托盘进程）
2. 克隆仓库并添加插件
git clone https://github.com/yunxiiQwQ/dsh-maid-whale-webUI.git
cd dsh-maid-whale-webUI
dsh plugin --profile web add ./maid-whale-webui

3. 启动 DSH Web UI
dsh --profile web

主题会在启动后自动应用，桌宠也会自动出现。若桌宠未显示，请前往 设置 → 插件 → 插件配置 → 鲸鱼桌宠 检查启用开关。工作区面板右下角的鲸鱼按钮也可即时启停桌宠；同一时间建议只启用一个界面主题。

更新与卸载

更新：在仓库目录拉取最新版本，然后重启 DSH
git pull

卸载：先完全退出 DSH
dsh plugin --profile web remove @yunxii/dsh-client-ui-skin-maid-whale-webui

Pet 动作和触发

| 动作 | 触发条件 |
| --- | --- |
| 待机 | DSH 空闲、没有正在处理的会话 |
| 休眠 | 桌宠与 DSH 断开连接 |
| 思考 | 新任务开始、Agent 分析或整理工具结果 |
| 工作 | Agent 编辑文件、使用普通工具或处于通用工作阶段 |
| 查找 | 搜索、读取、抓取或打开内容 |
| 执行命令 | 执行 Shell、终端、PowerShell 等命令 |
| 验证 | 测试、检查、构建、Lint 或验证 |
| 等待确认 | Agent 提问、请求审批或任务被阻塞 |
| 成功 | 任务正常完成时短暂播放 |
| 错误 | 工具失败、任务异常结束或达到限制 |
| 拖动 | 按住桌宠移动超过拖动阈值 |
| 摸头 | 单击桌宠上半部，或双击桌宠 |
| 戳一戳 | 单击桌宠主体区域 |
| 碰尾巴 | 单击桌宠右侧尾巴区域 |
| 空闲小动作 | 空闲且未开启“减少动态效果”时随机播放 |

交互动作结束后，桌宠会回到最新的 Agent 状态。多会话同时活动时，显示优先级为：等待确认 → 错误 → 工作 → 思考 → 空闲。

声明

- 代码使用 BSD-3-Clause 许可证。
- 本项目是非官方社区主题，与 DeepSeek 官方无隶属或背书关系；角色与插画素材来源于社区二创。
- 桌宠的 Node 侧伴侣代码与 Python runtime 基于 QCYTSN/dsh-dafeiyu（MIT），完整归属说明见 maid-whale-webui/NOTICE。
- 插件仅使用 DSH 官方客户端插件机制，不修改 DeepSeek Harness 源码，也不介入模型请求。
- 桌宠不存储密钥、不截图、无遥测、不新增网络端口，只响应 DSH 自身事件。