yefeng7531/dsh-whale-maid-mascot

Plugin插件 Native原生 ⭐ 9 NOASSERTION UI & Themes界面与主题Dev Workflow开发与代码工作流

DeepSeek 娘(鲸鱼女仆)页面内吉祥物插件,适用于 DeepSeek Harness 网页界面

Project Overview项目介绍

This is a mascot plugin built exclusively for the web interface of DeepSeek Harness. It adds an interactive page pet based on the fan-made DeepSeek whale lady character, and it only runs inside the DSH web interface rather than as a separate standalone desktop window. To install the plugin, you run the DSH CLI command dsh plugin --profile web add <local directory path>, then restart the DSH web service for the plugin to take effect. If your local directory path contains spaces, Windows users first need to create a junction with a no-space path to avoid parsing errors from the DSH CLI.

The plugin supports a wide range of interactive features including click reactions, style switching, an affinity system, and free drag movement. It also adds several useful productivity tools for DSH users, including conversation archiving, new session creation, term explanation, quick common prompt insertion, and system notifications. Different click regions on the mascot trigger different unique reactions, and quickly clicking 10 times within 2.6 seconds triggers a special angry reaction. All user settings and affinity data are saved to the browser’s localStorage, so they persist across page reloads and DSH restarts.

The whale lady character art used in this plugin comes from a publicly available fan work, licensed under CC BY-NC-SA 4.0, and is only permitted for non-commercial use. The plugin does not require any extra dependencies beyond what is already included in a standard DSH installation, so it works immediately after installation and restart. Users can customize the bubble text, mascot size, and starting position by editing the configuration at the top of the dsh/client.js file and refreshing the page. To uninstall the plugin completely, you just run the DSH CLI command dsh plugin --profile web remove dsh-whale-maid-mascot.

这是一个专为 DeepSeek Harness 网页界面打造的原生插件,功能是在DSH网页界面内添加一个交互式的鲸鱼娘吉祥物页宠,它仅运行在DSH网页界面中,并非独立桌面窗口程序。用户可通过DSH CLI命令安装,安装后需要重启DSH网页服务,若路径含空格,Windows用户需要先创建无空格的目录 junction 才能正常安装。

插件支持点击交互、样式切换、好感度系统、拖拽移动等多种互动功能,还提供归档对话、新建会话、术语解释、快速填充常用Prompt、系统通知等实用工具能力。用户点击不同区域的吉祥物会触发不同反应,快速连续点击还会触发特殊生气反应,所有设置和好感度数据都会保存在浏览器localStorage中。

吉祥物形象素材源自公开的二创作品,采用CC BY-NC-SA 4.0许可,仅允许非商业使用。插件本身未要求额外依赖,安装后可直接使用,用户也可自行编辑源码修改气泡文案、尺寸、初始位置等配置。卸载可通过DSH CLI的 dsh plugin --profile web remove 命令完成。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:yefeng7531/dsh-whale-maid-mascot

把 yefeng7531/dsh-whale-maid-mascot 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek 娘 · dsh 页面宠物插件 🐋

只在 DeepSeek Harness 网页界面里显示的吉祥物插件(不是独立桌面窗口)。

素材来源与版权

本插件中的鲸鱼娘形象素材来自:

详细声明见 assets/SOURCE.md。

  • 待机:显示原图 A(938d2f8a…jpg,全身立绘,白底已透明化),轻微漂浮摇摆
  • 样式切换:鼠标悬停左上角 A/B/C 圆钮,切换立绘 / Q 版 / 新立绘,选择会被记住,点击角色不再自动换样式
  • 分区反应:
    • 点头部:摸摸头 / 耳朵不是玩具
    • 点胸部:特殊害羞反应(脸红 + 😳 + “变态!”)
    • 点腿部:戳裙子 / 袜子才不臭
    • 点裙摆:裙摆要飞起来啦
    • 2.6 秒内快速点击 10 次:生气(💢 + 抖动 + “不理你了”)
  • 好感度系统:摸头 +1、胸 +3、腿 +2、裙摆 +1,保存在 localStorage;等级 0/10/30/60/100,等级越高气泡文案越亲密,升级时有 💖 提示
  • 拖拽动画:拖动时身体朝移动方向倾斜,松手后有惯性回弹和落地弹跳
  • 右键菜单:右键宠物可归档当前对话(二次确认)、新建会话、查看已归档会话(列表 + 只读历史查看)、解释术语
  • 解释术语:右键 → 解释术语 → 选中页面文本 → 点击浮动按钮,在右侧独立解释面板中查看结果,不占用当前会话
  • 解释面板:可通过右键菜单“打开解释面板”随时打开,点面板右上角 ✕ 关闭
  • 解释使用独立隐藏会话完成,不会出现在当前对话或已归档列表里
  • 当前会话被删除时,对应的解释会话会自动跟随删除;解释面板右上角 🗑 可手动清空所有解释记录
  • 常用 Prompt:右键菜单 → 常用 Prompt,可快速把常用指令填入输入框
  • 系统提醒:右键菜单可开启/关闭系统通知;任务完成时即使页面在后台也能收到提醒
  • 随机小剧场:长时间未互动时,宠物会随机说话/做小动作
  • 拖拽投喂:把工作区里的会话拖到宠物身上,可选择归档或删除(均有二次确认)
  • 可拖动、可收起(右上 ✕,右下 🐋 唤回);位置、样式、显隐状态、好感度保存在浏览器 localStorage

安装

dsh plugin --profile web add <本目录路径>
# 重启 dsh web 后生效(页面右下角)

注意:路径含空格时 dsh plugin add 会解析出错,可先建一个无空格 junction: New-Item -ItemType Junction -Path C:\Users\<你>\wm-mascot-plugin -Target <本目录>

结构

  • dsh/index.js:host 插件,向浏览器提供三张 PNG(/whale-maid-mascot/a.png、b.png、c.png)
  • dsh/client.js:浏览器插件,渲染页面宠物
  • assets/mascot_*.png:原图 JPG 去白底后的透明 PNG(A/B 高 520px,C 为新增立绘)
  • test/:本地 QA 页面与静态服务器(headless Chrome 截图验收用)

卸载

dsh plugin --profile web remove dsh-whale-maid-mascot

回归测试

使用 Node.js 20 或更新版本:

npm ci
npx playwright install chromium
npm test

测试会自动启动本地 QA 服务器,在 Chromium 中加载实际客户端,并模拟会话服务和删除接口,覆盖解释记录清理失败重试、部分成功及并发清理;不需要运行 DeepSeek Harness,也不会操作真实会话。

改气泡文案 / 尺寸 / 位置

编辑 dsh/client.js 顶部的 LINES 数组和 .wm-img、.wm-root 样式后刷新页面即可。

← 上一个 Prev html-doc-center 下一个 Next dsh-tylina →