返回目录

dsh-pet-whale

精选清单收录维护状态: 活跃

nzl153/dsh-pet-whale

桌宠小鲸鱼:DSH(DeepSeek Harness)桌宠插件,桌面端和网页端都能用,随 agent 状态切换动画,纯 DOM 零依赖

前往 GitHub项目主页
$ dsh plugin --profile web add link:/path/to/pet-whale

14

星标

3

Fork

JavaScript

语言

MIT

许可证

2026-08-14

创建于

2026-10-02

最近推送

MIT 开源的 DSH 桌宠:零依赖的 DOM 小鲸鱼,在桌面端与网页端同步 idle / think / working / celebrate / error / wait 状态,靠 profile 的 `package.json` 依赖加 `dsh.profile.bundles` 安装。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-13

许可证

MIT

01它能帮你完成什么?

  • 一眼看出 DeepSeek Harness 正在做什么——空闲、思考、干活、等待、报错还是庆祝——靠角落里的一只桌宠

    鲸鱼的表情和动画跟随会话状态机(idle / think / working / celebrate / error / disappointed / wait,优先级 error > celebrate > think > working > idle),桌面端和网页端都一致

    会跑很长 agent 回合、希望有个常驻状态指示而不是一直盯着对话记录的 DSH 用户

  • 同时盯住多个并行会话,并在其中一个跑完时收到提醒

    别的会话在跑时鲸鱼照样干活,头顶气泡角标显示正在运行的会话数量,某个会话完成时它会庆祝并报出是哪个会话,还会提醒你哪个会话正在等输入

    习惯同时开多个 DSH 会话的人(此能力需要 DSH 0.1.7 及以上)

  • 把漫长的 DSH 会话变成可以戳、可以换装、也可以收起来的东西

    戳一戳、摸摸头、双击翻滚、拖拽贴边压扁、7 套色板换肤、0.8–1.6 倍缩放、WebAudio 音效、收起到右下角并留下可拖拽的状态按钮,以及跟随亮/暗主题

    希望这个 harness 更像桌面应用、不那么像终端的人

02如何接入 DeepSeek Harness?

前置条件

  • 需要 DSH `>=0.1.5-alpha.2 <0.3.0` 与 Node.js `^22.19.0 || >=24.0.0`
  • 你实际在用的那个 profile 目录——桌面端和网页端各用各的 profile,网页版一般是 `~/.dsh/profiles/web`

安装步骤

  1. 01

    编辑 profile 的 `package.json`:在 `dependencies` 里加 `"pet-whale": "^1.2.7"`,并把 `"pet-whale"` 加进 `dsh.profile.bundles` 列表中原有条目旁边

  2. 02

    在该 profile 目录执行 `pnpm install`,然后重启 DSH——桌面端要从托盘退出再启动

  3. 03

    另一种做法:不用 npm 安装——本地仓库用 `dsh plugin --profile web add link:/path/to/pet-whale`(仓库已包含构建产物 `lib/`),git 直装用 `dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"`

    $ dsh plugin --profile web add link:/path/to/pet-whale

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配原生运行时

DSH 插件包:客户端部分(`lib/client.js`)负责在 DSH 界面里渲染鲸鱼并跟随会话状态,宿主部分(`lib/index.mjs`)负责宿主侧逻辑;安装时把它加进 profile 的 `dsh.profile.bundles` 列表

  • Agent 状态机

    DSH 会话快照与 chat 投影(`running`、`lastAgentError`、`partial`、`runningCalls`、`turnEnds`)→idle / think / working / celebrate / error / disappointed / wait 动画,优先级 error > celebrate > think > working > idle

  • 跟随所有会话

    来自 `ctx.uiSession.sessionStatus` 的每个会话运行状态与待批准状态→显示正在运行会话数量的气泡角标、完成会话的庆祝与点名,以及哪个会话正在等待的提醒(不含子 agent)

  • 思考流气泡

    状态为 `think` 时模型最近的思考文本→最近约 200 字在鲸鱼上方缓慢滚动,可在右键菜单里开关

  • 交互与外观

    单击、双击、拖拽、光标靠近和右键菜单选项→戳一戳 / 摸摸头的反应、360° 翻滚、贴边压扁、7 套色板、0.8–1.6 倍大小、六种 WebAudio 音效、收起到右下角并留下可拖拽的状态按钮

    把位置、隐藏状态和偏好记在 `localStorage` 里除非静音,否则播放合成音效
  • 多语言、主题与省电行为

    DSH 的 locale 服务、DSH 亮/暗主题以及页面可见性→跟随 DSH locale 的中文 / 英文文案,跟随主题的气泡与阴影,以及页面切到后台时暂停动画、并在 `prefers-reduced-motion` 下退化为静态显示

04适合谁?何时不该用?

适合

  • 会跑很长 agent 回合、希望有个常驻状态指示而不是一直盯着对话记录的 DSH 用户
  • 习惯同时开多个 DSH 会话的人(此能力需要 DSH 0.1.7 及以上)
  • 希望这个 harness 更像桌面应用、不那么像终端的人

不适合

  • 插件锁定 DSH `>=0.1.5-alpha.2 <0.3.0`,而且有几项行为取决于宿主版本——跟随所有会话需要 DSH 0.1.7,README 还记录了 1.1.0 在 0.1.5 下抛异常、1.1.2 在 0.1.7 下一直待机。
  • 安装是改 profile,而不是一行命令加装:把依赖和 `pet-whale` bundle 加进 profile 的 `package.json`,在该目录执行 `pnpm install` 再重启 DSH(桌面端必须从托盘退出)。桌面端和网页端各有自己的 profile,所以每个 profile 都要改一遍。

05兼容性、维护与安全提示

  • 插件锁定 DSH `>=0.1.5-alpha.2 <0.3.0`,而且有几项行为取决于宿主版本——跟随所有会话需要 DSH 0.1.7,README 还记录了 1.1.0 在 0.1.5 下抛异常、1.1.2 在 0.1.7 下一直待机。
  • 安装是改 profile,而不是一行命令加装:把依赖和 `pet-whale` bundle 加进 profile 的 `package.json`,在该目录执行 `pnpm install` 再重启 DSH(桌面端必须从托盘退出)。桌面端和网页端各有自己的 profile,所以每个 profile 都要改一遍。
  • 鲸鱼轮廓使用 DeepSeek 官方 FishLogo 路径,README 把它当作品牌素材,复用时必须注明出处。
  • 只有在 profile 以 `link:` 方式安装本仓库、且 DSH `>=0.1.5-alpha.2` 时热重载才有效;改动 `package.json` 结构、`cordis.patch.yml`、宿主部分或 bundle 列表仍然需要重启 DSH。
2026-08-142026-10-02v1.2.7

MIT · 最新版本 v1.2.7(2026-10-02),仅有 README 证据,未做安全审计

06常见问题

怎么把 pet-whale 装进 DeepSeek Harness?

打开你实际在用的 profile 目录(桌面端和网页版各一个,网页版一般是 `~/.dsh/profiles/web`),编辑其中的 `package.json`:在 `dependencies` 里加 `"pet-whale": "^1.2.7"`,并在 `dsh.profile.bundles` 列表里把 `"pet-whale"` 加在原有条目旁边。然后在该目录执行 `pnpm install`,重启 DSH——桌面端要从托盘「退出」再打开。

不改 package.json 能装吗?

有本地仓库或想走 git 时可以:本地目录用 `dsh plugin --profile web add link:/path/to/pet-whale`(仓库已包含构建产物 `lib/`,无需先构建),git 直装用 `dsh plugin --profile web add "github:nzl153/dsh-pet-whale#main"`。也只有 `link:` 方式才支持 README 里的热更新流程。

支持哪些 DSH 版本?

要求 DSH `>=0.1.5-alpha.2 <0.3.0` 与 Node.js `^22.19.0 || >=24.0.0`。部分能力要更新的宿主:「跟随所有会话」需要 DSH 0.1.7;README 还记录了 1.1.0 在 0.1.5 下抛异常、1.1.2 在 0.1.7 下一直待机,1.1.3 起改为读取主视图持有的会话才修好。

桌宠会读我的会话内容吗?

它读会话状态来决定动画:会话快照(`running`、`lastAgentError`)与 chat 投影(`partial`、`runningCalls`、`turnEnds`);处于 think 状态时,会把模型最近约 200 字思考内容滚动显示在鲸鱼上方(右键可关)。所有渲染都在 DSH 页面本地完成,位置、隐藏状态和偏好存在 `localStorage` 里。

它会写哪些文件?需要音频资源吗?

纯 DOM 实现、零 React、零运行时第三方依赖,六种音效全部由 WebAudio 合成,所以没有任何音频文件。客户端只存 `localStorage` 偏好,例如位置、大小、色板、静音和隐藏状态。

08数据与来源

  • 作者声明github.com231a1936c427…

    DeepSeek Harness(DSH)的桌宠插件,桌面端和网页端都能用:右下角一只**官方轮廓版小鲸鱼**,随 agent 状态实时切换动画。纯 DOM 实现、零 React 依赖、零运行时第三方依赖,WebAudio 合成音效无音频文…

  • 作者声明github.com231a1936c427…

    在你正在用的 profile 目录(桌面端和网页版各用各的 profile,网页版一般是 `~/.dsh/profiles/web`)的 `package.json` 里加上依赖和 bundle:

  • 作者声明github.com231a1936c427…

    "dependencies": { "pet-whale": "^1.2.7" }, "dsh": { "profile": { "bundles": ["...原有的...", "pet-whale"] } }

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-13。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。