yunxiiQwQ/dsh-maid-whale-webUI
DeepSeek Harness Web UI 鲸鱼女仆主题插件
安装Install
dsh plugin --profile web add github:yunxiiQwQ/dsh-maid-whale-webUI
把 yunxiiQwQ/dsh-maid-whale-webUI 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-maid-whale-webUI
English | 中文
DeepSeek Harness Web UI 的鲸鱼女仆主题插件:亮暗双主题、海洋插画壁纸、手绘九宫格边框,并附带随 DSH 启停、置顶桌面的鲸鱼桌宠(deepseek-drool 20 动作素材)。
效果预览
| 亮色模式 | 暗色模式 |
|---|---|
![]() |
![]() |
鲸鱼桌宠
安装
环境要求
- Windows 10/11 x64(桌宠为原生置顶窗口,仅支持 Windows;纯皮肤部分不限平台)
- 可正常运行的 DSH(DeepSeek Harness)Web UI
- 无需安装 Python 或 Node——桌宠帮助程序已随包提供(
runtime/bin/win32-x64/dsw-drool-helper.exe)
懒人版
对你的 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
dsh --profile web
启动后皮肤自动应用;鲸鱼桌宠会自动出现在桌面上。若未出现,到 设置 → 插件 → 插件配置 → 鲸鱼桌宠 检查启用开关。
更新与卸载
# 更新:本地目录以链接方式安装,拉取后重启 DSH 即生效
git pull
# 卸载(需先完全退出 DSH)
dsh plugin --profile web remove @dsh-external/dsh-client-ui-skin-maid-whale-webui
同一时间建议只启用一个界面主题。
开发
cd maid-whale-webui
pnpm install
pnpm art:embed
pnpm lint
pnpm typecheck
pnpm test
pnpm build
桌宠侧(改动 runtime/、assets/pet/ 或 assets/pet-manifest.json 后需要重建 exe):
py -3 -m unittest discover -s runtime/tests -t .
pnpm build:helper:windows
build-helper.ps1 默认使用 .build/python-env 虚拟环境(已被 .gitignore 排除,不会入库)。首次构建前自建一次即可:
python -m venv .build/python-env
.build/python-env/Scripts/pip install PySide6 pyinstaller
插件只使用官方 DSH 客户端插件机制,不修改 DeepSeek Harness 源码,也不影响模型请求。
桌面伴侣(鲸鱼桌宠)
本插件集成了一个由 DSH 状态驱动的桌面伴侣,随 DSH 启动自动出现、DSH 退出自动关闭;DSH 最小化后桌宠仍以透明置顶窗口显示在 Windows 桌面上。
- 事件驱动状态机:空闲 → 思考 → 工作(查找 / 执行 / 验证细分动作)→ 等待确认 / 完成 / 错误;多会话按“等待确认 > 错误 > 工作 > 思考 > 空闲”优先展示
- 角色为 deepseek-drool 20 动作素材(待机、思考、努力工作、加载、拜托、成功、错误、惊讶、吃东西等)
- 桌面互动:拖动(位置自动保存)、点击/双击摸头反应、右键菜单
- 设置入口:DSH 设置 → 插件 → 插件配置 → 鲸鱼桌宠(角色大小、气泡、活跃程度、减少动态效果、响应子 Agent)
- 快捷开关:工作区面板右下角有桌宠开关按钮,点击即时启停;灰化为关闭状态
- 隐私:不存密钥、不截图、无遥测、不开新端口,只响应 DSH 自身事件
节点侧伴侣代码与 Python runtime 源自 QCYTSN/dsh-dafeiyu(MIT),详见 maid-whale-webui/NOTICE。
许可与声明
代码使用 BSD-3-Clause 许可。本项目是非官方社区主题,素材来源于社区二创,与 DeepSeek 官方无隶属关系。



ruvnet/ruflo
amruthpillai/reactive-resume
volcengine/OpenViking
Molunerfinn/PicGo
titanwings/colleague-skill
nocobase/nocobase