DSH Marketplace
EN

whale-girl

vlln/whale-girl

桌面宠物(QQ 宠物形态):右下角悬浮、可拖拽/投喂/玩耍。

33918JavaScriptMIT源码

安装

把 whale-girl 装进 DeepSeek Harness

npm 方式

直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。

GitHub 方式 · npm 包

从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。

我们跑过之后

我们跑过,装得上

这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 13 天前.

挂进你的 README

实测可装 — dshmarketplace

给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。

安装前须知

装 whale-girl 之前,先看这几条

  • 源码在这里: vlln/whale-girl——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
  • 开源协议:MIT。
  • 自动识别到:终端执行。授权之前请先读一遍源码。
  • 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。

AI 锐评

是什么 — 一款QQ宠物风格的桌面浮动宠物,支持拖拽喂食玩耍。

谁该装 — 使用 DeepSeek Harness 进行会话任务的用户,希望获得宠物陪伴和任务反馈。 不适合不使用 Web GUI 的用户,因为这个插件是为 DeepSeek Harness Web GUI 设计的。

注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 没发现明显的坑。

锐评 — 我会装它,因为它能将任务完成度、会话和陪伴时间转化为宠物等级、头衔和记忆。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。

whale-girl 是做什么的

A floating figure flows through event states into interaction, growth, and desktop-rendering paths.

whale-girl 是一个 DeepSeek Harness 插件,在 DSH Web GUI 右下角显示可拖拽的桌面宠物。它不是独立的 agent,也不替代会话、任务或批准流程,而是把这些活动转成可见的陪伴状态:新会话会欢迎,思考中会陪伴,等待批准时等待,任务完成时庆祝,请求出错时表现出惊吓和失落。点击菜单可以投喂或玩耍,悬停可查看资历等级、任务数和最近共同记忆;任务、会话与活跃陪伴时长会持续积累等级、称号和回忆。

插件以官方 bundle 接入 web profile,网页端重启后生效。宿主设置中的 whale-girl: 可调整是否启用、尺寸、透明度、游走和入睡时间,配置热生效。网页端宠物不访问外部服务的事实未在 README 中说明,因此不应据此判断其网络行为。

它适合希望在工作台中加入轻量状态反馈和趣味陪伴的开发者。不需要宠物、希望界面保持简洁,或已经运行独立桌面伴侣时,不建议使用;后者会渲染同一个角色,可能造成重复显示。desktop/ 不随 dsh plugin 安装,使用 Node 引擎和 Tauri 外壳,并通过公开端点与插件配合。

whale-girl 的文档

行为说明

初始配置和 onboarding 期间宠物隐藏。网页端根据活动切换状态:新会话为 welcome;会话运行或思考中为 think,偶尔为 working;等待批准为 wait;任务完成、升级、称号或回合完成为 celebrate;任务失败或请求出错为 error,随后为 disappointed;空闲达到 60000 ms 后为 sleep,互动后为 wake。投喂和玩耍分别触发 eat、play,随后进入 joy。平时还会 idle、周期游走 walk。完整优先级见 docs/state-machine.md。

配置

在设置 UI 或 <dshHome>/settings.yaml 的 whale-girl: section 中修改,热生效:

键 默认值 作用
enabled true 开关网页端渲染
size 110 尺寸,范围 64–160 px
opacity 1 常态透明度,范围 0.2–1
walk.enabled true 开关游走
sleepAfterMs 60000 入睡前的空闲时长

资历、XP 和称号语义不可配置。角色可在菜单中切换,也可使用 localStorage 键 whale-girl:character。

命令与桌面伴侣

更新使用 dsh plugin --profile web update whale-girl,之后需重启 web。desktop/ 不由 dsh plugin 安装;在该目录运行 npm install,推荐使用 cd src-tauri && cargo run 启动 Tauri 外壳,也可运行 npm run start:headless 使用无窗模式。

环境要求

桌面伴侣使用 Node 引擎和 Tauri v2 渲染壳;README 也保留 Electron 外壳。它读取 /state、/events、/presence、/interact、/config、/assets。运行时网页端自动隐藏;退出或 45s TTL 过期后恢复。

根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README

同一分类

whale-girl 的同类插件

dsh-pet

zhu1090093659

7.6k

常驻界面的鲸鱼娘:随智能体状态切换动画,可摸头互动、喂小鱼干养亲密度,从幼鲸一路养成。

我们跑过,装得上

npm 包TypeScript17 天前

AI 锐评

dsh-pet

是什么 — dsh-pet 为 DeepSeek Harness Web GUI 提供了鲸鱼娘伴侣插件,动画跟随 agent 状态变化,并支持拍打互动和喂食提升亲密度的机制。

谁该装 — 在 DeepSeek Harness Web GUI 执行 AI 代理任务时,需要 agent 状态的可视化陪伴效果,dsh-pet 适合作为鲸鱼娘 companion。 如果使用 DSH Desktop 而非 Web GUI 的用户无需安装此插件。

注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。未发现明显的坑。

锐评 — 我会安装它,因为喂食机制能构建亲密度的设计。前提是任务涉及 agent 状态监控。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
源码

dsh-pet

PC2005-cloud

753

DSH Web UI 桌面宠物:25 个透明动画、屏幕漫游、点击反应与拖拽,附可复现的素材生成链。

我们跑过,装得上

npm 包TypeScript8 天前

AI 锐评

dsh-pet

是什么 — 在 DeepSeek Harness Web 界面中运行的桌面宠物插件,提供透明动画、屏幕漫游、点击反应和拖拽支持。

谁该装 — 在使用 DeepSeek Harness Web 界面、希望在屏幕角落放置一个会走动并会回应点击的桌面宠物的人适合安装它。不需要任何屏幕移动或点击回应的用户不必安装它。

注意 — 没发现明显的坑。沙箱尚未实测。从源码安装时需要先手动放行它的构建脚本。

锐评 — 我装它,因为它提供可复现的资产生成管道,让用户能生成自定义的透明动画。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
详情

dsh-ads

Nagi-ovo

634

2005 年中文站点风格的整活广告插件:侧栏广告/信息流/角落弹窗 + 假关闭叉,素材全虚构。

我们跑过,装得上

npm 包TypeScript14 天前

AI 锐评

dsh-ads

是什么 — 在侧栏、对话和推理中断插入 2005 风格虚构广告。

谁该装 — 在使用 DeepSeek Harness 的中文模式下,想在侧栏和对话内插入 2005 风格虚构广告的人。 只想使用英文模式的 DeepSeek Harness 用户可以不装。

注意 — 沙箱实测通过,在全新 profile 里装上,并被 harness 注册进 profile。 没发现明显的坑。

锐评 — 我会装它,因为点击广告就能打开真实仓库。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
详情
371

Desktop-native BigFish companion for DeepSeek Harness — real Agent status, always on top on Windows.

我们跑过,装得上

npm 包JavaScript16 天前

AI 锐评

dsh-dafeiyu

是什么 — 大肥鱼是 DeepSeek Harness 的桌面伴侣插件,能始终置顶显示 Harness 真实 Agent 工作状态。

谁该装 — 在 Windows 桌面使用 DeepSeek Harness 进行 Agent 任务时,需要看到实时状态的人适合安装它。 不进行 Agent 任务的人不必安装,因为他们不需要桌面状态显示。

注意 — 实测在全新 profile 里安装并被 harness 注册进 profile,通过。 会执行 shell 命令。 没发现明显的坑。

锐评 — 如果我在 Windows 桌面环境中使用 DeepSeek Harness 进行任务,需要持续查看 Agent 状态,我会安装它,因为它提供真实事件反馈的始终置顶显示。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码
115

陪 AI 斗图的搞笑插件:说个感觉,AI 帮你搜到、发出那张恰到好处的真实表情包。

我们跑过,装得上

npm 包JavaScript4 天前

AI 锐评

dsh-expression

是什么 — dsh-meme 是一个允许通过文字描述搜索发送表情包的 DeepSeek Harness 插件。

谁该装 — 在与不支持图片输入的模型对话时想插入表情包的用户适合使用这个插件。完全依赖模型自动生成所有视觉元素的用户可以不装,因为插件只提供文本标记方式。

注意 — 沙箱实测通过,插件能在全新 profile 里装上并被 harness 注册进 profile。会执行 shell 命令是静态检查提示。没发现明显的坑。

锐评 — 我会装它,因为它让模型仅用文字 token 就能发送带表情的回复,且无需模型图片输入能力。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码

dsh-meme

yyh-001

112

聊天表情包:纯文本斗图、情绪主动发图、像 QQ/微信 一样发图、AI 自动学图、自定义表情包。

我们跑过,装得上

npm 包JavaScript4 天前

AI 锐评

dsh-meme

是什么 — dsh-meme 插件支持 DeepSeek Harness 的文字表情包发送和一键挑选。

谁该装 — 在 DeepSeek Harness 进行日常对话的用户,如果模型无需图片输入能力,需要插入表情时可以安装此插件。 不使用工具调用的用户可以不安装此插件,因为插件依赖工具调用。

注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。没发现明显的坑。

锐评 — 我会装它,因为它能让模型仅用文字完成表情插入,且零第三方依赖。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码