sublatesublate-design/deepseek-whale-pet

DeepSeek 蓝鲸桌宠

这是一个独立维护的 DeepSeek Harness 社区插件。它向 shell.overlay slot 提供一只可拖动的 DeepSeek 蓝鲸，并把当前会话映射为稳定的空闲、思考、工具调用、等待、失败、复盘和回答状态。

本项目不是 DeepSeek Harness 官方包，由 sublatesublate-design 维护。按照 DSH 的生态贡献方式，项目发布在个人仓库，使用 GitHub dsh-plugin topic，并通过 Discussions 分享。

为什么做这个插件

浏览器版适合开始使用，但长期运行 AI 编程任务时有三个不足：状态变化不够直观，浏览器里的悬浮元素不能离开当前窗口，快速滚动的 reasoning 内容也不适合直接展示。

我做了什么

- 用蓝鲸把会话状态变成容易理解的视觉反馈。
- 为 Desktop 独立透明窗口提供拖动桥接，并同步主窗口的当前会话。
- 把高频 reasoning 收敛为稳定的思考状态，只保留有限的工具目标和回答摘要。

这样做的目的，是让 AI 长时间运行时仍然容易观察、不会刷屏，也不会因为切换到桌面其他位置而丢失当前会话状态。

下载和使用

想直接体验已经集成桌宠的 Desktop 版本，请使用个人 Fork 的 deepseek-desktop 分支：

git clone --branch deepseek-desktop https://github.com/sublatesublate-design/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm desktop

如果只需要浏览器模式，可以在同一个仓库运行 pnpm dsh web。

如果只想下载本插件源码，请继续克隆当前仓库。插件需要复制到 DSH workspace 的 packages/client/ui-pet，并加入 Web composition；它不是可以单独运行的应用，也不是一键安装的 npm 包。

请保留包名 @deepseek-ai/dsh-client-ui-pet，这样 DSH 现有的组合配置可以找到它；也可以把它作为本地 workspace member 使用。

当前包使用 DSH workspace peer dependency（workspace:^）。这是有意的：它让插件与宿主的客户端运行时、locale、layout、slot、invariant 和 Cordis 版本保持一致。它是可下载的插件源码包，不是把 DSH 宿主复制一份后独立运行的 npm runtime。

添加到 DSH workspace 后，把客户端包加入 Web composition，再运行正常的 client bundle 构建。个人 Fork 中的 packages/bundle/web-app/cordis.patch.yml 是完整的参考配置。

Desktop 示例

插件可运行在浏览器 overlay，也支持可选的 Electron 桌宠窗口。examples/desktop 目录包含桌宠窗口使用的最小 preload bridge。宿主主进程需要转发以下 IPC channel：

- dsh-pet-drag-start
- dsh-pet-drag-move
- dsh-pet-drag-end

桌宠 renderer 应使用 ?desktop=1&petOnly=1 加载 DSH Web 页面。主 renderer 和桌宠 renderer 通过桌面专用 BroadcastChannel 同步当前会话选择，然后各自消费实时会话流。

完整的 Electron 窗口生命周期、吸附、托盘菜单和启动集成位于个人 Fork 的 apps/desktop/src/main.mjs。

开发

请在 DSH workspace 中运行测试：

pnpm exec vitest run packages/client/ui-pet
pnpm --filter @deepseek-ai/dsh-client-ui-pet bundle

蓝鲸不会显示高频滚动的模型 reasoning 原文，只显示稳定的思考状态，以及受长度限制的工具目标或回答摘要，避免实时流期间气泡快速闪烁。

许可证

MIT，见 LICENSE。