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`
安装步骤
- 01
编辑 profile 的 `package.json`:在 `dependencies` 里加 `"pet-whale": "^1.2.7"`,并把 `"pet-whale"` 加进 `dsh.profile.bundles` 列表中原有条目旁边
- 02
在该 profile 目录执行 `pnpm install`,然后重启 DSH——桌面端要从托盘退出再启动
- 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 插件包:客户端部分(`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。
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` 偏好,例如位置、大小、色板、静音和隐藏状态。
07相关的 DSH 工作流
ds-harness-remote
作者 liguobao
基于 DeepSeek Harness 插件机制构建的远程访问方案,通过低延迟、端到端加密的 P2P 网络,支持使用 PC、移动端 和 Web 随时访问本地设备上的DSH 、CodeX、Cursor、Claude Code等工作区。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自动化插件,将 CursorTouch/Windows-MCP 接入内置 MCP 客户端桥接。提供默认关闭的 Computer Use 开关和应用内依赖安装器。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。
08数据与来源
DeepSeek Harness(DSH)的桌宠插件,桌面端和网页端都能用:右下角一只**官方轮廓版小鲸鱼**,随 agent 状态实时切换动画。纯 DOM 实现、零 React 依赖、零运行时第三方依赖,WebAudio 合成音效无音频文…
在你正在用的 profile 目录(桌面端和网页版各用各的 profile,网页版一般是 `~/.dsh/profiles/web`)的 `package.json` 里加上依赖和 bundle:
"dependencies": { "pet-whale": "^1.2.7" }, "dsh": { "profile": { "bundles": ["...原有的...", "pet-whale"] } }
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-13。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
